Esegui una stored procedure

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

• Creare integrazioni utilizzando Application Integration
• Attività del connettore
• Integration Connectors
• Stored procedure del database

Tutte le procedure memorizzate in una connessione al database sono esposte come azioni nell'attività del connettore. Un'azione è una funzione di prima classe resa disponibile all'integrazione tramite l'interfaccia del connettore. Le azioni ti consentono di apportare modifiche a una o più entità e variano da un connettore all'altro. Tuttavia, è possibile che un connettore non supporti 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
• Oracle DB
• 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 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à Connectors in modo che utilizzi 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]"
   }