Skip to content

Docs: describe show create #19170

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 28 commits into from
Jun 17, 2025

Conversation

shnikd
Copy link
Collaborator

@shnikd shnikd commented Jun 2, 2025

@shnikd shnikd requested a review from a team as a code owner June 2, 2025 12:08
Copy link

github-actions bot commented Jun 2, 2025

2025-06-02 12:10:04 UTC Pre-commit check linux-x86_64-release-asan for 570a06a has started.
2025-06-02 12:10:14 UTC Artifacts will be uploaded here
2025-06-02 12:12:39 UTC ya make is running...
🟢 2025-06-02 12:12:45 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2025-06-02 12:12:51 UTC Build successful.

Copy link

github-actions bot commented Jun 2, 2025

🟢 2025-06-02 14:16:56 UTC The validation of the Pull Request description is successful.

Copy link

github-actions bot commented Jun 2, 2025

2025-06-02 12:10:20 UTC Pre-commit check linux-x86_64-relwithdebinfo for 570a06a has started.
2025-06-02 12:10:47 UTC Artifacts will be uploaded here
2025-06-02 12:13:38 UTC ya make is running...
🟢 2025-06-02 12:13:44 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2025-06-02 12:13:49 UTC Build successful.

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

github-actions bot commented Jun 2, 2025

❌ Documentation build

Revision build failed

Build logs

Errors (2)

❌ ENOENT: no such file or directory, open '/en/yql/reference/syntax/show_create.md'

❌ ENOENT: no such file or directory, open '/ru/yql/reference/syntax/show_create.md'

Copy link

github-actions bot commented Jun 2, 2025

2025-06-02 12:20:45 UTC Pre-commit check linux-x86_64-release-asan for 73fe127 has started.
2025-06-02 12:20:56 UTC Artifacts will be uploaded here
2025-06-02 12:23:21 UTC ya make is running...
🟢 2025-06-02 12:23:27 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2025-06-02 12:23:33 UTC Build successful.

Copy link

github-actions bot commented Jun 2, 2025

2025-06-02 12:21:34 UTC Pre-commit check linux-x86_64-relwithdebinfo for 73fe127 has started.
2025-06-02 12:22:01 UTC Artifacts will be uploaded here
2025-06-02 12:24:52 UTC ya make is running...
🟢 2025-06-02 12:24:58 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2025-06-02 12:25:04 UTC Build successful.

Copy link

github-actions bot commented Jun 2, 2025

❌ Documentation build

Revision build failed

Build logs

Errors (2)

❌ ENOENT: no such file or directory, open '/en/yql/reference/syntax/show_create.md'

❌ ENOENT: no such file or directory, open '/ru/yql/reference/syntax/show_create.md'

Copy link

github-actions bot commented Jun 2, 2025

2025-06-02 13:07:22 UTC Pre-commit check linux-x86_64-release-asan for 5125aff has started.
2025-06-02 13:07:33 UTC Artifacts will be uploaded here
2025-06-02 13:10:02 UTC Check cancelled

Copy link

github-actions bot commented Jun 2, 2025

2025-06-02 13:07:56 UTC Pre-commit check linux-x86_64-relwithdebinfo for 5125aff has started.
2025-06-02 13:08:08 UTC Artifacts will be uploaded here
2025-06-02 13:10:06 UTC Check cancelled

@github-actions github-actions bot added documentation Improvements or additions to documentation and removed documentation Improvements or additions to documentation labels Jun 2, 2025
Copy link

github-actions bot commented Jun 2, 2025

2025-06-02 13:14:52 UTC Pre-commit check linux-x86_64-relwithdebinfo for 0ad65c4 has started.
2025-06-02 13:15:03 UTC Artifacts will be uploaded here
2025-06-02 13:17:24 UTC ya make is running...
🟢 2025-06-02 13:17:29 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2025-06-02 13:17:35 UTC Build successful.

Copy link

github-actions bot commented Jun 2, 2025

2025-06-02 13:15:02 UTC Pre-commit check linux-x86_64-release-asan for 0ad65c4 has started.
2025-06-02 13:15:14 UTC Artifacts will be uploaded here
2025-06-02 13:17:45 UTC ya make is running...
🟢 2025-06-02 13:17:51 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2025-06-02 13:17:57 UTC Build successful.

