Облачная платформаEvolution

Примеры кода для подключения к базе данных

Эта статья полезна?

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

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

  • В списке кластеров Managed PostgreSQL® напротив названия кластера нажмите Горизонтальное меню и выберите Подключиться к базе данных.

  • На странице кластера в разделе Информация нажмите Вертикальное меню и выберите Подключиться к базе данных.

В открывшемся окне выберите язык приложения и проверьте предзаполненные поля Пользователь, База данных и Внутренний IP.

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

Убедитесь, что:

  • кластер Managed PostgreSQL® находится в статусе «Доступен»;

  • виртуальная машина с ОС семейства Linux имеет сетевой доступ к кластеру.

Для подключения понадобятся данные кластера:

  • Внутренний IP-адрес — внутренний IP-адрес узла кластера.

  • Порт — порт для подключения к серверу PostgreSQL®.

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

  • Имя пользователя — по умолчанию используется dbadmin.

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

IP-адрес, порт, а также имя и пароль пользователя предустановленной базы данных можно найти на странице информации кластера в блоке Подключение к дефолтной базе данных. Информация о других базах данных доступна в разделе Базы данных, о пользователях — в разделе Пользователи.

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


Для подключения из Python используется библиотека psycopg2.

  1. Установите Python и библиотеку psycopg2-binary:

    sudo apt update
    sudo apt install -y python3 python3-pip
    pip3 install psycopg2-binary
  2. Сохраните строку подключения в переменную окружения:

    export CONN_STRING="\
    host=<ip_address> \
    port=<port> \
    dbname=<database_name> \
    user=<database_user_name> \
    password=<password>"

    Где:

    • <ip_address> — внутренний IP-адрес кластера Managed PostgreSQL®.

    • <port> — порт.

    • <database_name> — название базы данных.

    • <database_user_name> — имя пользователя базы данных.

    • <password> — пароль пользователя базы данных.

  3. Создайте файл connect.py:

    import psycopg2
    import os
    conn_string = os.environ.get("CONN_STRING")
    conn = None
    try:
    conn = psycopg2.connect(conn_string)
    cur = conn.cursor()
    cur.execute('SELECT version();')
    print(cur.fetchone()[0])
    cur.close()
    except Exception as e:
    print(f"Ошибка подключения: {e}")
    raise
    finally:
    if conn:
    conn.close()
  4. Запустите приложение:

    python3 connect.py

    Пример вывода:

    PostgreSQL 18.3 (Debian 18.3-1.pgdg13+1) on x86_64-pc-linux-gnu, compiled by gcc (Debian 14.2.0-19) 14.2.0, 64-bit