Skip to content

Improve Interactive CLI documentation #20013

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

Merged
merged 14 commits into from
Jul 11, 2025

Conversation

pnv1
Copy link
Collaborator

@pnv1 pnv1 commented Jun 22, 2025

Changelog entry

Changelog category

  • Documentation (changelog entry is not required)

Description for reviewers

@github-actions github-actions bot added the documentation Improvements or additions to documentation label Jun 22, 2025
Copy link

🟢 2025-06-22 19:02:55 UTC The validation of the Pull Request description is successful.

Copy link

github-actions bot commented Jun 22, 2025

2025-06-22 19:03:11 UTC Pre-commit check linux-x86_64-release-asan for f6e41ce has started.
2025-06-22 19:03:37 UTC Artifacts will be uploaded here
2025-06-22 19:07:03 UTC ya make is running...
🟢 2025-06-22 19:07:08 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-06-22 19:07:14 UTC Build successful.

Copy link

github-actions bot commented Jun 22, 2025

2025-06-22 19:03:18 UTC Pre-commit check linux-x86_64-relwithdebinfo for f6e41ce has started.
2025-06-22 19:03:30 UTC Artifacts will be uploaded here
2025-06-22 19:05:59 UTC ya make is running...
🟢 2025-06-22 19:06:04 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-06-22 19:06:10 UTC Build successful.

Copy link

✅ Documentation build

Revision built successfully
Revision preview link

Build logs

Warnings (2)

⚠️ en/reference/ydb-cli/interactive-cli.md: 13: MD022 / blanks-around-headings Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## Features {#features}"]

⚠️ en/reference/ydb-cli/interactive-cli.md: 14: MD032 / blanks-around-lists Lists should be surrounded by blank lines [Context: "* [Query history](#query-histo..."]

@ydbot
Copy link
Collaborator

ydbot commented Jun 23, 2025

🔄 New commits pushed — @ElenaAfina please take a look.

Copy link

github-actions bot commented Jun 23, 2025

2025-06-23 08:40:26 UTC Pre-commit check linux-x86_64-relwithdebinfo for 578dc36 has started.
2025-06-23 08:40:57 UTC Artifacts will be uploaded here
2025-06-23 08:44:05 UTC ya make is running...
🟢 2025-06-23 08:44:11 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-06-23 08:44:17 UTC Build successful.

Copy link

github-actions bot commented Jun 23, 2025

2025-06-23 08:41:07 UTC Pre-commit check linux-x86_64-release-asan for 578dc36 has started.
2025-06-23 08:41:19 UTC Artifacts will be uploaded here
2025-06-23 08:43:55 UTC ya make is running...
🟢 2025-06-23 08:44:00 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-06-23 08:44:06 UTC Build successful.

Copy link

✅ Documentation build

Revision built successfully
Revision preview link

Build logs

Warnings (4)

⚠️ en/reference/ydb-cli/interactive-cli.md: 13: MD022 / blanks-around-headings Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## Features {#features}"]

⚠️ en/reference/ydb-cli/interactive-cli.md: 14: MD032 / blanks-around-lists Lists should be surrounded by blank lines [Context: "* [Query history](#query-histo..."]

⚠️ ru/reference/ydb-cli/interactive-cli.md: 13: MD022 / blanks-around-headings Headings should be surrounded by blank lines [Expected: 1; Actual: 0; Below] [Context: "## Возможности {#features}"]

⚠️ ru/reference/ydb-cli/interactive-cli.md: 14: MD032 / blanks-around-lists Lists should be surrounded by blank lines [Context: "* [История запросов](#query-hi..."]

@ydbot
Copy link
Collaborator

ydbot commented Jun 23, 2025

🔄 New commits pushed — @ElenaAfina please take a look.

Copy link

github-actions bot commented Jun 23, 2025

2025-06-23 09:42:20 UTC Pre-commit check linux-x86_64-relwithdebinfo for 08aa085 has started.
2025-06-23 09:42:26 UTC Artifacts will be uploaded here
2025-06-23 09:44:51 UTC ya make is running...
🟢 2025-06-23 09:44:56 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-06-23 09:45:02 UTC Build successful.

Copy link

github-actions bot commented Jun 23, 2025

2025-06-23 09:42:37 UTC Pre-commit check linux-x86_64-release-asan for 08aa085 has started.
2025-06-23 09:42:48 UTC Artifacts will be uploaded here
2025-06-23 09:45:16 UTC ya make is running...
🟢 2025-06-23 09:45:22 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-06-23 09:45:28 UTC Build successful.

@pnv1 pnv1 marked this pull request as ready for review June 23, 2025 10:08
@pnv1 pnv1 requested a review from a team as a code owner June 23, 2025 10:08
@ydbot
Copy link
Collaborator

ydbot commented Jun 24, 2025

Hey @ElenaAfina, it has been 30 business-hours since the author's last update, could you please review?

@ydbot
Copy link
Collaborator

ydbot commented Jun 24, 2025

🔄 New commits pushed — @ElenaAfina please take a look.

Copy link

github-actions bot commented Jun 24, 2025

2025-06-24 12:18:49 UTC Pre-commit check linux-x86_64-relwithdebinfo for 7d5322a has started.
2025-06-24 12:19:22 UTC Artifacts will be uploaded here
2025-06-24 12:22:26 UTC ya make is running...
🟢 2025-06-24 12:22:32 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-06-24 12:22:37 UTC Build successful.

Copy link

✅ Documentation build

Revision built successfully
Revision preview link

Copy link

github-actions bot commented Jun 24, 2025

2025-06-24 12:25:53 UTC Pre-commit check linux-x86_64-release-asan for 7d5322a has started.
2025-06-24 12:26:01 UTC Artifacts will be uploaded here
2025-06-24 12:28:27 UTC ya make is running...
🟢 2025-06-24 12:28:32 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-06-24 12:28:38 UTC Build successful.

@ydbot
Copy link
Collaborator

ydbot commented Jun 24, 2025

🔄 New commits pushed — @ElenaAfina please take a look.

Copy link

github-actions bot commented Jun 24, 2025

2025-06-24 17:01:01 UTC Pre-commit check linux-x86_64-release-asan for 4a4650a has started.
2025-06-24 17:01:23 UTC Artifacts will be uploaded here
2025-06-24 17:04:23 UTC ya make is running...
🟢 2025-06-24 17:04:28 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-06-24 17:04:34 UTC Build successful.

Copy link

github-actions bot commented Jun 24, 2025

2025-06-24 17:02:03 UTC Pre-commit check linux-x86_64-relwithdebinfo for 4a4650a has started.
2025-06-24 17:02:25 UTC Artifacts will be uploaded here
2025-06-24 17:04:49 UTC ya make is running...
🟢 2025-06-24 17:04:54 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-06-24 17:05:00 UTC Build successful.

blinkov
blinkov previously requested changes Jul 1, 2025
Comment on lines 33 to 39
* YQL keywords (SELECT, FROM, WHERE, INSERT, UPDATE and others)
* Table and column names
* String literals (text in quotes)
* Numeric literals
* Operators (=, <, >, +, - and others)
* Special characters (brackets, commas, dots)
* Comments
Copy link
Member

Choose a reason for hiding this comment

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

Change it to be a table that explains which color represents what.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

We don't want to specify colors yet, it's a subject to change

Copy link
Member

Choose a reason for hiding this comment

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

Why? If they change, you'll be able to just update it.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

What's the point of specifying such thing? It's purpose is to distinguish one part of the script from another. No matter what colors are used. It has some default realisation and we don't want to sync it with the documentation if we decide to change it.

@ydbot
Copy link
Collaborator

ydbot commented Jul 3, 2025

🔄 New commits pushed — @ElenaAfina please take a look.

Copy link

github-actions bot commented Jul 3, 2025

2025-07-03 11:59:11 UTC Pre-commit check linux-x86_64-release-asan for 0720b51 has started.
2025-07-03 11:59:41 UTC Artifacts will be uploaded here
2025-07-03 12:02:50 UTC ya make is running...
🟢 2025-07-03 12:02:57 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-07-03 12:03:03 UTC Build successful.

Copy link

github-actions bot commented Jul 3, 2025

2025-07-03 12:01:24 UTC Pre-commit check linux-x86_64-relwithdebinfo for 0720b51 has started.
2025-07-03 12:01:53 UTC Artifacts will be uploaded here
2025-07-03 12:04:58 UTC ya make is running...
🟢 2025-07-03 12:05:05 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-07-03 12:05:11 UTC Build successful.

Copy link

github-actions bot commented Jul 3, 2025

✅ Documentation build

Revision built successfully
Revision preview link

@ydbot
Copy link
Collaborator

ydbot commented Jul 4, 2025

Hey @ElenaAfina, it has been 31 business-hours since the author's last update, could you please review?

Co-authored-by: Ivan Blinkov <ivan@blinkov.ru>
Copy link

github-actions bot commented Jul 7, 2025

2025-07-07 08:00:38 UTC Pre-commit check linux-x86_64-release-asan for 5a76189 has started.
2025-07-07 08:00:50 UTC Artifacts will be uploaded here
2025-07-07 08:03:25 UTC ya make is running...
🟢 2025-07-07 08:03:31 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-07-07 08:03:38 UTC Build successful.

@ydbot
Copy link
Collaborator

ydbot commented Jul 7, 2025

🔄 New commits pushed — @ElenaAfina please take a look.

Copy link

github-actions bot commented Jul 7, 2025

2025-07-07 08:01:39 UTC Pre-commit check linux-x86_64-relwithdebinfo for 5a76189 has started.
2025-07-07 08:01:51 UTC Artifacts will be uploaded here
2025-07-07 08:04:17 UTC ya make is running...
🟢 2025-07-07 08:04:24 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-07-07 08:04:30 UTC Build successful.

Copy link

github-actions bot commented Jul 7, 2025

✅ Documentation build

Revision built successfully
Revision preview link

Copy link

github-actions bot commented Jul 7, 2025

2025-07-07 08:24:48 UTC Pre-commit check linux-x86_64-release-asan for 8995a46 has started.
2025-07-07 08:24:52 UTC Artifacts will be uploaded here
2025-07-07 08:27:24 UTC ya make is running...
🟢 2025-07-07 08:27:30 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-07-07 08:27:37 UTC Build successful.

@ydbot
Copy link
Collaborator

ydbot commented Jul 7, 2025

🔄 New commits pushed — @ElenaAfina please take a look.

Copy link

github-actions bot commented Jul 7, 2025

2025-07-07 08:27:24 UTC Pre-commit check linux-x86_64-relwithdebinfo for 8995a46 has started.
2025-07-07 08:27:36 UTC Artifacts will be uploaded here
2025-07-07 08:30:08 UTC ya make is running...
🟢 2025-07-07 08:30:14 UTC Tests successful.

Test history | Ya make output | Test bloat

TESTS PASSED ERRORS FAILED SKIPPED MUTED?
0 0 0 0 0 0

🟢 2025-07-07 08:30:21 UTC Build successful.

Copy link

github-actions bot commented Jul 7, 2025

✅ Documentation build

Revision built successfully
Revision preview link

@ydbot
Copy link
Collaborator

ydbot commented Jul 8, 2025

Hey @ElenaAfina, it has been 28 business-hours since the author's last update, could you please review?

@ydbot
Copy link
Collaborator

ydbot commented Jul 9, 2025

Hey @ElenaAfina, it has been 58 business-hours since the author's last update, could you please review?

@ydbot
Copy link
Collaborator

ydbot commented Jul 10, 2025

Hey @ElenaAfina, it has been 82 business-hours since the author's last update, could you please review?

@blinkov blinkov enabled auto-merge (squash) July 11, 2025 03:17
Выполнив команду `ydb` без подкоманд, запустится интерактивный режим выполнения запросов. Консоль или терминал будут переведены в интерактивный режим. После этого можно вводить запросы напрямую в консоль или терминал, при вводе символа перевода строки запрос считается законченным и он начинает исполняться. Текст запроса может представлять из себя как YQL запрос, так и [специальную команду](#spec-commands). Также между запусками сохраняется история запросов, доступны автодополнение команд и поиск по истории запросов.
## Общее описание

После выполнения команды `{{ ydb-cli }}` без подкоманд запускается интерактивный режим выполнения запросов. После этого можно вводить запросы напрямую в консоль или терминал. При вводе символа перевода строки запрос считается законченным, и он начинает исполняться. Текст запроса может представлять из себя как YQL запрос, так и [специальную команду](#spec-commands).
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
После выполнения команды `{{ ydb-cli }}` без подкоманд запускается интерактивный режим выполнения запросов. После этого можно вводить запросы напрямую в консоль или терминал. При вводе символа перевода строки запрос считается законченным, и он начинает исполняться. Текст запроса может представлять из себя как YQL запрос, так и [специальную команду](#spec-commands).
Запуск команды `{{ ydb-cli }}` без подкоманд инициирует интерактивный режим выполнения запросов. После этого можно вводить запросы напрямую в консоль или терминал. При вводе символа перевода строки запрос считается законченным, и он начинает исполняться. Текст запроса может представлять из себя как YQL запрос, так и [специальную команду](#spec-commands).

@blinkov blinkov merged commit 703afff into ydb-platform:main Jul 11, 2025
13 checks passed
@pnv1 pnv1 deleted the add-interactive-cli-documentation branch July 11, 2025 06:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants