Accedere e gestire le risorse IBM DB2 usando App per la logica di Azure
Si applica a: App per la logica di Azure (A consumo)
Con App per la logica di Azure e il connettore IBM DB2, è possibile creare attività e flussi di lavoro automatizzati in base alle risorse archiviate nel database DB2. I flussi di lavoro possono connettersi alle risorse nel database, leggere ed elencare le tabelle di database, aggiungere righe, modificarle, eliminarle e altro ancora. È possibile includere azioni nelle app per la logica che ottengono risposte dal database e rendono l'output disponibile per altre azioni.
Questo articolo illustra come creare un'app per la logica che esegue varie operazioni di database. Se non si ha familiarità con le app per la logica, consultare Informazioni su App per la logica di Azure
Piattaforme e versioni supportate
Il connettore DB2 include un client Microsoft che comunica con server DB2 remoti su una rete TCP/IP. È possibile usare questo connettore per accedere ai database cloud, ad esempio IBM DB2 per Windows in esecuzione nella virtualizzazione di Azure. È anche possibile accedere ai database DB2 locali dopo aver installato e configurato il gateway dati locale.
Il connettore IBM DB2 supporta queste piattaforme e versioni IBM DB2 insieme ai prodotti compatibili con IBM DB2 che supportano Distributed Relational Database Architecture (DRDA) SQL Access Manager (SQLAM) versioni 10 e 11:
| Piattaforma | Versione |
|---|---|
| IBM DB2 per z/OS | 12, 11.1, 10.1 |
| IBM DB2 per i | 7.3, 7.2, 7.1 |
| IBM DB2 per LUW | 11, 10.5 |
Operazioni del database supportate
Il connettore IBM DB2 supporta queste operazioni di database, associabili alle azioni corrispondenti nel connettore:
| Operazione di database | Azione del connettore |
|---|---|
| Visualizzazione di un elenco delle tabelle di database | Ottieni tabelle |
| Lettura di una riga con SELECT | Ottenere la riga |
| Lettura di tutte le righe con SELECT | Ottieni righe |
| Aggiunta di una riga con INSERT | Inserimento di una riga |
| Modifica di una riga con UPDATE | Aggiorna riga |
| Rimozione di una riga con DELETE | Elimina riga |
Prerequisiti
Account e sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, iscriversi per creare un account Azure gratuito.
Un database IBM DB2, basato sul cloud o locale
Conoscenza di base di come creare le app per la logica. Per altre informazioni, vedere Creare un esempio di flusso di lavoro dell'app per la logica di consumo
L'app per la logica in cui si intende accedere al database DB2. Questo connettore offre solo azioni, quindi per avviare l'app per la logica, usare un trigger distinto, ad esempio il trigger Ricorrenza. Gli esempi di questo articolo usano il trigger Ricorrenza.
Aggiungere un'azione DB2 - Ottieni tabelle
Nel portale di Azure aprire l'app per la logica in Progettazione app per la logica, se non è già aperta.
Nel trigger scegliere Nuovo passaggio.
Nella casella di ricerca immettere "db2" come filtro. Per questo esempio, nell'elenco di azioni, selezionare questa azione: Ottieni tabelle (anteprima)
A questo punto viene chiesto di fornire i dettagli della connessione per il database DB2.
Seguire questi passaggi per la creazione di connessioni per database cloud o database locali.
Connettersi a DB2 - Cloud
Per configurare la connessione, specificare questi dettagli quando richiesto, scegliere Crea e quindi salvare l'app per la logica:
| Proprietà | Richiesto | Descrizione |
|---|---|---|
| Connettersi tramite gateway locale | No | Si applica solo alle connessioni locali. |
| Nome connessione | Sì | Il nome della connessione, ad esempio, "MyLogicApp-DB2-connection" |
| Server | Sì | Numero di porta dell'indirizzo o dei due punti alias per il server DB2, ad esempio "myDB2server.cloudapp.net:50000" Nota: questo valore è una stringa che rappresenta un alias o un indirizzo TCP/IP, in formato IPv4 o IPv6, seguito da due punti e un numero di porta TCP/IP. |
| Database | Sì | Nome del database Nota: questo valore è una stringa che rappresenta un nome di database relazionale DRDA (RDBNAM): - DB2 per z/OS accetta una stringa di 16 byte, in cui il database è definito come posizione di IBM DB2 per z/OS. |
| Nome utente | Sì | Nome utente per il database Nota: questo valore è una stringa la cui lunghezza è basata sul database specifico: - DB2 per z/OS accetta una stringa di 8 byte. |
| Password | Sì | La password amministrativa per il database |
Ad esempio:
Connettersi a DB2 - Locale
Prima di creare la connessione, è necessario aver già installato il gateway dati locale. In caso contrario non sarà possibile completare la configurazione della connessione. Con un'installazione del gateway, continuare fornendo questi dettagli di connessione e scegliere Create.
| Proprietà | Richiesto | Descrizione |
|---|---|---|
| Connettersi tramite gateway locale | Sì | Si applica quando si desidera una connessione locale e mostra le proprietà della connessione locale. |
| Nome connessione | Sì | Il nome della connessione, ad esempio, "MyLogicApp-DB2-connection" |
| Server | Sì | Numero di porta dell'indirizzo o dei due punti per il server DB2, ad esempio "myDB2server:50000" Nota: questo valore è una stringa che rappresenta un alias o un indirizzo TCP/IP, in formato IPv4 o IPv6, seguito da due punti e un numero di porta TCP/IP. |
| Database | Sì | Nome del database Nota: questo valore è una stringa che rappresenta un nome di database relazionale DRDA (RDBNAM): - DB2 per z/OS accetta una stringa di 16 byte, in cui il database è definito come posizione di IBM DB2 per z/OS. |
| Autenticazione | Sì | Tipo di autenticazione per la connessione, ad esempio "Basic" Nota: selezionare questo valore dall'elenco, che include Base o Windows (Kerberos). |
| Nome utente | Sì | Nome utente per il database Nota: questo valore è una stringa la cui lunghezza è basata sul database specifico: - DB2 per z/OS accetta una stringa di 8 byte. |
| Password | Sì | La password amministrativa per il database |
| Gateway | Sì | Nome del gateway dati locale installato Nota: selezionare questo valore dall'elenco, che include tutti i gateway dati installati all'interno del gruppo di risorse e della sottoscrizione di Azure. |
Ad esempio:
Visualizzare le tabelle di output
Per eseguire manualmente l'app per la logica, sulla barra degli strumenti di progettazione scegliere Esegui. Al termine dell'esecuzione dell'app per la logica sarà possibile visualizzare l'output dell'esecuzione.
Selezionare Panoramica dal menu dell'app per la logica.
In Riepilogo, nella sezione Cronologia esecuzioni, selezionare l'esecuzione più recente, ovvero il primo elemento nell'elenco.
In Esecuzione dell'app per la logica è ora possibile esaminare lo stato, gli input e gli output per ogni passaggio nell'app per la logica. Espandere l'azione Ottieni tabelle.
Per visualizzare gli input, scegliere Mostra input non elaborati.
Per visualizzare gli output, scegliere Mostra output non elaborati.
Gli output includono un elenco di tabelle.
Ottenere la riga
Per recuperare un record in una tabella di database DB2, usare l'azione Ottieni riga nell'app per la logica.
Questa azione esegue un'istruzione SELECT WHERE DB2, ad esempio SELECT FROM AREA WHERE AREAID = '99999'.
Se non sono mai state usate azioni DB2 nell'app per la logica, rivedere i passaggi nella sezione Aggiungere un'azione DB2 - Ottieni tabelle, ma aggiungere l'azione Ottieni riga e tornare qui per continuare.
Dopo aver aggiunto l'azione Ottieni riga, ecco come verrà visualizzata l'app per la logica di esempio:
Specificare valori per tutte le proprietà obbligatorie (*). Dopo aver selezionato una tabella, l'azione mostrerà le proprietà pertinenti specifiche per i record al suo interno.
Proprietà Richiesto Descrizione Nome tabella Sì La tabella che contiene il record desiderato, ad esempio "AREA" in questo esempio ID area Sì L'ID che contiene il record desiderato, ad esempio "99999" in questo esempio 
Al termine, nella barra degli strumenti della finestra di progettazione scegliere Salva.
Visualizzare la riga di output
Per eseguire manualmente l'app per la logica, sulla barra degli strumenti di progettazione scegliere Esegui. Al termine dell'esecuzione dell'app per la logica sarà possibile visualizzare l'output dell'esecuzione.
Selezionare Panoramica dal menu dell'app per la logica.
In Riepilogo, nella sezione Cronologia esecuzioni, selezionare l'esecuzione più recente, ovvero il primo elemento nell'elenco.
In Esecuzione dell'app per la logica è ora possibile esaminare lo stato, gli input e gli output per ogni passaggio nell'app per la logica. Espandere l'azione Ottieni riga.
Per visualizzare gli input, scegliere Mostra input non elaborati.
Per visualizzare gli output, scegliere Mostra output non elaborati.
Gli output includono la riga specificata.
Ottieni righe
Per recuperare tutti i record in una tabella di database DB2, usare l'azione Ottieni righe nell'app per la logica.
Questa azione esegue un'istruzione SELECT DB2, ad esempio SELECT * FROM AREA.
Se non sono mai state usate azioni DB2 nell'app per la logica, rivedere i passaggi nella sezione Aggiungere un'azione DB2 - Ottieni tabelle, ma aggiungere l'azione Ottieni righe e tornare qui per continuare.
Dopo aver aggiunto l'azione Ottieni righe, ecco come verrà visualizzata l'app per la logica di esempio:
Aprire l'elenco Nome tabella e selezionare la tabella desiderata, ovvero "AREA" in questo esempio:
Per specificare un filtro o eseguire una query per i risultati, scegliere Mostra opzioni avanzate.
Al termine, nella barra degli strumenti della finestra di progettazione scegliere Salva.
Visualizzare le righe di output
Per eseguire manualmente l'app per la logica, sulla barra degli strumenti di progettazione scegliere Esegui. Al termine dell'esecuzione dell'app per la logica sarà possibile visualizzare l'output dell'esecuzione.
Selezionare Panoramica dal menu dell'app per la logica.
In Riepilogo, nella sezione Cronologia esecuzioni, selezionare l'esecuzione più recente, ovvero il primo elemento nell'elenco.
In Esecuzione dell'app per la logica è ora possibile esaminare lo stato, gli input e gli output per ogni passaggio nell'app per la logica. Espandere l'azione Ottieni righe.
Per visualizzare gli input, scegliere Mostra input non elaborati.
Per visualizzare gli output, scegliere Mostra output non elaborati.
L'output include tutti i record nella tabella specificata.
Inserimento di una riga
Per aggiungere un singolo record in una tabella di database DB2, usare l'azione Ottieni riga nell'app per la logica.
Questa azione esegue un'istruzione INSERT DB2, ad esempio INSERT INTO AREA (AREAID, AREADESC, REGIONID) VALUES ('99999', 'Area 99999', 102).
Se non sono mai state usate azioni DB2 nell'app per la logica, rivedere i passaggi nella sezione Aggiungere un'azione DB2 - Ottieni tabelle, ma aggiungere l'azione Inserisci riga e tornare qui per continuare.
Dopo aver aggiunto l'azione Inserisci riga, ecco come verrà visualizzata l'app per la logica di esempio:
Specificare valori per tutte le proprietà obbligatorie (*). Dopo aver selezionato una tabella, l'azione mostrerà le proprietà pertinenti specifiche per i record al suo interno.
Ecco le proprietà per l'esempio:
Proprietà Richiesto Descrizione Nome tabella Sì La tabella in cui aggiungere il record, ad esempio "AREA" ID area Sì L'ID per l'area da aggiungere, ad esempio "99999" Area description (Descrizione area) Sì La descrizione dell'area da aggiungere, ad esempio "Area 99999" Region ID (ID area) Sì L'ID dell'area da aggiungere, ad esempio "102" Ad esempio:
Al termine, nella barra degli strumenti della finestra di progettazione scegliere Salva.
Visualizzare gli output di Inserisci riga
Per eseguire manualmente l'app per la logica, sulla barra degli strumenti di progettazione scegliere Esegui. Al termine dell'esecuzione dell'app per la logica sarà possibile visualizzare l'output dell'esecuzione.
Selezionare Panoramica dal menu dell'app per la logica.
In Riepilogo, nella sezione Cronologia esecuzioni, selezionare l'esecuzione più recente, ovvero il primo elemento nell'elenco.
In Esecuzione dell'app per la logica è ora possibile esaminare lo stato, gli input e gli output per ogni passaggio nell'app per la logica. Espandere l'azione Inserisci riga.
Per visualizzare gli input, scegliere Mostra input non elaborati.
Per visualizzare gli output, scegliere Mostra output non elaborati.
Gli output includono tutti i record aggiunti alla tabella specificata.
Aggiorna riga
Per aggiornare un singolo record in una tabella di database DB2, usare l'azione Aggiorna riga nell'app per la logica.
Questa azione esegue un'istruzione UPDATE DB2, ad esempio UPDATE AREA SET AREAID = '99999', AREADESC = 'Updated 99999', REGIONID = 102).
Se non sono mai state usate azioni DB2 nell'app per la logica, rivedere i passaggi nella sezione Aggiungere un'azione DB2 - Ottieni tabelle, ma aggiungere l'azione Aggiorna riga e tornare qui per continuare.
Dopo aver aggiunto l'azione Aggiorna riga, ecco come verrà visualizzata l'app per la logica di esempio:
Specificare valori per tutte le proprietà obbligatorie (*). Dopo aver selezionato una tabella, l'azione mostrerà le proprietà pertinenti specifiche per i record al suo interno.
Ecco le proprietà per l'esempio:
Proprietà Richiesto Descrizione Nome tabella Sì La tabella in cui aggiornare il record, ad esempio "AREA" ID riga Sì L'ID del record da aggiornare, ad esempio "99999" ID area Sì Il nuovo ID di area, ad esempio "99999" Area description (Descrizione area) Sì La nuova descrizione di area, ad esempio "Updated 99999" (99999 aggiornata) Region ID (ID area) Sì Il nuovo ID di area, ad esempio "102" Ad esempio:
Al termine, nella barra degli strumenti della finestra di progettazione scegliere Salva.
Visualizzare gli output di Aggiorna riga
Per eseguire manualmente l'app per la logica, sulla barra degli strumenti di progettazione scegliere Esegui. Al termine dell'esecuzione dell'app per la logica sarà possibile visualizzare l'output dell'esecuzione.
Selezionare Panoramica dal menu dell'app per la logica.
In Riepilogo, nella sezione Cronologia esecuzioni, selezionare l'esecuzione più recente, ovvero il primo elemento nell'elenco.
In Esecuzione dell'app per la logica è ora possibile esaminare lo stato, gli input e gli output per ogni passaggio nell'app per la logica. Espandere l'azione Aggiorna riga.
Per visualizzare gli input, scegliere Mostra input non elaborati.
Per visualizzare gli output, scegliere Mostra output non elaborati.
Gli output includono i record aggiornati nella tabella specificata.
Elimina riga
Per eliminare un singolo record da una tabella di database DB2, usare l'azione Elimina riga nell'app per la logica.
Questa azione esegue un'istruzione DELETE DB2, ad esempio DELETE FROM AREA WHERE AREAID = '99999'.
Se non sono mai state usate azioni DB2 nell'app per la logica, rivedere i passaggi nella sezione Aggiungere un'azione DB2 - Ottieni tabelle, ma aggiungere l'azione Elimina riga e tornare qui per continuare.
Dopo aver aggiunto l'azione Elimina riga, ecco come verrà visualizzata l'app per la logica di esempio:
Specificare valori per tutte le proprietà obbligatorie (*). Dopo aver selezionato una tabella, l'azione mostrerà le proprietà pertinenti specifiche per i record al suo interno.
Ecco le proprietà per l'esempio:
Proprietà Richiesto Descrizione Nome tabella Sì La tabella in cui eliminare il record, ad esempio "AREA" ID riga Sì L'ID del record da eliminare, ad esempio "99999" Ad esempio:
Al termine, nella barra degli strumenti della finestra di progettazione scegliere Salva.
Visualizzare gli output di Elimina riga
Per eseguire manualmente l'app per la logica, sulla barra degli strumenti di progettazione scegliere Esegui. Al termine dell'esecuzione dell'app per la logica sarà possibile visualizzare l'output dell'esecuzione.
Selezionare Panoramica dal menu dell'app per la logica.
In Riepilogo, nella sezione Cronologia esecuzioni, selezionare l'esecuzione più recente, ovvero il primo elemento nell'elenco.
In Esecuzione dell'app per la logica è ora possibile esaminare lo stato, gli input e gli output per ogni passaggio nell'app per la logica. Espandere l'azione Elimina riga.
Per visualizzare gli input, scegliere Mostra input non elaborati.
Per visualizzare gli output, scegliere Mostra output non elaborati.
Gli output non includono più il record eliminato dalla tabella specificata.
Informazioni di riferimento sui connettori
Per altri dettagli tecnici su questo connettore, ad esempio trigger, azioni e limiti, come descritto dal file Swagger del connettore, vedere la pagina di riferimento del connettore.