[Документация Yandex Cloud](../../index.md) > [Yandex Managed Service for ClickHouse®](../index.md) > [Пошаговые инструкции](index.md) > Базы данных > SQL-запросы в консоли управления

# SQL-запросы в консоли управления

Managed Service for ClickHouse® позволяет визуализировать структуру данных на вашем кластере ClickHouse® и отправлять SQL-запросы к базам из консоли управления Yandex Cloud. Для этого войдите в [консоль управления](https://kz.console.yandex.cloud), откройте страницу нужного кластера и перейдите на вкладку **SQL**.

Справочник по поддерживаемым запросам можно найти в [документации ClickHouse®](https://clickhouse.com/docs/ru/sql-reference/statements/select).

{% note warning %}

Встроенный в консоль управления SQL-редактор не предназначен для решения широкого круга задач редактирования данных. Значения некоторых параметров могут быть заменены на дефолтные для редактора.

При работе с БД рекомендуется использовать сторонние редакторы или сервис [Yandex WebSQL](../../websql/concepts/index.md). Для работы с Yandex WebSQL нажмите **Открыть** на промо-баннере и [установите соединение с кластером](../../websql/operations/create-connection.md#connect-cluster) базы данных.

{% endnote %}

## Доступ к кластеру из консоли управления {#sql-cluster-access}

Чтобы подключиться из консоли управления к кластеру Managed Service for ClickHouse® и работать с данными в нем, включите опцию **Доступ из консоли управления** при [создании кластера](cluster-create.md) или [изменении его настроек](update.md#change-additional-settings).

## Аутентификация {#authentication}

При каждом переходе на вкладку **SQL** необходимо ввести логин и пароль пользователя кластера. После этого откроется структура данных кластера и окно ввода для SQL-запросов.

{% note tip %}

Чтобы не вводить пароль слишком часто, откройте эту страницу консоли управления в новой вкладке браузера.

{% endnote %}

## Визуализация структуры данных {#data-structure-visualization}

После авторизации вы можете видеть структуру баз данных и таблиц в кластере:

![structure](../../_assets/mdb/structure.png)

По нажатию на таблицу выводятся первые 1000 строк результата запроса `SELECT *` для этой таблицы (полноценную навигацию по всем данным консоль управления не поддерживает). Наведите курсор на заголовок столбца, чтобы увидеть тип данных в столбце:

![table](../../_assets/mdb/table.png)

В поле **Номер первой строки** вы можете задать смещение, с которым следует показать таблицу результатов. На одной странице отображается не больше 20 строк — с помощью кнопок **<** и **>** вы можете быстро увеличивать и уменьшать смещение на 20.

## SQL-запросы {#sql-queries}

Справа открыто окно ввода запроса. Начните вводить запрос, и редактор будет предлагать варианты ключевых слов:

![suggest](../../_assets/mdb/suggest.png)

Введите запрос и нажмите кнопку **Выполнить**. Таблица результатов или сообщение об ошибке появится на панели результатов под кнопками.

![result](../../_assets/mdb/result.png)

## Ограничения запросов в консоли управления {#query-restrictions-in-the-management-console}

Главное ограничение запросов в консоли управления — текст запросов и их результаты доступны только пока вы не закрыли или перезагрузили страницу в браузере. Но если запрос был успешно запущен, Managed Service for ClickHouse® обработает его независимо от состояния консоли управления.

Помимо этого стоит помнить:

* Консоль управления выведет только первые 1000 строк результата, даже если данных на самом деле больше.
* Когда выполнение запроса на кластере занимает больше 10 минут, консоль управления не выведет результат и сообщит об ошибке, даже если запрос в конечном счете будет успешно обработан.
* Если в вашем кластере больше одного хоста ClickHouse®, то запросы из консоли управления отправляются на случайный хост. Учитывайте это, если будете модифицировать данные: например, запрос `CREATE TABLE db1.newtable` создаст таблицу только на одном хосте. Чтобы избежать этого, используйте [распределенный запрос](https://clickhouse.com/docs/ru/sql-reference/statements/create/table) с подстановкой имени кластера: `CREATE TABLE db1.newtable ON CLUSTER '{cluster}'`.
* SQL-запросы в консоли управления выполняется отдельно, без создания единой сессии с сервером ClickHouse®. Поэтому запросы, которые действуют в пределах сессии, не имеют эффекта. Например, `USE` или `SET`.


_ClickHouse® является зарегистрированным товарным знаком [ClickHouse, Inc](https://clickhouse.com)._