This is an automated email from the ASF dual-hosted git repository.
morningman pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push:
new 24904db29ced docs(i18n): machine Russian translation candidates (#4536)
24904db29ced is described below
commit 24904db29cedcbbb2d5f2f2546120055c9fed379
Author: Mingyu Chen (Rayner) <[email protected]>
AuthorDate: Thu Oct 29 02:00:30 2026 +0000
docs(i18n): machine Russian translation candidates (#4536)
## Russian translation candidate
Source commit: `69ecc79288512c3e2e665081e52bc44548383cd5`
Model: `gpt-6-sol`; glossary: `1`
Review status: machine. Russian proofreading and the normal PR checks
are still required.
| Action | Version | English source | SHA-256 prefix | Generation |
| --- | --- | --- | --- | --- |
| update | current |
[`docs/lakehouse/catalogs/iceberg-catalog.mdx`](https://github.com/apache/doris-website/blob/69ecc79288512c3e2e665081e52bc44548383cd5/docs/lakehouse/catalogs/iceberg-catalog.mdx)
| `35a6c84279e1` | incremental (2.1%) |
## Failed or skipped tasks
None.
## Candidates retained with warnings
None.
## Validation
Updates at or below 30% translate only changed Markdown/MDX blocks and
preserve other target blocks.
Change size is the sum of max(removed, added) non-empty English lines
per diff hunk, divided by the larger old/new line count.
New documents, larger updates, glossary changes or baselines that cannot
be aligned use full translation.
Generation uses at most three attempts per document. Deletions and
code-only updates may need no model call.
Each retry receives the earlier validation errors. Third-attempt content
issues are retained as warnings above.
Full attempt history and diagnostics are in generation.json and the page
state records.
Committed source hashes, managed paths and target/state hashes are
checked before applying candidates.
Master is checked before each model call and before publishing:
unrelated merges are allowed, a page changed on master is dropped, and a
translation configuration or tooling change discards the batch.
The publisher runs the shared PR translation-state, syntax and
internal-link checks before pushing.
The normal PR build and human proofreading are still required before
merging.
<!-- russian-translation-automation:v1
bot-head=6dfb32cb6e5906e73aca281131af7f2b362ff7d1 -->
Shared PR admission checks: passed (translation state, syntax, internal
links).
Co-authored-by: morningman <[email protected]>
---
.../current/lakehouse/catalogs/iceberg-catalog.mdx | 84 ++++++++++++++++++++++
.../lakehouse/catalogs/iceberg-catalog.json | 41 +++++------
2 files changed, 103 insertions(+), 22 deletions(-)
diff --git
a/i18n/ru/docusaurus-plugin-content-docs/current/lakehouse/catalogs/iceberg-catalog.mdx
b/i18n/ru/docusaurus-plugin-content-docs/current/lakehouse/catalogs/iceberg-catalog.mdx
index 93f6cc311a69..0bb4b76abdc0 100644
---
a/i18n/ru/docusaurus-plugin-content-docs/current/lakehouse/catalogs/iceberg-catalog.mdx
+++
b/i18n/ru/docusaurus-plugin-content-docs/current/lakehouse/catalogs/iceberg-catalog.mdx
@@ -222,6 +222,8 @@ ORDER BY engine_name, entry_name;
| Iceberg Rest Catalog | ✅ | ✅ | Зависит от поставщика
службы | Зависит от поставщика службы | Зависит от поставщика службы |
| FileSystem | ✅ | ✅ | ✅
| ✅ | ✅ |
+Системная таблица `labels` поддерживается начиная с версии 5.0.0 и доступна
только для Iceberg REST Catalog. См. раздел [labels](#labels) ниже.
+
## Поддерживаемые системы хранения {#supported-storage-systems}
* [HDFS](../storages/hdfs.md)
@@ -1725,6 +1727,8 @@ SELECT * FROM iceberg_table$history;
> Системная таблица `all_manifests` поддерживается начиная с версии 4.0.4.
>
> Системная таблица `position_deletes` поддерживается начиная с версии 4.1.4.
+>
+> Системная таблица `labels` поддерживается начиная с версии 5.0.0 и доступна
только для Iceberg REST Catalog.
:::caution Изменение поведения (4.1.4)
@@ -1819,6 +1823,86 @@ SELECT * FROM iceberg_table$history;
+----------------------------+---------------------+---------------------+---------------------+
```
+### labels
+
+> Эта возможность поддерживается начиная с версии 5.0.0
+
+Показывает метки уровня таблицы (`object`) и уровня поля (`field`), которые
REST Catalog предоставляет для таблицы Iceberg. Каждой паре ключ-значение метки
соответствует отдельная строка. С помощью этой таблицы можно просматривать,
например, сведения о владельце таблицы и категории данных в полях.
+
+Эта системная таблица доступна, только если для `iceberg.catalog.type` задано
значение `rest`. Дополнительная настройка Doris не требуется. Сервис REST
Catalog возвращает метки при загрузке таблицы; создавать и изменять их нужно
через поставщика сервиса. Эти метки описывают таблицы или поля и отличаются от
тегов снимков, показанных в разделе [refs](#refs).
+
+**Поля:**
+
+| Поле | Тип | Описание |
+| --- | --- | --- |
+| `scope` | `TEXT` | Область действия метки: `object` для метки уровня таблицы
или `field` для метки уровня поля. |
+| `field_id` | `INT` | Идентификатор поля Iceberg. Для меток уровня таблицы —
`NULL`. |
+| `field_name` | `TEXT` | Имя поля, определяемое по текущей схеме таблицы. Для
вложенных полей используется полный путь, например `address.city`. Для меток
уровня таблицы или если идентификатор поля отсутствует в текущей схеме —
`NULL`. |
+| `key` | `TEXT` | Ключ метки. Поскольку `key` — зарезервированное слово в
Doris, при явном обращении к этому столбцу в SQL заключайте его имя в обратные
кавычки. |
+| `value` | `TEXT` | Значение метки. |
+
+**Примеры запросов:**
+
+В следующих примерах предполагается, что Catalog `iceberg_ctl` настроен, как
описано в разделе [Iceberg REST Catalog](#iceberg-rest-catalog), таблица
`iceberg_db.iceberg_tbl` существует, а у текущего пользователя есть разрешение
на выполнение запросов к ней. Сервис REST Catalog настроен на возврат следующих
меток:
+
+- Метка уровня таблицы: `owner=team-a`.
+- Метка поля `email` (идентификатор поля `2`): `classification=pii`.
+- Метка вложенного поля `address.city` (идентификатор поля `5`):
`classification=location`.
+
+Получить все метки, отсортированные по области действия, идентификатору поля и
ключу метки:
+
+```sql
+SELECT * FROM iceberg_ctl.iceberg_db.iceberg_tbl$labels
+ORDER BY scope, field_id, `key`;
+```
+
+Результат:
+
+```text
++--------+----------+--------------+----------------+----------+
+| scope | field_id | field_name | key | value |
++--------+----------+--------------+----------------+----------+
+| field | 2 | email | classification | pii |
+| field | 5 | address.city | classification | location |
+| object | NULL | NULL | owner | team-a |
++--------+----------+--------------+----------------+----------+
+```
+
+Найти поля с категорией `pii`:
+
+```sql
+SELECT field_name, `key`, value
+FROM iceberg_ctl.iceberg_db.iceberg_tbl$labels
+WHERE scope = 'field' AND `key` = 'classification' AND value = 'pii';
+```
+
+Результат:
+
+```text
++------------+----------------+-------+
+| field_name | key | value |
++------------+----------------+-------+
+| email | classification | pii |
++------------+----------------+-------+
+```
+
+**Кэширование и обновление:**
+
+Метки кэшируются вместе с метаданными таблицы в соответствии с настройкой
`meta.cache.iceberg.table.ttl-second`. После изменения меток в сервисе обновите
основную таблицу перед запросом к `$labels`, чтобы получить актуальные метки:
+
+```sql
+REFRESH TABLE iceberg_ctl.iceberg_db.iceberg_tbl;
+```
+
+После обновления таблицы следующий запрос к `$labels` загрузит таблицу заново
и получит метки, возвращённые сервисом. Чтобы отключить кэш метаданных таблицы
и загружать метки заново при каждом запросе, установите для
`meta.cache.iceberg.table.ttl-second` значение `0`. Настройки кэша описаны в
разделе [Кэш метаданных](#meta-cache).
+
+**Примечания:**
+
+- Если сервис REST Catalog не возвращает метки, результат запроса будет
пустым. Таблица без снимков всё же может возвращать метки, если сервис их
предоставляет. `COUNT(*)` подсчитывает пары ключ-значение меток, а не строки
данных основной таблицы.
+- Метки не версионируются вместе со снимками. Использование `FOR VERSION AS
OF` для `$labels` не позволяет получить исторические метки: запрос по-прежнему
возвращает метки, полученные при текущей загрузке таблицы, а имена полей
определяются по текущей схеме.
+- Метки полей связаны с идентификаторами полей. После переименования поля
`field_name` показывает его новое имя. Если поле удалено, но сервис по-прежнему
возвращает его метки, `field_id` сохраняется, а `field_name` принимает значение
`NULL`.
+- Каталоги, не использующие REST, не поддерживают `$labels`: запрос к этой
системной таблице возвращает ошибку `Unknown sys table`. REST Catalog, которым
требуется планирование сканирования на стороне сервера, также не поддерживают
эту системную таблицу.
+
### manifests {#manifests}
Показывает сведения о файлах манифестов таблицы:
diff --git
a/translations/state/ru/pages/default/current/lakehouse/catalogs/iceberg-catalog.json
b/translations/state/ru/pages/default/current/lakehouse/catalogs/iceberg-catalog.json
index 3b78493ca98c..4bdab20ffb71 100644
---
a/translations/state/ru/pages/default/current/lakehouse/catalogs/iceberg-catalog.json
+++
b/translations/state/ru/pages/default/current/lakehouse/catalogs/iceberg-catalog.json
@@ -8,45 +8,42 @@
"sourceLocale": "en",
"sourcePath": "docs/lakehouse/catalogs/iceberg-catalog.mdx",
"targetPath":
"i18n/ru/docusaurus-plugin-content-docs/current/lakehouse/catalogs/iceberg-catalog.mdx",
- "sourceCommit": "8f714fef54cbb3e1887308cedcfca6982493c347",
- "sourceHash":
"5f9e59a11f12864bda19ad944ec51c7d8426b4f44f914da483a5b02f322381c9",
- "sourceTechnicalHash":
"e9f8c84f129dd0fdca3d1ed9970af0fb66804333320cfd395d29e62ea0cb1a80",
- "targetHash":
"4d0a2d456071b30ee5e2d4761cccf44ef8eeee6bec0e8d96be6996a117d57556",
+ "sourceCommit": "69ecc79288512c3e2e665081e52bc44548383cd5",
+ "sourceHash":
"35a6c84279e184d0256d95f0eb0dab459450461e9a5b59f592f704f9b46faa9d",
+ "sourceTechnicalHash":
"f704deb3aabd4e7ad43ca6247650398b5dbce199408e5a34346a3af87a6fcfb7",
+ "targetHash":
"e0c63e4194545933fe09b7f4ad6a223e1d71ad838cb51562e17e2907593dca8a",
"reviewStatus": "machine",
"ownership": "machine",
- "translatedAt": "2026-10-21T18:31:55.387Z",
+ "translatedAt": "2026-10-27T20:27:28.669Z",
"glossaryVersion": "1",
"generation": {
"policy": "whole-document-v1",
- "mode": "full",
- "reason": "local-t09-batch",
- "attempts": 3,
- "modelCalls": 3,
+ "previousSourceHash":
"5f9e59a11f12864bda19ad944ec51c7d8426b4f44f914da483a5b02f322381c9",
+ "previousTargetHash":
"4d0a2d456071b30ee5e2d4761cccf44ef8eeee6bec0e8d96be6996a117d57556",
+ "mode": "incremental",
+ "reason": "source-change-within-30-percent",
+ "sourceChange": {
+ "changedLines": 60,
+ "totalLines": 2801,
+ "ratio": 0.021420921099607283
+ },
+ "attempts": 2,
"acceptedWithWarnings": false,
- "sourceHash":
"5f9e59a11f12864bda19ad944ec51c7d8426b4f44f914da483a5b02f322381c9",
- "targetHash":
"4d0a2d456071b30ee5e2d4761cccf44ef8eeee6bec0e8d96be6996a117d57556",
+ "sourceHash":
"35a6c84279e184d0256d95f0eb0dab459450461e9a5b59f592f704f9b46faa9d",
+ "targetHash":
"e0c63e4194545933fe09b7f4ad6a223e1d71ad838cb51562e17e2907593dca8a",
"warnings": [],
"history": [
{
"attempt": 1,
- "issues": [
- {
- "check": "request",
- "message": "Codex attempted a tool call during text-only
translation\n\n1 !== 0\n"
- }
- ]
- },
- {
- "attempt": 2,
"issues": [
{
"check": "protected-content",
- "message": "Restore protected source content:\nprotected node
414: expected [\"inlineCode\",null,null,\"_row_id\"]; received
[\"inlineCode\",null,null,\"INSERT\"]\nprotected node 415: expected
[\"inlineCode\",null,null,\"_last_updated_sequence_number\"]; received
[\"inlineCode\",null,null,\"_row_id\"]\nprotected node 416: expected
[\"inlineCode\",null,null,\"INSERT\"]; received
[\"inlineCode\",null,null,\"_last_updated_sequence_number\"]"
+ "message": "Restore protected source content:\nprotected node
475: expected [\"inlineCode\",null,null,\"iceberg.catalog.type\"]; received
[\"inlineCode\",null,null,\"rest\"]\nprotected node 476: expected
[\"inlineCode\",null,null,\"rest\"]; received
[\"inlineCode\",null,null,\"iceberg.catalog.type\"]"
}
]
},
{
- "attempt": 3,
+ "attempt": 2,
"issues": []
}
]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
