全部产品
Search

搜索本产品

    DataWorks：Node FTP Check

    文档中心

    DataWorks：Node FTP Check

    更新时间：Feb 26, 2026

    Node FTP Check menggunakan protokol FTP untuk memeriksa keberadaan file tertentu secara berkala. Jika file tersebut ditemukan, node ini memicu node downstream; jika tidak, node ini melakukan retry hingga kondisi berhenti terpenuhi. Node ini biasanya digunakan untuk meneruskan sinyal antara DataWorks dan sistem penjadwalan eksternal.

    Tindakan Pencegahan

    • DataStudio (Classic) **tidak lagi merekomendasikan penggunaan node FTP Check**. Kami menyarankan Anda **segera migrasi ke node Check**. Untuk informasi selengkapnya, lihat Node Check.

    • DataStudio (New) **tidak mendukung node FTP Check**.

    Prasyarat

    • Sumber data FTP telah dibuat. Catatan: Node ini tidak mendukung konfigurasi SFTP yang menggunakan otentikasi Key.

    • Alur kerja telah dibuat. Untuk informasi selengkapnya, lihat Buat alur kerja dengan pemicu otomatis.

    Informasi latar belakang

    Kasus penggunaan: Sebuah task DataWorks bergantung pada data yang ditulis oleh sistem eksternal. DataWorks tidak dapat mendeteksi secara langsung kapan task penulisan eksternal selesai. Untuk memberi sinyal penyelesaian, sistem eksternal membuat file penanda (misalnya, file .done). Node FTP Check secara berkala memeriksa keberadaan file .done tersebut. Saat file terdeteksi, node downstream dipicu.

    Catatan

    • Sistem penjadwalan eksternal menentukan sistem file untuk file penanda tersebut.

    • Dokumen ini menggunakan file .done sebagai contoh, tetapi Anda dapat menyesuaikan nama file tersebut.

    Prosesnya adalah sebagai berikut:FTP Check

    1. Saat data eksternal siap, sistem eksternal menghasilkan file penanda (misalnya, xxxx2021-03-03.done). Dokumen ini menggunakan file dengan akhiran .done sebagai file penanda. Anda dapat menyesuaikan file penanda sesuai kebutuhan bisnis Anda.

    2. Sumber data FTP membaca file penanda dari sistem file.

    3. Node FTP Check memeriksa keberadaan file penanda dari sumber data berdasarkan strategi pemeriksaan.

      • Ditemukan: Node mengembalikan status sukses dan memicu node downstream.

      • Tidak ditemukan: Node melakukan retry sesuai strategi yang dikonfigurasi hingga batas tercapai.

      Untuk informasi selengkapnya tentang strategi pemeriksaan node FTP Check, lihat bagian Konfigurasikan objek deteksi dan strategi pemeriksaan.

    4. Node downstream hanya dijalankan jika node FTP Check mengembalikan status sukses.

      • Sukses: Node downstream mulai mengakses database eksternal.

      • Gagal: Node downstream tidak mulai mengakses database eksternal.

    5. Node downstream mengakses data di database eksternal.

    Catatan

    Database eksternal mencakup, namun tidak terbatas pada, Oracle, MySQL, SQL Server, dan layanan database atau penyimpanan lainnya.

    Batasan

    • Kelompok sumber daya: Node FTP Check mendukung kelompok sumber daya Serverless (direkomendasikan) atau kelompok sumber daya eksklusif lama untuk penjadwalan. Untuk membeli dan menggunakan kelompok sumber daya Serverless, lihat Gunakan kelompok sumber daya serverless.

    • Sumber data: Konfigurasi sumber data FTP yang menggunakan protokol SFTP dan otentikasi Key tidak didukung.

    • Untuk siklus penjadwalan Menit atau Jam, **Strategi Berhenti Pemeriksaan** tidak mendukung Check Stop Time. Gunakan Check Stop Count sebagai gantinya.

    • Wilayah yang didukung: Tiongkok (Hangzhou), Tiongkok (Shanghai), Tiongkok (Beijing), Tiongkok (Shenzhen), Tiongkok (Chengdu), Tiongkok (Hong Kong), Jepang (Tokyo), Singapura, Malaysia (Kuala Lumpur), Indonesia (Jakarta), Jerman (Frankfurt), Inggris (London), AS (Silicon Valley), dan AS (Virginia).

    Buat node FTP Check

    1. Masuk ke Konsol DataWorks.

    2. Buka DataStudio. Arahkan kursor ke ikon 新建 dan pilih General > FTP Check.

      Atau, buka alur kerja yang diinginkan, klik kanan General, lalu pilih Create > FTP Check.

    3. Pada kotak dialog Create Node, masukkan Name dan pilih Target Folder.

      Catatan

      Nama node dapat berisi huruf, karakter Tionghoa, angka, garis bawah (_), dan titik (.). Panjang nama tidak boleh melebihi 128 karakter.

    4. Klik Confirm.

    5. Klik Properties di panel kanan untuk mengonfigurasi penjadwalan.

      Properti penjadwalan meliputi Basic Properties, Time Properties, Resource Properties, dan Dependencies. Untuk informasi selengkapnya, lihat Konfigurasikan properti dasar, Konfigurasikan properti waktu, Konfigurasikan properti sumber daya, dan Konfigurasikan dependensi penjadwalan siklus yang sama.

    6. Konfigurasikan objek deteksi dan strategi pemeriksaan.

      配置FTP Check参数

      1. Dari daftar Select FTP Data Source, pilih sumber data target.

        Anda dapat memilih sumber data FTP atau SFTP. Jika tidak tersedia sumber data, buat terlebih dahulu. Untuk informasi selengkapnya, lihat Tambahkan sumber data FTP.

      2. Pada bidang Check File, masukkan path file. Jika path bersifat dinamis, Anda dapat menggunakan parameter penjadwalan untuk mengonfigurasi path variabel. Untuk informasi selengkapnya, lihat Format yang didukung untuk parameter penjadwalan.

      3. Pada bidang Check Interval (s), atur interval polling.

      4. Pada bagian Check Stop Strategy, konfigurasikan strategi untuk menghentikan pemeriksaan.

        • Check Stop Time: Waktu batas (format: hh24:mi:ss). Jika file tidak ditemukan hingga waktu ini, task gagal. Jika file ditemukan, node downstream dipicu.

          Catatan

          Konfigurasi siklus penjadwalan node FTP Check memengaruhi strategi Check Stop Strategy yang tersedia:

          • Jika siklus penjadwalan diatur ke Minute atau Hour, Check Stop Time tidak didukung. Anda harus menggunakan Check Stop Count. Untuk informasi selengkapnya, lihat Konfigurasikan strategi FTP Check.

          • Jika Anda mengubah siklus dari Day ke Minute atau Hour, strategi Check Stop Time menjadi tidak valid. Anda harus mengubah strategi menjadi Check Stop Count agar dapat meng-commit node.

        • Check Stop Count: Jumlah maksimum upaya polling. Jika file tidak ditemukan setelah jumlah percobaan ini, task gagal.

    7. Simpan dan commit.

      Catatan

      Anda harus mengonfigurasi properti Rerun dan Upstream Dependencies sebelum dapat meng-commit node.

      1. Klik ikon 保存 di bilah alat untuk menyimpan node.

      2. Klik ikon 提交 di bilah alat.

      3. Pada kotak dialog Submit New Version, masukkan Change Description.

      4. Klik Confirm.

      Untuk ruang kerja mode standar, klik Publish setelah melakukan commit. Untuk informasi selengkapnya, lihat Publikasikan task.

    8. Lakukan operasi O&M pada node. Untuk informasi selengkapnya, lihat Lakukan operasi O&M dasar pada node dengan pemicu otomatis.