Esecuzione di funzioni SQL definite dall'utente

Sono disponibili diversi metodi per eseguire le funzioni definite dall'utente (UDF) di SQL:

  • Utilizzare l'opzione di menu Esegui come > Db2 for z/OS Routine nel menu a comparsa dell'editor SQL.
  • Utilizzare l'opzione di menu Db2 for z/OS Routine > Call Routine nel menu a comparsa dell'editor SQL.
  • Utilizzate il pulsante della barra degli strumenti Pulsante della barra degli strumenti Esegui Run.
  • Aprire il menu a comparsa di un oggetto UDF nella navigazione del Catalogo e selezionare l'opzione Chiama routine.
  • Fare clic con il pulsante destro del mouse su un file .udfsql nell'Esplora progetti e selezionare Esegui come > Db2 for z/OS Routine.

Tutti i metodi cercano una configurazione di esecuzione esistente di Db2 for z/OS che corrisponda al file nel contesto. Se non esiste una corrispondenza, il tooling crea una configurazione di esecuzione per il file nel contesto e la utilizza. Se necessario, si apre la finestra Esegui routine per richiedere i valori delle variabili o dei parametri. Se l'istruzione SQL è stata eseguita di recente sul database attivo, la finestra può essere popolata con valori recenti per i campi Tipo di dati, Null e Valore.

La finestra di dialogo Parametri di input include le opzioni Carica e Salva, che consentono agli utenti di esportare i valori dei parametri in un file XML o di caricarli in seguito. Questo è particolarmente utile per gli insiemi di parametri di grandi dimensioni o frequentemente riutilizzati. La finestra di dialogo visualizza campi a riga singola per i tipi base e campi a più righe per i tipi XML e LOB.

I risultati dell'operazione UDF sono mostrati nella vista Dettagli sistema remoto e nella finestra di dialogo Stato dell'esecuzione, dove è possibile visualizzare eventuali avvisi o errori e collegarsi a ulteriori informazioni sui codici SQL e sullo stato. Il record della richiesta viene aggiunto anche alla cartella Query History della connessione Db2 for z/OS.

Creare una configurazione di esecuzione

  1. Per aprire la finestra Esegui configurazioni, fare clic su Esegui > Esegui configurazioni.
  2. Nell'elenco di navigazione, fare clic con il tasto destro del mouse su Db2 for z/OS Routine e selezionare Nuova configurazione. Una nuova configurazione viene aggiunta all'elenco di navigazione come figlio di Db2 for z/OS Routine e la nuova pagina di configurazione si apre nel riquadro dell'editor di Run Configurations.
  3. Nella pagina di nuova configurazione, fare clic su Sfoglia, quindi digitare una stringa di ricerca, ad esempio *.udfsql , nel campo di testo. Questa stringa corrisponde a tutte le UDF definite in un progetto z/OS locale o remoto nella vista z/OS Projects.
    Db2 for z/OS Configurazione dell'esecuzione di routine
  4. Selezionare una UDF dall'elenco e fare clic su OK.
  5. Nel campo Nome della pagina di nuova configurazione, digitare un nome per la nuova configurazione.
  6. Per salvare la configurazione di esecuzione, fare clic su Applica.