> 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/tarefas/etl/criar-tabela.md).

# Criar Tabela

<figure><img src="/files/NIq2fZWaWzWDuoElOotc" alt=""><figcaption></figcaption></figure>

A **Tarefa Criar Tabela** no **Gaio DataOS** permite definir e gerar a estrutura de uma nova tabela diretamente dentro do seu projeto de dados. Ela é essencial para a criação de camadas intermediárias ou finais de armazenamento em pipelines de dados.

***

### Como usar

Siga os passos abaixo para criar manualmente uma nova tabela:

#### 1. Abrir a Tarefa Criar Tabela

Acesse o **Studio** e, no painel lateral esquerdo, navegue até:\
**Tasks > ETL > Criar Tabela**

***

#### 2. Definir a task e o nome da tabela

* **Task label (opcional):** Informe um nome para identificar esta etapa de criação no fluxo.
* **Tabela Resultado:** Digite o nome da tabela que deseja criar.

***

#### 3. Adicionar colunas

Utilize a interface em formato de grade para definir a estrutura de cada coluna.

* Para adicionar uma coluna, utilize o botão **+**
* Para remover uma coluna, clique no ícone de lixeira&#x20;

| Campo      | Descrição                                                                                             |
| ---------- | ----------------------------------------------------------------------------------------------------- |
| **Coluna** | Insira o nome da coluna (ex., `col_1`, `date_one`, `value`).                                          |
| **Tipo**   | Seleciona o tipo de dado (ex., `String`, `Int64`, `Date`, `DateTime`, `Float64`, `Array`).            |
| **Padrão** | (Opcional)Defina um valor padrão (ex., `today()`, `now()`, or valores estatícos como `0` ou `"N/A"`). |

***

#### 4. Opcional: excluir tabela existente

Ative a opção **Excluir Tabela** caso deseje sobrescrever uma tabela com o mesmo nome.

{% hint style="danger" %}
**Atenção:** Essa ação remove todos os dados existentes da tabela.
{% endhint %}

***

#### 5. Executar ou salvar

* **Executar:** Cria a tabela imediatamente
* **Salvar:** Salva a task para execução posterior no fluxo
* **Salvar e Executar:** Executa a operação e mantém a task registrada no pipeline

***

### Boas práticas

* Sempre revise a opção **Excluir a tabela** com atenção — utilize-a apenas quando tiver certeza de que os dados anteriores podem ser excluídos
* Utilize valores padrão para timestamps ou campos recorrentes sempre que necessário
* Combine esta task com **Inserir Tabela**, **transformações** e **automações** para construir pipelines de dados completos

***