> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-home-button.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Выполняйте запросы и создавайте визуализации с помощью SQL-консоли.
# SQL Console
export const Image = ({img, alt, size}) => {
return
;
};
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¶m_end_date=2016-01-01`.
## Расширенные возможности работы с запросами
### Поиск по результатам запроса
После выполнения запроса вы можете быстро искать по возвращённому результирующему набору с помощью поля поиска на панели результатов. Эта возможность помогает предварительно оценить, как будут выглядеть результаты с дополнительным условием `WHERE`, или просто проверить, что нужные данные входят в результирующий набор. После ввода значения в поле поиска панель результатов обновится и покажет записи, содержащие значение, совпадающее с введённым. В этом примере мы найдём все вхождения `breakfast` в таблице `hackernews` среди комментариев, содержащих `ClickHouse` (регистронезависимый поиск):
Примечание: будут возвращены строки, в которых введённому значению соответствует любое поле. Например, в третьей записи на снимке экрана выше нет совпадения с `breakfast` в поле `by`, но оно есть в поле `text`:
По умолчанию панель результатов запроса показывает все записи на одной странице. Для крупных результирующих наборов может быть удобнее разбить результаты на страницы. Это можно сделать с помощью селектора пагинации в правом нижнем углу панели результатов:
При выборе размера страницы пагинация сразу применяется к результирующему набору, а элементы навигации появляются в центре нижнего колонтитула панели результатов
### Экспорт данных из результатов запроса
Данные из результатов запроса можно легко экспортировать в формате CSV прямо из SQL-консоли. Для этого откройте меню `•••` в правой части панели инструментов панели результатов и выберите 'Скачать как CSV'.
## Визуализация данных запроса
Некоторые данные удобнее воспринимать в виде диаграмм. Вы можете всего за несколько щелчков создать визуализации на основе данных из результатов запроса прямо в SQL-консоли. В качестве примера мы используем запрос, который рассчитывает еженедельную статистику по поездкам на такси в Нью-Йорке:
```sql theme={null}
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`, диапазоны осей нужно немного скорректировать: