Como escrever uma função de conector SQL
  • 31 Oct 2023
  • 3 Minutos para Ler
  • Contribuintes

Como escrever uma função de conector SQL


Resumo do artigo

Como escrever uma função de conector SQL

Use este guia para conectar seu aplicativo Tulip a um banco de dados SQL.

Veja um exemplo de como usar o recurso Connectors da Tulip para se conectar a um banco de dados SQL.

Para adicionar um novo Conector SQL:

1- Vá para a página Conectores colocando o cursor sobre Apps na barra de menu e escolhendo Conectores no menu suspenso.

2- Clique em "Add Connector" (Adicionar conector) no canto superior direito da tela, dê um nome ao conector e selecione "SQL" como o tipo de conector.

3- Na guia Environments (Ambientes) do novo conector, selecione "Add Connection Details" (Adicionar detalhes da conexão).

4- Preencha os detalhes apropriados para se conectar ao banco de dados:

  • Em execução ("Host do Cloud Connector", a menos que você tenha definido uma configuração diferente)
  • Tipo
  • Servidor
  • Porta
  • SSL (sim ou não)
  • Banco de dados
  • Nome de usuário
  • Senha

5- Clique no botão Test para executar um sinal de teste. Se o teste for bem-sucedido, clique em "Save".

6- Certifique-se de que o Connector Host tenha acesso ao banco de dados (indicado pelo rótulo verde "Online" ao lado do servidor na página Connectors)

Depois de configurar com êxito um novo conector, você poderá criar Connector Functions para enviar ou recuperar dados do banco de dados externo. Uma função de conector deve ser escrita no idioma relevante do banco de dados de destino.

Para configurar uma nova função de conector SQL:

1- Clique no botão "Add New Function" (Adicionar nova função) na guia Functions (Funções).

2- Nomeie a nova função (isso permite que você escolha a função de conector específica em Triggers).

  1. Configure as entradas e saídas da função

No exemplo acima:

Entradas

  • configuração (texto)

Saídas

  • subconfig_1
  • subconfig_2
  • subconfig_3

Consulta

`SELECT subconfig_1, subconfig_2, subconfig_3 FROM webinar database WHERE configuration = $configuration$ order by id desc limit 1`````

Uma função pode ter várias entradas e saídas. Você precisará de pelo menos uma entrada ou saída para enviar/receber dados de um aplicativo Tulip.

  • Clique em Add para adicionar uma nova entrada ou saída
  • Dê ao campo um nome reconhecível
  • Escolha o tipo de dados (por exemplo, Texto, Booleano, Inteiro, etc.)
  • Adicione uma instrução SQL válida no campo Query (Consulta). Observe que os nomes das variáveis de entrada devem estar embrulhados em $. Exemplo:
    $input$.
  • Teste a função
  • Se a função tiver entradas, insira valores válidos
  • Clique em "Test" (Teste) no canto superior direito.
  • Visualize os resultados do teste ou as mensagens de erro na seção Resultados do teste

  1. Em alguns casos, talvez você queira retornar várias linhas de uma tabela SQL. Para fazer isso, marque a caixa ao lado de "Return Multiple Rows" (Retornar várias linhas). Isso retornará uma matriz cheia de objetos, em que cada objeto contém valores de uma linha na tabela SQL.

Consulta

SELECT name, num from numbers where num > $number$

(no exemplo acima, número é um input)

Em seguida, quando você adicionar seus inputs e clicar em "Test" (Testar), deverá ver todas as linhas esperadas retornadas em "Test Results" (Resultados do teste).

Esses resultados podem ser armazenados em uma variável como uma matriz cheia de objetos no Trigger Editor.

7- Pressione "Save" (Salvar) quando terminar.

:::(Warning) (OBSERVAÇÃO) As entradas e saídas não podem ser alteradas depois de salvar uma função. Isso é para evitar interrupções nos aplicativos que possam estar usando uma função de conector.
:::

Se você precisar adicionar novas entradas/saídas, poderá copiar a função e fazer alterações na nova função.

Para obter mais informações sobre como escrever algumas funções SQL comumente usadas, consulte"Funções comuns do conector SQL".

Leitura adicional


Encontrou o que estava procurando?

Você também pode ir para community.tulip.co para postar sua pergunta ou ver se outras pessoas tiveram uma pergunta semelhante!


Este artigo foi útil?