Pengoptimal tabel API - AWS Glue
 —  tipe data  —TableOptimizerTableOptimizerConfigurationTableOptimizerRunBatchGetTableOptimizerEntryBatchTableOptimizerBatchGetTableOptimizerErrorRunMetrics —  operasi  —GetTableOptimizer (get_table_optimizer)BatchGetTableOptimizer (batch_get_table_optimizer)ListTableOptimizerRuns (list_table_optimizer_runs)CreateTableOptimizer (create_table_optimizer)DeleteTableOptimizer (delete_table_optimizer)UpdateTableOptimizer (update_table_optimizer)

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

Pengoptimal tabel API

Pengoptimal tabel API menjelaskan cara mengaktifkan pemadatan AWS Glue API untuk meningkatkan kinerja baca.

Jenis data

TableOptimizer struktur

Berisi rincian tentang pengoptimal yang terkait dengan tabel.

Bidang

  • type— UTF -8 string (nilai valid:compaction="COMPACTION").

    Jenis pengoptimal tabel. Saat ini, satu-satunya nilai yang valid adalahcompaction.

  • 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- UTF -8 string, tidak kurang dari 1 atau lebih dari 512 byte panjang, 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.

TableOptimizerRun struktur

Berisi detail untuk menjalankan pengoptimal tabel.

Bidang

  • eventType— UTF -8 string (nilai 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.

  • error— UTF -8 string.

    Kesalahan yang terjadi selama pengoptimal dijalankan.

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— UTF -8 string, setidaknya 1 byte panjang.

    Nama basis data dalam katalog tempat tabel berada.

  • tableName— UTF -8 string, setidaknya 1 byte panjang.

    Nama tabel.

  • type— UTF -8 string (nilai valid:compaction="COMPACTION").

    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— UTF -8 string, setidaknya 1 byte panjang.

    Nama basis data dalam katalog tempat tabel berada.

  • tableName— UTF -8 string, 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— UTF -8 string, setidaknya 1 byte panjang.

    Nama basis data dalam katalog tempat tabel berada.

  • tableName— UTF -8 string, setidaknya 1 byte panjang.

    Nama tabel.

  • type— UTF -8 string (nilai valid:compaction="COMPACTION").

    Jenis pengoptimal tabel.

RunMetrics struktur

Metrik untuk menjalankan pengoptimal.

Bidang

  • NumberOfBytesCompacted— UTF -8 string.

    Jumlah byte yang dihapus oleh pekerjaan pemadatan dijalankan.

  • NumberOfFilesCompacted— UTF -8 string.

    Jumlah file yang dihapus oleh pekerjaan pemadatan dijalankan.

  • NumberOfDpus— UTF -8 string.

    Jumlah DPU jam yang dikonsumsi oleh pekerjaan.

  • JobDurationInHour— UTF -8 string.

    Durasi pekerjaan dalam jam.

Operasi

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 pattern

    ID Katalog tabel.

  • DatabaseName- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string pattern

    Nama basis data dalam katalog tempat tabel berada.

  • TableName- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string pattern

    Nama tabel.

  • Type- Diperlukan: UTF -8 string (nilai valid:compaction="COMPACTION").

    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- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string pattern

    Nama basis data dalam katalog tempat tabel berada.

  • TableName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string pattern

    Nama tabel.

  • TableOptimizer — Sebuah objek TableOptimizer.

    Pengoptimal yang terkait dengan tabel yang ditentukan.

Kesalahan

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

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
Kesalahan

  • InternalServiceException

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 pattern

    ID Katalog tabel.

  • DatabaseName- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string pattern

    Nama basis data dalam katalog tempat tabel berada.

  • TableName- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string pattern

    Nama tabel.

  • Type- Diperlukan: UTF -8 string (nilai valid:compaction="COMPACTION").

    Jenis pengoptimal tabel. Saat ini, satu-satunya nilai yang valid adalahcompaction.

  • MaxResults — Nomor (bilangan bulat).

    Jumlah maksimum pengoptimal berjalan untuk kembali pada setiap panggilan.

  • NextToken— UTF -8 string.

    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- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string pattern

    Nama basis data dalam katalog tempat tabel berada.

  • TableName- UTF -8 string, tidak kurang dari 1 atau lebih dari 255 byte panjang, cocok dengan. Single-line string pattern

    Nama tabel.

  • NextToken— UTF -8 string.

    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

  • InternalServiceException

CreateTableOptimizer tindakan (Python: create_table_optimizer)

Membuat pengoptimal tabel baru untuk fungsi tertentu. compactionadalah satu-satunya jenis pengoptimal yang didukung saat ini.

Permintaan

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

    ID Katalog tabel.

  • DatabaseName- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string pattern

    Nama basis data dalam katalog tempat tabel berada.

  • TableName- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string pattern

    Nama tabel.

  • Type- Diperlukan: UTF -8 string (nilai valid:compaction="COMPACTION").

    Jenis pengoptimal tabel. Saat ini, satu-satunya nilai yang valid adalahcompaction.

  • TableOptimizerConfiguration — Wajib: Sebuah objek TableOptimizerConfiguration.

    Sebuah TableOptimizerConfiguration objek yang mewakili konfigurasi pengoptimal tabel.

Respons

  • Tidak ada parameter Respons.

Kesalahan

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • AlreadyExistsException

  • InternalServiceException

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 pattern

    ID Katalog tabel.

  • DatabaseName- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string pattern

    Nama basis data dalam katalog tempat tabel berada.

  • TableName- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string pattern

    Nama tabel.

  • Type- Diperlukan: UTF -8 string (nilai valid:compaction="COMPACTION").

    Jenis pengoptimal tabel.

Respons

  • Tidak ada parameter Respons.

Kesalahan

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

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 pattern

    ID Katalog tabel.

  • DatabaseName- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan file. Single-line string pattern

    Nama basis data dalam katalog tempat tabel berada.

  • TableName- Diperlukan: UTF -8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan. Single-line string pattern

    Nama tabel.

  • Type- Diperlukan: UTF -8 string (nilai valid:compaction="COMPACTION").

    Jenis pengoptimal tabel. Saat ini, satu-satunya nilai yang valid adalahcompaction.

  • TableOptimizerConfiguration — Wajib: Sebuah objek TableOptimizerConfiguration.

    Sebuah TableOptimizerConfiguration objek yang mewakili konfigurasi pengoptimal tabel.

Respons

  • Tidak ada parameter Respons.

Kesalahan

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException