Последнее обновление 22 дек. 2025 г.

INSERT

Описание

Этот оператор предназначен для вставки данных.

INSERT INTO table_name
    [ PARTITION (p1, ...) ]
    [ WITH LABEL label]
    [ (column [, ...]) ]
    [ [ hint [, ...] ] ]
    { VALUES ( { expression | DEFAULT } [, ...] ) [, ...] | query }

Параметры

tablet_name: Целевая таблица для загрузки данных. Можно указать в формате db_name.table_name

partitions: Указывает разделы для загрузки данных. Эти разделы должны существовать в table_name. Имена нескольких разделов разделяются запятыми

label: Указывает метку для задачи Insert

column_name: Указывает целевой столбец. Этот столбец должен существовать в table_name

expression: Выражение, значение которого нужно присвоить столбцу

DEFAULT: Позволяет использовать значение по умолчанию для соответствующего столбца

query: Обычный запрос, результат которого будет записан в целевую таблицу

hint: Подсказка, определяющая поведение при выполнении INSERT. Можно выбрать одно из следующих значений: /*+ STREAMING */, /*+ SHUFFLE */ или `/*+ NOSHUFFLE */.

STREAMING: В настоящее время не оказывает практического воздействия и сохранена только для совместимости с предыдущими версиями. (В предыдущей версии добавление этой подсказки приводило к возврату метки, а теперь метка возвращается по умолчанию)

SHUFFLE: Если целевая таблица разделена на разделы, включение этой подсказки приведет к перераспределению данных между разделами.

NOSHUFFLE: Даже если целевая таблица разделена на разделы, перераспределение данных между ними не выполняется. Вместо этого выполняются другие операции, обеспечивающие корректное размещение данных в каждом разделе.

Для таблицы Unique с включенным merge-on-write оператор insert также позволяет обновлять отдельные столбцы. Для этого необходимо установить переменную сеанса enable_unique_key_partial_update в true (по умолчанию эта переменная имеет значение false, то есть обновление отдельных столбцов с помощью оператора insert по умолчанию запрещено). При обновлении отдельных столбцов в список вставляемых столбцов необходимо включить как минимум все столбцы Key и указать столбцы, которые требуется обновить. Если значения столбцов Key вставляемой строки уже существуют в исходной таблице, данные строки с такими же значениями ключевых столбцов будут обновлены. Если значения столбцов Key вставляемой строки отсутствуют в исходной таблице, в таблицу будет добавлена новая строка. В этом случае столбцы, не указанные в операторе insert, должны либо иметь значения по умолчанию, либо допускать null. Сначала для этих отсутствующих столбцов предпринимается попытка использовать значения по умолчанию. Если у столбца нет значения по умолчанию, он заполняется значением null. Если столбец не допускает null, операция вставки завершится ошибкой.

Обратите внимание: переменная сеанса enable_insert_strict, определяющая, работает ли оператор insert в строгом режиме, по умолчанию имеет значение true. Другими словами, оператор insert по умолчанию работает в строгом режиме, в котором при обновлении отдельных столбцов запрещено обновлять несуществующие ключи. Поэтому, если при обновлении отдельных столбцов с помощью оператора insert требуется вставлять строки с несуществующими ключами, необходимо установить enable_unique_key_partial_update в true и одновременно установить enable_insert_strict в false.

Примечание:

При выполнении оператора INSERT по умолчанию отфильтровываются данные, не соответствующие формату целевой таблицы, например слишком длинные строки. Однако в бизнес-сценариях, где отфильтровывание данных недопустимо, можно установить переменную сеанса enable_insert_strict в true, чтобы INSERT не завершался успешно, если какие-либо данные были отфильтрованы.

Пример

Таблица test содержит два столбца: c1, c2.

Загрузка одной строки данных в таблицу test

INSERT INTO test VALUES (1, 2);
INSERT INTO test (c1, c2) VALUES (1, 2);
INSERT INTO test (c1, c2) VALUES (1, DEFAULT);
INSERT INTO test (c1) VALUES (1);

Первый и второй операторы дают одинаковый результат. Если целевые столбцы не указаны, по умолчанию используется порядок столбцов в таблице. Третий и четвертый операторы также дают одинаковый результат: для загрузки данных используется значение по умолчанию столбца c2.

Загрузка нескольких строк данных в таблицу test за один раз

INSERT INTO test VALUES (1, 2), (3, 2 + 2);
INSERT INTO test (c1, c2) VALUES (1, 2), (3, 2 * 2);
INSERT INTO test (c1) VALUES (1), (3);
INSERT INTO test (c1, c2) VALUES (1, DEFAULT), (3, DEFAULT);

Первый и второй операторы дают одинаковый результат: загружают две строки данных в таблицу test за один раз. Третий и четвертый операторы также дают одинаковый результат: значение по умолчанию столбца c2 используется для загрузки двух строк данных в таблицу test.

Загрузка результата запроса в таблицу test

INSERT INTO test SELECT * FROM test2;
INSERT INTO test (c1, c2) SELECT * from test2;

Загрузка результата запроса в таблицу test с указанием раздела и метки

INSERT INTO test PARTITION(p1, p2) WITH LABEL `label1` SELECT * FROM test2;
INSERT INTO test WITH LABEL `label1` (c1, c2) SELECT * from test2;

Ключевые слова

INSERT

Описание​

Пример​

Ключевые слова​

Рекомендации​

Описание

Пример

Ключевые слова

Рекомендации