# Usuários

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

A **tarefa Usuários** no **Gaio DataOS** permite gerar uma tabela contendo informações sobre todos os usuários registrados na plataforma. Esse recurso é especialmente útil para **controle de acesso**, **gestão de usuários**, **relatórios de governança** e **auditoria de fluxos** com base em papéis e permissões.

***

## Como usar

### 1. Abrir a tarefa

Navegue até:\
**Tasks > ETL > Usuário**

***

### 2. Definir o nome da tabela de resultado

* **Tabela resultado:** Informe o nome da tabela que irá armazenar os dados dos usuários\
  (ex.: `users_table`, `platform_users`, etc.).

***

### **3.** Selecionar as colunas desejadas

Escolha quais atributos de usuário deseja incluir na tabela de saída:

| Coluna        | Descrição                                    |
| ------------- | -------------------------------------------- |
| **Nome**      | Nome completo do usuário                     |
| **E-mail**    | Endereço de e-mail associado                 |
| **Criado em** | Data que a conta do usuário foi criada       |
| **Grupo**     | Grupo ou permissões a que o usuário pertence |
| **Papel**     | Nível de acesso (e.x., Admin, Dev, Usuário)  |

{% hint style="info" %}
Selecione apenas os campos necessários para o seu processo ou relatório
{% endhint %}

***

### 4. Salvar e utilizar

* Clique em **Salvar** para adicionar a tarefa ao fluxo
* Após a execução, o sistema irá gerar uma tabela com **uma linha por usuário**, contendo as colunas selecionadas

Essa tabela pode ser utilizada para:

* Joins com outras tabelas
* Validação de permissões
* Dashboards de governança
* Filtros baseados em usuários em fluxos e relatórios

***

### Casos de uso

* Criar dashboards de governança listando todos os usuários da plataforma
* Acompanhar níveis de acesso, papéis e associações a grupos
* Auditar quem possui acesso a determinados ambientes ou dados
* Cruzar informações de usuários com logs ou histórico de atividades


---

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