CockroachDB

Entitas, operasi, dan tindakan

Semua Konektor Integrasi menyediakan lapisan abstraksi untuk objek aplikasi yang terhubung. Anda hanya dapat mengakses objek aplikasi melalui abstraksi ini. Abstraksi ini ditampilkan kepada Anda sebagai entitas, operasi, dan tindakan.

• Entitas: Entitas dapat dianggap sebagai objek, atau kumpulan properti, dalam aplikasi atau layanan yang terhubung. Definisi entitas berbeda dari konektor ke konektor. Misalnya, di konektor database, tabel adalah entitas, di konektor server file, folder adalah entitas, dan di konektor sistem pesan, antrean adalah entitas.

  Namun, ada kemungkinan konektor tidak mendukung atau tidak memiliki entity apa pun, sehingga daftar Entities akan kosong.

• Operasi: Operasi adalah aktivitas yang dapat Anda lakukan pada entity. Anda dapat melakukan salah satu operasi berikut pada entitas:
  • Daftar
  • Dapatkan
  • Buat
  • Update
  • Hapus

  Memilih entitas dari daftar yang tersedia akan menghasilkan daftar operasi yang tersedia untuk entitas tersebut. Untuk deskripsi mendetail tentang operasi, lihat operasi entitas tugas Konektor. Namun, jika konektor tidak mendukung operasi entitas apa pun, operasi yang tidak didukung tersebut tidak tercantum dalam daftar Operations.

• Tindakan: Tindakan adalah fungsi kelas pertama yang tersedia untuk integrasi melalui antarmuka konektor. Tindakan memungkinkan Anda membuat perubahan pada satu atau beberapa entitas, dan berbeda-beda dari konektor ke konektor. Biasanya, tindakan akan memiliki beberapa parameter input, dan parameter output. Namun, ada kemungkinan konektor tidak mendukung tindakan apa pun, sehingga daftar Actions akan kosong.

Tindakan

Bagian ini mencantumkan tindakan yang didukung oleh konektor. Untuk memahami cara mengonfigurasi tindakan, lihat Contoh tindakan.

Tindakan ExecuteCustomQuery

Tindakan ini memungkinkan Anda menjalankan kueri kustom.

Untuk membuat kueri kustom, ikuti langkah-langkah berikut:

1. Ikuti petunjuk mendetail untuk menambahkan tugas konektor.
2. Saat Anda mengonfigurasi tugas konektor, di jenis tindakan yang ingin Anda lakukan, pilih Tindakan.
3. Dalam daftar Tindakan, pilih Jalankan kueri kustom, lalu klik Selesai.

   

4. Luaskan bagian Input tugas, lalu lakukan hal berikut:
   1. Di kolom Waktu tunggu setelah, masukkan jumlah detik untuk menunggu hingga kueri dieksekusi.

      Nilai default: 180 detik.

   2. Di kolom Jumlah baris maksimum, masukkan jumlah baris maksimum yang akan ditampilkan dari database.

      Nilai default: 25.

   3. Untuk memperbarui kueri kustom, klik Edit Skrip Kustom. Dialog Script editor akan terbuka.

      

   4. Dalam dialog Editor skrip, masukkan kueri SQL, lalu klik Simpan.

      Anda dapat menggunakan tanda tanya (?) dalam pernyataan SQL untuk merepresentasikan satu parameter yang harus ditentukan dalam daftar parameter kueri. Misalnya, kueri SQL berikut memilih semua baris dari tabel Employees yang cocok dengan nilai yang ditentukan untuk kolom LastName:

      SELECT * FROM Employees where LastName=?

   5. Jika Anda telah menggunakan tanda tanya dalam kueri SQL, Anda harus menambahkan parameter dengan mengklik + Tambahkan Nama Parameter untuk setiap tanda tanya. Saat menjalankan integrasi, parameter ini menggantikan tanda tanya (?) dalam kueri SQL secara berurutan. Misalnya, jika Anda telah menambahkan tiga tanda tanya (?), maka Anda harus menambahkan tiga parameter sesuai urutan.

      

      Untuk menambahkan parameter kueri, lakukan hal berikut:

      1. Dari daftar Jenis, pilih jenis data parameter.
      2. Di kolom Nilai, masukkan nilai parameter.
      3. Untuk menambahkan beberapa parameter, klik + Tambahkan Parameter Kueri.

