> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.2/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.2/wedocs-5.1/instalacao-e-atualizacao/weknow-servidor/definir-fonte-de-dados-e-licenciamento.md).

# Definir fonte de dados e licenciamento

O funcionamento do Weknow depende de dois elementos fundamentais: a configuração das fontes de dados utilizadas para obtenção das informações da instituição e o gerenciamento da licença da plataforma.

As fontes de dados permitem que o Weknow estabeleça conexão com os bancos de dados utilizados pela instituição, enquanto o licenciamento controla a habilitação dos recursos disponíveis e a validade da instalação.

Essas configurações devem ser realizadas por usuários com privilégios administrativos e revisadas sempre que houver alterações na infraestrutura, nas conexões com os bancos de dados ou no licenciamento da solução.

***

### Arquitetura das conexões e do licenciamento

O diagrama abaixo ilustra, de forma simplificada, como o Weknow utiliza as fontes de dados configuradas para acessar as informações da instituição e como o gerenciamento da licença está integrado ao ambiente.

<figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2FyuviJAoUn7XtQqgJdPpE%2Fimage.png?alt=media&amp;token=a2dfccba-3c57-4c7c-85d5-8095c825639d" alt="" width="375"><figcaption></figcaption></figure>

O Weknow Server utiliza as conexões configuradas para acessar os dados da instituição e armazena suas informações internas de configuração e licenciamento no banco de dados PostgreSQL.

***

### Definição de fontes de dados

As fontes de dados são responsáveis por estabelecer a comunicação entre o Weknow e os bancos de dados utilizados pela instituição.

Cada conexão armazena as informações necessárias para acesso ao banco de dados, permitindo que o Weknow realize consultas, sincronizações e atualizações das informações utilizadas pelos dashboards e demais recursos da plataforma.

Para cadastrar uma nova fonte de dados:

1. Acesse **Configurações > Conexões**.
2. Clique em **Novo** para criar uma nova conexão.
3. Informe um nome para identificar a conexão.
4. Selecione o driver correspondente ao banco de dados utilizado.
5. Preencha os parâmetros de conexão solicitados.
6. Utilize a opção **Teste** para validar a comunicação com o banco de dados.
7. Clique em **Salvar** para concluir o cadastro.

<div><figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2F4u1cRBeY1veCl3M9nW6d%2Fimage.png?alt=media&amp;token=8484ed2e-cfc0-4cc4-ade8-c2e8da20195f" alt=""><figcaption></figcaption></figure> <figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2F4thRQmKbyD7xlPNcba5J%2Fimage.png?alt=media&amp;token=8f5d7591-679c-4c11-abc0-1b6b836c1954" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
**Importante:** Cada driver possui parâmetros específicos de configuração. Antes de concluir o cadastro, recomenda-se validar a comunicação utilizando o botão **Teste**, garantindo que todas as informações foram preenchidas corretamente.
{% endhint %}

***

### Gerenciamento do licenciamento

O licenciamento é responsável por controlar a utilização da plataforma e habilitar os recursos contratados pela instituição.

Além da validação periódica da licença, o Weknow permite consultar informações detalhadas sobre sua situação e realizar atualizações sempre que necessário.

Para atualizar a licença:

1. Abra a aplicação **Weknow Servidor**.
2. Acesse a opção **Contas**.
3. Selecione a conta desejada.
4. Clique em **Atualizar licença**.
5. Aguarde a validação realizada pelo serviço de licenciamento.

<figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2FSMvgsWvCx5epmKES8XgA%2Fimage.png?alt=media&amp;token=352a5898-0cbf-4640-a2cb-976eb0824cf0" alt=""><figcaption></figcaption></figure>

Caso a atualização seja concluída com sucesso, será exibida uma mensagem confirmando que a licença foi atualizada.

{% hint style="info" %}
**Importante:** A atualização da licença depende da comunicação entre o Weknow Server e o serviço de licenciamento da Weknow. Caso o ambiente esteja sem acesso à Internet ou bloqueado por regras de firewall, a atualização poderá não ser concluída.
{% endhint %}

***

### Informações da licença

A opção **Informações Licença** permite consultar os principais dados relacionados ao licenciamento da plataforma, incluindo:

* identificação da licença;
* descrição;
* situação atual;
* período de validade;
* quantidade de usuários licenciados;
* recursos habilitados.

Essas informações auxiliam na verificação da situação da licença e na identificação de possíveis restrições de utilização.

<figure><img src="https://2246169615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4yXt6ny2DDnDTHV2uaYY%2Fuploads%2FHBRSrhoaoppLUPi9OYxf%2Fimage.png?alt=media&amp;token=bd08bfbf-b503-43a9-b890-b8b5385bedca" alt=""><figcaption></figcaption></figure>

***

### Armazenamento offline dos metadados

Além das conexões utilizadas para acessar os bancos de dados da instituição, o Weknow também permite configurar o mecanismo de armazenamento offline dos metadados.

Esse recurso é utilizado para armazenar localmente os dados processados pelos metadados, reduzindo a necessidade de consultas recorrentes às bases de origem e proporcionando melhor desempenho durante as análises.

Atualmente, o **DuckDB** é o mecanismo padrão para armazenamento offline dos metadados, oferecendo uma solução embarcada, de fácil administração e otimizada para consultas analíticas.

O **MonetDB** permanece disponível como alternativa, principalmente para ambientes existentes ou cenários específicos que já utilizam essa tecnologia, preservando a compatibilidade com implantações anteriores.

***

### Alteração do mecanismo de armazenamento

Ao criar ou editar um metadado, é possível selecionar o mecanismo de armazenamento offline que será utilizado.

Caso o mecanismo de armazenamento seja alterado em um metadado já existente, o Weknow executará automaticamente a migração dos dados para o novo banco, permitindo, opcionalmente, a remoção dos dados armazenados anteriormente.

Quando existirem tabelas virtuais relacionadas ao mesmo conjunto de dados, a alteração poderá ser aplicada aos demais metadados vinculados, preservando a consistência entre eles.

{% hint style="info" %}
**Importante:** A alteração do mecanismo de armazenamento somente será aplicada durante a próxima carga de dados, seja ela executada manualmente ou por uma tarefa agendada. Até que essa atualização ocorra, os dados continuarão sendo lidos normalmente do mecanismo anteriormente configurado.
{% endhint %}

***

### Configuração das cargas offline

As **cargas offline** permitem definir quando os dados dos metadados serão processados e armazenados localmente no mecanismo de armazenamento configurado.

Ao configurar o horário de uma carga offline no **Weknow Client**, os horários devem ser informados utilizando o **formato de 24 horas**.

O Weknow Client utiliza o formato de horário de 24 horas para validar os horários informados. Caso o sistema operacional esteja configurado para utilizar o formato de 12 horas com **AM/PM**, poderá ocorrer um erro ao salvar a configuração da carga.

{% hint style="danger" %}
**Importante:** Para configurar corretamente os horários das cargas offline, mantenha o Windows configurado para utilizar o formato de **24 horas**.
{% endhint %}

> Por exemplo, um horário como **13:00** deve ser informado no formato de 24 horas, em vez de utilizar `1:00 PM`.

{% hint style="warning" %}
**Nota:** Esse comportamento foi corrigido a partir da versão 5.2 do Weknow. Nas versões que incluem essa correção, não é necessário alterar as configurações regionais do Windows para configurar os horários das cargas offline.
{% endhint %}

***

### Considerações

O DuckDB foi adotado como padrão por oferecer benefícios como:

* arquitetura embarcada, dispensando a instalação de um servidor dedicado;
* menor complexidade de administração;
* alto desempenho em consultas analíticas locais;
* integração nativa com os recursos de armazenamento offline do Weknow.

O MonetDB continua disponível para garantir compatibilidade com ambientes já implantados e situações em que sua utilização seja necessária.

***

### Solução de problemas

**Se a atualização da licença falhar**

Verifique os seguintes pontos:

* se o servidor possui acesso à Internet;
* se as regras de firewall permitem a comunicação com o serviço de licenciamento;
* se a licença ainda está válida;
* se o serviço de licenciamento está disponível.

Caso a mensagem apresentada indique **licença expirada**, entre em contato com o suporte da Weknow.

**Se a conexão com a fonte de dados falhar**

Verifique se:

* o banco de dados está acessível;
* as credenciais informadas estão corretas;
* a porta de comunicação está liberada;
* o driver correspondente ao banco de dados foi selecionado corretamente;
* o teste de conexão foi executado com sucesso.

***

### Boas práticas

Para garantir o correto funcionamento do ambiente, recomenda-se:

* manter as conexões sempre documentadas e identificadas;
* utilizar nomes que facilitem a identificação das fontes de dados;
* validar todas as conexões antes de colocá-las em produção;
* revisar periodicamente a validade da licença;
* manter o servidor com acesso aos serviços de licenciamento da Weknow;
* revisar as configurações sempre que houver alterações na infraestrutura ou migração dos bancos de dados.