> 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/excluir.md).

# 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

***