Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DOCSUP-3121: Update the SHOW DATABASES and SHOW TABLES descriptions #16115

Conversation

sevirov
Copy link
Contributor

@sevirov sevirov commented Oct 17, 2020

I hereby agree to the terms of the CLA available at: https://yandex.ru/legal/cla/?lang=en

Changelog category:

Update descriptions of show databases and show tables.
@robot-clickhouse robot-clickhouse added the pr-documentation Documentation PRs for the specific code PR label Oct 17, 2020
Update 'identical query'.
Syntax:

```sql
SHOW DATABASES [LIKE '<pattern>'] [ILIKE '<pattern>'] [NOT LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
SHOW DATABASES [LIKE '<pattern>'] [ILIKE '<pattern>'] [NOT LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]
SHOW DATABASES [LIKE|ILIKE|NOT LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]

This statement is identical to the query:

```sql
SELECT name FROM system.databases [WHERE name LIKE '<pattern>'] [WHERE name ILIKE '<pattern>'] [WHERE name NOT LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
SELECT name FROM system.databases [WHERE name LIKE '<pattern>'] [WHERE name ILIKE '<pattern>'] [WHERE name NOT LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]
SELECT name FROM system.databases [WHERE name LIKE|ILIKE|NOT LIKE '<pattern>'][LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]

SELECT name FROM system.databases [WHERE name LIKE '<pattern>'] [WHERE name ILIKE '<pattern>'] [WHERE name NOT LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]
```

### SHOW DATABASES LIKE {#show-databases-like}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it's better to place all the examples under the header ### Examples.
Each example doesn't need the header. You can preface examples with a description of what the example does. For example, "Getting database names, containing the symbol sequence de in their names."


### SHOW DATABASES LIKE {#show-databases-like}

Syntax:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not syntax, this is query.

Внес поправки согласно комментариям.
└─────────┘
```

Getting database names, containing the case insensitive symbols sequence 'de' in their names:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Getting database names, containing the case insensitive symbols sequence 'de' in their names:
Getting database names, containing symbols sequence 'de' in their names, in the case insensitive manner:

Внес поправки и перевел на русский язык.
└─────────┘
```

Получение списка баз данных, имена которых нечувствительные к регистру и содержащие последовательность символов 'de':
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Получение списка баз данных, имена которых нечувствительные к регистру и содержащие последовательность символов 'de':
Получение списка баз данных, имена которых содержат последовательность символов 'de' независимо от регистра:

└────────────────────────────────┘
```

Получение первых 2 строк из списка имен баз данных:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Получение первых 2 строк из списка имен баз данных:
Получение первых двух строк из списка имен баз данных:

└──────────────────┘
```

Получение списка таблиц, имена которых нечувствительные к регистру и содержащие последовательность символов 'user':
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Получение списка таблиц, имена которых нечувствительные к регистру и содержащие последовательность символов 'user':
Получение списка таблиц, имена которых содержат последовательность символов 'user' без учёта регистра:

Внес мелкие поправки.
@BayoNet BayoNet merged commit b8e754d into ClickHouse:master Oct 23, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
pr-documentation Documentation PRs for the specific code PR
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants