Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Tabel API
API Tabel menjelaskan jenis data dan operasi yang dikaitkan dengan tabel.
Jenis Data
Struktur tabel
Mewakili kumpulan data terkait yang diatur dalam kolom dan baris.
Bidang
-
Name- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
DatabaseName— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.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.Deskripsi tabel.
-
Owner— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.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).Waktu retensi untuk tabel ini.
-
StorageDescriptor— Sebuah objek StorageDescriptor.Sebuah deskriptor penyimpanan yang berisi informasi tentang penyimpanan fisik tabel ini.
-
PartitionKeys– Susunan objek Kolom.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 nilaipartitionKeyske daftar kosong. Contoh:"PartitionKeys": [] -
ViewOriginalText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.Termasuk untuk kompatibilitas Apache Hive. Tidak digunakan dalam AWS Glue operasi normal. Jika tabel adalah Athena konfigurasi tertentu yang
VIRTUAL_VIEWdikodekan dalam base64. -
ViewExpandedText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.Termasuk untuk kompatibilitas Apache Hive. Tidak digunakan dalam AWS Glue operasi normal.
-
TableType— UTF-8 string, panjangnya tidak lebih dari 255 byte.Jenis tabel ini. AWS Glue akan membuat tabel dengan
EXTERNAL_TABLEtipe. Layanan lain, seperti Athena, dapat membuat tabel dengan jenis tabel tambahan.AWS Glue jenis tabel terkait:
- TABEL EKSTERNAL
-
Atribut yang kompatibel dengan hive - menunjukkan tabel yang dikelola non-Hive.
- DIPERINTAH
-
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.
Setiap nilai adalah UTF-8 string, panjangnya tidak lebih dari 512000 byte.
Pasangan nilai kunci ini menentukan sifat yang dikaitkan dengan tabel.
-
CreatedBy— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Orang atau entitas yang telah membuat tabel.
-
IsRegisteredWithLakeFormation– Boolean.Menunjukkan apakah tabel telah didaftarkan dengan AWS Lake Formation.
-
TargetTable— Sebuah objek TableIdentifier.Sebuah struktur
TableIdentifieryang 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.ID dari Katalog Data tempat tabel berada.
-
VersionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.ID versi tabel.
-
FederatedTable— Sebuah objek FederatedTable.FederatedTableStruktur yang mereferensikan entitas di luar AWS Glue Data Catalog. -
ViewDefinition— Sebuah objek 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 oleh karena itu dapat dibaca oleh mesin tersebut.
-
IsMaterializedView– Boolean.Menunjukkan tabel adalah a
MaterializedView. -
IcebergTableMetadata— Sebuah objek IcebergTableMetadata.Metadata tabel Apache Iceberg terbaru untuk tabel, termasuk versi format, skema, spesifikasi partisi, dan urutan urutan. Bidang ini diisi untuk tabel Iceberg dan mencerminkan keadaan metadata gunung es tabel saat ini.
-
Status— Sebuah objek TableStatus.Menunjukkan keadaan perubahan asinkron ke tabel.
TableInput struktur
Struktur yang digunakan untuk mendefinisikan tabel.
Bidang
-
Name- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.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.Deskripsi tabel.
-
Owner— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.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).Waktu retensi untuk tabel ini.
-
StorageDescriptor— Sebuah objek StorageDescriptor.Sebuah deskriptor penyimpanan yang berisi informasi tentang penyimpanan fisik tabel ini.
-
PartitionKeys– Susunan objek Kolom.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 nilaipartitionKeyske daftar kosong. Contoh:"PartitionKeys": [] -
ViewOriginalText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.Termasuk untuk kompatibilitas Apache Hive. Tidak digunakan dalam AWS Glue operasi normal. Jika tabel adalah Athena konfigurasi tertentu yang
VIRTUAL_VIEWdikodekan dalam base64. -
ViewExpandedText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.Termasuk untuk kompatibilitas Apache Hive. Tidak digunakan dalam AWS Glue operasi normal.
-
TableType— UTF-8 string, panjangnya tidak lebih dari 255 byte.Jenis tabel ini. AWS Glue akan membuat tabel dengan
EXTERNAL_TABLEtipe. Layanan lain, seperti Athena, dapat membuat tabel dengan jenis tabel tambahan.AWS Glue jenis tabel terkait:
- TABEL EKSTERNAL
-
Atribut yang kompatibel dengan hive - menunjukkan tabel yang dikelola non-Hive.
- DIPERINTAH
-
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.
Setiap nilai adalah UTF-8 string, panjangnya tidak lebih dari 512000 byte.
Pasangan nilai kunci ini menentukan sifat yang dikaitkan dengan tabel.
-
TargetTable— Sebuah objek TableIdentifier.Sebuah struktur
TableIdentifieryang menggambarkan tabel target untuk menghubungkan sumber daya. -
ViewDefinition— Sebuah objek 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— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 512 byte, cocok denganSingle-line string pattern.Pengidentifikasi unik untuk tabel federasi.
-
DatabaseIdentifier— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 512 byte, cocok denganSingle-line string pattern.Pengidentifikasi unik untuk database federasi.
-
ConnectionName— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama koneksi ke metastor eksternal.
-
ConnectionType— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.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- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama
Column. -
Type— UTF-8 string, panjangnya tidak lebih dari 131072 byte, cocok dengan. Single-line string patternJenis data dari
Column. -
Comment— String komentar, sepanjang tidak lebih dari 255, yang cocok dengan Single-line string pattern.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.
Setiap nilai adalah UTF-8 string, panjangnya 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.Daftar
Columnsdalam tabel. -
Location— String lokasi, sepanjang tidak lebih dari 2056, yang cocok dengan URI address multi-line string pattern.Lokasi fisik tabel. Secara default, ini mengambil bentuk lokasi gudang, yang diikuti oleh lokasi basis data di gudang, yang diikuti dengan nama tabel.
-
AdditionalLocations— Sebuah array UTF-8 string.Daftar lokasi yang menunjuk ke jalur tempat tabel Delta berada.
-
InputFormat— String format, sepanjang tidak lebih dari 128, yang cocok dengan Single-line string pattern.Format input:
SequenceFileInputFormat(biner), atauTextInputFormat, atau format kustom. -
OutputFormat— String format, sepanjang tidak lebih dari 128, yang cocok dengan Single-line string pattern.Format output:
SequenceFileOutputFormat(biner), atauIgnoreKeyTextOutputFormat, atau format kustom. -
Compressed– Boolean.Truejika data dalam tabel dikompresi, atauFalsejika tidak. -
NumberOfBuckets— Nomor (bilangan bulat).Harus ditentukan jika tabel berisi kolom dimensi.
-
SerdeInfo— Sebuah objek SerDeInfo.Informasi serialization/deserialization (SerDe).
-
BucketColumns— Sebuah array UTF-8 string.Daftar kolom pengelompokan peredam, kolom pengklasteran, dan kolom pem-bucket-an dalam tabel.
-
SortColumns– Susunan objek 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.
Setiap nilai adalah UTF-8 string, panjangnya tidak lebih dari 512000 byte.
Properti yang disediakan pengguna dalam bentuk nilai kunci.
-
SkewedInfo— Sebuah objek SkewedInfo.Informasi tentang nilai yang sering muncul di kolom (nilai kecenderungan).
-
StoredAsSubDirectories– Boolean.Truejika data tabel disimpan di subdirektori, atauFalsejika tidak. -
SchemaReference— Sebuah objek SchemaReference.Sebuah objek yang mereferensikan skema yang disimpan dalam S AWS Glue chema Registry.
Saat membuat sebuah tabel, Anda dapat memberikan daftar kosong kolom untuk skema, dan sebaliknya menggunakan referensi skema.
SchemaReference struktur
Sebuah objek yang mereferensikan skema yang disimpan dalam S AWS Glue chema Registry.
Bidang
-
SchemaId— Sebuah objek SchemaId.Struktur yang berisi bidang identitas skema. Baik ini atau
SchemaVersionIdharus disediakan. -
SchemaVersionId— UTF-8 string, panjangnya tidak kurang dari 36 atau lebih dari 36 byte, cocok denganCustom string pattern #42.ID unik yang ditetapkan untuk sebuah versi skema. Baik ini atau
SchemaIdharus 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 ekstraktor dan loader.
Bidang
-
Name— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama dari SerDe.
-
SerializationLibrary— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.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.
Setiap nilai adalah UTF-8 string, panjangnya tidak lebih dari 512000 byte.
Pasangan kunci-nilai ini menentukan parameter inisialisasi untuk. SerDe
Struktur pesanan
Menentukan urutan dari kolom yang diurutkan.
Bidang
-
Column- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.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— Sebuah array UTF-8 string.Daftar nama kolom yang berisi nilai-nilai menyimpang.
-
SkewedColumnValues— Sebuah array UTF-8 string.Daftar nilai yang muncul sangat sering untuk dianggap menyimpang.
-
SkewedColumnValueLocationMaps– Susunan peta pasangan nilai kunci.Setiap kunci adalah UTF-8 string.
Setiap nilai adalah UTF-8 string.
Pemetaan nilai menyimpang untuk kolom yang berisi nilai tersebut.
TableVersion struktur
Menentukan versi dari sebuah tabel.
Bidang
-
Table— Sebuah objek Tabel.Tabel yang dimaksud.
-
VersionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nilai ID yang mengidentifikasi versi tabel ini. Sebuah
VersionIdadalah representasi string dari bilangan bulat. Setiap versi bertambah 1.
TableError struktur
Catatan kesalahan untuk operasi tabel.
Bidang
-
TableName— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
ErrorDetail— Sebuah objek ErrorDetail.Detail tentang kesalahan.
TableVersionError struktur
Catatan kesalahan untuk operasi versi tabel.
Bidang
-
TableName— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama tabel yang dimaksud.
-
VersionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nilai ID dari versi yang dimaksud. Sebuah
VersionIDadalah representasi string dari bilangan bulat. Setiap versi bertambah 1. -
ErrorDetail— Sebuah objek ErrorDetail.Detail tentang kesalahan.
SortCriterion struktur
Menentukan sebuah bidang yang akan dijadikan dasar urutan dan urutan pengurutan.
Bidang
-
FieldName— Nilai string, tidak kurang dari 1 atau lebih dari 1024 byte panjangnya.Nama bidang yang akan dijadikan dasar pengurutan.
-
Sort— UTF-8 string (nilai valid:ASC="ASCENDING"|DESC="DESCENDING").Pengurutan naik atau turun.
TableIdentifier struktur
Sebuah struktur yang menggambarkan tabel target untuk menghubungkan sumber daya.
Bidang
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID dari Katalog Data tempat tabel berada.
-
DatabaseName— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama database katalog yang berisi tabel target.
-
Name— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama tabel target.
-
Region— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Wilayah tabel target.
KeySchemaElement struktur
Pasangan kunci partisi yang terdiri dari nama dan tipe.
Bidang
-
Name- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama kunci partisi.
-
Type- Diperlukan: UTF-8 string, panjang tidak lebih dari 131072 byte, cocok dengan. Single-line string patternJenis kunci partisi.
PartitionIndex struktur
Struktur untuk indeks partisi.
Bidang
-
Keys- Diperlukan: Sebuah array UTF-8 string, setidaknya 1 string.Kunci untuk indeks partisi.
-
IndexName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama indeks partisi.
PartitionIndexDescriptor struktur
Sebuah deskriptor untuk indeks partisi dalam sebuah tabel.
Bidang
-
IndexName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama indeks partisi.
-
Keys— Wajib: Array dari objek KeySchemaElement, setidaknya 1 struktur.Daftar satu atau beberapa kunci, sebagai struktur
KeySchemaElement, untuk indeks partisi. -
IndexStatus— Diperlukan: UTF-8 string (nilai valid:CREATING|ACTIVE|DELETING|FAILED).Status indeks partisi.
Status yang mungkin muncul adalah:
-
CREATING: Indeks sedang dibuat. Ketika indeks dalam status CREATING, indeks atau tabelnya tidak dapat dihapus.
-
ACTIVE: Pembuatan indeks berhasil.
-
FAILED: Pembuatan indeks gagal.
-
DELETING: Indeks dihapus dari daftar indeks.
-
-
BackfillErrors– Susunan objek BackfillError.Daftar kesalahan yang dapat terjadi saat mendaftarkan indeks partisi untuk tabel yang ada.
BackfillError struktur
Daftar kesalahan yang dapat terjadi saat mendaftarkan indeks partisi untuk tabel yang ada.
Kesalahan ini memberikan detail tentang mengapa pendaftaran indeks gagal dan menyediakan sejumlah partisi dalam respon dalam jumlah terbatas, sehingga Anda dapat memperbaiki partisi yang salah dan mencoba mendaftarkan indeks lagi. Kumpulan kesalahan yang paling umum yang dapat terjadi dikategorikan sebagai berikut:
-
EncryptedPartitionError: Partisi dienkripsi.
-
InvalidPartitionTypeDataError: Nilai partisi tidak cocok dengan tipe data untuk kolom partisi itu.
-
MissingPartitionValueError: Partisi dienkripsi.
-
UnsupportedPartitionCharacterError: Karakter di dalam nilai partisi tidak didukung. Sebagai contoh: U+0000, U+0001, U+0002.
-
InternalError: Kesalahan apa pun yang bukan milik kode kesalahan lainnya.
Bidang
-
Code— UTF-8 string (nilai valid:ENCRYPTED_PARTITION_ERROR|INTERNAL_ERROR|INVALID_PARTITION_TYPE_DATA_ERROR|MISSING_PARTITION_VALUE_ERROR|UNSUPPORTED_PARTITION_CHARACTER_ERROR).Kode kesalahan untuk kesalahan yang terjadi saat mendaftarkan indeks partisi untuk tabel yang ada.
-
Partitions– Susunan objek PartitionValueList.Daftar sejumlah partisi dalam respon dalam jumlah terbatas.
IcebergInput struktur
Struktur yang mendefinisikan tabel metadata Apache Iceberg untuk dibuat dalam katalog.
Bidang
-
MetadataOperation- Diperlukan: UTF-8 string (nilai valid:CREATE).Operasi metadata yang diperlukan. Hanya dapat diatur ke
CREATE. -
Version— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Versi tabel untuk tabel Iceberg. Secara default ke 2.
-
CreateIcebergTableInput— Sebuah objek 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.Menentukan
IcebergInputstruktur yang mendefinisikan tabel metadata Apache Iceberg.
ViewDefinition struktur
Struktur yang berisi detail untuk representasi.
Bidang
-
IsProtected– Boolean.Anda dapat mengatur flag ini sebagai true untuk menginstruksikan mesin agar tidak mendorong operasi yang disediakan pengguna ke dalam rencana logis tampilan selama perencanaan kueri. Namun, menetapkan bendera ini tidak menjamin bahwa mesin akan mematuhi. Lihat dokumentasi mesin untuk memahami jaminan yang diberikan, jika ada.
-
Definer— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 512 byte, cocok denganSingle-line string pattern.Pendefinisikan tampilan di SQL.
-
ViewVersionId— Angka (panjang), setidaknya -1.Nilai ID yang mengidentifikasi versi tampilan ini. Untuk tampilan yang terwujud, ID versi adalah ID snapshot tabel Apache Iceberg.
-
ViewVersionToken— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.ID versi tabel Apache Iceberg.
-
RefreshSeconds— Nomor (panjang).Interval refresh otomatis dalam hitungan detik untuk tampilan yang terwujud. Jika tidak ditentukan, tampilan tidak akan disegarkan secara otomatis.
-
LastRefreshType— UTF-8 string (nilai valid:FULL|INCREMENTAL).Menetapkan metode yang digunakan untuk penyegaran terbaru.
-
SubObjects— Sebuah array UTF-8 string, tidak lebih dari 10 string.Daftar tabel Nama Sumber Daya Amazon (ARN).
-
SubObjectVersionIds— Array bilangan bulat 64-bit yang ditandatangani, tidak lebih dari 250 angka.Daftar versi tabel Apache Iceberg yang direferensikan oleh tampilan terwujud.
-
Representations— Susunan objek 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 mengatur flag ini sebagai true untuk menginstruksikan mesin agar tidak mendorong operasi yang disediakan pengguna ke dalam rencana logis tampilan selama perencanaan kueri. Namun, menetapkan bendera ini tidak menjamin bahwa mesin akan mematuhi. Lihat dokumentasi mesin untuk memahami jaminan yang diberikan, jika ada.
-
Definer— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 512 byte, cocok denganSingle-line string pattern.Pendefinisikan tampilan di SQL.
-
Representations— Sebuah array ViewRepresentationInput objek, tidak kurang dari 1 atau lebih dari 10 struktur.Daftar struktur yang berisi dialek tampilan, dan query yang mendefinisikan tampilan.
-
ViewVersionId— Angka (panjang), setidaknya -1.Nilai ID yang mengidentifikasi versi tampilan ini. Untuk tampilan yang terwujud, ID versi adalah ID snapshot tabel Apache Iceberg.
-
ViewVersionToken— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.ID versi tabel Apache Iceberg.
-
RefreshSeconds— Nomor (panjang).Interval refresh otomatis dalam hitungan detik untuk tampilan yang terwujud. Jika tidak ditentukan, tampilan tidak akan disegarkan secara otomatis.
-
LastRefreshType— UTF-8 string (nilai valid:FULL|INCREMENTAL).Jenis penyegaran terakhir tampilan yang terwujud. Nilai-nilai yang valid:
Full,Incremental. -
SubObjects— Sebuah array UTF-8 string, tidak lebih dari 10 string.Daftar ARN tabel dasar yang membentuk tampilan.
-
SubObjectVersionIds— Array bilangan bulat 64-bit yang ditandatangani, tidak lebih dari 250 angka.Daftar versi tabel Apache Iceberg yang direferensikan oleh tampilan terwujud.
ViewRepresentation struktur
Struktur yang berisi dialek tampilan, dan query yang mendefinisikan tampilan.
Bidang
-
Dialect— UTF-8 string (nilai valid:REDSHIFT|ATHENA|SPARK).Dialek mesin query.
-
DialectVersion— UTF-8 string, tidak kurang dari 1 atau lebih dari 255 byte panjangnya.Versi dialek mesin kueri. Misalnya, 3.0.0.
-
ViewOriginalText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.Per
SELECTmintaan yang diberikan oleh pelanggan selamaCREATE VIEW DDL. SQL ini tidak digunakan selama kueri pada tampilan (ViewExpandedTextdigunakan sebagai gantinya).ViewOriginalTextdigunakan untuk kasus sepertiSHOW CREATE VIEWdi mana pengguna ingin melihat perintah DDL asli yang membuat tampilan. -
ViewExpandedText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.SQL yang diperluas untuk tampilan. SQL ini digunakan oleh mesin saat memproses query pada tampilan. Mesin dapat melakukan operasi selama pembuatan tampilan untuk diubah
ViewOriginalTextmenjadiViewExpandedText. Contoh:-
Pengidentifikasi yang sepenuhnya memenuhi syarat:
SELECT * from table1 -> SELECT * from db1.table1
-
-
ValidationConnection— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama koneksi yang akan digunakan untuk memvalidasi representasi spesifik dari tampilan.
-
IsStale– Boolean.Dialek-dialek yang ditandai sebagai basi tidak lagi valid dan harus diperbarui sebelum dapat ditanyakan di mesin kueri masing-masing.
ViewRepresentationInput struktur
Struktur yang berisi rincian representasi untuk memperbarui atau membuat tampilan Danau Formasi.
Bidang
-
Dialect— UTF-8 string (nilai valid:REDSHIFT|ATHENA|SPARK).Parameter yang menentukan jenis mesin dari representasi tertentu.
-
DialectVersion— UTF-8 string, tidak kurang dari 1 atau lebih dari 255 byte panjangnya.Parameter yang menentukan versi mesin dari representasi tertentu.
-
ViewOriginalText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.Sebuah string yang mewakili query SQL asli yang menggambarkan tampilan.
-
ValidationConnection— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama koneksi yang akan digunakan untuk memvalidasi representasi spesifik dari tampilan.
-
ViewExpandedText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.Sebuah string yang mewakili query SQL yang menjelaskan tampilan dengan ARN sumber daya yang diperluas
UpdateOpenTableFormatInput struktur
Parameter input 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.Param Iceberg-specific eter update Apache yang menentukan modifikasi tabel yang akan diterapkan, termasuk perubahan skema, spesifikasi partisi, dan properti tabel.
UpdateIcebergInput struktur
Parameter input khusus untuk memperbarui tabel Apache Iceberg di Katalog AWS Glue Data, berisi operasi pembaruan yang akan diterapkan ke tabel Iceberg yang ada.
Bidang
-
UpdateIcebergTableInput— Wajib: Sebuah objek UpdateIcebergTableInput.Operasi pembaruan spesifik 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- Diperlukan: String lokasi, panjang tidak lebih dari 2056 byte, cocok dengan. URI address multi-line string patternLokasi S3 tempat data tabel Iceberg akan disimpan.
-
Schema— Wajib: Sebuah objek IcebergSchema.Definisi skema yang menentukan struktur, jenis bidang, dan metadata untuk tabel Iceberg.
-
PartitionSpec— Sebuah objek IcebergPartitionSpec.Spesifikasi partisi yang mendefinisikan bagaimana data tabel Iceberg akan diatur dan dipartisi untuk kinerja kueri yang optimal.
-
WriteOrder— Sebuah objek IcebergSortOrder.Spesifikasi urutan urutan yang mendefinisikan bagaimana data harus diurutkan dalam setiap partisi untuk mengoptimalkan kinerja kueri.
-
Properties– Susunan peta pasangan nilai kunci.Setiap kunci adalah UTF-8 string.
Setiap nilai adalah UTF-8 string.
Key-value pasangan 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.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 untuk tabel Iceberg, menentukan bagaimana data harus diurutkan dalam partisi untuk mengoptimalkan kinerja kueri.
Bidang
-
OrderId— Wajib: Nomor (bilangan bulat).Pengidentifikasi unik untuk spesifikasi urutan urutan ini dalam metadata tabel Iceberg.
-
Fields– Wajib: Susunan objek IcebergSortField.Daftar bidang dan arah pengurutannya 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 nol.
Bidang
-
SourceId— Wajib: Nomor (bilangan bulat).Pengidentifikasi bidang sumber dari skema tabel yang menjadi dasar bidang pengurutan ini.
-
Transform- Diperlukan: UTF-8 string.Fungsi transformasi diterapkan ke bidang sumber sebelum menyortir, seperti identitas, bucket, atau truncate.
-
Direction— Diperlukan: UTF-8 string (nilai valid:asc="ASC"|desc="DESC").Arah pengurutan untuk bidang ini, baik naik atau turun.
-
NullOrder— Diperlukan: UTF-8 string (nilai valid:nulls-first="NULLS_FIRST"|nulls-last="NULLS_LAST").Perilaku pengurutan untuk nilai nol di bidang ini, menentukan apakah nol harus 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.Daftar bidang partisi yang menentukan bagaimana data tabel harus dipartisi, termasuk bidang sumber dan transformasi mereka.
-
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- Diperlukan: UTF-8 string.Fungsi transformasi diterapkan ke bidang sumber untuk membuat partisi, seperti identitas, bucket, truncate, tahun, bulan, hari, atau jam.
-
Name- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 1024 byte, cocok denganSingle-line string pattern.Nama bidang partisi seperti yang akan muncul dalam struktur tabel yang dipartisi.
-
FieldId— Nomor (bilangan bulat).Pengidentifikasi unik yang ditetapkan untuk bidang partisi ini dalam spesifikasi partisi tabel Iceberg.
IcebergSchema struktur
Mendefinisikan struktur skema untuk tabel Iceberg, termasuk definisi bidang, tipe data, dan metadata skema.
Bidang
-
SchemaId— Nomor (bilangan bulat).Pengidentifikasi unik untuk versi skema ini dalam riwayat 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— UTF-8 string (nilai valid:struct="STRUCT").Jenis akar dari struktur skema, biasanya “struct” untuk skema tabel Iceberg.
-
Fields– Wajib: Susunan objek IcebergStructField.Daftar definisi bidang yang membentuk skema tabel, termasuk nama bidang, jenis, dan metadata.
IcebergStructField struktur
Mendefinisikan satu bidang dalam skema tabel Iceberg, termasuk pengidentifikasi, nama, tipe data, nulabilitas, dan dokumentasi.
Bidang
-
Id— Wajib: Nomor (bilangan bulat).Pengidentifikasi unik yang ditetapkan untuk bidang ini dalam skema tabel Iceberg, digunakan untuk evolusi skema dan pelacakan lapangan.
-
Name- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 1024 byte, cocok denganSingle-line string pattern.Nama bidang seperti yang muncul dalam skema tabel dan operasi kueri.
-
Type— Diperlukan: Struktur kosong bernama.IcebergDocumentDefinisi tipe data untuk bidang ini, menentukan struktur dan format data yang dikandungnya.
-
Required– Wajib: Boolean.Menunjukkan apakah bidang ini wajib (non-nullable) atau opsional (nullable) dalam skema tabel.
-
Doc— String komentar, sepanjang tidak lebih dari 255, yang cocok dengan Single-line string pattern.Dokumentasi opsional atau teks deskripsi yang memberikan konteks tambahan tentang tujuan dan penggunaan bidang ini.
-
InitialDefault- Struktur kosong bernama.IcebergDocumentNilai default digunakan untuk mengisi nilai bidang untuk semua catatan yang ditulis sebelum bidang ditambahkan ke skema. Ini memungkinkan kompatibilitas mundur saat menambahkan bidang baru ke tabel Iceberg yang ada.
-
WriteDefault- Struktur kosong bernama.IcebergDocumentNilai default digunakan untuk mengisi nilai bidang untuk setiap catatan yang ditulis setelah bidang ditambahkan ke skema, jika penulis tidak memberikan nilai bidang. Ini dapat diubah melalui evolusi skema.
IcebergTableUpdate struktur
Mendefinisikan satu set lengkap pembaruan yang akan diterapkan ke tabel Iceberg, termasuk perubahan skema, modifikasi partisi, penyesuaian urutan, pembaruan lokasi, dan perubahan properti.
Bidang
-
Schema— Wajib: Sebuah objek IcebergSchema.Definisi skema yang diperbarui untuk tabel Iceberg, menentukan perubahan apa pun pada struktur bidang, tipe data, atau metadata skema.
-
PartitionSpec— Sebuah objek IcebergPartitionSpec.Spesifikasi partisi yang diperbarui yang mendefinisikan bagaimana data tabel harus ditata ulang dan dipartisi.
-
SortOrder— Sebuah objek IcebergSortOrder.Spesifikasi urutan urutan yang diperbarui yang mendefinisikan bagaimana data harus diurutkan dalam partisi untuk kinerja kueri yang optimal.
-
Location- Diperlukan: String lokasi, panjang tidak lebih dari 2056 byte, cocok dengan. URI address multi-line string patternLokasi S3 yang diperbarui tempat data tabel Iceberg akan disimpan.
-
Properties– Susunan peta pasangan nilai kunci.Setiap kunci adalah UTF-8 string.
Setiap nilai adalah UTF-8 string.
Diperbarui pasangan kunci-nilai properti tabel dan pengaturan konfigurasi untuk tabel Iceberg.
-
Action— UTF-8 string (nilai yang valid:add-schema="ADD_SCHEMA"set-current-schema="SET_CURRENT_SCHEMA"|add-spec="ADD_SPEC"|set-default-spec="SET_DEFAULT_SPEC"|add-sort-order="ADD_SORT_ORDER"|set-default-sort-order="SET_DEFAULT_SORT_ORDER"|set-location="SET_LOCATION"|set-properties="SET_PROPERTIES"|remove-properties="REMOVE_PROPERTIES"|add-encryption-key="ADD_ENCRYPTION_KEY"|remove-encryption-key="REMOVE_ENCRYPTION_KEY").Jenis tindakan pembaruan yang akan dilakukan pada tabel Iceberg. Mendefinisikan operasi tertentu seperti menambahkan skema, mengatur skema saat ini, menambahkan spesifikasi partisi, atau mengelola kunci enkripsi.
-
EncryptionKey— Sebuah objek IcebergEncryptedKey.Informasi kunci enkripsi terkait dengan operasi pembaruan tabel Iceberg. Digunakan saat menambahkan atau menghapus kunci enkripsi dari metadata tabel selama evolusi tabel.
-
KeyId— UTF-8 string, panjangnya tidak lebih dari 2056 byte, cocok dengan. URI address multi-line string patternPengidentifikasi kunci enkripsi yang terlibat dalam operasi pembaruan tabel Iceberg. Mereferensikan kunci spesifik yang ditambahkan atau dihapus dari konfigurasi enkripsi tabel.
IcebergTableMetadata struktur
Metadata tabel Apache Iceberg, termasuk versi format, pengidentifikasi tabel, skema, spesifikasi partisi, urutan urutan, dan properti tabel. Struktur ini menangkap keadaan metadata tabel Iceberg saat ini sebagaimana dikelola oleh Katalog AWS Glue Data.
Bidang
-
FormatVersion— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Versi format tabel Apache Iceberg, seperti
1atau2. Menentukan kumpulan fitur dan tata letak on-disk yang didukung oleh tabel. -
TableUuid— UTF-8 string, panjangnya tidak lebih dari 100 byte, cocok denganSingle-line string pattern.Pengidentifikasi unik (UUID) untuk tabel Iceberg, ditetapkan saat tabel dibuat dan digunakan untuk melacak tabel di seluruh pembaruan metadata.
-
Location— String lokasi, sepanjang tidak lebih dari 2056, yang cocok dengan URI address multi-line string pattern.Lokasi dasar S3 tempat data tabel Iceberg dan file metadata disimpan.
-
Properties– Susunan peta pasangan nilai kunci.Setiap kunci adalah UTF-8 string.
Setiap nilai adalah UTF-8 string.
Peta pasangan kunci-nilai yang menentukan properti tingkat tabel dan pengaturan konfigurasi untuk tabel Iceberg.
-
Schemas– Susunan objek IcebergSchema.Daftar skema yang telah dikaitkan dengan tabel Gunung Es selama sejarahnya, mendukung evolusi skema.
-
CurrentSchemaId— Nomor (bilangan bulat).Pengidentifikasi skema yang saat ini aktif untuk tabel Iceberg. Cocokkan entri di
Schemas. -
LastColumnId— Nomor (bilangan bulat).Pengidentifikasi kolom tertinggi yang telah ditetapkan dalam skema tabel Iceberg, digunakan untuk memastikan ID unik saat kolom baru ditambahkan.
-
PartitionSpecs– Susunan objek IcebergPartitionSpec.Daftar spesifikasi partisi yang telah dikaitkan dengan tabel Iceberg selama sejarahnya, mendukung evolusi partisi.
-
DefaultSpecId— Nomor (bilangan bulat).Pengidentifikasi spesifikasi partisi yang saat ini digunakan secara default saat menulis data baru ke tabel Iceberg.
-
LastPartitionId— Nomor (bilangan bulat).Pengidentifikasi bidang partisi tertinggi yang telah ditetapkan di seluruh spesifikasi partisi tabel.
-
SortOrders– Susunan objek IcebergSortOrder.Daftar spesifikasi urutan urutan yang telah dikaitkan dengan tabel Iceberg selama sejarahnya.
-
DefaultSortOrderId— Nomor (bilangan bulat).Pengidentifikasi urutan pengurutan yang saat ini digunakan secara default saat menulis data baru ke tabel Iceberg.
IcebergEncryptedKey struktur
Struktur kunci enkripsi digunakan untuk enkripsi tabel Iceberg. Berisi ID kunci, metadata kunci terenkripsi, referensi opsional ke kunci enkripsi, dan properti tambahan untuk skema enkripsi tabel.
Bidang
-
KeyId- Diperlukan: UTF-8 string, panjang tidak lebih dari 2056 byte, cocok dengan. URI address multi-line string patternPengidentifikasi unik dari kunci enkripsi yang digunakan untuk enkripsi tabel Iceberg. ID ini digunakan untuk mereferensikan kunci dalam metadata tabel dan melacak kunci mana yang digunakan untuk mengenkripsi data tertentu.
-
EncryptedKeyMetadata- Diperlukan: UTF-8 string, panjang tidak lebih dari 2056 byte, cocok dengan. URI address multi-line string patternKunci dan metadata terenkripsi, base64 dikodekan. Format metadata kunci terenkripsi ditentukan oleh skema enkripsi tabel dan dapat berupa format yang dibungkus khusus untuk penyedia KMS tabel.
-
EncryptedById— UTF-8 string, panjangnya tidak lebih dari 2056 byte, cocok dengan. URI address multi-line string patternID opsional kunci yang digunakan untuk mengenkripsi atau membungkus metadata kunci dalam enkripsi tabel Iceberg. Bidang ini mereferensikan kunci enkripsi lain yang digunakan untuk mengenkripsi metadata kunci saat ini.
-
Properties– Susunan peta pasangan nilai kunci.Setiap kunci adalah UTF-8 string.
Setiap nilai adalah UTF-8 string.
Peta string ke string dari metadata tambahan yang digunakan oleh skema enkripsi tabel. Properti ini menyediakan konteks dan konfigurasi tambahan untuk implementasi kunci enkripsi.
TableStatus struktur
Struktur yang berisi informasi tentang keadaan perubahan asinkron ke tabel.
Bidang
-
RequestedBy— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.ARN pengguna yang meminta perubahan asinkron.
-
UpdatedBy— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.ARN pengguna yang terakhir mengubah perubahan asinkron secara manual (meminta pembatalan, dll).
-
RequestTime— Stempel waktu.String tanggal berformat ISO 8601 yang menunjukkan waktu perubahan dimulai.
-
UpdateTime— Stempel waktu.String tanggal berformat ISO 8601 yang menunjukkan waktu status terakhir diperbarui.
-
Action— UTF-8 string (nilai valid:UPDATE|CREATE).Menunjukkan tindakan mana yang dipanggil di atas meja, saat ini hanya
CREATEatauUPDATE. -
State— UTF-8 string (nilai valid:QUEUED|IN_PROGRESS|SUCCESS|STOPPED|FAILED).Status umum untuk perubahan yang sedang berlangsung, seperti QUEUED, IN_PROGRESS, SUCCESS, atau FAILED.
-
Error— Sebuah objek ErrorDetail.Kesalahan yang hanya akan muncul ketika status “GAGAL”. Ini adalah pesan pengecualian tingkat induk, mungkin ada
Errors yang berbeda untuk setiap dialek. -
Details— Sebuah objek StatusDetails.Ob
StatusDetailsjek dengan informasi tentang perubahan yang diminta.
StatusDetails struktur
Struktur yang berisi informasi tentang perubahan asinkron pada tabel.
Bidang
-
RequestedChange— Sebuah objek Tabel.Ob
Tablejek yang mewakili perubahan yang diminta. -
ViewValidations– Susunan objek ViewValidation.Daftar
ViewValidationobjek yang berisi informasi untuk mesin analitik untuk memvalidasi tampilan.
ViewValidation struktur
Struktur yang berisi informasi untuk mesin analitik untuk memvalidasi tampilan, sebelum mempertahankan metadata tampilan. Digunakan dalam kasus panggilan langsung UpdateTable atau CreateTable API.
Bidang
-
Dialect— UTF-8 string (nilai valid:REDSHIFT|ATHENA|SPARK).Dialek mesin query.
-
DialectVersion— UTF-8 string, tidak kurang dari 1 atau lebih dari 255 byte panjangnya.Versi dialek mesin kueri. Misalnya, 3.0.0.
-
ViewValidationText— UTF-8 string, panjangnya tidak lebih dari 409600 byte.Ku
SELECTeri yang mendefinisikan tampilan, seperti yang disediakan oleh pelanggan. -
UpdateTime— Stempel waktu.Waktu pembaruan terakhir.
-
State— UTF-8 string (nilai valid:QUEUED|IN_PROGRESS|SUCCESS|STOPPED|FAILED).Keadaan validasi.
-
Error— Sebuah objek ErrorDetail.Kesalahan yang terkait dengan validasi.
AuditContext struktur
Struktur yang berisi konteks Lake Formation audit.
Bidang
-
AdditionalAuditContext— UTF-8 string, panjangnya tidak lebih dari 2048 byte.Sebuah string yang berisi informasi konteks audit tambahan.
-
RequestedColumns— Sebuah array UTF-8 string.Kolom yang diminta untuk audit.
-
AllColumnsRequested– Boolean.Semua kolom meminta audit.
Operasi
BatchDeleteTableVersion tindakan (Python: batch_delete_table_version)
GetPartitionIndexes tindakan (Python: get_partition_indexes)
CreatePartitionIndex tindakan (Python: create_partition_index)
DeletePartitionIndex tindakan (Python: delete_partition_index)
GetColumnStatisticsForTable tindakan (Python: get_column_statistics_for_table)
UpdateColumnStatisticsForTable tindakan (Python: update_column_statistics_for_table)
DeleteColumnStatisticsForTable tindakan (Python: delete_column_statistics_for_table)
CreateTable tindakan (Python: create_table)
Menciptakan sebuah definisi tabel baru dalam Katalog Data.
Permintaan
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID Katalog Data tempat
Tabledibuat. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default. -
DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Basis data katalog di mana tabel baru akan dibuat. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
Name— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Pengidentifikasi unik untuk tabel dalam database yang ditentukan yang akan dibuat dalam Katalog AWS Glue Data.
-
TableInput— Sebuah objek TableInput.Objek
TableInputyang mendefinisikan tabel metadata yang akan dibuat dalam katalog. -
PartitionIndexes– Susunan objek PartitionIndex.Daftar indeks partisi, struktur
PartitionIndex, yang akan dibuat dalam tabel. -
TransactionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganCustom string pattern #41.ID transaksi.
-
OpenTableFormatInput— Sebuah objek OpenTableFormatInput.Menentukan
OpenTableFormatInputstruktur saat membuat tabel format terbuka.
Respons
Tidak ada parameter Respons.
Kesalahan
AlreadyExistsExceptionInvalidInputExceptionEntityNotFoundExceptionResourceNumberLimitExceededExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionExceptionConcurrentModificationExceptionResourceNotReadyExceptionFederationSourceExceptionFederationSourceRetryableException
UpdateTable tindakan (Python: update_table)
Memperbarui tabel metadata dalam Katalog Data.
Permintaan
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID dari Katalog Data tempat tabel berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
-
DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama basis data katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
Name— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Pengidentifikasi unik untuk tabel dalam database yang ditentukan yang akan dibuat dalam Katalog AWS Glue Data.
-
TableInput— Sebuah objek TableInput.Objek
TableInputyang diperbarui untuk menentukan tabel metadata dalam katalog. -
SkipArchive– Boolean.Secara default,
UpdateTableselalu membuat versi diarsipkan dari tabel tersebut sebelum memperbaruinya. Namun, jikaskipArchivediatur ke BETUL,UpdateTabletidak akan membuat versi yang diarsipkan. -
TransactionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganCustom string pattern #41.ID transaksi untuk memperbarui isi tabel.
-
VersionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.ID versi untuk memperbarui isi tabel.
-
ViewUpdateAction— UTF-8 string (nilai valid:ADD|REPLACE|ADD_OR_REPLACE|DROP).Operasi yang akan dilakukan saat memperbarui tampilan.
-
Force– Boolean.Bendera yang dapat disetel ke true untuk mengabaikan deskriptor penyimpanan yang cocok dan persyaratan pencocokan suboobjek.
-
UpdateOpenTableFormatInput— Sebuah objek UpdateOpenTableFormatInput.Parameter input 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
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionConcurrentModificationExceptionResourceNumberLimitExceededExceptionGlueEncryptionExceptionResourceNotReadyExceptionFederationSourceExceptionFederationSourceRetryableExceptionAlreadyExistsException
DeleteTable tindakan (Python: delete_table)
Menghapus sebuah definisi tabel dari Katalog Data.
catatan
Setelah menyelesaikan operasi ini, Anda tidak lagi memiliki akses ke versi tabel dan partisi yang merupakan milik tabel yang dihapus. AWS Glue menghapus sumber daya "yatim piatu" secara asinkron pada waktu yang tepat, atas kebijaksanaan layanan.
Untuk memastikan penghapusan langsung dari semua sumber daya terkait, sebelum memanggil DeleteTable, gunakan DeleteTableVersion atau BatchDeleteTableVersion, dan DeletePartition atau BatchDeletePartition, untuk menghapus sumber daya yang dimiliki oleh tabel.
Permintaan
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID dari Katalog Data tempat tabel berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
-
DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama basis data katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
Name- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama tabel yang akan dihapus. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
TransactionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganCustom string pattern #41.ID transaksi untuk menghapus isi tabel.
Respons
Tidak ada parameter Respons.
Kesalahan
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionConcurrentModificationExceptionResourceNotReadyExceptionFederationSourceExceptionFederationSourceRetryableException
BatchDeleteTable tindakan (Python: batch_delete_table)
Menghapus beberapa tabel sekaligus.
catatan
Setelah menyelesaikan operasi ini, Anda tidak lagi memiliki akses ke versi tabel dan partisi yang merupakan milik tabel yang dihapus. AWS Glue menghapus sumber daya "yatim piatu" secara asinkron pada waktu yang tepat, atas kebijaksanaan layanan.
Untuk memastikan penghapusan langsung dari semua sumber daya terkait, sebelum memanggil BatchDeleteTable, gunakan DeleteTableVersion atau BatchDeleteTableVersion, dan DeletePartition atau BatchDeletePartition, untuk menghapus sumber daya yang dimiliki oleh tabel.
Permintaan
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID dari Katalog Data tempat tabel berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
-
DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama basis data katalog di mana tabel yang akan dihapus berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
TablesToDelete- Diperlukan: Sebuah array UTF-8 string, tidak lebih dari 100 string.Daftar tabel yang akan dihapus.
-
TransactionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganCustom string pattern #41.ID transaksi untuk menghapus isi tabel.
Respons
-
Errors– Susunan objek TableError.Daftar kesalahan yang ditemui saat berusaha untuk menghapus tabel tertentu.
Kesalahan
InvalidInputExceptionEntityNotFoundExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionExceptionResourceNotReadyException
GetTable tindakan (Python: get_table)
Mengambil definisi Table dalam Katalog Data untuk tabel yang ditentukan.
Permintaan
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID dari Katalog Data tempat tabel berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
-
DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama basis data dalam katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
Name- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama tabel yang untuknya definisi akan diambil. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
TransactionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganCustom string pattern #41.ID transaksi untuk membaca isi tabel.
-
QueryAsOfTime— Stempel waktu.Waktu kapan membaca isi tabel. Jika tidak diatur, waktu komit transaksi terbaru akan digunakan. Tidak dapat ditentukan bersama dengan
TransactionId. -
AuditContext— Sebuah objek AuditContext.Struktur yang berisi konteks Lake Formation audit.
-
IncludeStatusDetails– Boolean.Menentukan apakah akan menyertakan detail status terkait dengan permintaan untuk membuat atau memperbarui tampilan Katalog AWS Glue Data.
-
AttributesToGet— Sebuah array UTF-8 string.Menentukan bidang tabel yang dikembalikan oleh
GetTablepanggilan. Parameter ini tidak menerima daftar kosong.Berikut ini adalah kombinasi nilai yang valid:
-
DEFAULT- Mengembalikan definisi Hive-style tabel saja. -
LATEST_ICEBERG_METADATA- Mengembalikan hanya metadata tabel Apache Iceberg terbaru. -
DEFAULT,LATEST_ICEBERG_METADATA- Mengembalikan definisi Hive-style tabel dan metadata tabel Apache Iceberg terbaru.
-
Respons
-
Table— Sebuah objek Tabel.Objek
Tableyang mendefinisikan tabel yang ditentukan.
Kesalahan
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionExceptionResourceNotReadyExceptionFederationSourceExceptionFederationSourceRetryableException
GetTables tindakan (Python: get_tables)
Mengambil definisi dari beberapa atau semua tabel dalam Database yang ditentukan.
Permintaan
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID dari Katalog Data tempat tabel-tabel tersebut berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
-
DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Basis data dalam katalog yang tabelnya akan dicantumkan. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
Expression— UTF-8 string, panjangnya tidak lebih dari 2048 byte, cocok denganSingle-line string pattern.Sebuah pola ekspresi reguler. Jika ada, hanya tabel yang namanya cocok dengan pola saja yang dikembalikan.
-
NextToken— UTF-8 tali.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— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganCustom string pattern #41.ID transaksi untuk membaca isi tabel.
-
QueryAsOfTime— Stempel waktu.Waktu kapan membaca isi tabel. Jika tidak diatur, waktu komit transaksi terbaru akan digunakan. Tidak dapat ditentukan bersama dengan
TransactionId. -
AuditContext— Sebuah objek AuditContext.Struktur yang berisi konteks Lake Formation audit.
-
IncludeStatusDetails– Boolean.Menentukan apakah akan menyertakan detail status terkait dengan permintaan untuk membuat atau memperbarui tampilan Katalog AWS Glue Data.
-
AttributesToGet— Sebuah array UTF-8 string.Menentukan bidang tabel yang dikembalikan oleh
GetTablespanggilan. Parameter ini tidak menerima daftar kosong. Permintaan harus menyertakanNAME.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.Daftar objek
Tableyang diminta. -
NextToken— UTF-8 tali.Sebuah token kelanjutan, ada jika segmen daftar saat ini bukan yang terakhir.
Kesalahan
EntityNotFoundExceptionInvalidInputExceptionOperationTimeoutExceptionInternalServiceExceptionGlueEncryptionExceptionFederationSourceExceptionFederationSourceRetryableException
GetTableVersion tindakan (Python: get_table_version)
Mengambil versi tertentu dari sebuah tabel.
Permintaan
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID dari Katalog Data tempat tabel-tabel tersebut berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
-
DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Basis data dalam katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
VersionId— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nilai ID dari versi tabel yang akan diambil. Sebuah
VersionIDadalah representasi string dari bilangan bulat. Setiap versi bertambah 1.
Respons
-
TableVersion— Sebuah objek TableVersion.Versi tabel yang diminta.
Kesalahan
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionException
GetTableVersions tindakan (Python: get_table_versions)
Mengambil daftar string yang mengidentifikasi versi yang tersedia dari sebuah tabel yang ditentukan.
Permintaan
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID dari Katalog Data tempat tabel-tabel tersebut berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
-
DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Basis data dalam katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
NextToken— UTF-8 tali.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.Daftar string yang mengidentifikasi versi yang tersedia dari sebuah tabel yang ditentukan.
-
NextToken— UTF-8 tali.Sebuah token kelanjutan, jika daftar versi yang tersedia tidak termasuk yang terakhir.
Kesalahan
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionException
DeleteTableVersion tindakan (Python: delete_table_version)
Menghapus versi tertentu dari sebuah tabel.
Permintaan
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID dari Katalog Data tempat tabel-tabel tersebut berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
-
DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Basis data dalam katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
VersionId- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.ID dari versi tabel yang akan dihapus. Sebuah
VersionIDadalah representasi string dari bilangan bulat. Setiap versi bertambah 1.
Respons
Tidak ada parameter Respons.
Kesalahan
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutException
BatchDeleteTableVersion tindakan (Python: batch_delete_table_version)
Menghapus batch versi tertentu dari sebuah tabel.
Permintaan
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID dari Katalog Data tempat tabel-tabel tersebut berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
-
DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Basis data dalam katalog tempat tabel berada. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama tabel. Untuk kompatibilitas Hive, nama ini semuanya harus huruf kecil.
-
VersionIds- Diperlukan: Sebuah array UTF-8 string, tidak lebih dari 100 string.Daftar ID versi yang akan dihapus. Sebuah
VersionIdadalah representasi string dari bilangan bulat. Setiap versi bertambah 1.
Respons
-
Errors– Susunan objek TableVersionError.Daftar kesalahan yang ditemui saat berusaha menghapus versi tabel yang ditentukan.
Kesalahan
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutException
SearchTables tindakan (Python: search_tables)
Mencari satu set tabel berdasarkan properti dalam metadata tabel dan pada basis data induk. Anda dapat mencari berdasarkan teks atau syarat filter.
Anda hanya bisa mendapatkan tabel yang dapat Anda akses berdasarkan kebijakan keamanan yang ditetapkan dalam Lake Formation. Anda memerlukan setidaknya akses baca-saja ke tabel yang untuknya akan dikembalikan. Jika Anda tidak memiliki akses ke semua kolom dalam tabel, maka kolom-kolom tersebut tidak akan dicari saat mengembalikan daftar tabel kembali kepada Anda. Jika Anda memiliki akses ke kolom tetapi tidak ke data dalam kolom, maka kolom tersebut dan metadata yang dikaitkan ke kolom tersebut akan dimasukkan dalam pencarian.
Permintaan
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.Pengidentifikasi unik, terdiri dari
account_id. -
NextToken— UTF-8 tali.Sebuah token kelanjutan, disertakan jika ini adalah sebuah panggilan kelanjutan.
-
Filters– Susunan objek PropertyPredicate.Sebuah daftar pasangan nilai-kunci, dan sebuah pembanding digunakan untuk mem-filter hasil pencarian. Mengembalikan semua entitas yang cocok dengan predikat.
Anggota
Comparatordari structPropertyPredicatehanya digunakan untuk bidang waktu, dan dapat dihilangkan untuk jenis bidang lainnya. Selain itu, ketika membandingkan nilai string, seperti ketikaKey=Name, algoritme kecocokan fuzzy digunakan. BidangKey(misalnya, nilai bidangName) dibagi berdasarkan karakter tanda baca tertentu, misalnya, -, :, #, dll. menjadi token. Kemudian setiap token adalah dibandingkan secara exact-match dengan anggotaValuedariPropertyPredicate. Misalnya, jikaKey=NamedanValue=link, tabel bernamacustomer-linkdanxx-link-yydikembalikan, tapixxlinkyytidak dikembalikan. -
SearchText— Nilai string, tidak kurang dari 1 atau lebih dari 1024 byte panjangnya.String yang digunakan untuk pencarian teks.
Menentukan nilai dalam filter kutipan berdasarkan kecocokan persis dengan nilai.
-
SortCriteria— Susunan objek 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— UTF-8 string (nilai valid:FOREIGN|ALL|FEDERATED).Memungkinkan Anda untuk menentukan apakah Anda ingin mencari tabel yang dibagi dengan akun Anda. Nilai yang diijinkan adalah
FOREIGNatauALL.-
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 detail status terkait dengan permintaan untuk membuat atau memperbarui tampilan Katalog AWS Glue Data.
Respons
-
NextToken— UTF-8 tali.Sebuah token kelanjutan, ada jika segmen daftar saat ini bukan yang terakhir.
-
TableList– Susunan objek Tabel.Daftar objek
Tableyang diminta. ResponsSearchTableshanya mengembalikan tabel yang Anda miliki aksesnya.
Kesalahan
InternalServiceExceptionInvalidInputExceptionOperationTimeoutException
GetPartitionIndexes tindakan (Python: get_partition_indexes)
Mengambil indeks partisi yang dikaitkan dengan sebuah tabel.
Permintaan
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID katalog tempat tabel berada.
-
DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Menentukan nama basis data tempat Anda ingin mengambil indeks partisi.
-
TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Menentukan nama tabel yang untuknya Anda ingin mengambil indeks partisi.
-
NextToken— UTF-8 tali.Sebuah token kelanjutan, disertakan jika ini adalah sebuah panggilan kelanjutan.
Respons
-
PartitionIndexDescriptorList– Susunan objek PartitionIndexDescriptor.Daftar deskriptor indeks.
-
NextToken— UTF-8 tali.Sebuah token kelanjutan, ada jika segmen daftar saat ini bukan yang terakhir.
Kesalahan
InternalServiceExceptionOperationTimeoutExceptionInvalidInputExceptionEntityNotFoundExceptionConflictException
CreatePartitionIndex tindakan (Python: create_partition_index)
Menciptakan sebuah indeks partisi tertentu dalam tabel yang ada.
Permintaan
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID katalog tempat tabel berada.
-
DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Menentukan nama sebuah basis data di mana Anda ingin membuat sebuah indeks partisi.
-
TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Menentukan nama sebuah tabel di mana Anda ingin membuat sebuah indeks partisi.
-
PartitionIndex— Wajib: Sebuah objek PartitionIndex.Menentukan struktur
PartitionIndexuntuk membuat sebuah indeks partisi dalam tabel yang ada.
Respons
Tidak ada parameter Respons.
Kesalahan
AlreadyExistsExceptionInvalidInputExceptionEntityNotFoundExceptionResourceNumberLimitExceededExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionException
DeletePartitionIndex tindakan (Python: delete_partition_index)
Menghapus sebuah indeks partisi tertentu dari tabel yang ada.
Permintaan
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID katalog tempat tabel berada.
-
DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Menentukan nama sebuah basis data yang ingin Anda hapus indeks partisinya.
-
TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Menentukan nama sebuah tabel yang ingin Anda hapus indeks partisinya.
-
IndexName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama indeks partisi yang akan dihapus.
Respons
Tidak ada parameter Respons.
Kesalahan
InternalServiceExceptionOperationTimeoutExceptionInvalidInputExceptionEntityNotFoundExceptionConflictExceptionGlueEncryptionException
GetColumnStatisticsForTable tindakan (Python: get_column_statistics_for_table)
Mengambil statistik tabel kolom.
Izin Identity and Access Management (IAM) yang diperlukan untuk operasi ini adalah GetTable.
Permintaan
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID Katalog Data tempat partisi yang dimaksud berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
-
DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama basis data katalog tempat partisi berada.
-
TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama tabel partisi.
-
ColumnNames- Diperlukan: Sebuah array UTF-8 string, tidak lebih dari 100 string.Daftar nama kolom.
Respons
-
ColumnStatisticsList– Susunan objek ColumnStatistics.Daftar ColumnStatistics.
-
Errors– Susunan objek ColumnError.Daftar ColumnStatistics itu gagal diambil.
Kesalahan
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionException
UpdateColumnStatisticsForTable tindakan (Python: update_column_statistics_for_table)
Menciptakan atau memperbarui statistik tabel kolom.
Izin Identity and Access Management (IAM) yang diperlukan untuk operasi ini adalah UpdateTable.
Permintaan
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID Katalog Data tempat partisi yang dimaksud berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
-
DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama basis data katalog tempat partisi berada.
-
TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama tabel partisi.
-
ColumnStatisticsList— Wajib: Susunan objek ColumnStatistics, tidak lebih dari 25 struktur.Daftar statistik kolom.
Respons
-
Errors– Susunan objek ColumnStatisticsError.Daftar ColumnStatisticsErrors.
Kesalahan
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionException
DeleteColumnStatisticsForTable tindakan (Python: delete_column_statistics_for_table)
Mengambil statistik tabel kolom.
Izin Identity and Access Management (IAM) yang diperlukan untuk operasi ini adalah DeleteTable.
Permintaan
-
CatalogId— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID Katalog Data tempat partisi yang dimaksud berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
-
DatabaseName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama basis data katalog tempat partisi berada.
-
TableName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama tabel partisi.
-
ColumnName- Diperlukan: UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok denganSingle-line string pattern.Nama kolom.
Respons
Tidak ada parameter Respons.
Kesalahan
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionGlueEncryptionException