🛠️ Como conectar
- Vá para Configurações do Chat > Integrações > Banco de dados SQL.
- Clique em Conectar e preencha os detalhes do seu banco de dados:
- Nome e descrição: Um nome amigável e uma descrição para ajudar a IA a entender que dados estão contidos.
- Moeda (opcional): A moeda principal usada para valores monetários em suas tabelas, auxiliando a IA a formatar e interpretar dados financeiros.
- Host e porta: O endereço do servidor de banco de dados e a porta (o padrão é
5432para PostgreSQL). - Banco de dados: O nome do seu banco de dados.
- Usuário e senha: Suas credenciais do banco de dados (de preferência, somente leitura).
- Modo SSL: Selecione
requireoudisable.
- Clique em Testar para verificar as credenciais e ver quantas tabelas foram encontradas.
- Clique em Salvar para concluir.
Conectar um banco de dados Supabase
O Supabase mostra dois tipos de detalhes de conexão. Use o de pooler.- No seu projeto Supabase, clique em Conectar no topo do painel.
- Abra a guia Session pooler.
- Copie os valores para o formulário:
Preencha os detalhes da conexão
Clique no botão Conectar para abrir o formulário e preencher os seguintes campos:⚙️ Gerenciando sua integração
Clique em Configurações no cartão do seu Banco de dados SQL ativo para gerenciar o seguinte:- Selecionar tabelas para compartilhar: Escolha quais tabelas ou views o Attlas pode ler. O Attlas verifica esta lista a cada consulta e bloqueia qualquer tabela que você não compartilhou, independentemente do que seu usuário de banco de dados tem permissão para ler.
- Instruções: Escreva as regras que o Attlas deve seguir com seus dados (veja abaixo).
- Atualizar schema: Após adicionar ou alterar tabelas ou colunas, clique em Atualizar para sincronizá-las.
- Desativar temporariamente: Ative ou desative a integração com o botão de alternância.
- Desconectar: Remova a conexão com o banco de dados.
Instruções
A descrição diz o que o seu banco de dados contém. As instruções dizem como usá-lo. Escreva uma regra por linha, até 1.000 caracteres:Esquemas
O Attlas lê todos os esquemas do seu banco de dados, não apenas opublic. Tabelas fora do public aparecem como schema.tabela, por exemplo cms.projects. Os esquemas internos do Supabase (auth, storage, realtime, vault e similares) nunca são lidos.
Conexões existentes só veem novos esquemas após você clicar em Atualizar schema. Sua seleção atual de tabelas permanece inalterada.
💡 Boas práticas para o schema do banco de dados
Para ajudar o Attlas a escrever consultas precisas e realizar cálculos exatos, considere estas dicas de design de schema:- Use tipos de coluna precisos: Se você deseja que o chat realize cálculos, como somas, médias ou proporções, em dados numéricos, garanta que essas colunas usem um tipo numérico, como
numeric,decimal,integeroufloat. Evite armazenar números como texto, comovarcharoutext, pois isso torna os cálculos mais difíceis e menos precisos. - Adicione comentários nas colunas: Use comentários de banco de dados em suas tabelas e colunas. Adicionar uma breve descrição diretamente a uma coluna, por exemplo
COMMENT ON COLUMN users.status IS 'Active statuses: active, suspended, pending', fornece contexto crucial que orienta o Attlas a escrever as consultas SQL corretas.
🔒 Boas práticas de segurança
Para manter seus dados seguros, recomendamos fortemente:- Compartilhe apenas o necessário: O Attlas rejeita qualquer consulta que acesse uma tabela que você não compartilhou. Mantenha desmarcadas as tabelas com dados pessoais ou credenciais.
- Views precisam de suas tabelas de origem: Uma view que você compartilha lê de outras tabelas. Essas tabelas também devem ser compartilhadas.
- Use um usuário somente leitura: Crie um usuário de banco de dados com apenas permissões
SELECT. O Attlas só envia consultas de leitura, e um usuário somente leitura adiciona uma segunda camada de proteção. - Mantenha o SSL ativado: Defina
sslmodecomorequirepara criptografar os dados em trânsito.