Jika berhasil dieksekusi, tindakan ini akan menampilkan status 200 (OK) dengan isi respons yang memiliki hasil kueri.

Contoh tindakan

Contoh - Menemukan nilai yang lebih besar

Contoh ini menunjukkan cara menjalankan fungsi yang ditentukan pengguna. Fungsi find_greater dalam contoh ini, membandingkan dua bilangan bulat dan menampilkan bilangan bulat yang lebih besar.

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan find_greater, lalu klik Selesai.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
   "$1": 1.0,
   "$2": 5.0
   }

Jika eksekusi tindakan berhasil, kolom connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:

[{
"bignum": 5.0
}]

Contoh operasi entity

Bagian ini menunjukkan cara melakukan beberapa operasi entitas di konektor ini.

Contoh - Mencantumkan semua record Karyawan

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Employees dari daftar Entity.
3. Pilih operasi List, lalu klik Selesai.
4. Task Input pada tugas Connectors, Anda dapat menetapkan filterClause sesuai dengan persyaratan pelanggan.

Nilai untuk klausa filter harus selalu diteruskan dalam tanda petik tunggal (') dalam format ini.
Fungsi ini dapat digunakan untuk memfilter data berdasarkan kolom apa pun.

Anda dapat melakukan operasi List pada entitas berikut:

Cockroach_Datatypes, Accounts, SpatialData, UNICODE, LANGUAGES, dan View_Cockroach

Contoh - Mendapatkan record Karyawan

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Employees dari daftar Entity.
3. Pilih operasi Get, lalu klik Selesai.
4. Setel ID entity ke 5 yang merupakan Kunci yang akan diteruskan. Untuk menyetel ID entitas, di bagian Pemeta Data pada Pemetaan Data, klik Buka Editor Pemetaan Data, lalu masukkan 5 di kolom Nilai Input dan pilih EntityId sebagai Variabel lokal.

   Nilai untuk ID Entitas harus diteruskan secara langsung. Di sini, 5 adalah nilai kunci utama unik yang harus diteruskan.

   Ada kasus tertentu saat meneruskan ID Entity tunggal akan memunculkan error karena akan ada dua kunci gabungan.
   Dalam kasus seperti ini, Anda dapat menggunakan Klausa Filter dan meneruskan nilai seperti, EmployeeId='5'.

Anda dapat melakukan operasi List pada entitas berikut:

Cockroach_Datatypes, Accounts, SpatialData, UNICODE, dan LANGUAGES

Contoh - Menghapus record Karyawan

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Employees dari daftar Entity.
3. Pilih operasi Delete, lalu klik Selesai.
4. Setel ID entitas ke 2 yang merupakan Kunci yang akan diteruskan. Untuk menyetel ID entitas, di bagian Pemeta Data pada Pemetaan Data, klik Buka Editor Pemetaan Data, lalu masukkan 2 di kolom Nilai Input dan pilih EntityId sebagai Variabel lokal.

   Jika Entity memiliki dua Kunci Bisnis Gabungan atau Kunci Utama, bukan menentukan entityId, Anda juga dapat menyetel filterClause ke EmployeeId='2'.

Anda dapat melakukan operasi Hapus pada entitas berikut:

Cockroach_Datatypes, Accounts, SpatialData, UNICODE, dan LANGUAGES

Contoh - Membuat record Karyawan

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Employees dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.

   {
     "id": 100.0,
     "gender": "Male",
     "firstname": "Charlie",
     "lastname": "Cruz",
     "designation": "Tester",
     "dept": "IT"
   }
   

   Jika integrasi berhasil, parameter respons Employees tugas connectorOutputPayload akan memiliki nilai yang mirip dengan berikut:

   {
     "id": 100.0,
     "gender": "Male",
     "firstname": "Charlie",
     "lastname": "Cruz",
     "designation": "Tester",
     "dept": "IT"
     }
     

Contoh - Membuat rekaman Cockroach_Datatypes

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Cockroach_Datatypes dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.

   {
     "col_int": 8.0,
     "col_date": "2016-03-26",
     "col_inet": "190.0.0.0",
     "col_collate": "Cruz",
     "col_string": "Charlie",
     "col_timestamp": "1992-10-05 12:12:12",
     "col_float": 12.12,
     "col_decimal": 10.1,
     "col_json": "{\"type\": \"account creation\", \"username\": \"harvestboy93\"}",
     "col_bool": true,
     "col_interval": "1 year 2 mons 3 days 04:05:06",
     "col_array": "{sky,road,car}",
     "col_uuid": "63616665-6630-3064-6465-616462656562",
     "col_time": "05:41:39",
     "col_bytes": "abc",
     "col_bit": "1",
     "col_name": "Charlie",
     "col_character": "A",
     "col_tsvector": "ts",
     "col_tsquery": "normal",
     "col_oid": "11",
     "col_bytea": "01100001"
   }
   

   Jika integrasi berhasil, parameter respons Cockroach_Datatypes tugas connectorOutputPayload akan memiliki nilai yang mirip dengan berikut:

   {
     "col_int": 8.0,
     "col_date": "2016-03-26",
     "col_inet": "190.0.0.0",
     "col_collate": "Cruz",
     "col_string": "Charlie",
     "col_timestamp": "1992-10-05 12:12:12",
     "col_float": 12.12,
     "col_decimal": 10.1,
     "col_json": "{\"type\": \"account creation\", \"username\": \"harvestboy93\"}",
     "col_bool": true,
     "col_interval": "1 year 2 mons 3 days 04:05:06",
     "col_array": "{sky,road,car}",
     "col_uuid": "63616665-6630-3064-6465-616462656562",
     "col_time": "05:41:39",
     "col_bytes": "abc",
     "col_bit": "1",
     "col_name": "Charlie",
     "col_character": "A",
     "col_tsvector": "ts",
     "col_tsquery": "normal",
     "col_oid": "11",
     "col_bytea": "01100001"
     }
     

Contoh - Membuat rekaman Entity LANGUAGES

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih LANGUAGES dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.

   {
     "id": 5.0,
     "hinditext": "नमस्ते",
     "englishtest": "Namaste",
     "arabictext": "مرحبا",
     "germantext": "Günther"
   } 
   

   Jika integrasi berhasil, parameter respons connectorOutputPayload tugas LANGUAGES akan memiliki nilai yang mirip dengan berikut:

   {
   "id": 6.0,
   "hinditext": "नमस्ते",
   "englishtest": "Namaste",
   "arabictext": "مرحبا",
   "germantext": "Günther"
   }
   

Contoh - Membuat rekaman UNICODE

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih UNICODE dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.

   {
     "id": 2.0,
     "unicodedata": "Unicode データ型はグローバル化されたデータの保存に使用されます",
     "test": "UnicodeTest"
   }
   

Jika integrasi berhasil, parameter respons connectorOutputPayload tugas UNICODE akan memiliki nilai yang mirip dengan berikut:

{
"id": 2.0,
"unicodedata": "Unicode データ型はグローバル化されたデータの保存に使用されます",
"test": "UnicodeTest"
}

Contoh - Membuat rekaman SpatialData

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih SpatialData dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.

   {
     "id": 10.0,
     "data": "01020000000500000070CE88D2DE3453C075029A081B164540984C158C4AEA52C0DC68006F81B4444009F9A067B36252C02DB29DEFA7864440FA7E6ABC747B52C0D122DBF97EDA444070CE88D2DE3453C075029A081B164548"
   }
   

   Contoh ini akan membuat SpatialData Records. Jika integrasi berhasil, parameter respons connectorOutputPayload tugas SpatialData akan memiliki nilai yang mirip dengan berikut:

   {
   "id": 10.0,
   "data": "01020000000500000070CE88D2DE3453C075029A081B164540984C158C4AEA52C0DC68006F81B4444009F9A067B36252C02DB29DEFA7864440FA7E6ABC747B52C0D122DBF97EDA444070CE88D2DE3453C075029A081B164548"
   }
   

Contoh - Membuat rekaman Akun

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Accounts dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.

   {
     "balance": 2000.0,
     "status": "open",
     "id": 7.0
   }
   

   Contoh ini akan membuat SpatialData Records. Jika integrasi berhasil, parameter respons connectorOutputPayload tugas SpatialData akan memiliki nilai yang mirip dengan berikut:

   {
   "balance": 2000.0,
   "status": "open",
   "id": 7.0
   }
   

Contoh - Memperbarui record Karyawan

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Karyawan dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.

    {
     "dept": "Comp",
     "designation": "QA"
   }
   

5. Tetapkan ID entitas di Pemeta Data ke entitas Karyawan . Untuk menyetel ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value, dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.

   Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke 1.

   Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan di variabel output connectorOutputPayload tugas Connector:

   {
   }
   

Contoh - Memperbarui catatan LANGUAGES

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih LANGUAGES dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.

    {
     "englishtest": "UpdateTest_TEST"
   }
   

5. Tetapkan ID entitas di Pemeta Data ke entitas Array. Untuk menyetel ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value, dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.

   Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke 1.

   Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan di variabel output connectorOutputPayload tugas Connector:

   {
   }
   

Contoh - Mengupdate rekaman UNICODE

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih UNICODE dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.

    {
     "unicodedata": "ータ型はグロ",
     "test": "UpdateTest"
   }
   

5. Tetapkan ID entitas di Pemeta Data ke entitas ObjectType . Untuk menyetel ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value, dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.

   Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke 3.

   Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan di variabel output connectorOutputPayload tugas Connector:

   {
   }
   

Contoh - Memperbarui rekaman SpatialData

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Spatialdata dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.

   {
   "data": "01020000000500000070CE88D2DE3453C075029A081B164540984C158C4AEA52C0DC68006F81B4444009F9A067B36252C02DB29DEFA7864440FA7E6ABC747B52C0D122DBF97EDA444070CE88D2DE3453C075029A081B164543"
   } 
   

5. Tetapkan ID entitas di Pemetaan Data ke entitas TableType . Untuk menyetel ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value, dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.

   Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke id= 1.

   Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan di variabel output connectorOutputPayload tugas Connector:

   {
   "id": 1,
   "data": "01020000000500000070CE88D2DE3453C075029A081B164540984C158C4AEA52C0DC68006F81B4444009F9A067B36252C02DB29DEFA7864440FA7E6ABC747B52C0D122DBF97EDA444070CE88D2DE3453C075029A081B164543"
   }
   

Contoh - Memperbarui catatan Akun

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Accounts dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.

   {
   "balance": 1500.0,
   "status": "open"
   }
   

5. Tetapkan ID entitas di Pemetaan Data ke entitas TableType . Untuk menyetel ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value, dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.

   Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke id= 1.

   Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan di variabel output connectorOutputPayload tugas Connector:

   {
   "id": 1,
   "balance": 1500,
   "status": "open"
   }
   

Contoh - Memperbarui catatan Cockroach_Datatypes

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Cockroach_Datatypes dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.

   {
   "col_date": "2019-03-26",
   "col_collate": "Charlie",
   "col_string": "Cruz"
   }
   

5. Tetapkan ID entitas di Pemetaan Data ke entitas TableType . Untuk menyetel ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value, dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.

   Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke 2.

   Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan di variabel output connectorOutputPayload tugas Connector:

   {
   }