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 meja](#aws-glue-api-catalog-tables-Table) + [TableInput struktur](#aws-glue-api-catalog-tables-TableInput) + [FederatedTable struktur](#aws-glue-api-catalog-tables-FederatedTable) + [Struktur kolom](#aws-glue-api-catalog-tables-Column) + [StorageDescriptor struktur](#aws-glue-api-catalog-tables-StorageDescriptor) + [SchemaReference struktur](#aws-glue-api-catalog-tables-SchemaReference) + [SerDeInfo struktur](#aws-glue-api-catalog-tables-SerDeInfo) + [Struktur pesanan](#aws-glue-api-catalog-tables-Order) + [SkewedInfo struktur](#aws-glue-api-catalog-tables-SkewedInfo) + [TableVersion struktur](#aws-glue-api-catalog-tables-TableVersion) + [TableError struktur](#aws-glue-api-catalog-tables-TableError) + [TableVersionError struktur](#aws-glue-api-catalog-tables-TableVersionError) + [SortCriterion struktur](#aws-glue-api-catalog-tables-SortCriterion) + [TableIdentifier struktur](#aws-glue-api-catalog-tables-TableIdentifier) + [KeySchemaElement struktur](#aws-glue-api-catalog-tables-KeySchemaElement) + [PartitionIndex struktur](#aws-glue-api-catalog-tables-PartitionIndex) + [PartitionIndexDescriptor struktur](#aws-glue-api-catalog-tables-PartitionIndexDescriptor) + [BackfillError struktur](#aws-glue-api-catalog-tables-BackfillError) + [IcebergInput struktur](#aws-glue-api-catalog-tables-IcebergInput) + [OpenTableFormatInput struktur](#aws-glue-api-catalog-tables-OpenTableFormatInput) + [ViewDefinition struktur](#aws-glue-api-catalog-tables-ViewDefinition) + [ViewDefinitionInput struktur](#aws-glue-api-catalog-tables-ViewDefinitionInput) + [ViewRepresentation struktur](#aws-glue-api-catalog-tables-ViewRepresentation) + [ViewRepresentationInput struktur](#aws-glue-api-catalog-tables-ViewRepresentationInput) + [UpdateOpenTableFormatInput struktur](#aws-glue-api-catalog-tables-UpdateOpenTableFormatInput) + [UpdateIcebergInput struktur](#aws-glue-api-catalog-tables-UpdateIcebergInput) + [CreateIcebergTableInput struktur](#aws-glue-api-catalog-tables-CreateIcebergTableInput) + [UpdateIcebergTableInput struktur](#aws-glue-api-catalog-tables-UpdateIcebergTableInput) + [IcebergSortOrder struktur](#aws-glue-api-catalog-tables-IcebergSortOrder) + [IcebergSortField struktur](#aws-glue-api-catalog-tables-IcebergSortField) + [IcebergPartitionSpec struktur](#aws-glue-api-catalog-tables-IcebergPartitionSpec) + [IcebergPartitionField struktur](#aws-glue-api-catalog-tables-IcebergPartitionField) + [IcebergSchema struktur](#aws-glue-api-catalog-tables-IcebergSchema) + [IcebergStructField struktur](#aws-glue-api-catalog-tables-IcebergStructField) + [IcebergTableUpdate struktur](#aws-glue-api-catalog-tables-IcebergTableUpdate) + [AuditContext struktur](#aws-glue-api-catalog-tables-AuditContext) ## Struktur meja Mewakili kumpulan data terkait yang diatur dalam kolom dan baris. **Bidang** + `Name` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `DatabaseName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-common.md#aws-glue-api-regex-uri). Deskripsi tabel. + `Owner` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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), tidak lebih dari Tidak Ada. Waktu retensi untuk tabel ini. + `StorageDescriptor` — Sebuah objek [StorageDescriptor](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-StorageDescriptor). Sebuah deskriptor penyimpanan yang berisi informasi tentang penyimpanan fisik tabel ini. + `PartitionKeys` – Susunan objek [Kolom](#aws-glue-api-catalog-tables-Column). 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` — String UTF-8, dengan panjang tidak lebih dari 409600 byte. Termasuk untuk kompatibilitas Apache Hive. Tidak digunakan dalam AWS Glue operasi normal. Jika tabelnya adalah`VIRTUAL_VIEW`, Athena konfigurasi tertentu dikodekan dalam base64. + `ViewExpandedText` — String UTF-8, dengan panjang tidak lebih dari 409600 byte. Termasuk untuk kompatibilitas Apache Hive. Tidak digunakan dalam AWS Glue operasi normal. + `TableType` — String UTF-8, dengan panjang 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: EXTERNAL\_TABLE Atribut kompatibel sarang - menunjukkan tabel terkelola non-HIVE. DIATUR Digunakan oleh AWS Lake Formation. Katalog AWS Glue Data mengerti`GOVERNED`. + `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak lebih dari 512000 byte. Pasangan nilai kunci ini menentukan sifat yang dikaitkan dengan tabel. + `CreatedBy` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Orang atau entitas yang telah membuat tabel. + `IsRegisteredWithLakeFormation` – Boolean. Menunjukkan apakah tabel telah terdaftar AWS Lake Formation. + `TargetTable` — Sebuah objek [TableIdentifier](#aws-glue-api-catalog-tables-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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID dari Katalog Data tempat tabel berada. + `VersionId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID versi tabel. + `FederatedTable` — Sebuah objek [FederatedTable](#aws-glue-api-catalog-tables-FederatedTable). `FederatedTable`Struktur yang mereferensikan entitas di luar AWS Glue Data Catalog. + `ViewDefinition` — Sebuah objek [ViewDefinition](#aws-glue-api-catalog-tables-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 karena itu dapat dibaca oleh mesin tersebut. ## TableInput struktur Struktur yang digunakan untuk mendefinisikan tabel. **Bidang** + `Name` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-common.md#aws-glue-api-regex-uri). Deskripsi tabel. + `Owner` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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), tidak lebih dari Tidak Ada. Waktu retensi untuk tabel ini. + `StorageDescriptor` — Sebuah objek [StorageDescriptor](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-StorageDescriptor). Sebuah deskriptor penyimpanan yang berisi informasi tentang penyimpanan fisik tabel ini. + `PartitionKeys` – Susunan objek [Kolom](#aws-glue-api-catalog-tables-Column). 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` — String UTF-8, dengan panjang tidak lebih dari 409600 byte. Termasuk untuk kompatibilitas Apache Hive. Tidak digunakan dalam AWS Glue operasi normal. Jika tabelnya adalah`VIRTUAL_VIEW`, Athena konfigurasi tertentu dikodekan dalam base64. + `ViewExpandedText` — String UTF-8, dengan panjang tidak lebih dari 409600 byte. Termasuk untuk kompatibilitas Apache Hive. Tidak digunakan dalam AWS Glue operasi normal. + `TableType` — String UTF-8, dengan panjang 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: EXTERNAL\_TABLE Atribut kompatibel sarang - menunjukkan tabel terkelola non-HIVE. DIATUR Digunakan oleh AWS Lake Formation. Katalog AWS Glue Data mengerti`GOVERNED`. + `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak lebih dari 512000 byte. Pasangan nilai kunci ini menentukan sifat yang dikaitkan dengan tabel. + `TargetTable` — Sebuah objek [TableIdentifier](#aws-glue-api-catalog-tables-TableIdentifier). Sebuah struktur `TableIdentifier` yang menggambarkan tabel target untuk menghubungkan sumber daya. + `ViewDefinition` — Sebuah objek [ViewDefinitionInput](#aws-glue-api-catalog-tables-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` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 512 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Pengidentifikasi unik untuk tabel federasi. + `DatabaseIdentifier` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 512 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Pengidentifikasi unik untuk database federasi. + `ConnectionName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama koneksi ke metastore eksternal. + `ConnectionType` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama `Column`. + `Type` — String UTF-8, sepanjang tidak lebih dari 131072, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Jenis data dari `Column`. + `Comment` — String komentar, sepanjang tidak lebih dari 255, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Masing-masing kunci adalah sebuah string UTF-8, dengan panjang 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](#aws-glue-api-catalog-tables-Column). Daftar `Columns` dalam tabel. + `Location` — String lokasi, sepanjang tidak lebih dari 2056, yang cocok dengan [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri). Lokasi fisik tabel. Secara default, ini mengambil bentuk lokasi gudang, yang diikuti oleh lokasi basis data di gudang, yang diikuti dengan nama tabel. + `AdditionalLocations` – Susunan string UTF-8. Daftar lokasi yang mengarah ke jalur tempat tabel Delta berada. + `InputFormat` — String format, sepanjang tidak lebih dari 128, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Format input: `SequenceFileInputFormat` (biner), atau `TextInputFormat`, atau format kustom. + `OutputFormat` — String format, sepanjang tidak lebih dari 128, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SerDeInfo). Informasi serialization/deserialization (SerDe). + `BucketColumns` – Susunan string UTF-8. Daftar kolom pengelompokan peredam, kolom pengklasteran, dan kolom pem-bucket-an dalam tabel. + `SortColumns` – Susunan objek [Order](#aws-glue-api-catalog-tables-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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak lebih dari 512000 byte. Properti yang disediakan pengguna dalam bentuk nilai kunci. + `SkewedInfo` — Sebuah objek [SkewedInfo](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-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](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SchemaReference). Objek yang mereferensikan skema yang disimpan dalam AWS Glue Schema Registry. Saat membuat sebuah tabel, Anda dapat memberikan daftar kosong kolom untuk skema, dan sebaliknya menggunakan referensi skema. ## SchemaReference struktur Objek yang mereferensikan skema yang disimpan dalam AWS Glue Schema Registry. **Bidang** + `SchemaId` — Sebuah objek [SchemaId](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-SchemaId). Struktur yang berisi bidang identitas skema. Baik ini atau `SchemaVersionId` harus disediakan. + `SchemaVersionId` — String UTF-8, sepanjang tidak kurang dari 36 atau lebih dari 36 byte, yang cocok dengan [Custom string pattern #45](aws-glue-api-common.md#regex_45). 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 extractor dan loader. **Bidang** + `Name` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama SerDe. + `SerializationLibrary` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak lebih dari 512000 byte. Pasangan kunci-nilai ini menentukan parameter inisialisasi untuk. SerDe ## Struktur pesanan Menentukan urutan dari kolom yang diurutkan. **Bidang** + `Column` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama kolom. + `SortOrder` — *Wajib:* 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` – Susunan string UTF-8. Daftar nama kolom yang berisi nilai-nilai menyimpang. + `SkewedColumnValues` – Susunan string UTF-8. Daftar nilai yang muncul sangat sering untuk dianggap menyimpang. + `SkewedColumnValueLocationMaps` – Susunan peta pasangan nilai kunci. Setiap kunci adalah string UTF-8. Setiap nilai adalah string UTF-8. Pemetaan nilai menyimpang untuk kolom yang berisi nilai tersebut. ## TableVersion struktur Menentukan versi dari sebuah tabel. **Bidang** + `Table` — Sebuah objek [Tabel](#aws-glue-api-catalog-tables-Table). Tabel yang dimaksud. + `VersionId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `ErrorDetail` — Sebuah objek [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail). Detail tentang kesalahan. ## TableVersionError struktur Catatan kesalahan untuk operasi versi tabel. **Bidang** + `TableName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama tabel yang dimaksud. + `VersionId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nilai ID dari versi yang dimaksud. Sebuah `VersionID` adalah representasi string dari bilangan bulat. Setiap versi bertambah 1. + `ErrorDetail` — Sebuah objek [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail). Detail tentang kesalahan. ## SortCriterion struktur Menentukan sebuah bidang yang akan dijadikan dasar urutan dan urutan pengurutan. **Bidang** + `FieldName`— Nilai string, panjangnya tidak kurang dari 1 atau lebih dari 1024 byte. Nama bidang yang akan dijadikan dasar pengurutan. + `Sort` – String UTF-8 (nilai yang 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID dari Katalog Data tempat tabel berada. + `DatabaseName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama basis data katalog yang berisi tabel target. + `Name` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama tabel target. + `Region` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Wilayah tabel target. ## KeySchemaElement struktur Pasangan kunci partisi yang terdiri dari nama dan tipe. **Bidang** + `Name` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama kunci partisi. + `Type` – *Wajib:* String UTF-8, sepanjang tidak lebih dari 131072 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Jenis kunci partisi. ## PartitionIndex struktur Struktur untuk indeks partisi. **Bidang** + `Keys` — *Wajib:* Susunan string UTF-8, setidaknya 1 string. Kunci untuk indeks partisi. + `IndexName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama indeks partisi. ## PartitionIndexDescriptor struktur Sebuah deskriptor untuk indeks partisi dalam sebuah tabel. **Bidang** + `IndexName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama indeks partisi. + `Keys` — *Wajib:* Array dari objek [KeySchemaElement](#aws-glue-api-catalog-tables-KeySchemaElement), setidaknya 1 struktur. Daftar satu atau beberapa kunci, sebagai struktur `KeySchemaElement`, untuk indeks partisi. + `IndexStatus` – *Wajib:* String UTF-8 (nilai yang 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](#aws-glue-api-catalog-tables-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` – String UTF-8 (nilai yang 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](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionValueList). Daftar sejumlah partisi dalam respon dalam jumlah terbatas. ## IcebergInput struktur Struktur yang mendefinisikan tabel metadata Apache Iceberg untuk dibuat dalam katalog. **Bidang** + `MetadataOperation` – *Wajib:* String UTF-8 (nilai yang valid: `CREATE`). Operasi metadata yang diperlukan. Hanya dapat diatur ke`CREATE`. + `Version` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Versi tabel untuk tabel Iceberg. Secara default ke 2. + `CreateIcebergTableInput` — Sebuah objek [CreateIcebergTableInput](#aws-glue-api-catalog-tables-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](#aws-glue-api-catalog-tables-IcebergInput). Menentukan `IcebergInput` struktur yang mendefinisikan tabel metadata Apache Iceberg. ## ViewDefinition struktur Struktur yang berisi detail untuk representasi. **Bidang** + `IsProtected` – Boolean. Anda dapat menyetel flag ini sebagai true untuk menginstruksikan mesin agar tidak mendorong operasi yang disediakan pengguna ke dalam rencana logis tampilan selama perencanaan kueri. Namun, pengaturan bendera ini tidak menjamin bahwa mesin akan mematuhi. Lihat dokumentasi mesin untuk memahami jaminan yang diberikan, jika ada. + `Definer`— String UTF-8, panjangnya tidak kurang dari 20 atau lebih dari 2048 byte, cocok dengan. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Penentu tampilan di SQL. + `SubObjects` — Susunan string UTF-8, tidak lebih dari 10 string. Daftar tabel Amazon Resource Names (ARNs). + `Representations` — Susunan objek [ViewRepresentation](#aws-glue-api-catalog-tables-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 menyetel flag ini sebagai true untuk menginstruksikan mesin agar tidak mendorong operasi yang disediakan pengguna ke dalam rencana logis tampilan selama perencanaan kueri. Namun, pengaturan bendera ini tidak menjamin bahwa mesin akan mematuhi. Lihat dokumentasi mesin untuk memahami jaminan yang diberikan, jika ada. + `Definer`— String UTF-8, panjangnya tidak kurang dari 20 atau lebih dari 2048 byte, cocok dengan. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Penentu tampilan di SQL. + `Representations`— Array [ViewRepresentationInput](#aws-glue-api-catalog-tables-ViewRepresentationInput) objek, tidak kurang dari 1 atau lebih dari 10 struktur. Daftar struktur yang berisi dialek tampilan, dan kueri yang mendefinisikan tampilan. + `SubObjects` — Susunan string UTF-8, tidak lebih dari 10 string. Daftar tabel dasar ARNs yang membentuk tampilan. ## ViewRepresentation struktur Struktur yang berisi dialek tampilan, dan kueri yang mendefinisikan tampilan. **Bidang** + `Dialect` – String UTF-8 (nilai yang valid: `REDSHIFT` \| `ATHENA` \| `SPARK`). Dialek mesin kueri. + `DialectVersion` — String UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 255 byte. Versi dialek mesin kueri. Misalnya, 3.0.0. + `ViewOriginalText` — String UTF-8, dengan panjang tidak lebih dari 409600 byte. `SELECT`Permintaan yang diberikan oleh pelanggan selama`CREATE VIEW DDL`. SQL ini tidak digunakan selama query pada tampilan (`ViewExpandedText`digunakan sebagai gantinya). `ViewOriginalText`digunakan untuk kasus-kasus seperti `SHOW CREATE VIEW` di mana pengguna ingin melihat perintah DDL asli yang membuat tampilan. + `ViewExpandedText` — String UTF-8, dengan panjang tidak lebih dari 409600 byte. SQL diperluas untuk tampilan. SQL ini digunakan oleh mesin saat memproses kueri pada tampilan. Mesin dapat melakukan operasi selama pembuatan tampilan `ViewOriginalText` untuk diubah menjadi`ViewExpandedText`. Contoh: + Pengidentifikasi yang sepenuhnya memenuhi syarat: `SELECT * from table1 -> SELECT * from db1.table1` + `ValidationConnection` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama koneksi yang akan digunakan untuk memvalidasi representasi spesifik dari tampilan. + `IsStale` – Boolean. Dialek yang ditandai sebagai basi tidak lagi valid dan harus diperbarui sebelum dapat ditanyakan di mesin kueri masing-masing. ## ViewRepresentationInput struktur Struktur yang berisi detail representasi untuk memperbarui atau membuat tampilan Lake Formation. **Bidang** + `Dialect` – String UTF-8 (nilai yang valid: `REDSHIFT` \| `ATHENA` \| `SPARK`). Parameter yang menentukan jenis mesin dari representasi tertentu. + `DialectVersion` — String UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 255 byte. Parameter yang menentukan versi mesin representasi tertentu. + `ViewOriginalText` — String UTF-8, dengan panjang tidak lebih dari 409600 byte. Sebuah string yang mewakili query SQL asli yang menggambarkan tampilan. + `ValidationConnection` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama koneksi yang akan digunakan untuk memvalidasi representasi spesifik dari tampilan. + `ViewExpandedText` — String UTF-8, dengan panjang tidak lebih dari 409600 byte. Sebuah string yang mewakili query SQL yang menggambarkan tampilan dengan sumber daya diperluas ARNs ## UpdateOpenTableFormatInput struktur Parameter masukan 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](#aws-glue-api-catalog-tables-UpdateIcebergInput). Parameter pembaruan khusus Apache Iceberg yang menentukan modifikasi tabel yang akan diterapkan, termasuk perubahan skema, spesifikasi partisi, dan properti tabel. ## UpdateIcebergInput struktur Parameter masukan khusus untuk memperbarui tabel Apache Iceberg di Katalog AWS Glue Data, yang berisi operasi pembaruan yang akan diterapkan ke tabel Iceberg yang ada. **Bidang** + `UpdateIcebergTableInput` — *Wajib:* Sebuah objek [UpdateIcebergTableInput](#aws-glue-api-catalog-tables-UpdateIcebergTableInput). Operasi pembaruan khusus 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`- *Wajib:* String lokasi, panjangnya tidak lebih dari 2056 byte, cocok dengan. [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) Lokasi S3 tempat data tabel Iceberg akan disimpan. + `Schema` — *Wajib:* Sebuah objek [IcebergSchema](#aws-glue-api-catalog-tables-IcebergSchema). Definisi skema yang menentukan struktur, jenis bidang, dan metadata untuk tabel Iceberg. + `PartitionSpec` — Sebuah objek [IcebergPartitionSpec](#aws-glue-api-catalog-tables-IcebergPartitionSpec). Spesifikasi partisi yang mendefinisikan bagaimana data tabel Iceberg akan diatur dan dipartisi untuk kinerja kueri yang optimal. + `WriteOrder` — Sebuah objek [IcebergSortOrder](#aws-glue-api-catalog-tables-IcebergSortOrder). Spesifikasi urutan pengurutan yang mendefinisikan bagaimana data harus diurutkan dalam setiap partisi untuk mengoptimalkan kinerja kueri. + `Properties` – Pasangan kunci-nilai 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** + `Updates` – *Wajib:* Susunan objek [IcebergTableUpdate](#aws-glue-api-catalog-tables-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 pengurutan untuk tabel Iceberg, menentukan bagaimana data harus diurutkan dalam partisi untuk mengoptimalkan kinerja kueri. **Bidang** + `OrderId` — *Wajib:* Nomor (bilangan bulat). Pengenal unik untuk spesifikasi urutan sortir ini dalam metadata tabel Iceberg. + `Fields` – *Wajib:* Susunan objek [IcebergSortField](#aws-glue-api-catalog-tables-IcebergSortField). Daftar bidang dan arah urutannya 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 null. **Bidang** + `SourceId` — *Wajib:* Nomor (bilangan bulat). Pengidentifikasi bidang sumber dari skema tabel yang menjadi dasar bidang pengurutan ini. + `Transform` – *Wajib:* String UTF-8. Fungsi transformasi diterapkan ke bidang sumber sebelum menyortir, seperti identitas, bucket, atau truncate. + `Direction` – *Wajib:* String UTF-8 (nilai yang valid: `asc="ASC"` \| `desc="DESC"`). Arah pengurutan untuk bidang ini, baik naik atau turun. + `NullOrder` – *Wajib:* String UTF-8 (nilai yang valid: `nulls-first="NULLS_FIRST"` \| `nulls-last="NULLS_LAST"`). Perilaku pengurutan untuk nilai null di bidang ini, menentukan apakah null akan 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** + `Fields` – *Wajib:* Susunan objek [IcebergPartitionField](#aws-glue-api-catalog-tables-IcebergPartitionField). Daftar bidang partisi yang menentukan bagaimana data tabel harus dipartisi, termasuk bidang sumber dan transformasinya. + `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** + `SourceId` — *Wajib:* Nomor (bilangan bulat). Pengidentifikasi bidang sumber dari skema tabel yang menjadi dasar bidang partisi ini. + `Transform` – *Wajib:* String UTF-8. Fungsi transformasi diterapkan ke bidang sumber untuk membuat partisi, seperti identitas, bucket, pemotongan, tahun, bulan, hari, atau jam. + `Name` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 1024 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama bidang partisi seperti yang akan muncul dalam struktur tabel yang dipartisi. + `FieldId` — Nomor (bilangan bulat). Pengenal unik yang ditugaskan ke bidang partisi ini dalam spesifikasi partisi tabel Iceberg. ## IcebergSchema struktur Mendefinisikan struktur skema untuk tabel Gunung Es, termasuk definisi bidang, tipe data, dan metadata skema. **Bidang** + `SchemaId` — Nomor (bilangan bulat). Pengidentifikasi unik untuk versi skema ini dalam sejarah 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` – String UTF-8 (nilai yang valid: `struct="STRUCT"`). Jenis akar struktur skema, biasanya “struct” untuk skema tabel Iceberg. + `Fields` – *Wajib:* Susunan objek [IcebergStructField](#aws-glue-api-catalog-tables-IcebergStructField). Daftar definisi bidang yang membentuk skema tabel, termasuk nama bidang, jenis, dan metadata. ## IcebergStructField struktur Mendefinisikan satu bidang dalam skema tabel Iceberg, termasuk pengenal, nama, tipe data, nullability, dan dokumentasinya. **Bidang** + `Id` — *Wajib:* Nomor (bilangan bulat). Pengidentifikasi unik yang ditetapkan ke bidang ini dalam skema tabel Gunung Es, digunakan untuk evolusi skema dan pelacakan lapangan. + `Name` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 1024 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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. + `Required` – *Wajib:* Boolean. Menunjukkan apakah bidang ini diperlukan (non-nullable) atau opsional (nullable) dalam skema tabel. + `Doc` — String komentar, sepanjang tidak lebih dari 255, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Dokumentasi opsional atau teks deskripsi yang menyediakan konteks tambahan tentang tujuan dan penggunaan bidang ini. ## IcebergTableUpdate struktur Mendefinisikan satu set lengkap pembaruan yang akan diterapkan ke tabel Iceberg, termasuk perubahan skema, modifikasi partisi, penyesuaian urutan urutan, pembaruan lokasi, dan perubahan properti. **Bidang** + `Schema` — *Wajib:* Sebuah objek [IcebergSchema](#aws-glue-api-catalog-tables-IcebergSchema). Definisi skema yang diperbarui untuk tabel Iceberg, menentukan setiap perubahan pada struktur bidang, tipe data, atau metadata skema. + `PartitionSpec` — Sebuah objek [IcebergPartitionSpec](#aws-glue-api-catalog-tables-IcebergPartitionSpec). Spesifikasi partisi yang diperbarui yang mendefinisikan bagaimana data tabel harus ditata ulang dan dipartisi. + `SortOrder` — Sebuah objek [IcebergSortOrder](#aws-glue-api-catalog-tables-IcebergSortOrder). Spesifikasi urutan urutan diperbarui yang mendefinisikan bagaimana data harus diurutkan dalam partisi untuk kinerja kueri yang optimal. + `Location`- *Wajib:* String lokasi, panjangnya tidak lebih dari 2056 byte, cocok dengan. [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) Lokasi S3 yang diperbarui tempat data tabel Iceberg akan disimpan. + `Properties` – Pasangan kunci-nilai yang diperbarui dari properti tabel dan pengaturan konfigurasi untuk tabel Iceberg. ## AuditContext struktur Struktur yang berisi konteks Lake Formation audit. **Bidang** + `AdditionalAuditContext`— String UTF-8, panjangnya tidak lebih dari 2048 byte. String yang berisi informasi konteks audit tambahan. + `RequestedColumns` – Susunan string UTF-8. Kolom yang diminta untuk audit. + `AllColumnsRequested` – Boolean. Semua kolom meminta audit. ## Operasi + [CreateTable tindakan (Python: create\_table)](#aws-glue-api-catalog-tables-CreateTable) + [UpdateTable tindakan (Python: update\_table)](#aws-glue-api-catalog-tables-UpdateTable) + [DeleteTable tindakan (Python: delete\_table)](#aws-glue-api-catalog-tables-DeleteTable) + [BatchDeleteTable tindakan (Python: batch\_delete\_table)](#aws-glue-api-catalog-tables-BatchDeleteTable) + [GetTable tindakan (Python: get\_table)](#aws-glue-api-catalog-tables-GetTable) + [GetTables tindakan (Python: get\_tables)](#aws-glue-api-catalog-tables-GetTables) + [GetTableVersion tindakan (Python: get\_table\_version)](#aws-glue-api-catalog-tables-GetTableVersion) + [GetTableVersions tindakan (Python: get\_table\_versions)](#aws-glue-api-catalog-tables-GetTableVersions) + [DeleteTableVersion tindakan (Python: delete\_table\_version)](#aws-glue-api-catalog-tables-DeleteTableVersion) + [BatchDeleteTableVersion tindakan (Python: batch\_delete\_table\_version)](#aws-glue-api-catalog-tables-BatchDeleteTableVersion) + [SearchTables tindakan (Python: search\_tables)](#aws-glue-api-catalog-tables-SearchTables) + [GetPartitionIndexes tindakan (Python: get\_partition\_indexes)](#aws-glue-api-catalog-tables-GetPartitionIndexes) + [CreatePartitionIndex tindakan (Python: create\_partition\_index)](#aws-glue-api-catalog-tables-CreatePartitionIndex) + [DeletePartitionIndex tindakan (Python: delete\_partition\_index)](#aws-glue-api-catalog-tables-DeletePartitionIndex) + [GetColumnStatisticsForTable tindakan (Python: get\_column\_statistics\_for\_table)](#aws-glue-api-catalog-tables-GetColumnStatisticsForTable) + [UpdateColumnStatisticsForTable tindakan (Python: update\_column\_statistics\_for\_table)](#aws-glue-api-catalog-tables-UpdateColumnStatisticsForTable) + [DeleteColumnStatisticsForTable tindakan (Python: delete\_column\_statistics\_for\_table)](#aws-glue-api-catalog-tables-DeleteColumnStatisticsForTable) ## 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID Katalog Data tempat `Table` dibuat. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default. + `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Basis data katalog di mana tabel baru akan dibuat. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `Name` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Pengidentifikasi unik untuk tabel dalam database tertentu yang akan dibuat dalam Katalog AWS Glue Data. + `TableInput` — Sebuah objek [TableInput](#aws-glue-api-catalog-tables-TableInput). Objek `TableInput` yang mendefinisikan tabel metadata yang akan dibuat dalam katalog. + `PartitionIndexes` — Susunan objek [PartitionIndex](#aws-glue-api-catalog-tables-PartitionIndex), tidak lebih dari 3 struktur. Daftar indeks partisi, struktur `PartitionIndex`, yang akan dibuat dalam tabel. + `TransactionId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Custom string pattern #44](aws-glue-api-common.md#regex_44). ID transaksi. + `OpenTableFormatInput` — Sebuah objek [OpenTableFormatInput](#aws-glue-api-catalog-tables-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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID dari Katalog Data tempat tabel berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default. + `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama basis data katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `Name` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Pengidentifikasi unik untuk tabel dalam database tertentu yang akan dibuat dalam Katalog AWS Glue Data. + `TableInput` — Sebuah objek [TableInput](#aws-glue-api-catalog-tables-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` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Custom string pattern #44](aws-glue-api-common.md#regex_44). ID transaksi untuk memperbarui isi tabel. + `VersionId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID versi untuk memperbarui isi tabel. + `ViewUpdateAction` – String UTF-8 (nilai yang 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 subobject. + `UpdateOpenTableFormatInput` — Sebuah objek [UpdateOpenTableFormatInput](#aws-glue-api-catalog-tables-UpdateOpenTableFormatInput). Parameter masukan 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID dari Katalog Data tempat tabel berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default. + `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama basis data katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `Name` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama tabel yang akan dihapus. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `TransactionId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Custom string pattern #44](aws-glue-api-common.md#regex_44). 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID dari Katalog Data tempat tabel berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default. + `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama basis data katalog di mana tabel yang akan dihapus berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `TablesToDelete` — *Wajib:* Susunan string UTF-8, tidak lebih dari 100 string. Daftar tabel yang akan dihapus. + `TransactionId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Custom string pattern #44](aws-glue-api-common.md#regex_44). ID transaksi untuk menghapus isi tabel. **Respons** + `Errors` – Susunan objek [TableError](#aws-glue-api-catalog-tables-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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID dari Katalog Data tempat tabel berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default. + `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama basis data dalam katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `Name` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama tabel yang untuknya definisi akan diambil. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `TransactionId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Custom string pattern #44](aws-glue-api-common.md#regex_44). ID transaksi untuk membaca isi tabel. + `QueryAsOfTime` — Stempel waktu. Waktu kapan harus membaca isi tabel. Jika tidak diatur, waktu komit transaksi terbaru akan digunakan. Tidak dapat ditentukan bersama dengan`TransactionId`. + `AuditContext` — Sebuah objek [AuditContext](#aws-glue-api-catalog-tables-AuditContext). Struktur yang berisi [konteks Lake Formation audit](https://docs.aws.amazon.com/glue/latest/webapi/API_AuditContext.html). + `IncludeStatusDetails` – Boolean. Menentukan apakah akan menyertakan rincian status yang terkait dengan permintaan untuk membuat atau memperbarui tampilan AWS Glue Data Catalog. **Respons** + `Table` — Sebuah objek [Tabel](#aws-glue-api-catalog-tables-Table). 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID dari Katalog Data tempat tabel-tabel tersebut berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default. + `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Basis data dalam katalog yang tabelnya akan dicantumkan. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `Expression` — String UTF-8, sepanjang tidak lebih dari 2048, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Sebuah pola ekspresi reguler. Jika ada, hanya tabel yang namanya cocok dengan pola saja yang dikembalikan. + `NextToken` – String UTF-8. 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` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Custom string pattern #44](aws-glue-api-common.md#regex_44). ID transaksi untuk membaca isi tabel. + `QueryAsOfTime` — Stempel waktu. Waktu kapan harus membaca isi tabel. Jika tidak diatur, waktu komit transaksi terbaru akan digunakan. Tidak dapat ditentukan bersama dengan`TransactionId`. + `AuditContext` — Sebuah objek [AuditContext](#aws-glue-api-catalog-tables-AuditContext). Struktur yang berisi [konteks Lake Formation audit](https://docs.aws.amazon.com/glue/latest/webapi/API_AuditContext.html). + `IncludeStatusDetails` – Boolean. Menentukan apakah akan menyertakan rincian status yang terkait dengan permintaan untuk membuat atau memperbarui tampilan AWS Glue Data Catalog. + `AttributesToGet` – Susunan string UTF-8. Menentukan bidang tabel dikembalikan oleh `GetTables` panggilan. Parameter ini tidak menerima daftar kosong. Permintaan harus termasuk`NAME`. 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](#aws-glue-api-catalog-tables-Table). Daftar objek `Table` yang diminta. + `NextToken` – String UTF-8. 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID dari Katalog Data tempat tabel-tabel tersebut berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default. + `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Basis data dalam katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `TableName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `VersionId` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](#aws-glue-api-catalog-tables-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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID dari Katalog Data tempat tabel-tabel tersebut berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default. + `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Basis data dalam katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `TableName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `NextToken` – String UTF-8. 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](#aws-glue-api-catalog-tables-TableVersion). Daftar string yang mengidentifikasi versi yang tersedia dari sebuah tabel yang ditentukan. + `NextToken` – String UTF-8. 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID dari Katalog Data tempat tabel-tabel tersebut berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default. + `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Basis data dalam katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `TableName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `VersionId` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID dari Katalog Data tempat tabel-tabel tersebut berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default. + `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Basis data dalam katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `TableName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil. + `VersionIds` — *Wajib:* Susunan string UTF-8, tidak lebih dari 100 string. Daftar versi IDs yang akan dihapus. Sebuah `VersionId` adalah representasi string dari bilangan bulat. Setiap versi bertambah 1. **Respons** + `Errors` – Susunan objek [TableVersionError](#aws-glue-api-catalog-tables-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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Pengidentifikasi unik, terdiri dari `account_id`. + `NextToken` – String UTF-8. Sebuah token kelanjutan, disertakan jika ini adalah sebuah panggilan kelanjutan. + `Filters` – Susunan objek [PropertyPredicate](aws-glue-api-common.md#aws-glue-api-common-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, panjangnya tidak kurang dari 1 atau lebih dari 1024 byte. String yang digunakan untuk pencarian teks. Menentukan nilai dalam filter kutipan berdasarkan kecocokan persis dengan nilai. + `SortCriteria` — Susunan objek [SortCriterion](#aws-glue-api-catalog-tables-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` – String UTF-8 (nilai yang 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 rincian status yang terkait dengan permintaan untuk membuat atau memperbarui tampilan AWS Glue Data Catalog. **Respons** + `NextToken` – String UTF-8. Sebuah token kelanjutan, ada jika segmen daftar saat ini bukan yang terakhir. + `TableList` – Susunan objek [Tabel](#aws-glue-api-catalog-tables-Table). 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID katalog tempat tabel berada. + `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Menentukan nama basis data tempat Anda ingin mengambil indeks partisi. + `TableName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Menentukan nama tabel yang untuknya Anda ingin mengambil indeks partisi. + `NextToken` – String UTF-8. Sebuah token kelanjutan, disertakan jika ini adalah sebuah panggilan kelanjutan. **Respons** + `PartitionIndexDescriptorList` – Susunan objek [PartitionIndexDescriptor](#aws-glue-api-catalog-tables-PartitionIndexDescriptor). Daftar deskriptor indeks. + `NextToken` – String UTF-8. 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID katalog tempat tabel berada. + `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Menentukan nama sebuah basis data di mana Anda ingin membuat sebuah indeks partisi. + `TableName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Menentukan nama sebuah tabel di mana Anda ingin membuat sebuah indeks partisi. + `PartitionIndex` — *Wajib:* Sebuah objek [PartitionIndex](#aws-glue-api-catalog-tables-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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID katalog tempat tabel berada. + `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Menentukan nama sebuah basis data yang ingin Anda hapus indeks partisinya. + `TableName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Menentukan nama sebuah tabel yang ingin Anda hapus indeks partisinya. + `IndexName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID Katalog Data tempat partisi yang dimaksud berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default. + `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama basis data katalog tempat partisi berada. + `TableName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama tabel partisi. + `ColumnNames` — *Wajib:* Susunan string UTF-8, tidak lebih dari 100 string. Daftar nama kolom. **Respons** + `ColumnStatisticsList` – Susunan objek [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics). Daftar ColumnStatistics. + `Errors` – Susunan objek [ColumnError](aws-glue-api-common.md#aws-glue-api-common-ColumnError). Daftar ColumnStatistics yang 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID Katalog Data tempat partisi yang dimaksud berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default. + `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama basis data katalog tempat partisi berada. + `TableName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama tabel partisi. + `ColumnStatisticsList` — *Wajib:* Susunan objek [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics), tidak lebih dari 25 struktur. Daftar statistik kolom. **Respons** + `Errors` – Susunan objek [ColumnStatisticsError](aws-glue-api-common.md#aws-glue-api-common-ColumnStatisticsError). Daftar ColumnStatisticsErrors. **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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID Katalog Data tempat partisi yang dimaksud berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default. + `DatabaseName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama basis data katalog tempat partisi berada. + `TableName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama tabel partisi. + `ColumnName` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nama kolom. **Respons** + *Tidak ada parameter Respons.* **Kesalahan** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException`