Перейти к основному содержимому
Перейти к основному содержимому

Оператор INSERT INTO

Вставляет данные в таблицу.

Синтаксис

Вы можете указать список колонок для вставки, используя (c1, c2, c3). Также вы можете использовать выражение с колонным matcher таким как * и/или модификаторы такие как APPLY, EXCEPT, REPLACE.

Например, рассмотрим таблицу:

Если вы хотите вставить данные во все колонки, кроме колонки b, вы можете сделать это с помощью ключевого слова EXCEPT. Ссылаясь на синтаксис выше, вам нужно будет убедиться, что вы вставляете столько же значений (VALUES (v11, v13)), сколько вы указываете колонок ((c1, c3)):

В этом примере мы видим, что вторая вставленная строка имеет заполненные колонки a и c переданными значениями, и b заполнена значением по умолчанию. Также возможно использовать ключевое слово DEFAULT для вставки значений по умолчанию:

Если список колонок не включает все существующие колонки, оставшиеся колонки заполняются:

  • Значениями, вычисленными из выражений DEFAULT, указанных в определении таблицы.
  • Нулями и пустыми строками, если выражения DEFAULT не определены.

Данные можно передавать в INSERT в любом формате, поддерживаемом ClickHouse. Формат должен быть явно указан в запросе:

Например, следующий запрос имеет тот же формат, что и базовая версия INSERT ... VALUES:

ClickHouse удаляет все пробелы и один перевод строки (если он есть) перед данными. При формировании запроса мы рекомендуем помещать данные на новую строку после операторов запроса, что важно, если данные начинаются с пробелов.

Пример:

Вы можете вставить данные отдельно от запроса, используя командный клиент или HTTP интерфейс.

примечание

Если вы хотите указать SETTINGS для запроса INSERT, то вам нужно сделать это перед клаузой FORMAT, так как всё после FORMAT format_name рассматривается как данные. Например:

Ограничения​

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

Вставка результатов SELECT​

Синтаксис

Колонки сопоставляются в соответствии с их позициями в клаузе SELECT. Однако их имена в выражении SELECT и таблице для INSERT могут отличаться. При необходимости выполняется приведение типов.

Ни один из форматов данных, кроме формата Values, не позволяет устанавливать значения для выражений, таких как now(), 1 + 2 и т. д. Формат Values разрешает ограниченное использование выражений, но это не рекомендуется, поскольку в этом случае используется неэффективный код для их выполнения.

Другие запросы для модификации частей данных не поддерживаются: UPDATE, DELETE, REPLACE, MERGE, UPSERT, INSERT UPDATE. Однако вы можете удалить старые данные, используя ALTER TABLE ... DROP PARTITION.

Клауза FORMAT должна быть указана в конце запроса, если клаузу SELECT содержит табличная функция input().

Чтобы вставить значение по умолчанию вместо NULL в колонку с типом данных, не допускающим NULL, включите настройку insert_null_as_default.

INSERT также поддерживает CTE (общие табличные выражения). Например, следующие два оператора эквивалентны:

Вставка данных из файла​

Синтаксис

Используйте приведенный выше синтаксис для вставки данных из файла или файлов, хранящихся на стороне клиента. file_name и type являются строковыми литералами. Формат входного файла формат должен быть установлен в клаузе FORMAT.

Поддерживаются сжатые файлы. Тип сжатия определяется по расширению имени файла. Либо он может быть явно указан в клаузе COMPRESSION. Поддерживаемые типы: 'none', 'gzip', 'deflate', 'br', 'xz', 'zstd', 'lz4', 'bz2'.

Эта функциональность доступна в командном клиенте и clickhouse-local.

Примеры

Один файл с FROM INFILE​

Выполните следующие запросы, используя командный клиент:

Результат:

Несколько файлов с FROM INFILE с использованием шаблонов​

Этот пример очень похож на предыдущий, но вставка выполняется из нескольких файлов с использованием FROM INFILE 'input_*.csv.

подсказка

В дополнение к выбору нескольких файлов с помощью *, вы можете использовать диапазоны ({1,2} или {1..9}) и другие замены шаблонов. Все три из них будут работать с приведенным выше примером:

Вставка с использованием табличной функции​

Данные могут быть вставлены в таблицы, ссылаясь на табличные функции.

Синтаксис

Пример

Табличная функция remote используется в следующих запросах:

Результат:

Вставка в ClickHouse Cloud​

По умолчанию службы в ClickHouse Cloud предоставляют несколько реплик для высокой доступности. Когда вы подключаетесь к службе, устанавливается соединение с одной из этих реплик.

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

Возможно использование select_sequential_consistency для принуждения реплики получать последние обновления. Вот пример запроса SELECT с использованием этой настройки:

Обратите внимание, что использование select_sequential_consistency увеличит нагрузку на ClickHouse Keeper (используется внутренне ClickHouse Cloud) и может привести к снижению производительности в зависимости от нагрузки на службу. Мы не рекомендуем включать эту настройку, если это не необходимо. Рекомендуемый подход — выполнять чтение/запись в одной сессии или использовать клиентский драйвер, который использует внешний протокол (и, следовательно, поддерживает постоянные соединения).

Вставка в реплицированную настройку​

В реплицированной настройке данные будут видны на других репликах после их репликации. Данные начинают реплицироваться (загружаться на другие реплики) немедленно после INSERT. Это отличается от ClickHouse Cloud, где данные немедленно записываются в общее хранилище, а реплики подписываются на изменения метаданных.

Обратите внимание, что для реплицированных настроек INSERT может занять значительное количество времени (порядка одной секунды), так как требуется подтверждение в ClickHouse Keeper для распределенного консенсуса. Использование S3 для хранения также добавляет дополнительную задержку.

Соображения по производительности​

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

  • Добавляйте данные достаточно большими пакетами, например, по 100 000 строк за раз.
  • Группируйте данные по ключу партиционирования перед загрузкой в ClickHouse.

Производительность не снизится, если:

  • Данные добавляются в реальном времени.
  • Вы загружаете данные, которые обычно отсортированы по времени.

Асинхронные вставки​

Возможно асинхронно вставлять данные небольшими, но частыми вставками. Данные от таких вставок объединяются в пакеты и затем безопасно вставляются в таблицу. Для использования асинхронных вставок включите настройку async_insert.

Использование async_insert или движка таблиц Buffer приводит к дополнительному буферизации.

Большие или длительные вставки​

Когда вы вставляете большие объемы данных, ClickHouse оптимизирует производительность записи через процесс под названием "сжатие". Малые блоки вставленных данных в памяти объединяются и сжимаются в более крупные блоки перед записью на диск. Сжатие снижает накладные расходы, связанные с каждой операцией записи. В этом процессе вставленные данные будут доступны для запроса после того, как ClickHouse завершит запись каждых max_insert_block_size строк.

Смотрите также