DataWorks：Sumber data GDB

Pembacaan data batch

Penulisan data batch

• Anda harus mengonfigurasi dua tugas sinkronisasi untuk menyinkronkan data tentang simpul dan tepi secara terpisah.

• Simpul atau tepi yang datanya akan disinkronkan harus memiliki nama agar DataWorks dapat melintasi dan mendapatkan data terkait.

• Nilai kunci utama simpul dan tepi di GDB adalah bertipe STRING. Tipe data yang akan disinkronkan harus dikonfigurasi sebagai tipe STRING. Jika tipe yang dikonfigurasi adalah tipe numerik, seperti LONG, GDB Reader secara paksa mengonversi nilai kunci utama menjadi tipe STRING. Jika konversi gagal, nilai kunci utama akan hilang.

• Untuk nilai properti simpul atau tepi, tipe data untuk nilai properti yang akan disinkronkan harus sama dengan tipe data asli dalam instance GDB. Jika tipe data untuk nilai properti berbeda dari tipe data asli, GDB Reader secara paksa mengonversi nilai properti ke tipe data yang ditentukan. Jika konversi gagal, nilai properti akan hilang.

• Jika Anda menjalankan tugas untuk menyinkronkan data simpul beberapa kali, nilai yang diperoleh dari properti SET mungkin berbeda.

• Jika Anda mengonfigurasi semua properti dalam format JSON, properti SET yang hanya berisi satu nilai dianggap sebagai properti umum.

• Kecuali dinyatakan lain, nama bidang atau nilai enumerasi dalam topik ini bersifat peka huruf besar-kecil.

• GDB Reader hanya mendukung format pengkodean UTF-8. Data yang disinkronkan harus dikodekan dalam UTF-8.

• Hanya GDB versi 1.0.20 atau lebih baru yang mendukung properti SET. Konfirmasikan versi GDB sebelum Anda menggunakan properti SET.

• Anda harus menjalankan tugas sinkronisasi untuk menyinkronkan data simpul sebelum menjalankan tugas sinkronisasi untuk menyinkronkan data tepi.

• Batasan pada simpul:

  • Simpul harus memiliki nama, yang ditentukan oleh parameter label.

  • Simpul harus memiliki kunci utama unik bertipe STRING. Jika kunci utama bukan string, GDB Writer secara paksa mengonversi kunci utama menjadi string.

  • Berhati-hatilah saat mengonfigurasi parameter idTransRule. Jika Anda ingin menyetel parameter ini ke none, Anda harus memastikan bahwa kunci utama setiap simpul unik di antara semua simpul.

• Batasan pada tepi:

  • Tepi harus memiliki nama, yang ditentukan oleh parameter label.

  • Kunci utama bersifat opsional untuk sebuah tepi.

    • Jika Anda ingin menentukan kunci utama untuk sebuah tepi, Anda harus memastikan bahwa kunci utama tersebut unik di antara semua tepi.

    • Jika Anda tidak menentukan kunci utama untuk sebuah tepi, GDB Writer secara otomatis menghasilkan pengenal unik universal (UUID) bertipe STRING untuk tepi tersebut. Jika UUID bukan string, GDB Writer secara paksa mengonversi UUID menjadi string.

  • Berhati-hatilah saat mengonfigurasi parameter idTransRule. Jika Anda ingin menyetel parameter ini ke none, Anda harus memastikan bahwa kunci utama setiap tepi unik di antara semua tepi.

  • Parameter srcIdTransRule dan dstIdTransRule diperlukan untuk sebuah tepi. Nilai kedua parameter tersebut harus sama dengan nilai parameter idTransRule dari simpul terkait.

• Kecuali dinyatakan lain, nama bidang dan nilai enumerasi dalam topik ini bersifat peka huruf besar-kecil.

• GDB Writer hanya mendukung format pengkodean UTF-8. Data sumber harus dikodekan dalam UTF-8.

• Karena kendala jaringan, tugas sinkronisasi yang digunakan untuk menyinkronkan data ke database GDB hanya dapat berjalan pada kelompok sumber daya eksklusif untuk Data Integration. Anda harus membeli kelompok sumber daya eksklusif untuk Data Integration dan mengaitkan kelompok tersebut dengan virtual private cloud (VPC) tempat instance GDB berada sebelumnya.

Parameter

Deskripsi

Diperlukan

Nilai default

host

