Работа с базами данных Managed Service for YDB

В этом разделе описана основная информация про работу с Managed Service for YDB.

Для работы с базой данных Managed Service for YDB из Yandex Query необходимо выполнить следующие шаги:

1. Создать соединение, содержащее реквизиты для подключения к базе данных.
2. Выполнить запрос к базе данных.

Пример запроса, выполняющего чтение данных из Managed Service for YDB:

SELECT * FROM ydb_connection.my_table

где:

• ydb_connection — название созданного соединения с базой данных.
• my_table — имя таблицы в базе данных.

Настройка соединенияНастройка соединения

Чтобы создать соединение с Managed Service for YDB:

1. В консоли управления выберите каталог, в котором нужно создать соединение.

2. В списке сервисов выберите Yandex Query.

3. На панели слева перейдите на вкладку Соединения.

4. Нажмите кнопку Создать.

5. Укажите параметры соединения:

   1. В блоке Общие параметры:

      • Имя — название соединения с Managed Service for YDB.
      • Тип — Managed Service for YDB.

   2. В блоке Параметры типа соединения:

      • Кластер — выберите существующую базу данных Managed Service for YDB или создайте новую.

      • Сервисный аккаунт — выберите сервисный аккаунт Managed Service for YDB, от имени которого будет выполняться подключение к кластерам Managed Service for YDB и аутентификация в базе данных. Если сервисного аккаунта нет, создайте его и назначьте ему роль ydb.viewer.

        Чтобы использовать сервисный аккаунт, пользователю нужна роль iam.serviceAccounts.user.

6. Нажмите кнопку Создать.

Синтаксис запросовСинтаксис запросов

Для работы с Managed Service for YDB используется следующая форма SQL-запроса:

SELECT * FROM <соединение>.<имя_таблицы>

где:

• <соединение> — название созданного соединения с базой данных.
• <имя_таблицы> — имя таблицы в базе данных.

ОграниченияОграничения

Внешние источники доступны только для чтения данных через запросы SELECT. Запросы, модифицирующие таблицы во внешних источниках, сервисом Yandex Query в настоящее время не поддерживаются.

Пушдаун фильтровПушдаун фильтров

Yandex Query умеет передавать обработку частей запросов в систему-источник данных. Это означает, что фильтрующие выражения передаются сквозь Yandex Query непосредственно в базу данных для обработки, обычно это условия запросов, указанных в WHERE. Такой способ обработки называется пушдаун фильтров.

Пушдаун фильтров возможен при использовании:

Поддерживаемые типы данных для пушдауна фильтров:

Поддерживаемые типы данныхПоддерживаемые типы данных

Ниже приведены таблицы соответствия типов данных в Managed Service for YDB и Yandex Query. Типы данных, не указанные в таблицах, не поддерживаются.

Примитивные типы данныхПримитивные типы данных

Опциональные типы данныхОпциональные типы данных