> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wedocs.gitbook.io/wedocs-5.1/cliente-desktop/administracao/conexoes.md).

# Conexões

As conexões de dados permitem ao Weknow estabelecer comunicação com bancos de dados, arquivos e outras fontes de informação utilizadas pelos metadados, componentes e demais recursos da aplicação.

Neste artigo é apresentado o processo de criação, configuração e validação das conexões de dados.

{% hint style="danger" %}
Somente usuários com os papéis **Administrador** e **Administrador de TI** possuem permissão para criar e editar conexões.
{% endhint %}

***

#### Acessando o cadastro de conexões

Para acessar o cadastro de conexões, navegue até **Configurações > Conexões**.

Ao acessar essa opção, será exibida a tela de gerenciamento das conexões, permitindo pesquisar conexões existentes ou cadastrar novas conexões.

#### Pesquisando conexões

A tela de gerenciamento permite consultar todas as conexões cadastradas no ambiente.

***

#### Criando uma nova conexão

Para criar uma nova conexão:

1. Clique no botão **Adicionar** (\*) ou pressione **Enter**.
2. Informe o **Nome** da conexão.
3. Selecione o **Driver** correspondente à fonte de dados que será utilizada.

{% hint style="info" %}
Cada Driver possui um conjunto de configurações próprias que corresponde a fonte de dados;
{% endhint %}

***

#### Configurando a fonte de dados

Após selecionar o driver, serão exibidos os parâmetros necessários para estabelecer a conexão com a fonte de dados.

Esses parâmetros variam conforme o banco de dados ou tecnologia selecionada.

***

#### Configurações avançadas do DuckDB

Quando o driver selecionado for **DuckDB**, o editor de conexões disponibiliza parâmetros adicionais para controlar o comportamento do mecanismo de processamento durante a execução das consultas.

Essas configurações são opcionais e podem ser utilizadas para otimizar o processamento de grandes volumes de dados ou adequar o consumo de recursos do ambiente.

Os parâmetros abaixo são opcionais e podem ser configurados conforme a necessidade do ambiente.

| Parâmetro                      | Descrição                                                                                     | Exemplo           |
| ------------------------------ | --------------------------------------------------------------------------------------------- | ----------------- |
| **memory\_limit**              | Define o limite máximo de memória utilizado pela sessão DuckDB.                               | `2 GB`            |
| **threads**                    | Define a quantidade máxima de threads utilizadas durante a execução das consultas.            | `2`               |
| **temp\_directory**            | Define o diretório utilizado para armazenamento temporário durante o processamento.           | `.temp`           |
| **max\_temp\_directory\_size** | Define o limite máximo de espaço utilizado pelo diretório temporário.                         | `4 GB`            |
| **preserve\_insertion\_order** | Define se a ordem original de inserção dos dados deve ser preservada durante o processamento. | `true` ou `false` |

{% hint style="warning" %}
Esses parâmetros são específicos do driver **DuckDB** e normalmente só precisam ser alterados em cenários que envolvam grandes volumes de dados ou necessidade de otimização de desempenho.
{% endhint %}

***

#### Testando a conexão

Antes de salvar a conexão, recomenda-se executar o teste para verificar se a comunicação com a fonte de dados foi estabelecida corretamente.

***

#### Salvando a conexão

Após validar a comunicação com a fonte de dados, clique em **Salvar** para concluir o cadastro da conexão.