# 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


---

# 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/insercao-de-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.