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

# AWS Glue REST APIs untuk spesifikasi Apache Iceberg
<a name="iceberg-rest-apis"></a>

Bagian ini berisi spesifikasi tentang katalog dan AWS Glue ekstensi AWS Glue Iceberg REST APIs, dan pertimbangan saat menggunakannya. APIs 

Permintaan API ke AWS Glue Data Catalog titik akhir diautentikasi menggunakan AWS Signature Version 4 (SigV4). Lihat bagian [Sigv4 Versi AWS Tanda Tangan untuk permintaan API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) untuk mempelajari lebih lanjut tentang AWS SigV4.

Saat mengakses titik akhir AWS Glue layanan, dan AWS Glue metadata, aplikasi mengasumsikan peran IAM yang memerlukan tindakan IAM. `glue:getCatalog` 

Akses ke Katalog Data, dan objeknya dapat dikelola menggunakan izin mode hibrida IAM, Lake Formation, atau Lake Formation.

Katalog federasi dalam Katalog Data memiliki lokasi data terdaftar Lake Formation. Lake Formation bekerja dengan Katalog Data untuk memberikan izin gaya database untuk mengelola akses pengguna ke objek Katalog Data. 

Anda dapat menggunakan izin mode hibrida IAM AWS Lake Formation,, atau Lake Formation untuk mengelola akses ke Katalog Data default dan objeknya. 

Untuk membuat, menyisipkan, atau menghapus data dalam objek terkelola Lake Formation, Anda harus menyiapkan izin khusus untuk pengguna atau peran IAM. 
+ CREATE\$1CATALOG - Diperlukan untuk membuat katalog 
+ CREATE\$1DATABASE - Diperlukan untuk membuat database
+ CREATE\$1TABLE - Diperlukan untuk membuat tabel
+ DELETE - Diperlukan untuk menghapus data dari tabel
+ DESCRIPTION — Diperlukan untuk membaca metadata 
+ DROP - Diperlukan drop/delete untuk tabel atau database
+ INSERT - Diperlukan saat prinsipal perlu memasukkan data ke dalam tabel
+ SELECT — Diperlukan saat prinsipal perlu memilih data dari tabel

Untuk informasi selengkapnya, lihat [referensi izin Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/lf-permissions-reference.html) di Panduan AWS Lake Formation Pengembang.

# GetConfig
<a name="get-config"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | GetConfig | 
| Jenis |  Iceberg REST Katalog API  | 
| Jalur REST |  DAPATKAN/iceberg/v1/config  | 
| Tindakan IAM |  lem: GetCatalog  | 
| Izin Lake Formation | Tidak berlaku | 
| CloudTrail acara |  lem: GetCatalog  | 
| Definisi API terbuka | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L67 | 

****Pertimbangan dan keterbatasan****
+ Parameter `warehouse` kueri harus diatur ke ID AWS Glue katalog. Jika tidak diatur, katalog root di akun saat ini digunakan untuk mengembalikan respons. Lihat informasi yang lebih lengkap di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters).

# GetCatalog
<a name="get-catalog"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | GetCatalog | 
| Jenis |  AWS Glue API ekstensi  | 
| Jalur REST |  GET/extensions/v1/catalogs/\$1katalog\$1  | 
| Tindakan IAM |  lem: GetCatalog  | 
| Izin Lake Formation | MENJELASKAN | 
| CloudTrail acara |  lem: GetCatalog  | 
| Definisi API terbuka | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-ekstensi-api.yaml \$1L40 | 

****Pertimbangan dan keterbatasan****
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.

# ListNamespaces
<a name="list-ns"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | ListNamespaces | 
| Jenis |  Iceberg REST Katalog API  | 
| Jalur REST |  GET/iceberg/v1/catalogs/\$1catalog\$1/namespaces  | 
| Tindakan IAM |  lem: GetDatabase  | 
| Izin Lake Formation | SEMUA, JELASKAN, PILIH | 
| CloudTrail acara |  lem: GetDatabase  | 
| Definisi API terbuka | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L205 | 

****Pertimbangan dan keterbatasan****
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Hanya ruang nama tingkat berikutnya yang ditampilkan. Untuk membuat daftar ruang nama di level yang lebih dalam, tentukan ID katalog bersarang di parameter jalur katalog.

# CreateNamespace
<a name="create-ns"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | CreateNamespace | 
| Jenis |  Iceberg REST Katalog API  | 
| Jalur REST |  POST/iceberg/v1/catalogs/\$1catalog\$1/namespaces  | 
| Tindakan IAM |  lem: CreateDatabase  | 
| Izin Lake Formation | SEMUA, JELASKAN, PILIH | 
| CloudTrail acara |  lem: CreateDatabase  | 
| Definisi API terbuka | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L256 | 

****Pertimbangan dan keterbatasan****
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Hanya namespace tingkat tunggal yang dapat dibuat. Untuk membuat namespace multi-level, Anda harus membuat setiap level secara iteratif, dan terhubung ke level menggunakan parameter path katalog.

# StartCreateNamespaceTransaction
<a name="start-create-ns-transaction"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | StartCreateNamespaceTransaction | 
| Jenis |  AWS Glue ekstensi API  | 
| Jalur REST |  POST/extensions/v1/catalogs/\$1catalog\$1/namespaces  | 
| Tindakan IAM |  lem: CreateDatabase  | 
| Izin Lake Formation | SEMUA, JELASKAN, PILIH | 
| CloudTrail acara |  lem: CreateDatabase  | 
| Definisi API terbuka | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L256 | 

****Pertimbangan dan keterbatasan****
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Anda hanya dapat membuat namespace satu tingkat. Untuk membuat ruang nama multi-level, Anda harus membuat setiap level secara iteratif, dan terhubung ke level menggunakan parameter path katalog.
+ API bersifat asinkron, dan menampilkan ID transaksi yang dapat Anda gunakan untuk melacak menggunakan panggilan API. `CheckTransactionStatus`
+  Anda dapat memanggil API ini, hanya jika panggilan `GetCatalog` API berisi parameter `use-extensions=true` dalam respons. 

## LoadNamespaceMetadata
<a name="load-ns-metadata"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | LoadNamespaceMetadata | 
| Jenis |  Iceberg REST Katalog API  | 
| Jalur REST |  GET/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1  | 
| Tindakan IAM |  lem: GetDatabase  | 
| Izin Lake Formation | SEMUA, JELASKAN, PILIH | 
| CloudTrail acara |  lem: GetDatabase  | 
| Definisi API terbuka | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L302 | 

****Pertimbangan dan keterbatasan****
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Anda hanya dapat menentukan namespace satu tingkat di parameter jalur REST. Untuk lebih lanjut dalam formasi, lihat [Parameter jalur namespace](connect-glu-iceberg-rest.md#ns-path-param) bagian.

## UpdateNamespaceProperties
<a name="w2aac20c29c16c21c13"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | UpdateNamespaceProperties | 
| Jenis |  Iceberg REST Katalog API  | 
| Jalur REST |  POSTING/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/properties  | 
| Tindakan IAM |  lem: UpdateDatabase  | 
| Izin Lake Formation | SEMUA, UBAH | 
| CloudTrail acara |  lem: UpdateDatabase  | 
| Definisi API terbuka | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L400 | 

****Pertimbangan dan keterbatasan****
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Anda hanya dapat menentukan namespace satu tingkat di parameter jalur REST. Untuk lebih lanjut dalam formasi, lihat [Parameter jalur namespace](connect-glu-iceberg-rest.md#ns-path-param) bagian.

# DeleteNamespace
<a name="delete-ns"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | DeleteNamespace | 
| Jenis |  Iceberg REST Katalog API  | 
| Jalur REST |  DELETE/iceberg/v1/catalogs/\$1catalog\$1/namespces/\$1ns\$1  | 
| Tindakan IAM |  lem: DeleteDatabase  | 
| Izin Lake Formation | SEMUA, JATUHKAN | 
| CloudTrail acara |  lem: DeleteDatabase  | 
| Definisi API terbuka | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L365 | 

****Pertimbangan dan keterbatasan****
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat [Parameter jalur namespace](connect-glu-iceberg-rest.md#ns-path-param) bagian.
+ Jika ada objek dalam database, operasi akan gagal.
+ API bersifat asinkron, dan menampilkan ID transaksi yang dapat Anda gunakan untuk melacak menggunakan panggilan API. `CheckTransactionStatus`
+  API hanya dapat digunakan jika panggilan `GetCatalog` API menunjukkan `use-extensions=true` respons. 

# StartDeleteNamespaceTransaction
<a name="start-delete-ns-transaction"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | StartDeleteNamespaceTransaction | 
| Jenis |  AWS Glue ekstensi API  | 
| Jalur REST |  HAPUS/extensions/v1/catalogs/\$1catalog\$1/namespces/\$1ns\$1  | 
| Tindakan IAM |  lem: DeleteDatabase  | 
| Izin Lake Formation | SEMUA, JATUHKAN | 
| CloudTrail acara |  lem: DeleteDatabase  | 
| Definisi API terbuka | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-ekstensi-api.yaml \$1L85 | 

****Pertimbangan dan keterbatasan****
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Anda dapat menentukan hanya satu tingkat namespace dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat [Parameter jalur namespace](connect-glu-iceberg-rest.md#ns-path-param) bagian.
+ Jika ada objek dalam database, operasi akan gagal.
+ API bersifat asinkron, dan menampilkan ID transaksi yang dapat Anda gunakan untuk melacak menggunakan panggilan API. `CheckTransactionStatus`
+  API hanya dapat digunakan jika panggilan `GetCatalog` API menunjukkan `use-extensions=true` respons. 

# ListTables
<a name="list-tables"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | ListTables | 
| Jenis |  Iceberg REST Katalog API  | 
| Jalur REST |  DAPATKAN/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables  | 
| Tindakan IAM |  lem: GetTables  | 
| Izin Lake Formation | SEMUA, PILIH, JELASKAN | 
| CloudTrail acara |  lem: GetTables  | 
| Definisi API terbuka | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L463 | 

****Pertimbangan dan keterbatasan****
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat [Parameter jalur namespace](connect-glu-iceberg-rest.md#ns-path-param) bagian.
+ Semua tabel termasuk tabel non-Iceberg akan terdaftar. Untuk menentukan apakah tabel dapat dimuat sebagai tabel Iceberg atau tidak, panggil `LoadTable` operasi.

# CreateTable
<a name="create-table"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | CreateTable | 
| Jenis |  Iceberg REST Katalog API  | 
| Jalur REST |  DAPATKAN/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables  | 
| Tindakan IAM |  lem: CreateTable  | 
| Izin Lake Formation | SEMUA, CREATE\$1TABLE | 
| CloudTrail acara |  lem: CreateTable  | 
| Definisi API terbuka | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L497 | 

****Pertimbangan dan keterbatasan****
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat [Parameter jalur namespace](connect-glu-iceberg-rest.md#ns-path-param) bagian.
+ `CreateTable`dengan pementasan tidak didukung. Jika parameter `stageCreate` kueri ditentukan, operasi akan gagal.Ini berarti operasi seperti `CREATE TABLE AS SELECT` tidak didukung, dan Anda dapat menggunakan kombinasi `CREATE TABLE` dan `INSERT INTO` sebagai solusi.
+ Operasi `CreateTable` API tidak mendukung opsi`state-create = TRUE`.

# StartCreateTableTransaction
<a name="start-create-table-transaction"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | CreateTable | 
| Jenis |  AWS Glue ekstensi API  | 
| Jalur REST |  POST/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables  | 
| Tindakan IAM |  lem: CreateTable  | 
| Izin Lake Formation | SEMUA, CREATE\$1TABLE | 
| CloudTrail acara |  lem: CreateTable  | 
| Definisi API terbuka | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-ekstensi-api.yaml \$1L107 | 

****Pertimbangan dan keterbatasan****
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Anda hanya dapat menentukan namespace satu tingkat di parameter jalur REST. Untuk lebih lanjut dalam formasi, lihat [Parameter jalur namespace](connect-glu-iceberg-rest.md#ns-path-param) bagian.
+ `CreateTable`dengan pementasan tidak didukung. Jika parameter `stageCreate` kueri ditentukan, operasi akan gagal.Ini berarti operasi seperti tidak `CREATE TABLE AS SELECT` didukung, dan pengguna harus menggunakan kombinasi `CREATE TABLE` dan `INSERT INTO` untuk menyelesaikannya.
+ API bersifat asinkron, dan menampilkan ID transaksi yang dapat Anda gunakan untuk melacak menggunakan panggilan API. `CheckTransactionStatus`
+  API hanya dapat digunakan jika panggilan `GetCatalog` API menunjukkan `use-extensions=true` respons. 

# LoadTable
<a name="load-table"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | LoadTable | 
| Tipe |  Iceberg REST Katalog API  | 
| Jalur REST |  DAPATKAN/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1tabel\$1  | 
| Tindakan IAM |  lem: GetTable  | 
| Izin Lake Formation | SEMUA, PILIH, JELASKAN | 
| CloudTrail acara |  lem: GetTable  | 
| Definisi API terbuka | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L616 | 

**Pertimbangan-pertimbangan**
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Anda dapat menentukan hanya satu tingkat namespace dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat [Parameter jalur namespace](connect-glu-iceberg-rest.md#ns-path-param) bagian.
+ `CreateTable`dengan pementasan tidak didukung. Jika parameter `stageCreate` kueri ditentukan, operasi akan gagal.Ini berarti operasi seperti tidak `CREATE TABLE AS SELECT` didukung, dan pengguna harus menggunakan kombinasi `CREATE TABLE` dan `INSERT INTO` untuk menyelesaikannya.
+ API bersifat asinkron, dan menampilkan ID transaksi yang dapat Anda gunakan untuk melacak menggunakan panggilan API. `CheckTransactionStatus`
+  API hanya dapat digunakan jika panggilan `GetCatalog` API menunjukkan `use-extensions=true` respons. 

# ExtendedLoadTable
<a name="extended-load-table"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | LoadTable | 
| Tipe |  AWS Glue ekstensi API  | 
| Jalur REST |  DAPATKAN/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1tabel\$1  | 
| Tindakan IAM |  lem: GetTable  | 
| Izin Lake Formation | SEMUA, PILIH, JELASKAN | 
| CloudTrail acara |  lem: GetTable  | 
| Definisi API terbuka | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-ekstensi-api.yaml \$1L134 | 

**Pertimbangan-pertimbangan**
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat [Parameter jalur namespace](connect-glu-iceberg-rest.md#ns-path-param) bagian.
+ Hanya `all` mode yang didukung untuk parameter kueri snapshot.
+ Dibandingkan dengan `LoadTable` API, `ExtendedLoadTable` API berbeda dalam cara berikut:
  +  Tidak secara ketat menegakkan bahwa semua bidang akan tersedia.
  + menyediakan parameter tambahan berikut di bidang konfigurasi respons:   
**Parameter tambahan**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/extended-load-table.html)

# PreplanTable
<a name="preplan-table"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | PreplanTable | 
| Tipe |  AWS Glue ekstensi API  | 
| Jalur REST |  POSTING/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1/preplan  | 
| Tindakan IAM |  lem: GetTable  | 
| Izin Lake Formation | SEMUA, PILIH, JELASKAN | 
| CloudTrail acara |  lem: GetTable  | 
| Definisi API terbuka | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-ekstensi-api.yaml \$1L211 | 

**Pertimbangan-pertimbangan**
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat [Parameter jalur namespace](connect-glu-iceberg-rest.md#ns-path-param) bagian.
+ Penelepon API ini harus selalu menentukan apakah ada hasil yang tersisa untuk diambil berdasarkan token halaman. Respons dengan item halaman kosong tetapi token pagination dimungkinkan jika sisi server masih memproses tetapi tidak dapat menghasilkan hasil apa pun dalam waktu respons yang diberikan.
+  Anda dapat menggunakan API ini hanya jika respons `ExtendedLoadTable` API berisi`aws.server-side-capabilities.scan-planning=true`. 

# PlanTable
<a name="plan-table"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | PlanTable | 
| Tipe |  AWS Glue ekstensi API  | 
| Jalur REST |  POSTING/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1table\$1/plan  | 
| Tindakan IAM |  lem: GetTable  | 
| Izin Lake Formation | SEMUA, PILIH, JELASKAN | 
| CloudTrail acara |  lem: GetTable  | 
| Definisi API terbuka | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-ekstensi-api.yaml \$1L243 | 

**Pertimbangan-pertimbangan**
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat [Parameter jalur namespace](connect-glu-iceberg-rest.md#ns-path-param) bagian.
+ Penelepon API ini harus selalu menentukan apakah ada hasil yang tersisa untuk diambil berdasarkan token halaman. Respons dengan item halaman kosong tetapi token pagination dimungkinkan jika sisi server masih memproses tetapi tidak dapat menghasilkan hasil apa pun dalam waktu respons yang diberikan.
+  Anda dapat menggunakan API ini hanya jika respons `ExtendedLoadTable` API berisi`aws.server-side-capabilities.scan-planning=true`. 

# TableExists
<a name="table-exists"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | TableExists | 
| Tipe |  Iceberg REST Katalog API  | 
| Jalur REST |  HEAD/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1tabel\$1  | 
| Tindakan IAM |  lem: GetTable  | 
| Izin Lake Formation | SEMUA, PILIH, JELASKAN | 
| CloudTrail acara |  lem: GetTable  | 
| Definisi API terbuka | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L833 | 

**Pertimbangan-pertimbangan**
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat [Parameter jalur namespace](connect-glu-iceberg-rest.md#ns-path-param) bagian.

# UpdateTable
<a name="update-table"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | UpdateTable | 
| Tipe |  Iceberg REST Katalog API  | 
| Jalur REST |  POST/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1tabel\$1  | 
| Tindakan IAM |  lem: UpdateTable  | 
| Izin Lake Formation | SEMUA, UBAH | 
| CloudTrail acara |  lem: UpdateTable  | 
| Definisi API terbuka | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L677 | 

**Pertimbangan-pertimbangan**
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat [Parameter jalur namespace](connect-glu-iceberg-rest.md#ns-path-param) bagian.

# StartUpdateTableTransaction
<a name="start-update-table-transaction"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | StartUpdateTableTransaction | 
| Tipe | AWS Glue API ekstensi | 
| Jalur REST |  POST/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1tabel\$1  | 
| Tindakan IAM |  lem: UpdateTable  | 
| Izin Lake Formation |  SEMUA, UBAH  | 
| CloudTrail acara |  lem: UpdateTable  | 
| Definisi API terbuka | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-ekstensi-api.yaml \$1L154 | 

**Pertimbangan-pertimbangan**
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat [Parameter jalur namespace](connect-glu-iceberg-rest.md#ns-path-param) bagian.
+ API bersifat asinkron, dan menampilkan ID transaksi yang dapat Anda gunakan untuk melacak menggunakan panggilan API. `CheckTransactionStatus`
+  `RenamTable`Operasi juga dapat dilakukan melalui API ini. Ketika itu terjadi, pemanggil juga harus memiliki izin lem: CreateTable atau LakeFormation CREATE\$1TABLE untuk tabel yang akan diganti namanya menjadi. 
+  Anda dapat menggunakan API ini hanya jika respons `ExtendedLoadTable` API berisi`aws.server-side-capabilities.scan-planning=true`. 

# DeleteTable
<a name="delete-table"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | DeleteTable | 
| Tipe |  Iceberg REST Katalog API  | 
| Jalur REST |  DELETE/iceberg/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1tabel\$1  | 
| Tindakan IAM |  lem: DeleteTable  | 
| Izin Lake Formation | SEMUA, JATUHKAN | 
| CloudTrail acara |  lem: DeleteTable  | 
| Definisi API terbuka | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L793 | 

**Pertimbangan-pertimbangan**
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat [Parameter jalur namespace](connect-glu-iceberg-rest.md#ns-path-param) bagian.
+ `DeleteTable`Operasi API mendukung opsi pembersihan. Ketika pembersihan diatur ke`true`, data tabel dihapus, jika tidak data tidak dihapus. Untuk tabel di Amazon S3, operasi tidak menghapus data tabel. Operasi gagal saat tabel disimpan di Amazon S3, dan. `purge = TRUE,` 

  Untuk tabel yang disimpan di penyimpanan terkelola Amazon Redshift, operasi akan menghapus data tabel, mirip dengan `DROP TABLE` perilaku di Amazon Redshift. Operasi gagal saat tabel disimpan di Amazon Redshift dan. `purge = FALSE`
+ `purgeRequest=true` tidak didukung. 

# StartDeleteTableTransaction
<a name="start-delete-table-transaction"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | StartDeleteTableTransaction | 
| Tipe |  AWS Glue ekstensi API  | 
| Jalur REST |  HAPUS/extensions/v1/catalogs/\$1catalog\$1/namespaces/\$1ns\$1/tables/\$1tabel\$1  | 
| Tindakan IAM |  lem: DeleteTable  | 
| Izin Lake Formation | SEMUA, JATUHKAN | 
| CloudTrail acara |  lem: DeleteTable  | 
| Definisi API terbuka | https://github.com/apache/iceberg/blob/apache-iceberg-1.6.1/open-api/rest- catalog-open-api .yaml \$1L793 | 

**Pertimbangan-pertimbangan**
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.
+ Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat [Parameter jalur namespace](connect-glu-iceberg-rest.md#ns-path-param) bagian.
+ `purgeRequest=false` tidak didukung. 
+  API bersifat asinkron, dan mengembalikan ID transaksi yang dapat dilacak. `CheckTransactionStatus` 

# CheckTransactionStatus
<a name="check-transaction-status"></a>


**Informasi umum**  

|  |  | 
| --- |--- |
| Nama operasi | CheckTransactionStatus | 
| Tipe |  AWS Glue ekstensi API  | 
| Jalur REST |  POST/extensions/v1/transactions/status  | 
| Tindakan IAM |  Izin yang sama dengan tindakan yang memulai transaksi  | 
| Izin Lake Formation | Izin yang sama dengan tindakan yang memulai transaksi | 
| Definisi API terbuka | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-ekstensi-api.yaml \$1L273 | 

**Pertimbangan-pertimbangan**
+ Parameter jalur katalog harus mengikuti gaya yang dijelaskan di [Parameter jalur awalan dan katalog](connect-glu-iceberg-rest.md#prefix-catalog-path-parameters) bagian.