SQL Консоль
SQL консоль — это самый быстрый и простой способ исследовать и запрашивать ваши базы данных в ClickHouse Cloud. Вы можете использовать SQL консоль для:
- Подключения к вашим службам ClickHouse Cloud
- Просмотра, фильтрации и сортировки данных таблиц
- Выполнения запросов и визуализации данных результатов всего за несколько кликов
- Обмена запросами с членами команды и более эффективного сотрудничества.
Исследование таблиц
Просмотр списка таблиц и информации о схеме
Обзор таблиц, содержащихся в вашей инстанции ClickHouse, можно найти в области левой боковой панели. Используйте селектор базы данных в верхней части левой панели, чтобы просмотреть таблицы в конкретной базе данных.

Таблицы в списке также можно развернуть, чтобы посмотреть колонки и их типы.

Исследование данных таблицы
Нажмите на таблицу в списке, чтобы открыть её в новой вкладке. В представлении таблицы данные можно легко просматривать, выбирать и копировать. Обратите внимание, что структура и форматирование сохраняются при копировании-вставке в приложения для работы с таблицами, такие как Microsoft Excel и Google Sheets. Вы можете переключаться между страницами данных таблицы (пагинация по 30 строк) с помощью навигации в нижнем колонтитуле.

Проверка данных ячейки
Инструмент проверки ячейки позволяет просматривать большие объемы данных, содержащиеся в одной ячейке. Чтобы открыть его, щелкните правой кнопкой мыши по ячейке и выберите 'Проверить ячейку'. Содержимое инспектора ячеек можно скопировать, нажав на иконку копирования в правом верхнем углу содержимого инспектора.

Фильтрация и сортировка таблиц
Сортировка таблицы
Чтобы отсортировать таблицу в SQL консоли, откройте таблицу и выберите кнопку 'Сортировать' в панели инструментов. Эта кнопка откроет меню, которое позволит вам настроить сортировку. Вы можете выбрать колонку, по которой хотите сортировать, и настроить порядок сортировки (возрастание или убывание). Выберите 'Применить' или нажмите Enter, чтобы отсортировать вашу таблицу.

SQL консоль также позволяет добавлять несколько сортировок к таблице. Нажмите кнопку 'Сортировать' снова, чтобы добавить ещё одну сортировку.
Сортировки применяются в том порядке, в котором они появляются в панели сортировки (сверху вниз). Чтобы удалить сортировку, просто нажмите кнопку 'x' рядом с сортировкой.
Фильтрация таблицы
Чтобы отфильтровать таблицу в SQL консоли, откройте таблицу и выберите кнопку 'Фильтр'. Так же, как и при сортировке, эта кнопка откроет меню, которое позволит вам настроить фильтрацию. Вы можете выбрать колонку, по которой хотите фильтровать, и задать необходимые критерии. SQL консоль интеллектуально отображает варианты фильтров, соответствующие типу данных, содержащихся в колонке.

Когда вас устроит ваш фильтр, вы можете выбрать 'Применить' для фильтрации ваших данных. Вы также можете добавить дополнительные фильтры, как показано ниже.

Аналогично функции сортировки, нажмите кнопку 'x' рядом с фильтром, чтобы удалить его.
Фильтрация и сортировка одновременно
SQL консоль позволяет одновременно фильтровать и сортировать таблицу. Для этого добавьте все желаемые фильтры и сортировки с помощью описанных выше шагов и нажмите кнопку 'Применить'.

Создание запроса из фильтров и сортировок
SQL консоль может преобразовать ваши сортировки и фильтры напрямую в запросы одним нажатием кнопки. Просто выберите кнопку 'Создать запрос' на панели инструментов с параметрами сортировки и фильтров по вашему выбору. После нажатия 'Создать запрос' откроется новая вкладка запроса с предзаполненной SQL командой, соответствующей данным, содержащимся в вашем представлении таблицы.

Фильтры и сортировки не обязательны при использовании функции 'Создать запрос'.
Вы можете узнать больше о запросах в SQL консоли, прочитав документацию по (link) запросам.
Создание и выполнение запроса
Создание запроса
Существует два способа создать новый запрос в SQL консоли.
- Нажмите кнопку '+' в строке вкладок.
- Выберите кнопку 'Новый запрос' в списке запросов левой боковой панели.

Выполнение запроса
Чтобы выполнить запрос, введите ваши SQL команды в редакторе SQL и нажмите кнопку 'Запустить' или используйте сочетание клавиш cmd / ctrl + enter
. Чтобы записывать и выполнять несколько команд последовательно, убедитесь, что после каждой команды стоит точка с запятой.
Варианты выполнения запросов По умолчанию, нажатие кнопки запуска выполняет все команды, содержащиеся в редакторе SQL. SQL консоль поддерживает два других варианта выполнения запросов:
- Выполнить выделенные команды
- Выполнить команду в позиции курсора
Чтобы выполнить выделенные команды, выделите нужную команду или последовательность команд и нажмите кнопку 'Запустить' (или используйте сочетание клавиш cmd / ctrl + enter
). Вы также можете выбрать 'Выполнить выделенное' из контекстного меню редактора SQL (открывается при щелчке правой кнопкой мыши в редакторе), когда выделение присутствует.

Выполнить команду в текущей позиции курсора можно двумя способами:
- Выберите 'По курсору' из меню расширенных вариантов запуска (или используйте соответствующее сочетание клавиш
cmd / ctrl + shift + enter
).

- Выбрав 'Выполнить по курсору' из контекстного меню редактора SQL.

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

Сохранение запроса
Сохранение запросов позволяет вам легко находить их позже и делиться ими с вашими коллегами. SQL консоль также позволяет организовать ваши запросы в папки.
Чтобы сохранить запрос, просто нажмите кнопку "Сохранить" сразу рядом с кнопкой "Запустить" на панели инструментов. Введите желаемое имя и нажмите "Сохранить запрос".
Использование сочетания клавиш cmd / ctrl + s
также сохранит любую работу в текущей вкладке запроса.

Кроме того, вы можете одновременно назвать и сохранить запрос, нажав на "Безымянный запрос" на панели инструментов, изменив название и нажав Enter:

Обмен запросами
SQL консоль позволяет легко делиться запросами с вашими коллегами. SQL консоль поддерживает четыре уровня доступа, которые могут быть настроены как глобально, так и на уровне конкретного пользователя:
- Владелец (может настраивать параметры обмена)
- Права на запись
- Доступ только для чтения
- Нет доступа
После сохранения запроса нажмите кнопку "Поделиться" на панели инструментов. Появится модальное окно с параметрами обмена:

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

После применения вышеизложенного запрос теперь может быть просмотрен (и выполнен) всеми членами команды, имеющими доступ к SQL консоли для службы.
Чтобы настроить доступ к запросу для конкретных участников, выберите нужного участника команды из селектора "Добавить участника команды":

После выбора участника команды должна появиться новая строка с селектором уровня доступа:

Доступ к общим запросам
Если запрос был с вами разделен, он будет отображаться на вкладке "Запросы" в левой боковой панели SQL консоли:

Ссылка на запрос (постоянные ссылки)
Сохраненные запросы также имеют постоянные ссылки, что означает, что вы можете отправлять и получать ссылки на общие запросы и открывать их напрямую.
Значения для любых параметров, которые могут существовать в запросе, автоматически добавляются к URL сохраненного запроса в виде параметров запроса. Например, если запрос содержит параметры {start_date: Date}
и {end_date: Date}
, постоянная ссылка может выглядеть так: https://console.clickhouse.cloud/services/:serviceId/console/query/:queryId?param_start_date=2015-01-01¶m_end_date=2016-01-01
.
Расширенные функции запросов
Поиск по результатам запроса
После выполнения запроса вы можете быстро искать по возвращенному набору результатов, используя поле поиска в панели результатов. Эта функция помогает предварительно просматривать результаты дополнительного условия WHERE
или просто проверять, чтобы убедиться, что конкретные данные включены в набор результатов. После ввода значения в поле поиска панель результатов обновится и вернет записи, содержащие элемент, соответствующий введенному значению. В этом примере мы будем искать все экземпляры breakfast
в таблице hackernews
для комментариев, содержащих ClickHouse
(не учитывается регистр):

Примечание: любое поле, соответствующее введенному значению, будет возвращено. Например, третья запись на приведенном выше скриншоте не соответствует 'breakfast' в поле by
, но поле text
соответствует:

Настройка параметров пагинации
По умолчанию панель результатов запроса отображает каждую запись результата на одной странице. Для больших наборов результатов может быть предпочтительнее разбивать результаты на страницы для более удобного просмотра. Это можно сделать с помощью селектора пагинации в правом нижнем углу панели результатов:

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

Экспорт данных результата запроса
Наборы результатов запроса можно легко экспортировать в формат CSV прямо из SQL консоли. Для этого откройте меню •••
на правой стороне панели инструментов результатов и выберите 'Скачать как CSV'.

Визуализация данных запроса
Некоторые данные могут быть легче интерпретированы в виде графика. Вы можете быстро создавать визуализации из данных результатов запроса прямо из SQL консоли всего за несколько кликов. В качестве примера мы будем использовать запрос, который рассчитывает еженедельную статистику для поездок такси в Нью-Йорке:

Без визуализации эти результаты трудно интерпретировать. Давайте превратим их в график.
Создание графиков
Чтобы начать создавать вашу визуализацию, выберите опцию 'График' на панели инструментов панели результатов запроса. Появится панель конфигурации графика:

Мы начнем с создания простого столбчатого графика, отслеживающего trip_total
по week
. Для этого перетащим поле week
на ось x, а поле trip_total
на ось y:

Большинство типов графиков поддерживают несколько полей на числовых осях. Чтобы продемонстрировать это, мы перетащим поле fare_total на ось y:

Настройка графиков
SQL консоль поддерживает десять типов графиков, которые можно выбрать из селектора типов графиков в панели конфигурации графика. Например, мы можем легко изменить предыдущий тип графика с Столбчатого на Площадь:

Названия графиков совпадают с именем запроса, предоставляющего данные. Обновление названия запроса приведет к обновлению названия графика:

Некоторые более продвинутые характеристики графиков также можно настроить в разделе 'Дополнительно' панели конфигурации графика. Для начала мы изменим следующие настройки:
- Подзаголовок
- Названия осей
- Ориентация меток для оси x
Наш график будет обновлен соответственно:

В некоторых случаях может потребоваться настроить шкалы осей для каждого поля отдельно. Это также можно сделать в разделе 'Дополнительно' панели конфигурации графика, указывая минимальные и максимальные значения для диапазона оси. Например, вышеуказанный график выглядит хорошо, но для демонстрации корреляции между нашими полями trip_total
и fare_total
диапазоны осей нуждаются в некоторой корректировке:
