# Bases de dados e armazéns de dados

> Ligue uma base de dados ou um armazém de dados e faça perguntas em linguagem simples. Dvina só lê os dados e verifica cada consulta antes de a executar.

Ligue a sua base de dados ou o seu armazém de dados e faça perguntas como faria a um colega. Dvina encontra as tabelas certas, escreve a consulta e apresenta a resposta.

## O que Dvina pode fazer

- **Responder em linguagem simples.** Pergunte "Que regiões perderam clientes recorrentes no último trimestre?" e Dvina encontra as tabelas, escreve a consulta e apresenta a resposta, muitas vezes com um gráfico e a tabela por baixo.
- **Mapear as suas tabelas.** Dvina aprende como as suas tabelas se relacionam, para que nunca tenha de indicar uma junção.
- **Apresentar à sua maneira.** Altere a forma como uma resposta é apresentada: **Tabela**, **Linhas**, **Áreas**, **Barras**, **Barras horizontais**, **Circular**, **Anel**, **Radar** ou **Área polar**.
- **Guardar uma resposta.** Guarde qualquer resposta como um insight e volte a abri-la sempre que precisar.

Pode ligar 20 bases de dados e armazéns de dados, incluindo PostgreSQL, MySQL, SQL Server, Snowflake, BigQuery, Redshift e Databricks.

Para usar uma base de dados numa mensagem, escreva <kbd>/</kbd> no campo da mensagem e selecione-a.

## Permissões

As bases de dados e os armazéns de dados que liga são, por definição, apenas de leitura.

- **Apenas uma operação de leitura:** Antes de executar cada consulta, Dvina verifica se consiste numa única operação de leitura. Os seus dados ficam como estão.
- **Sem alterações:** Se pedir a Dvina para alterar ou eliminar dados, explica-lhe que só lê os dados e pode propor listar os dados em questão em vez disso.
- **O acesso da sua conta:** Dvina vê as tabelas que a conta usada para ligar a base de dados pode ler. Se não aparecerem tabelas, peça ao administrador da base de dados para verificar as permissões de leitura dessa conta.
- **Linhas e colunas por pessoa:** Quando partilha uma tabela, as regras de acesso podem mostrar a cada pessoa apenas algumas linhas e ocultar colunas. Consulte [Controlar as linhas e colunas que as pessoas veem](/docs/connectors/row-and-column-access).

> [!TIP]
> Ligue-se com uma conta da base de dados que só tenha permissões de leitura. Dvina nunca escreve dados, e uma conta apenas de leitura garante que isso também se mantém do lado da base de dados.

## Como ligar

1. Abra **Bases de dados** na sua Biblioteca e selecione **Ligar uma base de dados**. Também pode selecionar **Adicionar contexto** na sua Biblioteca e, depois, **Bases de dados**.
2. Encontre a sua base de dados ou o seu armazém de dados. Pode pesquisar pelo nome.
3. Selecione **Ligar**.
4. Introduza um **Nome da fonte** e os detalhes da ligação, como **Host**, **Porta**, **Base de dados**, **Nome de utilizador** e **Palavra-passe**. Alguns armazéns de dados pedem outros detalhes, como uma conta, um projeto ou um ficheiro de conta de serviço.
5. Em **Encriptação (SSL)**, selecione **Verificada**, **Obrigatória** ou **Desativada**.
6. Para que Dvina procure as relações entre as suas tabelas, ative **Encontrar relações entre tabelas**. Isto pode demorar algum tempo em bases de dados grandes.
7. Selecione **Ligar**.

Dvina verifica a ligação e descobre as suas tabelas. Cada tabela indica quando está **Pronta para perguntas**, e pode acompanhar o progresso na página da base de dados.

### Se a ligação falhar

Dvina indica o que correu mal. Estas são as soluções mais comuns:

- **A base de dados rejeitou as credenciais:** Verifique o nome de utilizador, a palavra-passe 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 da base de dados.
- **Não foi possível estabelecer a ligação encriptada:** Se a base de dados usar um certificado autoassinado, selecione **Obrigatória** em vez de **Verificada**. Se não suportar SSL, selecione **Desativada**.
- **Não foi possível aceder à base de dados:** Verifique a disponibilidade, o acesso à rede, o host e a porta.

Para alterar os detalhes mais tarde, abra a base de dados e selecione **Editar ligação** e, depois, **Verificar novamente**.

## Veja como as suas tabelas se relacionam

Abra **Bases de dados** na sua Biblioteca, abra a base de dados e escolha o respetivo cartão, o primeiro da página. O painel **Esquema da base de dados** apresenta uma visão geral da base de dados:

- **Ligação:** os detalhes da base de dados, como **Host**, **Porta** e **Utilizador**, e o respetivo **Estado**: **Ligada** ou **Não é possível ligar**, com a indicação de quando foi verificado pela última vez. Escolha **Verificar novamente** para verificar agora.
- **Relações:** indica se a Dvina já procurou ligações entre as suas tabelas. Escolha **Encontrar relações** ou **Procurar novamente** para iniciar uma pesquisa.
- **O diagrama:** cada tabela aparece como um cartão com as suas colunas, as chaves no topo e uma linha para cada relação entre tabelas. Passe o cursor sobre uma linha para destacar as duas colunas que liga. Escolha uma tabela para a abrir.

Para encontrar uma tabela ou coluna, use **Encontrar uma tabela ou coluna**. Para ver o diagrama em ecrã inteiro, escolha **Expandir**.

No diagrama, **PK** assinala uma chave primária e **FK** uma chave estrangeira. Uma linha contínua representa uma relação declarada pela base de dados ou uma relação confirmada e utilizada em consultas. Uma linha tracejada indica uma relação **Sugerida**: uma relação que a Dvina encontrou nos seus dados, mas que ainda não é utilizada.

### Reveja as relações que a Dvina encontrou

1. No diagrama, escolha uma linha tracejada.
2. Verifique as duas colunas que liga.
3. Escolha **Confirmar** para a utilizar em consultas ou **Rejeitar** se estiver incorreta. Uma relação que rejeite não volta a ser sugerida.

### Bases de dados grandes

- A pesquisa de relações conta as linhas das suas tabelas, pelo que pode demorar algum tempo. Numa base de dados com mais de 100 tabelas, a Dvina não pesquisa automaticamente, mesmo que tenha ativado **Encontrar relações entre tabelas**. Escolha **Encontrar relações** quando estiver pronto.
- Quando uma base de dados tem mais de 40 tabelas, o diagrama mostra uma tabela e as tabelas vizinhas. Pesquise para centrar o diagrama noutra tabela.

## Guarde e atualize análises

Uma análise guarda a resposta a uma pergunta, para que possa voltar a abri-la com dados atualizados.

1. No cartão da resposta, escolha como a quer ver, por exemplo, **Tabela** ou **Barras**.
2. Escolha **Guardar**. A Dvina apresenta **Guardado como análise**. Num telemóvel, escolha primeiro **Expandir** e depois **Guardar** no painel lateral.
3. Para a abrir, escolha **Guardado**. Também a pode encontrar no seu Feed.

A análise abre no painel lateral. Aí pode:

- **Mudar o nome:** clique no nome no topo e escreva um novo.
- **Alterar a visualização:** escolha outra apresentação ou uma tabela dinâmica. A nova visualização é guardada com a análise.
- **Atualizar:** abra o menu do painel e escolha **Atualizar** para a executar novamente com os dados mais recentes.
- **Descarregar:** abra o menu do painel e escolha **Descarregar**.
- **Apagar:** abra o menu do painel e escolha **Apagar**. A análise é movida para o Lixo, onde a pode restaurar.

### Análises partilhadas

Quando partilha uma análise, escolha **Pode editar** ou **Pode ver** para cada pessoa.

- **As pessoas que podem editar** também a podem atualizar.
- **As pessoas que podem ver** só podem consultar. Podem alterar a visualização no seu próprio ecrã, mas essa alteração não é guardada, e veem **Só os editores podem atualizar** e **Só os editores podem mudar o nome**.

Se as regras de acesso de uma tabela limitarem o que uma pessoa pode ver, essa pessoa recebe um resultado próprio da análise, assinalado como **Visualização restrita**. Consulte [Controle as linhas e colunas que as pessoas podem ver](/docs/connectors/row-and-column-access).

## Privacidade

- Os dados que liga nunca são utilizados para treinar modelos de IA.
- Só são lidos os dados necessários para o seu pedido.
- Os dados pessoais, como números de cartão e de telefone, são ocultados antes de serem enviados à IA.
- Os seus dados são encriptados em trânsito.

## Desligue

1. Abra **Bases de dados** na sua Biblioteca e escolha a base de dados.
2. Abra o respetivo menu e escolha **Desligar**. Em seguida, escolha **Desligar** para confirmar.

A base de dados é movida para o Lixo, juntamente com as suas tabelas e as análises criadas a partir delas. Pode restaurá-las a partir daí. Nada muda na própria base de dados.

## Relacionado

- [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)
- [A sua primeira conversa](/docs/use-dvina/get-started/first-chat)