Создание подключения PXF к Managed ArenadataDB

Перед началом работы

1. Создайте публичный SNAT-шлюз в той зоне доступности, в которой собираетесь создавать инстанс.

2. Создайте подсеть.

   В этой подсети создайте DNS-серверы с адресами:

   1. 8.8.8.8

   2. 8.8.4.4

   3. 77.88.8.8

3. Создайте лог-группу.

4. Создайте группу безопасности для инстанса Managed ArenadataDB.

5. В группе безопасности инстанса Managed ArenadataDB создайте правила входящего трафика. Укажите следующие значения параметров:

   Правило	Протокол	Порт	Тип источника	Источник
   Для подсети инстанса Managed ArenadataDB.	Любой	—	IP-адрес	Подсеть инстанса Managed ArenadataDB
   Для интерфейса ArenadataDB.	TCP	5432	IP-адрес	Подсеть инстанса Managed ArenadataDB
   Для интерфейсов ArenadataDB Control и Arenadata Cluster Manager.	TCP	443	IP-адрес	Подсеть инстанса Managed ArenadataDB

6. В группе безопасности инстанса Managed ArenadataDB создайте правила исходящего трафика. Укажите следующие значения параметров:

   Правило	Протокол	Тип адресата	Адресат
   Для трафика на любые адреса в интернете. В целях безопасности это правило можно отключить после завершения создания инстанса.	Любой	—	0.0.0.0/0
   Для трафика в пределах инстанса.	Любой	IP-адрес	Подсеть инстанса Managed ArenadataDB

7. (Опционально) Создайте бакет Object Storage для хранения файлов резервного копирования. Бакет должен иметь глобальное название.

8. Установите клиент для подключения к базам данных по протоколу JDBC, например DBeaver.

1. Подготовьте данные

На этом шаге вы загрузите файл с данными в Object Storage.

1. Создайте бакет Object Storage с названием adb-lab-files.

2. Подготовьте файл с данными adb-data.txt:

   id, email
   1, xxx@example.com
   2, yyy@example.com
   3, zzz@example.com
   
   

3. Загрузите файл в бакет adb-lab-files.

2. Создайте инстанс Managed ArenadataDB

На этом шаге вы создадите инстанс Managed ArenadataDB.

1. Перейдите в раздел Evolution и выберите сервис Managed ArenadataDB.

2. В блоке Общие параметры заполните поля:

   • Название — adb-lab.

   • Тип лицензии — Test.

   • Версия ArenadataDB — 6.27.1.59.

   • Объем исходных данных, ТБ — 1 ТБ.

3. Нажмите Продолжить.

4. В блоке Сетевые настройки выберите:

   • VPC — виртуальную сеть.

   • Зона доступности — зону доступности.

   • sNAT-шлюз — созданный шлюз.

   • Подсеть — подсеть c созданными DNS-серверами.

   • Группа безопасности — созданную группу безопасности с разрешающими правилами.

5. Нажмите Продолжить.

6. В блоке Логирование выберите:

   • Лог-группа — группу логов с созданными ранее DNS-серверами.

   • Сервисный аккаунт — сервисный аккаунт с ролью logaas.writer.

7. Нажмите Создать.

Инстанс Managed ArenadataDB отобразится на странице сервиса. Создание может занять от 40 минут.

3. Подготовьте ключи доступа

На этом шаге вы подготовите ключи доступа для дальнейшей настройки подключения.

1. Перейдите в раздел Пользователи на вкладку Сервисные аккаунты.

2. Нажмите на название аккаунта, у которого есть роль с доступом к сервису Object Storage. Если такого аккаунта нет, создайте его.

3. В блоке Учетные данные доступа откройте вкладку Ключи доступа.

4. Нажмите Создать ключ.

5. Введите краткое описание ключа.

6. Задайте время жизни ключа или выберите вариант Бессрочно. Бессрочные ключи менее безопасны. Рекомендуем выбирать ограничение по периоду действия или обновлять ключи самостоятельно не менее одного раза в год.

7. Нажмите Создать. Сервис сгенерирует Key ID (логин) и Key Secret (пароль). Скопируйте и сохраните эти значения. После того как вы закроете это окно, посмотреть их будет нельзя.

4. Получите логин и пароль

На этом шаге вы подготовите данные для аутентификации.

Для продолжения работы убедитесь, что статус инстанса Managed ArenadataDB изменился на «Готов».

1. Откройте карточку инстанса Managed ArenadataDB.

2. На вкладке Доступы в блоке Доступ к ADB нажмите Получить логин и пароль.

3. Cохраните логин и пароль.

   Внимание

   Логин и пароль отображаются один раз.

   В целях безопасности рекомендуется изменить пароль.

4. Нажмите Принято.

5. Создайте подключение PXF

На этом шаге вы настроите подключение PXF к инстансу Managed ArenadataDB.

1. Откройте карточку инстанса Managed ArenadataDB.

2. На панели слева выберите Подключения PXF.

3. Нажмите Добавить подключение.

4. Введите название подключения, например adb-lab-connection.

5. В поле Выбор коннектора выберите S3.

6. В поле Регион введите ru-central-1.

7. В поле Key ID введите идентификатор ключа доступа к бакету S3 в формате <tenant_id>:<key_id>, где:

   • <tenant_id> — идентификатор тенанта, указанный в разделе Хранение данных → Object Storage → Параметры работы с API.

   • <key_id> — Key ID (логин), сгенерированный при создании ключа доступа для сервисного аккаунта.

8. В поле Key Secret введите Key Secret (пароль), сгенерированный при создании ключа доступа для сервисного аккаунта.

9. В поле Эндпоинт введите s3.cloud.ru.

10. Включите опцию Быстрая выгрузка.

11. Нажмите Добавить.

6. Подключите инстанс Managed ArenadataDB к DBeaver

На этом шаге вы установите внешнее подключение с помощью JDBC-клиента.

1. Откройте карточку инстанса Managed ArenadataDB.

2. На панели слева выберите Доступы.

3. Запустите DBeaver.

4. В панели сверху нажмите База данных → Новое соединение.

5. В списке соединений выберите Greenplum.

6. На вкладке Главное введите:

   • Хост — публичный хост из карточки инстанса Managed ArenadataDB;

   • База данных — adb-lab;

   • Пользователь — сохраненный ранее логин;

   • Пароль — сохраненный ранее пароль.

7. Нажмите Готово.

8. Выполните запрос:

   CREATE EXTERNAL TABLE pxf_ext_tbl(name text, orders int)
    LOCATION ('pxf://adb-lab-files/adb-data.txt>?PROFILE=s3:text&SERVER=adb-lab-connection')
    FORMAT 'TEXT' (delimiter=',');
   
   

При успешной установке подключения в интерфейсе DBeaver появится таблица с данными, ранее загруженными в бакет Object Storage.

Результат

Вы научились устанавливать подключение PXF к инстансам Managed ArenadataDB.