Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# API objek katalog
API objek Katalog menjelaskan tipe data dan API yang terkait dengan bekerja dengan katalog di. AWS Glue
**Topics**
+ [Katalog API](aws-glue-api-catalog-catalogs.md)
+ [API basis data](aws-glue-api-catalog-databases.md)
+ [Tabel API](aws-glue-api-catalog-tables.md)
+ [API partisi](aws-glue-api-catalog-partitions.md)
+ [Koneksi API](aws-glue-api-catalog-connections.md)
+ [API Fungsi yang ditentukan pengguna](aws-glue-api-catalog-functions.md)
+ [Mengimpor Athena katalog ke AWS Glue](aws-glue-api-catalog-migration.md)
# Katalog API
API Katalog menjelaskan APIs untuk membuat, menghapus, menemukan, memperbarui, dan mencantumkan katalog.
## Jenis Data
+ [Struktur katalog](#aws-glue-api-catalog-catalogs-Catalog)
+ [CatalogInput struktur](#aws-glue-api-catalog-catalogs-CatalogInput)
+ [TargetRedshiftCatalog struktur](#aws-glue-api-catalog-catalogs-TargetRedshiftCatalog)
+ [CatalogProperties struktur](#aws-glue-api-catalog-catalogs-CatalogProperties)
+ [CatalogPropertiesOutput struktur](#aws-glue-api-catalog-catalogs-CatalogPropertiesOutput)
+ [DataLakeAccessProperties struktur](#aws-glue-api-catalog-catalogs-DataLakeAccessProperties)
+ [IcebergOptimizationProperties struktur](#aws-glue-api-catalog-catalogs-IcebergOptimizationProperties)
+ [DataLakeAccessPropertiesOutput struktur](#aws-glue-api-catalog-catalogs-DataLakeAccessPropertiesOutput)
+ [IcebergOptimizationPropertiesOutput struktur](#aws-glue-api-catalog-catalogs-IcebergOptimizationPropertiesOutput)
+ [FederatedCatalog struktur](#aws-glue-api-catalog-catalogs-FederatedCatalog)
## Struktur katalog
Objek katalog mewakili pengelompokan logis database dalam Katalog AWS Glue Data atau sumber federasi. Sekarang Anda dapat membuat katalog federasi RedShift atau katalog yang berisi tautan sumber daya ke database Redshift di akun atau wilayah lain.
**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 katalog. Untuk memberikan akses ke katalog default, bidang ini tidak boleh disediakan.
+ `Name`- *Wajib:* UTF-8 string, tidak kurang dari 1 atau lebih dari 64 byte panjang, cocok dengan. [Custom string pattern #25](aws-glue-api-common.md#regex_25)
Nama katalog. Tidak bisa sama dengan ID akun.
+ `ResourceArn` – String UTF-8.
Nama Sumber Daya Amazon (ARN) ditetapkan ke sumber daya katalog.
+ `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 string, panjangnya tidak lebih dari 2048 byte, cocok dengan pola string multi-baris alamat URI. Deskripsi katalog.
+ `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.
Sebuah array peta pasangan kunci-nilai yang menentukan parameter dan properti katalog.
+ `CreateTime` — Stempel waktu.
Waktu di mana katalog dibuat.
+ `UpdateTime` — Stempel waktu.
Waktu di mana katalog terakhir diperbarui.
+ `TargetRedshiftCatalog` — Sebuah objek [TargetRedshiftCatalog](#aws-glue-api-catalog-catalogs-TargetRedshiftCatalog).
`TargetRedshiftCatalog`Objek yang menjelaskan katalog target untuk penautan sumber daya database.
+ `FederatedCatalog` — Sebuah objek [FederatedCatalog](#aws-glue-api-catalog-catalogs-FederatedCatalog).
`FederatedCatalog`Objek yang menunjuk ke entitas di luar Katalog AWS Glue Data.
+ `CatalogProperties` — Sebuah objek [CatalogPropertiesOutput](#aws-glue-api-catalog-catalogs-CatalogPropertiesOutput).
`CatalogProperties`Objek yang menentukan properti akses danau data dan properti kustom lainnya.
+ `CreateTableDefaultPermissions` – Susunan objek [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions).
Susunan objek `PrincipalPermissions`. Membuat satu set izin default pada tabel (s) untuk prinsipal. Digunakan oleh AWS Lake Formation. Tidak digunakan dalam AWS Glue operasi normal.
+ `CreateDatabaseDefaultPermissions` – Susunan objek [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions).
Susunan objek `PrincipalPermissions`. Membuat satu set izin default pada database (s) untuk prinsipal. Digunakan oleh AWS Lake Formation. Tidak digunakan dalam AWS Glue operasi normal.
+ `AllowFullTableExternalDataAccess` – String UTF-8 (nilai yang valid: `True` \$1 `False`).
Memungkinkan mesin pihak ketiga untuk mengakses data di Amazon S3 lokasi yang terdaftar di Lake Formation.
## CatalogInput struktur
Struktur yang menggambarkan properti katalog.
**Bidang**
+ `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 string, panjangnya tidak lebih dari 2048 byte, cocok dengan pola string multi-baris alamat URI. Deskripsi katalog.
+ `FederatedCatalog` — Sebuah objek [FederatedCatalog](#aws-glue-api-catalog-catalogs-FederatedCatalog).
Sebuah objek `FederatedCatalog`. `FederatedCatalog`Struktur yang mereferensikan entitas di luar Katalog AWS Glue Data, misalnya database Redshift.
+ `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.
Sebuah array peta pasangan kunci-nilai yang menentukan parameter dan properti katalog.
+ `TargetRedshiftCatalog` — Sebuah objek [TargetRedshiftCatalog](#aws-glue-api-catalog-catalogs-TargetRedshiftCatalog).
`TargetRedshiftCatalog`Objek yang menjelaskan katalog target untuk penautan sumber daya.
+ `CatalogProperties` — Sebuah objek [CatalogProperties](#aws-glue-api-catalog-catalogs-CatalogProperties).
`CatalogProperties`Objek yang menentukan properti akses danau data dan properti kustom lainnya.
+ `CreateTableDefaultPermissions` – Susunan objek [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions).
Susunan objek `PrincipalPermissions`. Membuat satu set izin default pada tabel (s) untuk prinsipal. Digunakan oleh AWS Lake Formation. Biasanya harus secara eksplisit ditetapkan sebagai daftar kosong.
+ `CreateDatabaseDefaultPermissions` – Susunan objek [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions).
Susunan objek `PrincipalPermissions`. Membuat satu set izin default pada database (s) untuk prinsipal. Digunakan oleh AWS Lake Formation. Biasanya harus secara eksplisit ditetapkan sebagai daftar kosong.
+ `AllowFullTableExternalDataAccess` – String UTF-8 (nilai yang valid: `True` \$1 `False`).
Memungkinkan mesin pihak ketiga untuk mengakses data di Amazon S3 lokasi yang terdaftar di Lake Formation.
## TargetRedshiftCatalog struktur
Struktur yang menjelaskan katalog target untuk penautan sumber daya.
**Bidang**
+ `CatalogArn` – *Wajib:* String UTF-8.
Nama Sumber Daya Amazon (ARN) dari sumber daya katalog.
## CatalogProperties struktur
Struktur yang menentukan properti akses danau data dan properti kustom lainnya.
**Bidang**
+ `DataLakeAccessProperties` — Sebuah objek [DataLakeAccessProperties](#aws-glue-api-catalog-catalogs-DataLakeAccessProperties).
`DataLakeAccessProperties`Objek yang menentukan properti untuk mengonfigurasi akses data lake untuk sumber daya katalog Anda di Katalog AWS Glue Data.
+ `IcebergOptimizationProperties` — Sebuah objek [IcebergOptimizationProperties](#aws-glue-api-catalog-catalogs-IcebergOptimizationProperties).
Struktur yang menentukan properti optimasi tabel Iceberg untuk katalog. Ini termasuk konfigurasi untuk operasi pemadatan, retensi, dan penghapusan file yatim piatu yang dapat diterapkan ke tabel Iceberg dalam katalog ini.
+ `CustomProperties` – 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 nilai kunci tambahan untuk katalog, seperti pengoptimalan statistik kolom.
## CatalogPropertiesOutput struktur
Atribut properti yang menyertakan properti konfigurasi untuk sumber daya katalog.
**Bidang**
+ `DataLakeAccessProperties` — Sebuah objek [DataLakeAccessPropertiesOutput](#aws-glue-api-catalog-catalogs-DataLakeAccessPropertiesOutput).
`DataLakeAccessProperties`Objek dengan properti input untuk mengonfigurasi akses data lake untuk sumber daya katalog Anda di Katalog AWS Glue Data.
+ `IcebergOptimizationProperties` — Sebuah objek [IcebergOptimizationPropertiesOutput](#aws-glue-api-catalog-catalogs-IcebergOptimizationPropertiesOutput).
`IcebergOptimizationPropertiesOutput`Objek yang menentukan setelan pengoptimalan tabel Iceberg untuk katalog, termasuk konfigurasi untuk operasi pemadatan, retensi, dan penghapusan file yatim piatu.
+ `CustomProperties` – 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 nilai kunci tambahan untuk katalog, seperti pengoptimalan statistik kolom.
## DataLakeAccessProperties struktur
Input properti untuk mengonfigurasi akses data lake untuk sumber daya katalog Anda di Katalog AWS Glue Data.
**Bidang**
+ `DataLakeAccess` – Boolean.
Mengaktifkan atau menonaktifkan akses data lake untuk aplikasi Apache Spark yang mengakses database Amazon Redshift di Katalog Data dari mesin non-Redshift apa pun, seperti Amazon Athena, Amazon EMR, atau ETL. AWS Glue
+ `DataTransferRole` — String UTF-8, yang cocok dengan [Custom string pattern #53](aws-glue-api-common.md#regex_53).
Peran yang akan diasumsikan oleh AWS Glue untuk mentransfer data into/out bucket staging selama kueri.
+ `KmsKey` – String UTF-8.
Kunci enkripsi yang akan digunakan untuk bucket pementasan yang akan dibuat bersama dengan katalog.
+ `CatalogType` — 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 jenis katalog federasi untuk sumber daya katalog asli. Jenis yang didukung saat ini adalah`aws:redshift`.
## IcebergOptimizationProperties struktur
Struktur yang menentukan properti pengoptimalan tabel Iceberg untuk katalog, termasuk konfigurasi untuk operasi pemadatan, retensi, dan penghapusan file yatim piatu.
**Bidang**
+ `RoleArn` — String UTF-8, yang cocok dengan [Custom string pattern #53](aws-glue-api-common.md#regex_53).
Nama Sumber Daya Amazon (ARN) dari peran IAM yang akan diasumsikan untuk melakukan operasi pengoptimalan tabel Iceberg.
+ `Compaction` – 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.
Peta pasangan nilai kunci yang menentukan parameter konfigurasi untuk operasi pemadatan tabel Iceberg, yang mengoptimalkan tata letak file data untuk meningkatkan kinerja kueri.
+ `Retention` – 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.
Peta pasangan nilai kunci yang menentukan parameter konfigurasi untuk operasi retensi tabel Iceberg, yang mengelola siklus hidup snapshot tabel untuk mengontrol biaya penyimpanan.
+ `OrphanFileDeletion` – 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.
Peta pasangan nilai kunci yang menentukan parameter konfigurasi untuk operasi penghapusan file yatim Iceberg, yang mengidentifikasi dan menghapus file yang tidak lagi direferensikan oleh metadata tabel.
## DataLakeAccessPropertiesOutput struktur
Properti keluaran konfigurasi akses danau data untuk sumber daya katalog Anda di Katalog AWS Glue Data.
**Bidang**
+ `DataLakeAccess` – Boolean.
Mengaktifkan atau menonaktifkan akses data lake untuk aplikasi Apache Spark yang mengakses database Amazon Redshift di Katalog Data.
+ `DataTransferRole` — String UTF-8, yang cocok dengan [Custom string pattern #53](aws-glue-api-common.md#regex_53).
Peran yang akan diasumsikan oleh AWS Glue untuk mentransfer data into/out bucket staging selama kueri.
+ `KmsKey` – String UTF-8.
Kunci enkripsi yang akan digunakan untuk bucket pementasan yang akan dibuat bersama dengan katalog.
+ `ManagedWorkgroupName` — 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 komputasi Redshift Tanpa Server terkelola yang dibuat untuk sumber daya katalog Anda.
+ `ManagedWorkgroupStatus` — 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).
Status komputasi Redshift Tanpa Server yang dikelola.
+ `RedshiftDatabaseName` — 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 sumber daya database Redshift default dalam komputasi terkelola.
+ `StatusMessage` — 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).
Pesan yang memberikan informasi lebih rinci tentang status workgroup terkelola.
+ `CatalogType` — 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 jenis katalog federasi untuk sumber daya katalog asli. Jenis yang didukung saat ini adalah`aws:redshift`.
## IcebergOptimizationPropertiesOutput struktur
Struktur yang berisi properti keluaran konfigurasi pengoptimalan tabel Iceberg untuk sumber daya katalog Anda di Katalog AWS Glue Data.
**Bidang**
+ `RoleArn` — String UTF-8, yang cocok dengan [Custom string pattern #53](aws-glue-api-common.md#regex_53).
Nama Sumber Daya Amazon (ARN) dari peran IAM yang digunakan untuk melakukan operasi pengoptimalan tabel Iceberg.
+ `Compaction` – 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.
Peta pasangan nilai kunci yang menentukan parameter konfigurasi untuk operasi pemadatan tabel Iceberg, yang mengoptimalkan tata letak file data untuk meningkatkan kinerja kueri.
+ `Retention` – 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.
Peta pasangan nilai kunci yang menentukan parameter konfigurasi untuk operasi retensi tabel Iceberg, yang mengelola siklus hidup snapshot tabel untuk mengontrol biaya penyimpanan.
+ `OrphanFileDeletion` – 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.
Peta pasangan nilai kunci yang menentukan parameter konfigurasi untuk operasi penghapusan file yatim Iceberg, yang mengidentifikasi dan menghapus file yang tidak lagi direferensikan oleh metadata tabel.
+ `LastUpdatedTime` — Stempel waktu.
Stempel waktu ketika properti optimasi Iceberg terakhir diperbarui.
## FederatedCatalog struktur
Katalog yang menunjuk ke entitas di luar Katalog AWS Glue Data.
**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 katalog 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 sumber data eksternal, misalnya katalog federasi RedShift.
+ `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 katalog federasi, menentukan protokol atau metode untuk koneksi ke sumber data eksternal.
## Operasi
+ [CreateCatalog tindakan (Python: create\$1catalog)](#aws-glue-api-catalog-catalogs-CreateCatalog)
+ [UpdateCatalog tindakan (Python: update\$1catalog)](#aws-glue-api-catalog-catalogs-UpdateCatalog)
+ [DeleteCatalog tindakan (Python: delete\$1catalog)](#aws-glue-api-catalog-catalogs-DeleteCatalog)
+ [GetCatalog tindakan (Python: get\$1catalog)](#aws-glue-api-catalog-catalogs-GetCatalog)
+ [GetCatalogs tindakan (Python: get\$1catalogs)](#aws-glue-api-catalog-catalogs-GetCatalogs)
## CreateCatalog tindakan (Python: create\$1catalog)
Membuat katalog baru di Katalog AWS Glue Data.
**Permintaan**
+ `Name`- *Wajib:* UTF-8 string, tidak kurang dari 1 atau lebih dari 64 byte panjang, cocok dengan. [Custom string pattern #25](aws-glue-api-common.md#regex_25)
Nama katalog yang akan dibuat.
+ `CatalogInput` — *Wajib:* Sebuah objek [CatalogInput](#aws-glue-api-catalog-catalogs-CatalogInput).
`CatalogInput`Objek yang mendefinisikan metadata untuk katalog.
+ `Tags` — Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 50 pasang.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak lebih dari 256 byte.
Sebuah array peta pasangan kunci-nilai, tidak lebih dari 50 pasang. Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte. Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak lebih dari 256 byte. Tag yang Anda tetapkan ke katalog.
**Respons**
+ *Tidak ada parameter Respons.*
**Kesalahan**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `FederatedResourceAlreadyExistsException`
+ `FederationSourceException`
## UpdateCatalog tindakan (Python: update\$1catalog)
Memperbarui properti katalog yang ada di Katalog AWS Glue Data.
**Permintaan**
+ `CatalogId`— *Wajib:* String id katalog, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)
ID katalog.
+ `CatalogInput` — *Wajib:* Sebuah objek [CatalogInput](#aws-glue-api-catalog-catalogs-CatalogInput).
`CatalogInput`Objek yang menentukan properti baru dari katalog yang ada.
**Respons**
+ *Tidak ada parameter Respons.*
**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `AccessDeniedException`
+ `FederationSourceException`
## DeleteCatalog tindakan (Python: delete\$1catalog)
Menghapus katalog yang ditentukan dari Katalog AWS Glue Data.
Setelah menyelesaikan operasi ini, Anda tidak lagi memiliki akses ke database, tabel (dan semua versi tabel dan partisi yang mungkin milik tabel) dan fungsi yang ditentukan pengguna dalam katalog yang dihapus. AWS Glue menghapus sumber daya “yatim piatu” ini secara asinkron pada waktu yang tepat, atas kebijaksanaan layanan.
Untuk memastikan penghapusan segera semua sumber daya terkait sebelum memanggil `DeleteCatalog` operasi, gunakan `DeleteTableVersion` (atau`BatchDeleteTableVersion`), (atau), `DeletePartition` `DeleteTable` (atau `BatchDeletePartition``BatchDeleteTable`), `DeleteUserDefinedFunction` dan `DeleteDatabase` untuk menghapus sumber daya apa pun yang termasuk dalam katalog.
**Permintaan**
+ `CatalogId`— *Wajib:* String id katalog, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)
ID katalog.
**Respons**
+ *Tidak ada parameter Respons.*
**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `AccessDeniedException`
+ `FederationSourceException`
## GetCatalog tindakan (Python: get\$1catalog)
Nama Katalog untuk diambil. Ini harus semua huruf kecil.
**Permintaan**
+ `CatalogId`— *Wajib:* String id katalog, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)
ID katalog induk tempat katalog berada. Jika tidak ada yang disediakan, Nomor AWS Rekening digunakan secara default.
**Respons**
+ `Catalog` — Sebuah objek [Katalog](#aws-glue-api-catalog-catalogs-Catalog).
Sebuah objek `Catalog`. Definisi katalog yang ditentukan dalam Katalog AWS Glue Data.
**Kesalahan**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
## GetCatalogs tindakan (Python: get\$1catalogs)
Mengambil semua katalog yang didefinisikan dalam katalog di Katalog Data. AWS Glue Untuk kasus penggunaan katalog federasi RedShift, operasi ini mengembalikan daftar katalog yang dipetakan ke database Redshift di katalog namespace Redshift.
**Permintaan**
+ `ParentCatalogId` — 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 induk tempat katalog berada. Jika tidak ada yang disediakan, Nomor AWS Rekening digunakan secara default.
+ `NextToken` – String UTF-8.
Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan.
+ `MaxResults` — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 1000.
Jumlah maksimum katalog untuk dikembalikan dalam satu respons.
+ `Recursive` – Boolean.
Apakah akan mencantumkan semua katalog di seluruh hierarki katalog, mulai dari. `ParentCatalogId` Default ke. `false` Kapan`true`, semua objek katalog dalam `ParentCatalogID` hierarki disebutkan dalam respons.
+ `IncludeRoot` – Boolean.
Apakah akan mencantumkan katalog default di akun dan wilayah dalam respons. Default ke `false`. Kapan `true` dan`ParentCatalogId = NULL | AWS Account ID`, semua katalog dan katalog default disebutkan dalam respons.
Ketika `ParentCatalogId` tidak sama dengan null, dan atribut ini dilewatkan sebagai `false` atau`true`, sebuah `InvalidInputException` dilemparkan.
**Respons**
+ `CatalogList` – *Wajib:* Susunan objek [Katalog](#aws-glue-api-catalog-catalogs-Catalog).
Susunan objek `Catalog`. Daftar `Catalog` objek dari katalog induk yang ditentukan.
+ `NextToken` – String UTF-8.
Sebuah token kelanjutan untuk pemberian nomor halaman untuk daftar token yang ditampilkan, dikembalikan jika segmen saat ini dari daftar tersebut bukan yang terakhir.
**Kesalahan**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
# API basis data
API basis data menjelaskan tipe data basis data, dan termasuk API untuk membuat, menghapus, menemukan, memperbarui, dan mencantumkan basis data.
## Jenis Data
+ [Struktur basis data](#aws-glue-api-catalog-databases-Database)
+ [DatabaseInput struktur](#aws-glue-api-catalog-databases-DatabaseInput)
+ [PrincipalPermissions struktur](#aws-glue-api-catalog-databases-PrincipalPermissions)
+ [DataLakePrincipal struktur](#aws-glue-api-catalog-databases-DataLakePrincipal)
+ [DatabaseIdentifier struktur](#aws-glue-api-catalog-databases-DatabaseIdentifier)
+ [FederatedDatabase struktur](#aws-glue-api-catalog-databases-FederatedDatabase)
## Struktur basis data
Objek `Database` merupakan pengelompokan logis tabel yang mungkin berada di metastore Hive atau RDBMS.
**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 basis data. 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 basis data.
+ `LocationUri` — Pengenal sumber daya seragam (uri), dengan panjang tidak kurang dari 1 atau lebih dari 1024 byte, yang cocok dengan [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
Lokasi basis data (misalnya, jalur HDFS).
+ `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 dan properti basis data.
+ `CreateTime` — Stempel waktu.
Waktu ketika metadata basis data dibuat dalam katalog.
+ `CreateTableDefaultPermissions` – Susunan objek [PrincipalPermissions](#aws-glue-api-catalog-databases-PrincipalPermissions).
Menciptakan satu set izin default pada tabel untuk prinsipal utama. Digunakan oleh AWS Lake Formation. Tidak digunakan dalam AWS Glue operasi normal.
+ `TargetDatabase` — Sebuah objek [DatabaseIdentifier](#aws-glue-api-catalog-databases-DatabaseIdentifier).
Struktur `DatabaseIdentifier` yang menggambarkan basis data target untuk penautan 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 basis data berada.
+ `FederatedDatabase` — Sebuah objek [FederatedDatabase](#aws-glue-api-catalog-databases-FederatedDatabase).
`FederatedDatabase`Struktur yang mereferensikan entitas di luar AWS Glue Data Catalog.
## DatabaseInput struktur
Struktur yang digunakan untuk membuat atau memperbarui basis data.
**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 basis data. 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 basis data.
+ `LocationUri` — Pengenal sumber daya seragam (uri), dengan panjang tidak kurang dari 1 atau lebih dari 1024 byte, yang cocok dengan [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).
Lokasi basis data (misalnya, jalur HDFS).
+ `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 dan properti basis data.
Pasangan kunci-nilai ini menentukan parameter dan properti basis data.
+ `CreateTableDefaultPermissions` – Susunan objek [PrincipalPermissions](#aws-glue-api-catalog-databases-PrincipalPermissions).
Menciptakan satu set izin default pada tabel untuk prinsipal utama. Digunakan oleh AWS Lake Formation. Tidak digunakan dalam AWS Glue operasi normal.
+ `TargetDatabase` — Sebuah objek [DatabaseIdentifier](#aws-glue-api-catalog-databases-DatabaseIdentifier).
Struktur `DatabaseIdentifier` yang menggambarkan basis data target untuk penautan sumber daya.
+ `FederatedDatabase` — Sebuah objek [FederatedDatabase](#aws-glue-api-catalog-databases-FederatedDatabase).
`FederatedDatabase`Struktur yang mereferensikan entitas di luar AWS Glue Data Catalog.
## PrincipalPermissions struktur
Izin yang diberikan ke sebuah prinsipal utama.
**Bidang**
+ `Principal` — Sebuah objek [DataLakePrincipal](#aws-glue-api-catalog-databases-DataLakePrincipal).
Prinsipal utama yang diberikan izin.
+ `Permissions` – Susunan string UTF-8.
Izin yang diberikan kepada prinsipal utama.
## DataLakePrincipal struktur
Kepala AWS Lake Formation sekolah.
**Bidang**
+ `DataLakePrincipalIdentifier` — String UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 255 byte.
Pengenal untuk AWS Lake Formation kepala sekolah.
## DatabaseIdentifier struktur
Struktur yang menggambarkan database 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 basis data 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.
+ `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 basis data target.
## FederatedDatabase struktur
Database 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 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 database federasi, seperti JDBC, ODBC, atau protokol koneksi lain yang didukung.
## Operasi
+ [CreateDatabase tindakan (Python: create\$1database)](#aws-glue-api-catalog-databases-CreateDatabase)
+ [UpdateDatabase tindakan (Python: update\$1database)](#aws-glue-api-catalog-databases-UpdateDatabase)
+ [DeleteDatabase tindakan (Python: delete\$1database)](#aws-glue-api-catalog-databases-DeleteDatabase)
+ [GetDatabase tindakan (Python: get\$1database)](#aws-glue-api-catalog-databases-GetDatabase)
+ [GetDatabases tindakan (Python: get\$1databases)](#aws-glue-api-catalog-databases-GetDatabases)
## CreateDatabase tindakan (Python: create\$1database)
Menciptakan sebuah basis data 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 basis data akan dibuat. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `DatabaseInput` — *Wajib:* Sebuah objek [DatabaseInput](#aws-glue-api-catalog-databases-DatabaseInput).
Metadata untuk basis data.
+ `Tags` — Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 50 pasang.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak lebih dari 256 byte.
Tag yang Anda tetapkan ke database.
**Respons**
+ *Tidak ada parameter Respons.*
**Kesalahan**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `FederatedResourceAlreadyExistsException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
## UpdateDatabase tindakan (Python: update\$1database)
Memperbarui definisi basis data yang ada 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 metadata basis data berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `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 basis data yang akan diperbarui dalam katalog. Untuk kompatibilitas Hive, nama ini diubah ke huruf kecil.
+ `DatabaseInput` — *Wajib:* Sebuah objek [DatabaseInput](#aws-glue-api-catalog-databases-DatabaseInput).
Sebuah objek `DatabaseInput` menentukan definisi baru dari metadata basis data dalam katalog.
**Respons**
+ *Tidak ada parameter Respons.*
**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
+ `AlreadyExistsException`
## DeleteDatabase tindakan (Python: delete\$1database)
Menghapus sebuah basis data yang ditentukan dari Katalog Data.
**catatan**
Setelah menyelesaikan operasi ini, Anda tidak lagi memiliki akses ke tabel (dan semua versi tabel dan partisi yang mungkin milik tabel) dan fungsi yang ditentukan pengguna dalam database yang dihapus. AWS Glue menghapus sumber daya “yatim piatu” ini secara asinkron pada waktu yang tepat, atas kebijaksanaan layanan.
Untuk memastikan penghapusan langsung dari semua sumber daya terkait, sebelum memanggil `DeleteDatabase`, gunakan `DeleteTableVersion` atau `BatchDeleteTableVersion`, `DeletePartition` atau `BatchDeletePartition`, `DeleteUserDefinedFunction`, dan `DeleteTable` atau `BatchDeleteTable`, untuk menghapus sumber daya yang dimiliki oleh basis 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 basis data berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `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 basis data yang akan dihapus. Untuk kompatibilitas Hive, ini semua harus huruf kecil.
**Respons**
+ *Tidak ada parameter Respons.*
**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
## GetDatabase tindakan (Python: get\$1database)
Mengambil definisi dari basis data 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 basis data berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `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 basis data yang akan diambil. Untuk kompatibilitas Hive, nama ini harus huruf kecil.
**Respons**
+ `Database` — Sebuah objek [Basis Data](#aws-glue-api-catalog-databases-Database).
Definisi basis data yang ditentukan dalam Katalog Data.
**Kesalahan**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
## GetDatabases tindakan (Python: get\$1databases)
Mengambil semua basis data yang didefinisikan dalam Katalog Data 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 `Databases` akan diambil. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `NextToken` – String UTF-8.
Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan.
+ `MaxResults` — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100.
Jumlah maksimum basis data yang akan dikembalikan dalam satu respons.
+ `ResourceShareType` – String UTF-8 (nilai yang valid: `FOREIGN` \$1 `ALL` \$1 `FEDERATED`).
Memungkinkan Anda untuk menentukan apakah Anda ingin mencantumkan basis data yang dibagikan dengan akun Anda. Nilai yang diijinkan adalah`FEDERATED`, `FOREIGN` atau`ALL`.
+ Jika disetel ke`FEDERATED`, akan mencantumkan database federasi (merujuk entitas eksternal) yang dibagikan dengan akun Anda.
+ Jika diatur ke `FOREIGN`, akan mencantumkan basis data yang dibagikan dengan akun Anda.
+ Jika diatur ke `ALL`, akan mencantumkan basis data yang dibagikan dengan akun Anda, serta basis data di akun lokal Anda.
+ `AttributesToGet` – Susunan string UTF-8.
Menentukan bidang database yang dikembalikan oleh `GetDatabases` panggilan. Parameter ini tidak menerima daftar kosong. Permintaan harus mencakup`NAME`.
**Respons**
+ `DatabaseList` – *Wajib:* Susunan objek [Basis Data](#aws-glue-api-catalog-databases-Database).
Daftar objek `Database` dari katalog yang ditentukan.
+ `NextToken` – String UTF-8.
Sebuah token kelanjutan untuk pemberian nomor halaman untuk daftar token yang ditampilkan, dikembalikan jika segmen saat ini dari daftar tersebut bukan yang terakhir.
**Kesalahan**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `EntityNotFoundException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
# 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\$1TABLE
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\$1TABLE
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"` \$1 `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` \$1 `ACTIVE` \$1 `DELETING` \$1 `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\$10000, U\$10001, U\$10002.
+ InternalError: Kesalahan apa pun yang bukan milik kode kesalahan lainnya.
**Bidang**
+ `Code` – String UTF-8 (nilai yang valid: `ENCRYPTED_PARTITION_ERROR` \$1 `INTERNAL_ERROR` \$1 `INVALID_PARTITION_TYPE_DATA_ERROR` \$1 `MISSING_PARTITION_VALUE_ERROR` \$1 `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` \$1 `ATHENA` \$1 `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` \$1 `ATHENA` \$1 `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"` \$1 `desc="DESC"`).
Arah pengurutan untuk bidang ini, baik naik atau turun.
+ `NullOrder` – *Wajib:* String UTF-8 (nilai yang valid: `nulls-first="NULLS_FIRST"` \$1 `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\$1table)](#aws-glue-api-catalog-tables-CreateTable)
+ [UpdateTable tindakan (Python: update\$1table)](#aws-glue-api-catalog-tables-UpdateTable)
+ [DeleteTable tindakan (Python: delete\$1table)](#aws-glue-api-catalog-tables-DeleteTable)
+ [BatchDeleteTable tindakan (Python: batch\$1delete\$1table)](#aws-glue-api-catalog-tables-BatchDeleteTable)
+ [GetTable tindakan (Python: get\$1table)](#aws-glue-api-catalog-tables-GetTable)
+ [GetTables tindakan (Python: get\$1tables)](#aws-glue-api-catalog-tables-GetTables)
+ [GetTableVersion tindakan (Python: get\$1table\$1version)](#aws-glue-api-catalog-tables-GetTableVersion)
+ [GetTableVersions tindakan (Python: get\$1table\$1versions)](#aws-glue-api-catalog-tables-GetTableVersions)
+ [DeleteTableVersion tindakan (Python: delete\$1table\$1version)](#aws-glue-api-catalog-tables-DeleteTableVersion)
+ [BatchDeleteTableVersion tindakan (Python: batch\$1delete\$1table\$1version)](#aws-glue-api-catalog-tables-BatchDeleteTableVersion)
+ [SearchTables tindakan (Python: search\$1tables)](#aws-glue-api-catalog-tables-SearchTables)
+ [GetPartitionIndexes tindakan (Python: get\$1partition\$1indexes)](#aws-glue-api-catalog-tables-GetPartitionIndexes)
+ [CreatePartitionIndex tindakan (Python: create\$1partition\$1index)](#aws-glue-api-catalog-tables-CreatePartitionIndex)
+ [DeletePartitionIndex tindakan (Python: delete\$1partition\$1index)](#aws-glue-api-catalog-tables-DeletePartitionIndex)
+ [GetColumnStatisticsForTable tindakan (Python: get\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-GetColumnStatisticsForTable)
+ [UpdateColumnStatisticsForTable tindakan (Python: update\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-UpdateColumnStatisticsForTable)
+ [DeleteColumnStatisticsForTable tindakan (Python: delete\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-DeleteColumnStatisticsForTable)
## CreateTable tindakan (Python: create\$1table)
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\$1table)
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` \$1 `REPLACE` \$1 `ADD_OR_REPLACE` \$1 `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\$1table)
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\$1delete\$1table)
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\$1table)
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\$1tables)
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\$1table\$1version)
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\$1table\$1versions)
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\$1table\$1version)
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\$1delete\$1table\$1version)
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\$1tables)
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, -, :, \$1, 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` \$1 `ALL` \$1 `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\$1partition\$1indexes)
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\$1partition\$1index)
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\$1partition\$1index)
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\$1column\$1statistics\$1for\$1table)
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\$1column\$1statistics\$1for\$1table)
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\$1column\$1statistics\$1for\$1table)
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`
# 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`
# Koneksi API
Connections API menjelaskan tipe data dan API yang terkait dengan bekerja dengan koneksi di AWS Glue.
**Topics**
+ [API Koneksi](aws-glue-api-catalog-connections-connections.md)
+ [Jenis Koneksi API](aws-glue-api-catalog-connections-connections-type.md)
+ [Metadata Koneksi dan API Pratinjau](aws-glue-api-catalog-connections-connections-metadata.md)
# API Koneksi
Connection API menjelaskan tipe data AWS Glue koneksi, dan API untuk membuat, menghapus, memperbarui, dan mencantumkan koneksi.
## Jenis Data
+ [Struktur koneksi](#aws-glue-api-catalog-connections-connections-Connection)
+ [ConnectionInput struktur](#aws-glue-api-catalog-connections-connections-ConnectionInput)
+ [TestConnectionInput struktur](#aws-glue-api-catalog-connections-connections-TestConnectionInput)
+ [PhysicalConnectionRequirements struktur](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements)
+ [GetConnectionsFilter struktur](#aws-glue-api-catalog-connections-connections-GetConnectionsFilter)
+ [AuthenticationConfiguration struktur](#aws-glue-api-catalog-connections-connections-AuthenticationConfiguration)
+ [AuthenticationConfigurationInput struktur](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput)
+ [OAuth2Struktur properti](#aws-glue-api-catalog-connections-connections-OAuth2Properties)
+ [OAuth2PropertiesInput struktur](#aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput)
+ [OAuth2ClientApplication struktur](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication)
+ [AuthorizationCodeProperties struktur](#aws-glue-api-catalog-connections-connections-AuthorizationCodeProperties)
+ [BasicAuthenticationCredentials struktur](#aws-glue-api-catalog-connections-connections-BasicAuthenticationCredentials)
+ [OAuth2Struktur kredensial](#aws-glue-api-catalog-connections-connections-OAuth2Credentials)
## Struktur koneksi
Mendefinisikan sebuah koneksi ke sumber data.
**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 definisi koneksi.
+ `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 koneksi.
+ `ConnectionType`— UTF-8 string (nilai valid: `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` `INTERCOM` `SNAPCHATADS`\$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` \$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE`\$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1`VERTICA`).
Jenis koneksi. Saat ini, SFTP tidak didukung.
+ `MatchCriteria` — Susunan string UTF-8, tidak lebih dari 10 string.
Daftar kriteria yang dapat digunakan dalam memilih koneksi ini.
+ `ConnectionProperties` — Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 100 pasang.
Setiap kunci adalah string UTF-8 (nilai yang valid: `HOST` \$1 \$1 \$1 `PORT` \$1 `USERNAME="USER_NAME"` \$1 `PASSWORD` \$1 `ENCRYPTED_PASSWORD` \$1 `JDBC_DRIVER_JAR_URI` \$1 `JDBC_DRIVER_CLASS_NAME` \$1 `JDBC_ENGINE` \$1 `JDBC_ENGINE_VERSION` \$1 `CONFIG_FILES` \$1 `INSTANCE_ID` \$1 \$1 `JDBC_CONNECTION_URL` \$1 `JDBC_ENFORCE_SSL` \$1 `CUSTOM_JDBC_CERT` \$1 `SKIP_CUSTOM_JDBC_CERT_VALIDATION` \$1 `CUSTOM_JDBC_CERT_STRING` \$1 `CONNECTION_URL` \$1 `KAFKA_BOOTSTRAP_SERVERS` \$1 `KAFKA_SSL_ENABLED` \$1 \$1 `KAFKA_CUSTOM_CERT` \$1 `KAFKA_SKIP_CUSTOM_CERT_VALIDATION` \$1 `KAFKA_CLIENT_KEYSTORE` \$1 `KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `KAFKA_CLIENT_KEY_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD` \$1 `KAFKA_SASL_MECHANISM` \$1 `KAFKA_SASL_PLAIN_USERNAME` \$1 `KAFKA_SASL_PLAIN_PASSWORD` \$1 \$1 `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD` \$1 `KAFKA_SASL_SCRAM_USERNAME` \$1 `KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_SCRAM_SECRETS_ARN` \$1 `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD` `KAFKA_SASL_GSSAPI_KEYTAB` `KAFKA_SASL_GSSAPI_KRB5_CONF` \$1 `KAFKA_SASL_GSSAPI_SERVICE` \$1 `KAFKA_SASL_GSSAPI_PRINCIPAL` \$1 `SECRET_ID` \$1 `CONNECTOR_URL` \$1 `CONNECTOR_TYPE` \$1 `CONNECTOR_CLASS_NAME` `ENDPOINT` \$1 `ENDPOINT_TYPE` \$1 `ROLE_ARN` \$1 `REGION` \$1 `WORKGROUP_NAME` \$1 `CLUSTER_IDENTIFIER` \$1`DATABASE`).
Setiap nilai adalah string Nilai, panjangnya tidak kurang dari 1 atau lebih dari 1024 byte.
Pasangan nilai kunci ini menentukan parameter untuk koneksi saat menggunakan skema Koneksi versi 1:
+ `HOST`- URI host: baik nama domain yang memenuhi syarat (FQDN) atau IPv4 alamat host database.
+ `PORT` - Nomor port, antara 1024 dan 65535, port di mana host basis data mendengarkan untuk koneksi basis data.
+ `USER_NAME` - Nama yang digunakan untuk log in ke basis data. Nilai string untuk `USER_NAME` adalah "`USERNAME`".
+ `PASSWORD` - Sebuah kata sandi, jika salah satu digunakan, untuk nama pengguna.
+ `ENCRYPTED_PASSWORD` - Bila Anda mengaktifkan perlindungan kata sandi koneksi dengan menetapkan `ConnectionPasswordEncryption` dalam pengaturan enkripsi Katalog Data, bidang ini menyimpan kata sandi terenkripsi.
+ `JDBC_DRIVER_JAR_URI` - Path Amazon Simple Storage Service (Amazon S3) dari file JAR yang berisi driver JDBC yang akan digunakan.
+ `JDBC_DRIVER_CLASS_NAME` - Nama kelas driver JDBC yang akan digunakan.
+ `JDBC_ENGINE` - Nama mesin JDBC yang akan digunakan.
+ `JDBC_ENGINE_VERSION` - Versi mesin JDBC yang akan digunakan.
+ `CONFIG_FILES` - (Dicadangkan untuk digunakan di masa depan.)
+ `INSTANCE_ID` - ID instans yang akan digunakan.
+ `JDBC_CONNECTION_URL` - URL untuk menghubungkan ke sumber data JDBC.
+ `JDBC_ENFORCE_SSL`- String Boolean case-insensitive (true, false) yang menentukan apakah Secure Sockets Layer (SSL) dengan pencocokan nama host diberlakukan untuk koneksi JDBC pada klien. Default-nya adalah salah.
+ `CUSTOM_JDBC_CERT`- Lokasi Amazon S3 yang menentukan sertifikat root pelanggan. AWS Glue menggunakan sertifikat root ini untuk memvalidasi sertifikat pelanggan saat menghubungkan ke database pelanggan. AWS Glue hanya menangani sertifikat X.509. Sertifikat yang diberikan harus dikodekan-DER dan disediakan dalam format PEM encoding Base64.
+ `SKIP_CUSTOM_JDBC_CERT_VALIDATION`- Secara default, ini`false`. AWS Glue memvalidasi algoritma Signature dan Subject Public Key Algorithm untuk sertifikat pelanggan. Satu-satunya algoritma yang diizinkan untuk algoritma Signature adalah SHA256with RSA, RSA atau SHA384with RSA. SHA512with Untuk Algoritme Kunci Publik Subjek, panjang kunci paling tidak 2048. Anda dapat mengatur nilai properti ini ke `true` untuk melompati validasi sertifikat pelanggan AWS Glue.
+ `CUSTOM_JDBC_CERT_STRING`- String sertifikat JDBC kustom yang digunakan untuk pencocokan domain atau pencocokan nama yang dibedakan untuk mencegah serangan. man-in-the-middle Dalam basis data Oracle, ini digunakan sebagai `SSL_SERVER_CERT_DN`; di Microsoft SQL Server, ini digunakan sebagai `hostNameInCertificate`.
+ `CONNECTION_URL` - URL untuk menghubungkan ke sumber data umum (non-JDBC).
+ `SECRET_ID` - ID rahasia yang digunakan untuk secret manager kredensialnya.
+ `CONNECTOR_URL` - URL konektor untuk koneksi MARKETPLACE atau KUSTOM.
+ `CONNECTOR_TYPE` - Jenis konektor untuk koneksi MARKETPLACE atau KUSTOM.
+ `CONNECTOR_CLASS_NAME` - Nama kelas konektor untuk koneksi MARKETPLACE atau KUSTOM.
+ `KAFKA_BOOTSTRAP_SERVERS` - Sebuah daftar yang dipisahkan koma dari pasangan host dan port yang merupakan alamat dari broker Apache Kafka dalam klaster Kafka yang akan terhubung dengan klien Kafka dan bootstrap itu sendiri.
+ `KAFKA_SSL_ENABLED` - Baik untuk mengaktifkan atau menonaktifkan SSL pada koneksi Apache Kafka. Nilai default-nya adalah "BETUL".
+ `KAFKA_CUSTOM_CERT` - URL Amazon S3 untuk file sertifikat CA privat (format.pem). Default-nya adalah string kosong.
+ `KAFKA_SKIP_CUSTOM_CERT_VALIDATION`- Apakah akan melewatkan validasi file sertifikat CA atau tidak. AWS Glue memvalidasi untuk tiga algoritma: SHA256with RSA, RSA dan SHA384with RSA. SHA512with Nilai default-nya adalah "SALAH".
+ `KAFKA_CLIENT_KEYSTORE` - Lokasi Amazon S3 dari file keystore klien untuk autentikasi sisi klien Kafka (Opsional).
+ `KAFKA_CLIENT_KEYSTORE_PASSWORD` - Kata sandi untuk mengakses keystore yang disediakan (Opsional).
+ `KAFKA_CLIENT_KEY_PASSWORD` - Sebuah keystore dapat terdiri dari beberapa kunci, jadi ini adalah kata sandi untuk mengakses kunci klien yang akan digunakan dengan kunci sisi klien Kafka (Opsional).
+ `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD`- Versi terenkripsi dari kata sandi keystore klien Kafka (jika pengguna memiliki pengaturan kata sandi AWS Glue enkripsi yang dipilih).
+ `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD`- Versi terenkripsi dari kata sandi kunci klien Kafka (jika pengguna memiliki pengaturan kata sandi AWS Glue enkripsi yang dipilih).
+ `KAFKA_SASL_MECHANISM`-`"SCRAM-SHA-512"`,`"GSSAPI"`,`"AWS_MSK_IAM"`, atau`"PLAIN"`. Ini adalah [Mekanisme SASL](https://www.iana.org/assignments/sasl-mechanisms/sasl-mechanisms.xhtml) yang didukung.
+ `KAFKA_SASL_PLAIN_USERNAME`- Nama pengguna plaintext yang digunakan untuk mengautentikasi dengan mekanisme “PLAIN”.
+ `KAFKA_SASL_PLAIN_PASSWORD`- Kata sandi plaintext yang digunakan untuk mengautentikasi dengan mekanisme “PLAIN”.
+ `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD`- Versi terenkripsi dari kata sandi Kafka SASL PLAIN (jika pengguna memiliki pengaturan kata sandi AWS Glue enkripsi yang dipilih).
+ `KAFKA_SASL_SCRAM_USERNAME`- Nama pengguna plaintext yang digunakan untuk mengautentikasi dengan mekanisme “SCRAM-SHA-512".
+ `KAFKA_SASL_SCRAM_PASSWORD`- Kata sandi plaintext yang digunakan untuk mengautentikasi dengan mekanisme “SCRAM-SHA-512".
+ `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD`- Versi terenkripsi dari kata sandi Kafka SASL SCRAM (jika pengguna memiliki pengaturan kata sandi AWS Glue enkripsi yang dipilih).
+ `KAFKA_SASL_SCRAM_SECRETS_ARN`- Nama Sumber Daya Amazon dari AWS rahasia di Secrets Manager.
+ `KAFKA_SASL_GSSAPI_KEYTAB`- Lokasi S3 dari file Kerberos`keytab`. Keytab menyimpan kunci jangka panjang untuk satu atau lebih prinsipal. Untuk informasi selengkapnya, lihat [Dokumentasi MIT Kerberos: Keytab](https://web.mit.edu/kerberos/krb5-latest/doc/basic/keytab_def.html).
+ `KAFKA_SASL_GSSAPI_KRB5_CONF`- Lokasi S3 dari file Kerberos`krb5.conf`. Krb5.conf menyimpan informasi konfigurasi Kerberos, seperti lokasi server KDC. Untuk informasi lebih lanjut, lihat [Dokumentasi MIT Kerberos:](https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html) krb5.conf.
+ `KAFKA_SASL_GSSAPI_SERVICE`- Nama layanan Kerberos, seperti yang diatur `sasl.kerberos.service.name` dalam Konfigurasi [Kafka](https://kafka.apache.org/documentation/#brokerconfigs_sasl.kerberos.service.name) Anda.
+ `KAFKA_SASL_GSSAPI_PRINCIPAL`- Nama princial Kerberos yang digunakan oleh. AWS Glue Untuk informasi lebih lanjut, lihat [Dokumentasi Kafka: Mengkonfigurasi Broker Kafka](https://kafka.apache.org/documentation/#security_sasl_kerberos_clientconfig).
+ `ROLE_ARN`- Peran yang akan digunakan untuk menjalankan query.
+ `REGION`- AWS Wilayah tempat kueri akan dijalankan.
+ `WORKGROUP_NAME`- Nama workgroup tanpa server Amazon Redshift atau workgroup Amazon Athena tempat kueri akan berjalan.
+ `CLUSTER_IDENTIFIER`- Pengidentifikasi cluster dari cluster Amazon Redshift tempat kueri akan berjalan.
+ `DATABASE`- Basis data Amazon Redshift yang Anda sambungkan.
+ `SparkProperties` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 2048 byte.
Properti koneksi khusus untuk lingkungan komputasi Spark.
+ `AthenaProperties` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 2048 byte.
Properti koneksi khusus untuk lingkungan komputasi Athena.
+ `PythonProperties` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 2048 byte.
Properti koneksi khusus untuk lingkungan komputasi Python.
+ `PhysicalConnectionRequirements` — Sebuah objek [PhysicalConnectionRequirements](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements).
Persyaratan koneksi fisik, seperti virtual private cloud (VPC) dan`SecurityGroup`, yang diperlukan untuk membuat koneksi ini berhasil.
+ `CreationTime` — Stempel waktu.
Stempel waktu waktu definisi koneksi ini dibuat.
+ `LastUpdatedTime` — Stempel waktu.
Stempel waktu terakhir kali definisi koneksi diperbarui.
+ `LastUpdatedBy` — 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).
Pengguna, grup, atau peran yang terakhir memperbarui definisi koneksi ini.
+ `Status` – String UTF-8 (nilai yang valid: `READY` \$1 `IN_PROGRESS` \$1 `FAILED`).
Status koneksi. Bisa menjadi salah satu dari:`READY`,`IN_PROGRESS`, atau`FAILED`.
+ `StatusReason`— String UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 16384 byte.
Alasan status koneksi.
+ `LastConnectionValidationTime` — Stempel waktu.
Stempel waktu saat koneksi ini terakhir divalidasi.
+ `AuthenticationConfiguration` — Sebuah objek [AuthenticationConfiguration](#aws-glue-api-catalog-connections-connections-AuthenticationConfiguration).
Properti otentikasi koneksi.
+ `ConnectionSchemaVersion`— Angka (bilangan bulat), tidak kurang dari 1 atau lebih dari 2.
Versi skema koneksi untuk koneksi ini. Versi 2 mendukung properti untuk lingkungan komputasi tertentu.
+ `CompatibleComputeEnvironments` – Susunan string UTF-8.
Daftar lingkungan komputasi yang kompatibel dengan koneksi.
## ConnectionInput struktur
Sebuah struktur yang digunakan untuk menentukan koneksi yang akan dibuat atau diperbarui.
**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 koneksi.
+ `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 koneksi.
+ `ConnectionType`— *Diperlukan:* UTF-8 string (nilai valid: `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` `DATADOG` `WOOCOMMERCE`\$1 `INTERCOM` \$1 `SNAPCHATADS` \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO`\$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` \$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1`VERTICA`).
Jenis koneksi. Saat ini, jenis-jenis berikut ini didukung:
+ `JDBC` - Menunjuk koneksi ke database melalui Java Database Connectivity (JDBC).
`JDBC`Koneksi menggunakan yang berikut ini ConnectionParameters.
+ Diperlukan: Semua (`HOST`,`PORT`,`JDBC_ENGINE`) atau`JDBC_CONNECTION_URL`.
+ Diperlukan: Semua (`USERNAME`,`PASSWORD`) atau`SECRET_ID`.
+ Opsional:`JDBC_ENFORCE_SSL`,`CUSTOM_JDBC_CERT`,`CUSTOM_JDBC_CERT_STRING`,`SKIP_CUSTOM_JDBC_CERT_VALIDATION`. Parameter ini digunakan untuk mengkonfigurasi SSL dengan JDBC.
+ `KAFKA` - Menunjuk koneksi ke platform streaming Apache Kafka.
`KAFKA`Koneksi menggunakan yang berikut ini ConnectionParameters.
+ Diperlukan:`KAFKA_BOOTSTRAP_SERVERS`.
+ Opsional:`KAFKA_SSL_ENABLED`,`KAFKA_CUSTOM_CERT`,`KAFKA_SKIP_CUSTOM_CERT_VALIDATION`. Parameter ini digunakan untuk mengkonfigurasi SSL dengan`KAFKA`.
+ Opsional:`KAFKA_CLIENT_KEYSTORE`,`KAFKA_CLIENT_KEYSTORE_PASSWORD`,`KAFKA_CLIENT_KEY_PASSWORD`,`ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD`,`ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD`. Parameter ini digunakan untuk mengkonfigurasi konfigurasi klien TLS dengan SSL di. `KAFKA`
+ Opsional:`KAFKA_SASL_MECHANISM`. Dapat ditentukan sebagai`SCRAM-SHA-512`,`GSSAPI`, atau`AWS_MSK_IAM`.
+ Opsional:`KAFKA_SASL_SCRAM_USERNAME`,`KAFKA_SASL_SCRAM_PASSWORD`,`ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD`. Parameter ini digunakan untuk mengkonfigurasi otentikasi SASL/SCRAM-SHA-512 dengan. `KAFKA`
+ Opsional:`KAFKA_SASL_GSSAPI_KEYTAB`,`KAFKA_SASL_GSSAPI_KRB5_CONF`,`KAFKA_SASL_GSSAPI_SERVICE`,`KAFKA_SASL_GSSAPI_PRINCIPAL`. Parameter ini digunakan untuk mengkonfigurasi SASL/GSSAPI otentikasi dengan`KAFKA`.
+ `MONGODB` - Menunjuk koneksi ke database dokumen MongoDB.
`MONGODB`Koneksi menggunakan yang berikut ini ConnectionParameters.
+ Diperlukan:`CONNECTION_URL`.
+ Diperlukan: Semua (`USERNAME`,`PASSWORD`) atau`SECRET_ID`.
+ `VIEW_VALIDATION_REDSHIFT`- Menetapkan koneksi yang digunakan untuk validasi tampilan oleh Amazon Redshift.
+ `VIEW_VALIDATION_ATHENA`- Menentukan koneksi yang digunakan untuk validasi tampilan oleh Amazon Athena.
+ `NETWORK` - Menunjuk koneksi jaringan ke sumber data dalam lingkungan Amazon Virtual Private Cloud (Amazon VPC).
`NETWORK`Koneksi tidak memerlukan ConnectionParameters. Sebaliknya, berikan a PhysicalConnectionRequirements.
+ `MARKETPLACE`- Menggunakan pengaturan konfigurasi yang terdapat dalam konektor yang dibeli AWS Marketplace untuk membaca dan menulis ke penyimpanan data yang tidak didukung secara asli oleh AWS Glue.
`MARKETPLACE`Koneksi menggunakan yang berikut ini ConnectionParameters.
+ Diperlukan:`CONNECTOR_TYPE`,`CONNECTOR_URL`,`CONNECTOR_CLASS_NAME`,`CONNECTION_URL`.
+ Diperlukan untuk `JDBC` `CONNECTOR_TYPE` koneksi: Semua (`USERNAME`,`PASSWORD`) atau`SECRET_ID`.
+ `CUSTOM` - Menggunakan pengaturan konfigurasi yang terkandung dalam sebuah konektor kustom untuk membaca dari dan menulis ke penyimpanan data yang tidak didukung secara asli oleh AWS Glue.
Untuk informasi selengkapnya tentang parameter koneksi yang diperlukan untuk konektor tertentu, lihat dokumentasi untuk konektor di [Menambahkan AWS Glue koneksi](https://docs.aws.amazon.com/glue/latest/dg/console-connections.html) di Panduan AWS Glue Pengguna.
`SFTP` tidak didukung.
Untuk informasi selengkapnya tentang cara opsional ConnectionProperties digunakan untuk mengonfigurasi fitur AWS Glue, lihat [properti AWS Glue koneksi](https://docs.aws.amazon.com/glue/latest/dg/connection-defining.html).
Untuk informasi selengkapnya tentang cara opsional ConnectionProperties digunakan untuk mengonfigurasi fitur di AWS Glue Studio, lihat [Menggunakan konektor dan koneksi](https://docs.aws.amazon.com/glue/latest/ug/connectors-chapter.html).
+ `MatchCriteria` — Susunan string UTF-8, tidak lebih dari 10 string.
Daftar kriteria yang dapat digunakan dalam memilih koneksi ini.
+ `ConnectionProperties` — *Wajib:* Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 100 pasang.
Setiap kunci adalah string UTF-8 (nilai yang valid: `HOST` \$1 \$1 \$1 `PORT` \$1 `USERNAME="USER_NAME"` \$1 `PASSWORD` \$1 `ENCRYPTED_PASSWORD` \$1 `JDBC_DRIVER_JAR_URI` \$1 `JDBC_DRIVER_CLASS_NAME` \$1 `JDBC_ENGINE` \$1 `JDBC_ENGINE_VERSION` \$1 `CONFIG_FILES` \$1 `INSTANCE_ID` \$1 \$1 `JDBC_CONNECTION_URL` \$1 `JDBC_ENFORCE_SSL` \$1 `CUSTOM_JDBC_CERT` \$1 `SKIP_CUSTOM_JDBC_CERT_VALIDATION` \$1 `CUSTOM_JDBC_CERT_STRING` \$1 `CONNECTION_URL` \$1 `KAFKA_BOOTSTRAP_SERVERS` \$1 `KAFKA_SSL_ENABLED` \$1 \$1 `KAFKA_CUSTOM_CERT` \$1 `KAFKA_SKIP_CUSTOM_CERT_VALIDATION` \$1 `KAFKA_CLIENT_KEYSTORE` \$1 `KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `KAFKA_CLIENT_KEY_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD` \$1 `KAFKA_SASL_MECHANISM` \$1 `KAFKA_SASL_PLAIN_USERNAME` \$1 `KAFKA_SASL_PLAIN_PASSWORD` \$1 \$1 `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD` \$1 `KAFKA_SASL_SCRAM_USERNAME` \$1 `KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_SCRAM_SECRETS_ARN` \$1 `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD` `KAFKA_SASL_GSSAPI_KEYTAB` `KAFKA_SASL_GSSAPI_KRB5_CONF` \$1 `KAFKA_SASL_GSSAPI_SERVICE` \$1 `KAFKA_SASL_GSSAPI_PRINCIPAL` \$1 `SECRET_ID` \$1 `CONNECTOR_URL` \$1 `CONNECTOR_TYPE` \$1 `CONNECTOR_CLASS_NAME` `ENDPOINT` \$1 `ENDPOINT_TYPE` \$1 `ROLE_ARN` \$1 `REGION` \$1 `WORKGROUP_NAME` \$1 `CLUSTER_IDENTIFIER` \$1`DATABASE`).
Setiap nilai adalah string Nilai, panjangnya tidak kurang dari 1 atau lebih dari 1024 byte.
Pasangan nilai-kunci ini menentukan parameter untuk koneksi.
+ `SparkProperties` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 2048 byte.
Properti koneksi khusus untuk lingkungan komputasi Spark.
+ `AthenaProperties` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 2048 byte.
Properti koneksi khusus untuk lingkungan komputasi Athena.
+ `PythonProperties` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 2048 byte.
Properti koneksi khusus untuk lingkungan komputasi Python.
+ `PhysicalConnectionRequirements` — Sebuah objek [PhysicalConnectionRequirements](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements).
Persyaratan koneksi fisik, seperti virtual private cloud (VPC) dan`SecurityGroup`, yang diperlukan untuk berhasil membuat koneksi ini.
+ `AuthenticationConfiguration` — Sebuah objek [AuthenticationConfigurationInput](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput).
Properti otentikasi koneksi.
+ `ValidateCredentials` – Boolean.
Bendera untuk memvalidasi kredensyal selama membuat koneksi. Default benar.
+ `ValidateForComputeEnvironments` – Susunan string UTF-8.
Lingkungan komputasi yang properti koneksi tertentu divalidasi terhadap.
## TestConnectionInput struktur
Struktur yang digunakan untuk menentukan pengujian koneksi ke layanan.
**Bidang**
+ `ConnectionType`— *Diperlukan:* UTF-8 string (nilai valid: `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` `DATADOG` `WOOCOMMERCE`\$1 `INTERCOM` \$1 `SNAPCHATADS` \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO`\$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` \$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1`VERTICA`).
Jenis koneksi yang akan diuji. Operasi ini hanya tersedia untuk jenis `JDBC` atau `SALESFORCE` koneksi.
+ `ConnectionProperties` — *Wajib:* Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 100 pasang.
Setiap kunci adalah string UTF-8 (nilai yang valid: `HOST` \$1 \$1 \$1 `PORT` \$1 `USERNAME="USER_NAME"` \$1 `PASSWORD` \$1 `ENCRYPTED_PASSWORD` \$1 `JDBC_DRIVER_JAR_URI` \$1 `JDBC_DRIVER_CLASS_NAME` \$1 `JDBC_ENGINE` \$1 `JDBC_ENGINE_VERSION` \$1 `CONFIG_FILES` \$1 `INSTANCE_ID` \$1 \$1 `JDBC_CONNECTION_URL` \$1 `JDBC_ENFORCE_SSL` \$1 `CUSTOM_JDBC_CERT` \$1 `SKIP_CUSTOM_JDBC_CERT_VALIDATION` \$1 `CUSTOM_JDBC_CERT_STRING` \$1 `CONNECTION_URL` \$1 `KAFKA_BOOTSTRAP_SERVERS` \$1 `KAFKA_SSL_ENABLED` \$1 \$1 `KAFKA_CUSTOM_CERT` \$1 `KAFKA_SKIP_CUSTOM_CERT_VALIDATION` \$1 `KAFKA_CLIENT_KEYSTORE` \$1 `KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `KAFKA_CLIENT_KEY_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD` \$1 `KAFKA_SASL_MECHANISM` \$1 `KAFKA_SASL_PLAIN_USERNAME` \$1 `KAFKA_SASL_PLAIN_PASSWORD` \$1 \$1 `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD` \$1 `KAFKA_SASL_SCRAM_USERNAME` \$1 `KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_SCRAM_SECRETS_ARN` \$1 `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD` `KAFKA_SASL_GSSAPI_KEYTAB` `KAFKA_SASL_GSSAPI_KRB5_CONF` \$1 `KAFKA_SASL_GSSAPI_SERVICE` \$1 `KAFKA_SASL_GSSAPI_PRINCIPAL` \$1 `SECRET_ID` \$1 `CONNECTOR_URL` \$1 `CONNECTOR_TYPE` \$1 `CONNECTOR_CLASS_NAME` `ENDPOINT` \$1 `ENDPOINT_TYPE` \$1 `ROLE_ARN` \$1 `REGION` \$1 `WORKGROUP_NAME` \$1 `CLUSTER_IDENTIFIER` \$1`DATABASE`).
Setiap nilai adalah string Nilai, panjangnya tidak kurang dari 1 atau lebih dari 1024 byte.
Pasangan kunci-nilai yang menentukan parameter untuk koneksi.
Koneksi JDBC menggunakan properti koneksi berikut:
+ Diperlukan: Semua (`HOST`,`PORT`,`JDBC_ENGINE`) atau`JDBC_CONNECTION_URL`.
+ Diperlukan: Semua (`USERNAME`,`PASSWORD`) atau`SECRET_ID`.
+ Opsional:`JDBC_ENFORCE_SSL`,`CUSTOM_JDBC_CERT`,`CUSTOM_JDBC_CERT_STRING`,`SKIP_CUSTOM_JDBC_CERT_VALIDATION`. Parameter ini digunakan untuk mengkonfigurasi SSL dengan JDBC.
Koneksi SALESFORCE mengharuskan `AuthenticationConfiguration` anggota untuk dikonfigurasi.
+ `AuthenticationConfiguration` — Sebuah objek [AuthenticationConfigurationInput](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput).
Struktur yang berisi konfigurasi otentikasi dalam TestConnection permintaan. Diperlukan untuk koneksi ke Salesforce menggunakan OAuth otentikasi.
## PhysicalConnectionRequirements struktur
Aplikasi OAuth klien GetConnection sebagai tanggapan.
**Bidang**
+ `SubnetId` — 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 subnet yang digunakan oleh koneksi.
+ `SecurityGroupIdList` — Susunan string UTF-8, tidak lebih dari 50 string.
Daftar ID grup keamanan yang digunakan oleh koneksi.
+ `AvailabilityZone` — 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).
Availability Zone koneksi.
## GetConnectionsFilter struktur
Mem-filter definisi koneksi yang dikembalikan oleh operasi API `GetConnections`.
**Bidang**
+ `MatchCriteria` — Susunan string UTF-8, tidak lebih dari 10 string.
Sebuah kriteria string yang harus sesuai dengan kriteria yang dicatat dalam definisi koneksi untuk definisi koneksi yang akan dikembalikan.
+ `ConnectionType`— UTF-8 string (nilai valid: `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` `INTERCOM` `SNAPCHATADS`\$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` \$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE`\$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1`VERTICA`).
Jenis koneksi yang akan dikembalikan. Saat ini, SFTP tidak didukung.
+ `ConnectionSchemaVersion`— Angka (bilangan bulat), tidak kurang dari 1 atau lebih dari 2.
Menunjukkan jika koneksi dibuat dengan skema versi 1 atau 2.
## AuthenticationConfiguration struktur
Struktur yang berisi konfigurasi otentikasi.
**Bidang**
+ `AuthenticationType` – String UTF-8 (nilai yang valid: `BASIC` \$1 `OAUTH2` \$1 `CUSTOM` \$1 `IAM`).
Struktur yang berisi konfigurasi otentikasi.
+ `SecretArn` — String UTF-8, yang cocok dengan [Custom string pattern #36](aws-glue-api-common.md#regex_36).
Manajer rahasia ARN untuk menyimpan kredensi.
+ `KmsKeyArn` — String UTF-8, yang cocok dengan [Custom string pattern #42](aws-glue-api-common.md#regex_42).
Nama Sumber Daya Amazon (ARN) dari kunci KMS yang digunakan untuk mengenkripsi informasi otentikasi sensitif. Kunci ini digunakan untuk melindungi kredensyal dan data sensitif lainnya yang disimpan dalam konfigurasi otentikasi.
+ `OAuth2Properties` — Sebuah objek [OAuth2Properti](#aws-glue-api-catalog-connections-connections-OAuth2Properties).
Properti untuk OAuth2 otentikasi.
## AuthenticationConfigurationInput struktur
Struktur yang berisi konfigurasi otentikasi dalam CreateConnection permintaan.
**Bidang**
+ `AuthenticationType` – String UTF-8 (nilai yang valid: `BASIC` \$1 `OAUTH2` \$1 `CUSTOM` \$1 `IAM`).
Struktur yang berisi konfigurasi otentikasi dalam CreateConnection permintaan.
+ `OAuth2Properties` — Sebuah objek [OAuth2PropertiesInput](#aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput).
Properti untuk OAuth2 otentikasi dalam CreateConnection permintaan.
+ `SecretArn` — String UTF-8, yang cocok dengan [Custom string pattern #36](aws-glue-api-common.md#regex_36).
Manajer rahasia ARN untuk menyimpan kredensyal dalam permintaan. CreateConnection
+ `KmsKeyArn` — String UTF-8, yang cocok dengan [Custom string pattern #42](aws-glue-api-common.md#regex_42).
ARN dari kunci KMS digunakan untuk mengenkripsi koneksi. Hanya diambil sebagai input dalam permintaan dan disimpan di Secret Manager.
+ `BasicAuthenticationCredentials` — Sebuah objek [BasicAuthenticationCredentials](#aws-glue-api-catalog-connections-connections-BasicAuthenticationCredentials).
Kredensyal yang digunakan ketika jenis otentikasi adalah otentikasi dasar.
+ `CustomAuthenticationCredentials` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 2048 byte.
Kredensyal yang digunakan ketika jenis otentikasi adalah otentikasi kustom.
## OAuth2Struktur properti
Struktur yang berisi properti untuk OAuth2 otentikasi.
**Bidang**
+ `OAuth2GrantType` – String UTF-8 (nilai yang valid: `AUTHORIZATION_CODE` \$1 `CLIENT_CREDENTIALS` \$1 `JWT_BEARER`).
Jenis OAuth2 hibah. Sebagai contoh, `AUTHORIZATION_CODE`, `JWT_BEARER`, atau `CLIENT_CREDENTIALS`.
+ `OAuth2ClientApplication` — Sebuah objek [OAuth2ClientApplication](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication).
Jenis aplikasi klien. Misalnya, AWS\$1MANAGED atau USER\$1MANAGED.
+ `TokenUrl`— String UTF-8, panjangnya tidak lebih dari 256 byte, cocok dengan file. [Custom string pattern #40](aws-glue-api-common.md#regex_40)
URL server otentikasi penyedia, untuk menukar kode otorisasi untuk token akses.
+ `TokenUrlParametersMap` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 512 byte.
Peta parameter yang ditambahkan ke `GET` permintaan token.
## OAuth2PropertiesInput struktur
Struktur yang berisi properti untuk OAuth2 dalam CreateConnection permintaan.
**Bidang**
+ `OAuth2GrantType` – String UTF-8 (nilai yang valid: `AUTHORIZATION_CODE` \$1 `CLIENT_CREDENTIALS` \$1 `JWT_BEARER`).
Jenis OAuth2 hibah dalam CreateConnection permintaan. Sebagai contoh, `AUTHORIZATION_CODE`, `JWT_BEARER`, atau `CLIENT_CREDENTIALS`.
+ `OAuth2ClientApplication` — Sebuah objek [OAuth2ClientApplication](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication).
Jenis aplikasi klien dalam CreateConnection permintaan. Misalnya, `AWS_MANAGED` atau `USER_MANAGED`.
+ `TokenUrl`— String UTF-8, panjangnya tidak lebih dari 256 byte, cocok dengan file. [Custom string pattern #40](aws-glue-api-common.md#regex_40)
URL server otentikasi penyedia, untuk menukar kode otorisasi untuk token akses.
+ `TokenUrlParametersMap` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 512 byte.
Peta parameter yang ditambahkan ke `GET` permintaan token.
+ `AuthorizationCodeProperties` — Sebuah objek [AuthorizationCodeProperties](#aws-glue-api-catalog-connections-connections-AuthorizationCodeProperties).
Kumpulan properti yang diperlukan untuk jenis OAuth2 `AUTHORIZATION_CODE` hibah.
+ `OAuth2Credentials` — Sebuah objek [OAuth2Kredensialnya](#aws-glue-api-catalog-connections-connections-OAuth2Credentials).
Kredensyal yang digunakan saat jenis otentikasi adalah otentikasi. OAuth2
## OAuth2ClientApplication struktur
Aplikasi OAuth2 klien yang digunakan untuk koneksi.
**Bidang**
+ `UserManagedClientApplicationClientId` — String UTF-8, sepanjang tidak lebih dari 2048, yang cocok dengan [Custom string pattern #37](aws-glue-api-common.md#regex_37).
Aplikasi klien ClientID jika ada. ClientAppType `USER_MANAGED`
+ `AWSManagedClientApplicationReference` — String UTF-8, sepanjang tidak lebih dari 2048, yang cocok dengan [Custom string pattern #37](aws-glue-api-common.md#regex_37).
Referensi ke aplikasi klien sisi SaaS yang dikelola AWS .
## AuthorizationCodeProperties struktur
Kumpulan properti yang diperlukan untuk alur kerja jenis OAuth2 `AUTHORIZATION_CODE` hibah.
**Bidang**
+ `AuthorizationCode`— String UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 4096 byte, cocok dengan file. [Custom string pattern #37](aws-glue-api-common.md#regex_37)
Kode otorisasi yang akan digunakan di bagian ketiga alur kerja `AUTHORIZATION_CODE` hibah. Ini adalah kode sekali pakai yang menjadi tidak valid setelah ditukar dengan token akses, sehingga dapat diterima untuk memiliki nilai ini sebagai parameter permintaan.
+ `RedirectUri`— String UTF-8, panjangnya tidak lebih dari 512 byte, cocok dengan. [Custom string pattern #41](aws-glue-api-common.md#regex_41)
URI pengalihan tempat pengguna diarahkan oleh server otorisasi saat mengeluarkan kode otorisasi. URI selanjutnya digunakan ketika kode otorisasi ditukar dengan token akses.
## BasicAuthenticationCredentials struktur
Untuk menyediakan kredensyal autentikasi dasar saat tidak memberikan nilai. `SecretArn`
**Bidang**
+ `Username`— String UTF-8, panjangnya tidak lebih dari 512 byte, cocok dengan. [Custom string pattern #37](aws-glue-api-common.md#regex_37)
Nama pengguna untuk terhubung ke sumber data.
+ `Password`— String UTF-8, panjangnya tidak lebih dari 512 byte, cocok dengan. [Custom string pattern #33](aws-glue-api-common.md#regex_33)
Kata sandi untuk terhubung ke sumber data.
## OAuth2Struktur kredensial
Kredensyal yang digunakan saat jenis otentikasi adalah otentikasi. OAuth2
**Bidang**
+ `UserManagedClientApplicationClientSecret`— String UTF-8, panjangnya tidak lebih dari 512 byte, cocok dengan. [Custom string pattern #38](aws-glue-api-common.md#regex_38)
Rahasia klien aplikasi klien jika aplikasi klien dikelola pengguna.
+ `AccessToken`— String UTF-8, panjangnya tidak lebih dari 4096 byte, cocok dengan. [Custom string pattern #38](aws-glue-api-common.md#regex_38)
Token akses yang digunakan saat jenis otentikasi. OAuth2
+ `RefreshToken`— String UTF-8, panjangnya tidak lebih dari 4096 byte, cocok dengan. [Custom string pattern #38](aws-glue-api-common.md#regex_38)
Token penyegaran yang digunakan saat jenis otentikasi. OAuth2
+ `JwtToken`— String UTF-8, panjangnya tidak lebih dari 8000 byte, cocok dengan. [Custom string pattern #39](aws-glue-api-common.md#regex_39)
JSON Web Token (JWT) digunakan ketika jenis otentikasi. OAuth2
## Operasi
+ [CreateConnection tindakan (Python: create\$1connection)](#aws-glue-api-catalog-connections-connections-CreateConnection)
+ [DeleteConnection tindakan (Python: delete\$1connection)](#aws-glue-api-catalog-connections-connections-DeleteConnection)
+ [GetConnection tindakan (Python: get\$1connection)](#aws-glue-api-catalog-connections-connections-GetConnection)
+ [GetConnections tindakan (Python: get\$1connections)](#aws-glue-api-catalog-connections-connections-GetConnections)
+ [UpdateConnection tindakan (Python: update\$1connection)](#aws-glue-api-catalog-connections-connections-UpdateConnection)
+ [TestConnection tindakan (Python: test\$1connection)](#aws-glue-api-catalog-connections-connections-TestConnection)
+ [BatchDeleteConnection tindakan (Python: batch\$1delete\$1connection)](#aws-glue-api-catalog-connections-connections-BatchDeleteConnection)
## CreateConnection tindakan (Python: create\$1connection)
Menciptakan sebuah definisi koneksi baru dalam Katalog Data.
Koneksi yang digunakan untuk membuat sumber daya federasi memerlukan izin IAM`glue:PassConnection`.
**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 koneksi akan dibuat. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `ConnectionInput` — *Wajib:* Sebuah objek [ConnectionInput](#aws-glue-api-catalog-connections-connections-ConnectionInput).
Sebuah objek `ConnectionInput` yang mendefinisikan koneksi yang akan dibuat.
+ `Tags` — Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 50 pasang.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak lebih dari 256 byte.
Tag yang Anda tetapkan ke koneksi.
**Respons**
+ `CreateConnectionStatus` – String UTF-8 (nilai yang valid: `READY` \$1 `IN_PROGRESS` \$1 `FAILED`).
Status permintaan pembuatan koneksi. Permintaan dapat memakan waktu untuk jenis otentikasi tertentu, misalnya saat membuat OAuth koneksi dengan pertukaran token melalui VPC.
**Kesalahan**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`
## DeleteConnection tindakan (Python: delete\$1connection)
Menghapus sebuah koneksi dari 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 koneksi berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `ConnectionName` — *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 koneksi yang akan dihapus.
**Respons**
+ *Tidak ada parameter Respons.*
**Kesalahan**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
## GetConnection tindakan (Python: get\$1connection)
Mengambil sebuah definisi koneksi dari 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 koneksi berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `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 definisi koneksi yang akan diambil.
+ `HidePassword` – Boolean.
Memungkinkan Anda untuk mengambil metadata koneksi tanpa perlu mengembalikan kata sandi. Misalnya, AWS Glue konsol menggunakan bendera ini untuk mengambil koneksi, dan tidak menampilkan kata sandi. Tetapkan parameter ini ketika pemanggil mungkin tidak memiliki izin untuk menggunakan AWS KMS kunci untuk mendekripsi kata sandi, tetapi ia memiliki izin untuk mengakses properti koneksi lainnya.
+ `ApplyOverrideForComputeEnvironment` – String UTF-8 (nilai yang valid: `SPARK` \$1 `ATHENA` \$1 `PYTHON`).
Untuk koneksi yang dapat digunakan dalam beberapa layanan, menentukan properti kembali untuk lingkungan komputasi yang ditentukan.
**Respons**
+ `Connection` — Sebuah objek [Koneksi](#aws-glue-api-catalog-connections-connections-Connection).
Definisi koneksi yang diminta.
**Kesalahan**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
## GetConnections tindakan (Python: get\$1connections)
Mengambil sebuah daftar definisi koneksi dari 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 koneksi berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `Filter` — Sebuah objek [GetConnectionsFilter](#aws-glue-api-catalog-connections-connections-GetConnectionsFilter).
Filter yang mengontrol koneksi mana yang dikembalikan.
+ `HidePassword` – Boolean.
Memungkinkan Anda untuk mengambil metadata koneksi tanpa perlu mengembalikan kata sandi. Misalnya, AWS Glue konsol menggunakan bendera ini untuk mengambil koneksi, dan tidak menampilkan kata sandi. Tetapkan parameter ini ketika pemanggil mungkin tidak memiliki izin untuk menggunakan AWS KMS kunci untuk mendekripsi kata sandi, tetapi ia memiliki izin untuk mengakses properti koneksi lainnya.
+ `NextToken` – String UTF-8.
Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan.
+ `MaxResults` — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 1000.
Jumlah maksimum koneksi yang akan dikembalikan dalam satu respons.
**Respons**
+ `ConnectionList` – Susunan objek [Koneksi](#aws-glue-api-catalog-connections-connections-Connection).
Daftar definisi koneksi yang diminta.
+ `NextToken` – String UTF-8.
Sebuah token kelanjutan, jika daftar koneksi yang dikembalikan tidak mencakup koneksi disaring yang terakhir.
**Kesalahan**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
## UpdateConnection tindakan (Python: update\$1connection)
Memperbarui sebuah definisi koneksi 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 koneksi berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `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 definisi koneksi yang akan diperbarui.
+ `ConnectionInput` — *Wajib:* Sebuah objek [ConnectionInput](#aws-glue-api-catalog-connections-connections-ConnectionInput).
Sebuah objek `ConnectionInput` yang mengubah koneksi yang dimaksud.
**Respons**
+ *Tidak ada parameter Respons.*
**Kesalahan**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
## TestConnection tindakan (Python: test\$1connection)
Menguji koneksi ke layanan untuk memvalidasi kredensyal layanan yang Anda berikan.
Anda dapat memberikan nama koneksi yang ada atau `TestConnectionInput` untuk menguji input koneksi yang tidak ada. Menyediakan keduanya pada saat yang sama akan menyebabkan kesalahan.
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
**Permintaan**
+ `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).
Tidak wajib. Nama koneksi yang akan diuji. Jika hanya nama yang diberikan, operasi akan mendapatkan koneksi dan menggunakannya untuk pengujian.
+ `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 koneksi berada.
+ `TestConnectionInput` — Sebuah objek [TestConnectionInput](#aws-glue-api-catalog-connections-connections-TestConnectionInput).
Struktur yang digunakan untuk menentukan pengujian koneksi ke layanan.
**Respons**
+ *Tidak ada parameter Respons.*
**Kesalahan**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`
+ `FederationSourceException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ConflictException`
+ `InternalServiceException`
## BatchDeleteConnection tindakan (Python: batch\$1delete\$1connection)
Menghapus sebuah daftar definisi koneksi dari 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 koneksi berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `ConnectionNameList` — *Wajib:* Susunan string UTF-8, tidak lebih dari 25 string.
Daftar nama koneksi yang akan dihapus.
**Respons**
+ `Succeeded` – Susunan string UTF-8.
Daftar nama definisi koneksi yang sudah berhasil dihapus.
+ `Errors` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, 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).
Setiap nilai adalah sebuah objek [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail).
Peta nama koneksi yang tidak berhasil dihapus ke detail kesalahan.
**Kesalahan**
+ `InternalServiceException`
+ `OperationTimeoutException`
# Jenis Koneksi API
Connection Type API menjelaskan AWS Glue APIs terkait dengan mendeskripsikan jenis koneksi.
## Manajemen koneksi APIs
+ [DescribeConnectionType tindakan (Python: describe\$1connection\$1type)](#aws-glue-api-catalog-connections-connections-type-DescribeConnectionType)
+ [ListConnectionTypes tindakan (Python: list\$1connection\$1types)](#aws-glue-api-catalog-connections-connections-type-ListConnectionTypes)
+ [ConnectionTypeBrief struktur](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief)
+ [ConnectionTypeVariant struktur](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant)
## DescribeConnectionType tindakan (Python: describe\$1connection\$1type)
`DescribeConnectionType`API memberikan rincian lengkap tentang opsi yang didukung untuk jenis koneksi tertentu AWS Glue.
**Permintaan**
+ `ConnectionType` — *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 jenis koneksi yang akan dijelaskan.
**Respons**
+ `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).
Nama jenis koneksi.
+ `Description`— String UTF-8, panjangnya tidak lebih dari 1024 byte.
Deskripsi jenis koneksi.
+ `Capabilities` — Sebuah objek [Kemampuan](#aws-glue-api-catalog-connections-connections-type-Capabilities).
Jenis otentikasi yang didukung, tipe antarmuka data (lingkungan komputasi), dan operasi data konektor.
+ `ConnectionProperties` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.
Properti koneksi yang umum di seluruh lingkungan komputasi.
+ `ConnectionOptions` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.
Mengembalikan properti yang dapat diatur saat membuat koneksi di`ConnectionInput.ConnectionProperties`. `ConnectionOptions`mendefinisikan parameter yang dapat diatur dalam skrip Spark ETL di peta opsi koneksi yang diteruskan ke kerangka data.
+ `AuthenticationConfiguration` — Sebuah objek [AuthConfiguration](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration).
Jenis otentikasi yang digunakan untuk koneksi.
+ `ComputeEnvironmentConfigurations` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah sebuah objek [ComputeEnvironmentConfiguration](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration) A.
Lingkungan komputasi yang didukung oleh koneksi.
+ `PhysicalConnectionRequirements` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.
Persyaratan fisik untuk koneksi, seperti spesifikasi VPC, Subnet, dan Grup Keamanan.
+ `AthenaConnectionProperties` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.
Properti koneksi khusus untuk lingkungan komputasi Athena.
+ `PythonConnectionProperties` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.
Properti koneksi khusus untuk lingkungan komputasi Python.
+ `SparkConnectionProperties` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.
Properti koneksi khusus untuk lingkungan komputasi Spark.
**Kesalahan**
+ `ValidationException`
+ `InvalidInputException`
+ `InternalServiceException`
## ListConnectionTypes tindakan (Python: list\$1connection\$1types)
`ListConnectionTypes`API menyediakan mekanisme penemuan untuk mempelajari jenis koneksi yang tersedia di AWS Glue. Respons berisi daftar jenis koneksi dengan detail tingkat tinggi tentang apa yang didukung untuk setiap jenis koneksi. Jenis koneksi yang tercantum adalah kumpulan opsi yang didukung untuk `ConnectionType` nilai di `CreateConnection` API.
**Permintaan**
+ `MaxResults` — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 1000.
Jumlah hasil maksimum yang akan dikembalikan.
+ `NextToken` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 2048 byte, yang cocok dengan [Custom string pattern #11](aws-glue-api-common.md#regex_11).
Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan.
**Respons**
+ `ConnectionTypes` – Susunan objek [ConnectionTypeBrief](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief).
Daftar `ConnectionTypeBrief` objek yang berisi informasi singkat tentang jenis koneksi yang didukung.
+ `NextToken` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 2048 byte, yang cocok dengan [Custom string pattern #11](aws-glue-api-common.md#regex_11).
Token kelanjutan, jika segmen daftar saat ini bukan yang terakhir.
**Kesalahan**
+ `InternalServiceException`
## ConnectionTypeBrief struktur
Informasi singkat tentang jenis koneksi yang didukung yang dikembalikan oleh `ListConnectionTypes` API.
**Bidang**
+ `ConnectionType`— UTF-8 string (nilai yang valid: `JDBC` `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` `INTERCOM` `SNAPCHATADS`\$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` \$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE`\$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1`VERTICA`).
Nama jenis koneksi.
+ `DisplayName` — String UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Nama yang dapat dibaca manusia untuk jenis koneksi yang ditampilkan di konsol. AWS Glue
+ `Vendor` — String UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Nama vendor atau penyedia yang membuat atau memelihara jenis koneksi ini.
+ `Description`— String UTF-8, panjangnya tidak lebih dari 1024 byte.
Deskripsi jenis koneksi.
+ `Categories` – .
Daftar kategori yang dimiliki oleh jenis koneksi ini. Kategori membantu pengguna memfilter dan menemukan jenis koneksi yang sesuai berdasarkan kasus penggunaannya.
+ `Capabilities` — Sebuah objek [Kemampuan](#aws-glue-api-catalog-connections-connections-type-Capabilities).
Jenis otentikasi yang didukung, tipe antarmuka data (lingkungan komputasi), dan operasi data konektor.
+ `LogoUrl` – String UTF-8.
URL logo yang terkait dengan jenis koneksi.
+ `ConnectionTypeVariants` – Susunan objek [ConnectionTypeVariant](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant).
Daftar varian yang tersedia untuk jenis koneksi ini. Varian yang berbeda dapat menyediakan konfigurasi khusus untuk kasus penggunaan tertentu atau implementasi dari jenis koneksi umum yang sama.
## ConnectionTypeVariant struktur
Merupakan varian dari jenis koneksi dalam Katalog AWS Glue Data. Varian tipe koneksi menyediakan konfigurasi dan perilaku spesifik untuk implementasi yang berbeda dari jenis koneksi umum yang sama.
**Bidang**
+ `ConnectionTypeVariantName` — String UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Pengidentifikasi unik untuk varian tipe koneksi. Nama ini digunakan secara internal untuk mengidentifikasi varian spesifik dari jenis koneksi.
+ `DisplayName` — String UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Nama yang dapat dibaca manusia untuk varian jenis koneksi yang ditampilkan di konsol. AWS Glue
+ `Description`— String UTF-8, panjangnya tidak lebih dari 1024 byte.
Penjelasan rinci tentang varian jenis koneksi, termasuk tujuannya, kasus penggunaan, dan persyaratan konfigurasi spesifik apa pun.
+ `LogoUrl` – String UTF-8.
URL logo yang terkait dengan varian jenis koneksi.
## tipe data
+ [Struktur validasi](#aws-glue-api-catalog-connections-connections-type-Validation)
+ [AuthConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration)
+ [Struktur kemampuan](#aws-glue-api-catalog-connections-connections-type-Capabilities)
+ [Struktur properti](#aws-glue-api-catalog-connections-connections-type-Property)
+ [AllowedValue struktur](#aws-glue-api-catalog-connections-connections-type-AllowedValue)
+ [ComputeEnvironmentConfiguration struktur](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration)
## Struktur validasi
Mendefinisikan bagaimana validasi dilakukan pada properti koneksi.
**Bidang**
+ `ValidationType` – *Wajib:* String UTF-8 (nilai yang valid: `REGEX` \$1 `RANGE`).
Jenis validasi yang akan dilakukan, seperti`REGEX`.
+ `Patterns` – .
Daftar pola yang berlaku untuk validasi.
+ `Description`- *Diperlukan:* string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 1024 byte.
Deskripsi untuk validasi.
+ `MaxLength` — Nomor (bilangan bulat).
Panjang maksimum untuk properti koneksi string.
+ `Maximum` — Nomor (bilangan bulat).
Nilai maksimum saat menentukan `RANGE` jenis validasi.
+ `Minimum` — Nomor (bilangan bulat).
Nilai minimum saat menentukan `RANGE` jenis validasi.
## AuthConfiguration struktur
Konfigurasi otentikasi untuk koneksi yang dikembalikan oleh `DescribeConnectionType` API.
**Bidang**
+ `AuthenticationType` — *Wajib:* Sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property).
Jenis otentikasi untuk koneksi.
+ `SecretArn` — Sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property).
Nama Sumber Daya Amazon (ARN) untuk Secrets Manager.
+ `OAuth2Properties` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.
Peta pasangan kunci-nilai untuk properti. OAuth2 Setiap nilai adalah `Property` objek.
+ `BasicAuthenticationProperties` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.
Peta pasangan kunci-nilai untuk properti. OAuth2 Setiap nilai adalah `Property` objek.
+ `CustomAuthenticationProperties` – Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.
Peta pasangan kunci-nilai untuk properti otentikasi kustom. Setiap nilai adalah `Property` objek.
## Struktur kemampuan
Menentukan jenis otentikasi didukung dikembalikan oleh API. `DescribeConnectionType`
**Bidang**
+ `SupportedAuthenticationTypes` – *Wajib:* Susunan string UTF-8.
Daftar jenis otentikasi yang didukung.
+ `SupportedDataOperations` – *Wajib:* Susunan string UTF-8.
Daftar operasi data yang didukung.
+ `SupportedComputeEnvironments` – *Wajib:* Susunan string UTF-8.
Daftar lingkungan komputasi yang didukung.
## Struktur properti
Objek yang mendefinisikan jenis koneksi untuk lingkungan komputasi.
**Bidang**
+ `Name`- *Diperlukan:* string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.
Nama properti.
+ `Description`- *Diperlukan:* string UTF-8, panjangnya tidak lebih dari 1024 byte.
Deskripsi properti.
+ `Required` – *Wajib:* Boolean.
Menunjukkan apakah properti diperlukan.
+ `PropertyTypes` – *Wajib:* Susunan string UTF-8.
Menjelaskan jenis properti.
+ `AllowedValues` – Susunan objek [AllowedValue](#aws-glue-api-catalog-connections-connections-type-AllowedValue).
Daftar `AllowedValue` objek yang mewakili nilai yang diizinkan untuk properti.
+ `DataOperationScopes` – Susunan string UTF-8.
Menunjukkan operasi data mana yang berlaku untuk properti.
## AllowedValue struktur
Objek yang mewakili nilai yang diizinkan untuk properti.
**Bidang**
+ `Description`— String UTF-8, panjangnya tidak lebih dari 1024 byte.
Deskripsi nilai yang diizinkan.
+ `Value`- *Diperlukan:* string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.
Nilai yang diizinkan untuk properti.
## ComputeEnvironmentConfiguration struktur
Objek yang berisi konfigurasi untuk lingkungan komputasi (seperti Spark, Python, atau Athena) yang dikembalikan oleh API. `DescribeConnectionType`
**Bidang**
+ `Name`- *Diperlukan:* string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.
Nama untuk konfigurasi lingkungan komputasi.
+ `Description`- *Diperlukan:* string UTF-8, panjangnya tidak lebih dari 1024 byte.
Deskripsi lingkungan komputasi.
+ `ComputeEnvironment` – *Wajib:* String UTF-8 (nilai yang valid: `SPARK` \$1 `ATHENA` \$1 `PYTHON`).
Tipe lingkungan komputasi.
+ `SupportedAuthenticationTypes` – *Wajib:* Susunan string UTF-8.
Jenis otentikasi yang didukung untuk lingkungan komputasi.
+ `ConnectionOptions` – *Wajib:* Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah sebuah objek [Properti](#aws-glue-api-catalog-connections-connections-type-Property) A.
Parameter yang digunakan sebagai opsi koneksi untuk lingkungan komputasi.
+ `ConnectionPropertyNameOverrides` – *Wajib:* Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.
Nama properti koneksi diganti untuk lingkungan komputasi.
+ `ConnectionOptionNameOverrides` – *Wajib:* Susunan peta pasangan nilai kunci.
Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.
Setiap nilai adalah string UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.
Nama opsi koneksi menggantikan untuk lingkungan komputasi.
+ `ConnectionPropertiesRequiredOverrides`— *Diperlukan:*.
Properti koneksi yang diperlukan sebagai penggantian untuk lingkungan komputasi.
+ `PhysicalConnectionPropertiesRequired` – Boolean.
Menunjukkan `PhysicalConnectionProperties` apakah diperlukan untuk lingkungan komputasi.
# Metadata Koneksi dan API Pratinjau
Koneksi berikut APIs menjelaskan operasi untuk menggambarkan metadata koneksi.
## Jenis Data
+ [Struktur entitas](#aws-glue-api-catalog-connections-connections-metadata-Entity)
+ [Struktur lapangan](#aws-glue-api-catalog-connections-connections-metadata-Field)
## Struktur entitas
Entitas yang didukung oleh yang diberikan`ConnectionType`.
**Bidang**
+ `EntityName` – String UTF-8.
Nama entitas.
+ `Label` – String UTF-8.
Label yang digunakan untuk entitas.
+ `IsParentEntity` – Boolean.
Sebuah nilai Boolean yang membantu untuk menentukan apakah ada sub objek yang dapat terdaftar.
+ `Description` – String UTF-8.
Deskripsi entitas.
+ `Category` – String UTF-8.
Jenis entitas yang hadir dalam respons. Nilai ini tergantung pada koneksi sumber. Misalnya ini `SObjects` untuk Salesforce dan `databases` atau `schemas` atau `tables` untuk sumber seperti Amazon Redshift.
+ `CustomProperties` –
Peta opsional kunci yang dapat dikembalikan untuk entitas oleh konektor.
## Struktur lapangan
`Field`Objek memiliki informasi tentang berbagai properti yang terkait dengan bidang di konektor.
**Bidang**
+ `FieldName` – String UTF-8.
Pengenal unik untuk bidang tersebut.
+ `Label` – String UTF-8.
Label yang dapat dibaca yang digunakan untuk bidang tersebut.
+ `Description` – String UTF-8.
Deskripsi lapangan.
+ `FieldType`— UTF-8 string (nilai valid: `INT` \$1 \$1 `SMALLINT` \$1 `BIGINT` \$1 `FLOAT` \$1 `LONG` \$1 `DATE` \$1 `BOOLEAN` \$1 `MAP` \$1 `ARRAY` \$1 \$1 `STRING` \$1 `TIMESTAMP` \$1 `DECIMAL` \$1 `BYTE` `SHORT` `DOUBLE` \$1`STRUCT`).
Jenis data di lapangan.
+ `IsPrimaryKey` – Boolean.
Menunjukkan apakah bidang ini dapat digunakan sebagai kunci utama untuk entitas yang diberikan.
+ `IsNullable` – Boolean.
Menunjukkan apakah bidang ini dapat dibatalkan atau tidak.
+ `IsRetrievable` – Boolean.
Menunjukkan apakah bidang ini dapat ditambahkan dalam klausa Pilih dari kueri SQL atau apakah itu dapat diambil atau tidak.
+ `IsFilterable` – Boolean.
Menunjukkan apakah bidang ini dapat digunakan dalam klausa filter (`WHERE`klausa) dari pernyataan SQL saat menanyakan data.
+ `IsPartitionable` – Boolean.
Menunjukkan apakah bidang tertentu dapat digunakan dalam mempartisi kueri yang dibuat untuk SaaS.
+ `IsCreateable` – Boolean.
Menunjukkan apakah bidang ini dapat dibuat sebagai bagian dari penulisan tujuan.
+ `IsUpdateable` – Boolean.
Menunjukkan apakah bidang ini dapat diperbarui sebagai bagian dari penulisan tujuan.
+ `IsUpsertable` – Boolean.
Menunjukkan apakah bidang ini dapat diangkat sebagai bagian dari penulisan tujuan.
+ `IsDefaultOnCreate` – Boolean.
Menunjukkan apakah bidang ini diisi secara otomatis ketika objek dibuat, seperti dibuat pada stempel waktu.
+ `SupportedValues` – .
Daftar nilai yang didukung untuk bidang tersebut.
+ `SupportedFilterOperators` – Susunan string UTF-8.
Menunjukkan operator filter dukungan untuk bidang ini.
+ `CustomProperties` –
Peta opsional kunci yang dapat dikembalikan.
## Operasi
+ [ListEntities tindakan (Python: list\$1entities)](#aws-glue-api-catalog-connections-connections-metadata-ListEntities)
+ [DescribeEntity tindakan (Python: describe\$1entity)](#aws-glue-api-catalog-connections-connections-metadata-DescribeEntity)
+ [GetEntityRecords tindakan (Python: get\$1entity\$1records)](#aws-glue-api-catalog-connections-connections-metadata-GetEntityRecords)
## ListEntities tindakan (Python: list\$1entities)
Mengembalikan entitas yang tersedia didukung oleh jenis koneksi.
**Permintaan**
+ `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 untuk koneksi yang memerlukan kredensi untuk menanyakan jenis koneksi apa pun.
+ `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 katalog yang berisi koneksi. Ini bisa null, Secara default, ID AWS Akun adalah ID katalog.
+ `ParentEntityName` – String UTF-8.
Nama entitas induk yang ingin Anda daftarkan anak-anak. Parameter ini mengambil jalur entitas yang sepenuhnya memenuhi syarat untuk membuat daftar entitas anak.
+ `NextToken` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 2048 byte, yang cocok dengan [Custom string pattern #11](aws-glue-api-common.md#regex_11).
Sebuah token kelanjutan, disertakan jika ini adalah sebuah panggilan kelanjutan.
+ `DataStoreApiVersion` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 256 byte, yang cocok dengan [Custom string pattern #23](aws-glue-api-common.md#regex_23).
Versi API dari konektor SaaS.
**Respons**
+ `Entities` – Susunan objek [Entitas](#aws-glue-api-catalog-connections-connections-metadata-Entity).
Daftar objek `Entity`.
+ `NextToken` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 2048 byte, yang cocok dengan [Custom string pattern #11](aws-glue-api-common.md#regex_11).
Token kelanjutan, hadir jika segmen saat ini bukan yang terakhir.
**Kesalahan**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`
## DescribeEntity tindakan (Python: describe\$1entity)
Memberikan rincian mengenai entitas yang digunakan dengan jenis koneksi, dengan deskripsi model data untuk setiap bidang dalam entitas yang dipilih.
Respons mencakup semua bidang yang membentuk entitas.
**Permintaan**
+ `ConnectionName` — *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 koneksi yang berisi kredenal jenis koneksi.
+ `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 katalog yang berisi koneksi. Ini bisa null, Secara default, ID AWS Akun adalah ID katalog.
+ `EntityName` – *Wajib:* String UTF-8.
Nama entitas yang ingin Anda gambarkan dari jenis koneksi.
+ `NextToken` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 2048 byte, yang cocok dengan [Custom string pattern #11](aws-glue-api-common.md#regex_11).
Sebuah token kelanjutan, disertakan jika ini adalah sebuah panggilan kelanjutan.
+ `DataStoreApiVersion` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 256 byte, yang cocok dengan [Custom string pattern #23](aws-glue-api-common.md#regex_23).
Versi API yang digunakan untuk penyimpanan data.
**Respons**
+ `Fields` – Susunan objek [Bidang](#aws-glue-api-catalog-connections-connections-metadata-Field).
Menjelaskan bidang untuk entitas konektor tersebut. Ini adalah daftar `Field` objek. `Field`sangat mirip dengan kolom dalam database. `Field`Objek memiliki informasi tentang berbagai properti yang terkait dengan bidang di konektor.
+ `NextToken` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 2048 byte, yang cocok dengan [Custom string pattern #11](aws-glue-api-common.md#regex_11).
Token kelanjutan, hadir jika segmen saat ini bukan yang terakhir.
**Kesalahan**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`
## GetEntityRecords tindakan (Python: get\$1entity\$1records)
API ini digunakan untuk menanyakan data pratinjau dari jenis koneksi tertentu atau dari Katalog AWS Glue Data berbasis Amazon S3 asli.
Mengembalikan catatan sebagai array gumpalan JSON. Setiap rekaman diformat menggunakan Jackson JsonNode berdasarkan jenis bidang yang ditentukan oleh `DescribeEntity` API.
Konektor percikan menghasilkan skema sesuai dengan pemetaan tipe data yang sama seperti di API. `DescribeEntity` Konektor percikan mengonversi data ke tipe data yang sesuai yang cocok dengan skema saat mengembalikan baris.
**Permintaan**
+ `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 yang berisi kredenal jenis koneksi.
+ `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 katalog yang berisi koneksi. Ini bisa null, Secara default, ID AWS Akun adalah ID katalog.
+ `EntityName` – *Wajib:* String UTF-8.
Nama entitas yang ingin kita kueri data pratinjau dari jenis koneksi yang diberikan.
+ `NextToken` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 2048 byte, yang cocok dengan [Custom string pattern #11](aws-glue-api-common.md#regex_11).
Sebuah token kelanjutan, disertakan jika ini adalah sebuah panggilan kelanjutan.
+ `DataStoreApiVersion` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 256 byte, yang cocok dengan [Custom string pattern #23](aws-glue-api-common.md#regex_23).
Versi API dari konektor SaaS.
+ `ConnectionOptions` — Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 100 pasang.
Setiap kunci adalah string UTF-8, tidak kurang dari 1 atau lebih dari 256 byte panjang, cocok dengan. [Custom string pattern #18](aws-glue-api-common.md#regex_18)
Setiap nilai adalah string UTF-8, tidak kurang dari 1 atau lebih dari 256 byte panjang, cocok dengan. [Custom string pattern #17](aws-glue-api-common.md#regex_17)
Opsi konektor yang diperlukan untuk menanyakan data.
+ `FilterPredicate`- String UTF-8, panjangnya tidak kurang dari 1 atau lebih dari 100000 byte.
Predikat filter yang dapat Anda terapkan dalam permintaan kueri.
+ `Limit`— *Wajib:* Jumlah (panjang), tidak kurang dari 1 atau lebih dari 1000.
Membatasi jumlah catatan yang diambil dengan permintaan.
+ `SelectedFields`— Array string UTF-8, tidak kurang dari 1 atau lebih dari 1000 string.
Daftar bidang yang ingin kita ambil sebagai bagian dari data pratinjau.
**Respons**
+ `Records`— Sebuah array dari struktur.
Daftar objek yang diminta.
+ `NextToken` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 2048 byte, yang cocok dengan [Custom string pattern #11](aws-glue-api-common.md#regex_11).
Token kelanjutan, hadir jika segmen saat ini bukan yang terakhir.
**Kesalahan**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`
# API Fungsi yang ditentukan pengguna
User-defined Function API menjelaskan tipe AWS Glue data dan operasi yang digunakan dalam bekerja dengan fungsi.
## Jenis Data
+ [UserDefinedFunction struktur](#aws-glue-api-catalog-functions-UserDefinedFunction)
+ [UserDefinedFunctionInput struktur](#aws-glue-api-catalog-functions-UserDefinedFunctionInput)
## UserDefinedFunction struktur
Merepresentasikan definisi fungsi yang ditetapkan pengguna Hive (`UDF`) yang setara.
**Bidang**
+ `FunctionName` — 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 fungsi.
+ `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 fungsi.
+ `ClassName` — 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).
Kelas Java yang berisi kode fungsi.
+ `OwnerName` — 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 fungsi.
+ `OwnerType` – String UTF-8 (nilai yang valid: `USER` \$1 `ROLE` \$1 `GROUP`).
Jenis pemilik.
+ `CreateTime` — Stempel waktu.
Waktu saat fungsi dibuat.
+ `ResourceUris` — Susunan objek [ResourceUri](aws-glue-api-common.md#aws-glue-api-common-ResourceUri), tidak lebih dari 1000 struktur.
Sumber daya URIs untuk fungsi tersebut.
+ `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 fungsi berada.
## UserDefinedFunctionInput struktur
Struktur yang digunakan untuk membuat atau memperbarui sebuah fungsi yang ditetapkan pengguna.
**Bidang**
+ `FunctionName` — 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 fungsi.
+ `ClassName` — 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).
Kelas Java yang berisi kode fungsi.
+ `OwnerName` — 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 fungsi.
+ `OwnerType` – String UTF-8 (nilai yang valid: `USER` \$1 `ROLE` \$1 `GROUP`).
Jenis pemilik.
+ `ResourceUris` — Susunan objek [ResourceUri](aws-glue-api-common.md#aws-glue-api-common-ResourceUri), tidak lebih dari 1000 struktur.
Sumber daya URIs untuk fungsi tersebut.
## Operasi
+ [CreateUserDefinedFunction tindakan (Python: create\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-CreateUserDefinedFunction)
+ [UpdateUserDefinedFunction tindakan (Python: update\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-UpdateUserDefinedFunction)
+ [DeleteUserDefinedFunction tindakan (Python: delete\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-DeleteUserDefinedFunction)
+ [GetUserDefinedFunction tindakan (Python: get\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-GetUserDefinedFunction)
+ [GetUserDefinedFunctions tindakan (Python: get\$1user\$1defined\$1functions)](#aws-glue-api-catalog-functions-GetUserDefinedFunctions)
## CreateUserDefinedFunction tindakan (Python: create\$1user\$1defined\$1function)
Menciptakan sebuah definisi fungsi 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 fungsi 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).
Nama basis data katalog tempat fungsi dibuat.
+ `FunctionInput` — *Wajib:* Sebuah objek [UserDefinedFunctionInput](#aws-glue-api-catalog-functions-UserDefinedFunctionInput).
Sebuah objek `FunctionInput` yang mendefinisikan fungsi yang akan dibuat dalam Katalog Data.
**Respons**
+ *Tidak ada parameter Respons.*
**Kesalahan**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`
## UpdateUserDefinedFunction tindakan (Python: update\$1user\$1defined\$1function)
Memperbarui definisi fungsi yang ada 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 di mana fungsi 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 fungsi yang akan diperbarui berada.
+ `FunctionName` — *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 fungsi.
+ `FunctionInput` — *Wajib:* Sebuah objek [UserDefinedFunctionInput](#aws-glue-api-catalog-functions-UserDefinedFunctionInput).
Sebuah objek `FunctionInput` yang mendefinisikan kembali fungsi yang ada dalam Katalog Data.
**Respons**
+ *Tidak ada parameter Respons.*
**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
## DeleteUserDefinedFunction tindakan (Python: delete\$1user\$1defined\$1function)
Menghapus sebuah definisi fungsi yang ada dari 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 di mana fungsi 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 tempat fungsi berada.
+ `FunctionName` — *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 definisi fungsi yang akan dihapus.
**Respons**
+ *Tidak ada parameter Respons.*
**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
## GetUserDefinedFunction tindakan (Python: get\$1user\$1defined\$1function)
Mengambil definisi fungsi yang ditentukan dari 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 di mana fungsi yang akan diambil 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 fungsi berada.
+ `FunctionName` — *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 fungsi.
**Respons**
+ `UserDefinedFunction` — Sebuah objek [UserDefinedFunction](#aws-glue-api-catalog-functions-UserDefinedFunction).
Definisi fungsi yang diminta.
**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
## GetUserDefinedFunctions tindakan (Python: get\$1user\$1defined\$1functions)
Mengambil beberapa definisi fungsi dari 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 di mana fungsi yang akan diambil berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `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 di mana fungsi berada. Jika tidak ada yang disediakan, maka fungsi dari semua basis data di katalog akan dikembalikan.
+ `Pattern` — *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).
String pola fungsi-nama opsional yang menyaring definisi fungsi yang dikembalikan.
+ `NextToken` – String UTF-8.
Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan.
+ `MaxResults` — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100.
Jumlah maksimum fungsi yang akan dikembalikan dalam satu respons.
**Respons**
+ `UserDefinedFunctions` – Susunan objek [UserDefinedFunction](#aws-glue-api-catalog-functions-UserDefinedFunction).
Daftar definisi fungsi yang diminta.
+ `NextToken` – String UTF-8.
Sebuah token kelanjutan, jika daftar fungsi yang dikembalikan tidak termasuk fungsi yang diminta terakhir.
**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`
# Mengimpor Athena katalog ke AWS Glue
Migration API menjelaskan tipe AWS Glue data dan operasi yang berkaitan dengan migrasi katalog Athena Data ke AWS Glue.
## Jenis Data
+ [CatalogImportStatus struktur](#aws-glue-api-catalog-migration-CatalogImportStatus)
## CatalogImportStatus struktur
Struktur yang berisi informasi status migrasi.
**Bidang**
+ `ImportCompleted` – Boolean.
`True` jika migrasi telah selesai, atau `False` jika sebaliknya.
+ `ImportTime` — Stempel waktu.
Waktu ketika migrasi dimulai.
+ `ImportedBy` — 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 orang yang memulai migrasi.
## Operasi
+ [ImportCatalogToGlue tindakan (Python: import\$1catalog\$1to\$1glue)](#aws-glue-api-catalog-migration-ImportCatalogToGlue)
+ [GetCatalogImportStatus tindakan (Python: get\$1catalog\$1import\$1status)](#aws-glue-api-catalog-migration-GetCatalogImportStatus)
## ImportCatalogToGlue tindakan (Python: import\$1catalog\$1to\$1glue)
Mengimpor Katalog Data Amazon Athena yang ada ke. AWS Glue
**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 yang akan diimpor. Saat ini, ini harus menjadi ID AWS akun.
**Respons**
+ *Tidak ada parameter Respons.*
**Kesalahan**
+ `InternalServiceException`
+ `OperationTimeoutException`
## GetCatalogImportStatus tindakan (Python: get\$1catalog\$1import\$1status)
Mengambil status dari sebuah operasi migrasi.
**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 yang akan dimigrasi. Saat ini, ini harus menjadi ID AWS akun.
**Respons**
+ `ImportStatus` — Sebuah objek [CatalogImportStatus](#aws-glue-api-catalog-migration-CatalogImportStatus).
Status dari migrasi katalog yang ditentukan.
**Kesalahan**
+ `InternalServiceException`
+ `OperationTimeoutException`