SQL Console

Выполняйте запросы и создавайте визуализации с помощью SQL-консоли.

SQL-консоль — самый быстрый и простой способ изучать ваши базы данных в ClickHouse Cloud и выполнять к ним запросы. С помощью SQL-консоли вы можете:

• Подключаться к сервисам ClickHouse Cloud
• Просматривать, фильтровать и сортировать данные в таблицах
• Выполнять запросы и визуализировать результаты всего за несколько щелчков
• Делиться запросами с участниками команды и эффективнее работать вместе.

​

Просмотр таблиц

​

Просмотр списка таблиц и сведений о схеме

Обзор таблиц в вашем экземпляре ClickHouse доступен в левой боковой панели. Используйте селектор базы данных в верхней части левой панели, чтобы просмотреть таблицы в конкретной базе данных

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

​

Просмотр данных таблицы

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

​

Просмотр данных в ячейке

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

​

Фильтрация и сортировка таблиц

​

Сортировка таблицы

Чтобы отсортировать таблицу в SQL-консоли, откройте таблицу и нажмите кнопку ‘Sort’ на панели инструментов. Откроется меню, в котором можно настроить параметры сортировки. Выберите столбец, по которому нужно выполнить сортировку, и задайте порядок сортировки (по возрастанию или по убыванию). Выберите ‘Apply’ или нажмите Enter, чтобы отсортировать таблицу.

SQL-консоль также позволяет добавлять для таблицы несколько сортировок. Нажмите кнопку ‘Sort’ ещё раз, чтобы добавить ещё одну сортировку.

Сортировки применяются в том порядке, в котором они отображаются на панели сортировки (сверху вниз). Чтобы удалить сортировку, просто нажмите кнопку ‘x’ рядом с ней.

​

Фильтрация таблицы

Чтобы отфильтровать таблицу в SQL-консоли, откройте таблицу и нажмите кнопку ‘Filter’. Как и в случае с сортировкой, эта кнопка откроет меню, в котором можно настроить фильтр. Вы можете выбрать столбец, по которому нужно фильтровать данные, и задать необходимые критерии. SQL-консоль интеллектуально показывает параметры фильтрации, соответствующие типу данных в столбце.

Когда результат фильтрации вас устроит, нажмите ‘Apply’, чтобы отфильтровать данные. Вы также можете добавить дополнительные фильтры, как показано ниже.

Как и в случае с сортировкой, нажмите кнопку ‘x’ рядом с фильтром, чтобы удалить его.

​

Одновременная фильтрация и сортировка

SQL-консоль позволяет одновременно фильтровать и сортировать таблицу. Для этого добавьте все нужные фильтры и параметры сортировки, как описано выше, и нажмите кнопку ‘Apply’.

​

Создание запроса из фильтров и сортировки

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

Для использования функции ‘Создать запрос’ фильтры и сортировка не обязательны.

Подробнее о выполнении запросов в SQL-консоли см. в документации по запросам (link).

​

Создание и выполнение запроса

​

Создание запроса

Создать новый запрос в SQL-консоли можно двумя способами.

• Нажмите кнопку ’+’ на панели вкладок
• Выберите кнопку ‘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

При выполнении команда в позиции курсора кратковременно подсветится жёлтым.

​

Отмена запроса

Пока запрос выполняется, на панели инструментов редактора запросов вместо кнопки ‘Run’ отображается кнопка ‘Cancel’. Просто нажмите эту кнопку или клавишу Esc, чтобы отменить запрос. Примечание: все результаты, которые уже были получены, сохранятся после отмены.

​

Сохранение запроса

Сохранив запрос, вы сможете легко найти его позже и поделиться им с коллегами. В SQL-консоли также можно упорядочивать запросы по папкам.

Чтобы сохранить запрос, просто нажмите кнопку “Save” на панели инструментов рядом с кнопкой “Run”. Введите нужное имя и нажмите “Save Query”.

Сочетание клавиш cmd / ctrl + s также сохранит все изменения в текущей вкладке запроса.

Кроме того, можно одновременно задать имя и сохранить запрос: нажмите “Untitled Query” на панели инструментов, измените имя и нажмите Enter:

​

Общий доступ к запросам

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

• Владелец (может настраивать параметры общего доступа)
• Доступ на запись
• Доступ только для чтения
• Нет доступа

После сохранения запроса нажмите кнопку “Share” на панели инструментов. Появится модальное окно с параметрами общего доступа:

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

После этого запрос смогут просматривать (и выполнять) все участники команды, у которых есть доступ к SQL-консоли этого сервиса.

Чтобы настроить доступ к запросу для отдельных участников, выберите нужного участника команды в списке “Add a team member”:

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

​

Доступ к общим запросам

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

​

Ссылки на запрос (постоянные ссылки)

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

Значения всех параметров, присутствующих в запросе, автоматически добавляются в URL сохранённого запроса как query-параметры. Например, если запрос содержит параметры {start_date: Date} и {end_date: Date}, постоянная ссылка может выглядеть так: https://console.clickhouse.cloud/services/:serviceId/console/query/:queryId?param_start_date=2015-01-01&param_end_date=2016-01-01.

​

Расширенные возможности работы с запросами

​

Поиск по результатам запроса

После выполнения запроса вы можете быстро искать по возвращённому результирующему набору с помощью поля поиска на панели результатов. Эта возможность помогает предварительно оценить, как будут выглядеть результаты с дополнительным условием WHERE, или просто проверить, что нужные данные входят в результирующий набор. После ввода значения в поле поиска панель результатов обновится и покажет записи, содержащие значение, совпадающее с введённым. В этом примере мы найдём все вхождения breakfast в таблице hackernews среди комментариев, содержащих ClickHouse (регистронезависимый поиск):

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

​

Настройка параметров пагинации

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

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

​

Экспорт данных из результатов запроса

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

​

Визуализация данных запроса

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

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

Без визуализации эти результаты трудно интерпретировать. Давайте представим их в виде графика.

​

Создание диаграмм

Чтобы начать создавать визуализацию, выберите на панели результатов запроса опцию ‘Chart’. Появится панель конфигурации диаграммы:

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

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

​

Настройка диаграмм

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

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

Некоторые дополнительные параметры диаграммы также можно настроить в разделе ‘Advanced’ на панели конфигурации диаграммы. Для начала изменим следующие настройки:

• Подзаголовок
• Названия осей
• Ориентация подписей на оси x

Наша диаграмма изменится соответствующим образом:

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