SQL Консоль

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

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

Изучение таблиц

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

Обзор таблиц, содержащихся в вашем экземпляре 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&param_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 диапазоны осей нужно немного подкорректировать: