aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authoralexv-smirnov <alexv-smirnov@yandex-team.ru>2022-06-14 16:50:13 +0300
committeralexv-smirnov <alexv-smirnov@yandex-team.ru>2022-06-14 16:50:13 +0300
commit1f45819a9d6ddcc028552d64fda12ed1a9039f16 (patch)
treee19214e92117c6672dff53d431260f975f0476dc
parent092b0847d7c63e69291379cb66117a5a984363ba (diff)
downloadydb-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.md4
-rw-r--r--ydb/docs/ru/core/reference/ydb-cli/export_import/_includes/import-file.md4
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 %}. Обработка переноса строки внутри поля данных не поддерживается.