Fontes de dados

Conectar Supabase, PostgreSQL, MySQL, SQL Server, Snowflake e Databricks, escolher as tabelas expostas e acompanhar a conexão.

Uma fonte de dados é um banco que o Rowgate lê para responder às perguntas da equipe. Toda fonte é usada em modo somente leitura e a credencial fica guardada criptografada.

Conectar um banco

Em Fontes de dados, clique em Adicionar fonte e escolha o tipo de banco.
Dê um nome à fonte (por exemplo, “ERP” ou “Produção”).
Preencha os dados de conexão (veja abaixo, por banco) e clique em Testar conexão.
Com o teste aprovado, clique em Continuar, marque as tabelas que a IA pode consultar e clique em Salvar com N tabelas.

O número de fontes depende do plano. No limite, o botão Adicionar fonte fica desligado até você contratar uma conexão adicional em Configurações.

Supabase

Informe a URL do projeto (https://<projeto>.supabase.co) e a chave de serviço (service_role). Os dois ficam no Supabase em Project Settings › API.

O Rowgate lê os schemas que a API do projeto publica. Para incluir outro schema além do public, adicione-o em Project Settings › Data API › Exposed schemas e clique em Reler estrutura no Rowgate.

PostgreSQL, MySQL e SQL Server

Informe host, porta, banco, usuário e senha. O servidor precisa aceitar conexões de fora com SSL (no SQL Server, criptografia).

SSL: “Exigir SSL” cifra a conexão. “Exigir SSL e verificar o certificado” é mais seguro, mas o certificado precisa ser de uma autoridade reconhecida e valer para aquele host.
Rede: o endereço precisa ser público. Hosts que apontam para uma rede interna (localhost ou IP privado) são recusados.
Versões: MySQL 8 e MariaDB; SQL Server 2017 ou mais novo e Azure SQL.

Snowflake

Informe a conta (identificador orgname-accountname, em Snowsight › Admin › Accounts), o usuário, o warehouse, o banco e, se quiser, o papel (vazio usa o papel padrão do usuário).

A autenticação pode ser por par de chaves (recomendado: cole a chave privada PEM sem senha e cadastre a chave pública no usuário do Snowflake) ou por token de acesso programático, gerado em Snowsight › Settings › Authentication.

Databricks

Informe o endereço do workspace, o caminho do SQL warehouse, o catálogo do Unity Catalog e um token de acesso. Use um service principal com permissão só de leitura no catálogo.

Usuário só de leitura

Recomendamos um usuário de banco dedicado ao Rowgate, com permissão apenas de leitura nas tabelas que serão liberadas. A tela de conexão traz o comando pronto em Como criar um usuário só de leitura. Para PostgreSQL, por exemplo:

CREATE ROLE rowgate_leitor LOGIN PASSWORD '<senha forte>';
GRANT USAGE ON SCHEMA public TO rowgate_leitor;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO rowgate_leitor;

PostgreSQL: repita os dois GRANT para cada schema que a IA pode ler.
MySQL: GRANT SELECT, SHOW VIEW ON <banco>.* para o usuário, criado com REQUIRE SSL.
SQL Server: um login com o papel db_datareader no banco. No Azure SQL, rode o CREATE LOGIN no banco master.
Snowflake: um papel com USAGE no warehouse, no banco e no schema e SELECT nas tabelas.
Databricks: CAN USE no warehouse e USE CATALOG, USE SCHEMA e SELECT no Unity Catalog.

Mesmo com um usuário com mais permissões, o Rowgate só envia consultas de leitura. No PostgreSQL e no MySQL, cada consulta roda numa transação somente leitura; no SQL Server, numa transação que é sempre desfeita no final.

Escolher as tabelas expostas

Abra a fonte (botão Tabelas) para ver todas as tabelas, agrupadas por schema, e ligar ou desligar cada uma. Só tabelas expostas podem entrar num perfil de acesso.

Tabela desligada fica invisível para todos os perfis.
Tabela ou schema novo encontrado numa releitura entra desligado: nada novo fica visível sem você ligar.

Reler a estrutura

Criou uma tabela ou uma coluna no banco? Na página da fonte, clique em Reler estrutura. O Rowgate também confere cada fonte automaticamente de tempos em tempos.

Status da conexão

Operacional: a última verificação passou.
Com falha: o banco não respondeu ou recusou o acesso. A mensagem com o motivo aparece no cartão da fonte. Veja Solução de problemas.
Pausada: você pausou a fonte no menu ⋯ › Pausar fonte. Para voltar, use Retomar fonte.

O cartão também mostra as tabelas expostas, a latência da última verificação e quando ela aconteceu.