Pemicu - AWS Glue

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

Pemicu

Pemicu API menjelaskan tipe data dan API terkait dengan membuat, memperbarui, atau menghapus, dan memulai dan menghentikan pemicu pekerjaan. AWS Glue

Jenis data

Struktur pemicu

Informasi tentang sebuah pemicu tertentu.

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

    Nama pemicu.

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

    Nama alur kerja yang dikaitkan dengan pemicu.

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

    Terpesan untuk digunakan di masa mendatang.

  • Type— UTF -8 string (nilai valid: SCHEDULED | | CONDITIONAL ON_DEMAND |EVENT).

    Jenis pemicu yang ini.

  • State— UTF -8 string (nilai yang valid: CREATING CREATED | ACTIVATING | ACTIVATED | DEACTIVATING | DEACTIVATED DELETING |UPDATING).

    Status pemicu saat ini.

  • Description — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Deskripsi pemicu ini.

  • Schedule— UTF -8 string.

    Sebuah ekspresi cron yang digunakan untuk menentukan jadwal (lihat Jadwal Berbasis Waktu untuk Tugas dan Crawler. Misalnya, untuk menjalankan sesuatu setiap hari pada pukul 12:15UTC, Anda akan menentukan:cron(15 12 * * ? *).

  • Actions – Susunan objek Tindakan.

    Tindakan yang dimulai oleh pemicu ini.

  • Predicate — Sebuah objek Predikat.

    Predikat pemicu ini, yang menentukan kapan akan aktif.

  • EventBatchingCondition — Sebuah objek EventBatchingCondition.

    Kondisi batch yang harus dipenuhi (jumlah peristiwa tertentu yang diterima atau jendela waktu batch kedaluwarsa) sebelum pemicu EventBridge peristiwa terjadi kebakaran.

TriggerUpdate struktur

Struktur yang digunakan untuk memberikan informasi yang digunakan untuk memperbarui sebuah pemicu. Objek ini memperbarui definisi pemicu sebelumnya dengan menimpa semuanya.

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

    Terpesan untuk digunakan di masa mendatang.

  • Description — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Deskripsi pemicu ini.

  • Schedule— UTF -8 string.

    Sebuah ekspresi cron yang digunakan untuk menentukan jadwal (lihat Jadwal Berbasis Waktu untuk Tugas dan Crawler. Misalnya, untuk menjalankan sesuatu setiap hari pada pukul 12:15UTC, Anda akan menentukan:cron(15 12 * * ? *).

  • Actions – Susunan objek Tindakan.

    Tindakan yang dimulai oleh pemicu ini.

  • Predicate — Sebuah objek Predikat.

    Predikat pemicu ini, yang menentukan kapan akan aktif.

  • EventBatchingCondition — Sebuah objek EventBatchingCondition.

    Kondisi batch yang harus dipenuhi (jumlah peristiwa tertentu yang diterima atau jendela waktu batch kedaluwarsa) sebelum pemicu EventBridge peristiwa terjadi kebakaran.

Struktur predikat

Menentukan predikat pemicu, yang menentukan kapan terjadi inisiasi.

Bidang
  • Logical— UTF -8 string (nilai valid: AND |ANY).

    Bidang opsional hanya jika satu kondisi tercantum. Jika beberapa kondisi tercantum, bidang ini diperlukan.

  • Conditions – Susunan objek Syarat.

    Daftar syarat yang menentukan kapan pemicu akan aktif.

Struktur kondisi

Menentukan kondisi yang memicu inisiasi.

Bidang
  • LogicalOperator— UTF -8 string (nilai valid:EQUALS).

    Operator logika.

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

    Nama tugas yang JobRuns kondisi ini berlaku, dan tempat pemicu ini menunggu.

  • State— UTF -8 string (nilai valid: STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT | ERROR WAITING |EXPIRED).

    Status syarat. Saat ini, satu-satunya status tugas yang didengarkan oleh pemicu adalah SUCCEEDED, STOPPED, FAILED, dan TIMEOUT. Satu-satunya status crawler yang didengarkan oleh pemicu adalah SUCCEEDED, FAILED, dan CANCELLED.

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

    Nama crawler tempat kondisi ini berlaku.

  • CrawlState— UTF -8 string (nilai valid: RUNNING | CANCELLING | CANCELLED | SUCCEEDED FAILED |ERROR).

    Status crawler yang berlaku syarat ini padanya.

Struktur aksi

Menentukan tindakan yang dimulai oleh pemicu.

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

    Nama tugas yang akan dijalankan.

  • Arguments – Susunan peta pasangan nilai kunci.

    Setiap kunci adalah string UTF -8.

    Setiap nilai adalah string UTF -8.

    Argumen tugas yang digunakan saat pemicu ini aktif. Agar tugas ini berjalan, argumen default yang diatur dalam ketentuan tugas itu sendiri diganti.

    Anda dapat menentukan argumen di sini yang digunakan skrip eksekusi pekerjaan Anda sendiri, serta argumen yang AWS Glue dikonsumsi sendiri.

    Untuk informasi tentang cara menentukan dan menggunakan argumen Job Anda sendiri, lihat topik Memanggil AWS Glue APIs dengan Python di panduan pengembang.

    Untuk informasi tentang pasangan kunci-nilai yang AWS Glue digunakan untuk menyiapkan pekerjaan Anda, lihat Parameter Khusus yang Digunakan menurut AWS Glue topik dalam panduan pengembang.

  • Timeout — Nomor (bilangan bulat), minimal 1.

    Waktu habis JobRun, dalam satuan menit. Ini adalah waktu maksimum yang bisa digunakan oleh eksekusi tugas untuk menggunakan sumber daya sebelum eksekusi dihentikan dan memasuki status TIMEOUT. Nilai default-nya adalah 2.880 menit (48 jam). Ini menimpa nilai waktu habis yang diatur dalam tugas induk.

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

    Nama struktur SecurityConfiguration yang akan digunakan dengan tindakan ini.

  • NotificationProperty — Sebuah objek NotificationProperty.

    Menentukan properti konfigurasi dari sebuah notifikasi eksekusi tugas.

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

    Nama crawler yang akan digunakan dengan tindakan ini.

EventBatchingCondition struktur

Kondisi batch yang harus dipenuhi (jumlah peristiwa tertentu yang diterima atau jendela waktu batch kedaluwarsa) sebelum pemicu EventBridge peristiwa terjadi kebakaran.

Bidang
  • BatchSizeWajib: Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100.

    Jumlah peristiwa yang harus diterima dari Amazon EventBridge sebelum EventBridge peristiwa memicu kebakaran.

  • BatchWindow — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 900.

    Jendela waktu dalam hitungan detik setelah EventBridge peristiwa memicu kebakaran. Jendela dimulai ketika peristiwa pertama diterima.

Operasi

CreateTrigger tindakan (Python: create_trigger)

Menciptakan sebuah pemicu baru.

Argumen Job dapat dicatat. Jangan berikan rahasia plaintext sebagai argumen. Ambil rahasia dari AWS Glue Connection, AWS Secrets Manager atau mekanisme manajemen rahasia lainnya jika Anda ingin menyimpannya dalam Job.

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

    Nama pemicu.

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

    Nama alur kerja yang dikaitkan dengan pemicu.

  • Type- Diperlukan: UTF -8 string (nilai valid: SCHEDULED | | CONDITIONAL ON_DEMAND |EVENT).

    Jenis pemicu baru.

  • Schedule— UTF -8 string.

    Sebuah ekspresi cron yang digunakan untuk menentukan jadwal (lihat Jadwal Berbasis Waktu untuk Tugas dan Crawler. Misalnya, untuk menjalankan sesuatu setiap hari pada pukul 12:15UTC, Anda akan menentukan:cron(15 12 * * ? *).

    Bidang ini wajib ketika jenis pemicu-nya adalah SCHEDULED.

  • Predicate — Sebuah objek Predikat.

    Sebuah predikat untuk menentukan kapan pemicu baru harus aktif.

    Bidang ini wajib ketika jenis pemicu-nya adalah CONDITIONAL.

  • ActionsWajib: Susunan objek Tindakan.

    Tindakan yang dimulai oleh pemicu ini saat pemicu tersebut aktif.

  • Description — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan URI address multi-line string pattern.

    Sebuah deskripsi dari pemicu baru.

  • StartOnCreation – Boolean.

    Atur ke true untuk memulai pemicu SCHEDULED dan CONDITIONAL ketika dibuat. BETUL tidak didukung untuk pemicu ON_DEMAND.

  • Tags — Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 50 pasang.

    Setiap kunci adalah string UTF -8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.

    Setiap nilai adalah string UTF -8, panjangnya tidak lebih dari 256 byte.

    Tag yang akan digunakan dengan pemicu ini. Anda dapat menggunakan tag untuk membatasi akses ke pemicu tersebut. Untuk informasi selengkapnya tentang AWS tag AWS Glue, lihat Tag AWS Glue di panduan pengembang.

  • EventBatchingCondition — Sebuah objek EventBatchingCondition.

    Kondisi batch yang harus dipenuhi (jumlah peristiwa tertentu yang diterima atau jendela waktu batch kedaluwarsa) sebelum pemicu EventBridge peristiwa terjadi kebakaran.

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

    Nama pemicu.

Kesalahan
  • AlreadyExistsException

  • EntityNotFoundException

  • InvalidInputException

  • IdempotentParameterMismatchException

  • InternalServiceException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

StartTrigger tindakan (Python: start_trigger)

Memulai pemicu yang ada. Lihat Memicu Tugas untuk informasi tentang bagaimana berbagai jenis pemicu dimulai.

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

    Nama pemicu yang akan dimulai.

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

    Nama pemicu yang sudah dimulai.

Kesalahan
  • InvalidInputException

  • InternalServiceException

  • EntityNotFoundException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentRunsExceededException

GetTrigger tindakan (Python: get_trigger)

Mengambil definisi dari sebuah pemicu.

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

    Nama pemicu yang akan diambil.

Respons
  • Trigger — Sebuah objek Pemicu.

    Definisi pemicu yang diminta.

Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

GetTriggers tindakan (Python: get_trigger)

Mendapatkan semua pemicu yang dikaitkan dengan sebuah tugas.

Permintaan
  • NextToken— UTF -8 string.

    Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan.

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

    Nama tugas yang untuknya pemicu akan diambil. Pemicu yang dapat memulai tugas ini dikembalikan, dan jika tidak ada pemicu seperti itu, maka semua pemicu dikembalikan.

  • MaxResults— Angka (bilangan bulat), tidak kurang dari 1 atau lebih dari 200.

    Ukuran maksimum respons.

Respons
  • Triggers – Susunan objek Pemicu.

    Daftar pemicu untuk tugas yang ditentukan.

  • NextToken— UTF -8 string.

    Sebuah token kelanjutan, jika bukan semua pemicu yang diminta yang belum dikembalikan.

Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

UpdateTrigger tindakan (Python: update_trigger)

Memperbarui sebuah definisi pemicu.

Argumen Job dapat dicatat. Jangan berikan rahasia plaintext sebagai argumen. Ambil rahasia dari AWS Glue Connection, AWS Secrets Manager atau mekanisme manajemen rahasia lainnya jika Anda ingin menyimpannya dalam Job.

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

    Nama pemicu yang akan diperbarui.

  • TriggerUpdateWajib: Sebuah objek TriggerUpdate.

    Nilai-nilai baru yang digunakan untuk memperbarui pemicu.

Respons
  • Trigger — Sebuah objek Pemicu.

    Definisi pemicu yang dihasilkan.

Kesalahan
  • InvalidInputException

  • InternalServiceException

  • EntityNotFoundException

  • OperationTimeoutException

  • ConcurrentModificationException

StopTrigger tindakan (Python: stop_trigger)

Menghentikan pemicu tertentu.

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

    Nama pemicu yang akan dihentikan.

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

    Nama pemicu yang sudah dihentikan.

Kesalahan
  • InvalidInputException

  • InternalServiceException

  • EntityNotFoundException

  • OperationTimeoutException

  • ConcurrentModificationException

DeleteTrigger tindakan (Python: delete_trigger)

Menghapus pemicu tertentu. Jika pemicu tidak ditemukan, tidak ada pengecualian yang dibuang.

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

    Nama pemicu yang akan dihapus.

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

    Nama pemicu yang sudah dihapus.

Kesalahan
  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ConcurrentModificationException

ListTriggers tindakan (Python: list_trigger)

Mengambil nama semua sumber daya pemicu di AWS akun ini, atau sumber daya dengan tag yang ditentukan. Operasi ini memungkinkan Anda melihat sumber daya yang tersedia di akun Anda, dan nama-namanya.

Operasi ini mengambil kolom Tags opsional, yang dapat Anda gunakan sebagai filter pada respon sehingga tag sumber daya dapat diambil sebagai sebuah grup. Jika Anda memilih untuk menggunakan pem-filter-an tag, maka hanya sumber daya dengan tag saja yang diambil.

Permintaan
  • NextToken— UTF -8 string.

    Sebuah token kelanjutan, jika ini adalah permintaan kelanjutan.

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

    Nama tugas yang untuknya pemicu akan diambil. Pemicu yang dapat memulai tugas ini dikembalikan. Jika tidak ada pemicu seperti itu, maka semua pemicu dikembalikan.

  • MaxResults— Angka (bilangan bulat), tidak kurang dari 1 atau lebih dari 200.

    Ukuran maksimum daftar yang akan dikembalikan.

  • Tags — Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 50 pasang.

    Setiap kunci adalah string UTF -8, panjangnya tidak kurang dari 1 atau lebih dari 128 byte.

    Setiap nilai adalah string UTF -8, panjangnya tidak lebih dari 256 byte.

    Menentukan untuk mengembalikan hanya sumber daya ditandai saja.

Respons
  • TriggerNames— Sebuah array UTF -8 string.

    Nama dari semua pemicu dalam akun, atau pemicu dengan tag yang ditentukan.

  • NextToken— UTF -8 string.

    Sebuah token kelanjutan, jika daftar yang dikembalikan tidak berisi metrik terakhir yang tersedia.

Kesalahan
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

BatchGetTriggers tindakan (Python: batch_get_trigger)

Mengembalikan daftar metadata sumber daya untuk daftar nama pemicu tertentu. Setelah memanggil operasi ListTriggers, Anda dapat memanggil operasi ini untuk mengakses data yang Anda telah diberikan izinnya. Operasi ini mendukung semua IAM izin, termasuk kondisi izin yang menggunakan tag.

Permintaan
  • TriggerNamesDiperlukan: Sebuah array UTF -8 string.

    Daftar nama pemicu, mungkin nama yang dikembalikan dari operasi ListTriggers.

Respons
  • Triggers – Susunan objek Pemicu.

    Daftar definisi pemicu.

  • TriggersNotFound— Sebuah array UTF -8 string.

    Daftar nama pemicu yang tidak ditemukan.

Kesalahan
  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException