[Документация Yandex Cloud](../../index.md) > [Yandex WebSQL](../index.md) > Концепции > О сервисе Yandex WebSQL

# О сервисе Yandex WebSQL

Yandex WebSQL — это сервис Yandex Cloud, который позволяет подключаться к публично доступным БД и кластерам управляемых БД.

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


Вы можете устанавливать подключения к кластерам управляемых БД из облаков и каталогов, которые принадлежат вашей [организации](../../organization/concepts/organization.md) Yandex Cloud. Если вы [перейдете в другую организацию](../../organization/operations/manage-organizations.md#switch-to-another-org), то вам будет доступен набор кластеров из других облаков и каталогов. Добавленные подключения будут доступны, пока вы работаете в текущей организации Yandex Cloud.



Вы можете устанавливать подключения к кластерам управляемых БД Yandex Cloud из облаков Yandex Cloud, которые принадлежат вашей организации. Если вы перейдете в другую организацию, то вам будет доступен набор кластеров из других облаков. Добавленные подключения будут доступны, пока вы работаете в текущей организации.


Yandex WebSQL поддерживает работу со следующими версиями БД:

* PostgreSQL: 12 и выше.
* MySQL®: 5 и выше.
* ClickHouse®: 23 и выше.
* Redis/Valkey™ (только нешардированные кластеры): 6 и выше.
* MongoDB/Yandex StoreDoc: 6 и выше.
* [Yandex Managed Service for Trino](../../managed-trino/index.md) (сервис находится на стадии [Preview](../../overview/concepts/launch-stages.md)): 454 и выше.
* Greenplum®: 6 и выше.

## Пользовательский интерфейс {#user-interface}

Для работы с Yandex WebSQL используйте:

* _Панель управления_ — крайняя левая панель с иконками ![image](../../_assets/console-icons/folder-tree.svg) **Подключения**, ![image](../../_assets/console-icons/floppy-disk.svg) **Сохраненные запросы** и ![image](../../_assets/console-icons/clock-arrow-rotate-left.svg) **История запросов**.
* _Подключения_ — панель просмотра существующих и добавления новых подключений к БД.
* _Панель данных_ — правая панель, на которой можно формировать запросы и просматривать результаты их выполнения, а также просматривать настройки подключений и информацию об объектах БД.

Во время работы в интерфейсе Yandex WebSQL к URL текущей страницы автоматически добавляются идентификаторы открытых сущностей Yandex WebSQL. Получившейся прямой ссылкой на кластер, подключение, БД, сохраненный запрос или запрос из истории в сервисе Yandex WebSQL можно поделиться с другими пользователями.

> Например, во время работы с сервисом Yandex WebSQL вы сохранили запрос и хотите поделиться им с другим пользователем. Для этого выберите нужный запрос в разделе ![image](../../_assets/console-icons/floppy-disk.svg) **Сохраненные запросы** и скопируйте URL из адресной строки.
> URL будет иметь вид:
> ```
> https://websql.yandex.cloud/folders/<идентификатор_вашего_каталога>/saved-queries/<идентификатор_сохраненного_запроса>`
> ```
> По этой ссылке другой пользователь сможет перейти на страницу с сохраненным запросом в сервисе Yandex WebSQL.

## Подключения {#connection}

В Yandex WebSQL вы можете создавать, использовать и контролировать подключения к БД. В разделе ![image](../../_assets/console-icons/folder-tree.svg) [**Подключения**](https://websql.yandex.cloud) можно работать со следующими типами подключений:
* [Подключения к кластерам Yandex Cloud](../operations/create-connection.md#connect-cluster) — подключения к БД в кластерах управляемых БД через внутреннюю сеть Yandex Cloud. Такие кластеры необязательно должны быть публично доступными.
* [Внешние подключения](../operations/create-connection.md#connect-db) — подключения к пользовательским инсталляциям БД через интернет.

В подразделе **Подключения Yandex Cloud** автоматически отображаются кластеры PostgreSQL, ClickHouse®, MySQL®, Redis/Valkey™, Yandex StoreDoc, Yandex Managed Service for Trino и Yandex MPP Analytics for PostgreSQL из текущего каталога, если у пользователя есть доступ к ним. В строке над разделом **Подключения** вы можете выбрать другой каталог. Список кластеров обновится автоматически.

Для каждого кластера все подключения к БД сгруппированы в раскрывающийся список под именем этого кластера. Изменить это имя в Yandex WebSQL нельзя, но вы можете изменить имя кластера в сервисе управляемых БД. Это изменение автоматически отразится в разделе ![image](../../_assets/console-icons/folder-tree.svg) [**Подключения**](https://websql.yandex.cloud).

Внешние подключения не группируются, даже если у хостов БД совпадают адреса.

Yandex WebSQL также поддерживает интеграцию с сервисом [Yandex MetaData Hub](../../metadata-hub/index.md) на уровне каталога пользователя. Созданные в Yandex WebSQL подключения автоматически появляются в Connection Manager сервиса Yandex MetaData Hub и наоборот.

Вы также можете [редактировать настройки подключения](../operations/change-connection-settings.md) и [удалять ненужные подключения](../operations/delete-connection.md). После подключения к БД вы сможете [просматривать схемы, таблицы и представления](../operations/view-db-objects-info.md) (`VIEW`). Таблицы и представления в рамках одного подключения объединяются в группы. Группировка представлений доступна, если в БД есть хотя бы одно представление.

## Запросы {#queries}

Для каждой БД можно выполнять запросы с использованием подсказок: начните вводить команду запроса и выберите подходящую из выпадающего списка. Вы также можете использовать готовые _шаблоны_ запросов или [сохранять свои запросы](../operations/templates.md#save-query) в виде [пользовательских шаблонов](#saved-queries).

С помощью [истории запросов](#query-log) можно [посмотреть](../operations/history.md), какие запросы вы выполняли ранее, и повторить их.

Подробнее о выполнении запросов в [инструкции](../operations/query-executor.md).

## Сохраненные запросы {#saved-queries}

_Сохраненный запрос_ — это запрос, сохраненный в качестве шаблона. Вы можете сохранить любой запрос. Он будет доступен в разделе ![image](../../_assets/console-icons/floppy-disk.svg) **Сохраненные запросы** на панели управления.

Подробнее о работе с сохраненными запросами в [инструкции](../operations/templates.md).

## Запросы из истории {#query-log}

_Запросы из истории_ — это запросы, выполненные в вашей [организации](../../organization/concepts/organization.md) Yandex Cloud в рамках текущей сессии подключения. Они отображаются в разделе ![image](../../_assets/console-icons/clock-arrow-rotate-left.svg) **История запросов**. Рядом с запросом отображается статус запроса:

* ![image](../../_assets/websql/success.svg) — запрос выполнен успешно;
* ![image](../../_assets/websql/error.svg) — запрос не удалось выполнить;
* ![image](../../_assets/websql/unknown.svg) — произошла непредвиденная ошибка на стороне Yandex WebSQL.

Подробнее о работе с запросами из истории в [инструкции](../operations/history.md).