DOCSUP-1395: Add desc for system tables. (#13852)

* Add desc for system tables.

* Fixed links, add comments from the developer

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

Co-authored-by: BayoNet <da-daos@yandex.ru>

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

Co-authored-by: BayoNet <da-daos@yandex.ru>

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

Co-authored-by: BayoNet <da-daos@yandex.ru>

* Update docs/en/operations/system-tables/settings_profile_elements.md

Co-authored-by: BayoNet <da-daos@yandex.ru>

* Update docs/en/operations/system-tables/settings_profile_elements.md

Co-authored-by: BayoNet <da-daos@yandex.ru>

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

Co-authored-by: BayoNet <da-daos@yandex.ru>

* Update docs/en/operations/system-tables/settings_profile_elements.md

Co-authored-by: BayoNet <da-daos@yandex.ru>

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

Co-authored-by: BayoNet <da-daos@yandex.ru>

* Link to Enum.

* Added translation to russian

* Update row_policies.md

* Add lost description

* Update docs/ru/operations/system-tables/grants.md

Co-authored-by: BayoNet <da-daos@yandex.ru>

* Update docs/ru/operations/system-tables/grants.md

Co-authored-by: BayoNet <da-daos@yandex.ru>

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

Co-authored-by: BayoNet <da-daos@yandex.ru>

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

Co-authored-by: BayoNet <da-daos@yandex.ru>

* Additions

* Fixed links

Co-authored-by: Anna Devyatova <annadevyatova@yandex-team.ru>
Co-authored-by: BayoNet <da-daos@yandex.ru>

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

@@ -0,0 +1,24 @@
+# system.grants {#system_tables-grants}
+
+Privileges granted to ClickHouse user accounts.
+
+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 assigned to user account.
+
+-    `access_type` ([Enum8](../../sql-reference/data-types/enum.md)) — Access parameters for ClickHouse user account.
+
+-    `database` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Name of a database.
+
+-    `table` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Name of a table.
+
+-    `column` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Name of a column to which access is granted.
+
+-    `is_partial_revoke` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Logical value. It shows whether some privileges have been revoked. Possible values:
+- `0` — The row describes a partial revoke.
+- `1` — The row describes a grant.
+
+-    `grant_option` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Permission is granted `WITH GRANT OPTION`, see [GRANT](../../sql-reference/statements/grant.md#grant-privigele-syntax).
+
+[Original article](https://clickhouse.tech/docs/en/operations/system_tables/grants) <!--hide-->

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

@@ -0,0 +1,30 @@
+# system.row_policies {#system_tables-row_policies}
+
+Contains filters for one particular table, as well as a list of roles and/or users which should use this row policy.
+
+Columns:
+-    `name` ([String](../../sql-reference/data-types/string.md)) — Name of a row policy.
+
+-    `short_name` ([String](../../sql-reference/data-types/string.md)) — Short name of a row policy. Names of row policies are compound, for example: myfilter ON mydb.mytable. Here "myfilter ON mydb.mytable" is the name of the row policy, "myfilter" is it's short name.
+
+-    `database` ([String](../../sql-reference/data-types/string.md)) — Database name.
+
+-    `table` ([String](../../sql-reference/data-types/string.md)) — Table name.
+
+-    `id` ([UUID](../../sql-reference/data-types/uuid.md)) — Row policy ID.
+
+-    `storage` ([String](../../sql-reference/data-types/string.md)) — Name of the directory where the row policy is stored. 
+
+-    `select_filter` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Condition which is used to filter rows.
+
+-    `is_restrictive` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Shows whether the row policy restricts access to rows, see [CREATE ROW POLICY](../../sql-reference/statements/create/row-policy.md#create-row-policy-as). Value:
+- `0` — The row policy is defined with `AS PERMISSIVE` clause.
+- `1` — The row policy is defined with `AS RESTRICTIVE` clause.
+
+-    `apply_to_all` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Shows that the row policies set for all roles and/or users.
+
+-    `apply_to_list` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — List of the roles and/or users to which the row policies is applied.
+
+-    `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.
+
+[Original article](https://clickhouse.tech/docs/en/operations/system_tables/row_policies) <!--hide-->

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

@@ -0,0 +1,30 @@
+# system.settings_profile_elements {#system_tables-settings_profile_elements}
+
+Describes the content of the settings profile:
+
+- Сonstraints.
+- Roles and users that the setting applies to.
+- Parent settings profiles.
+
+Columns:
+-    `profile_name` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Setting profile name.
+
+-    `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.
+
+-    `index` ([UInt64](../../sql-reference/data-types/int-uint.md)) — Sequential number of the settings profile element.
+
+-    `setting_name` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Setting name.
+
+-    `value` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Setting value.
+
+-    `min` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — The minimum value of the setting. `NULL` if not set.
+
+-    `max` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — The maximum value of the setting. NULL if not set.
+
+-    `readonly` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges))) — Profile that allows only read queries.
+
+-    `inherit_profile` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — A parent profile for this setting profile. `NULL` if not set. Setting profile will inherit all the settings' values and constraints (`min`, `max`, `readonly`) from its parent profiles.
+
+[Original article](https://clickhouse.tech/docs/en/operations/system_tables/settings_profile_elements) <!--hide-->

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

@@ -0,0 +1,20 @@
+# system.settings_profiles {#system_tables-settings_profiles}
+
+Contains properties of configured setting profiles.
+
+Columns:
+-    `name` ([String](../../sql-reference/data-types/string.md)) — Setting profile name.
+
+-    `id` ([UUID](../../sql-reference/data-types/uuid.md)) — Setting profile ID.
+
+-    `storage` ([String](../../sql-reference/data-types/string.md)) — Path to the storage of setting profiles. Configured in the `access_control_path` parameter. 
+
+-    `num_elements` ([UInt64](../../sql-reference/data-types/int-uint.md)) — Number of elements for this profile in the `system.settings_profile_elements` table.
+
+-    `apply_to_all` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Shows that the settings profile set for all roles and/or users.
+
+-    `apply_to_list` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — List of the roles and/or users to which the setting profile is applied.
+
+-    `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.
+
+[Original article](https://clickhouse.tech/docs/en/operations/system_tables/settings_profiles) <!--hide-->

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

@@ -0,0 +1,30 @@
+# system.users {#system_tables-users}
+
+Contains a list of [user accounts](../../operations/access-rights.md#user-account-management) configured at the server.
+
+Columns:
+-    `name` ([String](../../sql-reference/data-types/string.md)) — User name.
+
+-    `id` ([UUID](../../sql-reference/data-types/uuid.md)) — User ID.
+
+-    `storage` ([String](../../sql-reference/data-types/string.md)) — Path to the storage of users. Configured in the `access_control_path` parameter. 
+
+-    `auth_type` ([Enum8](../../sql-reference/data-types/enum.md)('no_password' = 0,'plaintext_password' = 1, 'sha256_password' = 2, 'double_sha1_password' = 3)) — Shows the authentication type. There are multiple ways of user identification: with no password, with plain text password, with [SHA256](https://ru.wikipedia.org/wiki/SHA-2)-encoded password or with [double SHA-1](https://ru.wikipedia.org/wiki/SHA-1)-encoded password.
+
+-    `auth_params` ([String](../../sql-reference/data-types/string.md)) — Authentication parameters in the JSON format depending on the `auth_type`.
+
+-    `host_ip` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — IP addresses of hosts that are allowed to connect to the ClickHouse server.
+
+-    `host_names` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — Names of hosts that are allowed to connect to the ClickHouse server.
+
+-    `host_names_regexp` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — Regular expression for host names that are allowed to connect to the ClickHouse server.
+
+-    `host_names_like` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — Names of hosts that are allowed to connect to the ClickHouse server, set using the LIKE predicate.
+
+-    `default_roles_all` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Shows that all granted roles set for user by default.
+
+-    `default_roles_list` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — List of granted roles provided by default.
+
+-    `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.
+
+[Original article](https://clickhouse.tech/docs/en/operations/system_tables/users) <!--hide-->

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

@@ -0,0 +1,24 @@
+# system.grants {#system_tables-grants}
+
+Привилегии пользовательских аккаунтов ClickHouse.
+
+Столбцы:
+-    `user_name` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Название учётной записи.
+
+-    `role_name` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Роль, назначенная учетной записи пользователя.
+
+-    `access_type` ([Enum8](../../sql-reference/data-types/enum.md)) — Параметры доступа для учетной записи пользователя ClickHouse.
+
+-    `database` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Имя базы данных.
+
+-    `table` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Имя таблицы.
+
+-    `column` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Имя столбца, к которому предоставляется доступ.
+
+-    `is_partial_revoke` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Логическое значение. Показывает, были ли отменены некоторые привилегии. Возможные значения:
+- `0` — Строка описывает частичный отзыв.
+- `1` — Строка описывает грант.
+
+-    `grant_option` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Разрешение предоставлено с опцией `WITH GRANT OPTION`, подробнее см. [GRANT](../../sql-reference/statements/grant.md#grant-privigele-syntax).
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/operations/system_tables/grants) <!--hide-->

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

@@ -0,0 +1,30 @@
+# system.row_policies {#system_tables-row_policies}
+
+Содержит фильтры безопасности уровня строк (политики строк) для каждой таблицы, а также список ролей и/или пользователей, к которым применяются эти политики.
+
+Столбцы:
+-    `name` ([String](../../sql-reference/data-types/string.md)) — Имя политики строк.
+
+-    `short_name` ([String](../../sql-reference/data-types/string.md)) — Короткое имя политики строк. Имена политик строк являются составными, например: `myfilter ON mydb.mytable`. Здесь `myfilter ON mydb.mytable` — это имя политики строк, `myfilter` — короткое имя.
+
+-    `database` ([String](../../sql-reference/data-types/string.md)) — Имя базы данных.
+
+-    `table` ([String](../../sql-reference/data-types/string.md)) — Имя таблицы.
+
+-    `id` ([UUID](../../sql-reference/data-types/uuid.md)) — ID политики строк.
+
+-    `storage` ([String](../../sql-reference/data-types/string.md)) — Имя каталога, в котором хранится политика строк.
+
+-    `select_filter` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Условие, которое используется для фильтрации строк.
+
+-    `is_restrictive` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Показывает, ограничивает ли политика строк доступ к строкам, подробнее см. [CREATE ROW POLICY](../../sql-reference/statements/create/row-policy.md#create-row-policy-as). Значения:
+- `0` — Политика строк определяется с помощью условия 'AS PERMISSIVE'.
+- `1` — Политика строк определяется с помощью условия 'AS RESTRICTIVE'.
+
+-    `apply_to_all` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Показывает, что политики строк заданы для всех ролей и/или пользователей.
+
+-    `apply_to_list` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — Список ролей и/или пользователей, к которым применяется политика строк.
+
+-    `apply_to_except` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — Политики строк применяются ко всем ролям и/или пользователям, за исключением перечисленных.
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/operations/system_tables/row_policies) <!--hide-->

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

@@ -0,0 +1,30 @@
+# system.settings_profile_elements {#system_tables-settings_profile_elements}
+
+Описывает содержимое профиля настроек:
+
+- Ограничения.
+- Роли и пользователи, к которым применяется настройка.
+- Родительские профили настроек.
+
+Столбцы:
+-    `profile_name` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Имя профиля настроек.
+
+-    `user_name` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Имя пользователя.
+
+-    `role_name` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Имя роли.
+
+-    `index` ([UInt64](../../sql-reference/data-types/int-uint.md)) — Порядковый номер элемента профиля настроек.
+
+-    `setting_name` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Имя настройки.
+
+-    `value` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Значение настройки.
+
+-    `min` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Минимальное значение настройки. `NULL` если не задано.
+
+-    `max` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Максимальное значение настройки. `NULL` если не задано.
+
+-    `readonly` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges))) — Профиль разрешает только запросы на чтение.
+
+-    `inherit_profile` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — Родительский профиль для данного профиля настроек. `NULL` если не задано. Профиль настроек может наследовать все значения и ограничения настроек (`min`, `max`, `readonly`) от своего родительского профиля.
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/operations/system_tables/settings_profile_elements) <!--hide-->

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

@@ -0,0 +1,20 @@
+# system.settings_profiles {#system_tables-settings_profiles}
+
+Содержит свойства сконфигурированных профилей настроек.
+
+Столбцы:
+-    `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`. 
+
+-    `num_elements` ([UInt64](../../sql-reference/data-types/int-uint.md)) — Число элементов для этого профиля в таблице `system.settings_profile_elements`.
+
+-    `apply_to_all` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Признак, который показывает, что параметры профиля заданы для всех ролей и/или пользователей.
+
+-    `apply_to_list` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — Список ролей и/или пользователей, к которым применяется профиль настроек.
+
+-    `apply_to_except` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — Профиль настроек применяется ко всем ролям и/или пользователям, за исключением перечисленных.
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/operations/system_tables/settings_profiles) <!--hide-->

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

@@ -0,0 +1,30 @@
+# system.users {#system_tables-users}
+
+Содержит список [аккаунтов пользователей](../../operations/access-rights.md#user-account-management), настроенных на сервере.
+
+Столбцы:
+-    `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`. 
+
+-    `auth_type` ([Enum8](../../sql-reference/data-types/enum.md)('no_password' = 0,'plaintext_password' = 1, 'sha256_password' = 2, 'double_sha1_password' = 3)) — Показывает тип аутентификации. Существует несколько способов идентификации пользователя: без пароля, с помощью обычного текстового пароля, с помощью шифрования [SHA256] (https://ru.wikipedia.org/wiki/SHA-2) или с помощью шифрования [double SHA-1] (https://ru.wikipedia.org/wiki/SHA-1).
+
+-    `auth_params` ([String](../../sql-reference/data-types/string.md)) — Параметры аутентификации в формате JSON, зависят от `auth_type`.
+
+-    `host_ip` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — IP-адреса хостов, которым разрешено подключаться к серверу ClickHouse.
+
+-    `host_names` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — Имена хостов, которым разрешено подключаться к серверу ClickHouse.
+
+-    `host_names_regexp` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — Регулярное выражение для имен хостов, которым разрешено подключаться к серверу ClickHouse.
+
+-    `host_names_like` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — Имена хостов, которым разрешено подключаться к серверу ClickHouse, заданные с помощью предиката LIKE.
+
+-    `default_roles_all` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Показывает, что все предоставленные роли установлены для пользователя по умолчанию.
+
+-    `default_roles_list` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — Список предоставленных ролей по умолчанию.
+
+-    `default_roles_except` ([Array](../../sql-reference/data-types/array.md)([String](../../sql-reference/data-types/string.md))) — Все предоставленные роли задаются по умолчанию, за исключением перечисленных.
+
+[Оригинальная статья](https://clickhouse.tech/docs/ru/operations/system_tables/users) <!--hide-->