Пусть вас не вводит в заблуждение минорный номер версии: pg_clickhouse v0.11.1, выпущенный на прошлой неделе, содержит множество улучшений и исправлений ошибок, включая pushdown для UPDATE, DELETE, TRUNCATE и поиска pgvector.
Начнем с последнего: сопоставление типов . Учитывая следующую таблицу ClickHouse:
позволяет нам сопоставить столбец v с типом vector:
Мы используем явную команду CREATE FOREIGN TABLE вместо IMPORT FOREIGN SCHEMA, чтобы сопоставить столбец ClickHouse Array(Float32) со столбцом вектора в PostgreSQL. Это также работает для столбцов ClickHouse Array(Float64). Теперь мы можем вставлять значения векторных массивов:
И, конечно, выбирать их:
также выполняет pushdown для ряда операторов и функций , включая, самое простое, =, что видно в строке "Remote SQL" из EXPLAIN (VERBOSE):
Результаты вполне ожидаемы:
Более того, pg_clickhouse выполняет pushdown для операторов расстояния pgvector. Например, <-> передается в функцию ClickHouse L2Distance, что снова видно в строке "Remote SQL" из EXPLAIN (VERBOSE):
И результаты:
Полный список операторов и функций , которые передаются (pushdown) в функции ClickHouse:
Внимательные читатели могли заметить строки "Vector" в выводе плана:
Строка Vector Index Not Used ясно говорит нам, что запрос не использовал индекс векторного сходства. Но мог ли он его использовать? Давайте добавим индекс и посмотрим:
Снова используем оператор расстояния L2:
И вуаля! Теперь он обнаруживает, что таблица ClickHouse имеет индекс L2Distance(), который исполнитель ClickHouse мог использовать для запроса. Результаты остаются неизменными:
pg_clickhouse обнаруживает и сообщает об использовании индексов vector_similarity в ClickHouse, используя функции сходства, соответствующие поддерживаемым операторам (cosineDistance, L1Distance и т. д.).
также вводит поддержку операторов UPDATE, DELETE и TRUNCATE для таблиц семейства MergeTree. Он передает операторы UPDATE и DELETE как облегченные (lightweight) операторы UPDATE или DELETE соответственно, а операторы TRUNCATE — как TRUNCATE, разумеется.
Давайте применим их к таблице items. Во-первых, для UPDATE требуется включить пару настроек ClickHouse:
А теперь мы можем выполнять обновления:
Проверим результат:
Теперь DELETE:
Удалено? Да:
Имейте в виду, что PostgreSQL UPDATE и DELETE, в отличие от ClickHouse, не требуют предложений WHERE. При отсутствии предложения WHERE pg_clickhouse вставляет WHERE true, чтобы соответствовать поведению PostgreSQL. Но вы наверняка не хотите обновлять или удалять каждую строку в таблице ClickHouse! Как сказано в документации:
Облегченные обновления предназначены для обновления небольшого количества строк (до 10% таблицы).
Облегченные обновления предназначены для обновления небольшого количества строк (до 10% таблицы).
Вместо удаления каждой строки используйте TRUNCATE:
Все удалено:
также добавляет pushdown для семейства агрегатных функций линейной регрессии regr_* в ClickHouse 26.9 или более поздних версиях, когда ClickHouse их добавил. К ним относятся:
- regr_avgx
- regr_avgy
- regr_count
- regr_intercept
- regr_r2
- regr_slope
- regr_sxx
- regr_sxy
- regr_syy
Пример:
Появление regr_avgyOrNull() в предыдущем примере вывода раскрывает новость, но, чтобы внести ясность, этот выпуск также учит агрегаты, возвращающие NULL, действительно возвращать NULL, а не значение по умолчанию ClickHouse (например, 0), когда они не агрегируют никаких значений. Вместо sum, avg, min и т. д. pg_clickhouse теперь выполняет pushdown для sumOrNull, avgOrNull и minOrNull, тем самым соответствуя поведению Postgres:
Синтаксис подписки JSONB, data['a']['b'], теперь передается в "точечную нотацию" столбца ClickHouse:
В ClickHouse 23.6+ pg_clickhouse теперь всегда устанавливает session_timezone в соответствии с PostgreSQL TimeZone и передает PostgreSQL TimeZone в функции DateTime, обеспечивая тем самым совместимость значений timestamp и timestamptz:
Для простых числовых столбцов pg_clickhouse теперь использует Decimal(76, 38), максимально возможный размер десятичного числа в ClickHouse, и выдает ошибку для более длинных значений. Он также правильно обрезает конечные нули из таких значений, благодаря вкладу сообщества:
При выполнении этого запроса вывод ранее был:
Но теперь он такой:
Эти изменения охватывают основные моменты; ознакомьтесь с , чтобы узнать обо всем остальном. И, конечно, pg_clickhouse v0.11.1 доступен на всех новых и существующих серверах ClickHouse Managed Postgres уже сегодня. Поскольку это минорный релиз, все установки получают выгоду от улучшений без каких-либо действий. Но выполните ALTER EXTENSION pg_clickhouse UPDATE;, чтобы обновиться с версии v0.10 или более ранней.












