All Products
Search

This Product

    DataWorks:CreateNode

    Document Center

    DataWorks:CreateNode

    Last Updated:Jun 11, 2026

    Membuat node di DataStudio. Informasi tentang node dijelaskan menggunakan FlowSpec.

    Deskripsi operasi

    Penting

    API ini tidak mendukung operasi batch. Jika Anda mendefinisikan lebih dari satu node dalam FlowSpec, semua node kecuali yang pertama akan diabaikan.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ProjectId

    integer

    Yes

    ID workspace DataWorks. Anda dapat masuk ke konsol DataWorks dan membuka halaman Workspace untuk mengambil ID tersebut.

    Anda harus mengonfigurasi parameter ini untuk menentukan workspace DataWorks tempat operasi API diterapkan.

    123456
    ContainerId

    string

    No

    Tentukan parameter ini jika Anda ingin membuat node di dalam sebuah kontainer. Parameter ini mewakili pengenal unik dari kontainer, yang dapat berupa workflow atau node kontainer.

    Catatan

    Jika parameter ini ditentukan, kolom path yang didefinisikan dalam FlowSpec akan diabaikan.

    Catatan

    Sebelum SDK versi 8.0.0, kolom ini bertipe Long. Pada SDK versi 8.0.0 dan setelahnya, kolom ini bertipe String. Perubahan ini tidak memengaruhi penggunaan normal SDK. Parameter dikembalikan berdasarkan tipe yang didefinisikan dalam SDK. Kegagalan kompilasi akibat perubahan tipe hanya mungkin terjadi saat Anda memutakhirkan SDK melintasi versi 8.0.0. Dalam kasus tersebut, Anda harus memperbarui tipe data secara manual.

    23451286945488XXXX

    Scene

    string

    Yes

    Tentukan parameter ini jika Anda ingin membuat node di dalam sebuah kontainer. Parameter ini mewakili pengenal unik dari kontainer, yang dapat berupa workflow atau node kontainer.

    Catatan

    Jika parameter ini ditentukan, kolom path yang didefinisikan dalam FlowSpec akan diabaikan.

    Catatan

    Sebelum SDK versi 8.0.0, kolom ini bertipe Long. Pada SDK versi 8.0.0 dan setelahnya, kolom ini bertipe String. Perubahan ini tidak memengaruhi penggunaan normal SDK. Parameter dikembalikan berdasarkan tipe yang didefinisikan dalam SDK. Kegagalan kompilasi akibat perubahan tipe hanya mungkin terjadi saat Anda memutakhirkan SDK melintasi versi 8.0.0. Dalam kasus tersebut, Anda harus memperbarui tipe data secara manual.

    DATAWORKS_PROJECT
    Spec

    string

    Yes

    Informasi FlowSpec yang menjelaskan node. Untuk informasi selengkapnya, lihat FlowSpec.

    Catatan

    Bagaimana cara cepat memperoleh template FlowSpec?

    • Buka Data Studio, buka sebuah node, klik Version di sisi kanan, temukan versi terbaru, lalu klik Scheduling Settings untuk memperoleh deskripsi FlowSpec dari node saat ini. Anda dapat menggunakan deskripsi FlowSpec pada versi tersebut untuk membangun template yang memenuhi kebutuhan Anda dengan cepat.

    Catatan

    Bagaimana cara mengonfigurasi konten node?

    • Masukkan kode untuk node tersebut pada kolom $.spec.nodes[].script.content.

    Catatan

    Bagaimana cara mengonfigurasi node sinkronisasi batch?

    • Tulis skrip dengan mengacu pada Langkah 4 di Configure an offline sync task in the code editor, kemudian masukkan konten skrip pada kolom $.spec.nodes[*].script.content. Sebagai alternatif, Anda dapat membuat node sinkronisasi batch di konsol dan melihat informasi versinya untuk memperoleh konten skrip.

    { "version": "1.1.0", "kind": "Node", "spec": { "nodes": [ { "recurrence": "Normal", "timeout": 0, "instanceMode": "T+1", "rerunMode": "Allowed", "rerunTimes": 3, "rerunInterval": 180000, "datasource": { "name": "odps_test" }, "script": { "path": "XX/OpenAPI_Test/odpsSQL_Test", "runtime": { "command": "ODPS_SQL" }, "content": "select now();" }, "trigger": { "type": "Scheduler", "cron": "00 00 00 * * ?", "startTime": "1970-01-01 00:00:00", "endTime": "9999-01-01 00:00:00", "timezone": "Asia/Shanghai", "delaySeconds": 0 }, "runtimeResource": { "resourceGroup": "S_res_group_XXXX_XXXX" }, "name": "odpsSQL_Test", "inputs": { "nodeOutputs": [ { "data": "project_root", "artifactType": "NodeOutput" } ] }, "outputs": { "nodeOutputs": [ { "data": "output_data", "artifactType": "NodeOutput", "refTableName": "odpsSQL_Test" } ] } } ] } }

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons

    RequestId

    string

    ID permintaan.

    AFBB799F-8578-51C5-A766-E922EDB8XXXX
    Id

    string

    Pengenal unik dari node Data Studio.

    Catatan

    Kolom ini bertipe Long pada SDK versi sebelum 8.0.0, dan bertipe String pada SDK versi 8.0.0 dan setelahnya. Perubahan ini tidak memengaruhi penggunaan normal SDK. Parameter dikembalikan berdasarkan tipe yang didefinisikan dalam SDK. Kegagalan kompilasi akibat perubahan tipe hanya mungkin terjadi saat Anda memutakhirkan SDK melintasi versi 8.0.0. Dalam kasus tersebut, Anda harus memperbarui tipe data secara manual.

    860438872620113XXXX

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "AFBB799F-8578-51C5-A766-E922EDB8XXXX",
  "Id": "860438872620113XXXX"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.