SAP HANA

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 EMPLOYEE_PROCEDURE_HANA

Tindakan ini menampilkan data ID.

Parameter input tindakan EMPLOYEE_PROCEDURE_HANA

Untuk contoh cara mengonfigurasi tindakan EMPLOYEE_PROCEDURE_HANA, lihat Contoh.

Tindakan ExecuteCustomQuery

Tindakan ini memungkinkan Anda melakukan tugas tertentu. Misalnya, HANADB memungkinkan Anda menjalankan kueri SQL kustom.

Parameter input tindakan ExecuteCustomQuery

Untuk contoh cara mengonfigurasi tindakan ExecuteCustomQuery, lihat Contoh.

Contoh tindakan

Contoh - EMPLOYEE_PROCEDURE_HANA

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

   {
   "ID":1
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas EMPLOYEE_PROCEDURE_HANA akan memiliki nilai yang mirip dengan berikut ini:

 [{
"EMP_ID": 1.0,
"NAME": "Komal",
"CITY": "UP",
"SALARY": 7500.0,
"DEPARTMENT": "IT" 
}]

Contoh - ExecuteCustomQuery Join_GroupBy

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

   {
   "query": "SELECT CUSTOMER.COMPANY, SUM(ORDERS.AMOUNT) AS Total
   FROM ORDERS
   INNER JOIN CUSTOMER
   ON ORDERS.CUSTOMER_ID = CUSTOMER.ID
   GROUP BY CUSTOMER.COMPANY"
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

[{
"COMPANY": "google India",
"TOTAL": 1560.0
},{
"COMPANY": "IBM India",
"TOTAL": 4500.0
}]

Contoh - Gabungan ExecuteCustomQuery

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

   {
   "query": "SELECT ID, NAME, AGE, AMOUNT FROM CUSTOMERS JOIN ORDERS ON CUSTOMERS.ID = ORDERS.CUSTOMER_ID"
     }]
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

[{
  "ID": 3.0,
  "NAME": "Kaushik",
  "AGE": 23.0,
  "AMOUNT": 3000.0
}, {
  "ID": 3.0,
  "NAME": "Kaushik",
  "AGE": 23.0,
  "AMOUNT": 1500.0
}, {
  "ID": 2.0,
  "NAME": "Khilan",
  "AGE": 25.0,
  "AMOUNT": 1560.0
}, {
  "ID": 4.0,
  "NAME": "Chaitali",
  "AGE": 25.0,
  "AMOUNT": 2060.0
}]

Contoh - ExecuteCustomQuery Groupby_Having_Count

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

   {
   "query": "SELECT COUNT(ID), CITY FROM GCP_HANA_CUSTOM GROUP BY CITY HAVING COUNT(ID) > 1"
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

 [{
  "COUNT(ID)": 2.0,
  "CITY": "Delhi"
}] 

Contoh - ExecuteCustomQuery GroupBy

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

   {
   "query": "SELECT COUNT(ID), CITY FROM GCP_HANA_CUSTOM GROUP BY CITY"
   }
   

Contoh ini akan memperbarui rekaman ExecuteCustomQuery. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

[{
  "COUNT(ID)": 1.0,
  "CITY": "Kolkata"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Katihar"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Bangalore"
}, {
  "COUNT(ID)": 2.0,
  "CITY": "Delhi"
}]

Contoh - ExecuteCustomQuery GroupBy_OrderBy

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

   {
   "query": "SELECT COUNT(ID), CITY FROM GCP_HANA_CUSTOM GROUP BY CITY ORDER BY COUNT(ID) DESC"
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

[{
  "COUNT(ID)": 2.0,
  "CITY": "Delhi"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Kolkata"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Bangalore"
}, {
  "COUNT(ID)": 1.0,
  "CITY": "Katihar"
}]

Contoh - ExecuteCustomQuery Insert_Table

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

   {
   "query": "INSERT INTO CUSTOMER VALUES (3, 'IBM India')"
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

[{
}]

Contoh - ExecuteCustomQuery SUM_AggFunc

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

   {
   "query": "SELECT SUM(SALARY) FROM CUSTOMERS"
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

 [{
"SUM(SALARY)": 12000.0
}] 

Contoh - ExecuteCustomQuery AVG_AggFunc

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

   {
   "query": "SELECT AVG(SALARY) FROM CUSTOMERS"
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

[{
"AVG(SALARY)": 3000.0
}] 

Contoh - ExecuteCustomQuery MAX_AggFunc

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

   {
   "query": "SELECT MAX(SALARY) FROM CUSTOMERS"
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

 [{
"MAX(SALARY)": 6500.0
}] 

Contoh - ExecuteCustomQuery MIN_AggFunc

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

   {
   "query": "SELECT MIN(SALARY) FROM CUSTOMERS"
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

[{
"MIN_SALARY": 1500.0
}]

Contoh - ExecuteCustomQuery COUNT_AggFunc

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

   {
   "query": "SELECT COUNT(*) FROM CUSTOMERS"
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

[{
"COUNT(*)": 4.0
}]

Contoh - ExecuteCustomQuery CreateTable

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

   {
   "query": "CREATE TABLE CUSTOMER (ID INT NOT NULL,COMPANY VARCHAR (20))"
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

[{
}]

Contoh - ExecuteCustomQuery AlterTable

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

   {
   "query": "ALTER TABLE GCP_HANA_CUSTOM ADD CONSTRAINT test PRIMARY KEY (ID)"
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

[{
}]

Contoh - ExecuteCustomQuery TruncateTable

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

   {
   "query": "TRUNCATE TABLE GCP_HANA_RENAME"
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

[{
}]

Contoh - ExecuteCustomQuery DropTable

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

   {
   "query": "DROP TABLE GCP_HANA_DROP"
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

[{
}]

Contoh - ExecuteCustomQuery RenameTable

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

   {
   "query": "RENAME TABLE GCP_HANA_CUSTOM1 TO GCP_HANA_RENAME"
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

[{
}]

Contoh - ExecuteCustomQuery UpdateTable

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

   {
   "query": "UPDATE CUSTOMERS SET ADDRESS = 'Pune' WHERE ID = 3"
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

[{
}]

Contoh - ExecuteCustomQuery SELECT_DATA_Table

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

   {
   "query": "SELECT * FROM CUSTOMERS"
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

[{
  "ID": 1.0,
  "NAME": "Ramesh",
  "AGE": 32.0,
  "ADDRESS": "Ahmedabad",
  "SALARY": 2000.0
}, {
  "ID": 2.0,
  "NAME": "Khilan",
  "AGE": 25.0,
  "ADDRESS": "Delhi",
  "SALARY": 1500.0
}, {
  "ID": 4.0,
  "NAME": "Chaitali",
  "AGE": 25.0,
  "ADDRESS": "Mumbai",
  "SALARY": 6500.0
}]

Contoh - ExecuteCustomQuery DeleteTable

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

   {
   "query": "DELETE FROM CUSTOMERS WHERE ID = 3"
   }
   

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas ExecuteCustomQuery akan memiliki nilai yang mirip dengan berikut ini:

[{
}]

Contoh operasi entity

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

Contoh - Mencantumkan semua karyawan

Contoh ini mencantumkan semua karyawan dalam entitas Employee.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Employee dari daftar Entity.
3. Pilih operasi List, lalu klik Selesai.
4. Secara opsional, di bagian Input Tugas pada tugas Konektor, Anda dapat memfilter kumpulan hasil dengan menentukan klausa filter. Selalu tentukan nilai klausa filter dalam tanda kutip tunggal ('). Misalnya, City='Bangalore'. Anda juga dapat menentukan beberapa kondisi filter menggunakan operator logika. Sebagai contoh, City='Bangalore' and region='asia-south2'

Contoh - Mendapatkan data

Contoh ini mendapatkan data dengan ID yang ditentukan dari entitas Employee.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Employee dari daftar Entity.
3. Pilih operasi Get, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik EntityId, lalu masukkan 12294 di kolom Default Value.

   Di sini, 12294 adalah nilai kunci utama dalam entity Employee.

Contoh - Membuat data di Hana_unicode

Contoh ini membuat data dalam entitas Hana_unicode.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Hana_unicode dari daftar Entity.
3. Pilih operasi Create, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
   "ID": 2.0,
   "UNICODEDATA": "Unicode データ型はグローバル化されたデータの保存に使用されます",
   "TEST": "Test7"
   }

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

   {
   "ID": 2.0,
   "UNICODEDATA": "Unicode データ型はグローバル化されたデータの保存に使用されます",
   "TEST": "Test7"
   }

Contoh - Membuat data di Languages

Contoh ini membuat data dalam entitas 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 Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
   "ID": 5,
   "ARABICTEXT": "مرحبا",
   "GERMANTEXT": "Günther",
   "HINDITEXT": "नमस्ते",
   "ENGLISHTEST": "Test1"
   }

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

   {
   "ID": 5.0,
   "ARABICTEXT": "مرحبا",
   "GERMANTEXT": "Günther",
   "HINDITEXT": "नमस्ते",
   "ENGLISHTEST": "Test1"
   }

Contoh - Memperbarui data

Contoh ini memperbarui data dalam entitas Employee.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Employee dari daftar Entity.
3. Pilih operasi Update, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
   "SALARY": 9000.0
   }

5. Klik entityId, lalu masukkan 12294 di kolom Default Value.

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

   {
   "SALARY": 9000.0
   }

Contoh - Menghapus data

Contoh ini menghapus data dengan ID yang ditentukan di entitas Employee.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Employee dari daftar Entity.
3. Pilih operasi Delete, lalu klik Selesai.
4. Di bagian Task Input pada tugas Connectors, klik entityId, lalu masukkan 10001 di kolom Default Value.