DOCSUP-2193: Describe SHOW queries for RBAC (#14515)

* Documentation for #10387, upd syntax by issues #12311, #12312

* Update docs/ru/sql-reference/statements/show.md
Co-authored-by: NAnna Devyatova <annadevyatova@yandex-team.ru>
Co-authored-by: NBayoNet <da-daos@yandex.ru>

docs/en/operations/access-rights.md

@@ -62,6 +62,7 @@ Management queries:
 -   [ALTER USER](../sql-reference/statements/alter/user.md#alter-user-statement)
 -   [DROP USER](../sql-reference/statements/drop.md)
 -   [SHOW CREATE USER](../sql-reference/statements/show.md#show-create-user-statement)
+-   [SHOW USERS](../sql-reference/statements/show.md#show-users-statement)
 
 ### Settings Applying {#access-control-settings-applying}
 
@@ -90,6 +91,7 @@ Management queries:
 -   [SET ROLE](../sql-reference/statements/set-role.md)
 -   [SET DEFAULT ROLE](../sql-reference/statements/set-role.md#set-default-role-statement)
 -   [SHOW CREATE ROLE](../sql-reference/statements/show.md#show-create-role-statement)
+-   [SHOW ROLES](../sql-reference/statements/show.md#show-roles-statement)
 
 Privileges can be granted to a role by the [GRANT](../sql-reference/statements/grant.md) query. To revoke privileges from a role ClickHouse provides the [REVOKE](../sql-reference/statements/revoke.md) query.
 
@@ -103,6 +105,7 @@ Management queries:
 -   [ALTER ROW POLICY](../sql-reference/statements/alter/row-policy.md#alter-row-policy-statement)
 -   [DROP ROW POLICY](../sql-reference/statements/drop.md#drop-row-policy-statement)
 -   [SHOW CREATE ROW POLICY](../sql-reference/statements/show.md#show-create-row-policy-statement)
+-   [SHOW POLICIES](../sql-reference/statements/show.md#show-policies-statement)
 
 ## Settings Profile {#settings-profiles-management}
 
@@ -114,6 +117,7 @@ Management queries:
 -   [ALTER SETTINGS PROFILE](../sql-reference/statements/alter/settings-profile.md#alter-settings-profile-statement)
 -   [DROP SETTINGS PROFILE](../sql-reference/statements/drop.md#drop-settings-profile-statement)
 -   [SHOW CREATE SETTINGS PROFILE](../sql-reference/statements/show.md#show-create-settings-profile-statement)
+-   [SHOW PROFILES](../sql-reference/statements/show.md#show-profiles-statement)
 
 ## Quota {#quotas-management}
 
@@ -127,6 +131,8 @@ Management queries:
 -   [ALTER QUOTA](../sql-reference/statements/alter/quota.md#alter-quota-statement)
 -   [DROP QUOTA](../sql-reference/statements/drop.md#drop-quota-statement)
 -   [SHOW CREATE QUOTA](../sql-reference/statements/show.md#show-create-quota-statement)
+-   [SHOW QUOTA](../sql-reference/statements/show.md#show-quota-statement)
+-   [SHOW QUOTAS](../sql-reference/statements/show.md#show-quotas-statement)
 
 ## Enabling SQL-driven Access Control and Account Management {#enabling-access-control}
 

docs/en/operations/system-tables/quota_usage.md

@@ -23,4 +23,8 @@ Columns:
 - `execution_time` ([Nullable](../../sql-reference/data-types/nullable.md)([Float64](../../sql-reference/data-types/float.md))) — The total query execution time, in seconds (wall time).
 - `max_execution_time` ([Nullable](../../sql-reference/data-types/nullable.md)([Float64](../../sql-reference/data-types/float.md))) — Maximum of query execution time.
 
+## See Also {#see-also}
+
+-   [SHOW QUOTA](../../sql-reference/statements/show.md#show-quota-statement)
+
 [Original article](https://clickhouse.tech/docs/en/operations/system_tables/quota_usage) <!--hide-->

docs/en/operations/system-tables/quotas.md

@@ -20,5 +20,9 @@ Columns:
 - `apply_to_list` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — List of user names/[roles](../../operations/access-rights.md#role-management) that the quota should be applied to.
 - `apply_to_except` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — List of user names/roles that the quota should not apply to.
 
+## See Also {#see-also}
+
+-   [SHOW QUOTAS](../../sql-reference/statements/show.md#show-quotas-statement)
+
 [Original article](https://clickhouse.tech/docs/en/operations/system_tables/quotas) <!--hide-->
 

docs/en/operations/system-tables/quotas_usage.md

@@ -24,4 +24,8 @@ Columns:
 - `execution_time` ([Nullable](../../sql-reference/data-types/nullable.md)([Float64](../../sql-reference/data-types/float.md))) — The total query execution time, in seconds (wall time).
 - `max_execution_time` ([Nullable](../../sql-reference/data-types/nullable.md)([Float64](../../sql-reference/data-types/float.md))) — Maximum of query execution time.
 
+## See Also {#see-also}
+
+-   [SHOW QUOTA](../../sql-reference/statements/show.md#show-quota-statement)
+
 [Original article](https://clickhouse.tech/docs/en/operations/system_tables/quotas_usage) <!--hide-->

docs/en/operations/system-tables/role-grants.md

@@ -5,11 +5,15 @@ Contains the role grants for users and roles. To add entries to this table, use
 Columns:
 
 - `user_name` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — User name.
+
 - `role_name` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Role name.
+
 - `granted_role_name` ([String](../../sql-reference/data-types/string.md)) — Name of role granted to the `role_name` role. To grant one role to another one use `GRANT role1 TO role2`.
+
 - `granted_role_is_default` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Flag that shows whether `granted_role` is a default role. Possible values:
     -   1 — `granted_role` is a default role.
     -   0 — `granted_role` is not a default role.
+    
 - `with_admin_option` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Flag that shows whether `granted_role` is a role with [ADMIN OPTION](../../sql-reference/statements/grant.md#admin-option-privilege) privilege. Possible values:
     -   1 — The role has `ADMIN OPTION` privilege.
     -   0 — The role without `ADMIN OPTION` privilege. 

docs/en/operations/system-tables/roles.md

@@ -8,4 +8,8 @@ Columns:
 - `id` ([UUID](../../sql-reference/data-types/uuid.md)) — Role ID.
 - `storage` ([String](../../sql-reference/data-types/string.md)) — Path to the storage of roles. Configured in the `access_control_path` parameter.
 
+## See Also {#see-also}
+
+-   [SHOW ROLES](../../sql-reference/statements/show.md#show-roles-statement)
+
 [Original article](https://clickhouse.tech/docs/en/operations/system_tables/roles) <!--hide-->

docs/en/operations/system-tables/row_policies.md

@@ -27,4 +27,8 @@ Columns:
 
 -    `apply_to_except` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — The row policies is applied to all roles and/or users excepting of the listed ones.
 
+## See Also {#see-also}
+
+-   [SHOW POLICIES](../../sql-reference/statements/show.md#show-policies-statement)
+
 [Original article](https://clickhouse.tech/docs/en/operations/system_tables/row_policies) <!--hide-->

docs/en/operations/system-tables/settings_profiles.md

@@ -17,4 +17,8 @@ Columns:
 
 -    `apply_to_except` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — The setting profile is applied to all roles and/or users excepting of the listed ones.
 
+## See Also {#see-also}
+
+-   [SHOW PROFILES](../../sql-reference/statements/show.md#show-profiles-statement)
+
 [Original article](https://clickhouse.tech/docs/en/operations/system_tables/settings_profiles) <!--hide-->

docs/en/operations/system-tables/users.md

@@ -27,4 +27,8 @@ Columns:
 
 -    `default_roles_except` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — All the granted roles set as default excepting of the listed ones.
 
+## See Also {#see-also}
+
+-   [SHOW USERS](../../sql-reference/statements/show.md#show-users-statement)
+
 [Original article](https://clickhouse.tech/docs/en/operations/system_tables/users) <!--hide-->

docs/en/sql-reference/statements/alter/settings-profile.md

@@ -10,7 +10,7 @@ Changes settings profiles.
 Syntax:
 
 ``` sql
-ALTER SETTINGS PROFILE [IF EXISTS] name [ON CLUSTER cluster_name]
+ALTER SETTINGS PROFILE [IF EXISTS] TO name [ON CLUSTER cluster_name]
     [RENAME TO new_name]
     [SETTINGS variable [= value] [MIN [=] min_value] [MAX [=] max_value] [READONLY|WRITABLE] | INHERIT 'profile_name'] [,...]
 ```

docs/en/sql-reference/statements/create/settings-profile.md

@@ -10,7 +10,7 @@ Creates a [settings profile](../../../operations/access-rights.md#settings-profi
 Syntax:
 
 ``` sql
-CREATE SETTINGS PROFILE [IF NOT EXISTS | OR REPLACE] name [ON CLUSTER cluster_name]
+CREATE SETTINGS PROFILE [IF NOT EXISTS | OR REPLACE] TO name [ON CLUSTER cluster_name]
     [SETTINGS variable [= value] [MIN [=] min_value] [MAX [=] max_value] [READONLY|WRITABLE] | INHERIT 'profile_name'] [,...]
 ```
 

docs/en/sql-reference/statements/show.md

@@ -148,7 +148,7 @@ SHOW CREATE [ROW] POLICY name ON [database.]table
 
 Shows parameters that were used at a [quota creation](../../sql-reference/statements/create/quota.md).
 
-### Syntax {#show-create-row-policy-syntax}
+### Syntax {#show-create-quota-syntax}
 
 ``` sql
 SHOW CREATE QUOTA [name | CURRENT]
@@ -158,10 +158,70 @@ SHOW CREATE QUOTA [name | CURRENT]
 
 Shows parameters that were used at a [settings profile creation](../../sql-reference/statements/create/settings-profile.md).
 
-### Syntax {#show-create-row-policy-syntax}
+### Syntax {#show-create-settings-profile-syntax}
 
 ``` sql
 SHOW CREATE [SETTINGS] PROFILE name
 ```
 
+## SHOW USERS {#show-users-statement}
+
+Returns a list of [user account](../../operations/access-rights.md#user-account-management) names. To view user accounts parameters, see the system table [system.users](../../operations/system-tables/users.md#system_tables-users).
+
+### Syntax {#show-users-syntax}
+
+``` sql
+SHOW USERS
+```
+ 
+## SHOW ROLES {#show-roles-statement}
+
+Returns a list of [roles](../../operations/access-rights.md#role-management). To view another parameters, see system tables [system.roles](../../operations/system-tables/roles.md#system_tables-roles) and [system.role-grants](../../operations/system-tables/role-grants.md#system_tables-role_grants).
+
+### Syntax {#show-roles-syntax}
+
+``` sql
+SHOW [CURRENT|ENABLED] ROLES
+```
+
+## SHOW PROFILES {#show-profiles-statement}
+
+Returns a list of [setting profiles](../../operations/access-rights.md#settings-profiles-management). To view user accounts parameters, see the system table [settings_profiles](../../operations/system-tables/settings_profiles.md#system_tables-settings_profiles).
+
+### Syntax {#show-profiles-syntax}
+
+``` sql
+SHOW [SETTINGS] PROFILES
+```
+
+## SHOW POLICIES {#show-policies-statement}
+
+Returns a list of [row policies](../../operations/access-rights.md#row-policy-management) for the specified table. To view user accounts parameters, see the system table [system.row_policies](../../operations/system-tables/row_policies.md#system_tables-row_policies).
+
+### Syntax {#show-policies-syntax}
+
+``` sql
+SHOW [ROW] POLICIES [ON [db.]table]
+```
+
+## SHOW QUOTAS {#show-quotas-statement}
+
+Returns a list of [quotas](../../operations/access-rights.md#quotas-management). To view quotas parameters, see the system table [system.quotas](../../operations/system-tables/quotas.md#system_tables-quotas).
+
+### Syntax {#show-quotas-syntax}
+
+``` sql
+SHOW QUOTAS
+```  
+    
+## SHOW QUOTA {#show-quota-statement}
+
+Returns a [quota](../../operations/quotas.md) consumption for all users or for current user. To view another parameters, see system tables [system.quotas_usage](../../operations/system-tables/quotas_usage.md#system_tables-quotas_usage) and [system.quota_usage](../../operations/system-tables/quota_usage.md#system_tables-quota_usage).
+
+### Syntax {#show-quota-syntax}
+
+``` sql
+SHOW [CURRENT] QUOTA
+```
+
 [Original article](https://clickhouse.tech/docs/en/query_language/show/) <!--hide-->

docs/ru/operations/system-tables/quota_usage.md

@@ -24,4 +24,8 @@
 -   `execution_time` ([Nullable](../../sql-reference/data-types/nullable.md)([Float64](../../sql-reference/data-types/float.md))) — Общее время выполнения запроса, в секундах.
 -   `max_execution_time` ([Nullable](../../sql-reference/data-types/nullable.md)([Float64](../../sql-reference/data-types/float.md))) — Максимальное время выполнения запроса.
 
+## Смотрите также {#see-also}
+
+-   [SHOW QUOTA](../../sql-reference/statements/show.md#show-quota-statement)
+
 [Оригинальная статья](https://clickhouse.tech/docs/ru/operations/system_tables/quota_usage) <!--hide-->

docs/ru/operations/system-tables/quotas.md

@@ -21,5 +21,9 @@
 -   `apply_to_list` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — Список имен пользователей/[ролей](../../operations/access-rights.md#role-management) к которым применяется квота.
 -   `apply_to_except` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — Список имен пользователей/ролей к которым квота применяться не должна.
 
+## Смотрите также {#see-also}
+
+-   [SHOW QUOTAS](../../sql-reference/statements/show.md#show-quotas-statement)
+
 [Оригинальная статья](https://clickhouse.tech/docs/ru/operations/system_tables/quotas) <!--hide-->
 

docs/ru/operations/system-tables/quotas_usage.md

@@ -25,4 +25,8 @@
 -   `execution_time` ([Nullable](../../sql-reference/data-types/nullable.md)([Float64](../../sql-reference/data-types/float.md))) — Общее время выполнения запроса, в секундах.
 -   `max_execution_time` ([Nullable](../../sql-reference/data-types/nullable.md)([Float64](../../sql-reference/data-types/float.md))) — Максимальное время выполнения запроса.
 
+## Смотрите также {#see-also}
+
+-   [SHOW QUOTA](../../sql-reference/statements/show.md#show-quota-statement)
+
 [Оригинальная статья](https://clickhouse.tech/docs/ru/operations/system_tables/quotas_usage) <!--hide-->

docs/ru/operations/system-tables/roles.md

@@ -5,7 +5,13 @@
 Столбцы:
 
 - `name` ([String](../../sql-reference/data-types/string.md)) — Имя роли.
+
 - `id` ([UUID](../../sql-reference/data-types/uuid.md)) — ID роли.
+
 - `storage` ([String](../../sql-reference/data-types/string.md)) — Путь к хранилищу ролей. Настраивается в параметре `access_control_path`.
 
+## Смотрите также {#see-also}
+
+-   [SHOW ROLES](../../sql-reference/statements/show.md#show-roles-statement)
+
 [Оригинальная статья](https://clickhouse.tech/docs/ru/operations/system_tables/roles) <!--hide-->

docs/ru/operations/system-tables/row_policies.md

@@ -27,4 +27,8 @@
 
 -    `apply_to_except` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — Политики строк применяются ко всем ролям и/или пользователям, за исключением перечисленных.
 
+## Смотрите также {#see-also}
+
+-   [SHOW POLICIES](../../sql-reference/statements/show.md#show-policies-statement)
+
 [Оригинальная статья](https://clickhouse.tech/docs/ru/operations/system_tables/row_policies) <!--hide-->

docs/ru/operations/system-tables/settings_profiles.md

@@ -17,4 +17,8 @@
 
 -    `apply_to_except` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — Профиль настроек применяется ко всем ролям и/или пользователям, за исключением перечисленных.
 
+## Смотрите также {#see-also}
+
+-   [SHOW PROFILES](../../sql-reference/statements/show.md#show-profiles-statement)
+
 [Оригинальная статья](https://clickhouse.tech/docs/ru/operations/system_tables/settings_profiles) <!--hide-->

docs/ru/operations/system-tables/users.md

@@ -27,4 +27,8 @@
 
 -    `default_roles_except` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — Все предоставленные роли задаются по умолчанию, за исключением перечисленных.
 
+## Смотрите также {#see-also}
+
+-   [SHOW USERS](../../sql-reference/statements/show.md#show-users-statement)
+
 [Оригинальная статья](https://clickhouse.tech/docs/ru/operations/system_tables/users) <!--hide-->

docs/ru/sql-reference/statements/show.md

@@ -169,4 +169,65 @@ SHOW CREATE QUOTA [name | CURRENT]
 SHOW CREATE [SETTINGS] PROFILE name
 ```
 
+
+## SHOW USERS {#show-users-statement}
+
+Выводит список [пользовательских аккаунтов](../../operations/access-rights.md#user-account-management). Для просмотра параметров пользовательских аккаунтов, см. системную таблицу [system.users](../../operations/system-tables/users.md#system_tables-users).
+
+### Синтаксис {#show-users-syntax}
+
+``` sql
+SHOW USERS
+```
+ 
+## SHOW ROLES {#show-roles-statement}
+
+Выводит список [ролей](../../operations/access-rights.md#role-management). Для просмотра параметров ролей, см. системные таблицы [system.roles](../../operations/system-tables/roles.md#system_tables-roles) и [system.role-grants](../../operations/system-tables/role-grants.md#system_tables-role_grants).
+
+### Синтаксис {#show-roles-syntax}
+
+``` sql
+SHOW [CURRENT|ENABLED] ROLES
+```
+
+## SHOW PROFILES {#show-profiles-statement}
+
+Выводит список [профилей настроек](../../operations/access-rights.md#settings-profiles-management). Для просмотра других параметров профилей настроек, см. системную таблицу [settings_profiles](../../operations/system-tables/settings_profiles.md#system_tables-settings_profiles).
+
+### Синтаксис {#show-profiles-syntax}
+
+``` sql
+SHOW [SETTINGS] PROFILES
+```
+
+## SHOW POLICIES {#show-policies-statement}
+
+Выводит список [политик доступа к строкам](../../operations/access-rights.md#row-policy-management) для указанной таблицы. Для просмотра других параметров, см. системную таблицу [system.row_policies](../../operations/system-tables/row_policies.md#system_tables-row_policies).
+
+### Синтаксис {#show-policies-syntax}
+
+``` sql
+SHOW [ROW] POLICIES [ON [db.]table]
+```
+
+## SHOW QUOTAS {#show-quotas-statement}
+
+Выводит список [квот](../../operations/access-rights.md#quotas-management). Для просмотра параметров квот, см. системную таблицу [system.quotas](../../operations/system-tables/quotas.md#system_tables-quotas).
+
+### Синтаксис {#show-quotas-syntax}
+
+``` sql
+SHOW QUOTAS
+```  
+    
+## SHOW QUOTA {#show-quota-statement}
+
+Выводит потребление [квоты](../../operations/quotas.md) для всех пользователей или только для текущего пользователя. Для просмотра других параметров, см. системные таблицы [system.quotas_usage](../../operations/system-tables/quotas_usage.md#system_tables-quotas_usage) и [system.quota_usage](../../operations/system-tables/quota_usage.md#system_tables-quota_usage).
+
+### Синтаксис {#show-quota-syntax}
+
+``` sql
+SHOW [CURRENT] QUOTA
+```
+
 [Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/show/) <!--hide-->