Banco de dados
Quando os dados estão num banco e não há uma API na frente, você conecta o banco direto. A plataforma só lê: nunca grava nada nele.
No workspace Aurora Imóveis, o conector Banco do sistema de locação é um PostgreSQL. Dele vêm os contratos, os boletos de aluguel e os documentos de cada inquilino.
Bancos suportados
| Tipo | Bancos |
|---|---|
| SQL | PostgreSQL, MySQL, MariaDB, SQL Server |
| NoSQL | MongoDB |
Outros bancos aparecem na lista como em breve.
Conectar um banco
- Em Dados › Conectores, clique em Conectar fonte e abra a aba Banco de Dados.
- Escolha o Tipo (SQL ou NoSQL) e o Banco.
- Preencha a conexão:
| Campo | O que informar |
|---|---|
| Host e Porta | O endereço do servidor, como db.exemplo.com.br, e a porta (a padrão do banco já vem preenchida) |
| Database | O nome do banco, como locacao |
| Usuário e Senha | O usuário que a plataforma usa para ler |
| Connection string | Só no MongoDB: a string de conexão completa, em vez de host e porta |
| SSL/TLS | Conecta com criptografia |
| Verificar certificado | Confere o certificado do servidor (só com SSL/TLS ligado) |
- Clique em Testar conexão para conferir.
- Clique em Conectar e sincronizar.
O teste conecta no banco e lista as tabelas e views (ou coleções, no MongoDB) que o usuário enxerga. Elas aparecem na aba Tabelas e views da página do conector.
Sempre somente leitura
A opção Somente leitura (sempre) vem marcada e não pode ser desligada. Além de só fazer consultas, a plataforma abre a sessão em modo de leitura quando o banco permite.
Mesmo assim, crie um usuário só de leitura, com permissão de SELECT apenas nas tabelas que o portal precisa. No exemplo da Aurora Imóveis, o usuário é portal_leitura.
Rede
O banco precisa aceitar conexões da plataforma pela internet:
- Libere os IPs de saída da Kobana no firewall do banco.
- O host precisa apontar para um endereço público. Endereços internos (como
localhostou IPs de rede privada) são recusados.
Tabelas ou consultas SQL
Uma entidade pode ler de duas formas:
- Uma tabela, view ou coleção — escolha na lista, em Criar entidade. Você também pode filtrar quais linhas entram (veja Sincronização das entidades).
- Uma consulta SQL — escreva um
SELECT, comJOINse precisar. É o que a Aurora Imóveis usa para juntar contratos e imóveis. Veja Consultas SQL.
Ao editar o conector, o banco escolhido fica fixo; o resto da conexão pode ser trocado. Deixe a senha (ou a connection string) em branco para manter a salva.