Executar um procedimento armazenado

Neste exemplo, mostramos como executar um procedimento armazenado quando você está usando uma conexão de banco de dados. O exemplo pressupõe que você esteja familiarizado com os seguintes conceitos:

• Como criar integrações usando a Application Integration
• Tarefa do conector
• Conectores de integração
• Procedimentos armazenados no banco de dados

Todos os procedimentos armazenados em uma conexão de banco de dados são expostos a você como ações na Tarefa do conector. Uma ação é uma função de primeira classe que é disponibilizada para a integração por meio da interface do conector. Com as ações, é possível fazer alterações em uma ou mais entidades, variando de acordo com o conector. No entanto, é possível que o conector não ofereça suporte a nenhuma ação. Nesse caso, a lista Actions estará vazia.

Os seguintes conectores são compatíveis com procedimentos armazenados:

• BigQuery
• Cloud SQL - MySQL
• Cloud SQL - PostgreSQL
• Cloud SQL – SQL Server
• MySQL
• Banco de dados Oracle
• PostgreSQL
• SQL Server
• MariaDB
• AlloyDB
• Snowflake
• Redshift

Exemplo

Imagine que você tem um banco de dados MySQL com o seguinte procedimento armazenado, que recebe as informações de um cliente da tabela 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

Este procedimento armazenado retorna o nome e o e-mail do cliente especificado. Ele recebe o ID do cliente pela variável de entrada p_customer_id e retorna o nome e o e-mail nas variáveis de saída p_name e p_email, respectivamente.

Agora, suponha que você queira saber o nome e o ID de e-mail do cliente com customer_id=1001. Realize as seguintes tarefas:

1. Crie uma conexão com o banco de dados MySQL.
2. Abra ou crie uma integração.
3. Adicione a tarefa de conectores à sua integração.
4. Na seção Configuração, clique em Configurar tarefa para abrir o painel Configurar a tarefa do conector.
5. Configure a tarefa Conectores para usar a conexão criada na etapa 1.
   1. Na coluna Conexão, selecione a conexão necessária na lista de conexões disponíveis.

      Depois de selecionar uma conexão, a coluna Type é exibida com os valores Entities e Actions. Todos os procedimentos armazenados serão listados em Ações.

   2. Selecione Actions > get_customer_info.
   3. Clique em Concluído para concluir a configuração da conexão e feche o painel.
6. Clique no elemento de tarefa Connectors e, em seguida, clique em connectorInputPayload na seção Task Input.
7. Especifique o seguinte payload JSON no campo Default Value:

   {
   "customer_id": 1001
   }

8. Clique no botão Test na barra de ferramentas do editor de integração para executar a integração.

   Se a integração for executada corretamente, o connectorOutputPayload vai ter um payload JSON semelhante a este:

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