Консоль SQL — самый быстрый и простой способ просматривать базы данных в ClickHouse Cloud и выполнять к ним запросы. С помощью консоли SQL вы можете:
- Подключаться к сервисам ClickHouse Cloud
- Просматривать, фильтровать и сортировать данные таблиц
- Выполнять запросы и визуализировать результаты всего за несколько кликов
- Делиться запросами с участниками команды и эффективнее работать вместе.
Просмотр списка таблиц и сведений о схеме
Фильтрация и сортировка таблиц
Одновременная фильтрация и сортировка
Создание запроса из фильтров и сортировок
Для использования возможности ‘Create Query’ фильтры и сортировки не обязательны.
Создание и выполнение запроса
- Нажмите кнопку ’+’ на панели вкладок
- Выберите кнопку ‘New Query’ в списке запросов на левой боковой панели
Чтобы выполнить запрос, введите SQL-команду или несколько команд в редакторе SQL и нажмите кнопку ‘Run’ либо используйте сочетание клавиш cmd / ctrl + enter. Чтобы писать и выполнять несколько команд последовательно, обязательно ставьте точку с запятой после каждой команды.
Параметры выполнения запроса
По умолчанию при нажатии кнопки запускаются все команды, содержащиеся в редакторе SQL. Консоль SQL поддерживает еще два варианта выполнения запроса:
- Выполнить выбранные команды
- Выполнить команду в позиции курсора
Чтобы выполнить выбранные команды, выделите нужную команду или последовательность команд и нажмите кнопку ‘Run’ (или используйте сочетание клавиш cmd / ctrl + enter). Если текст выделен, вы также можете выбрать ‘Run selected’ в контекстном меню редактора SQL (оно открывается щелчком правой кнопкой мыши в любом месте редактора).
Выполнить команду в текущей позиции курсора можно двумя способами:
- Выберите ‘At Cursor’ в меню дополнительных параметров запуска (или используйте соответствующее сочетание клавиш
cmd / ctrl + shift + enter
- Выберите ‘Run at cursor’ в контекстном меню редактора SQL
При выполнении команда в позиции курсора кратковременно подсвечивается желтым.
Esc, чтобы отменить запрос. Примечание: все результаты, которые уже были получены, сохранятся после отмены.
Если имя запроса ещё не задано, он будет называться «Untitled Query». Нажмите на название запроса, чтобы изменить его. При переименовании запрос будет сохранён.
Вы также можете сохранить запрос с помощью кнопки сохранения или сочетания клавиш cmd / ctrl + s.
Использование GenAI для работы с запросами
-
Откройте сервис ClickHouse Cloud.
-
Создайте новый запрос, нажав значок +.
-
Вставьте и выполните следующий код:
CREATE TABLE uk_price_paid
(
price UInt32,
date Date,
postcode1 LowCardinality(String),
postcode2 LowCardinality(String),
type Enum8('terraced' = 1, 'semi-detached' = 2, 'detached' = 3, 'flat' = 4, 'other' = 0),
is_new UInt8,
duration Enum8('freehold' = 1, 'leasehold' = 2, 'unknown' = 0),
addr1 String,
addr2 String,
street LowCardinality(String),
locality LowCardinality(String),
town LowCardinality(String),
district LowCardinality(String),
county LowCardinality(String)
)
ENGINE = MergeTree
ORDER BY (postcode1, postcode2, addr1, addr2);
uk_price_paid.
-
Создайте новый запрос и вставьте в него следующий запрос:
INSERT INTO uk_price_paid
WITH
splitByChar(' ', postcode) AS p
SELECT
toUInt32(price_string) AS price,
parseDateTimeBestEffortUS(time) AS date,
p[1] AS postcode1,
p[2] AS postcode2,
transform(a, ['T', 'S', 'D', 'F', 'O'], ['terraced', 'semi-detached', 'detached', 'flat', 'other']) AS type,
b = 'Y' AS is_new,
transform(c, ['F', 'L', 'U'], ['freehold', 'leasehold', 'unknown']) AS duration,
addr1,
addr2,
street,
locality,
town,
district,
county
FROM url(
'http://prod.publicdata.landregistry.gov.uk.s3-website-eu-west-1.amazonaws.com/pp-complete.csv',
'CSV',
'uuid_string String,
price_string String,
time String,
postcode String,
a String,
b String,
c String,
addr1 String,
addr2 String,
street String,
locality String,
town String,
district String,
county String,
d String,
e String'
) SETTINGS max_http_get_redirects=10;
Этот запрос получает набор данных с сайта gov.uk. Размер файла — около 4 ГБ, поэтому выполнение запроса займет несколько минут. После того как ClickHouse обработает запрос, весь набор данных будет загружен в таблицу uk_price_paid.
Давайте создадим запрос с помощью естественного языка.
-
Выберите table uk_price_paid, затем нажмите Create Query.
-
Нажмите Generate SQL. Вас могут попросить подтвердить, что ваши запросы отправляются в Chat-GPT. Чтобы продолжить, необходимо выбрать I agree.
-
Теперь вы можете использовать этот промпт, чтобы ввести запрос на естественном языке, а ChatGPT преобразует его в SQL-запрос. В этом примере мы введём:
Покажи общую стоимость и общее количество всех транзакций в uk_price_paid по годам.
-
Консоль сгенерирует нужный запрос и отобразит его на новой вкладке. В нашем примере GenAI создал следующий запрос:
-- Покажи общую стоимость и общее количество всех транзакций в uk_price_paid по годам.
SELECT year(date), sum(price) as total_price, Count(*) as total_transactions
FROM uk_price_paid
GROUP BY year(date)
-
Убедившись, что запрос корректен, нажмите Run, чтобы выполнить его.
Теперь давайте проверим возможности GenAI по отладке запросов.
-
Создайте новый запрос, нажав на значок +, и вставьте следующий код:
-- Покажи мне общую цену и общее количество всех транзакций uk_price_paid по годам.
SELECT year(date), sum(pricee) as total_price, Count(*) as total_transactions
FROM uk_price_paid
GROUP BY year(date)
-
Нажмите Run. Запрос завершится ошибкой, поскольку мы пытаемся получить значения из
pricee, а не из price.
-
Нажмите Fix Query.
-
GenAI попытается исправить запрос. В этом случае он заменил
pricee на price. Он также определил, что в этом случае лучше использовать функцию toYear.
-
Выберите Apply, чтобы добавить предложенные изменения в запрос, и нажмите Run.
Имейте в виду, что GenAI — экспериментальная возможность. Соблюдайте осторожность при выполнении запросов, сгенерированных GenAI, для любого набора данных.
Расширенные возможности запросов
Поиск по результатам запроса
WHERE или просто проверить, что нужные данные входят в результирующий набор. После ввода значения в поле поиска панель результатов обновится и покажет записи, содержащие запись, соответствующую введённому значению. В этом примере мы найдём все вхождения breakfast в таблице hackernews среди комментариев, содержащих ClickHouse (регистронезависимо):
Примечание: будет возвращена любая запись, в любом поле которой есть совпадение с введённым значением. Например, третья запись на снимке экрана выше не содержит ‘breakfast’ в поле by, но содержит его в поле text:
По умолчанию панель результатов запроса отображает все записи на одной странице. Для более крупных результирующих наборов удобнее разбивать результаты на страницы. Это можно сделать с помощью селектора пагинации в правом нижнем углу панели результатов:
При выборе размера страницы пагинация сразу применяется к результирующему набору, а элементы навигации появляются в центре нижнего колонтитула панели результатов
Экспорт данных результата запроса
••• в правой части панели инструментов панели результатов и выберите «Скачать как CSV».
Визуализация данных запроса
SELECT
toStartOfWeek(pickup_datetime) AS week,
sum(total_amount) AS fare_total,
sum(trip_distance) AS distance_total,
count(*) AS trip_total
FROM
nyc_taxi
GROUP BY
1
ORDER BY
1 ASC
trip_total по week. Для этого перетащим поле week на ось x, а поле trip_total — на ось y:
Большинство типов диаграмм поддерживают несколько полей на числовых осях. Для примера перетащим поле fare_total на ось y:
Консоль SQL поддерживает десять типов диаграмм, которые можно выбрать в селекторе типа диаграммы на панели конфигурации диаграммы. Например, мы можем легко изменить предыдущий тип диаграммы с Bar на Area:
Заголовки диаграмм соответствуют имени запроса, который предоставляет данные. Если изменить имя запроса, заголовок диаграммы также обновится:
Ряд более продвинутых параметров диаграммы также можно настроить в разделе ‘Advanced’ на панели конфигурации диаграммы. Для начала изменим следующие настройки:
- Подзаголовок
- Заголовки осей
- Ориентация меток на оси x
Наша диаграмма будет обновлена соответствующим образом:
В некоторых случаях может потребоваться настроить шкалы осей для каждого поля отдельно. Это также можно сделать в разделе ‘Advanced’ на панели конфигурации диаграммы, указав минимальное и максимальное значения для диапазона оси. Например, приведенная выше диаграмма выглядит хорошо, но, чтобы продемонстрировать корреляцию между нашими полями trip_total и fare_total, диапазоны осей нужно немного скорректировать:
Консоль SQL позволяет делиться запросами с вашей командой. Когда запрос открыт для общего доступа, все участники команды могут просматривать и редактировать его. Запросы с общим доступом — удобный способ совместной работы с командой.
Чтобы поделиться запросом, нажмите кнопку ‘Share’ на панели инструментов запроса.
Откроется диалоговое окно, в котором можно открыть доступ к запросу для всех участников команды. Если у вас несколько команд, вы можете выбрать, с какой из них поделиться запросом.
В некоторых случаях может потребоваться отдельно настроить масштаб осей для каждого поля. Это также можно сделать в разделе ‘Advanced’ на панели конфигурации диаграммы, указав минимальное и максимальное значения для диапазона оси. Например, приведённая выше диаграмма выглядит хорошо, но, чтобы продемонстрировать корреляцию между полями trip_total и fare_total, диапазоны осей нужно немного скорректировать:
Последнее изменение 10 июня 2026 г.
