View a markdown version of this page

Pemecahan masalah: DAG, Operator, Koneksi, dan masalah lainnya - Amazon Managed Workflows for Apache Airflow

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

Pemecahan masalah: DAG, Operator, Koneksi, dan masalah lainnya

Topik di halaman ini menjelaskan resolusi untuk dependensi Python Apache Airflow v2 dan v3, plugin khusus, DAG, Operator, Koneksi, tugas, dan masalah server web yang dapat Anda temui di lingkungan Amazon Managed Workflow untuk Apache Airflow.

Koneksi

Topik berikut menjelaskan kesalahan yang mungkin Anda terima saat menggunakan koneksi Apache Airflow, atau menggunakan AWS database lain.

Saya tidak dapat terhubung ke Manajer Rahasia

Kami merekomendasikan langkah-langkah berikut:

  1. Pelajari cara membuat kunci rahasia untuk koneksi dan variabel Apache Airflow Anda diMengkonfigurasi koneksi Apache Airflow menggunakan AWS Secrets Manager Rahasia.

  2. Pelajari cara menggunakan kunci rahasia untuk variabel Apache Airflow (test-variable) diMenggunakan kunci rahasia AWS Secrets Manager untuk variabel Apache Airflow.

  3. Pelajari cara menggunakan kunci rahasia untuk koneksi Apache Airflow (myconn) diMenggunakan kunci rahasia AWS Secrets Manager untuk koneksi Apache Airflow.

Bagaimana cara mengonfigurasi kondisi pengelola > rahasia secretsmanager:ResourceTag/<tag-key atau pembatasan sumber daya dalam kebijakan peran eksekusi saya?

catatan

Berlaku untuk Apache Airflow versi 2.0 dan sebelumnya.

Saat ini, Anda tidak dapat membatasi akses ke rahasia Manajer Rahasia dengan menggunakan kunci kondisi atau pembatasan sumber daya lainnya dalam peran eksekusi lingkungan Anda, karena masalah yang diketahui di Apache Airflow.

Saya tidak dapat terhubung ke Snowflake

Kami merekomendasikan langkah-langkah berikut:

  1. Uji DAG, plugin khusus, dan dependensi Python Anda secara lokal menggunakan aws- mwaa-docker-images on. GitHub

  2. Tambahkan entri berikut ke requirements.txt untuk lingkungan Anda.

    apache-airflow-providers-snowflake==1.3.0
  3. Tambahkan impor berikut ke DAG Anda:

    from airflow.providers.snowflake.operators.snowflake import SnowflakeOperator

Pastikan objek koneksi Apache Airflow menyertakan pasangan kunci-nilai berikut:

  1. Id Konten: snowflake_conn

  2. Jenis Konn: Kepingan Salju

  3. Tuan rumah: <my account>. <my region if not us-west-2>.snowflakecomputing.com

  4. Skema: <my schema>

  5. Masuk: <my user name>

  6. Kata Sandi: ********

  7. Pelabuhan: <port, if any>

  8. Tambahan:

    { "account": "<my account>", "warehouse": "<my warehouse>", "database": "<my database>", "region": "<my region if not using us-west-2 otherwise omit this line>" }

Contoh:

>>> import json >>> from airflow.models.connection import Connection >>> myconn = Connection( ... conn_id='snowflake_conn', ... conn_type='Snowflake', ... host='123456789012.us-east-1.snowflakecomputing.com', ... schema='YOUR_SCHEMA', ... login='YOUR_USERNAME', ... password='YOUR_PASSWORD', ... port='YOUR_PORT', ... extra=json.dumps(dict(account='123456789012', warehouse='YOUR_WAREHOUSE', database='YOUR_DB_OPTION', region='us-east-1')), ... )

Saya tidak dapat menemukan koneksi saya di UI Airflow

Apache Airflow menyediakan template koneksi di Apache Airflow UI. Ini menggunakan ini untuk menghasilkan string URI koneksi, terlepas dari jenis koneksi. Jika template koneksi tidak tersedia di Apache Airflow UI, template koneksi alternatif dapat digunakan untuk menghasilkan string URI koneksi, seperti menggunakan template koneksi HTTP.

Kami merekomendasikan langkah-langkah berikut:

  1. Akses jenis koneksi yang disediakan Amazon MWAA di Apache Airflow UI diPaket penyedia Apache Airflow diinstal di lingkungan Amazon MWAA.

  2. Akses perintah untuk membuat koneksi Apache Airflow di CLI diReferensi perintah Apache Airflow CLI.

  3. Pelajari cara menggunakan templat koneksi di UI Apache Airflow secara bergantian untuk jenis koneksi yang tidak tersedia di UI Apache Airflow di Amazon MWAA di. Ikhtisar jenis koneksi

Webserver

Topik berikut menjelaskan kesalahan yang mungkin Anda terima untuk server web Apache Airflow Anda di Amazon MWAA.

Saya mendapatkan kesalahan 5xx saat mengakses server web

Kami merekomendasikan langkah-langkah berikut:

  1. Periksa opsi konfigurasi Apache Airflow. Pastikan pasangan kunci-nilai yang Anda tentukan sebagai opsi konfigurasi Apache Airflow, seperti AWS Secrets Manager, telah dikonfigurasi dengan benar. Untuk mempelajari lebih lanjut, lihatSaya tidak dapat terhubung ke Manajer Rahasia.

  2. Periksarequirements.txt. Verifikasi paket “ekstra” Airflow dan pustaka lain yang tercantum dalam paket requirements.txt Anda kompatibel dengan versi Apache Airflow Anda.

  3. Jelajahi cara untuk menentukan dependensi Python dalam requirements.txt file, lihat. Mengelola dependensi Python di requirements.txt

Saya mendapatkan penjadwal tampaknya tidak menjalankan kesalahan

Jika penjadwal tampaknya tidak berjalan, atau “detak jantung” terakhir diterima beberapa jam yang lalu, DAG Anda mungkin tidak terdaftar di Apache Airflow, dan tugas baru tidak akan dijadwalkan.

Kami merekomendasikan langkah-langkah berikut:

  1. Konfirmasikan bahwa grup keamanan VPC Anda mengizinkan akses masuk ke port. 5432 Port ini diperlukan untuk terhubung ke database metadata Amazon Aurora PostgreSQL untuk lingkungan Anda. Setelah aturan ini ditambahkan, beri Amazon MWAA beberapa menit, dan kesalahan dapat hilang. Untuk mempelajari lebih lanjut, lihatKeamanan di VPC Anda di Amazon MWAA.

    catatan
    • Metadatabase Aurora PostgreSQL adalah bagian dari arsitektur layanan Amazon MWAA dan tidak tersedia di situs Anda. Akun AWS

    • Database-related kesalahan biasanya merupakan gejala kegagalan penjadwal dan bukan akar penyebabnya.

  2. Jika penjadwal tidak berjalan, itu mungkin karena sejumlah faktor seperti kegagalan instalasi ketergantungan, atau penjadwal yang kelebihan beban. Konfirmasikan bahwa DAG, plugin, dan persyaratan Anda berfungsi dengan benar dengan mengakses grup log yang sesuai di CloudWatch Log. Untuk mempelajari lebih lanjut, lihatPemantauan dan metrik untuk Alur Kerja Terkelola Amazon untuk Apache Airflow.

Tugas

Topik berikut menjelaskan kesalahan yang mungkin Anda terima untuk tugas Apache Airflow di suatu lingkungan.

Tugas saya macet atau tidak selesai

Jika tugas Apache Airflow Anda “macet” atau tidak selesai, kami sarankan langkah-langkah berikut:

  1. Mungkin ada sejumlah besar DAG yang didefinisikan. Kurangi jumlah DAG dan lakukan pembaruan lingkungan (seperti mengubah level log) untuk memaksa reset.

    1. Aliran udara mengurai DAG apakah diaktifkan atau tidak. Jika Anda menggunakan lebih dari 50% kapasitas lingkungan Anda, Anda mungkin mulai membebani penjadwal Apache Airflow. Hal ini menyebabkan Total Waktu Penguraian yang besar dalam CloudWatch Metrik atau waktu pemrosesan DAG yang panjang di CloudWatch Log. Ada cara lain untuk mengoptimalkan konfigurasi Apache Airflow yang berada di luar cakupan panduan ini.

    2. Untuk mempelajari lebih lanjut tentang praktik terbaik yang kami sarankan untuk menyesuaikan kinerja lingkungan Anda, lihatPenyetelan kinerja untuk Apache Airflow di Amazon MWAA.

  2. Mungkin ada sejumlah besar tugas dalam antrian. Ini sering ditampilkan sebagai jumlah tugas yang besar—dan bertambah—di None negara bagian, atau sebagai jumlah besar di dalam. Queued Tasks and/or Tasks Pending CloudWatch Hal ini dapat terjadi karena alasan berikut:

    1. Jika ada lebih banyak tugas untuk dijalankan daripada kapasitas lingkungan untuk dijalankan, and/or sejumlah besar tugas yang diantri sebelum penskalaan otomatis memiliki waktu untuk mendeteksi tugas dan menyebarkan pekerja tambahan.

    2. Jika ada lebih banyak tugas yang harus dijalankan daripada kapasitas lingkungan untuk dijalankan, sebaiknya kurangi jumlah tugas yang dijalankan DAG Anda secara bersamaan, and/or meningkatkan minimum pekerja Apache Airflow.

    3. Jika ada sejumlah besar tugas yang diantri sebelum penskalaan otomatis sempat mendeteksi dan menyebarkan pekerja tambahan, kami sarankan penerapan tugas yang mengejutkan and/or meningkatkan minimum pekerja Apache Airflow.

    4. Anda dapat menggunakan perintah update-environment di AWS Command Line Interface (AWS CLI) untuk mengubah jumlah minimum atau maksimum pekerja yang berjalan di lingkungan Anda.

      aws mwaa update-environment --name MyEnvironmentName --min-workers 2 --max-workers 10
    5. Untuk mempelajari lebih lanjut tentang praktik terbaik yang kami sarankan untuk menyesuaikan kinerja lingkungan Anda, lihatPenyetelan kinerja untuk Apache Airflow di Amazon MWAA.

  3. Jika tugas Anda macet dalam status “berjalan”, Anda juga dapat menghapus tugas atau menandainya sebagai berhasil atau gagal. Hal ini memungkinkan komponen penskalaan otomatis untuk lingkungan Anda untuk mengurangi jumlah pekerja yang berjalan di lingkungan Anda. Gambar berikut menggambarkan contoh tugas yang terdampar.

    Ini adalah gambar dengan tugas yang terdampar.
    1. Pilih lingkaran untuk tugas yang terdampar, lalu pilih H apus (seperti yang ditunjukkan). Ini memungkinkan Amazon MWAA menurunkan skala pekerja; jika tidak, Amazon MWAA tidak dapat menentukan DAG mana yang diaktifkan atau dinonaktifkan, dan tidak dapat mengurangi skala, jika masih ada tugas yang antri.

      Tindakan Aliran Udara Apache
  4. Pelajari lebih lanjut tentang siklus hidup tugas Apache Airflow di Konsep dalam panduan referensi Apache Airflow.

Saya mendapatkan kegagalan tugas tanpa log di Airflow v3

Jika tugas Apache Airflow 3 Anda gagal tanpa log, ikuti langkah-langkah ini:

  • Jika log pekerja menampilkan kesalahan seperti Task handler raised error: WorkerLostError('Worker exited prematurely: exitcode 15 Job: 12.') sekitar waktu tugas gagal, ini menunjukkan bahwa proses pekerja bercabang yang ditugaskan ke tugas kemungkinan dihentikan secara tidak terduga.

    Untuk mengatasi hal ini, pertimbangkan untuk mengonfigurasi celery.worker_autoscale dengan nilai minimum dan maksimum yang sama. Contoh:

    celery.worker_autoscale=5,5 # for mw1.small celery.worker_autoscale=10,10 # for mw1.medium celery.worker_autoscale=20,20 # for mw1.large

    Ini memastikan bahwa ukuran kumpulan pekerja tetap tetap, mencegah penghentian pekerja yang tidak terduga.

CLI

Topik berikut menjelaskan kesalahan yang mungkin Anda terima saat menjalankan perintah Airflow CLI di AWS Command Line Interface.

Saya mendapatkan kesalahan '503' saat memicu DAG di CLI

Airflow CLI berjalan di server web Apache Airflow, yang memiliki konkurensi terbatas. Biasanya maksimal 4 perintah CLI dapat berjalan secara bersamaan.

Mengapa perintah dags backfill Apache Airflow CLI gagal? Apakah ada solusinya?

catatan

Berikut ini hanya berlaku untuk lingkungan Apache Airflow v2.0.2.

Per backfill intah tersebut, seperti perintah Apache Airflow CLI lainnya, mengurai semua DAG secara lokal sebelum DAG diproses, terlepas dari DAG mana yang diterapkan operasi CLI. Di lingkungan Amazon MWAA menggunakan Apache Airflow v2.0.2, karena plugin dan persyaratan belum diinstal pada server web pada saat perintah CLI berjalan, operasi penguraian gagal, dan operasi tidak dipang backfill gil. Jika Anda tidak memiliki persyaratan atau plugin di lingkungan Anda, backfill operasi akan berhasil.

Untuk dapat menjalankan perintah backfill CLI, kami sarankan untuk memanggilnya di operator bash. Dalam operator bash, backfill dimulai dari pekerja, memungkinkan DAG untuk berhasil mengurai karena semua persyaratan dan plugin yang diperlukan tersedia dan diinstal. Gunakan contoh berikut untuk membuat DAG dengan a BashOperator to runbackfill.

from airflow import DAG from airflow.operators.bash_operator import BashOperator from airflow.utils.dates import days_ago with DAG(dag_id="backfill_dag", schedule_interval=None, catchup=False, start_date=days_ago(1)) as dag: cli_command = BashOperator( task_id="bash_command", bash_command="airflow dags backfill my_dag_id" )

Operator

Topik berikut menjelaskan kesalahan yang mungkin Anda terima saat menggunakan Operator.

Saya menerima kesalahanPermissionError: [Errno 13] Izin ditolak menggunakan operator S3Transform

Kami merekomendasikan langkah-langkah berikut jika Anda mencoba menjalankan skrip shell dengan operator S3Transform dan Anda menerima kesalahan. PermissionError: [Errno 13] Permission denied Langkah-langkah berikut mengasumsikan Anda memiliki file plugins.zip yang ada. Jika Anda membuat plugins.zip baru, lihatMenginstal plugin kustom.

  1. Uji DAG, plugin khusus, dan dependensi Python Anda secara lokal menggunakan aws- mwaa-docker-images on. GitHub

  2. Buat skrip “transformasi” Anda.

    #!/bin/bash cp $1 $2
  3. (opsional) Pengguna macOS dan Linux mungkin perlu menjalankan perintah berikut untuk memastikan skrip dapat dieksekusi.

    chmod 777 transform_test.sh
  4. Tambahkan skrip ke plugins.zip Anda.

    zip plugins.zip transform_test.sh
  5. Ikuti langkah-langkah di Unggah plugins.zip ke Amazon S3.

  6. Ikuti langkah-langkah dalam Men entukan versi plugins.zip di konsol Amazon MWAA.

  7. Buat DAG berikut.

    from airflow import DAG from airflow.providers.amazon.aws.operators.s3_file_transform import S3FileTransformOperator from airflow.utils.dates import days_ago import os DAG_ID = os.path.basename(__file__).replace(".py", "") with DAG (dag_id=DAG_ID, schedule_interval=None, catchup=False, start_date=days_ago(1)) as dag: file_transform = S3FileTransformOperator( task_id='file_transform', transform_script='/usr/local/airflow/plugins/transform_test.sh', source_s3_key='s3://amzn-s3-demo-bucket/files/input.txt', dest_s3_key='s3://amzn-s3-demo-bucket/files/output.txt' )
  8. Ikuti langkah-langkah di Meng unggah kode DAG ke Amazon S3.