O Apidog suporta integração direta com bases de dados, permitindo-lhe realizar operações CRUD nos seus fluxos de trabalho de API. Pode executar consultas SQL em processadores Pre/Post, fazer asserções sobre os resultados ou extrair dados como variáveis para utilização em pedidos subsequentes.Introdução#
1
Adicionar processador de base de dadosNavegue até à secção Pre Processors ou Post Processors do seu pedido e selecione Database Operation. 2
Configurar operaçãoAtribua um nome à operação e selecione uma Database Connection. 3
Introduzir comando SQLIntroduza a sua consulta SQL. Pode utilizar variáveis como {{variable}} dentro da consulta. 4
Extrair resultados (opcional)Ative Extract Result To Variable para guardar os resultados da consulta.Nome da variável: nome da variável.
Expressão JSONPath: utilize $[0].uid para obter o uid da primeira linha.
5
ExecutarClique em Send. Os resultados são apresentados na Console. O Apidog suporta consultas SQL padrão, mas atualmente não suporta operações complexas, como procedimentos armazenados, através da interface visual.
Ligações a bases de dados#
Bases de dados suportadas#
| Nível | Bases de dados suportadas |
|---|
| Gratuito | MySQL, SQL Server (2014+), PostgreSQL, Oracle |
| Pago | ClickHouse, MongoDB, Redis |
A ligação a uma base de dados Oracle requer a instalação separada do Oracle Client. Configurar uma ligação#
1
Aceda a
Settings >
Database Connections.
2
Clique em + New no canto superior direito.
3
Selecione o tipo de base de dados e introduza os detalhes da ligação (Host, Port, Username, Password, Database Name).
4
(Opcional) Configure
SSH Tunnel para ligações seguras.
Privacidade dos dados: as credenciais da base de dados (endereço, porta, nome de utilizador, palavra-passe) são armazenadas localmente no seu cliente e não são sincronizadas com a cloud. Cada membro da equipa tem de configurar as suas próprias ligações a bases de dados.
Configuração multiambiente#
Ao trabalhar com diferentes ambientes (por exemplo, Dev, Test, Prod), pode configurar ligações a bases de dados específicas do ambiente.1.
Em Database Connections, crie ligações separadas para cada ambiente.
2.
Ative as definições Environment Specific, se disponíveis, ou simplesmente atribua-lhes nomes claros.
3.
Ao executar pedidos, o Apidog utilizará a ligação correspondente ao ambiente atualmente selecionado.
Acesso à base de dados em scripts#
Para lógica avançada, pode ligar-se a bases de dados utilizando scripts JavaScript personalizados.Suporte de CLI#
A Apidog CLI suporta a execução de cenários de teste com operações de base de dados. No entanto, uma vez que as configurações da base de dados são locais, tem de exportar o ficheiro de configuração da base de dados e colocá-lo na máquina que executa a CLI. 
