Executar consulta personalizada

Esta página mostra como executar uma consulta SQL personalizada. Para executar uma consulta personalizada, tem de conhecer os seguintes conceitos:

• Criar integrações com a integração de aplicações
• Tarefa de conetor
• Conetores de integração
• Consultas SQL

A função Execute custom query é-lhe apresentada como uma ação na Connector task. Uma ação é uma função de primeira classe que é disponibilizada à integração através da interface do conector. As ações permitem-lhe fazer alterações a uma ou mais entidades e variam de conetor para conetor. No entanto, é possível que um conector não suporte nenhuma ação, caso em que a lista Actions está vazia.

Os seguintes conetores suportam consultas personalizadas:

• BigQuery
• Cloud SQL – MySQL
• Cloud SQL – PostgreSQL
• Cloud SQL – SQL Server
• Couchbase
• Elasticsearch
• MySQL
• Oracle DB
• PostgreSQL
• Salesforce
• SQL Server
• Snowflake
• Spanner
• Teradata

Crie uma consulta personalizada

Para criar uma consulta personalizada, siga estes passos:

1. Siga as instruções detalhadas para adicionar uma tarefa de conetores.
2. Quando configurar a tarefa do conetor, no tipo de ação que quer realizar, selecione Ações.
3. Na lista Ação, selecione Executar consulta personalizada e, de seguida, clique em Concluído.

   

4. Expanda a secção Entrada de tarefas e, de seguida, faça o seguinte:
   1. No campo Tempo limite após, introduza o número de segundos a aguardar até que a consulta seja executada.

      Valor predefinido: 180 segundos.

   2. No campo Número máximo de linhas, introduza o número máximo de linhas a devolver da base de dados.

      Valor predefinido: 25.

   3. Para atualizar a consulta personalizada, clique em Editar script personalizado. É apresentada a caixa de diálogo Editor de scripts.

      

   4. Na caixa de diálogo Editor de scripts, introduza a consulta SQL e clique em Guardar.

      Pode usar um ponto de interrogação (?) numa declaração SQL para representar um único parâmetro que tem de ser especificado na lista de parâmetros de consulta. Por exemplo, a seguinte consulta SQL seleciona todas as linhas da tabela Employees que correspondem aos valores especificados para a coluna LastName:

      SELECT * FROM Employees where LastName=?

      Nota: as declarações de linguagem de manipulação de dados (DML) e linguagem de definição de dados (DDL) são suportadas.
   5. Se usou pontos de interrogação na sua consulta SQL, tem de adicionar o parâmetro clicando em + Adicionar nome do parâmetro para cada ponto de interrogação. Durante a execução da integração, estes parâmetros substituem os pontos de interrogação (?) na consulta SQL sequencialmente. Por exemplo, se adicionou três pontos de interrogação (?), tem de adicionar três parâmetros por ordem de sequência.

      

      Para adicionar parâmetros de consulta, faça o seguinte:

      1. Na lista Tipo, selecione o tipo de dados do parâmetro.
      2. No campo Valor, introduza o valor do parâmetro.
      3. Para adicionar vários parâmetros, clique em + Adicionar parâmetro de consulta.

   A ação Executar consulta personalizada não suporta variáveis de matriz.