# Definir valor de parâmetro

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

A **tarefa Definir valor de parâmetro** no **Gaio DataOS** permite atribuir manualmente um novo valor a um parâmetro existente dentro de um fluxo de dados. É um recurso fundamental para controlar a execução do fluxo, atualizar dinamicamente o contexto ou sobrescrever valores padrão em tempo de execução.

***

## Como usar

### 1. Abrir a task

Navegue até:\
**Tasks > ETL > Definir valor de parâmetro**

***

### 2. Configurar os campos da task

* **Rótulo (opcional):** Rótulo personalizado para identificar esta task no fluxo.
* **Parâmetro:** Selecione o parâmetro que deseja atualizar. Ele **deve já existir** no ambiente.
* **Padrão:** Valor padrão original do parâmetro (somente leitura).
* **Atual:** Valor atual em uso antes da atualização (somente leitura).
* **Valor:** Novo valor que será atribuído ao parâmetro durante a execução do fluxo.

{% hint style="warning" %}
O valor definido aqui sobrescreve temporariamente o valor atual do parâmetro durante a execução do fluxo e pode ser reutilizado por outras tasks na sequência.
{% endhint %}

***

### 3. Salvar e aplicar

* Após informar o novo valor no campo **Value**, clique em **Save**.
* Quando o fluxo for executado, o parâmetro será atualizado em tempo real com o novo valor atribuído.

***

### Casos de uso

* Atualizar dinamicamente filtros ou variáveis antes da execução de queries
* Aplicar lógica condicional baseada em valores definidos em runtime
* Personalizar execuções a partir de entradas do usuário ou valores contextuais
* Sobrescrever parâmetros herdados de outros fluxos ou configurações padrã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/definir-valor-de-parametro.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.