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

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

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

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

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

SELECT * FROM postgresql_mdb_connection.my_table

где:

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

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

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

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

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

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

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

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

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

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

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

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

      • Сервисный аккаунт — выберите существующий сервисный аккаунт Managed Service for PostgreSQL или создайте новый с ролью managed-postgresql.viewer, от имени которого будет выполняться подключение к кластерам Managed Service for PostgreSQL.

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

      • База данных — выберите базу данных, которая будет использоваться при работе с кластером PostgreSQL.

      • Схема — укажите пространство имен, которое будет использоваться при работе с базой данных PostgreSQL.

      • Логин — имя пользователя, которое будет использоваться для подключения к базам данных PostgreSQL.

      • Пароль — пароль пользователя, который будет использоваться для подключения к базам данных PostgreSQL.

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

Сервисный аккаунт необходим для обнаружения точек подключения к кластерам Managed Service for PostgreSQL внутри Yandex Cloud, для работы с данными логин и пароль пользователя задаются отдельно.

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

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

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

где:

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

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

При работе с кластерами PostgreSQL существует ряд ограничений.

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

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

2. В YQ используется система типов Yandex Managed Service for YDB. Однако диапазоны допустимых значений для типов, использующихся в YDB при работе с датой и временем (Date, Datetime, Timestamp), зачастую оказываются недостаточно широкими для того, чтобы вместить значения соответствующих типов PostgreSQL (date, timestamp).
   В связи с этим значения даты и времени, прочитанные из PostgreSQL, возвращаются YQ как обычные строки (тип Optional<Utf8>) в формате ISO-8601.

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

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

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

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

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

В базе данных PostgreSQL признак опциональности значений колонки (разрешено или запрещено колонке содержать значения NULL) не является частью системы типов. Ограничение (constraint) NOT NULL для каждой колонки реализуется в виде атрибута attnotnull в системном каталоге pg_attribute, то есть на уровне метаданных таблицы. Следовательно, все базовые типы PostgreSQL по умолчанию могут содержать значения NULL, и в системе типов YQ они должны отображаться в опциональные типы.

Ниже приведена таблица соответствия типов PostgreSQL и Yandex Query. Все остальные типы данных, за исключением перечисленных, не поддерживаются.