Консоль 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, чтобы отменить запрос. Обратите внимание: любые результаты, которые уже были возвращены, останутся после отмены.

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

Если раньше не было присвоено название, ваш запрос должен называться «Непридуманное название запроса». Щелкните на имя запроса, чтобы изменить его. Переименование запроса приведет к его сохранению.

Вы также можете использовать кнопку сохранения или сочетание клавиш cmd / ctrl + s, чтобы сохранить запрос.

Использование GenAI для управления запросами

Эта функция позволяет пользователям формулировать запросы в виде вопросов на естественном языке и создавать SQL-запросы на основе контекста доступных таблиц. GenAI также может помочь пользователям отладить их запросы.

Для получения дополнительной информации о GenAI ознакомьтесь с объявлением о предложениях запросов на основе GenAI в ClickHouse Cloud.

Настройка таблицы

Давайте импортируем пример набора данных UK Price Paid и воспользуемся им для создания запросов GenAI.

1. Откройте службу ClickHouse Cloud.

2. Создайте новый запрос, нажав на иконку +.

3. Вставьте и выполните следующий код:

   Этот запрос должен занять около 1 секунды для завершения. После этого у вас должна быть пустая таблица с названием uk_price_paid.

4. Создайте новый запрос и вставьте следующий запрос:

Этот запрос загружает набор данных с сайта gov.uk. Этот файл весит около ~4 ГБ, поэтому выполнение этого запроса займет несколько минут. После того как ClickHouse обработает запрос, у вас должен быть полный набор данных в таблице uk_price_paid.

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

Давайте создадим запрос, используя естественный язык.

1. Выберите таблицу uk_price_paid, а затем нажмите Создать запрос.

2. Нажмите Сгенерировать SQL. Вас могут попросить подтвердить, что ваши запросы отправляются в Chat-GPT. Вы должны выбрать Я согласен, чтобы продолжить.

3. Теперь вы можете использовать этот запрос, чтобы ввести запрос на естественном языке и позволить ChatGPT преобразовать его в SQL-запрос. В этом примере мы введем:

   Покажите мне общую цену и общее количество всех транзакций uk_price_paid по годам.

4. Консоль сгенерирует запрос, который мы ищем, и отобразит его в новой вкладке. В нашем примере GenAI создал следующий запрос:

5. После проверки того, что запрос корректен, нажмите Выполнить, чтобы его выполнить.

Отладка

Теперь давайте протестируем возможности отладки запросов GenAI.

1. Создайте новый запрос, нажав на иконку + и вставьте следующий код:

2. Нажмите Выполнить. Запрос не выполняется, так как мы пытаемся получить значения из pricee, а не из price.

3. Нажмите Исправить запрос.

4. GenAI попытается исправить запрос. В этом случае он изменил pricee на price. Он также понял, что функция toYear лучше подходит для этого сценария.

5. Выберите Применить, чтобы добавить предложенные изменения в ваш запрос, затем нажмите Выполнить.

Помните, что GenAI — это экспериментальная функция. Будьте осторожны при выполнении запросов, сгенерированных GenAI, с любым набором данных.

Расширенные функции запросов

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

После выполнения запроса вы можете быстро искать по возвращенному набору результатов, используя поле поиска в панели результатов. Эта функция помогает предварительно просмотреть результаты дополнительного предложения 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 диапазоны осей нуждаются в некотором корректировании:

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

Консоль SQL позволяет вам делиться запросами со своей командой. Когда запрос делится, все участники команды могут видеть и редактировать его. Совместное использование запросов — отличный способ сотрудничества с вашей командой.

Чтобы поделиться запросом, нажмите кнопку «Поделиться» на панели инструментов запроса.

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

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