Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
API pengoptimal tabel
API pengoptimal tabel menjelaskan AWS Glue API untuk mengaktifkan pemadatan guna meningkatkan kinerja baca.
Jenis data
TableOptimizer struktur
Berisi rincian tentang pengoptimal yang terkait dengan tabel.
Bidang
-
type
– String UTF-8 (nilai yang valid:compaction="COMPACTION"
|retention="RETENTION"
|orphan_file_deletion="ORPHAN_FILE_DELETION"
).Jenis pengoptimal tabel. Nilai yang valid adalah:
-
compaction
: untuk mengelola pemadatan dengan pengoptimal tabel. -
retention
: untuk mengelola retensi snapshot dengan pengoptimal tabel. -
orphan_file_deletion
: untuk mengelola penghapusan file yatim piatu dengan pengoptimal tabel.
-
-
configuration
— Sebuah objek TableOptimizerConfiguration.TableOptimizerConfiguration
Objek yang ditentukan saat membuat atau memperbarui pengoptimal tabel. -
lastRun
— Sebuah objek TableOptimizerRun.Sebuah
TableOptimizerRun
objek yang mewakili run terakhir dari pengoptimal tabel.
TableOptimizerConfiguration struktur
Berisi detail tentang konfigurasi pengoptimal tabel. Anda meneruskan konfigurasi ini saat membuat atau memperbarui pengoptimal tabel.
Bidang
-
roleArn
— String UTF-8, panjangnya tidak kurang dari 20 atau lebih dari 2048 byte, cocok dengan. Single-line string patternPeran yang diteruskan oleh pemanggil yang memberikan izin layanan untuk memperbarui sumber daya yang terkait dengan pengoptimal atas nama pemanggil.
-
enabled
– Boolean.Apakah optimasi tabel diaktifkan.
-
vpcConfiguration
— Sebuah objek TableOptimizerVpcConfiguration.TableOptimizerVpcConfiguration
Objek yang mewakili konfigurasi VPC untuk pengoptimal tabel.Konfigurasi ini diperlukan untuk melakukan optimasi pada tabel yang ada di VPC pelanggan.
-
retentionConfiguration
— Sebuah objek RetentionConfiguration.Konfigurasi untuk pengoptimal retensi snapshot.
-
orphanFileDeletionConfiguration
— Sebuah objek OrphanFileDeletionConfiguration.Konfigurasi untuk pengoptimal penghapusan file yatim piatu.
TableOptimizerVpcConfiguration struktur
Objek yang menjelaskan konfigurasi VPC untuk pengoptimal tabel.
Konfigurasi ini diperlukan untuk melakukan optimasi pada tabel yang ada di VPC pelanggan.
Bidang
-
glueConnectionName
— String UTF-8, setidaknya 1 byte panjang.Nama AWS Glue koneksi yang digunakan untuk VPC untuk pengoptimal tabel.
TableOptimizerRun struktur
Berisi detail untuk menjalankan pengoptimal tabel.
Bidang
-
eventType
– String UTF-8 (nilai yang valid:starting="STARTING"
|completed="COMPLETED"
|failed="FAILED"
|in_progress="IN_PROGRESS"
).Jenis peristiwa yang mewakili status menjalankan pengoptimal tabel.
-
startTimestamp
— Stempel waktu.Merupakan stempel waktu zaman di mana pekerjaan pemadatan dimulai dalam Lake Formation.
-
endTimestamp
— Stempel waktu.Merupakan stempel waktu zaman di mana pekerjaan pemadatan berakhir.
-
metrics
— Sebuah objek RunMetrics.RunMetrics
Objek yang berisi metrik untuk menjalankan pengoptimal.Anggota ini tidak digunakan lagi. Lihat anggota metrik individu untuk pemadatan, retensi, dan penghapusan file yatim piatu.
-
error
– String UTF-8.Kesalahan yang terjadi selama pengoptimal dijalankan.
-
compactionMetrics
— Sebuah objek CompactionMetrics.CompactionMetrics
Objek yang berisi metrik untuk menjalankan pengoptimal. -
retentionMetrics
— Sebuah objek RetentionMetrics.RetentionMetrics
Objek yang berisi metrik untuk menjalankan pengoptimal. -
orphanFileDeletionMetrics
— Sebuah objek OrphanFileDeletionMetrics.OrphanFileDeletionMetrics
Objek yang berisi metrik untuk menjalankan pengoptimal.
BatchGetTableOptimizerEntry struktur
Merupakan pengoptimal tabel untuk mengambil dalam operasi. BatchGetTableOptimizer
Bidang
-
catalogId
— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID Katalog tabel.
-
databaseName
— String UTF-8, setidaknya 1 byte panjang.Nama basis data dalam katalog tempat tabel berada.
-
tableName
— String UTF-8, setidaknya 1 byte panjang.Nama tabel.
-
type
– String UTF-8 (nilai yang valid:compaction="COMPACTION"
|retention="RETENTION"
|orphan_file_deletion="ORPHAN_FILE_DELETION"
).Jenis pengoptimal tabel.
BatchTableOptimizer struktur
Berisi detail untuk salah satu pengoptimal tabel yang dikembalikan oleh operasi. BatchGetTableOptimizer
Bidang
-
catalogId
— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID Katalog tabel.
-
databaseName
— String UTF-8, setidaknya 1 byte panjang.Nama basis data dalam katalog tempat tabel berada.
-
tableName
— String UTF-8, setidaknya 1 byte panjang.Nama tabel.
-
tableOptimizer
— Sebuah objek TableOptimizer.TableOptimizer
Objek yang berisi detail tentang konfigurasi dan proses terakhir dari pengoptimal tabel.
BatchGetTableOptimizerError struktur
Berisi rincian tentang salah satu kesalahan dalam daftar kesalahan yang dikembalikan oleh BatchGetTableOptimizer
operasi.
Bidang
-
error
— Sebuah objek ErrorDetail.ErrorDetail
Objek yang berisi kode dan rincian pesan tentang kesalahan. -
catalogId
— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID Katalog tabel.
-
databaseName
— String UTF-8, setidaknya 1 byte panjang.Nama basis data dalam katalog tempat tabel berada.
-
tableName
— String UTF-8, setidaknya 1 byte panjang.Nama tabel.
-
type
– String UTF-8 (nilai yang valid:compaction="COMPACTION"
|retention="RETENTION"
|orphan_file_deletion="ORPHAN_FILE_DELETION"
).Jenis pengoptimal tabel.
RetentionConfiguration struktur
Konfigurasi untuk pengoptimal retensi snapshot.
Bidang
-
icebergConfiguration
— Sebuah objek IcebergRetentionConfiguration.Konfigurasi untuk pengoptimal retensi snapshot Iceberg.
IcebergRetentionConfiguration struktur
Konfigurasi untuk pengoptimal retensi snapshot Iceberg.
Bidang
-
snapshotRetentionPeriodInDays
— Nomor (bilangan bulat).Jumlah hari untuk mempertahankan snapshot Iceberg. Jika input tidak disediakan, bidang konfigurasi tabel Iceberg yang sesuai akan digunakan atau jika tidak ada, nilai default 5 akan digunakan.
-
numberOfSnapshotsToRetain
— Nomor (bilangan bulat).Jumlah snapshot Gunung Es yang akan disimpan dalam periode retensi. Jika input tidak disediakan, bidang konfigurasi tabel Iceberg yang sesuai akan digunakan atau jika tidak ada, nilai default 1 akan digunakan.
-
cleanExpiredFiles
– Boolean.Jika disetel ke false, snapshot hanya dihapus dari metadata tabel, dan data dan file metadata yang mendasarinya tidak dihapus.
OrphanFileDeletionConfiguration struktur
Konfigurasi untuk pengoptimal penghapusan file yatim piatu.
Bidang
-
icebergConfiguration
— Sebuah objek IcebergOrphanFileDeletionConfiguration.Konfigurasi untuk pengoptimal penghapusan file yatim Iceberg.
IcebergOrphanFileDeletionConfiguration struktur
Konfigurasi untuk pengoptimal penghapusan file yatim Iceberg.
Bidang
-
orphanFileRetentionPeriodInDays
— Nomor (bilangan bulat).Jumlah hari file yatim piatu harus disimpan sebelum penghapusan file. Jika input tidak disediakan, nilai default 3 akan digunakan.
-
location
– String UTF-8.Menentukan direktori di mana untuk mencari file (default ke lokasi tabel). Anda dapat memilih sub-direktori daripada lokasi tabel tingkat atas.
CompactionMetrics struktur
Struktur yang berisi metrik pemadatan untuk menjalankan pengoptimal.
Bidang
-
IcebergMetrics
— Sebuah objek IcebergCompactionMetrics.Struktur yang berisi metrik pemadatan Iceberg untuk menjalankan pengoptimal.
RetentionMetrics struktur
Struktur yang berisi metrik retensi untuk menjalankan pengoptimal.
Bidang
-
IcebergMetrics
— Sebuah objek IcebergRetentionMetrics.Struktur yang berisi metrik retensi Gunung Es untuk menjalankan pengoptimal.
OrphanFileDeletionMetrics struktur
Struktur yang berisi metrik penghapusan file yatim piatu untuk menjalankan pengoptimal.
Bidang
-
IcebergMetrics
— Sebuah objek IcebergOrphanFileDeletionMetrics.Struktur yang berisi metrik penghapusan file yatim Iceberg untuk menjalankan pengoptimal.
IcebergCompactionMetrics struktur
Metrik pemadatan untuk Iceberg untuk menjalankan pengoptimal.
Bidang
-
NumberOfDpus
— Nomor (Integer).Jumlah jam DPU yang dikonsumsi oleh pekerjaan.
-
JobDurationInHour
— Nomor (ganda).Durasi pekerjaan dalam jam.
IcebergRetentionMetrics struktur
Metrik retensi snapshot untuk Iceberg untuk menjalankan pengoptimal.
Bidang
-
NumberOfDpus
— Nomor (Integer).Jumlah jam DPU yang dikonsumsi oleh pekerjaan.
-
JobDurationInHour
— Nomor (ganda).Durasi pekerjaan dalam jam.
IcebergOrphanFileDeletionMetrics struktur
Metrik penghapusan file yatim piatu untuk Iceberg untuk menjalankan pengoptimal.
Bidang
-
NumberOfDpus
— Nomor (Integer).Jumlah jam DPU yang dikonsumsi oleh pekerjaan.
-
JobDurationInHour
— Nomor (ganda).Durasi pekerjaan dalam jam.
RunMetrics struktur
Metrik untuk menjalankan pengoptimal.
Struktur ini sudah usang. Lihat anggota metrik individu untuk pemadatan, retensi, dan penghapusan file yatim piatu.
Bidang
-
NumberOfBytesCompacted
– String UTF-8.Jumlah byte yang dihapus oleh pekerjaan pemadatan dijalankan.
-
NumberOfFilesCompacted
– String UTF-8.Jumlah file yang dihapus oleh pekerjaan pemadatan dijalankan.
-
NumberOfDpus
– String UTF-8.Jumlah jam DPU yang dikonsumsi oleh pekerjaan.
-
JobDurationInHour
– String UTF-8.Durasi pekerjaan dalam jam.
Operasi
BatchGetTableOptimizer tindakan (Python: batch_get_table_optimizer)
ListTableOptimizerRuns tindakan (Python: list_table_optimizer_runs)
CreateTableOptimizer tindakan (Python: create_table_optimizer)
DeleteTableOptimizer tindakan (Python: delete_table_optimizer)
UpdateTableOptimizer tindakan (Python: update_table_optimizer)
GetTableOptimizer tindakan (Python: get_table_optimizer)
Mengembalikan konfigurasi semua pengoptimal yang terkait dengan tabel tertentu.
Permintaan
-
CatalogId
— Wajib: String id katalog, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string patternID Katalog tabel.
-
DatabaseName
— Wajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.Nama basis data dalam katalog tempat tabel berada.
-
TableName
— Wajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.Nama tabel.
-
Type
– Wajib: String UTF-8 (nilai yang valid:compaction="COMPACTION"
|retention="RETENTION"
|orphan_file_deletion="ORPHAN_FILE_DELETION"
).Jenis pengoptimal tabel.
Respons
-
CatalogId
— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID Katalog tabel.
-
DatabaseName
— String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.Nama basis data dalam katalog tempat tabel berada.
-
TableName
— String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.Nama tabel.
-
TableOptimizer
— Sebuah objek TableOptimizer.Pengoptimal yang terkait dengan tabel yang ditentukan.
Kesalahan
EntityNotFoundException
InvalidInputException
AccessDeniedException
InternalServiceException
ThrottlingException
BatchGetTableOptimizer tindakan (Python: batch_get_table_optimizer)
Mengembalikan konfigurasi untuk pengoptimal tabel tertentu.
Permintaan
-
Entries
– Wajib: Susunan objek BatchGetTableOptimizerEntry.Daftar
BatchGetTableOptimizerEntry
objek yang menentukan pengoptimal tabel untuk mengambil.
Respons
-
TableOptimizers
– Susunan objek BatchTableOptimizer.Daftar objek
BatchTableOptimizer
. -
Failures
– Susunan objek BatchGetTableOptimizerError.Daftar kesalahan dari operasi.
Kesalahan
EntityNotFoundException
InvalidInputException
AccessDeniedException
InternalServiceException
ThrottlingException
ListTableOptimizerRuns tindakan (Python: list_table_optimizer_runs)
Daftar riwayat pengoptimal sebelumnya berjalan untuk tabel tertentu.
Permintaan
-
CatalogId
— Wajib: String id katalog, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string patternID Katalog tabel.
-
DatabaseName
— Wajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.Nama basis data dalam katalog tempat tabel berada.
-
TableName
— Wajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.Nama tabel.
-
Type
– Wajib: String UTF-8 (nilai yang valid:compaction="COMPACTION"
|retention="RETENTION"
|orphan_file_deletion="ORPHAN_FILE_DELETION"
).Jenis pengoptimal tabel.
-
MaxResults
— Nomor (bilangan bulat).Jumlah maksimum pengoptimal berjalan untuk kembali pada setiap panggilan.
-
NextToken
– String UTF-8.Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan.
Respons
-
CatalogId
— String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.ID Katalog tabel.
-
DatabaseName
— String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.Nama basis data dalam katalog tempat tabel berada.
-
TableName
— String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.Nama tabel.
-
NextToken
– String UTF-8.Token kelanjutan untuk paginasi daftar pengoptimal yang dikembalikan berjalan, dikembalikan jika segmen daftar saat ini bukan yang terakhir.
-
TableOptimizerRuns
– Susunan objek TableOptimizerRun.Daftar pengoptimal berjalan terkait dengan tabel.
Kesalahan
EntityNotFoundException
AccessDeniedException
InvalidInputException
ValidationException
InternalServiceException
ThrottlingException
CreateTableOptimizer tindakan (Python: create_table_optimizer)
Membuat pengoptimal tabel baru untuk fungsi tertentu.
Permintaan
-
CatalogId
— Wajib: String id katalog, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string patternID Katalog tabel.
-
DatabaseName
— Wajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.Nama basis data dalam katalog tempat tabel berada.
-
TableName
— Wajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.Nama tabel.
-
Type
– Wajib: String UTF-8 (nilai yang valid:compaction="COMPACTION"
|retention="RETENTION"
|orphan_file_deletion="ORPHAN_FILE_DELETION"
).Jenis pengoptimal tabel.
-
TableOptimizerConfiguration
— Wajib: Sebuah objek TableOptimizerConfiguration.Sebuah
TableOptimizerConfiguration
objek yang mewakili konfigurasi pengoptimal tabel.
Respons
Tidak ada parameter Respons.
Kesalahan
EntityNotFoundException
ValidationException
InvalidInputException
AccessDeniedException
AlreadyExistsException
InternalServiceException
ThrottlingException
DeleteTableOptimizer tindakan (Python: delete_table_optimizer)
Menghapus pengoptimal dan semua metadata terkait untuk tabel. Optimalisasi tidak akan lagi dilakukan di atas meja.
Permintaan
-
CatalogId
— Wajib: String id katalog, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string patternID Katalog tabel.
-
DatabaseName
— Wajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.Nama basis data dalam katalog tempat tabel berada.
-
TableName
— Wajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.Nama tabel.
-
Type
– Wajib: String UTF-8 (nilai yang valid:compaction="COMPACTION"
|retention="RETENTION"
|orphan_file_deletion="ORPHAN_FILE_DELETION"
).Jenis pengoptimal tabel.
Respons
Tidak ada parameter Respons.
Kesalahan
EntityNotFoundException
InvalidInputException
AccessDeniedException
InternalServiceException
ThrottlingException
UpdateTableOptimizer tindakan (Python: update_table_optimizer)
Memperbarui konfigurasi untuk pengoptimal tabel yang ada.
Permintaan
-
CatalogId
— Wajib: String id katalog, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string patternID Katalog tabel.
-
DatabaseName
— Wajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.Nama basis data dalam katalog tempat tabel berada.
-
TableName
— Wajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.Nama tabel.
-
Type
– Wajib: String UTF-8 (nilai yang valid:compaction="COMPACTION"
|retention="RETENTION"
|orphan_file_deletion="ORPHAN_FILE_DELETION"
).Jenis pengoptimal tabel.
-
TableOptimizerConfiguration
— Wajib: Sebuah objek TableOptimizerConfiguration.Sebuah
TableOptimizerConfiguration
objek yang mewakili konfigurasi pengoptimal tabel.
Respons
Tidak ada parameter Respons.
Kesalahan
EntityNotFoundException
InvalidInputException
AccessDeniedException
ValidationException
InternalServiceException
ThrottlingException
ConcurrentModificationException