API pengoptimal tabel - AWS Glue

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.

    TableOptimizerConfigurationObjek 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 pattern

    Peran 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.

    TableOptimizerVpcConfigurationObjek 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.

    RunMetricsObjek 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.

    CompactionMetricsObjek yang berisi metrik untuk menjalankan pengoptimal.

  • retentionMetrics — Sebuah objek RetentionMetrics.

    RetentionMetricsObjek yang berisi metrik untuk menjalankan pengoptimal.

  • orphanFileDeletionMetrics — Sebuah objek OrphanFileDeletionMetrics.

    OrphanFileDeletionMetricsObjek 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.

    TableOptimizerObjek 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.

    ErrorDetailObjek 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

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

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

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

GetTableOptimizer tindakan (Python: get_table_optimizer)

Mengembalikan konfigurasi semua pengoptimal yang terkait dengan tabel tertentu.

Permintaan
  • CatalogIdWajib: String id katalog, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string pattern

    ID Katalog tabel.

  • DatabaseNameWajib: 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.

  • TableNameWajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama tabel.

  • TypeWajib: 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
  • EntriesWajib: Susunan objek BatchGetTableOptimizerEntry.

    Daftar BatchGetTableOptimizerEntry objek yang menentukan pengoptimal tabel untuk mengambil.

Respons
Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

  • ThrottlingException

ListTableOptimizerRuns tindakan (Python: list_table_optimizer_runs)

Daftar riwayat pengoptimal sebelumnya berjalan untuk tabel tertentu.

Permintaan
  • CatalogIdWajib: String id katalog, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string pattern

    ID Katalog tabel.

  • DatabaseNameWajib: 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.

  • TableNameWajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama tabel.

  • TypeWajib: 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
  • CatalogIdWajib: String id katalog, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string pattern

    ID Katalog tabel.

  • DatabaseNameWajib: 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.

  • TableNameWajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama tabel.

  • TypeWajib: String UTF-8 (nilai yang valid: compaction="COMPACTION" | retention="RETENTION" | orphan_file_deletion="ORPHAN_FILE_DELETION").

    Jenis pengoptimal tabel.

  • TableOptimizerConfigurationWajib: 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
  • CatalogIdWajib: String id katalog, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string pattern

    ID Katalog tabel.

  • DatabaseNameWajib: 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.

  • TableNameWajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama tabel.

  • TypeWajib: 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
  • CatalogIdWajib: String id katalog, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string pattern

    ID Katalog tabel.

  • DatabaseNameWajib: 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.

  • TableNameWajib: String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan Single-line string pattern.

    Nama tabel.

  • TypeWajib: String UTF-8 (nilai yang valid: compaction="COMPACTION" | retention="RETENTION" | orphan_file_deletion="ORPHAN_FILE_DELETION").

    Jenis pengoptimal tabel.

  • TableOptimizerConfigurationWajib: Sebuah objek TableOptimizerConfiguration.

    Sebuah TableOptimizerConfiguration objek yang mewakili konfigurasi pengoptimal tabel.

Respons
  • Tidak ada parameter Respons.

Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • ValidationException

  • InternalServiceException

  • ThrottlingException

  • ConcurrentModificationException