View a markdown version of this page

Tabel API - AWS Lem

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tabel API

API Tabel menjelaskan jenis data dan operasi yang dikaitkan dengan tabel.

Jenis Data

Struktur tabel

Mewakili kumpulan data terkait yang diatur dalam kolom dan baris.

Bidang
  • Name- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • DatabaseName— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama basis data tempat metadata tabel berada. Untuk kompatibilitas Hive, ini semua harus huruf kecil.

  • Description — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Deskripsi tabel.

  • Owner— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Pemilik tabel.

  • CreateTime — Stempel waktu.

    Waktu ketika definisi tabel dibuat dalam Katalog Data.

  • UpdateTime — Stempel waktu.

    Terakhir kali tabel itu diperbarui.

  • LastAccessTime — Stempel waktu.

    Terakhir kali tabel itu diakses. Ini biasanya diambil dari HDFS, dan mungkin tidak dapat diandalkan.

  • LastAnalyzedTime — Stempel waktu.

    Terakhir kali statistik kolom dikomputasi untuk tabel ini.

  • Retention — Nomor (bilangan bulat).

    Waktu retensi untuk tabel ini.

  • StorageDescriptor — Sebuah objek StorageDescriptor.

    Sebuah deskriptor penyimpanan yang berisi informasi tentang penyimpanan fisik tabel ini.

  • PartitionKeys – Susunan objek Kolom.

    Daftar kolom yang digunakan sebagai dasar pemartisian. Hanya tipe primitif saja yang didukung sebagai kunci partisi.

    Bila Anda membuat sebuah tabel yang digunakan oleh Amazon Athena, dan Anda tidak menentukan partitionKeys, Anda harus setidaknya menetapkan nilai partitionKeys ke daftar kosong. Contoh:

    "PartitionKeys": []

  • ViewOriginalText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.

    Termasuk untuk kompatibilitas Apache Hive. Tidak digunakan dalam AWS Glue operasi normal. Jika tabel adalah Athena konfigurasi tertentu yang VIRTUAL_VIEW dikodekan dalam base64.

  • ViewExpandedText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.

    Termasuk untuk kompatibilitas Apache Hive. Tidak digunakan dalam AWS Glue operasi normal.

  • TableType— UTF-8 string, panjangnya tidak lebih dari 255 byte.

    Jenis tabel ini. AWS Glue akan membuat tabel dengan EXTERNAL_TABLE tipe. Layanan lain, seperti Athena, dapat membuat tabel dengan jenis tabel tambahan.

    AWS Glue jenis tabel terkait:

    TABEL EKSTERNAL

    Atribut yang kompatibel dengan hive - menunjukkan tabel yang dikelola non-Hive.

    DIPERINTAH

    Digunakan oleh AWS Lake Formation. Katalog AWS Glue Data mengertiGOVERNED.

  • Parameters – Susunan peta pasangan nilai kunci.

    Masing-masing kunci adalah sebuah String kunci, dengan panjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Setiap nilai adalah UTF-8 string, panjangnya tidak lebih dari 512000 byte.

    Pasangan nilai kunci ini menentukan sifat yang dikaitkan dengan tabel.

  • CreatedBy— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Orang atau entitas yang telah membuat tabel.

  • IsRegisteredWithLakeFormation – Boolean.

    Menunjukkan apakah tabel telah didaftarkan dengan AWS Lake Formation.

  • TargetTable — Sebuah objek TableIdentifier.

    Sebuah struktur TableIdentifier yang menggambarkan tabel target untuk menghubungkan sumber daya.

  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID dari Katalog Data tempat tabel berada.

  • VersionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    ID versi tabel.

  • FederatedTable — Sebuah objek FederatedTable.

    FederatedTableStruktur yang mereferensikan entitas di luar AWS Glue Data Catalog.

  • ViewDefinition — Sebuah objek ViewDefinition.

    Struktur yang berisi semua informasi yang mendefinisikan tampilan, termasuk dialek atau dialek untuk tampilan, dan kueri.

  • IsMultiDialectView – Boolean.

    Menentukan apakah tampilan mendukung dialek SQL dari satu atau lebih mesin query yang berbeda dan oleh karena itu dapat dibaca oleh mesin tersebut.

  • IsMaterializedView – Boolean.

    Menunjukkan tabel adalah aMaterializedView.

  • IcebergTableMetadata — Sebuah objek IcebergTableMetadata.

    Metadata tabel Apache Iceberg terbaru untuk tabel, termasuk versi format, skema, spesifikasi partisi, dan urutan urutan. Bidang ini diisi untuk tabel Iceberg dan mencerminkan keadaan metadata gunung es tabel saat ini.

  • Status — Sebuah objek TableStatus.

    Menunjukkan keadaan perubahan asinkron ke tabel.

TableInput struktur

Struktur yang digunakan untuk mendefinisikan tabel.

Bidang
  • Name- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama tabel. Untuk kompatibilitas Hive, nama ini diubah ke huruf kecil ketika disimpan.

  • Description — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Deskripsi tabel.

  • Owner— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Pemilik tabel. Termasuk untuk kompatibilitas Apache Hive. Tidak digunakan dalam AWS Glue operasi normal.

  • LastAccessTime — Stempel waktu.

    Terakhir kali tabel itu diakses.

  • LastAnalyzedTime — Stempel waktu.

    Terakhir kali statistik kolom dikomputasi untuk tabel ini.

  • Retention — Nomor (bilangan bulat).

    Waktu retensi untuk tabel ini.

  • StorageDescriptor — Sebuah objek StorageDescriptor.

    Sebuah deskriptor penyimpanan yang berisi informasi tentang penyimpanan fisik tabel ini.

  • PartitionKeys – Susunan objek Kolom.

    Daftar kolom yang digunakan sebagai dasar pemartisian. Hanya tipe primitif saja yang didukung sebagai kunci partisi.

    Bila Anda membuat sebuah tabel yang digunakan oleh Amazon Athena, dan Anda tidak menentukan partitionKeys, Anda harus setidaknya menetapkan nilai partitionKeys ke daftar kosong. Contoh:

    "PartitionKeys": []

  • ViewOriginalText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.

    Termasuk untuk kompatibilitas Apache Hive. Tidak digunakan dalam AWS Glue operasi normal. Jika tabel adalah Athena konfigurasi tertentu yang VIRTUAL_VIEW dikodekan dalam base64.

  • ViewExpandedText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.

    Termasuk untuk kompatibilitas Apache Hive. Tidak digunakan dalam AWS Glue operasi normal.

  • TableType— UTF-8 string, panjangnya tidak lebih dari 255 byte.

    Jenis tabel ini. AWS Glue akan membuat tabel dengan EXTERNAL_TABLE tipe. Layanan lain, seperti Athena, dapat membuat tabel dengan jenis tabel tambahan.

    AWS Glue jenis tabel terkait:

    TABEL EKSTERNAL

    Atribut yang kompatibel dengan hive - menunjukkan tabel yang dikelola non-Hive.

    DIPERINTAH

    Digunakan oleh AWS Lake Formation. Katalog AWS Glue Data mengertiGOVERNED.

  • Parameters – Susunan peta pasangan nilai kunci.

    Masing-masing kunci adalah sebuah String kunci, dengan panjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Setiap nilai adalah UTF-8 string, panjangnya tidak lebih dari 512000 byte.

    Pasangan nilai kunci ini menentukan sifat yang dikaitkan dengan tabel.

  • TargetTable — Sebuah objek TableIdentifier.

    Sebuah struktur TableIdentifier yang menggambarkan tabel target untuk menghubungkan sumber daya.

  • ViewDefinition — Sebuah objek ViewDefinitionInput.

    Struktur yang berisi semua informasi yang mendefinisikan tampilan, termasuk dialek atau dialek untuk tampilan, dan kueri.

FederatedTable struktur

Tabel yang menunjuk ke entitas di luar AWS Glue Data Catalog.

Bidang
  • Identifier— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 512 byte, cocok denganSingle-line string pattern.

    Pengidentifikasi unik untuk tabel federasi.

  • DatabaseIdentifier— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 512 byte, cocok denganSingle-line string pattern.

    Pengidentifikasi unik untuk database federasi.

  • ConnectionName— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama koneksi ke metastor eksternal.

  • ConnectionType— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Jenis koneksi yang digunakan untuk mengakses tabel federasi, menentukan protokol atau metode untuk menghubungkan ke sumber data eksternal.

Struktur kolom

Sebuah kolom di Table.

Bidang
  • Name- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama Column.

  • Type— UTF-8 string, panjangnya tidak lebih dari 131072 byte, cocok dengan. Single-line string pattern

    Jenis data dari Column.

  • Comment — String komentar, sepanjang tidak lebih dari 255, yang cocok dengan Single-line string pattern.

    Sebuah komentar teks bentuk bebas.

  • Parameters – Susunan peta pasangan nilai kunci.

    Masing-masing kunci adalah sebuah String kunci, dengan panjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Setiap nilai adalah UTF-8 string, panjangnya tidak lebih dari 512000 byte.

    Pasangan nilai kunci ini menentukan sifat yang dikaitkan dengan kolom.

StorageDescriptor struktur

Menjelaskan penyimpanan fisik data tabel.

Bidang
  • Columns – Susunan objek Kolom.

    Daftar Columns dalam tabel.

  • Location — String lokasi, sepanjang tidak lebih dari 2056, yang cocok dengan URI address multi-line string pattern.

    Lokasi fisik tabel. Secara default, ini mengambil bentuk lokasi gudang, yang diikuti oleh lokasi basis data di gudang, yang diikuti dengan nama tabel.

  • AdditionalLocations— Sebuah array UTF-8 string.

    Daftar lokasi yang menunjuk ke jalur tempat tabel Delta berada.

  • InputFormat — String format, sepanjang tidak lebih dari 128, yang cocok dengan Single-line string pattern.

    Format input: SequenceFileInputFormat (biner), atau TextInputFormat, atau format kustom.

  • OutputFormat — String format, sepanjang tidak lebih dari 128, yang cocok dengan Single-line string pattern.

    Format output: SequenceFileOutputFormat (biner), atau IgnoreKeyTextOutputFormat, atau format kustom.

  • Compressed – Boolean.

    True jika data dalam tabel dikompresi, atau False jika tidak.

  • NumberOfBuckets — Nomor (bilangan bulat).

    Harus ditentukan jika tabel berisi kolom dimensi.

  • SerdeInfo — Sebuah objek SerDeInfo.

    Informasi serialization/deserialization (SerDe).

  • BucketColumns— Sebuah array UTF-8 string.

    Daftar kolom pengelompokan peredam, kolom pengklasteran, dan kolom pem-bucket-an dalam tabel.

  • SortColumns – Susunan objek Order.

    Daftar yang menentukan urutan dari setiap bucket dalam tabel.

  • Parameters – Susunan peta pasangan nilai kunci.

    Masing-masing kunci adalah sebuah String kunci, dengan panjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Setiap nilai adalah UTF-8 string, panjangnya tidak lebih dari 512000 byte.

    Properti yang disediakan pengguna dalam bentuk nilai kunci.

  • SkewedInfo — Sebuah objek SkewedInfo.

    Informasi tentang nilai yang sering muncul di kolom (nilai kecenderungan).

  • StoredAsSubDirectories – Boolean.

    True jika data tabel disimpan di subdirektori, atau False jika tidak.

  • SchemaReference — Sebuah objek SchemaReference.

    Sebuah objek yang mereferensikan skema yang disimpan dalam S AWS Glue chema Registry.

    Saat membuat sebuah tabel, Anda dapat memberikan daftar kosong kolom untuk skema, dan sebaliknya menggunakan referensi skema.

SchemaReference struktur

Sebuah objek yang mereferensikan skema yang disimpan dalam S AWS Glue chema Registry.

Bidang
  • SchemaId — Sebuah objek SchemaId.

    Struktur yang berisi bidang identitas skema. Baik ini atau SchemaVersionId harus disediakan.

  • SchemaVersionId— UTF-8 string, panjangnya tidak kurang dari 36 atau lebih dari 36 byte, cocok denganCustom string pattern #42.

    ID unik yang ditetapkan untuk sebuah versi skema. Baik ini atau SchemaId harus disediakan.

  • SchemaVersionNumber — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100000.

    Nomor versi dari skema.

SerDeInfo struktur

Informasi tentang serialization/deserialization program (SerDe) yang berfungsi sebagai ekstraktor dan loader.

Bidang
  • Name— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama dari SerDe.

  • SerializationLibrary— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Biasanya kelas yang mengimplementasikan SerDe. Contohnya adalah org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe.

  • Parameters – Susunan peta pasangan nilai kunci.

    Masing-masing kunci adalah sebuah String kunci, dengan panjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Setiap nilai adalah UTF-8 string, panjangnya tidak lebih dari 512000 byte.

    Pasangan kunci-nilai ini menentukan parameter inisialisasi untuk. SerDe

Struktur pesanan

Menentukan urutan dari kolom yang diurutkan.

Bidang
  • Column- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama kolom.

  • SortOrderWajib: Nomor (bilangan bulat), tidak lebih dari 1.

    Menunjukkan bahwa kolom diurutkan dalam urutan menaik (== 1), atau dalam urutan menurun (==0).

SkewedInfo struktur

Menentukan nilai menyimpang dalam sebuah tabel. Nilai menyimpang adalah nilai yang terjadi dengan frekuensi sangat tinggi.

Bidang
  • SkewedColumnNames— Sebuah array UTF-8 string.

    Daftar nama kolom yang berisi nilai-nilai menyimpang.

  • SkewedColumnValues— Sebuah array UTF-8 string.

    Daftar nilai yang muncul sangat sering untuk dianggap menyimpang.

  • SkewedColumnValueLocationMaps – Susunan peta pasangan nilai kunci.

    Setiap kunci adalah UTF-8 string.

    Setiap nilai adalah UTF-8 string.

    Pemetaan nilai menyimpang untuk kolom yang berisi nilai tersebut.

TableVersion struktur

Menentukan versi dari sebuah tabel.

Bidang
  • Table — Sebuah objek Tabel.

    Tabel yang dimaksud.

  • VersionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nilai ID yang mengidentifikasi versi tabel ini. Sebuah VersionId adalah representasi string dari bilangan bulat. Setiap versi bertambah 1.

TableError struktur

Catatan kesalahan untuk operasi tabel.

Bidang
  • TableName— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • ErrorDetail — Sebuah objek ErrorDetail.

    Detail tentang kesalahan.

TableVersionError struktur

Catatan kesalahan untuk operasi versi tabel.

Bidang
  • TableName— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama tabel yang dimaksud.

  • VersionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nilai ID dari versi yang dimaksud. Sebuah VersionID adalah representasi string dari bilangan bulat. Setiap versi bertambah 1.

  • ErrorDetail — Sebuah objek ErrorDetail.

    Detail tentang kesalahan.

SortCriterion struktur

Menentukan sebuah bidang yang akan dijadikan dasar urutan dan urutan pengurutan.

Bidang
  • FieldName— Nilai string, tidak kurang dari 1 atau lebih dari 1024 byte panjangnya.

    Nama bidang yang akan dijadikan dasar pengurutan.

  • Sort— UTF-8 string (nilai valid: ASC="ASCENDING" |DESC="DESCENDING").

    Pengurutan naik atau turun.

TableIdentifier struktur

Sebuah struktur yang menggambarkan tabel target untuk menghubungkan sumber daya.

Bidang
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID dari Katalog Data tempat tabel berada.

  • DatabaseName— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama database katalog yang berisi tabel target.

  • Name— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama tabel target.

  • Region— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Wilayah tabel target.

KeySchemaElement struktur

Pasangan kunci partisi yang terdiri dari nama dan tipe.

Bidang
  • Name- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama kunci partisi.

  • Type- Diperlukan: UTF-8 string, panjang tidak lebih dari 131072 byte, cocok dengan. Single-line string pattern

    Jenis kunci partisi.

PartitionIndex struktur

Struktur untuk indeks partisi.

Bidang
  • Keys- Diperlukan: Sebuah array UTF-8 string, setidaknya 1 string.

    Kunci untuk indeks partisi.

  • IndexName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama indeks partisi.

PartitionIndexDescriptor struktur

Sebuah deskriptor untuk indeks partisi dalam sebuah tabel.