@github-actions github-actions bot added documentation Improvements or additions to documentation and removed documentation Improvements or additions to documentation labels Jun 2, 2025
Copy link

github-actions bot commented Jun 2, 2025

✅ Documentation build

Revision built successfully
Revision preview link

Build logs

Warnings (3)

⚠️ en/yql/reference/syntax/show_create.md: 5: MD001 / heading-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3]

⚠️ ru/yql/reference/syntax/show_create.md: 5: MD001 / heading-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3]

⚠️ ru/yql/reference/syntax/show_create.md: 5: MD026 / no-trailing-punctuation Trailing punctuation in heading [Punctuation: ':']

Copy link

github-actions bot commented Jun 2, 2025

2025-06-02 13:31:40 UTC Pre-commit check linux-x86_64-relwithdebinfo for 735fa97 has started.
2025-06-02 13:31:56 UTC Artifacts will be uploaded here
2025-06-02 13:34:58 UTC ya make is running...
🟢 2025-06-02 13:35: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-02 13:35:10 UTC Build successful.

Copy link

github-actions bot commented Jun 2, 2025

2025-06-02 13:32:48 UTC Pre-commit check linux-x86_64-release-asan for 735fa97 has started.
2025-06-02 13:33:17 UTC Artifacts will be uploaded here
2025-06-02 13:36:16 UTC ya make is running...
🟢 2025-06-02 13:36: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-02 13:36:28 UTC Build successful.

@shnikd shnikd requested a review from anton-bobkov June 6, 2025 11:48
blinkov
blinkov previously requested changes Jun 9, 2025
ADD CHANGEFEED `feed_3` WITH (MODE = 'KEYS_ONLY', FORMAT = 'JSON', RETENTION_PERIOD = INTERVAL('PT30M'), TOPIC_MIN_ACTIVE_PARTITIONS = 3)
;

ALTER SEQUENCE `/Root/my_table/_serial_column_Key3` START WITH 101 INCREMENT BY 404 RESTART;
Copy link
Member

Choose a reason for hiding this comment

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

Why is this the only place that uses an absolute path?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Для alter sequence сейчас поддерживается только абсолютный путь

- [ALTER TABLE ... ALTER INDEX](alter_table/secondary_index#alter-index) — for index partitioning settings.
- [ALTER TABLE ... ADD CHANGEFEED](alter_table/changefeed.md) — for adding a changefeed.
- `ALTER SEQUENCE` — for restoring a `Sequence` state for `Serial` columns.
- For views: the definition via [CREATE VIEW](create-view.md), and, if necessary, [PRAGMA TablePathPrefix](pragma#table-path-prefix).
Copy link
Member

Choose a reason for hiding this comment

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

The TablePathPrefix thing needs more clarification: when is it added, and why is it necessary?

Copy link
Collaborator

@jepett0 jepett0 Jun 9, 2025

Choose a reason for hiding this comment

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

Unfortunately, the capturing of pragmas by views is not yet described in the documentation. Here is the issue:

I propose to not block the current PR and merge it with something minimal, like:

For views: the definition via CREATE VIEW and the statements the view has [captured](here would be the link to the context capturing by views) from the creation context, for example, PRAGMA TablePathPrefix.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Добавил описание

shnikd and others added 2 commits June 9, 2025 13:49
Co-authored-by: Ivan Blinkov <ivan@blinkov.ru>
Co-authored-by: Ivan Blinkov <ivan@blinkov.ru>
@ydbot
Copy link
Collaborator

ydbot commented Jun 9, 2025

🔄 New commits pushed — @anton-bobkov please take a look.

Copy link

github-actions bot commented Jun 9, 2025

2025-06-09 10:51:29 UTC Pre-commit check linux-x86_64-relwithdebinfo for 7d1ebe0 has started.
2025-06-09 10:51:51 UTC Artifacts will be uploaded here
2025-06-09 10:52:36 UTC Check cancelled

Copy link

github-actions bot commented Jun 9, 2025

2025-06-09 10:51:45 UTC Pre-commit check linux-x86_64-release-asan for 7d1ebe0 has started.
2025-06-09 10:52:09 UTC Artifacts will be uploaded here
2025-06-09 10:52:36 UTC Check cancelled

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

ydbot commented Jun 9, 2025

🔄 New commits pushed — @anton-bobkov please take a look.

Copy link

github-actions bot commented Jun 9, 2025

2025-06-09 10:56:15 UTC Pre-commit check linux-x86_64-release-asan for 752eb50 has started.
2025-06-09 10:56:27 UTC Artifacts will be uploaded here
2025-06-09 10:58:47 UTC ya make is running...
🟢 2025-06-09 10:58:53 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2025-06-09 10:58:59 UTC Build successful.

Copy link

github-actions bot commented Jun 9, 2025

2025-06-09 10:56:16 UTC Pre-commit check linux-x86_64-relwithdebinfo for 752eb50 has started.
2025-06-09 10:56:27 UTC Artifacts will be uploaded here
2025-06-09 10:58:49 UTC ya make is running...
🟢 2025-06-09 10:58:55 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2025-06-09 10:59:01 UTC Build successful.

Copy link

github-actions bot commented Jun 9, 2025

✅ Documentation build

Revision built successfully
Revision preview link

Build logs

Warnings (1)

⚠️ en/yql/reference/syntax/show_create.md: 43: MD038 / no-space-in-code Spaces inside code span elements [Context: "Table "]

@ydbot
Copy link
Collaborator

ydbot commented Jun 9, 2025

🔄 New commits pushed — @anton-bobkov please take a look.

Copy link

github-actions bot commented Jun 9, 2025

2025-06-09 12:26:50 UTC Pre-commit check linux-x86_64-release-asan for 7e7535a has started.
2025-06-09 12:27:02 UTC Artifacts will be uploaded here
2025-06-09 12:29:27 UTC ya make is running...
🟢 2025-06-09 12:29:33 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2025-06-09 12:29:40 UTC Build successful.

Copy link

github-actions bot commented Jun 9, 2025

2025-06-09 12:27:08 UTC Pre-commit check linux-x86_64-relwithdebinfo for 7e7535a has started.
2025-06-09 12:27:24 UTC Artifacts will be uploaded here
2025-06-09 12:29:49 UTC ya make is running...
🟢 2025-06-09 12:29:55 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2025-06-09 12:30:01 UTC Build successful.

@shnikd shnikd requested a review from blinkov June 9, 2025 12:28
Copy link

github-actions bot commented Jun 9, 2025

✅ Documentation build

Revision built successfully
Revision preview link

@ydbot
Copy link
Collaborator

ydbot commented Jun 9, 2025

🔄 New commits pushed — @anton-bobkov please take a look.

Copy link

github-actions bot commented Jun 9, 2025

2025-06-09 13:06:40 UTC Pre-commit check linux-x86_64-release-asan for 2eafdf8 has started.
2025-06-09 13:06:53 UTC Artifacts will be uploaded here
2025-06-09 13:09:26 UTC ya make is running...
🟢 2025-06-09 13:09:33 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2025-06-09 13:09:39 UTC Build successful.

Copy link

github-actions bot commented Jun 9, 2025

2025-06-09 13:06:44 UTC Pre-commit check linux-x86_64-relwithdebinfo for 2eafdf8 has started.
2025-06-09 13:06:56 UTC Artifacts will be uploaded here
2025-06-09 13:09:19 UTC ya make is running...
🟢 2025-06-09 13:09:25 UTC Tests successful.

Test history | Ya make output | Test bloat

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

🟢 2025-06-09 13:09:31 UTC Build successful.

Copy link

github-actions bot commented Jun 9, 2025

✅ Documentation build

Revision built successfully
Revision preview link

@ydbot
Copy link
Collaborator

ydbot commented Jun 10, 2025

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

@ydbot
Copy link
Collaborator

ydbot commented Jun 12, 2025

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

@ydbot
Copy link
Collaborator

ydbot commented Jun 13, 2025

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

@ydbot
Copy link
Collaborator

ydbot commented Jun 16, 2025

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

@blinkov blinkov merged commit ef7627e into ydb-platform:main Jun 17, 2025
14 checks passed
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.

7 participants