Durante il runtime, l'attività Esegui query esegue un'istruzione SQL SELECT.
L'attività Esegui query supporta le query con parametri - una query che contiene parametri di input o parametri di input e di output. Quando sono specificati i parametri di input in una query, il valore del parametro viene fornito durante il runtime. Il carattere ? nell'istruzione SELECT di esempio di seguito, specifica che esiste un parametro di input:
select * from myUserSchema.mySourceTable where myUserSchema.mySourceTable.myColumn=?
Nell'istruzione SELECT precedente, il carattere
* specifica che la query restituisce la colonna o le colonne trovate nella tabella
mySourceTable come il parametro o i parametri di output. Ad esempio, se
mySource table contiene due colonne, una di tipo CHAR e una di tipo VARCHAR, l'attività
Esegui query restituisce due parametri di output, uno di tipo CHAR e l'altro di tipo VARCHAR.
Nota: solo l'istruzione SQL SELECT è supportata nell'attività Esegui query.
L'istruzione SQL INSERT non è supportata nell'attività Esegui query.
I passi per aggiungere e configurare un'attività
Esegui query in
un'orchestrazione, vengono descritti nelle seguenti procedure:
Aggiunta di Esegui query nell'orchestrazione
- Creare oppure
aprire un'orchestrazione. Viene visualizzata una rappresentazione grafica
dell'orchestrazione.
- Selezionare la scheda Attività ed espandere la cartella
Database.
- Trascinare l'attività Esegui query nell'orchestrazione.
- Selezionare l'attività Esegui query.
Creazione, selezione o modifica di un endpoint del database
- Fare clic sull'attività Seleziona endpoint dall'Elenco di controllo e
scegliere una delle seguenti azioni:
- Selezionare un endpoint esistente:
- Selezionare Sfoglia. Viene visualizzato Esplora progetto.
- Selezionare un endpoint esistente e fare clic su OK.
Passare alla procedura Specificare l'istruzione SQL query.
- Selezionare un endpoint esistente e modificarlo:
- Selezionare Sfoglia. Viene visualizzato Esplora progetto.
- Selezionare un endpoint esistente e fare clic su OK
- Fare clic su Modifica. Viene visualizzato il pannello Modifica
endpoint.
- Creare un endpoint: selezionare Nuovo. Viene visualizzato il pannello Crea
endpoint.
- Creazione o modifica di un endpoint del database
Specificare l'istruzione SQL query
- Selezionare l'attività Immetti query dall'Elenco di controllo.
Viene visualizzato il pannello Immetti query.
- Immettere la query nello spazio vuoto visualizzato nel pannello. Non inserire punto e virgola alla fine della query.
- Fare clic su Visualizza colonne per esaminare i dettagli della colonna per una tabella selezionata, come supporto per la creazione dell'istruzione SQL, immettendo nomi di tabella e colonne validi.
- Selezionare un'impostazione alternativa di codifica dei caratteri per i parametri di input e di output, se la codifica desiderata è diversa dalla codifica predefinita per il database, utilizzando una delle seguenti opzioni:
- Dall'elenco Codifica, selezionare uno dei tipi di
codifica predefiniti.
- Immettere il tipo di codifica direttamente, facendo clic nel campo Codifica e digitando il tipo di codifica.
- Fare clic su Convalida query. Questa azione controlla se la
query è valida e popola i parametri di input e di output nelle attività
Associa input e Associa output.
- Immettere un valore nel campo Numero massimo di righe. Il campo Numero massimo di righe specifica il numero massimo di righe che la query deve restituire durante il runtime.
Nota: se la stessa query viene avviata più volte sugli stessi dati, viene restituito lo stesso insieme di righe. Ad esempio, se Numero massimo di righe è uguale a 1, la stessa riga (la prima riga) viene sempre restituita ogni volta che si avvia la query - non esiste iterazione nonostante l'insieme di righe.
Specifica delle opzioni dei tentativi per la query
Per specificare le opzioni dei tentativi per la query:
- Configurare le Opzioni dei tentativi.
Nota: per l'attività Esegui query database, se si imposta l'opzione dei tentativi su zero, il dispositivo di integrazione tenta di nuovo la connessione indefinitamente.
Associazione dell'output dell'attività
- Selezionare l'attività Associa output nell'Elenco di controllo.
Le colonne restituite dall'istruzione SELECT sono gli elementi visualizzati sotto l'elemento rows/row nel pannello Da attività.
- Non è necessario associare i parametri di output dell'attività.
Per istruzioni generiche relative all'associazione, consultare
Creazione di un'associazione.