# 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


---

# 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-linha.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.