> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Консоль SQL
> Узнайте о консоли SQL
export const Image = ({img, alt, size}) => {
return
;
};
export const ExperimentalBadge = () => {
return ;
};
Консоль SQL — самый быстрый и простой способ просматривать базы данных в ClickHouse Cloud и выполнять к ним запросы. С помощью консоли SQL вы можете:
* Подключаться к сервисам ClickHouse Cloud
* Просматривать, фильтровать и сортировать данные таблиц
* Выполнять запросы и визуализировать результаты всего за несколько кликов
* Делиться запросами с участниками команды и эффективнее работать вместе.
## Просмотр таблиц
### Просмотр списка таблиц и сведений о схеме
Обзор таблиц в вашем экземпляре ClickHouse можно найти на левой боковой панели. Чтобы просмотреть таблицы в конкретной базе данных, используйте селектор базы данных в верхней части левой панели.
Таблицы в списке также можно развернуть, чтобы просмотреть столбцы и типы данных.
### Просмотр данных таблицы
Нажмите на таблицу в списке, чтобы открыть её в новой вкладке. В режиме просмотра таблицы данные можно легко просматривать, выделять и копировать. Обратите внимание: при копировании в табличные приложения, такие как Microsoft Excel и Google Sheets, структура и форматирование сохраняются. Переключаться между страницами данных таблицы (по 30 строк на страницу) можно с помощью навигации в нижнем колонтитуле.
### Просмотр данных в ячейке
Инструмент Cell Inspector можно использовать для просмотра больших объёмов данных, содержащихся в одной ячейке. Чтобы открыть его, щёлкните правой кнопкой мыши по ячейке и выберите «Inspect Cell». Содержимое инспектора ячейки можно скопировать, нажав значок копирования в правом верхнем углу.
## Фильтрация и сортировка таблиц
### Сортировка таблицы
Чтобы отсортировать таблицу в консоли SQL, откройте таблицу и нажмите кнопку 'Sort' на панели инструментов. Откроется меню, в котором можно настроить сортировку. Вы можете выбрать столбец, по которому нужно сортировать, и задать порядок сортировки (по возрастанию или по убыванию). Нажмите 'Apply' или клавишу Enter, чтобы отсортировать таблицу
Консоль SQL также позволяет добавить для таблицы несколько сортировок. Снова нажмите кнопку 'Sort', чтобы добавить еще одну сортировку. Обратите внимание: сортировки применяются в том порядке, в котором они отображаются на панели сортировки (сверху вниз). Чтобы удалить сортировку, просто нажмите кнопку 'x' рядом с ней.
### Фильтрация таблицы
Чтобы отфильтровать таблицу в Консоли SQL, откройте таблицу и нажмите кнопку 'Filter'. Как и при сортировке, эта кнопка открывает меню, в котором можно настроить фильтр. Вы можете выбрать столбец, по которому нужно фильтровать, и указать необходимые критерии. Консоль SQL автоматически показывает варианты фильтрации, соответствующие типу данных в столбце.
Когда фильтр вас устроит, нажмите 'Apply', чтобы применить его к данным. Как показано ниже, вы также можете добавить дополнительные фильтры.
Как и при сортировке, нажмите кнопку 'x' рядом с фильтром, чтобы удалить его.
### Одновременная фильтрация и сортировка
Консоль SQL позволяет одновременно фильтровать и сортировать таблицу. Для этого добавьте все нужные фильтры и параметры сортировки, как описано выше, и нажмите кнопку «Применить».
### Создание запроса из фильтров и сортировок
Консоль 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`, чтобы отменить запрос. Примечание: все результаты, которые уже были получены, сохранятся после отмены.
### Сохранение запроса
Если имя запроса ещё не задано, он будет называться «Untitled Query». Нажмите на название запроса, чтобы изменить его. При переименовании запрос будет сохранён.
Вы также можете сохранить запрос с помощью кнопки сохранения или сочетания клавиш `cmd / ctrl + s`.
## Использование GenAI для работы с запросами
Эта возможность позволяет писать запросы в виде вопросов на естественном языке, а консоль запросов будет создавать SQL-запросы с учётом контекста доступных таблиц. GenAI также может помочь с отладкой запросов.
Подробнее о GenAI читайте в [блоге Announcing GenAI powered query suggestions in ClickHouse Cloud](https://clickhouse.com/blog/announcing-genai-powered-query-suggestions-clickhouse-cloud).
### Настройка таблицы
Давайте импортируем демонстрационный набор данных UK Price Paid и используем его для создания нескольких GenAI-запросов.
1. Откройте сервис ClickHouse Cloud.
2. Создайте новый запрос, нажав значок *+*.
3. Вставьте и выполните следующий код:
```sql theme={null}
CREATE TABLE uk_price_paid
(
price UInt32,
date Date,
postcode1 LowCardinality(String),
postcode2 LowCardinality(String),
type Enum8('terraced' = 1, 'semi-detached' = 2, 'detached' = 3, 'flat' = 4, 'other' = 0),
is_new UInt8,
duration Enum8('freehold' = 1, 'leasehold' = 2, 'unknown' = 0),
addr1 String,
addr2 String,
street LowCardinality(String),
locality LowCardinality(String),
town LowCardinality(String),
district LowCardinality(String),
county LowCardinality(String)
)
ENGINE = MergeTree
ORDER BY (postcode1, postcode2, addr1, addr2);
```
Выполнение этого запроса займет около 1 секунды. После этого у вас будет пустая таблица с именем `uk_price_paid`.
4. Создайте новый запрос и вставьте в него следующий запрос:
```sql theme={null}
INSERT INTO uk_price_paid
WITH
splitByChar(' ', postcode) AS p
SELECT
toUInt32(price_string) AS price,
parseDateTimeBestEffortUS(time) AS date,
p[1] AS postcode1,
p[2] AS postcode2,
transform(a, ['T', 'S', 'D', 'F', 'O'], ['terraced', 'semi-detached', 'detached', 'flat', 'other']) AS type,
b = 'Y' AS is_new,
transform(c, ['F', 'L', 'U'], ['freehold', 'leasehold', 'unknown']) AS duration,
addr1,
addr2,
street,
locality,
town,
district,
county
FROM url(
'http://prod.publicdata.landregistry.gov.uk.s3-website-eu-west-1.amazonaws.com/pp-complete.csv',
'CSV',
'uuid_string String,
price_string String,
time String,
postcode String,
a String,
b String,
c String,
addr1 String,
addr2 String,
street String,
locality String,
town String,
district String,
county String,
d String,
e String'
) SETTINGS max_http_get_redirects=10;
```
Этот запрос получает набор данных с сайта `gov.uk`. Размер файла — около 4 ГБ, поэтому выполнение запроса займет несколько минут. После того как ClickHouse обработает запрос, весь набор данных будет загружен в таблицу `uk_price_paid`.
#### Создание запроса
Давайте создадим запрос с помощью естественного языка.
1. Выберите table **uk\_price\_paid**, затем нажмите **Create Query**.
2. Нажмите **Generate SQL**. Вас могут попросить подтвердить, что ваши запросы отправляются в Chat-GPT. Чтобы продолжить, необходимо выбрать **I agree**.
3. Теперь вы можете использовать этот промпт, чтобы ввести запрос на естественном языке, а ChatGPT преобразует его в SQL-запрос. В этом примере мы введём:
> Покажи общую стоимость и общее количество всех транзакций в uk\_price\_paid по годам.
4. Консоль сгенерирует нужный запрос и отобразит его на новой вкладке. В нашем примере GenAI создал следующий запрос:
```sql theme={null}
-- Покажи общую стоимость и общее количество всех транзакций в uk_price_paid по годам.
SELECT year(date), sum(price) as total_price, Count(*) as total_transactions
FROM uk_price_paid
GROUP BY year(date)
```
5. Убедившись, что запрос корректен, нажмите **Run**, чтобы выполнить его.
### Отладка
Теперь давайте проверим возможности GenAI по отладке запросов.
1. Создайте новый запрос, нажав на значок *+*, и вставьте следующий код:
```sql theme={null}
-- Покажи мне общую цену и общее количество всех транзакций uk_price_paid по годам.
SELECT year(date), sum(pricee) as total_price, Count(*) as total_transactions
FROM uk_price_paid
GROUP BY year(date)
```
2. Нажмите **Run**. Запрос завершится ошибкой, поскольку мы пытаемся получить значения из `pricee`, а не из `price`.
3. Нажмите **Fix Query**.
4. GenAI попытается исправить запрос. В этом случае он заменил `pricee` на `price`. Он также определил, что в этом случае лучше использовать функцию `toYear`.
5. Выберите **Apply**, чтобы добавить предложенные изменения в запрос, и нажмите **Run**.
Имейте в виду, что GenAI — экспериментальная возможность. Соблюдайте осторожность при выполнении запросов, сгенерированных GenAI, для любого набора данных.
## Расширенные возможности запросов
### Поиск по результатам запроса
После выполнения запроса вы можете быстро выполнить поиск по возвращённому результирующему набору с помощью поля поиска на панели результатов. Эта возможность помогает предварительно оценить результаты применения дополнительного условия `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`, диапазоны осей нужно немного скорректировать:
## Общий доступ к запросам
Консоль SQL позволяет делиться запросами с вашей командой. Когда запрос открыт для общего доступа, все участники команды могут просматривать и редактировать его. Запросы с общим доступом — удобный способ совместной работы с командой.
Чтобы поделиться запросом, нажмите кнопку 'Share' на панели инструментов запроса.
Откроется диалоговое окно, в котором можно открыть доступ к запросу для всех участников команды. Если у вас несколько команд, вы можете выбрать, с какой из них поделиться запросом.
В некоторых случаях может потребоваться отдельно настроить масштаб осей для каждого поля. Это также можно сделать в разделе 'Advanced' на панели конфигурации диаграммы, указав минимальное и максимальное значения для диапазона оси. Например, приведённая выше диаграмма выглядит хорошо, но, чтобы продемонстрировать корреляцию между полями `trip_total` и `fare_total`, диапазоны осей нужно немного скорректировать: