Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # API partisi API Partisi menjelaskan tipe data dan operasi yang digunakan untuk bekerja dengan partisi. ## Jenis Data + [Struktur partisi](#aws-glue-api-catalog-partitions-Partition) + [PartitionInput struktur](#aws-glue-api-catalog-partitions-PartitionInput) + [PartitionSpecWithSharedStorageDescriptor struktur](#aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor) + [PartitionListComposingSpec struktur](#aws-glue-api-catalog-partitions-PartitionListComposingSpec) + [PartitionSpecProxy struktur](#aws-glue-api-catalog-partitions-PartitionSpecProxy) + [PartitionValueList struktur](#aws-glue-api-catalog-partitions-PartitionValueList) + [Struktur segmen](#aws-glue-api-catalog-partitions-Segment) + [PartitionError struktur](#aws-glue-api-catalog-partitions-PartitionError) + [BatchUpdatePartitionFailureEntry struktur](#aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry) + [BatchUpdatePartitionRequestEntry struktur](#aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry) + [StorageDescriptor struktur](#aws-glue-api-catalog-partitions-StorageDescriptor) + [SchemaReference struktur](#aws-glue-api-catalog-partitions-SchemaReference) + [SerDeInfo struktur](#aws-glue-api-catalog-partitions-SerDeInfo) + [SkewedInfo struktur](#aws-glue-api-catalog-partitions-SkewedInfo) ## Struktur partisi Merupakan sepotong data tabel. **Bidang** + `Values` – Susunan string UTF-8. Nilai-nilai partisi. + `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 tempat partisi akan dibuat. + `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 basis data tempat partisi akan dibuat. + `CreationTime` — Stempel waktu. Waktu pembuatan partisi. + `LastAccessTime` — Stempel waktu. Waktu saat partisi terakhir kali diakses. + `StorageDescriptor` — Sebuah objek [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor). Sediakan informasi tentang lokasi fisik di mana partisi disimpan. + `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 parameter partisi. + `LastAnalyzedTime` — Stempel waktu. Terakhir kali statistik kolom dikomputasi untuk partisi ini. + `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 partisi berada. ## PartitionInput struktur Struktur yang digunakan untuk membuat dan memperbarui partisi. **Bidang** + `Values` – Susunan string UTF-8. Nilai-nilai partisi. Meskipun parameter ini tidak diperlukan oleh SDK, Anda harus menentukan parameter ini untuk input yang valid. Nilai kunci untuk partisi baru harus dilewatkan sebagai array objek String yang harus dipesan dalam urutan yang sama seperti kunci partisi yang muncul di prefiks Amazon S3. Jika tidak, AWS Glue akan menambahkan nilai ke kunci yang salah. + `LastAccessTime` — Stempel waktu. Waktu saat partisi terakhir kali diakses. + `StorageDescriptor` — Sebuah objek [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor). Sediakan informasi tentang lokasi fisik di mana partisi disimpan. + `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 parameter partisi. + `LastAnalyzedTime` — Stempel waktu. Terakhir kali statistik kolom dikomputasi untuk partisi ini. ## PartitionSpecWithSharedStorageDescriptor struktur Sebuah spesifikasi partisi untuk partisi yang berbagi lokasi fisik. **Bidang** + `StorageDescriptor` — Sebuah objek [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor). Informasi penyimpanan fisik bersama. + `Partitions` – Susunan objek [Partisi](#aws-glue-api-catalog-partitions-Partition). Daftar partisi yang berbagi lokasi fisik ini. ## PartitionListComposingSpec struktur Daftar partisi terkait. **Bidang** + `Partitions` – Susunan objek [Partisi](#aws-glue-api-catalog-partitions-Partition). Daftar partisi dalam spesifikasi penyusunan. ## PartitionSpecProxy struktur Menyediakan path root untuk partisi yang ditentukan. **Bidang** + `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). Katalog basis data di mana partisi berada. + `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 berisi partisi. + `RootPath` — 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). Path akar dari proxy untuk pengalamatan partisi. + `PartitionSpecWithSharedSD` — Sebuah objek [PartitionSpecWithSharedStorageDescriptor](#aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor). Spesifikasi partisi yang berbagi lokasi penyimpanan fisik yang sama. + `PartitionListComposingSpec` — Sebuah objek [PartitionListComposingSpec](#aws-glue-api-catalog-partitions-PartitionListComposingSpec). Menentukan daftar partisi. ## PartitionValueList struktur Berisi daftar nilai yang mendefinisikan partisi. **Bidang** + `Values` – *Wajib:* Susunan string UTF-8. Daftar nilai. ## Struktur segmen Mendefinisikan wilayah yang tidak bertumpang tindih dari partisi tabel ini, memungkinkan beberapa permintaan untuk dijalankan secara paralel. **Bidang** + `SegmentNumber` — *Wajib:* Nomor (bilangan bulat), tidak lebih dari Tidak Ada. Nomor indeks berbasis-nol dari segmen. Sebagai contoh, jika jumlah segmen adalah 4, nilai `SegmentNumber` berkisar dari 0 sampai 3. + `TotalSegments` — *Wajib:* Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 10. Jumlah total segmen. ## PartitionError struktur Berisi informasi tentang sebuah kesalahan partisi. **Bidang** + `PartitionValues` – Susunan string UTF-8. Nilai yang menentukan partisi. + `ErrorDetail` — Sebuah objek [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail). Detail tentang kesalahan partisi. ## BatchUpdatePartitionFailureEntry struktur Berisi informasi tentang kesalahan partisi pembaruan batch. **Bidang** + `PartitionValueList` — Susunan string UTF-8, tidak lebih dari 100 string. Daftar nilai yang mendefinisikan partisi. + `ErrorDetail` — Sebuah objek [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail). Detail tentang kesalahan partisi pembaruan batch. ## BatchUpdatePartitionRequestEntry struktur Struktur yang berisi nilai-nilai dan struktur yang digunakan untuk memperbarui partisi. **Bidang** + `PartitionValueList` — *Wajib:* Susunan string UTF-8, tidak lebih dari 100 string. Daftar nilai yang mendefinisikan partisi. + `PartitionInput` — *Wajib:* Sebuah objek [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput). Struktur yang digunakan untuk memperbarui sebuah partisi. ## StorageDescriptor struktur Menjelaskan penyimpanan fisik data tabel. **Bidang** + `Columns` – Susunan objek [Kolom](aws-glue-api-catalog-tables.md#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-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.md#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-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-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 dari 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 ## 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. ## Operasi + [CreatePartition tindakan (Python: create\$1partition)](#aws-glue-api-catalog-partitions-CreatePartition) + [BatchCreatePartition tindakan (Python: batch\$1create\$1partition)](#aws-glue-api-catalog-partitions-BatchCreatePartition) + [UpdatePartition tindakan (Python: update\$1partition)](#aws-glue-api-catalog-partitions-UpdatePartition) + [DeletePartition tindakan (Python: delete\$1partition)](#aws-glue-api-catalog-partitions-DeletePartition) + [BatchDeletePartition tindakan (Python: batch\$1delete\$1partition)](#aws-glue-api-catalog-partitions-BatchDeletePartition) + [GetPartition tindakan (Python: get\$1partition)](#aws-glue-api-catalog-partitions-GetPartition) + [GetPartitions tindakan (Python: get\$1partitions)](#aws-glue-api-catalog-partitions-GetPartitions) + [BatchGetPartition tindakan (Python: batch\$1get\$1partition)](#aws-glue-api-catalog-partitions-BatchGetPartition) + [BatchUpdatePartition tindakan (Python: batch\$1update\$1partition)](#aws-glue-api-catalog-partitions-BatchUpdatePartition) + [GetColumnStatisticsForPartition tindakan (Python: get\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-GetColumnStatisticsForPartition) + [UpdateColumnStatisticsForPartition tindakan (Python: update\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-UpdateColumnStatisticsForPartition) + [DeleteColumnStatisticsForPartition tindakan (Python: delete\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-DeleteColumnStatisticsForPartition) ## CreatePartition tindakan (Python: create\$1partition) Membuat sebuah partisi baru. **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 AWS akun katalog tempat partisi akan dibuat. + `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 metadata di mana partisi akan dibuat. + `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 metadata di mana partisi akan dibuat. + `PartitionInput` — *Wajib:* Sebuah objek [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput). Struktur `PartitionInput` mendefinisikan partisi yang akan dibuat. **Respons** + *Tidak ada parameter Respons.* **Kesalahan** + `InvalidInputException` + `AlreadyExistsException` + `ResourceNumberLimitExceededException` + `InternalServiceException` + `EntityNotFoundException` + `OperationTimeoutException` + `GlueEncryptionException` ## BatchCreatePartition tindakan (Python: batch\$1create\$1partition) Menciptakan satu atau beberapa partisi dalam operasi batch. **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 di mana partisi akan dibuat. Saat ini, ini harus menjadi ID AWS akun. + `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 metadata di mana partisi akan dibuat. + `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 metadata di mana partisi akan dibuat. + `PartitionInputList` — *Wajib:* Susunan objek [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput), tidak lebih dari 100 struktur. Daftar struktur `PartitionInput` yang menentukan partisi yang akan dibuat. **Respons** + `Errors` – Susunan objek [PartitionError](#aws-glue-api-catalog-partitions-PartitionError). Kesalahan yang dihadapi saat mencoba membuat partisi yang diminta. **Kesalahan** + `InvalidInputException` + `AlreadyExistsException` + `ResourceNumberLimitExceededException` + `InternalServiceException` + `EntityNotFoundException` + `OperationTimeoutException` + `GlueEncryptionException` ## UpdatePartition tindakan (Python: update\$1partition) Memperbarui sebuah partisi. **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 di mana partisi yang akan diperbarui 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 dimaksud 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 tempat partisi yang akan diperbarui berada. + `PartitionValueList` — *Wajib:* Susunan string UTF-8, tidak lebih dari 100 string. Daftar nilai kunci partisi yang menentukan partisi yang akan diperbarui. + `PartitionInput` — *Wajib:* Sebuah objek [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput). Objek partisi baru untuk memperbarui partisi. Properti `Values` tidak dapat diubah. Jika Anda ingin mengubah nilai kunci partisi untuk sebuah partisi, hapus dan buat ulang partisi. **Respons** + *Tidak ada parameter Respons.* **Kesalahan** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` ## DeletePartition tindakan (Python: delete\$1partition) Menghapus partisi 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 di mana partisi yang akan dihapus 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 dimaksud 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 yang berisi partisi yang akan dihapus. + `PartitionValues` – *Wajib:* Susunan string UTF-8. Nilai yang menentukan partisi. **Respons** + *Tidak ada parameter Respons.* **Kesalahan** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` ## BatchDeletePartition tindakan (Python: batch\$1delete\$1partition) Menghapus satu atau beberapa partisi dalam sebuah operasi batch. **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 di mana partisi yang akan dihapus 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 dimaksud 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 yang berisi partisi yang akan dihapus. + `PartitionsToDelete` — *Wajib:* Susunan objek [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList), tidak lebih dari 25 struktur. Daftar struktur `PartitionInput` yang menentukan partisi yang akan dihapus. **Respons** + `Errors` – Susunan objek [PartitionError](#aws-glue-api-catalog-partitions-PartitionError). Kesalahan yang ditemui saat mencoba menghapus partisi yang diminta. **Kesalahan** + `InvalidInputException` + `EntityNotFoundException` + `InternalServiceException` + `OperationTimeoutException` ## GetPartition tindakan (Python: get\$1partition) Mengambil informasi tentang sebuah partisi 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 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. + `PartitionValues` – *Wajib:* Susunan string UTF-8. Nilai yang menentukan partisi. **Respons** + `Partition` — Sebuah objek [Partisi](#aws-glue-api-catalog-partitions-Partition). Informasi yang diminta, dalam bentuk objek `Partition`. **Kesalahan** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` + `FederationSourceException` + `FederationSourceRetryableException` ## GetPartitions tindakan (Python: get\$1partitions) Mengambil informasi tentang partisi dalam 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 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. + `Expression` — String predikat, sepanjang tidak lebih dari 2048 byte, yang cocok dengan [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri). Ekspresi yang menyaring partisi yang akan dikembalikan. Ekspresi menggunakan sintaksis SQL yang mirip dengan klausul filter `WHERE` SQL. Parser pernyataan SQL [JSQLParser](http://jsqlparser.sourceforge.net/home.php)mem-parsing ekspresi. *Operator*: Berikut ini adalah operator yang dapat Anda gunakan dalam panggilan API `Expression`: = Periksa apakah nilai-nilai dari dua operan adalah sama; jika ya, maka syarat menjadi BETUL. Contoh: Asumsikan 'variabel a' adalah 10 dan 'variabel b' adalah 20. (a = b) tidak BETUL. < > Periksa apakah nilai-nilai dari dua operan adalah sama; jika nilainya tidak sama, maka syarat menjadi BETUL. Contoh: (< > b) BETUL. > Periksa apakah nilai operan kiri lebih besar dari nilai operan kanan; jika ya, maka syarat menjadi BETUL. Contoh: (a> b) tidak BETUL. < Periksa apakah nilai operan kiri lebih kecil dari nilai operan kanan; jika ya, maka syarat menjadi BETUL. Contoh: (a < b) adalah BETUL. >= Periksa apakah nilai operan kiri lebih besar dari atau sama dengan nilai operan kanan; jika ya, maka syarat menjadi BETUL. Contoh: (a> = b) tidak BETUL. <= Periksa apakah nilai operan kiri lebih kecil dari atau sama dengan nilai operan kanan; jika ya, maka syarat menjadi BETUL. Contoh: (a <= b) benar. DAN, ATAU, DI, ANTARA, SEPERTI, TIDAK, ADALAH NOL Operator logistik. *Jenis Kunci Partisi yang Didukung*: Berikut ini adalah kunci partisi yang didukung. + `string` + `date` + `timestamp` + `int` + `bigint` + `long` + `tinyint` + `smallint` + `decimal` Jika ada jenis kunci yang ditemui yang tidak valid, maka pengecualian dilemparkan. Daftar berikut menunjukkan operator yang valid pada masing-masing jenis. Bila Anda menentukan sebuah crawler, jenis `partitionKey` dibuat sebagai `STRING`, agar kompatibel dengan partisi katalog. *Panggilan API Sampel*: **Example** Tabel `twitter_partition` memiliki tiga partisi: ``` year = 2015 year = 2016 year = 2017 ``` **Example** Ambil partisi `year` sama dengan 2015 ``` aws glue get-partitions --database-name dbname --table-name twitter_partition --expression "year*=*'2015'" ``` **Example** Ambil partisi `year` antara 2016 dan 2018 (eksklusif) ``` aws glue get-partitions --database-name dbname --table-name twitter_partition --expression "year>'2016' AND year<'2018'" ``` **Example** Ambil partisi `year` antara 2015 dan 2018 (inklusif). Panggilan API berikut setara satu sama lain: ``` aws glue get-partitions --database-name dbname --table-name twitter_partition --expression "year>='2015' AND year<='2018'" aws glue get-partitions --database-name dbname --table-name twitter_partition --expression "year BETWEEN 2015 AND 2018" aws glue get-partitions --database-name dbname --table-name twitter_partition --expression "year IN (2015,2016,2017,2018)" ``` **Example** Filter partisi wildcard, di mana output panggilan berikut adalah partisi tahun=2017. Sebuah ekspresi reguler tidak didukung di `LIKE`. ``` aws glue get-partitions --database-name dbname --table-name twitter_partition --expression "year LIKE '%7'" ``` + `NextToken` – String UTF-8. Sebuah token kelanjutan, jika ini bukan panggilan pertama untuk mengambil partisi ini. + `Segment` — Sebuah objek [Segment](#aws-glue-api-catalog-partitions-Segment). Segmen tabel partisi yang akan dipindai dalam permintaan ini. + `MaxResults` — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 1000. Jumlah maksimum partisi yang akan dikembalikan dalam satu respons tunggal. + `ExcludeColumnSchema` – Boolean. Ketika benar, menentukan tidak mengembalikan skema kolom partisi. Berguna bila Anda hanya tertarik pada atribut partisi lain seperti nilai partisi atau lokasi. Pendekatan ini menghindari masalah respons besar dengan tidak mengembalikan data duplikat. + `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 di mana untuk membaca isi partisi. + `QueryAsOfTime` — Stempel waktu. Waktu kapan harus membaca isi partisi. Jika tidak diatur, waktu komit transaksi terbaru akan digunakan. Tidak dapat ditentukan bersama dengan`TransactionId`. **Respons** + `Partitions` – Susunan objek [Partisi](#aws-glue-api-catalog-partitions-Partition). Daftar partisi yang diminta. + `NextToken` – String UTF-8. Sebuah token kelanjutan, jika daftar partisi yang dikembalikan tidak termasuk yang terakhir. **Kesalahan** + `EntityNotFoundException` + `InvalidInputException` + `OperationTimeoutException` + `InternalServiceException` + `GlueEncryptionException` + `InvalidStateException` + `ResourceNotReadyException` + `FederationSourceException` + `FederationSourceRetryableException` ## BatchGetPartition tindakan (Python: batch\$1get\$1partition) Mengambil partisi dalam sebuah permintaan batch. **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. + `PartitionsToGet` — *Wajib:* Susunan objek [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList), tidak lebih dari 1000 struktur. Daftar nilai partisi yang mengidentifikasi partisi yang akan diambil. **Respons** + `Partitions` – Susunan objek [Partisi](#aws-glue-api-catalog-partitions-Partition). Daftar partisi yang diminta. + `UnprocessedKeys` — Susunan objek [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList), tidak lebih dari 1000 struktur. Daftar nilai partisi dalam permintaan yang untuknya partisi tidak dikembalikan. **Kesalahan** + `InvalidInputException` + `EntityNotFoundException` + `OperationTimeoutException` + `InternalServiceException` + `GlueEncryptionException` + `InvalidStateException` + `FederationSourceException` + `FederationSourceRetryableException` ## BatchUpdatePartition tindakan (Python: batch\$1update\$1partition) Memperbarui satu atau beberapa partisi dalam sebuah operasi batch. **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 di mana partisi akan diperbarui. Saat ini, ini harus menjadi ID AWS akun. + `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 metadata di mana partisi akan diperbarui. + `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 metadata di mana partisi akan diperbarui. + `Entries` — *Wajib:* Susunan objek [BatchUpdatePartitionRequestEntry](#aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry), tidak kurang dari 1 atau lebih dari 100 struktur. Daftar dari hingga 100 objek `BatchUpdatePartitionRequestEntry` yang akan diperbarui. **Respons** + `Errors` – Susunan objek [BatchUpdatePartitionFailureEntry](#aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry). Kesalahan yang ditemui saat mencoba memperbarui partisi yang diminta. Sebuah daftar objek `BatchUpdatePartitionFailureEntry`. **Kesalahan** + `InvalidInputException` + `EntityNotFoundException` + `OperationTimeoutException` + `InternalServiceException` + `GlueEncryptionException` ## GetColumnStatisticsForPartition tindakan (Python: get\$1column\$1statistics\$1for\$1partition) Mengambil statistik partisi kolom. Izin Identity and Access Management (IAM) yang diperlukan untuk operasi ini adalah `GetPartition`. **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. + `PartitionValues` – *Wajib:* Susunan string UTF-8. Daftar nilai partisi yang mengidentifikasi 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 yang gagal diambil. + `Errors` – Susunan objek [ColumnError](aws-glue-api-common.md#aws-glue-api-common-ColumnError). Terjadi kesalahan saat mengambil data statistik kolom. **Kesalahan** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` ## UpdateColumnStatisticsForPartition tindakan (Python: update\$1column\$1statistics\$1for\$1partition) Membuat atau memperbarui statistik partisi kolom. Izin Identity and Access Management (IAM) yang diperlukan untuk operasi ini adalah `UpdatePartition`. **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. + `PartitionValues` – *Wajib:* Susunan string UTF-8. Daftar nilai partisi yang mengidentifikasi 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). Terjadi kesalahan saat memperbarui data statistik kolom. **Kesalahan** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` ## DeleteColumnStatisticsForPartition tindakan (Python: delete\$1column\$1statistics\$1for\$1partition) Menghapus statistik kolom partisi dari sebuah kolom. Izin Identity and Access Management (IAM) yang diperlukan untuk operasi ini adalah `DeletePartition`. **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. + `PartitionValues` – *Wajib:* Susunan string UTF-8. Daftar nilai partisi yang mengidentifikasi 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 kolomnya. **Respons** + *Tidak ada parameter Respons.* **Kesalahan** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException`