Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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 AWS Tanda Tangan Versi 4 untuk permintaan API 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_CATALOG - Diperlukan untuk membuat katalog
-
CREATE_DATABASE - Diperlukan untuk membuat database
-
CREATE_TABLE - Diperlukan untuk membuat tabel
-
DELETE - Diperlukan untuk menghapus data dari tabel
-
DESKRIPSIKAN — Diperlukan untuk membaca metadata
-
DROP - Diperlukan untuk menjatuhkan/menghapus 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 di Panduan AWS Lake Formation Pengembang.
Nama operasi | GetConfig |
Jenis |
Iceberg REST Katalog API |
Jalur REST |
GET /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 #L67 |
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. Untuk informasi selengkapnya, lihat Parameter jalur awalan dan katalog.
Nama operasi | GetCatalog |
Jenis |
AWS Glue API ekstensi |
Jalur REST |
GET/extensions/v1/catalogs/{katalog} |
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 #L40 |
Pertimbangan dan keterbatasan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.
Nama operasi | ListNamespaces |
Jenis |
Iceberg REST Katalog API |
Jalur REST |
GET/iceberg/v1/catalogs/{catalog}/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 #L205 |
Pertimbangan dan keterbatasan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog 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.
Nama operasi | CreateNamespace |
Jenis |
Iceberg REST Katalog API |
Jalur REST |
POST/iceberg/v1/catalogs/{catalog}/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 #L256 |
Pertimbangan dan keterbatasan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog 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.
Nama operasi | StartCreateNamespaceTransaction |
Jenis |
AWS Glue ekstensi API |
Jalur REST |
POST/extensions/v1/catalogs/{catalog}/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 #L256 |
Pertimbangan dan keterbatasan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog 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 parameteruse-extensions=true
dalam respons.
Nama operasi | LoadNamespaceMetadata |
Jenis |
Iceberg REST Katalog API |
Jalur REST |
GET/iceberg/v1/catalogs/{catalog}/namespaces/{ns} |
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 #L302 |
Pertimbangan dan keterbatasan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.
Anda hanya dapat menentukan namespace satu tingkat di parameter jalur REST. Untuk lebih lanjut dalam formasi, lihat Parameter jalur namespace bagian.
Nama operasi | UpdateNamespaceProperties |
Jenis |
Iceberg REST Katalog API |
Jalur REST |
POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/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 #L400 |
Pertimbangan dan keterbatasan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.
Anda hanya dapat menentukan namespace satu tingkat di parameter jalur REST. Untuk lebih lanjut dalam formasi, lihat Parameter jalur namespace bagian.
Nama operasi | DeleteNamespace |
Jenis |
Iceberg REST Katalog API |
Jalur REST |
DELETE/iceberg/v1/catalogs/{catalog}/namespces/{ns} |
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 #L365 |
Pertimbangan dan keterbatasan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.
Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat Parameter jalur namespace 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 menunjukkanuse-extensions=true
respons.
Nama operasi | StartDeleteNamespaceTransaction |
Jenis |
AWS Glue ekstensi API |
Jalur REST |
DELETE /extensions/v1/catalogs/{catalog}/namespces/{ns} |
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 #L85 |
Pertimbangan dan keterbatasan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.
Anda dapat menentukan hanya satu tingkat namespace dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat Parameter jalur namespace 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 menunjukkanuse-extensions=true
respons.
Nama operasi | ListTables |
Jenis |
Iceberg REST Katalog API |
Jalur REST |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/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 #L463 |
Pertimbangan dan keterbatasan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.
Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat Parameter jalur namespace bagian.
-
Semua tabel termasuk tabel non-Iceberg akan terdaftar. Untuk menentukan apakah tabel dapat dimuat sebagai tabel Iceberg atau tidak, panggil
LoadTable
operasi.
Nama operasi | CreateTable |
Jenis |
Iceberg REST Katalog API |
Jalur REST |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables |
Tindakan IAM |
lem: CreateTable |
Izin Lake Formation | SEMUA, CREATE_TABLE |
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 #L497 |
Pertimbangan dan keterbatasan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.
Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat Parameter jalur namespace bagian.
-
CreateTable
dengan pementasan tidak didukung. Jika parameterstageCreate
kueri ditentukan, operasi akan gagal.Ini berarti operasi sepertiCREATE TABLE AS SELECT
tidak didukung, dan Anda dapat menggunakan kombinasiCREATE TABLE
danINSERT INTO
sebagai solusi. -
Operasi
CreateTable
API tidak mendukung opsistate-create = TRUE
.
Nama operasi | CreateTable |
Jenis |
AWS Glue ekstensi API |
Jalur REST |
POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables |
Tindakan IAM |
lem: CreateTable |
Izin Lake Formation | SEMUA, CREATE_TABLE |
CloudTrail acara |
lem: CreateTable |
Definisi API terbuka | https://github.com/awslabs/glue-extensions-for-iceberg/blob/main/glue-ekstensi-api.yaml #L107 |
Pertimbangan dan keterbatasan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.
Anda hanya dapat menentukan namespace satu tingkat di parameter jalur REST. Untuk lebih lanjut dalam formasi, lihat Parameter jalur namespace bagian.
-
CreateTable
dengan pementasan tidak didukung. Jika parameterstageCreate
kueri ditentukan, operasi akan gagal.Ini berarti operasi seperti tidakCREATE TABLE AS SELECT
didukung, dan pengguna harus menggunakan kombinasiCREATE TABLE
danINSERT 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 menunjukkanuse-extensions=true
respons.
Nama operasi | LoadTable |
Tipe |
AWS Glue ekstensi API |
Jalur REST |
GET /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tabel} |
Tindakan IAM |
Lem: GE TTable |
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 #L616 |
Pertimbangan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.
Anda dapat menentukan hanya satu tingkat namespace dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat Parameter jalur namespace bagian.
-
CreateTable
dengan pementasan tidak didukung. Jika parameterstageCreate
kueri ditentukan, operasi akan gagal.Ini berarti operasi seperti tidakCREATE TABLE AS SELECT
didukung, dan pengguna harus menggunakan kombinasiCREATE TABLE
danINSERT 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 menunjukkanuse-extensions=true
respons.
Nama operasi | LoadTable |
Tipe |
AWS Glue ekstensi API |
Jalur REST |
GET /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tabel} |
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 #L134 |
Pertimbangan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.
Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat Parameter jalur namespace 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 Kunci Config Deskripsi aws. server-side-capabilities.perencanaan pemindaian
Indiactes jika tabel dapat dipindai menggunakan tabel dan PreparePlan . PlanTable APIs aws. server-side-capabilities.data-komit
Menunjukkan apakah tabel dapat dilakukan menggunakan StartUpdateTable transaksi. aws.glue.staging.location
Digunakan untuk perencanaan pemindaian sisi server atau komit data, lokasi pementasan yang dikelola layanan yang dapat digunakan untuk mesin untuk menulis file data sementara
aws.glue.staging. access-key-id
Digunakan untuk perencanaan pemindaian sisi server atau komit data, bagian dari AWS kredensyal sementara untuk mengakses lokasi pementasan yang dikelola layanan
aws.glue.staging. secret-access-key
Digunakan untuk perencanaan pemindaian sisi server atau komit data, bagian dari AWS kredensyal sementara untuk mengakses lokasi pementasan yang dikelola layanan.
aws.glue.staging.session-token
Digunakan untuk perencanaan pemindaian sisi server atau komit data, bagian dari AWS kredensyal sementara untuk mengakses lokasi pementasan yang dikelola layanan.
aws.glue.staging.expiration-ms
Digunakan untuk perencanaan pemindaian sisi server atau komit data, waktu kedaluwarsa kredensyal untuk mengakses pementasan yang dikelola layanan. lokasi.
aws.glue.staging. data-transfer-role-arn
Digunakan untuk perencanaan pemindaian sisi server atau komit data, peran IAM yang dapat diasumsikan untuk mengakses lokasi pementasan yang dikelola layanan.
Nama operasi | PreplanTable |
Tipe |
AWS Glue ekstensi API |
Jalur REST |
POST /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/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 #L211 |
Pertimbangan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.
Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat Parameter jalur namespace 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 berisiaws.server-side-capabilities.scan-planning=true
.
Nama operasi | PlanTable |
Tipe |
AWS Glue ekstensi API |
Jalur REST |
POST /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{table}/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 #L243 |
Pertimbangan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.
Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat Parameter jalur namespace 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 berisiaws.server-side-capabilities.scan-planning=true
.
Nama operasi | TableExists |
Tipe |
Iceberg REST Katalog API |
Jalur REST |
HEAD/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tabel} |
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 #L833 |
Pertimbangan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.
Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat Parameter jalur namespace bagian.
Nama operasi | UpdateTable |
Tipe |
Iceberg REST Katalog API |
Jalur REST |
POST /iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tabel} |
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 #L677 |
Pertimbangan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.
Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat Parameter jalur namespace bagian.
Nama operasi | StartUpdateTableTransaction |
Tipe | AWS Glue API ekstensi |
Jalur REST |
POST/extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tabel} |
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 #L154 |
Pertimbangan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.
Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat Parameter jalur namespace 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_TABLE untuk tabel yang akan diganti namanya. -
Anda dapat menggunakan API ini hanya jika respons
ExtendedLoadTable
API berisiaws.server-side-capabilities.scan-planning=true
.
Nama operasi | DeleteTable |
Tipe |
Iceberg REST Katalog API |
Jalur REST |
DELETE/iceberg/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tabel} |
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 #L793 |
Pertimbangan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.
Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat Parameter jalur namespace bagian.
-
DeleteTable
Operasi API mendukung opsi pembersihan. Ketika pembersihan diatur ketrue
, 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.
Nama operasi | StartDeleteTableTransaction |
Tipe |
AWS Glue ekstensi API |
Jalur REST |
DELETE /extensions/v1/catalogs/{catalog}/namespaces/{ns}/tables/{tabel} |
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 #L793 |
Pertimbangan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.
Anda hanya dapat menentukan namespace satu tingkat dalam parameter REST Path. Untuk lebih lanjut dalam formasi, lihat Parameter jalur namespace bagian.
-
purgeRequest=false
tidak didukung. -
API bersifat asinkron, dan mengembalikan ID transaksi yang dapat dilacak.
CheckTransactionStatus
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 #L273 |
Pertimbangan
-
Parameter jalur katalog harus mengikuti gaya yang dijelaskan di Parameter jalur awalan dan katalog bagian.