Conectores
Dados e Armazenamento

SQL-Mongo

15min
objetivo/resumo a api fluid conector sql/mongo oferece uma interface simplificada e padronizada para executar operações em bancos de dados sql e mongodb seu objetivo é facilitar o acesso e manipulação de dados, permitindo que desenvolvedores realizem consultas e inserções de forma eficiente e segura esta documentação fornece informações detalhadas sobre como fazer requisições, os parâmetros necessários, e os campos específicos para cada operação além disso, inclui instruções sobre como configuração de conexão e os dados de configuração necessários seja para consultas simples, inserções de dados complexas ou operações avançadas como filtragem e ordenação, a api fluid conector sql/mongo simplifica o processo de interação com bancos de dados, tornando o desenvolvimento mais ágil e eficaz criando um fluxo utilizando conector sql/mongo para criar um fluxo utilizando o conector sql/mongo, é preciso criar uma conexão e em seguida configurar o fluxo configurando conexão sql/mongo acesse nosso passo a passo para criar conexão docid 1pcvn0mjbfkujhmhj86k estes são os seguintes parâmetros de configuração da conexão sql/mongo que serão requisitados em sua criação nome parâmetro padrão em qualquer criação de uma conexão, te ajudará a identificar melhor sua conexão (campo obrigatório) descrição este campo é opcional, mas pode ser útil para fornecer detalhes sobre a finalidade da conexão driver selecione o driver apropriado para sua conexão mongo selecione esta opção se estiver se conectando a um banco de dados mongodb você precisará fornecer a url de conexão e o nome do banco de dados snowflake se estiver conectando ao snowflake, forneça a url de conexão postgresql/mysql/sql server/oracle se estiver se conectando a um dos bancos de dados mencionados, especifique o tipo de driver necessário (postgresql/mssql/mysql/sql server/oracle) e a url de conexão correspondente certifique se de preencher esses parâmetros corretamente para estabelecer uma conexão bem sucedida segue alguns exemplos de urls de configuração exemplo de url de configuração para snowflake { 	"url" "usuario\ senha\@url dos snowflake/banco de dados?schema=schema se necessario\&warehouse=warehouse se necessario" } exemplo de url de configuração para sqlserver { "url" "sqlserver //user$ password\@1localhost 1433?database=db\&connection+timeout=30", } exemplo de url de configuração para postgres { "url" "user\ password\@tcp(localhost 1433)/database", } configurando fluxo sql/mongo ao configurar um fluxo sql/mongo, é necessário realizar a parametrização de três configurações essenciais operação nesta etapa, você define a operação que deseja executar as opções disponíveis incluem select utilizado para realizar consultas no banco de dados insert usado para inserir dados no banco de dados sql permite que você utilize consultas sql personalizadas para selecionar dados utilize os campos adicionais fornecidos para configurar sua consulta argumentos aqui, você define o que vai utilizado no corpo da requisição que pode ser enviado utilizando template docid\ treajh8tvdyh6ukyeaqzp ou de/para docid\ voqdaukjjknbswvrhbzqw para configurar a busca no banco com o conector tabela este campo requer o nome da tabela que será afetada pela operação definida certifique se de fornecer o nome correto da tabela para garantir que a operação seja realizada no local desejado operação insert configurando o template a operação de inserção (insert) serve para adicionar dados em uma determinada tabela de um banco de dados para realizar esta operação, é necessário configurar uma lista de objetos onde cada chave representa uma coluna da tabela e cada valor é o dado a ser inserido nessa coluna a estrutura do payload para a operação de inserção deve ser uma lista de objetos json cada objeto na lista representa uma linha a ser inserida na tabela e cada chave valor no objeto representa uma coluna e o respectivo valor a ser inserido a seguir, apresentamos um exemplo de como deve ser estruturado o payload json para a operação de inserção \[ { "id" 1, "name" "joão", "age" 30, "email" "joao\@example com" }, { "id" 2, "name" "maria", "age" 25, "email" "maria\@example com" } ] operação sql configurando o template ao configurar os argumentos no template, é importante entender o payload padrão reconhecido pela nossa aplicação este payload inclui statement neste campo, definimos a query sql a ser executada, os argumentos a serem passados na query e as colunas a serem retornadas ou inseridas args esta é uma lista de variáveis de busca que precisam ser incluídas na cláusula where da query cada argumento substitui um ponto de interrogação (?) na query, conforme exemplificado abaixo out este campo indica como você espera receber a resposta dos dados do conector segue abaixo um exemplo do template utilizado \[ { "statement" "select coluna tabela 1, coluna tabela 2, coluna tabela 3 from nome da tabela where coluna tabela 1 = ? ", "args" \["filtro da busca"], "out" \[ { "name" "coluna tabela 1", "as" "int"}, { "name" "coluna tabela 2", "as" "string"}, { "name" "coluna tabela 3", "as" "string"} ] } ] na prática neste tópico, vamos criar um fluxo para demonstrar como funciona a consulta de dados em um banco utilizando nosso conector exemplo de caso vamos criar um fluxo para buscar dados do banco utilizando o conector passo 'buscardados' aqui está a parametrização do nosso primeiro e único passo observe que utilizamos a operação sql , os argumentos template e a tabela com a qual iremos trabalhar o próximo passo é a criação do template segue um exemplo de uso assim que executarmos o fluxo, teremos a requisição e a resposta com os dados buscados este é um exemplo básico de como criar um fluxo para buscar dados em um banco utilizando nosso conector caso queira utilizar o tratamento de erros docid\ s8tskaolyiismac7tczhc para este conector, o código do status sempre será 400 conclusão a api fluid conector sql/mongo é uma ferramenta poderosa que oferece uma interface simplificada e padronizada para executar operações em bancos de dados sql e mongodb ao facilitar o acesso e manipulação de dados, ela permite que desenvolvedores realizem consultas e inserções de forma eficiente e segura esta documentação fornece um guia detalhado sobre como fazer requisições, configurar conexões e criar fluxos de trabalho utilizando o conector ao seguir os passos descritos aqui, os usuários podem configurar facilmente suas conexões, definir operações e parametrizar argumentos para obter os resultados desejados seja para consultas simples, inserções complexas ou operações avançadas como filtragem e ordenação, a api fluid conector sql/mongo simplifica o processo de interação com bancos de dados, tornando o desenvolvimento mais ágil e eficaz com uma abordagem clara e exemplos práticos, esperamos que esta documentação seja útil para todos os usuários que desejam aproveitar ao máximo os recursos oferecidos pelo conector