# Excluir

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

A **Tarefa Excluir** no **Gaio DataOS** permite remover registros de uma tabela com base em condições de filtro personalizadas. Ela é útil para limpeza de dados desatualizados, inconsistentes ou temporários como parte de fluxos automatizados de ETL.

{% hint style="warning" %}
&#x20;Esta task só pode ser utilizada quando uma **tabela** estiver selecionada no fluxo. Certifique-se de adicionar e conectar uma **Table** antes de configurar a exclusão.
{% endhint %}

***

### Como usar

#### 1. Adicionar e selecionar um bloco de tabela

No seu fluxo:

* Adicione uma **Tabela** com o dataset que deseja utilizar.
* Selecione a tabela como entrada para a **Tarefa Excluir**.

***

#### 2. Abrir a Tarefa Excluir

No menu lateral esquerdo, navegue até:\
**Tasks > ETL > Excluir**

***

#### 3. Preencher as informações da task

* **Rótulo (opcional):** Nome descritivo para identificar esta etapa no fluxo.
* **Tabela:** Será preenchida automaticamente com base na tabela selecionada (ex.: `new_sales`).

***

#### 4. Definir condições de filtro

Na seção **Filters**, defina uma ou mais condições para especificar quais linhas devem ser removidas.

Exemplo:\
Excluir registros da tabela `new_sales` onde `order_id` seja igual a `1001`.

| Campo        | Descrição                                                                 |
| ------------ | ------------------------------------------------------------------------- |
| **Coluna**   | Escolha uma coluna para usar como filtro (ex., `order_id`)                |
| **Tipo**     | Insira o tipo: `Valor`, `Parâmetro`, etc.                                 |
| **Operador** | Operadores de comparação (`Igual a` , `Diferente de` , `Maior que`, etc.) |
| **Valor**    | O valor a ser comparado                                                   |

{% hint style="warning" %}
Caso nenhum filtro seja definido, nenhuma exclusão ocorrerá.
{% endhint %}

***

#### 5. Executar ou salvar

* **Executar:** Executa a exclusão imediatamente, sem salvar a task
* **Salvar:** Salva a task no fluxo atual
* **Salvar e Executar:** Salva e executa a exclusão imediatamente

***

### Casos de uso

* Remover registros inválidos ou duplicados
* Excluir dados temporários de teste
* Automatizar rotinas de limpeza baseadas em regras de negócio
* Garantir consistência dos dados antes ou após o processamento

***


---

# 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/excluir.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.