diff options
author | alexv-smirnov <alexv-smirnov@yandex-team.ru> | 2022-06-14 16:50:13 +0300 |
---|---|---|
committer | alexv-smirnov <alexv-smirnov@yandex-team.ru> | 2022-06-14 16:50:13 +0300 |
commit | 1f45819a9d6ddcc028552d64fda12ed1a9039f16 (patch) | |
tree | e19214e92117c6672dff53d431260f975f0476dc | |
parent | 092b0847d7c63e69291379cb66117a5a984363ba (diff) | |
download | ydb-1f45819a9d6ddcc028552d64fda12ed1a9039f16.tar.gz |
ydb docs cli import-file non-atomicity instead of non-transactionality
ref:e064444ff4d1c20848443d785dc37e8c6a3bf877
-rw-r--r-- | ydb/docs/en/core/reference/ydb-cli/export_import/_includes/import-file.md | 4 | ||||
-rw-r--r-- | ydb/docs/ru/core/reference/ydb-cli/export_import/_includes/import-file.md | 4 |
2 files changed, 6 insertions, 2 deletions
diff --git a/ydb/docs/en/core/reference/ydb-cli/export_import/_includes/import-file.md b/ydb/docs/en/core/reference/ydb-cli/export_import/_includes/import-file.md index ce975b3272..d13e0f47c4 100644 --- a/ydb/docs/en/core/reference/ydb-cli/export_import/_includes/import-file.md +++ b/ydb/docs/en/core/reference/ydb-cli/export_import/_includes/import-file.md @@ -2,7 +2,9 @@ Using the `import file` subcommand, you can import data from [CSV]{% if lang == "ru" %}(https://ru.wikipedia.org/wiki/CSV){% endif %}{% if lang == "en" %}(https://en.wikipedia.org/wiki/Comma-separated_values){% endif %} or [TSV]{% if lang == "ru" %}(https://ru.wikipedia.org/wiki/TSV){% endif %}{% if lang == "en" %}(https://en.wikipedia.org/wiki/Tab-separated_values){% endif %} files to an existing table. -Data is imported by the `BulkUpsert` method that doesn't guarantee transactionality. In case the table already contains data, it will be replaced with imported data if the primary key matches. +Data is imported using the `BulkUpsert` method that provides high-efficient batch data inserts without atomicity guarantees. Data writes are split in multiple independent single-shard transactions executed in parallel. When succesfully completed, all data is guaranteed to be inserted. + +In case the table already contains data, it will be replaced with imported data if the primary key matches. The imported file must be encoded in [UTF-8]{% if lang == "ru" %}(https://ru.wikipedia.org/wiki/UTF-8){% endif %}{% if lang == "en" %}(https://en.wikipedia.org/wiki/UTF-8){% endif %}. Processing a line break inside a data field is not supported. diff --git a/ydb/docs/ru/core/reference/ydb-cli/export_import/_includes/import-file.md b/ydb/docs/ru/core/reference/ydb-cli/export_import/_includes/import-file.md index e95e5d66e8..1235449d3a 100644 --- a/ydb/docs/ru/core/reference/ydb-cli/export_import/_includes/import-file.md +++ b/ydb/docs/ru/core/reference/ydb-cli/export_import/_includes/import-file.md @@ -2,7 +2,9 @@ С помощью подкоманды `import file` вы можете импортировать данные из [CSV]{% if lang == "ru" %}(https://ru.wikipedia.org/wiki/CSV){% endif %}{% if lang == "en" %}(https://en.wikipedia.org/wiki/Comma-separated_values){% endif %}- или [TSV]{% if lang == "ru" %}(https://ru.wikipedia.org/wiki/TSV){% endif %}{% if lang == "en" %}(https://en.wikipedia.org/wiki/Tab-separated_values){% endif %}-файлов в существующую таблицу. -Импорт выполняется методом `BulkUpsert`, который не гарантирует транзакционность. Если в таблице уже содержатся данные, они будут заменены импортируемыми при совпадении первичного ключа. +Импорт выполняется методом `BulkUpsert`, который обеспечивает высокоэффективную пакетную вставку большого количества строк без гарантий атомарности. Запись данных разбивается на несколько независимых транзакций, каждая их которых затрагивает единственную партицию, с параллельным исполнением. В случае успеха гарантируется вставка всех данных. + +Если в таблице уже содержатся данные, они будут заменены импортируемыми при совпадении первичного ключа. Импортируемый файл должен быть в кодировке [UTF-8]{% if lang == "ru" %}(https://ru.wikipedia.org/wiki/UTF-8){% endif %}{% if lang == "en" %}(https://en.wikipedia.org/wiki/UTF-8){% endif %}. Обработка переноса строки внутри поля данных не поддерживается. |