# 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

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gaiodataos.com/gaio-dataos-portuguese/tools/tarefas/etl/criar-tabela.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.