SQL-запросы в Managed Service for ClickHouse®
Managed Service for ClickHouse® позволяет визуализировать структуру данных на вашем кластере ClickHouse® и отправлять SQL-запросы к базам из консоли управления Yandex Cloud. Для этого войдите в консоль управления
Справочник по поддерживаемым запросам можно найти в документации ClickHouse®
Важно
Встроенный в консоль управления SQL-редактор не предназначен для решения широкого круга задач редактирования данных. Значения некоторых параметров могут быть заменены на дефолтные для редактора.
При работе с БД рекомендуется использовать сторонние редакторы или сервис Yandex WebSQL. Для работы с Yandex WebSQL нажмите Открыть на промо-баннере и установите соединение с кластером базы данных.
Доступ к кластеру из консоли управления
Чтобы подключиться из консоли управления к кластеру Managed Service for ClickHouse® и работать с данными в нем, включите опцию Доступ из консоли управления при создании кластера или изменении его настроек.
Аутентификация
При каждом переходе на вкладку SQL необходимо ввести логин и пароль пользователя кластера. После этого откроется структура данных кластера и окно ввода для SQL-запросов.
Совет
Чтобы не вводить пароль слишком часто, откройте эту страницу консоли управления в новой вкладке браузера.
Визуализация структуры данных
После авторизации вы можете видеть структуру баз данных и таблиц в кластере:
По нажатию на таблицу выводятся первые 1000 строк результата запроса SELECT *
для этой таблицы (полноценную навигацию по всем данным консоль управления не поддерживает). Наведите курсор на заголовок столбца, чтобы увидеть тип данных в столбце:
В поле Номер первой строки вы можете задать смещение, с которым следует показать таблицу результатов. На одной странице отображается не больше 20 строк — с помощью кнопок < и > вы можете быстро увеличивать и уменьшать смещение на 20.
SQL-запросы
Справа открыто окно ввода запроса. Начните вводить запрос, и редактор будет предлагать варианты ключевых слов:
Введите запрос и нажмите кнопку Выполнить. Таблица результатов или сообщение об ошибке появится на панели результатов под кнопками.
Ограничения запросов в консоли управления
Главное ограничение запросов в консоли управления — текст запросов и их результаты доступны только пока вы не закрыли или перезагрузили страницу в браузере. Но если запрос был успешно запущен, Managed Service for ClickHouse® обработает его независимо от состояния консоли управления.
Помимо этого стоит помнить:
- Консоль управления выведет только первые 1000 строк результата, даже если данных на самом деле больше.
- Когда выполнение запроса на кластере занимает больше 10 минут, консоль управления не выведет результат и сообщит об ошибке, даже если запрос в конечном счете будет успешно обработан.
- Если в вашем кластере больше одного хоста ClickHouse®, то запросы из консоли управления отправляются на случайный хост. Учитывайте это, если будете модифицировать данные: например, запрос
CREATE TABLE db1.newtable
создаст таблицу только на одном хосте. Чтобы избежать этого, используйте распределенный запрос с подстановкой имени кластера:CREATE TABLE db1.newtable ON CLUSTER '{cluster}'
. - SQL-запросы в консоли управления выполняется отдельно, без создания единой сессии с сервером ClickHouse®. Поэтому запросы, которые действуют в пределах сессии, не имеют эффекта. Например,
USE
илиSET
.
ClickHouse® является зарегистрированным товарным знаком ClickHouse, Inc