Titik akhir yang digunakan untuk terhubung ke instance GDB. Anda dapat masuk ke Konsol GDB, temukan instance yang ingin Anda konfigurasikan, dan klik View Instance Details di kolom Aksi untuk melihat Intranet URL.

Ya

Tidak ada nilai default

port

Nomor port yang digunakan untuk terhubung ke instance GDB.

Ya

8182

username

Nama pengguna yang digunakan untuk terhubung ke instance GDB.

Ya

Tidak ada nilai default

password

Kata sandi yang digunakan untuk terhubung ke instance GDB.

Ya

Tidak ada nilai default

labels

Label, yaitu nama simpul atau tepi. GDB Reader dapat membaca data dari beberapa simpul atau tepi sekaligus. Dalam hal ini, nilai parameter ini adalah array, seperti ["label1", "label2"].

Ya

Tidak ada nilai default

labelType

Jenis label. Nilai valid:

• VERTEX

• EDGE

Ya

Tidak ada nilai default

column

Simpul atau tepi yang akan disinkronkan.

Ya

Tidak ada nilai default

column -> name

Nama properti simpul atau tepi yang akan disinkronkan. Parameter ini diperlukan jika properti simpul atau tepi akan disinkronkan.

Ya

Tidak ada nilai default

column -> type

Tipe data untuk menyimpan properti simpul atau tepi yang akan disinkronkan.

• Kunci utama dan label hanya bisa bertipe STRING. Jika Anda tidak menyetel tipe data ke STRING, konversi data gagal.

• Properti lainnya bisa bertipe INT, LONG, FLOAT, DOUBLE, BOOLEAN, atau STRING.

• GDB Reader secara paksa mengonversi data yang diperoleh ke tipe yang ditentukan. Jika konversi gagal, catatan data hilang.

Ya

Tidak ada nilai default

column -> columnType

Kategori properti simpul atau tepi yang akan disinkronkan.

• Untuk simpul dan tepi:

  • primaryKey: kunci utama.

  • primaryLabel: label.

• Untuk simpul:

  • vertexProperty: properti umum simpul.

  • vertexJsonProperty: kumpulan properti simpul, dalam format JSON. Jika Anda menyetel parameter columnType ke vertexJsonProperty, semua properti terdaftar di kolom ini. Kolom lain tidak dapat berisi properti simpul.

    Contoh vertexJsonProperty:

    {
        "properties":[
            {"k":"name","t":"string","v":"tom","c":"set"},
            {"k":"name","t":"string","v":"jack","c":"set"},
            {"k":"sex","t":"string","v":"male","c":"single"}
        ]
    }
                                                        

    Kode di atas berisi properti multi-nilai name dan properti single-nilai gender. Properti name memiliki dua catatan. Meskipun properti gender adalah properti multi-nilai, dianggap sebagai properti single-nilai dalam contoh ini karena hanya ada satu catatan terkait.

• Untuk tepi:

  • srcPrimaryKey: kunci utama simpul awal.

  • dstPrimaryKey: kunci utama simpul akhir.

  • srcPrimaryLabel: label simpul awal.

  • dstPrimaryLabel: label simpul akhir.

  • edgeProperty: properti tepi.

  • edgeJsonProperty: kumpulan properti tepi, dalam format JSON. Jika Anda menyetel parameter columnType ke edgeJsonProperty, semua properti terdaftar di kolom ini. Kolom lain tidak dapat berisi properti tepi.

    Contoh edgeJsonProperty:

    {
        "properties":[
            {"k":"name","t":"string","v":"tom"},
            {"k":"sex","t":"string","v":"male"}
    ]
    }
                                                        

    Tepi tidak mendukung properti multi-nilai atau bidang c.

Ya

Tidak ada nilai default

Parameter

Deskripsi

Diperlukan

Nilai default

datasource

Nama sumber data. Harus sama dengan nama sumber data yang telah ditambahkan. Anda dapat menambahkan sumber data menggunakan editor kode.

Ya

Tidak ada nilai default

label

Label, yaitu nama simpul atau tepi.

GDB Writer dapat memperoleh label dari kolom dalam tabel sumber. Misalnya, jika Anda menyetel parameter ini ke #{0}, GDB Writer menggunakan nilai kolom pertama sebagai label. Indeks kolom dimulai dari 0.

Ya

Tidak ada nilai default

labelType

Jenis label. Nilai valid:

• VERTEX

• EDGE

Ya

Tidak ada nilai default

srcLabel

• Nama simpul awal dalam tepi saat parameter labelType disetel ke EDGE.

  Parameter ini dapat dibiarkan kosong jika srcIdTransRule disetel ke none. Jika srcIdTransRule disetel ke nilai lain, parameter ini diperlukan.

• Biarkan parameter ini kosong jika parameter labelType disetel ke VERTEX.

Tidak

Tidak ada nilai default

dstLabel

• Nama simpul akhir dalam tepi saat parameter labelType disetel ke EDGE.

  Parameter ini dapat dibiarkan kosong jika dstIdTransRule disetel ke none. Jika dstIdTransRule disetel ke nilai lain, parameter ini diperlukan.

• Biarkan parameter ini kosong jika parameter labelType disetel ke VERTEX.

Tidak

Tidak ada nilai default

writeMode

Mode di mana GDB Writer memproses catatan data dengan kunci utama duplikat. Nilai valid:

• INSERT: mengembalikan pesan kesalahan. Jumlah catatan data kesalahan bertambah satu.

• MERGE: menimpa data lama dengan yang baru.

Ya

INSERT

idTransRule

Aturan untuk mengonversi kunci utama. Nilai valid:

• labelPrefix: mengonversi kunci utama menjadi format {label}-{kolom dalam sumber}.

• none: tidak mengonversi kunci utama.

Ya

none

srcIdTransRule

Aturan untuk mengonversi kunci utama simpul awal saat parameter labelType disetel ke EDGE. Nilai valid:

• labelPrefix: mengonversi kunci utama menjadi format {label}-{kolom dalam sumber}.

• none: tidak mengonversi kunci utama. Dalam hal ini, parameter srcLabel dapat dibiarkan kosong.

Diperlukan saat parameter labelType disetel ke EDGE

none

dstIdTransRule

Aturan untuk mengonversi kunci utama simpul akhir saat parameter labelType disetel ke EDGE. Nilai valid:

• labelPrefix: mengonversi kunci utama menjadi format {label}-{kolom dalam sumber}.

• none: tidak mengonversi kunci utama. Dalam hal ini, parameter dstLabel dapat dibiarkan kosong.

Diperlukan saat parameter labelType disetel ke EDGE

none

column

Simpul atau tepi yang ingin Anda sinkronkan.

• name: nama properti simpul atau tepi.

• value: nilai properti simpul atau tepi. Anda dapat menyesuaikan nilai hanya di editor kode.

  • #{N}: menggunakan nilai kolom ke-N dalam sumber sebagai nilai properti simpul atau tepi. N menunjukkan indeks kolom, yang dimulai dari 0.

  • #{0}: menggunakan nilai kolom pertama dalam sumber sebagai nilai properti simpul atau tepi.

  • test-#{0}: menambahkan string tetap seperti test- di awal atau akhir #{0}.

  • #{0}-#{1}: menggabungkan nilai beberapa kolom dalam sumber sebagai nilai properti simpul atau tepi. Anda juga dapat menambahkan string tetap di posisi mana pun, seperti test-#{0}-test1-#{1}-test2.

• type: tipe data properti simpul atau tepi.

  Kunci utama harus bertipe STRING. Jika nilai yang diperoleh dari sumber bukan string, GDB Writer secara paksa mengonversi nilai tersebut menjadi string. Pastikan nilai tersebut dapat dikonversi menjadi string.

  Properti lainnya bisa bertipe INT, LONG, FLOAT, DOUBLE, BOOLEAN, atau STRING.

• columnType: kategori properti simpul atau tepi yang ingin Anda sinkronkan.

  • Untuk simpul dan tepi

    primaryKey: kunci utama.

  • Untuk simpul

    • vertexProperty: properti umum simpul.

    • vertexJsonProperty: properti JSON simpul. Untuk informasi lebih lanjut tentang struktur nilai, lihat contoh properti.

  • Untuk tepi

    • srcPrimaryKey: kunci utama simpul awal.

    • dstPrimaryKey: kunci utama simpul akhir.

    • edgeProperty: properti umum tepi.

    • edgeJsonProperty: properti JSON tepi. Untuk informasi lebih lanjut tentang struktur nilai, lihat contoh properti.

Contoh properti

{"properties":[
    {"k":"name","t":"string","v":"tom"},
    {"k":"age","t":"int","v":"20"},
    {"k":"sex","t":"string","v":"male"}
]}

Ya

Tidak ada nilai default