mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-15 19:02:04 +00:00
47 lines
1.3 KiB
Markdown
47 lines
1.3 KiB
Markdown
---
|
|
slug: /en/sql-reference/statements/check-grant
|
|
sidebar_position: 56
|
|
sidebar_label: CHECK GRANT
|
|
title: "CHECK GRANT Statement"
|
|
---
|
|
|
|
The `CHECK GRANT` query is used to check whether the current user/role has been granted a specific privilege.
|
|
|
|
## Syntax
|
|
|
|
The basic syntax of the query is as follows:
|
|
|
|
```sql
|
|
CHECK GRANT privilege[(column_name [,...])] [,...] ON {db.table[*]|db[*].*|*.*|table[*]|*}
|
|
```
|
|
|
|
- `privilege` — Type of privilege.
|
|
|
|
## Examples
|
|
|
|
If the user used to be granted the privilege, the response`check_grant` will be `1`. Otherwise, the response `check_grant` will be `0`.
|
|
|
|
If `table_1.col1` exists and current user is granted by privilege `SELECT`/`SELECT(con)` or role(with privilege), the response is `1`.
|
|
```sql
|
|
CHECK GRANT SELECT(col1) ON table_1;
|
|
```
|
|
|
|
```text
|
|
┌─result─┐
|
|
│ 1 │
|
|
└────────┘
|
|
```
|
|
If `table_2.col2` doesn't exists, or current user is not granted by privilege `SELECT`/`SELECT(con)` or role(with privilege), the response is `0`.
|
|
```sql
|
|
CHECK GRANT SELECT(col2) ON table_2;
|
|
```
|
|
|
|
```text
|
|
┌─result─┐
|
|
│ 0 │
|
|
└────────┘
|
|
```
|
|
|
|
## Wildcard
|
|
Specifying privileges you can use asterisk (`*`) instead of a table or a database name. Please check [WILDCARD GRANTS](../../sql-reference/statements/grant.md#wildcard-grants) for wildcard rules.
|