Teradata

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

Questo connettore supporta l'esecuzione delle seguenti azioni:

• Funzioni e stored procedure definite dall'utente. Se nel backend sono presenti stored procedure e funzioni, queste vengono elencate nella colonna Actions della finestra di dialogo Configure connector task.
• Query SQL personalizzate. Per eseguire query SQL personalizzate, il connettore fornisce l'azione Esegui 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.

Tipi di dati supportati

Di seguito sono riportati i tipi di dati supportati per questo connettore:

• BIGINT
• BINARY
• BIT
• BOOLEANO
• CHAR
• DATA
• DECIMALE
• DOUBLE
• FLOAT
• INTEGER
• LONGN VARCHAR
• LONG VARCHAR
• NCHAR
• NUMERIC
• NVARCHAR
• REAL
• SMALL INT
• TEMPO
• TIMESTAMP
• TINY INT
• VARBINARY
• VARCHAR

Esempi di azioni

Questa sezione descrive come eseguire alcune delle azioni in questo connettore.

Esempio: esegui una query Raggruppa per

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione ExecuteCustomQuery, 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:

   {
   "query": "select E.EMPLOYEE_ID,E.EMPLOYEE_NAME,E.CITY from EMPLOYEES E LEFT JOIN EMPLOYEE_DEPARTMENT ED ON E.EMPLOYEE_ID=ED.ID where E.EMPLOYEE_NAME = 'John' Group by E.CITY,E.EMPLOYEE_ID,E.EMPLOYEE_NAME"
   }

Questo esempio seleziona i record dei dipendenti dalle tabelle EMPLOYEES e EMPLOYEE_DEPARTMENT. Se l'azione va a buon fine, il parametro connectorOutputPayload della risposta dell'attività del connettore conterrà il set di risultati della query.

Esempio: esecuzione di una query con parametri

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione ExecuteCustomQuery, 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:

   {
   "query": "select C.ID,C.NAME,C.CITY,C.O_DATE,E.EMPLOYEE_ID from customqueries C,Employees E where C.ID=E.Employee_id and C.NAME=?",
   "queryParameters": [{
         "value": "John",
         "dataType": "VARCHAR"
   }],
   "timeout":10,
   "maxRows":3
   }

Questo esempio seleziona i record dei dipendenti in cui il nome del dipendente è John. Tieni presente che il nome del dipendente è parametrizzato utilizzando il parametro queryParameters. Se l'azione ha esito positivo, il parametro connectorOutputPayload della risposta dell'attività del connettore avrà un valore simile al seguente:

[{
"NAME": "John",
"O_DATE": "2023-06-01 00:00:00.0",
"EMPLOYEE_ID": 1.0
}, {
"NAME": "John",
"O_DATE": "2021-07-01 00:00:00.0",
"EMPLOYEE_ID": 3.0
}, {
"NAME": "John",
"O_DATE": "2022-09-01 00:00:00.0",
"EMPLOYEE_ID": 4.0
}]

Esempio: inserisci un record utilizzando un valore di sequenza

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione ExecuteCustomQuery, 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:

   {
   "query": "INSERT INTO AUTHOR(id,title) VALUES(author_table_id_seq.NEXTVAL,'Sample_book_title')"
   }

Questo esempio inserisce un record nella tabella AUTHOR utilizzando un oggetto sequenza author_table_id_seq esistente. Se l'azione ha esito positivo, il parametro connectorOutputPayload della risposta dell'attività del connettore avrà un valore simile al seguente:

[{
}]

Esempio: esecuzione di una query con una funzione aggregata

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione ExecuteCustomQuery, 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:

   {
   "query": "SELECT SUM(SALARY) as Total FROM EMPLOYEES"
   }

Questo esempio calcola il valore aggregato degli stipendi nella tabella EMPLOYEES. Se l'azione ha esito positivo, il parametro connectorOutputPayload della risposta dell'attività del connettore avrà un valore simile al seguente:

[{
"TOTAL": 13000.0
}]  
  

Esempio: crea una nuova tabella

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione ExecuteCustomQuery, 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:

   {
   "query": "CREATE TABLE TEST1 (ID INT, NAME VARCHAR(40),DEPT VARCHAR(20),CITY VARCHAR(10))"
   }

Questo esempio crea la tabella TEST1. Se l'azione ha esito positivo, il parametro connectorOutputPayload della risposta dell'attività del connettore avrà un valore simile al seguente:

[{
}]

Esempi di operazioni sulle entità

Esempio: elenca tutti i dipendenti

Questo esempio elenca tutti i dipendenti nell'entità Employee.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Employee dall'elenco Entity.
3. Seleziona l'operazione List, quindi fai clic su Fine.
4. (Facoltativo) Nella sezione Input attività dell'attività Connettori, puoi filtrare il set di risultati specificando una clausola di filtro.

Esempio: recuperare i dettagli del dipendente

Questo esempio recupera i dettagli del dipendente con l'ID specificato dall'entità Employee.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Employee dall'elenco Entity.
3. Seleziona l'operazione Get, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su EntityId e poi inserisci 45 nel campo Valore predefinito.

   In questo caso, 45 è il valore della chiave primaria dell'entità Employee.

Esempio: crea una scheda dipendente

Questo esempio aggiunge un nuovo record dipendente nell'entità Employee.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Employee dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "EMPLOYEE_ID": 69.0,
   "EMPLOYEE_NAME": "John",
   "CITY": "Bangalore"
   }

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

    {
   "ROWID": "AAAoU0AABAAAc3hAAF"
   }

Esempio: aggiornare la scheda di un dipendente

Questo esempio aggiorna il record del dipendente il cui ID è 69 nell'entità Employee.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Employee dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "EMPLOYEE_NAME": "John",
   "CITY": "Mumbai"
   }

5. Fai clic su entityId, quindi inserisci 69 nel campo Valore predefinito.

   In alternativa, anziché specificare entityId, puoi anche impostare filterClause su 69.

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

   {
   }

Esempio: eliminare la scheda di un dipendente

Questo esempio elimina il record del dipendente con l'ID specificato nell'entità Employee.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Employee dall'elenco Entity.
3. Seleziona l'operazione Delete, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su entityId e poi inserisci 35 nel campo Valore predefinito.