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:

• Creazione di integrazioni utilizzando Application Integration
• Attività del connettore
• Connettori di integrazione
• stored procedure del database

Tutte le stored procedure in una connessione al database sono esposte come azioni nell'attività connettore. Un'azione è una funzione di prima classe resa disponibile all'integrazione tramite l'interfaccia del connettore. Le azioni consentono di apportare modifiche a una o più entità e variano da connettore a connettore. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

I seguenti connettori supportano stored procedure:

• BigQuery
• Cloud SQL - MySQL
• Cloud SQL - PostgreSQL
• Cloud SQL - SQL Server
• MySQL
• DB Oracle
• PostgreSQL
• SQL Server
• MariaDB
• AlloyDB
• Snowflake
• Spostamento verso il rosso

Esempio

Supponi di avere un database MySQL con la seguente stored procedure che riceve 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'indirizzo email del cliente specificato. Recupera l'ID cliente tramite la variabile di input p_customer_id e restituisce il nome e l'indirizzo email nelle variabili di output p_name e p_email, rispettivamente.

Ora supponi di voler ricevere il nome e l'ID email del cliente con customer_id=1001, devi completare 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à del connettore.
5. Configura l'attività Connettori in modo che utilizzi la connessione creata nel passaggio 1.
   1. Nella colonna Connessione, seleziona la connessione richiesta dall'elenco di connessioni disponibili.

      Dopo aver selezionato una connessione, viene visualizzata la colonna Tipo con i valori Entities e Actions. Tutte le stored procedure saranno 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 attività Connectors, quindi fai clic su connectorInputPayload nella sezione Task Input.
7. Specifica il seguente payload JSON nel campo Default Value:

   {
   "customer_id": 1001
   }

8. Fai clic sul pulsante Test nella barra degli strumenti dell'editor delle integrazioni per eseguire l'integrazione.

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

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