Bidang
  • IndexName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama indeks partisi.

  • KeysWajib: Array dari objek KeySchemaElement, setidaknya 1 struktur.

    Daftar satu atau beberapa kunci, sebagai struktur KeySchemaElement, untuk indeks partisi.

  • IndexStatus Diperlukan: UTF-8 string (nilai valid: CREATING | ACTIVE | DELETING |FAILED).

    Status indeks partisi.

    Status yang mungkin muncul adalah:

    • CREATING: Indeks sedang dibuat. Ketika indeks dalam status CREATING, indeks atau tabelnya tidak dapat dihapus.

    • ACTIVE: Pembuatan indeks berhasil.

    • FAILED: Pembuatan indeks gagal.

    • DELETING: Indeks dihapus dari daftar indeks.

  • BackfillErrors – Susunan objek BackfillError.

    Daftar kesalahan yang dapat terjadi saat mendaftarkan indeks partisi untuk tabel yang ada.

BackfillError struktur

Daftar kesalahan yang dapat terjadi saat mendaftarkan indeks partisi untuk tabel yang ada.

Kesalahan ini memberikan detail tentang mengapa pendaftaran indeks gagal dan menyediakan sejumlah partisi dalam respon dalam jumlah terbatas, sehingga Anda dapat memperbaiki partisi yang salah dan mencoba mendaftarkan indeks lagi. Kumpulan kesalahan yang paling umum yang dapat terjadi dikategorikan sebagai berikut:

  • EncryptedPartitionError: Partisi dienkripsi.

  • InvalidPartitionTypeDataError: Nilai partisi tidak cocok dengan tipe data untuk kolom partisi itu.

  • MissingPartitionValueError: Partisi dienkripsi.

  • UnsupportedPartitionCharacterError: Karakter di dalam nilai partisi tidak didukung. Sebagai contoh: U+0000, U+0001, U+0002.

  • InternalError: Kesalahan apa pun yang bukan milik kode kesalahan lainnya.

Bidang
  • Code— UTF-8 string (nilai valid: ENCRYPTED_PARTITION_ERROR | INTERNAL_ERROR | INVALID_PARTITION_TYPE_DATA_ERROR | MISSING_PARTITION_VALUE_ERROR |UNSUPPORTED_PARTITION_CHARACTER_ERROR).

    Kode kesalahan untuk kesalahan yang terjadi saat mendaftarkan indeks partisi untuk tabel yang ada.

  • Partitions – Susunan objek PartitionValueList.

    Daftar sejumlah partisi dalam respon dalam jumlah terbatas.

IcebergInput struktur

Struktur yang mendefinisikan tabel metadata Apache Iceberg untuk dibuat dalam katalog.

Bidang
  • MetadataOperation- Diperlukan: UTF-8 string (nilai valid:CREATE).

    Operasi metadata yang diperlukan. Hanya dapat diatur keCREATE.

  • Version— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Versi tabel untuk tabel Iceberg. Secara default ke 2.

  • CreateIcebergTableInput — Sebuah objek CreateIcebergTableInput.

    Parameter konfigurasi yang diperlukan untuk membuat tabel Iceberg baru di Katalog AWS Glue Data, termasuk properti tabel dan spesifikasi metadata.

OpenTableFormatInput struktur

Struktur yang mewakili tabel format terbuka.

Bidang
  • IcebergInput — Sebuah objek IcebergInput.

    Menentukan IcebergInput struktur yang mendefinisikan tabel metadata Apache Iceberg.

ViewDefinition struktur

Struktur yang berisi detail untuk representasi.

Bidang
  • IsProtected – Boolean.

    Anda dapat mengatur flag ini sebagai true untuk menginstruksikan mesin agar tidak mendorong operasi yang disediakan pengguna ke dalam rencana logis tampilan selama perencanaan kueri. Namun, menetapkan bendera ini tidak menjamin bahwa mesin akan mematuhi. Lihat dokumentasi mesin untuk memahami jaminan yang diberikan, jika ada.

  • Definer— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 512 byte, cocok denganSingle-line string pattern.

    Pendefinisikan tampilan di SQL.

  • ViewVersionId— Angka (panjang), setidaknya -1.

    Nilai ID yang mengidentifikasi versi tampilan ini. Untuk tampilan yang terwujud, ID versi adalah ID snapshot tabel Apache Iceberg.

  • ViewVersionToken— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    ID versi tabel Apache Iceberg.

  • RefreshSeconds — Nomor (panjang).

    Interval refresh otomatis dalam hitungan detik untuk tampilan yang terwujud. Jika tidak ditentukan, tampilan tidak akan disegarkan secara otomatis.

  • LastRefreshType— UTF-8 string (nilai valid: FULL |INCREMENTAL).

    Menetapkan metode yang digunakan untuk penyegaran terbaru.

  • SubObjects— Sebuah array UTF-8 string, tidak lebih dari 10 string.

    Daftar tabel Nama Sumber Daya Amazon (ARN).

  • SubObjectVersionIds— Array bilangan bulat 64-bit yang ditandatangani, tidak lebih dari 250 angka.

    Daftar versi tabel Apache Iceberg yang direferensikan oleh tampilan terwujud.

  • Representations — Susunan objek ViewRepresentation, tidak kurang dari 1 atau tidak lebih dari 1000 struktur.

    Daftar representasi.

ViewDefinitionInput struktur

Struktur yang berisi detail untuk membuat atau memperbarui AWS Glue tampilan.

Bidang
  • IsProtected – Boolean.

    Anda dapat mengatur flag ini sebagai true untuk menginstruksikan mesin agar tidak mendorong operasi yang disediakan pengguna ke dalam rencana logis tampilan selama perencanaan kueri. Namun, menetapkan bendera ini tidak menjamin bahwa mesin akan mematuhi. Lihat dokumentasi mesin untuk memahami jaminan yang diberikan, jika ada.

  • Definer— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 512 byte, cocok denganSingle-line string pattern.

    Pendefinisikan tampilan di SQL.

  • Representations— Sebuah array ViewRepresentationInput objek, tidak kurang dari 1 atau lebih dari 10 struktur.

    Daftar struktur yang berisi dialek tampilan, dan query yang mendefinisikan tampilan.

  • ViewVersionId— Angka (panjang), setidaknya -1.

    Nilai ID yang mengidentifikasi versi tampilan ini. Untuk tampilan yang terwujud, ID versi adalah ID snapshot tabel Apache Iceberg.

  • ViewVersionToken— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    ID versi tabel Apache Iceberg.

  • RefreshSeconds — Nomor (panjang).

    Interval refresh otomatis dalam hitungan detik untuk tampilan yang terwujud. Jika tidak ditentukan, tampilan tidak akan disegarkan secara otomatis.

  • LastRefreshType— UTF-8 string (nilai valid: FULL |INCREMENTAL).

    Jenis penyegaran terakhir tampilan yang terwujud. Nilai-nilai yang valid: Full, Incremental.

  • SubObjects— Sebuah array UTF-8 string, tidak lebih dari 10 string.

    Daftar ARN tabel dasar yang membentuk tampilan.

  • SubObjectVersionIds— Array bilangan bulat 64-bit yang ditandatangani, tidak lebih dari 250 angka.

    Daftar versi tabel Apache Iceberg yang direferensikan oleh tampilan terwujud.

ViewRepresentation struktur

Struktur yang berisi dialek tampilan, dan query yang mendefinisikan tampilan.

Bidang
  • Dialect— UTF-8 string (nilai valid: REDSHIFT | ATHENA |SPARK).

    Dialek mesin query.

  • DialectVersion— UTF-8 string, tidak kurang dari 1 atau lebih dari 255 byte panjangnya.

    Versi dialek mesin kueri. Misalnya, 3.0.0.

  • ViewOriginalText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.

    Per SELECT mintaan yang diberikan oleh pelanggan selamaCREATE VIEW DDL. SQL ini tidak digunakan selama kueri pada tampilan (ViewExpandedTextdigunakan sebagai gantinya). ViewOriginalTextdigunakan untuk kasus seperti SHOW CREATE VIEW di mana pengguna ingin melihat perintah DDL asli yang membuat tampilan.

  • ViewExpandedText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.

    SQL yang diperluas untuk tampilan. SQL ini digunakan oleh mesin saat memproses query pada tampilan. Mesin dapat melakukan operasi selama pembuatan tampilan untuk diubah ViewOriginalText menjadiViewExpandedText. Contoh:

    • Pengidentifikasi yang sepenuhnya memenuhi syarat: SELECT * from table1 -> SELECT * from db1.table1

  • ValidationConnection— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama koneksi yang akan digunakan untuk memvalidasi representasi spesifik dari tampilan.

  • IsStale – Boolean.

    Dialek-dialek yang ditandai sebagai basi tidak lagi valid dan harus diperbarui sebelum dapat ditanyakan di mesin kueri masing-masing.

ViewRepresentationInput struktur

Struktur yang berisi rincian representasi untuk memperbarui atau membuat tampilan Danau Formasi.

Bidang
  • Dialect— UTF-8 string (nilai valid: REDSHIFT | ATHENA |SPARK).

    Parameter yang menentukan jenis mesin dari representasi tertentu.

  • DialectVersion— UTF-8 string, tidak kurang dari 1 atau lebih dari 255 byte panjangnya.

    Parameter yang menentukan versi mesin dari representasi tertentu.

  • ViewOriginalText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.

    Sebuah string yang mewakili query SQL asli yang menggambarkan tampilan.

  • ValidationConnection— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama koneksi yang akan digunakan untuk memvalidasi representasi spesifik dari tampilan.

  • ViewExpandedText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.

    Sebuah string yang mewakili query SQL yang menjelaskan tampilan dengan ARN sumber daya yang diperluas

UpdateOpenTableFormatInput struktur

Parameter input untuk memperbarui tabel format tabel terbuka di Katalog AWS Glue Data, berfungsi sebagai pembungkus untuk operasi pembaruan khusus format seperti Apache Iceberg.

Bidang
  • UpdateIcebergInput — Sebuah objek UpdateIcebergInput.

    Param Iceberg-specific eter update Apache yang menentukan modifikasi tabel yang akan diterapkan, termasuk perubahan skema, spesifikasi partisi, dan properti tabel.

UpdateIcebergInput struktur

Parameter input khusus untuk memperbarui tabel Apache Iceberg di Katalog AWS Glue Data, berisi operasi pembaruan yang akan diterapkan ke tabel Iceberg yang ada.

Bidang
  • UpdateIcebergTableInputWajib: Sebuah objek UpdateIcebergTableInput.

    Operasi pembaruan spesifik yang akan diterapkan ke tabel Iceberg, berisi daftar pembaruan yang menentukan status baru tabel termasuk skema, partisi, dan properti.

CreateIcebergTableInput struktur

Parameter konfigurasi yang diperlukan untuk membuat tabel Iceberg baru di Katalog AWS Glue Data, termasuk properti tabel dan spesifikasi metadata.

Bidang
  • Location- Diperlukan: String lokasi, panjang tidak lebih dari 2056 byte, cocok dengan. URI address multi-line string pattern

    Lokasi S3 tempat data tabel Iceberg akan disimpan.

  • SchemaWajib: Sebuah objek IcebergSchema.

    Definisi skema yang menentukan struktur, jenis bidang, dan metadata untuk tabel Iceberg.

  • PartitionSpec — Sebuah objek IcebergPartitionSpec.

    Spesifikasi partisi yang mendefinisikan bagaimana data tabel Iceberg akan diatur dan dipartisi untuk kinerja kueri yang optimal.

  • WriteOrder — Sebuah objek IcebergSortOrder.

    Spesifikasi urutan urutan yang mendefinisikan bagaimana data harus diurutkan dalam setiap partisi untuk mengoptimalkan kinerja kueri.

  • Properties – Susunan peta pasangan nilai kunci.

    Setiap kunci adalah UTF-8 string.

    Setiap nilai adalah UTF-8 string.

    Key-value pasangan properti tabel tambahan dan pengaturan konfigurasi untuk tabel Iceberg.

UpdateIcebergTableInput struktur

Berisi operasi pembaruan yang akan diterapkan ke tabel Iceberg yang ada di Katalog AWS Glue Data, menentukan status baru metadata tabel.

Bidang
  • UpdatesWajib: Susunan objek IcebergTableUpdate.

    Daftar operasi pembaruan tabel yang menentukan perubahan yang akan dilakukan pada tabel Iceberg, termasuk modifikasi skema, spesifikasi partisi, dan properti tabel.

IcebergSortOrder struktur

Mendefinisikan spesifikasi urutan untuk tabel Iceberg, menentukan bagaimana data harus diurutkan dalam partisi untuk mengoptimalkan kinerja kueri.

Bidang
  • OrderIdWajib: Nomor (bilangan bulat).

    Pengidentifikasi unik untuk spesifikasi urutan urutan ini dalam metadata tabel Iceberg.

  • FieldsWajib: Susunan objek IcebergSortField.

    Daftar bidang dan arah pengurutannya yang menentukan kriteria pemesanan untuk data tabel Iceberg.

IcebergSortField struktur

Mendefinisikan satu bidang dalam spesifikasi urutan Iceberg, termasuk bidang sumber, transformasi, arah pengurutan, dan urutan nilai nol.

Bidang
  • SourceIdWajib: Nomor (bilangan bulat).

    Pengidentifikasi bidang sumber dari skema tabel yang menjadi dasar bidang pengurutan ini.

  • Transform- Diperlukan: UTF-8 string.

    Fungsi transformasi diterapkan ke bidang sumber sebelum menyortir, seperti identitas, bucket, atau truncate.

  • Direction Diperlukan: UTF-8 string (nilai valid: asc="ASC" |desc="DESC").

    Arah pengurutan untuk bidang ini, baik naik atau turun.

  • NullOrder Diperlukan: UTF-8 string (nilai valid: nulls-first="NULLS_FIRST" |nulls-last="NULLS_LAST").

    Perilaku pengurutan untuk nilai nol di bidang ini, menentukan apakah nol harus muncul pertama atau terakhir dalam urutan pengurutan.

IcebergPartitionSpec struktur

Mendefinisikan spesifikasi partisi untuk tabel Iceberg, menentukan bagaimana data tabel akan diatur dan dipartisi untuk kinerja kueri yang optimal.

Bidang
  • FieldsWajib: Susunan objek IcebergPartitionField.

    Daftar bidang partisi yang menentukan bagaimana data tabel harus dipartisi, termasuk bidang sumber dan transformasi mereka.

  • SpecId — Nomor (bilangan bulat).

    Pengidentifikasi unik untuk spesifikasi partisi ini dalam riwayat metadata tabel Iceberg.

IcebergPartitionField struktur

Mendefinisikan bidang partisi tunggal dalam spesifikasi partisi Iceberg, termasuk bidang sumber, fungsi transformasi, nama partisi, dan pengidentifikasi unik.

Bidang
  • SourceIdWajib: Nomor (bilangan bulat).

    Pengidentifikasi bidang sumber dari skema tabel yang menjadi dasar bidang partisi ini.

  • Transform- Diperlukan: UTF-8 string.

    Fungsi transformasi diterapkan ke bidang sumber untuk membuat partisi, seperti identitas, bucket, truncate, tahun, bulan, hari, atau jam.

  • Name- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 1024 byte, cocok denganSingle-line string pattern.

    Nama bidang partisi seperti yang akan muncul dalam struktur tabel yang dipartisi.

  • FieldId — Nomor (bilangan bulat).

    Pengidentifikasi unik yang ditetapkan untuk bidang partisi ini dalam spesifikasi partisi tabel Iceberg.

IcebergSchema struktur

Mendefinisikan struktur skema untuk tabel Iceberg, termasuk definisi bidang, tipe data, dan metadata skema.

Bidang
  • SchemaId — Nomor (bilangan bulat).

    Pengidentifikasi unik untuk versi skema ini dalam riwayat evolusi skema tabel Iceberg.

  • IdentifierFieldIds— Array bilangan bulat 32-bit yang ditandatangani.

    Daftar pengidentifikasi bidang yang secara unik mengidentifikasi catatan dalam tabel, digunakan untuk operasi tingkat baris dan deduplikasi.

  • Type— UTF-8 string (nilai valid:struct="STRUCT").

    Jenis akar dari struktur skema, biasanya “struct” untuk skema tabel Iceberg.

  • FieldsWajib: Susunan objek IcebergStructField.

    Daftar definisi bidang yang membentuk skema tabel, termasuk nama bidang, jenis, dan metadata.

IcebergStructField struktur

Mendefinisikan satu bidang dalam skema tabel Iceberg, termasuk pengidentifikasi, nama, tipe data, nulabilitas, dan dokumentasi.

Bidang
  • IdWajib: Nomor (bilangan bulat).

    Pengidentifikasi unik yang ditetapkan untuk bidang ini dalam skema tabel Iceberg, digunakan untuk evolusi skema dan pelacakan lapangan.

  • Name- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 1024 byte, cocok denganSingle-line string pattern.

    Nama bidang seperti yang muncul dalam skema tabel dan operasi kueri.

  • Type Diperlukan: Struktur kosong bernama. IcebergDocument

    Definisi tipe data untuk bidang ini, menentukan struktur dan format data yang dikandungnya.

  • RequiredWajib: Boolean.

    Menunjukkan apakah bidang ini wajib (non-nullable) atau opsional (nullable) dalam skema tabel.

  • Doc — String komentar, sepanjang tidak lebih dari 255, yang cocok dengan Single-line string pattern.

    Dokumentasi opsional atau teks deskripsi yang memberikan konteks tambahan tentang tujuan dan penggunaan bidang ini.

  • InitialDefault- Struktur kosong bernama. IcebergDocument

    Nilai default digunakan untuk mengisi nilai bidang untuk semua catatan yang ditulis sebelum bidang ditambahkan ke skema. Ini memungkinkan kompatibilitas mundur saat menambahkan bidang baru ke tabel Iceberg yang ada.

  • WriteDefault- Struktur kosong bernama. IcebergDocument

    Nilai default digunakan untuk mengisi nilai bidang untuk setiap catatan yang ditulis setelah bidang ditambahkan ke skema, jika penulis tidak memberikan nilai bidang. Ini dapat diubah melalui evolusi skema.

IcebergTableUpdate struktur

Mendefinisikan satu set lengkap pembaruan yang akan diterapkan ke tabel Iceberg, termasuk perubahan skema, modifikasi partisi, penyesuaian urutan, pembaruan lokasi, dan perubahan properti.

Bidang
  • SchemaWajib: Sebuah objek IcebergSchema.

    Definisi skema yang diperbarui untuk tabel Iceberg, menentukan perubahan apa pun pada struktur bidang, tipe data, atau metadata skema.

  • PartitionSpec — Sebuah objek IcebergPartitionSpec.

    Spesifikasi partisi yang diperbarui yang mendefinisikan bagaimana data tabel harus ditata ulang dan dipartisi.

  • SortOrder — Sebuah objek IcebergSortOrder.

    Spesifikasi urutan urutan yang diperbarui yang mendefinisikan bagaimana data harus diurutkan dalam partisi untuk kinerja kueri yang optimal.

  • Location- Diperlukan: String lokasi, panjang tidak lebih dari 2056 byte, cocok dengan. URI address multi-line string pattern

    Lokasi S3 yang diperbarui tempat data tabel Iceberg akan disimpan.

  • Properties – Susunan peta pasangan nilai kunci.

    Setiap kunci adalah UTF-8 string.

    Setiap nilai adalah UTF-8 string.

    Diperbarui pasangan kunci-nilai properti tabel dan pengaturan konfigurasi untuk tabel Iceberg.

  • Action— UTF-8 string (nilai yang valid: add-schema="ADD_SCHEMA" set-current-schema="SET_CURRENT_SCHEMA" | add-spec="ADD_SPEC" | set-default-spec="SET_DEFAULT_SPEC" | add-sort-order="ADD_SORT_ORDER" | set-default-sort-order="SET_DEFAULT_SORT_ORDER" | set-location="SET_LOCATION" | set-properties="SET_PROPERTIES" | remove-properties="REMOVE_PROPERTIES" | add-encryption-key="ADD_ENCRYPTION_KEY" |remove-encryption-key="REMOVE_ENCRYPTION_KEY").

    Jenis tindakan pembaruan yang akan dilakukan pada tabel Iceberg. Mendefinisikan operasi tertentu seperti menambahkan skema, mengatur skema saat ini, menambahkan spesifikasi partisi, atau mengelola kunci enkripsi.

  • EncryptionKey — Sebuah objek IcebergEncryptedKey.

    Informasi kunci enkripsi terkait dengan operasi pembaruan tabel Iceberg. Digunakan saat menambahkan atau menghapus kunci enkripsi dari metadata tabel selama evolusi tabel.

  • KeyId— UTF-8 string, panjangnya tidak lebih dari 2056 byte, cocok dengan. URI address multi-line string pattern

    Pengidentifikasi kunci enkripsi yang terlibat dalam operasi pembaruan tabel Iceberg. Mereferensikan kunci spesifik yang ditambahkan atau dihapus dari konfigurasi enkripsi tabel.

IcebergTableMetadata struktur

Metadata tabel Apache Iceberg, termasuk versi format, pengidentifikasi tabel, skema, spesifikasi partisi, urutan urutan, dan properti tabel. Struktur ini menangkap keadaan metadata tabel Iceberg saat ini sebagaimana dikelola oleh Katalog AWS Glue Data.

Bidang
  • FormatVersion— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Versi format tabel Apache Iceberg, seperti 1 atau2. Menentukan kumpulan fitur dan tata letak on-disk yang didukung oleh tabel.

  • TableUuid— UTF-8 string, panjangnya tidak lebih dari 100 byte, cocok denganSingle-line string pattern.

    Pengidentifikasi unik (UUID) untuk tabel Iceberg, ditetapkan saat tabel dibuat dan digunakan untuk melacak tabel di seluruh pembaruan metadata.

  • Location — String lokasi, sepanjang tidak lebih dari 2056, yang cocok dengan URI address multi-line string pattern.

    Lokasi dasar S3 tempat data tabel Iceberg dan file metadata disimpan.

  • Properties – Susunan peta pasangan nilai kunci.

    Setiap kunci adalah UTF-8 string.

    Setiap nilai adalah UTF-8 string.

    Peta pasangan kunci-nilai yang menentukan properti tingkat tabel dan pengaturan konfigurasi untuk tabel Iceberg.

  • Schemas – Susunan objek IcebergSchema.

    Daftar skema yang telah dikaitkan dengan tabel Gunung Es selama sejarahnya, mendukung evolusi skema.

  • CurrentSchemaId — Nomor (bilangan bulat).

    Pengidentifikasi skema yang saat ini aktif untuk tabel Iceberg. Cocokkan entri diSchemas.

  • LastColumnId — Nomor (bilangan bulat).

    Pengidentifikasi kolom tertinggi yang telah ditetapkan dalam skema tabel Iceberg, digunakan untuk memastikan ID unik saat kolom baru ditambahkan.

  • PartitionSpecs – Susunan objek IcebergPartitionSpec.

    Daftar spesifikasi partisi yang telah dikaitkan dengan tabel Iceberg selama sejarahnya, mendukung evolusi partisi.

  • DefaultSpecId — Nomor (bilangan bulat).

    Pengidentifikasi spesifikasi partisi yang saat ini digunakan secara default saat menulis data baru ke tabel Iceberg.

  • LastPartitionId — Nomor (bilangan bulat).

    Pengidentifikasi bidang partisi tertinggi yang telah ditetapkan di seluruh spesifikasi partisi tabel.

  • SortOrders – Susunan objek IcebergSortOrder.

    Daftar spesifikasi urutan urutan yang telah dikaitkan dengan tabel Iceberg selama sejarahnya.

  • DefaultSortOrderId — Nomor (bilangan bulat).

    Pengidentifikasi urutan pengurutan yang saat ini digunakan secara default saat menulis data baru ke tabel Iceberg.

IcebergEncryptedKey struktur

Struktur kunci enkripsi digunakan untuk enkripsi tabel Iceberg. Berisi ID kunci, metadata kunci terenkripsi, referensi opsional ke kunci enkripsi, dan properti tambahan untuk skema enkripsi tabel.

Bidang
  • KeyId- Diperlukan: UTF-8 string, panjang tidak lebih dari 2056 byte, cocok dengan. URI address multi-line string pattern

    Pengidentifikasi unik dari kunci enkripsi yang digunakan untuk enkripsi tabel Iceberg. ID ini digunakan untuk mereferensikan kunci dalam metadata tabel dan melacak kunci mana yang digunakan untuk mengenkripsi data tertentu.

  • EncryptedKeyMetadata- Diperlukan: UTF-8 string, panjang tidak lebih dari 2056 byte, cocok dengan. URI address multi-line string pattern

    Kunci dan metadata terenkripsi, base64 dikodekan. Format metadata kunci terenkripsi ditentukan oleh skema enkripsi tabel dan dapat berupa format yang dibungkus khusus untuk penyedia KMS tabel.

  • EncryptedById— UTF-8 string, panjangnya tidak lebih dari 2056 byte, cocok dengan. URI address multi-line string pattern

    ID opsional kunci yang digunakan untuk mengenkripsi atau membungkus metadata kunci dalam enkripsi tabel Iceberg. Bidang ini mereferensikan kunci enkripsi lain yang digunakan untuk mengenkripsi metadata kunci saat ini.

  • Properties – Susunan peta pasangan nilai kunci.

    Setiap kunci adalah UTF-8 string.

    Setiap nilai adalah UTF-8 string.

    Peta string ke string dari metadata tambahan yang digunakan oleh skema enkripsi tabel. Properti ini menyediakan konteks dan konfigurasi tambahan untuk implementasi kunci enkripsi.

TableStatus struktur

Struktur yang berisi informasi tentang keadaan perubahan asinkron ke tabel.

Bidang
  • RequestedBy— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    ARN pengguna yang meminta perubahan asinkron.

  • UpdatedBy— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    ARN pengguna yang terakhir mengubah perubahan asinkron secara manual (meminta pembatalan, dll).

  • RequestTime — Stempel waktu.

    String tanggal berformat ISO 8601 yang menunjukkan waktu perubahan dimulai.

  • UpdateTime — Stempel waktu.

    String tanggal berformat ISO 8601 yang menunjukkan waktu status terakhir diperbarui.

  • Action— UTF-8 string (nilai valid: UPDATE |CREATE).

    Menunjukkan tindakan mana yang dipanggil di atas meja, saat ini hanya CREATE atauUPDATE.

  • State— UTF-8 string (nilai valid: QUEUED | IN_PROGRESS | SUCCESS | STOPPED |FAILED).

    Status umum untuk perubahan yang sedang berlangsung, seperti QUEUED, IN_PROGRESS, SUCCESS, atau FAILED.

  • Error — Sebuah objek ErrorDetail.

    Kesalahan yang hanya akan muncul ketika status “GAGAL”. Ini adalah pesan pengecualian tingkat induk, mungkin ada Error s yang berbeda untuk setiap dialek.

  • Details — Sebuah objek StatusDetails.

    Ob StatusDetails jek dengan informasi tentang perubahan yang diminta.

StatusDetails struktur

Struktur yang berisi informasi tentang perubahan asinkron pada tabel.

Bidang
  • RequestedChange — Sebuah objek Tabel.

    Ob Table jek yang mewakili perubahan yang diminta.

  • ViewValidations – Susunan objek ViewValidation.

    Daftar ViewValidation objek yang berisi informasi untuk mesin analitik untuk memvalidasi tampilan.

ViewValidation struktur

Struktur yang berisi informasi untuk mesin analitik untuk memvalidasi tampilan, sebelum mempertahankan metadata tampilan. Digunakan dalam kasus panggilan langsung UpdateTable atau CreateTable API.

Bidang
  • Dialect— UTF-8 string (nilai valid: REDSHIFT | ATHENA |SPARK).

    Dialek mesin query.

  • DialectVersion— UTF-8 string, tidak kurang dari 1 atau lebih dari 255 byte panjangnya.

    Versi dialek mesin kueri. Misalnya, 3.0.0.

  • ViewValidationText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.

    Ku SELECT eri yang mendefinisikan tampilan, seperti yang disediakan oleh pelanggan.

  • UpdateTime — Stempel waktu.

    Waktu pembaruan terakhir.

  • State— UTF-8 string (nilai valid: QUEUED | IN_PROGRESS | SUCCESS | STOPPED |FAILED).

    Keadaan validasi.

  • Error — Sebuah objek ErrorDetail.

    Kesalahan yang terkait dengan validasi.

AuditContext struktur

Struktur yang berisi konteks Lake Formation audit.

Bidang
  • AdditionalAuditContext— UTF-8 string, panjangnya tidak lebih dari 2048 byte.

    Sebuah string yang berisi informasi konteks audit tambahan.

  • RequestedColumns— Sebuah array UTF-8 string.

    Kolom yang diminta untuk audit.

  • AllColumnsRequested – Boolean.

    Semua kolom meminta audit.

Operasi

CreateTable tindakan (Python: create_table)

Menciptakan sebuah definisi tabel baru dalam Katalog Data.

Permintaan
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID Katalog Data tempat Table dibuat. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.

  • DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Basis data katalog di mana tabel baru akan dibuat. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • Name— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Pengidentifikasi unik untuk tabel dalam database yang ditentukan yang akan dibuat dalam Katalog AWS Glue Data.

  • TableInput — Sebuah objek TableInput.

    Objek TableInput yang mendefinisikan tabel metadata yang akan dibuat dalam katalog.

  • PartitionIndexes – Susunan objek PartitionIndex.

    Daftar indeks partisi, struktur PartitionIndex, yang akan dibuat dalam tabel.

  • TransactionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganCustom string pattern #41.

    ID transaksi.

  • OpenTableFormatInput — Sebuah objek OpenTableFormatInput.

    Menentukan OpenTableFormatInput struktur saat membuat tabel format terbuka.

Respons
  • Tidak ada parameter Respons.

Kesalahan
  • AlreadyExistsException

  • InvalidInputException

  • EntityNotFoundException

  • ResourceNumberLimitExceededException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

  • ConcurrentModificationException

  • ResourceNotReadyException

  • FederationSourceException

  • FederationSourceRetryableException

UpdateTable tindakan (Python: update_table)

Memperbarui tabel metadata dalam Katalog Data.

Permintaan
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID dari Katalog Data tempat tabel berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.

  • DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama basis data katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • Name— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Pengidentifikasi unik untuk tabel dalam database yang ditentukan yang akan dibuat dalam Katalog AWS Glue Data.

  • TableInput — Sebuah objek TableInput.

    Objek TableInput yang diperbarui untuk menentukan tabel metadata dalam katalog.

  • SkipArchive – Boolean.

    Secara default, UpdateTable selalu membuat versi diarsipkan dari tabel tersebut sebelum memperbaruinya. Namun, jika skipArchive diatur ke BETUL, UpdateTable tidak akan membuat versi yang diarsipkan.

  • TransactionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganCustom string pattern #41.

    ID transaksi untuk memperbarui isi tabel.

  • VersionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    ID versi untuk memperbarui isi tabel.

  • ViewUpdateAction— UTF-8 string (nilai valid: ADD | REPLACE | ADD_OR_REPLACE |DROP).

    Operasi yang akan dilakukan saat memperbarui tampilan.

  • Force – Boolean.

    Bendera yang dapat disetel ke true untuk mengabaikan deskriptor penyimpanan yang cocok dan persyaratan pencocokan suboobjek.

  • UpdateOpenTableFormatInput — Sebuah objek UpdateOpenTableFormatInput.

    Parameter input untuk memperbarui tabel format tabel terbuka di Katalog AWS Glue Data, berfungsi sebagai pembungkus untuk operasi pembaruan khusus format seperti Apache Iceberg.

Respons
  • Tidak ada parameter Respons.

Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ConcurrentModificationException

  • ResourceNumberLimitExceededException

  • GlueEncryptionException

  • ResourceNotReadyException

  • FederationSourceException

  • FederationSourceRetryableException

  • AlreadyExistsException

DeleteTable tindakan (Python: delete_table)

Menghapus sebuah definisi tabel dari Katalog Data.

catatan

Setelah menyelesaikan operasi ini, Anda tidak lagi memiliki akses ke versi tabel dan partisi yang merupakan milik tabel yang dihapus. AWS Glue menghapus sumber daya "yatim piatu" secara asinkron pada waktu yang tepat, atas kebijaksanaan layanan.

Untuk memastikan penghapusan langsung dari semua sumber daya terkait, sebelum memanggil DeleteTable, gunakan DeleteTableVersion atau BatchDeleteTableVersion, dan DeletePartition atau BatchDeletePartition, untuk menghapus sumber daya yang dimiliki oleh tabel.

Permintaan
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID dari Katalog Data tempat tabel berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.

  • DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama basis data katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • Name- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama tabel yang akan dihapus. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • TransactionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganCustom string pattern #41.

    ID transaksi untuk menghapus isi tabel.

Respons
  • Tidak ada parameter Respons.

Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ConcurrentModificationException

  • ResourceNotReadyException

  • FederationSourceException

  • FederationSourceRetryableException

BatchDeleteTable tindakan (Python: batch_delete_table)

Menghapus beberapa tabel sekaligus.

catatan

Setelah menyelesaikan operasi ini, Anda tidak lagi memiliki akses ke versi tabel dan partisi yang merupakan milik tabel yang dihapus. AWS Glue menghapus sumber daya "yatim piatu" secara asinkron pada waktu yang tepat, atas kebijaksanaan layanan.

Untuk memastikan penghapusan langsung dari semua sumber daya terkait, sebelum memanggil BatchDeleteTable, gunakan DeleteTableVersion atau BatchDeleteTableVersion, dan DeletePartition atau BatchDeletePartition, untuk menghapus sumber daya yang dimiliki oleh tabel.

Permintaan
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID dari Katalog Data tempat tabel berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.

  • DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama basis data katalog di mana tabel yang akan dihapus berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • TablesToDelete- Diperlukan: Sebuah array UTF-8 string, tidak lebih dari 100 string.

    Daftar tabel yang akan dihapus.

  • TransactionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganCustom string pattern #41.

    ID transaksi untuk menghapus isi tabel.

Respons
  • Errors – Susunan objek TableError.

    Daftar kesalahan yang ditemui saat berusaha untuk menghapus tabel tertentu.

Kesalahan
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

  • ResourceNotReadyException

GetTable tindakan (Python: get_table)

Mengambil definisi Table dalam Katalog Data untuk tabel yang ditentukan.

Permintaan
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID dari Katalog Data tempat tabel berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.

  • DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama basis data dalam katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • Name- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama tabel yang untuknya definisi akan diambil. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • TransactionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganCustom string pattern #41.

    ID transaksi untuk membaca isi tabel.

  • QueryAsOfTime — Stempel waktu.

    Waktu kapan membaca isi tabel. Jika tidak diatur, waktu komit transaksi terbaru akan digunakan. Tidak dapat ditentukan bersama denganTransactionId.

  • AuditContext — Sebuah objek AuditContext.

    Struktur yang berisi konteks Lake Formation audit.

  • IncludeStatusDetails – Boolean.

    Menentukan apakah akan menyertakan detail status terkait dengan permintaan untuk membuat atau memperbarui tampilan Katalog AWS Glue Data.

  • AttributesToGet— Sebuah array UTF-8 string.

    Menentukan bidang tabel yang dikembalikan oleh GetTable panggilan. Parameter ini tidak menerima daftar kosong.

    Berikut ini adalah kombinasi nilai yang valid:

    • DEFAULT- Mengembalikan definisi Hive-style tabel saja.

    • LATEST_ICEBERG_METADATA- Mengembalikan hanya metadata tabel Apache Iceberg terbaru.

    • DEFAULT, LATEST_ICEBERG_METADATA - Mengembalikan definisi Hive-style tabel dan metadata tabel Apache Iceberg terbaru.

Respons
  • Table — Sebuah objek Tabel.

    Objek Table yang mendefinisikan tabel yang ditentukan.

Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

  • ResourceNotReadyException

  • FederationSourceException

  • FederationSourceRetryableException

GetTables tindakan (Python: get_tables)

Mengambil definisi dari beberapa atau semua tabel dalam Database yang ditentukan.

Permintaan
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID dari Katalog Data tempat tabel-tabel tersebut berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.

  • DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Basis data dalam katalog yang tabelnya akan dicantumkan. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • Expression— UTF-8 string, panjangnya tidak lebih dari 2048 byte, cocok denganSingle-line string pattern.

    Sebuah pola ekspresi reguler. Jika ada, hanya tabel yang namanya cocok dengan pola saja yang dikembalikan.

  • NextToken— UTF-8 tali.

    Sebuah token kelanjutan, disertakan jika ini adalah sebuah panggilan kelanjutan.

  • MaxResults — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100.

    Jumlah maksimum tabel yang akan dikembalikan dalam satu respons tunggal.

  • TransactionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganCustom string pattern #41.

    ID transaksi untuk membaca isi tabel.

  • QueryAsOfTime — Stempel waktu.

    Waktu kapan membaca isi tabel. Jika tidak diatur, waktu komit transaksi terbaru akan digunakan. Tidak dapat ditentukan bersama denganTransactionId.

  • AuditContext — Sebuah objek AuditContext.

    Struktur yang berisi konteks Lake Formation audit.

  • IncludeStatusDetails – Boolean.

    Menentukan apakah akan menyertakan detail status terkait dengan permintaan untuk membuat atau memperbarui tampilan Katalog AWS Glue Data.

  • AttributesToGet— Sebuah array UTF-8 string.

    Menentukan bidang tabel yang dikembalikan oleh GetTables panggilan. Parameter ini tidak menerima daftar kosong. Permintaan harus menyertakanNAME.

    Berikut ini adalah kombinasi nilai yang valid:

    • NAME- Nama semua tabel dalam database.

    • NAME, TABLE_TYPE - Nama semua tabel dan jenis tabel.

Respons
  • TableList – Susunan objek Tabel.

    Daftar objek Table yang diminta.

  • NextToken— UTF-8 tali.

    Sebuah token kelanjutan, ada jika segmen daftar saat ini bukan yang terakhir.

Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • OperationTimeoutException

  • InternalServiceException

  • GlueEncryptionException

  • FederationSourceException

  • FederationSourceRetryableException

GetTableVersion tindakan (Python: get_table_version)

Mengambil versi tertentu dari sebuah tabel.

Permintaan
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID dari Katalog Data tempat tabel-tabel tersebut berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.

  • DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Basis data dalam katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • VersionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nilai ID dari versi tabel yang akan diambil. Sebuah VersionID adalah representasi string dari bilangan bulat. Setiap versi bertambah 1.

Respons
  • TableVersion — Sebuah objek TableVersion.

    Versi tabel yang diminta.

Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

GetTableVersions tindakan (Python: get_table_versions)

Mengambil daftar string yang mengidentifikasi versi yang tersedia dari sebuah tabel yang ditentukan.

Permintaan
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID dari Katalog Data tempat tabel-tabel tersebut berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.

  • DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Basis data dalam katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • NextToken— UTF-8 tali.

    Sebuah token kelanjutan, jika ini bukan panggilan pertama.

  • MaxResults — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100.

    Jumlah maksimum versi tabel yang akan dikembalikan dalam satu respons.

Respons
  • TableVersions – Susunan objek TableVersion.

    Daftar string yang mengidentifikasi versi yang tersedia dari sebuah tabel yang ditentukan.

  • NextToken— UTF-8 tali.

    Sebuah token kelanjutan, jika daftar versi yang tersedia tidak termasuk yang terakhir.

Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

DeleteTableVersion tindakan (Python: delete_table_version)

Menghapus versi tertentu dari sebuah tabel.

Permintaan
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID dari Katalog Data tempat tabel-tabel tersebut berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.

  • DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Basis data dalam katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • VersionId- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    ID dari versi tabel yang akan dihapus. Sebuah VersionID adalah representasi string dari bilangan bulat. Setiap versi bertambah 1.

Respons
  • Tidak ada parameter Respons.

Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

BatchDeleteTableVersion tindakan (Python: batch_delete_table_version)

Menghapus batch versi tertentu dari sebuah tabel.

Permintaan
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID dari Katalog Data tempat tabel-tabel tersebut berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.

  • DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Basis data dalam katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.

  • VersionIds- Diperlukan: Sebuah array UTF-8 string, tidak lebih dari 100 string.

    Daftar ID versi yang akan dihapus. Sebuah VersionId adalah representasi string dari bilangan bulat. Setiap versi bertambah 1.

Respons
  • Errors – Susunan objek TableVersionError.

    Daftar kesalahan yang ditemui saat berusaha menghapus versi tabel yang ditentukan.

Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

SearchTables tindakan (Python: search_tables)

Mencari satu set tabel berdasarkan properti dalam metadata tabel dan pada basis data induk. Anda dapat mencari berdasarkan teks atau syarat filter.

Anda hanya bisa mendapatkan tabel yang dapat Anda akses berdasarkan kebijakan keamanan yang ditetapkan dalam Lake Formation. Anda memerlukan setidaknya akses baca-saja ke tabel yang untuknya akan dikembalikan. Jika Anda tidak memiliki akses ke semua kolom dalam tabel, maka kolom-kolom tersebut tidak akan dicari saat mengembalikan daftar tabel kembali kepada Anda. Jika Anda memiliki akses ke kolom tetapi tidak ke data dalam kolom, maka kolom tersebut dan metadata yang dikaitkan ke kolom tersebut akan dimasukkan dalam pencarian.

Permintaan
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Pengidentifikasi unik, terdiri dari account_id.

  • NextToken— UTF-8 tali.

    Sebuah token kelanjutan, disertakan jika ini adalah sebuah panggilan kelanjutan.

  • Filters – Susunan objek PropertyPredicate.

    Sebuah daftar pasangan nilai-kunci, dan sebuah pembanding digunakan untuk mem-filter hasil pencarian. Mengembalikan semua entitas yang cocok dengan predikat.

    Anggota Comparator dari struct PropertyPredicate hanya digunakan untuk bidang waktu, dan dapat dihilangkan untuk jenis bidang lainnya. Selain itu, ketika membandingkan nilai string, seperti ketika Key=Name, algoritme kecocokan fuzzy digunakan. Bidang Key (misalnya, nilai bidang Name) dibagi berdasarkan karakter tanda baca tertentu, misalnya, -, :, #, dll. menjadi token. Kemudian setiap token adalah dibandingkan secara exact-match dengan anggota Value dari PropertyPredicate. Misalnya, jika Key=Name dan Value=link, tabel bernama customer-link dan xx-link-yy dikembalikan, tapi xxlinkyy tidak dikembalikan.

  • SearchText— Nilai string, tidak kurang dari 1 atau lebih dari 1024 byte panjangnya.

    String yang digunakan untuk pencarian teks.

    Menentukan nilai dalam filter kutipan berdasarkan kecocokan persis dengan nilai.

  • SortCriteria — Susunan objek SortCriterion, tidak lebih dari 1 struktur.

    Daftar kriteria untuk mengurutkan hasil berdasarkan nama bidang, dalam urutan menaik atau menurun.

  • MaxResults — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 1000.

    Jumlah maksimum tabel yang akan dikembalikan dalam satu respons tunggal.

  • ResourceShareType— UTF-8 string (nilai valid: FOREIGN | ALL |FEDERATED).

    Memungkinkan Anda untuk menentukan apakah Anda ingin mencari tabel yang dibagi dengan akun Anda. Nilai yang diijinkan adalah FOREIGN atau ALL.

    • Jika diatur ke FOREIGN, akan mencari tabel yang dibagikan dengan akun Anda.

    • Jika diatur ke ALL, akan mencari tabel yang dibagikan dengan akun Anda, serta tabel di akun lokal Anda.

  • IncludeStatusDetails – Boolean.

    Menentukan apakah akan menyertakan detail status terkait dengan permintaan untuk membuat atau memperbarui tampilan Katalog AWS Glue Data.

Respons
  • NextToken— UTF-8 tali.

    Sebuah token kelanjutan, ada jika segmen daftar saat ini bukan yang terakhir.

  • TableList – Susunan objek Tabel.

    Daftar objek Table yang diminta. Respons SearchTables hanya mengembalikan tabel yang Anda miliki aksesnya.

Kesalahan
  • InternalServiceException

  • InvalidInputException

  • OperationTimeoutException

GetPartitionIndexes tindakan (Python: get_partition_indexes)

Mengambil indeks partisi yang dikaitkan dengan sebuah tabel.

Permintaan
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID katalog tempat tabel berada.

  • DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Menentukan nama basis data tempat Anda ingin mengambil indeks partisi.

  • TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Menentukan nama tabel yang untuknya Anda ingin mengambil indeks partisi.

  • NextToken— UTF-8 tali.

    Sebuah token kelanjutan, disertakan jika ini adalah sebuah panggilan kelanjutan.

Respons
  • PartitionIndexDescriptorList – Susunan objek PartitionIndexDescriptor.

    Daftar deskriptor indeks.

  • NextToken— UTF-8 tali.

    Sebuah token kelanjutan, ada jika segmen daftar saat ini bukan yang terakhir.

Kesalahan
  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException

  • EntityNotFoundException

  • ConflictException

CreatePartitionIndex tindakan (Python: create_partition_index)

Menciptakan sebuah indeks partisi tertentu dalam tabel yang ada.

Permintaan
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID katalog tempat tabel berada.

  • DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Menentukan nama sebuah basis data di mana Anda ingin membuat sebuah indeks partisi.

  • TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Menentukan nama sebuah tabel di mana Anda ingin membuat sebuah indeks partisi.

  • PartitionIndexWajib: Sebuah objek PartitionIndex.

    Menentukan struktur PartitionIndex untuk membuat sebuah indeks partisi dalam tabel yang ada.

Respons
  • Tidak ada parameter Respons.

Kesalahan
  • AlreadyExistsException

  • InvalidInputException

  • EntityNotFoundException

  • ResourceNumberLimitExceededException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

DeletePartitionIndex tindakan (Python: delete_partition_index)

Menghapus sebuah indeks partisi tertentu dari tabel yang ada.

Permintaan
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID katalog tempat tabel berada.

  • DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Menentukan nama sebuah basis data yang ingin Anda hapus indeks partisinya.

  • TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Menentukan nama sebuah tabel yang ingin Anda hapus indeks partisinya.

  • IndexName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama indeks partisi yang akan dihapus.

Respons
  • Tidak ada parameter Respons.

Kesalahan
  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException

  • EntityNotFoundException

  • ConflictException

  • GlueEncryptionException

GetColumnStatisticsForTable tindakan (Python: get_column_statistics_for_table)

Mengambil statistik tabel kolom.

Izin Identity and Access Management (IAM) yang diperlukan untuk operasi ini adalah GetTable.

Permintaan
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID Katalog Data tempat partisi yang dimaksud berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.

  • DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama basis data katalog tempat partisi berada.

  • TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama tabel partisi.

  • ColumnNames- Diperlukan: Sebuah array UTF-8 string, tidak lebih dari 100 string.

    Daftar nama kolom.

Respons
  • ColumnStatisticsList – Susunan objek ColumnStatistics.

    Daftar ColumnStatistics.

  • Errors – Susunan objek ColumnError.

    Daftar ColumnStatistics itu gagal diambil.

Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

UpdateColumnStatisticsForTable tindakan (Python: update_column_statistics_for_table)

Menciptakan atau memperbarui statistik tabel kolom.

Izin Identity and Access Management (IAM) yang diperlukan untuk operasi ini adalah UpdateTable.

Permintaan
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID Katalog Data tempat partisi yang dimaksud berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.

  • DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama basis data katalog tempat partisi berada.

  • TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama tabel partisi.

  • ColumnStatisticsListWajib: Susunan objek ColumnStatistics, tidak lebih dari 25 struktur.

    Daftar statistik kolom.

Respons
Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

DeleteColumnStatisticsForTable tindakan (Python: delete_column_statistics_for_table)

Mengambil statistik tabel kolom.

Izin Identity and Access Management (IAM) yang diperlukan untuk operasi ini adalah DeleteTable.

Permintaan
  • CatalogId — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    ID Katalog Data tempat partisi yang dimaksud berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.

  • DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama basis data katalog tempat partisi berada.

  • TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama tabel partisi.

  • ColumnName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.

    Nama kolom.

Respons
  • Tidak ada parameter Respons.

Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException