SQL Console

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

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

Исследование таблиц

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

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

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

Исследование данных таблицы

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

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

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

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

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

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

SQL‑консоль также позволяет добавлять несколько сортировок для одной таблицы. Нажмите кнопку 'Sort' еще раз, чтобы добавить дополнительную сортировку.

Примечание

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

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

Чтобы отфильтровать таблицу в SQL‑консоли, откройте таблицу и нажмите кнопку 'Filter'. Аналогично сортировке, откроется меню, в котором вы сможете настроить параметры фильтрации. Вы можете выбрать столбец для фильтрации и задать необходимые критерии. SQL‑консоль автоматически отображает доступные варианты фильтрации, соответствующие типу данных в выбранном столбце.

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

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

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

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

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

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

Примечание

При использовании функции 'Create Query' фильтры и сортировки не являются обязательными.

Дополнительную информацию о работе с запросами в 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":

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

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

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

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

Сохранённые запросы также получают постоянные ссылки (permalink), что позволяет вам отправлять и получать ссылки на общие запросы и открывать их напрямую.

Значения любых параметров, которые могут присутствовать в запросе, автоматически добавляются к URL сохранённого запроса в виде параметров строки запроса. Например, если запрос содержит параметры {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-консоли. Для этого откройте меню ••• в правой части панели инструментов области результатов и выберите пункт Download as 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, диапазоны осей нуждаются в некоторой корректировке: