CockroachDB

Entità, operazioni e azioni

Tutti i connettori di integrazione forniscono un livello di astrazione per gli oggetti dell'applicazione connessa. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione ti viene mostrata come entità, operazioni e azioni.

• Entità : un'entità può essere considerata un oggetto o una raccolta di proprietà nell'applicazione o nel servizio connesso. La definizione di un'entità varia da un connettore all'altro. Ad esempio, in un connettore di database, le tabelle sono le entità, in un connettore del file server, le cartelle sono le entità e in un connettore del sistema di messaggistica, le code sono le entità.

  Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l'elenco Entities sarà vuoto.

• Operazione : un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire una delle seguenti operazioni su un'entità:
  • Elenca
  • Scarica
  • Crea
  • Aggiorna
  • Elimina

  Selezionando un'entità dall'elenco disponibile, viene generato un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta le operazioni sulle entità dell'attività Connettori. Tuttavia, se un connettore non supporta alcuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

• Azione: un'azione è una funzione di prima classe resa disponibile per l'integrazione tramite l'interfaccia del connettore. Un'azione ti consente di apportare modifiche a una o più entità e varia da connettore a connettore. In genere, un'azione ha alcuni parametri di input e un parametro di output. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Azioni

Questa sezione elenca le azioni supportate dal connettore. Per capire come configurare le azioni, consulta Esempi di azioni.

Azione ExecuteCustomQuery

Questa azione ti consente di eseguire una query personalizzata.

Per creare una query personalizzata:

1. Segui le istruzioni dettagliate per aggiungere un'attività di connettori.
2. Quando configuri l'attività del connettore, seleziona Azioni nel tipo di azione che vuoi eseguire.
3. Nell'elenco Azione, seleziona Esegui query personalizzata, quindi fai clic su Fine.

   

4. Espandi la sezione Input attività e poi segui questi passaggi:
   1. Nel campo Timeout dopo, inserisci il numero di secondi di attesa prima dell'esecuzione della query.

      Valore predefinito: 180 secondi.

   2. Nel campo Numero massimo di righe, inserisci il numero massimo di righe da restituire dal database.

      Valore predefinito: 25.

   3. Per aggiornare la query personalizzata, fai clic su Modifica script personalizzato. Si apre la finestra di dialogo Editor di script.

      

   4. Nella finestra di dialogo Editor di script, inserisci la query SQL e fai clic su Salva.

      Puoi utilizzare un punto interrogativo (?) in un'istruzione SQL per rappresentare un singolo parametro che deve essere specificato nell'elenco parametri di ricerca. Ad esempio, la seguente query SQL seleziona tutte le righe della tabella Employees che corrispondono ai valori specificati per la colonna LastName:

      SELECT * FROM Employees where LastName=?

   5. Se hai utilizzato punti interrogativi nella query SQL, devi aggiungere il parametro facendo clic su + Aggiungi nome parametro per ogni punto interrogativo. Durante l'esecuzione dell'integrazione, questi parametri sostituiscono in sequenza i punti interrogativi (?) nella query SQL. Ad esempio, se hai aggiunto tre punti interrogativi (?), devi aggiungere tre parametri in ordine di sequenza.

      

      Per aggiungere parametri di ricerca:

      1. Nell'elenco Tipo, seleziona il tipo di dati del parametro.
      2. Nel campo Valore, inserisci il valore del parametro.
      3. Per aggiungere più parametri, fai clic su + Aggiungi parametro di query.

Se l'esecuzione va a buon fine, questa azione restituisce lo stato 200 (OK) con un corpo della risposta contenente i risultati della query.

Esempi di azioni

Esempio: trova il valore maggiore

Questo esempio mostra come eseguire una funzione definita dall'utente;utente. La funzione find_greater in questo esempio confronta due numeri interi e restituisce quello maggiore.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione find_greater, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'esecuzione dell'azione ha esito positivo, il campo connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

[{
"bignum": 5.0
}]

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Esempio: elenca tutti i record Dipendenti

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Employees dall'elenco Entity.
3. Seleziona l'operazione List, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, puoi impostare la filterClause in base ai requisiti del cliente.

Il valore della clausola di filtro deve essere sempre passato tra virgolette singole ("'") in questo formato.
Può essere utilizzato per filtrare i record in base a qualsiasi colonna.

Puoi eseguire l'operazione List sulle seguenti entità:

Cockroach_Datatypes, Accounts, SpatialData, UNICODE, LANGUAGES e View_Cockroach

Esempio: recuperare un record Employees

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Employees dall'elenco Entity.
3. Seleziona l'operazione Get, quindi fai clic su Fine.
4. Imposta l'ID entità su 5, ovvero la chiave da trasferire. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dati, fai clic su Apri editor mappatura dati, inserisci 5 nel campo Valore di input e scegli EntityId come variabile locale.

   Il valore di Entity Id deve essere passato direttamente. Qui 5 è il valore univoco della chiave primaria, che deve essere passato.

   In alcuni casi, il passaggio di un singolo ID entità genererà un errore perché saranno presenti due chiavi composite.
   In questi casi, puoi utilizzare la clausola di filtro e passare il valore, ad esempio EmployeeId='5'.

Puoi eseguire l'operazione List sulle seguenti entità:

Cockroach_Datatypes, Accounts, SpatialData, UNICODE e LANGUAGES

Esempio: elimina un record Dipendenti

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Employees dall'elenco Entity.
3. Seleziona l'operazione Delete, quindi fai clic su Fine.
4. Imposta l'ID entità su 2, ovvero la chiave da trasferire. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dati, fai clic su Apri editor mappatura dati, inserisci 2 nel campo Valore di input e scegli EntityId come variabile locale.

   Se l'entità ha due chiavi aziendali composite o primarie anziché specificare entityId, puoi anche impostare filterClause su EmployeeId='2'.

Puoi eseguire l'operazione di eliminazione sulle seguenti entità:

Cockroach_Datatypes, Accounts, SpatialData, UNICODE e LANGUAGES

Esempio: crea un record Dipendenti

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Employees dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

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

   Se l'integrazione ha esito positivo, il parametro Employees della risposta connectorOutputPayload avrà un valore simile al seguente:

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

Esempio: crea un record Cockroach_Datatypes

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Cockroach_Datatypes dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

   {
     "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"
   }
   

   Se l'integrazione ha esito positivo, il parametro Cockroach_Datatypes della risposta connectorOutputPayload avrà un valore simile al seguente:

   {
     "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"
     }
     

Esempio: crea un record LANGUAGES dell'entità

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona LANGUAGES dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

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

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività LANGUAGES avrà un valore simile al seguente:

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

Esempio: crea un record UNICODE

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona UNICODE dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

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

Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività UNICODE avrà un valore simile al seguente:

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

Esempio: crea un record SpatialData

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona SpatialData dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

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

   Questo esempio creerà i record SpatialData. Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività SpatialData avrà un valore simile al seguente:

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

Esempio: crea un record Account

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Accounts dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload come variabile locale.

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

   Questo esempio creerà i record SpatialData. Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività SpatialData avrà un valore simile al seguente:

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

Esempio: aggiornare un record Dipendenti

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Dipendenti dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

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

5. Imposta l'ID entità in Data Mapper sull'entità Employees . Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su 1.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:

   {
   }
   

Esempio: aggiorna un record LANGUAGES

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona LANGUAGES dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

    {
     "englishtest": "UpdateTest_TEST"
   }
   

5. Imposta l'ID entità in Data Mapper sull'entità degli array. Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su 1.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:

   {
   }
   

Esempio: aggiornare un record UNICODE

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona UNICODE dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

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

5. Imposta l'ID entità in Data Mapper sull'entità di ObjectType . Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su 3.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:

   {
   }
   

Esempio: aggiorna un record SpatialData

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Spatialdata dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   {
   "data": "01020000000500000070CE88D2DE3453C075029A081B164540984C158C4AEA52C0DC68006F81B4444009F9A067B36252C02DB29DEFA7864440FA7E6ABC747B52C0D122DBF97EDA444070CE88D2DE3453C075029A081B164543"
   } 
   

5. Imposta l'ID entità in Data Mapper sull'entità di TableType . Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su id= 1.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:

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

Esempio: aggiornare un record Account

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Accounts dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

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

5. Imposta l'ID entità in Data Mapper sull'entità di TableType . Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su id= 1.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:

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

Esempio: aggiorna un record Cockroach_Datatypes

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Cockroach_Datatypes dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Data Mapper dell'attività Mappatura dati, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

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

5. Imposta l'ID entità in Data Mapper sull'entità di TableType . Per impostare l'ID entità, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli EntityId/ConnectorInputPayload/FilterClause come variabile locale.

   Anziché specificare entityId, puoi anche impostare filterClause su 2.

   L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connettore:

   {
   }