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

# 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