Docs en,ru PLUS templates updates

This commit is contained in:
Olga Revyakina 2021-03-06 11:59:50 +03:00
parent af2135ef9d
commit ff76356fd1
8 changed files with 149 additions and 15 deletions

View File

@ -58,6 +58,6 @@ Result:
Follow up with any text to clarify the example.
## See Also {#see-also}
**See Also** {#see-also}
- [link](#)

View File

@ -14,18 +14,16 @@ More text (Optional).
**Arguments** (Optional)
- `x` — Description. [Type name](relative/path/to/type/dscr.md#type).
- `y` — Description. [Type name](relative/path/to/type/dscr.md#type).
- `x` — Description. Optional (only for optional arguments). Possible values: <values list>. Default value: <value>. [Type name](relative/path/to/type/dscr.md#type).
- `y` — Description. Optional (only for optional arguments). Possible values: <values list>.Default value: <value>. [Type name](relative/path/to/type/dscr.md#type).
**Parameters** (Optional, only for parametric aggregate functions)
- `z` — Description. [Type name](relative/path/to/type/dscr.md#type).
- `z` — Description. Optional (only for optional parameters). Possible values: <values list>.Default value: <value>. [Type name](relative/path/to/type/dscr.md#type).
**Returned value(s)**
- Returned values list.
Type: [Type name](relative/path/to/type/dscr.md#type).
- Returned values list. Type: [Type name](relative/path/to/type/dscr.md#type).
**Example**

View File

@ -8,14 +8,14 @@ Possible value: ...
Default value: ...
Settings: (Optional)
**Settings** (Optional)
If the section contains several settings, list them here. Specify possible values and default values:
- setting_1 — Description.
- setting_2 — Description.
**Example:**
**Example**
```xml
<server_setting_name>

View File

@ -1,14 +1,14 @@
# Statement name (for example, SHOW USER)
# Statement name (for example, SHOW USER) {#statement-name-in-lower-case}
Brief description of what the statement does.
Syntax:
**Syntax**
```sql
Syntax of the statement.
```
## Other necessary sections of the description (Optional)
## Other necessary sections of the description (Optional) {#anchor}
Examples of descriptions with a complicated structure:
@ -17,7 +17,7 @@ Examples of descriptions with a complicated structure:
- https://clickhouse.tech/docs/en/sql-reference/statements/select/join/
## See Also (Optional)
**See Also** (Optional)
Links to related topics as a list.

View File

@ -48,5 +48,6 @@ SELECT * FROM system.settings WHERE changed AND name='load_balancing'
- [Settings](../../operations/settings/index.md#session-settings-intro)
- [Permissions for Queries](../../operations/settings/permissions-for-queries.md#settings_readonly)
- [Constraints on Settings](../../operations/settings/constraints-on-settings.md)
- [SHOW SETTINGS](../../sql-reference/statements/show.md#show-settings) statement
[Original article](https://clickhouse.tech/docs/en/operations/system_tables/settings) <!--hide-->

View File

@ -428,4 +428,71 @@ errors_count: 0
estimated_recovery_time: 0
```
[Original article](https://clickhouse.tech/docs/en/query_language/show/) <!--hide-->
## SHOW SETTINGS {#show-settings}
Returns a list of system settings and their values. Selects data from the [system.settings](../../operations/system-tables/settings.md) table.
**Syntax**
```sql
SHOW [CHANGED] SETTINGS LIKE|ILIKE <name>;
```
**Clauses**
`LIKE` clause needs a setting name or part of the name without globs.
`ILIKE` clause can contain globs such as `%` or `_`.
When the `CHANGED` clause is used, the query returns only settings changed from their default values.
**Examples**
Query with the `LIKE` clause:
```sql
SHOW SETTINGS LIKE 'send_timeout';
```
Result:
```text
┌─name─────────┬─type────┬─value─┐
│ send_timeout │ Seconds │ 300 │
└──────────────┴─────────┴───────┘
```
Query with the `ILIKE` clause:
```sql
SHOW SETTINGS ILIKE '%CONNECT_timeout%'
```
Result:
```text
┌─name────────────────────────────────────┬─type─────────┬─value─┐
│ connect_timeout │ Seconds │ 10 │
│ connect_timeout_with_failover_ms │ Milliseconds │ 50 │
│ connect_timeout_with_failover_secure_ms │ Milliseconds │ 100 │
└─────────────────────────────────────────┴──────────────┴───────┘
```
Query with the `CHANGED` clause:
```sql
SHOW CHANGED SETTINGS ILIKE '%MEMORY%'
```
Result:
```text
┌─name─────────────┬─type───┬─value───────┐
│ max_memory_usage │ UInt64 │ 10000000000 │
└──────────────────┴────────┴─────────────┘
```
**See Also**
- [system.settings](../../operations/system-tables/settings.md) table
[Original article](https://clickhouse.tech/docs/en/sql-reference/statements/show/) <!--hide-->

View File

@ -48,5 +48,6 @@ SELECT * FROM system.settings WHERE changed AND name='load_balancing'
- [Настройки](../settings/index.md#settings)
- [Разрешения для запросов](../settings/permissions-for-queries.md#settings_readonly)
- [Ограничения для значений настроек](../settings/constraints-on-settings.md)
- Выражение [SHOW SETTINGS](../../sql-reference/statements/show.md#show-settings)
[Оригинальная статья](https://clickhouse.tech/docs/ru/operations/system_tables/settings) <!--hide-->

View File

@ -362,4 +362,71 @@ SHOW [CURRENT] QUOTA
SHOW ACCESS
```
[Оригинальная статья](https://clickhouse.tech/docs/ru/query_language/show/) <!--hide-->
## SHOW SETTINGS {#show-settings}
Возвращает список системных настроек и их значений. Использует данные из таблицы [system.settings](../../operations/system-tables/settings.md).
**Синтаксис**
```sql
SHOW [CHANGED] SETTINGS LIKE|ILIKE <name>;
```
**Секции**
При использовании `LIKE` необходимо указывать имя или часть имени системной настройки без символов подстановки.
При использовании `ILIKE` имя системной настройки может содержать символы подстановки, такие как `%` или `_`.
Если используется `CHANGED`, запрос вернет только те настройки, значения которых были изменены, т.е. отличны от значений по умолчанию.
**Примеры**
Запрос с использованием `LIKE`:
```sql
SHOW SETTINGS LIKE 'send_timeout';
```
Результат:
```text
┌─name─────────┬─type────┬─value─┐
│ send_timeout │ Seconds │ 300 │
└──────────────┴─────────┴───────┘
```
Запрос с использованием `ILIKE`:
```sql
SHOW SETTINGS ILIKE '%CONNECT_timeout%'
```
Результат:
```text
┌─name────────────────────────────────────┬─type─────────┬─value─┐
│ connect_timeout │ Seconds │ 10 │
│ connect_timeout_with_failover_ms │ Milliseconds │ 50 │
│ connect_timeout_with_failover_secure_ms │ Milliseconds │ 100 │
└─────────────────────────────────────────┴──────────────┴───────┘
```
Запрос с использованием `CHANGED`:
```sql
SHOW CHANGED SETTINGS ILIKE '%MEMORY%'
```
Результат:
```text
┌─name─────────────┬─type───┬─value───────┐
│ max_memory_usage │ UInt64 │ 10000000000 │
└──────────────────┴────────┴─────────────┘
```
**См. также**
- Таблица [system.settings](../../operations/system-tables/settings.md)
[Оригинальная статья](https://clickhouse.tech/docs/ru/sql-reference/statements/show/) <!--hide-->