> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Documentação da instrução CHECK GRANT

# Instrução CHECK GRANT

A consulta `CHECK GRANT` é usada para verificar se o usuário/role atual recebeu um privilégio específico.

<div id="syntax">
  ## Sintaxe
</div>

A sintaxe básica da consulta é a seguinte:

```sql theme={null}
CHECK GRANT privilege[(column_name [,...])] [,...] ON {db.table[*]|db[*].*|*.*|table[*]|*}
```

* `privilege` — Tipo de privilégio.

<div id="examples">
  ## Exemplos
</div>

Se o usuário já tiver recebido o privilégio, a resposta `check_grant` será `1`. Caso contrário, a resposta `check_grant` será `0`.

Se `table_1.col1` existir e o usuário atual tiver recebido o privilégio `SELECT`/`SELECT(con)` ou uma role (com o privilégio), a resposta será `1`.

```sql theme={null}
CHECK GRANT SELECT(col1) ON table_1;
```

```text theme={null}
┌─result─┐
│      1 │
└────────┘
```

Se `table_2.col2` não existir ou se o usuário atual não tiver o privilégio `SELECT`/`SELECT(con)` nem um role (com esse privilégio), a resposta será `0`.

```sql theme={null}
CHECK GRANT SELECT(col2) ON table_2;
```

```text theme={null}
┌─result─┐
│      0 │
└────────┘
```

<div id="wildcard">
  ## Curinga
</div>

Ao especificar privilégios, você pode usar um asterisco (`*`) no lugar de um nome de tabela ou de banco de dados. Consulte [GRANTS COM CURINGA](/pt-BR/reference/statements/grant#wildcard-grants) para conferir as regras de uso de curingas.
