# Bancos de dados e data warehouses

> Conecte um banco de dados ou data warehouse e faça perguntas em linguagem simples. Dvina apenas lê os dados, e cada consulta é verificada antes de ser executada.

Conecte seu banco de dados ou data warehouse e pergunte como perguntaria a um colega. Dvina encontra as tabelas certas, escreve a consulta e mostra a resposta.

## O que Dvina pode fazer

- **Responder em linguagem simples.** Pergunte "Quais regiões perderam clientes recorrentes no último trimestre?" e Dvina encontra as tabelas, escreve a consulta e mostra a resposta, muitas vezes com um gráfico e a tabela abaixo dele.
- **Mapear suas tabelas.** Dvina aprende como suas tabelas se relacionam, para que você nunca precise especificar um join.
- **Mostrar do seu jeito.** Altere a apresentação de uma resposta: **Tabela**, **Linha**, **Área**, **Barras**, **Barras horizontais**, **Pizza**, **Rosca**, **Radar** ou **Área polar**.
- **Guardar uma resposta.** Salve qualquer resposta como um insight e abra novamente sempre que precisar.

Você pode conectar 20 bancos de dados e data warehouses, incluindo PostgreSQL, MySQL, SQL Server, Snowflake, BigQuery, Redshift e Databricks.

Para usar um banco de dados em uma mensagem, digite <kbd>/</kbd> no campo de mensagem e selecione o banco.

## Permissões

Os bancos de dados e data warehouses que você conecta são somente leitura por definição.

- **Apenas uma leitura por consulta:** Antes de ser executada, cada consulta é verificada para garantir que faça apenas uma leitura. Seus dados permanecem como estão.
- **Nenhuma alteração:** Se você pedir que Dvina altere ou exclua dados, Dvina informa que apenas lê e pode oferecer, como alternativa, uma lista dos dados mencionados no pedido.
- **Acesso da sua conta:** Dvina vê as tabelas que a conta usada para conectar ao banco de dados pode ler. Se nenhuma tabela aparecer, peça ao administrador do banco de dados que verifique o acesso de leitura dessa conta.
- **Linhas e colunas por pessoa:** Ao compartilhar uma tabela, as regras de acesso podem mostrar a cada pessoa apenas algumas linhas e ocultar colunas. Consulte [Controle quais linhas e colunas as pessoas podem ver](/docs/connectors/row-and-column-access).

> [!TIP]
> Conecte usando uma conta do banco de dados que tenha apenas acesso de leitura. Dvina nunca grava dados, e uma conta somente leitura garante isso também no banco de dados.

## Como conectar

1. Abra **Bancos de dados** na sua Biblioteca e selecione **Conectar um banco de dados**. Você também pode selecionar **Adicionar contexto** na sua Biblioteca e depois **Bancos de dados**.
2. Encontre seu banco de dados ou data warehouse. Você pode pesquisar pelo nome.
3. Selecione **Conectar**.
4. Insira um **Nome da fonte** e os detalhes de conexão, como **Host**, **Porta**, **Banco de dados**, **Nome de usuário** e **Senha**. Alguns data warehouses pedem outros detalhes, como uma conta, um projeto ou um arquivo de conta de serviço.
5. Em **Criptografia (SSL)**, selecione **Verificada**, **Obrigatória** ou **Desativada**.
6. Para que Dvina procure como suas tabelas se relacionam, ative **Encontrar relacionamentos entre tabelas**. Isso pode levar algum tempo em bancos de dados grandes.
7. Selecione **Conectar**.

Dvina verifica a conexão e descobre suas tabelas. Cada tabela indica quando está **Pronta para perguntas**, e você pode acompanhar o progresso na página do banco de dados.

### Se a conexão falhar

Dvina informa o que deu errado. As soluções mais comuns:

- **O banco de dados rejeitou as credenciais:** Verifique o nome de usuário, a senha e o método de autenticação.
- **O endereço aponta para uma rede privada ou interna:** Use o nome de host público ou o endereço IP público do banco de dados.
- **Não foi possível estabelecer a conexão criptografada:** Se o banco de dados usa um certificado autoassinado, selecione **Obrigatória** em vez de **Verificada**. Se ele não oferece suporte a SSL, selecione **Desativada**.
- **Não foi possível acessar o banco de dados:** Verifique a disponibilidade, o acesso à rede, o host e a porta.

Para alterar os detalhes depois, abra o banco de dados e selecione **Editar conexão** e depois **Verificar novamente**.

## Veja como suas tabelas se relacionam

Abra **Bancos de dados** na sua Biblioteca, abra o banco de dados e selecione o cartão dele, o primeiro da página. O painel **Esquema do banco de dados** mostra uma visão geral do banco de dados:

