Подключение к базе данных

Благодаря тому, что СУБД Greenplum® основана на PostgreSQL, для подключения к обеим СУБД используются одни и те же инструменты.

Подключение к кластеру Managed Service for Greenplum® производится только через первичный хост-мастер. Чтобы определить роли хостов, получите список хостов в кластере.

К кластеру можно подключиться:

• С виртуальных машин Yandex Cloud, расположенных в той же облачной сети.

• Через интернет, если вы настроили публичный доступ для кластера.

Если настроен публичный доступ к кластеру, подключение возможно только с использованием SSL-соединения. В противном случае использовать SSL необязательно.

Без SSL-соединения трафик внутри облачной сети не шифруется.

Настройка групп безопасностиНастройка групп безопасности

Кластеру Managed Service for Greenplum® может быть назначена одна или несколько групп безопасности. Для подключения к кластеру необходимо, чтобы группы безопасности содержали правила, разрешающие входящий трафик на порт 6432 с определенных IP-адресов или из других групп безопасности.

Настройки правил будут различаться в зависимости от выбранного способа подключения:

Автоматический выбор первичного мастераАвтоматический выбор первичного мастера

Чтобы выбирать хост для подключения к кластеру автоматически, используйте особый FQDN первичного мастера.

Получение SSL-сертификатаПолучение SSL-сертификата

Чтобы использовать SSL-соединение, получите сертификат:

mkdir -p ~/.postgresql && \
wget "https://storage.yandexcloud.net/cloud-certs/CA.pem" \
     --output-document ~/.postgresql/root.crt && \
chmod 0655 ~/.postgresql/root.crt

mkdir $HOME\.postgresql; curl.exe -o $HOME\.postgresql\root.crt https://storage.yandexcloud.net/cloud-certs/CA.pem

Для использования графических IDE сохраните сертификат в локальную папку и укажите путь к нему в настройках подключения.

FQDN хоста Greenplum®FQDN хоста Greenplum®

Для подключения к хосту-мастеру потребуется его FQDN — доменное имя. Его можно получить несколькими способами:

• Запросите список хостов в кластере.

• Скопируйте команду для подключения к кластеру в консоли управления. Команда содержит список FQDN хостов-мастеров. Чтобы получить команду, перейдите на страницу кластера и нажмите кнопку Подключиться.

• Посмотрите FQDN в консоли управления:

  1. Перейдите на страницу кластера.
  2. Перейдите в раздел Хосты.
  3. Скопируйте значение в столбце FQDN хоста.

Для первичного хоста-мастера также используется особый FQDN.

Особый FQDN первичного мастераОсобый FQDN первичного мастера

Чтобы вручную не подключаться к другому хосту-мастеру, если текущий станет недоступен, можно использовать особый FQDN вида c-<идентификатор_кластера>.rw.mdb.yandexcloud.net. Он всегда указывает на первичный хост-мастер. К этому FQDN разрешено подключаться и выполнять операции чтения и записи.

Пример подключения к первичному хосту-мастеру в кластере с идентификатором c9qash3nb1v9********:

psql "host=c-c9qash3nb1v9********.rw.mdb.yandexcloud.net \
      port=6432 \
      sslmode=verify-full \
      dbname=<имя_БД> \
      user=<имя_пользователя>"

Подключение из графических IDEПодключение из графических IDE

Подключения проверялись в следующем окружении:

• Ubuntu 20.04, DBeaver: 22.2.4;
• MacOS Monterey 12.7:
  • JetBrains DataGrip: 2023.3.4;
  • DBeaver Community: 24.0.0.

Подключаться из графических IDE можно только к кластеру в публичном доступе с использованием SSL-сертификата.

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

Подключение из pgAdmin 4Подключение из pgAdmin 4

Подключение проверялось для pgAdmin 4 версии 7.1 в macOS Ventura 13.0 и Microsoft Windows 10 Pro 21H1.

Подключаться из pgAdmin 4 можно только к хостам кластера в публичном доступе с использованием SSL-сертификата.

Создайте новое подключение к серверу:

1. Выберите в меню Object → Register → Server...

2. На вкладке General в поле Name укажите имя, под которым кластер будет отображаться в интерфейсе pgAdmin 4. Имя может быть любым.

3. На вкладке Connection укажите параметры подключения:

   • Host name/address — особый FQDN хоста-мастера или обычный FQDN хоста;
   • Port — 6432;
   • Maintenance database — имя служебной базы данных postgres;
   • Username — имя пользователя, от имени которого выполняется подключение;
   • Password — пароль пользователя.

4. На вкладке Parameters:

   • Установите параметр SSL mode в значение verify-full.
   • Добавьте новый параметр Root certificate и укажите в нем путь к сохраненному файлу SSL-сертификата.

5. Нажмите кнопку Save, чтобы сохранить настройки подключения к серверу.

Кластер появится в списке серверов в навигационном меню.

Для наблюдения за состоянием кластера рекомендуется использовать сервис Yandex Monitoring вместо вкладки Dashboard в pgAdmin 4, потому что в ней может возникать ошибка:

column "wait_event_type" does not exist LINE 10: wait_event_type || ': ' || wait_event AS wait_event, ^

При работе с другими вкладками в pgAdmin 4 эта ошибка не возникает.

Подготовка к подключению из Docker-контейнераПодготовка к подключению из Docker-контейнера

Чтобы подключаться к кластеру Managed Service for Greenplum® из Docker-контейнера, добавьте в Dockerfile строки:

RUN apt-get update && \
    apt-get install postgresql-client --yes

RUN apt-get update && \
    apt-get install wget postgresql-client --yes && \
    mkdir --parents ~/.postgresql && \
    wget "https://storage.yandexcloud.net/cloud-certs/CA.pem" \
         --output-document ~/.postgresql/root.crt && \
    chmod 0655 ~/.postgresql/root.crt

Примеры строк подключенияПримеры строк подключения

Примеры проверялись в следующем окружении:

• Виртуальная машина в Yandex Cloud с Ubuntu 20.04 LTS:
  • Bash: 5.0.16.
• Виртуальная машина в Yandex Cloud с Windows Server 2019 Datacenter:
  • PostgreSQL: 13.
  • PowerShell: 5.1.17763.1490 Desktop.

При создании кластера Greenplum® пользовательская база данных не создается. Для проверки подключения используйте служебную базу postgres.

Для подключения к кластеру с публичным доступом подготовьте SSL-сертификат. В примерах предполагается, что SSL-сертификат root.crt расположен в директории:

• /home/<домашняя_директория>/.postgresql/ для Ubuntu;
• $HOME\AppData\Roaming\postgresql для Windows.

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

Примеры кода с заполненным FQDN хоста доступны в консоли управления по нажатию кнопки Подключиться на странице кластера.

BashBash

Перед подключением установите зависимости:

sudo apt update && sudo apt install --yes postgresql-client

Подключитесь к базе данных:

psql "host=c-<идентификатор_кластера>.rw.mdb.yandexcloud.net \
      port=6432 \
      sslmode=disable \
      dbname=postgres \
      user=<имя_пользователя> \
      target_session_attrs=read-write"

psql "host=c-<идентификатор_кластера>.rw.mdb.yandexcloud.net \
      port=6432 \
      sslmode=verify-full \
      dbname=postgres \
      user=<имя_пользователя> \
      target_session_attrs=read-write"

После выполнения команды введите пароль пользователя для завершения процедуры подключения.

Для проверки успешности подключения выполните запрос:

SELECT version();

C# EF CoreC# EF Core

Необходимые пакеты:

• Microsoft.EntityFrameworkCore
• Npgsql.EntityFrameworkCore.PostgreSQL

using System;
using System.Threading.Tasks;
using Microsoft.EntityFrameworkCore;

namespace ConsoleApp
{
    public class VersionString
    {
        public int id { get; set; }
        public string versionString { get; set; }
    }
    public class ApplicationContext : DbContext
    {
        public ApplicationContext()
        {
            Database.EnsureCreated();
        }
        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        {
            var host      = "c-<идентификатор_кластера>.rw.mdb.yandexcloud.net";
            var port      = "6432";
            var db        = "postgres";
            var username  = "<имя_пользователя>";
            var password  = "<пароль_пользователя>";
            optionsBuilder.UseNpgsql($"Host={host};Port={port};Database={db};Username={username};Password={password};Ssl Mode=Require;Trust Server Certificate=true;");
        }
        public DbSet<VersionString> VersionStrings { get; set; }

    }
    class Program
    {
        static async Task Main(string[] args)
        {
            using (ApplicationContext db = new ApplicationContext())
            {
                var versionStrings = await db.VersionStrings.FromSqlRaw(@"select 1 as id,version() as versionString;").ToListAsync();
                Console.WriteLine(versionStrings[0].versionString);
            }
        }
    }
}

GoGo

Перед подключением установите зависимости:

sudo apt update && sudo apt install --yes golang git && \
go mod init example && go get github.com/jackc/pgx/v4

JavaJava

Перед подключением:

1. Установите зависимости:

   sudo apt update && sudo apt install --yes default-jdk maven
   

2. Создайте директорию для проекта Maven:

   cd ~/ && mkdir --parents project/src/java/com/example && cd project/
   

3. Создайте конфигурационный файл для Maven:

   pom.xml

   <?xml version="1.0" encoding="utf-8"?>
   <project xmlns="http://maven.apache.org/POM/4.0.0"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
   
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.example</groupId>
     <artifactId>app</artifactId>
     <packaging>jar</packaging>
     <version>0.1.0</version>
     <properties>
       <maven.compiler.source>1.8</maven.compiler.source>
       <maven.compiler.target>1.8</maven.compiler.target>
     </properties>
     <dependencies>
       <dependency>
         <groupId>org.postgresql</groupId>
         <artifactId>postgresql</artifactId>
         <version>42.2.16</version>
       </dependency>
     </dependencies>
     <build>
       <finalName>${project.artifactId}-${project.version}</finalName>
       <sourceDirectory>src</sourceDirectory>
       <resources>
         <resource>
           <directory>src</directory>
         </resource>
       </resources>
       <plugins>
         <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-assembly-plugin</artifactId>
           <executions>
             <execution>
               <goals>
                 <goal>attached</goal>
               </goals>
               <phase>package</phase>
               <configuration>
                 <descriptorRefs>
                   <descriptorRef>
                   jar-with-dependencies</descriptorRef>
                 </descriptorRefs>
                 <archive>
                   <manifest>
                     <mainClass>com.example.App</mainClass>
                   </manifest>
                 </archive>
               </configuration>
             </execution>
           </executions>
         </plugin>
         <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-jar-plugin</artifactId>
           <version>3.1.0</version>
           <configuration>
             <archive>
               <manifest>
                 <mainClass>com.example.App</mainClass>
               </manifest>
             </archive>
           </configuration>
         </plugin>
       </plugins>
     </build>
   </project>
   

   Актуальную версию postgresql уточняйте на странице проекта в репозитории Maven.

Node.jsNode.js

Перед подключением установите зависимости:

sudo apt update && sudo apt install --yes nodejs npm && \
npm install pg

"use strict";
const pg = require("pg");

const config = {
    connectionString:
        "postgres://<имя_пользователя>:<пароль_пользователя>@c-<идентификатор_кластера>.rw.mdb.yandexcloud.net:6432/postgres"
};

const conn = new pg.Client(config);

conn.connect((err) => {
    if (err) throw err;
});
conn.query("SELECT version()", (err, q) => {
    if (err) throw err;
    console.log(q.rows[0]);
    conn.end();
});

"use strict";
const fs = require("fs");
const pg = require("pg");

const config = {
    connectionString:
        "postgres://<имя_пользователя>:<пароль_пользователя>@c-<идентификатор_кластера>.rw.mdb.yandexcloud.net:6432/postgres",
    ssl: {
        rejectUnauthorized: true,
        ca: fs
            .readFileSync("/home/<домашняя_директория>/.postgresql/root.crt")
            .toString(),
    },
};

const conn = new pg.Client(config);

conn.connect((err) => {
    if (err) throw err;
});
conn.query("SELECT version()", (err, q) => {
    if (err) throw err;
    console.log(q.rows[0]);
    conn.end();
});

Подключение:

node app.js

ODBCODBC

Перед подключением установите зависимости:

sudo apt update && sudo apt install --yes unixodbc odbc-postgresql

Драйвер PostgreSQL ODBC будет автоматически зарегистрирован в файле /etc/odbcinst.ini.

PHPPHP

Перед подключением установите зависимости:

sudo apt update && sudo apt install --yes php php-pgsql

PowerShellPowerShell

Перед подключением установите PostgreSQL для Windows актуальной версии. Выберите только установку Command Line Tools.

Подключитесь к базе данных:

& "C:\Program Files\PostgreSQL\<версия>\bin\psql.exe" "`
    host=c-<идентификатор_кластера>.rw.mdb.yandexcloud.net `
    port=6432 `
    sslmode=disable `
    dbname=postgres `
    user=<имя_пользователя>"

& "C:\Program Files\PostgreSQL\<версия>\bin\psql.exe" "`
    host=c-<идентификатор_кластера>.rw.mdb.yandexcloud.net `
    port=6432 `
    sslmode=verify-full `
    dbname=postgres `
    user=<имя_пользователя>"

После выполнения команды введите пароль пользователя для завершения процедуры подключения.

Для проверки успешности подключения выполните запрос:

SELECT version();

PythonPython

Перед подключением установите зависимости:

sudo apt update && sudo apt install --yes python3 python3-pip && \
pip3 install psycopg2-binary

RubyRuby

Перед подключением установите зависимости:

sudo apt update && sudo apt install --yes ruby ruby-pg

Greenplum® и Greenplum Database® являются зарегистрированными товарными знаками или товарными знаками VMware, Inc в США и/или других странах.