Esegui una stored procedure

Questo esempio mostra come eseguire una stored procedure quando si utilizza una connessione di database. L'esempio presuppone che tu abbia familiarità con i seguenti concetti:

• Creazione di integrazioni mediante Application Integration
• Attività del connettore
• Integration Connectors
• Stored procedure del database

Tutte le stored procedure in una connessione di database ti vengono mostrate sotto forma di azioni Attività del connettore: Un'azione è una prima funzione di classe resa disponibile per l'integrazione tramite l'interfaccia del connettore. Azioni consentono di apportare modifiche a una o più entità e variare da connettore a connettore. Tuttavia, è possibile che un connettore non supporta alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

I seguenti connettori supportano le stored procedure:

• BigQuery
• Cloud SQL - MySQL
• Cloud SQL - PostgreSQL
• Cloud SQL - SQL Server
• MySQL
• DB Oracle
• PostgreSQL
• SQL Server
• MariaDB
• AlloyDB
• Snowflake
• Redshift

Esempio

Supponiamo di avere un database MySQL con la seguente stored procedure che recupera le informazioni di un cliente dalla tabella customers:

CREATE PROCEDURE get_customer_info
(IN p_customer_id INT, OUT p_name VARCHAR(50), OUT p_email VARCHAR(255))
BEGIN
    SELECT name, email INTO p_name, p_email
    FROM customers
    WHERE id = p_customer_id;
END

Questa stored procedure restituisce il nome e l'email del cliente specificato. Prende l'ID cliente tramite la variabile di input p_customer_id e restituisce il nome e l'email nelle variabili di output p_name e p_email, rispettivamente.

Supponiamo ora che tu voglia ottenere il nome e l'ID indirizzo email del cliente con customer_id=1001. Devi svolgere le seguenti attività:

1. Crea una connessione al tuo database MySQL.
2. Apri o crea una nuova integrazione.
3. Aggiungi l'attività Connettori all'integrazione.
4. Nella sezione Configurazione, fai clic su Configura attività per aprire il riquadro Configura attività di collegamento.
5. Configura l'attività Connettori in modo da utilizzare la connessione creata nel passaggio 1.
   1. Nella colonna Connessione, seleziona la connessione richiesta dall'elenco delle connessioni disponibili.

      Dopo aver selezionato una connessione, viene visualizzata la colonna Tipo con i valori. Entities e Actions. Tutte le procedure memorizzate verranno elencate in Azioni.

   2. Seleziona Azioni > get_customer_info.
   3. Fai clic su Fine per completare la configurazione della connessione e chiudere il riquadro.
6. Fai clic sull'elemento dell'attività Connectors e poi su connectorInputPayload nella sezione Task Input.
7. Specifica il seguente payload JSON nel campo Default Value:

   {
   "customer_id": 1001
   }

8. Fai clic sul pulsante Testa nella barra degli strumenti dell'Editor integrazioni per eseguire l'integrazione.

   Se l'integrazione viene eseguita correttamente, la variabile connectorOutputPayload avrà un payload JSON simile al seguente:

   {
   "name": "John",
   "email": "[e-mail]"
   }