> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/gaio-dataos-portuguese/tools/data-workspace/catalogo.md).

# Catálogo

Encontre, classifique e documente as tabelas do projeto.

O **Catálogo** lista todas as tabelas do projeto em cartões ou em lista (pelo botão de visualização). É o ponto de partida para encontrar, classificar e documentar os dados.

<figure><img src="https://1268188283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91J5WBQDmSrL6EE6Xqez%2Fuploads%2FMbFdxNM4mqXMD2geQO41%2Fdata-workspace-catalogo.png?alt=media&amp;token=55ac32ab-fcb0-4bb7-a800-dd686ed1ab5f" alt=""><figcaption></figcaption></figure>

### Barra de ferramentas

* **Filtrar tabelas por nome**: busca pelo nome da tabela.
* **Filtros rápidos**: Importantes, Compartilhadas, Mostrar temporárias, Engine e Confiança.
* **Ordenação** e **Atualizar**: reordenam e recarregam o catálogo.
* **ⓘ Classificação e confiança**: abre a legenda dos sinais de curadoria.

### Cartão de cada tabela

* Nome, engine (ex.: `MergeTree`) e número aproximado de linhas.
* Quando há linhagem conhecida, setas `← n` e `→ n` com o número de origens e de consumidores.
* **Estrela**: marca a tabela como importante.
* **Escudo**: nível de confiança da tabela.
* **Olho**: visualiza os dados.
* **Documento**: documenta a tabela e as colunas.
* **Círculo numérico**: índice de documentação.

### Sinais de curadoria

| Sinal                    | Significado                                                                                                                             |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Importante (estrela)** | Marca pessoal ou do time para tabelas-chave. Destaca a tabela e permite filtrar. Não afeta a confiabilidade dos dados.                  |
| **Certificada**          | Tabela oficial, revisada e confiável para construir análises e relatórios.                                                              |
| **Beta**                 | Em desenvolvimento. Utilizável, mas o schema ou os números ainda podem mudar. Valide antes de depender dela.                            |
| **Descontinuada**        | Em descontinuação. Evite construir trabalho novo sobre ela e migre para a substituta recomendada.                                       |
| **Documentação (Doc)**   | Mede quanto a tabela está documentada: descrição da tabela mais títulos e descrições das colunas. Independe de confiança e importância. |

### Analisar uma tabela

Clique no nome da tabela para abrir o menu **Analisar com…**:

* **Ver dados**
* **Perfil & Qualidade**
* **Documentar colunas**
* **Ver linhagem**
* **Governança** e **Explorar** (em breve)

**Ver dados** abre um visualizador com quatro abas:

* **Dados**: grade paginada, com filtros (coluna, operador e valor) e escolha de quantas linhas mostrar.
* **Colunas**: nome, tipo e tipo de dado de cada coluna.
* **Estatísticas**: estatísticas por coluna.
* **Frequência**: contagem, percentual e acumulado de cada valor.

No topo do visualizador ficam a estrela, o escudo e o documento da tabela, o seletor de quantas linhas mostrar (ex.: **20 linhas**), o botão **Atualizar** e as ações de exportar, expandir e fechar. Na aba **Dados**, o botão **+** adiciona outro filtro e **Aplicar** executa a filtragem.

<figure><img src="https://1268188283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91J5WBQDmSrL6EE6Xqez%2Fuploads%2Fuu0bEcx2XbUjWv3tpnyX%2Fdw-catalogo-ver-dados.png?alt=media&amp;token=7e7ed7ef-1471-4763-934b-f6b96a462d4b" alt=""><figcaption></figcaption></figure>

### Documentar uma tabela

A janela **Documentar** tem:

* Um campo para a **descrição da tabela**.
* Uma grade com **Título** (rótulo curto) e **Descrição** para cada coluna.
* Um filtro de colunas e a opção **Só vazias**.
* O contador **"x de y documentadas"**.
* A opção **Limpar documentação**.
* O botão **Gerar com IA**, que sugere a documentação automaticamente.

Clique em **Salvar** para gravar ou em **Cancelar** para descartar.

Na grade, cada coluna aparece com o nome e o tipo de dado (ex.: `Nullable(String)`), o que ajuda a escrever o título e a descrição.

<figure><img src="https://1268188283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91J5WBQDmSrL6EE6Xqez%2Fuploads%2FFLtaFBVcUOiWcGkYsdYG%2Fdw-catalogo-documentar.png?alt=media&amp;token=18d6a9f6-a9e2-462c-b6b9-093d784df181" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Títulos e descrições de colunas melhoram as respostas da IA e aumentam o índice de documentação do catálogo.
{% endhint %}
