> 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/insercao-de-tabela.md).

# Inserção de tabela

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

### Insert Table Task

A **Inserção de Tabela** no **Gaio DataOS** permite copiar ou migrar dados de uma tabela para outra.\
Ela é especialmente útil para a construção de processos de **ETL**, versionamento de datasets ou consolidação de informações provenientes de múltiplas fontes.

***

### Como usar

Siga os passos abaixo para inserir dados de uma tabela de origem em uma tabela de destino:

#### 1. Abrir a Insert Table Task

No **Studio**, acesse o painel **Tarefas**.\
Na seção **ETL**, selecione **Inserção de Tabela**.

***

#### 2. Definir tabelas de origem e destino

* **Tabela origem:** Escolha a tabela da qual os dados serão extraídos (ex.: `sales`).
* **Tabela alvo:** Selecione ou informe o nome da tabela onde os dados serão inseridos (ex.: `new_sales`).

{% hint style="danger" %}
Caso a tabela de destino não exista, é necessário criá-la previamente utilizando a task **Criar Tabela**.
{% endhint %}

***

#### 3. Mapear colunas

O sistema tentará automaticamente relacionar as colunas pelo nome.

Você pode:

* Utilizar **Auto preenchimento** para preencher rapidamente os campos correspondentes
* Ajustar manualmente o mapeamento de cada **coluna de origem → coluna de destino** utilizando os menus suspensos
* Utilizar **Limpar campos** para limpar todos os mapeamentos

{% hint style="warning" %}
Certifique-se de que os tipos de dados sejam compatíveis para evitar erros durante a inserção.
{% endhint %}

***

#### 4. Revisar e salvar

Após mapear todas as colunas necessárias:

* Clique em **Salvar** para salvar a task
* Ou **Salvar e executar** (se disponível) para executar a task imediatamente

***

### Casos de uso

* Sincronização de dados entre tabelas em um fluxo
* Criação de cópias limpas de datasets de trabalho
* Backup de dados brutos antes de transformações
* Agregação ou particionamento de registros

***

### Boas práticas

* Utilize nomes descritivos para as tasks, facilitando a identificação da operação no fluxo
* Sempre valide o mapeamento das colunas antes de executar a task
* Combine com etapas de filtro ou transformação quando necessário, antes da inserção