O Apidog oferece suporte à integração direta com bancos de dados, permitindo que você realize operações CRUD dentro dos seus fluxos de trabalho de API. Você pode executar consultas SQL em pré/pós-processadores, aplicar assertivas aos resultados ou extrair dados como variáveis para uso em requisições subsequentes.Primeiros passos#
1
Adicionar processador de banco de dadosNavegue até a seção Pré-processadores ou Pós-processadores da sua requisição e selecione Operação de banco de dados. 2
Configurar operaçãoNomeie a operação e selecione uma Conexão de banco de dados. 3
Inserir comando SQLInsira sua consulta SQL. Você pode usar variáveis como {{variable}} dentro da consulta. 4
Extrair resultados (opcional)Habilite Extrair resultado para variável para salvar os resultados da consulta.Nome da variável: nome da variável.
Expressão JSONPath: use $[0].uid para obter o uid da primeira linha.
5
ExecutarClique em Enviar. Os resultados são exibidos no Console. O Apidog oferece suporte a consultas SQL padrão, mas atualmente não oferece suporte a operações complexas, como procedimentos armazenados, por meio da interface visual.
Conexões de banco de dados#
Bancos de dados compatíveis#
| Nível | Bancos de dados compatíveis |
|---|
| Gratuito | MySQL, SQL Server (2014+), PostgreSQL, Oracle |
| Pago | ClickHouse, MongoDB, Redis |
A conexão a um banco de dados Oracle requer a instalação separada do Oracle Client. Configurar uma conexão#
1
Vá para
Configurações >
Conexões de banco de dados.
2
Clique em + Novo no canto superior direito.
3
Selecione o tipo de banco de dados e insira os detalhes da conexão (Host, Porta, Nome de usuário, Senha, Nome do banco de dados).
4
(Opcional) Configure o
Túnel SSH para conexões seguras.
Privacidade dos dados: as credenciais do banco de dados (endereço, porta, nome de usuário, senha) são armazenadas localmente no seu cliente e não são sincronizadas com a nuvem. Cada membro da equipe deve configurar suas próprias conexões de banco de dados.
Configuração de múltiplos ambientes#
Ao trabalhar com diferentes ambientes (por exemplo, Dev, Teste, Prod), você pode configurar conexões de banco de dados específicas para cada ambiente.1.
Em Conexões de banco de dados, crie conexões separadas para cada ambiente.
2.
Habilite as configurações Específicas do ambiente, se disponíveis, ou simplesmente nomeie-as com clareza.
3.
Ao executar requisições, o Apidog usará a conexão correspondente ao ambiente atualmente selecionado.
Acesso ao banco de dados em scripts#
Para lógica avançada, você pode se conectar a bancos de dados usando scripts JavaScript personalizados.Suporte à CLI#
A CLI do Apidog oferece suporte à execução de cenários de teste com operações de banco de dados. No entanto, como as configurações de banco de dados são locais, você deve exportar o arquivo de configuração do banco de dados e colocá-lo na máquina que executa a CLI. 