- **Conexão:** os detalhes do banco de dados, como **Host**, **Porta** e **Usuário**, e seu **Status**: **Conectado** ou **Não foi possível conectar**, com a indicação de quando foi verificado pela última vez. Selecione **Verificar novamente** para verificar agora.
- **Relacionamentos:** se o Dvina já buscou como suas tabelas se conectam. Selecione **Encontrar relacionamentos** ou **Buscar novamente** para iniciar uma busca.
- **O diagrama:** cada tabela aparece como um cartão com suas colunas, as chaves no topo e uma linha para cada relacionamento entre tabelas. Passe o cursor sobre uma linha para destacar as duas colunas que ela conecta. Selecione uma tabela para abri-la.

Para encontrar uma tabela ou coluna, use **Encontrar uma tabela ou coluna**. Para ver o diagrama em tela cheia, selecione **Expandir**.

No diagrama, **PK** indica uma chave primária e **FK**, uma chave estrangeira. Uma linha contínua representa um relacionamento declarado pelo banco de dados ou um relacionamento confirmado e usado em consultas. Uma linha tracejada indica um relacionamento **Sugerido**: um relacionamento que o Dvina encontrou nos seus dados e que ainda não é usado.

### Revise os relacionamentos que o Dvina encontrou

1. No diagrama, selecione uma linha tracejada.
2. Confira as duas colunas que ela conecta.
3. Selecione **Confirmar** para usar o relacionamento em consultas ou **Descartar** se ele estiver incorreto. Um relacionamento descartado não será sugerido novamente.

### Bancos de dados grandes

- A busca por relacionamentos conta as linhas das suas tabelas, por isso pode demorar um pouco. Em bancos de dados com mais de 100 tabelas, o Dvina não faz a busca automaticamente, mesmo que você tenha ativado **Encontrar relacionamentos entre tabelas**. Selecione **Encontrar relacionamentos** quando estiver pronto.
- Quando um banco de dados tem mais de 40 tabelas, o diagrama mostra uma tabela e suas vizinhas. Faça uma busca para focar em outra tabela.

## Salve e atualize insights

Um insight guarda a resposta a uma pergunta para que você possa abri-la novamente com dados atualizados.

1. No cartão da resposta, selecione como você quer vê-la, por exemplo, **Tabela** ou **Barras**.
2. Selecione **Salvar**. O Dvina mostra **Salvo como insight**. No celular, selecione **Expandir** primeiro e depois **Salvar** no painel lateral.
3. Para abrir o insight, selecione **Salvo**. Você também pode encontrá-lo no seu Feed.

O insight é aberto no painel lateral. Nele, você pode:

- **Renomear:** clique no nome no topo e digite um novo.
- **Alterar a visualização:** selecione outra apresentação ou uma tabela dinâmica. A nova visualização é salva com o insight.
- **Atualizar:** abra o menu do painel e selecione **Atualizar** para executar novamente com os dados mais recentes.
- **Baixar:** abra o menu do painel e selecione **Baixar**.
- **Excluir:** abra o menu do painel e selecione **Excluir**. O insight é movido para a Lixeira, onde você pode restaurá-lo.

### Insights compartilhados

Ao compartilhar um insight, selecione **Pode editar** ou **Pode visualizar** para cada pessoa.

- **Pessoas que podem editar** também podem atualizar o insight.
- **Pessoas que podem visualizar** só podem vê-lo. Elas podem alterar a visualização na própria tela, mas a alteração não é salva, e veem as mensagens **Somente editores podem atualizar** e **Somente editores podem renomear**.

Se as regras de acesso de uma tabela limitarem o que uma pessoa pode ver, ela receberá um resultado próprio do insight, marcado como **Visualização restrita**. Consulte [Controle quais linhas e colunas as pessoas podem ver](/docs/connectors/row-and-column-access).

## Privacidade

- O que você conecta nunca é usado para treinar modelos de IA.
- Apenas o que sua solicitação precisa é lido.
- Dados pessoais, como números de cartão e de telefone, são mascarados antes de serem vistos pela IA.
- Seus dados são criptografados em trânsito.

## Desconecte

1. Abra **Bancos de dados** na sua Biblioteca e escolha o banco de dados.
2. Abra o menu dele e escolha **Desconectar**. Depois, escolha **Desconectar** para confirmar.

O banco de dados é movido para a Lixeira junto com suas tabelas e os insights criados a partir delas. Você pode restaurá-los de lá. Nada muda no banco de dados em si.

## Veja também

- [Visão geral dos conectores](/docs/connectors/overview)
- [Acesso a linhas e colunas](/docs/connectors/row-and-column-access)
- [Respostas em tempo real](/docs/use-dvina/features/live-answers)
- [Seu primeiro chat](/docs/use-dvina/get-started/first-chat)