Attività Esegui query

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.

Aggiunta di Esegui query nell'orchestrazione

  1. Creare oppure aprire un'orchestrazione. Viene visualizzata una rappresentazione grafica dell'orchestrazione.
  2. Selezionare la scheda Attività ed espandere la cartella Database.
  3. Trascinare l'attività Esegui query nell'orchestrazione.
  4. Selezionare l'attività Esegui query.

Creazione, selezione o modifica di un endpoint del database

  1. Fare clic sull'attività Seleziona endpoint dall'Elenco di controllo e scegliere una delle seguenti azioni:
    • Selezionare un endpoint esistente:
      1. Selezionare Sfoglia. Viene visualizzato Esplora progetto.
      2. Selezionare un endpoint esistente e fare clic su OK. Passare alla procedura Specificare l'istruzione SQL query.
    • Selezionare un endpoint esistente e modificarlo:
      1. Selezionare Sfoglia. Viene visualizzato Esplora progetto.
      2. Selezionare un endpoint esistente e fare clic su OK
      3. Fare clic su Modifica. Viene visualizzato il pannello Modifica endpoint.
    • Creare un endpoint: selezionare Nuovo. Viene visualizzato il pannello Crea endpoint.
  2. Creazione o modifica di un endpoint del database

Specificare l'istruzione SQL query

  1. Selezionare l'attività Immetti query dall'Elenco di controllo. Viene visualizzato il pannello Immetti query.
  2. Immettere la query nello spazio vuoto visualizzato nel pannello. Non inserire punto e virgola alla fine della query.
  3. 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.
  4. 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.
    Nota: alcuni caratteri double-byte non vengono convertiti mediante la codifica SHIFT-JIS. Per ulteriori informazioni, consultare Utilizzo della codifica Shift-JIS.
  5. 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.
  6. 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.

Configurazione dei parametri di input per la query

  1. Selezionare l'attività Imposta parametri di input dall'Elenco di controllo. Il pannello Imposta parametri di input mostra il parametro o i parametri di input della query.
  2. 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.
  3. Fare clic nell'intestazione della colonna per ordinare le righe in base al valore della colonna. Ad esempio, per ordinare le righe in base al nome della colonna, fare clic sull'intestazione Nome colonna della colonna. Viene visualizzata una freccia sulla destra del nome di intestazione della colonna. Una freccia verso l'alto indica che la colonna è ordinata in ordine alfabetico, a cominciare dalla a fino alla z. Una freccia verso il basso indica che la colonna è ordinata in ordine alfabetico inverso, a cominciare dalla z fino alla a. Fare clic sulla freccia per invertire l'ordine alfabetico.
  4. Se necessario, modificare le impostazioni dei valori Tipo di dati, Codifica o Valore null supportato per ogni parametro di input di query. Fare clic nel campo per effettuare una nuova selezione:
    • Nome parametro - È possibile modificare il nome predefinito con un nome più indicativo. I parametri sono elencati nell'ordine in cui sono specificati nella query.
    • Tipo di dati - Selezionare un tipo di dati per questo parametro.
      Nota: (per i tipi di dati MONEY e XMLTYPE) per il tipo di dati XMLTYPE in un database Oracle e i tipi di dati MONEY in un database SQL Server, Studio non associa automaticamente il tipo di dati corretto, quindi è necessario selezionare manualmente il tipo di dati appropriato.
    • Codifica - Selezionare un'impostazione alternativa di codifica dei caratteri per il parametro, se la codifica richiesta è diversa dalla codifica predefinita per il database.
    • Dimensione — La dimensione della colonna definita nella tabella. Tale dimensione viene richiamata dalla tabella di database e non può essere configurata.
  5. Fare clic su Reimposta valori per interrogare il database e acquisire i tipi di dati e la dimensione dal database. Questa azione sovrascrive le impostazioni per il tipo di dati e la dimensione immesse manualmente nel pannello.

Configurazione dei parametri di output

  1. Selezionare l'attività Imposta insieme di risultati dall'Elenco di controllo. Il pannello Imposta insieme di risultati viene visualizzato e vengono elencati i valori predefiniti per il parametro o i parametri di output della query.
  2. 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.
  3. Se necessario, modificare le impostazioni dei valori Tipo di dati, Codifica o Valore null supportato per ogni parametro di output di query:
    • Nome parametro - È possibile modificare il nome predefinito con un nome più indicativo. I parametri sono elencati nell'ordine in cui sono specificati nella query.
    • Tipo di dati - Selezionare un tipo di dati per questo parametro.
    • Codifica - Selezionare un'impostazione alternativa di codifica dei caratteri per il parametro, se la codifica richiesta è diversa dalla codifica predefinita per il database.
    • Dimensione — La dimensione della colonna definita nella tabella. Tale dimensione viene richiamata dalla tabella di database e non può essere configurata.
  4. Fare clic su Reimposta valori per interrogare il database e acquisire i tipi di dati e la dimensione dal database. Questa azione sovrascrive le impostazioni per il tipo di dati e la dimensione immesse manualmente nel pannello.

Specifica delle opzioni dei tentativi per la query

Per specificare le opzioni dei tentativi per la query:
  1. 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'input dell'attività

  1. Selezionare l'attività Associa input nell'Elenco di controllo. I parametri di input specificati per la query sono i parametri di input per l'attività. I parametri di input dell'attività vengono visualizzati sotto l'elemento parameters nel pannello A attività.
  2. È necessario associare tutti i parametri di input dell'attività. Per istruzioni generiche relative all'associazione, consultare Creazione di un'associazione.

Associazione dell'output dell'attività

  1. 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à.
  2. Non è necessario associare i parametri di output dell'attività. Per istruzioni generiche relative all'associazione, consultare Creazione di un'associazione.