> 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-linha.md).

# Inserção Linha

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

A **Inserção de Linha** no **Gaio DataOS** permite inserir manualmente uma nova linha em uma tabela existente.\
Ela é especialmente útil para adicionar registros estáticos, valores parametrizados ou dados dinâmicos gerados por fórmulas ou campos computados.

***

### Como usar

#### 1. Abrir a task

No **Studio**, acesse o menu lateral esquerdo e navegue até:\
**Tasks > ETL > Inserção de Linha**

***

#### 2. Preencher as informações básicas

* **Rótulo (opcional):** Defina um nome para identificar esta task dentro do fluxo.
* **Tabela:** Selecione a tabela de destino onde a nova linha será inserida.

***

#### 3. Selecionar colunas

No campo **Colunas**, escolha quais colunas deseja preencher.\
Após a seleção, uma lista de campos de entrada será exibida abaixo, um para cada coluna selecionada.

***

#### 4. Definir tipo e valor para cada coluna

Para cada coluna selecionada, configure:

* **Tipo:** Escolha o tipo de entrada:
  * **Valor:** insere um valor fixo/estático (ex.: `"Produto A"`, `123`)
  * **Parâmetro:** utiliza um parâmetro previamente definido no projeto
  * **Computado:** define uma fórmula ou função (ex.: `now()`, `today()`, `1+1`)
* **Valor:** Informe o valor correspondente de acordo com o tipo selecionado.

**Exemplos:**

* `col_1`: Type = Value, Value = `"Novo Cliente"`
* `col_2`: Type = Parameter, Value = `@client_id`
* `date_one`: Type = Computed, Value = `today()`

***

#### 5. Executar ou salvar

* **Executar:** Executa a task sem salvá-la no fluxo
* **Salvar:** Salva a task para uso no fluxo atual, sem executá-la
* **Salvar e Executar:** Salva e executa a task imediatamente

***

### Casos de uso

* Inserir manualmente uma única linha em uma tabela
* Registrar eventos ou marcadores durante a execução de fluxos
* Popular valores de teste durante o desenvolvimento de pipelines
* Utilizar campos computados para timestamps, UUIDs ou valores calculados
