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

1. В веб-консоли выберите нужный проект.

2. В списке сервисов выберите Managed PostgreSQL.

3. Нажмите на имя нужного кластера.

4. Перейдите на вкладку Сети.

5. Скопируйте внутренний IPv4-адрес нужного эндпоинта, в зависимости от типа подключения:

   • Подключение к кластеру — подключение через эндпоинт кластера. Выберите нужный эндпоинт:

     • Primary — если подключаетесь для записи и чтения;
     • ReadOnly — если подключаетесь только для чтения.

   • Подключение к узлам — подключение к конкретному узлу кластера.

   Сохраните внутренний IPv4-адрес эндпоинта из соответствующего блока.

6. Перейдите на вкладку Базы данных.

7. Нажмите на имя нужной БД.

8. Найдите идентификатор БД вида .../<имя базы данных>. Сохраните имя базы данных.

9. Перейдите на вкладку Пользователи.

10. В списке пользователей найдите и сохраните имя нужного пользователя.

11. Убедитесь, что у вас есть ВМ в сервисе Compute, подключенная к одной сети с кластером. Если нет, создайте ее.

12. Подключитесь к ВМ по SSH.

13. Скачайте по прямой ссылке сертификат шифрования. Он сохранится в файле с именем mws-root-ca.crt.

14. Установите утилиту psql:

    1
    sudo apt install postgresql-client-common

15. Выполните команду:

    1
    psql "
    2
      host=<внутренний IPv4-адрес эндпоинта кластера или узла>
    3
      dbname=<имя базы данных БД>
    4
      user=<имя пользователя>
    5
      sslmode=verify-ca
    6
      sslrootcert=<путь до сертификата>/mws-root-ca.crt
    7
    "

16. Введите пароль пользователя.

При успешном подключении будет выведено имя БД и приглашение к вводу.

1. Если у вас нет утилиты MWS CLI:

   1. Установите утилиту.

   2. Инициализируйте профиль.

2. Узнайте имя кластера, в котором развернута база данных:

   1
   mws mpostgres cluster list

3. Получите информацию о кластере:

   1
   mws mpostgres cluster get <имя кластера>

4. Найдите и сохраните внутренний IPv4-адрес эндпоинта, к которому будете подключаться. Нужный параметр зависит от того, к какому объекту вы подключаетесь:

   • к кластеру:

     • status.network.primaryAddresses.ip — если подключаетесь к primary-эндпоинту для записи и чтения;
     • status.network.readOnlyAddresses.ip — если подключаетесь к readOnly-эндпоинту только для чтения.
   • к конкретному узлу — status.network.directAddresses.ip.

5. Получите список баз данных кластера:

   1
   mws mpostgres database list --cluster <имя кластера>

6. Найдите имя нужной БД в столбце NAME и сохраните его.

7. Получите список пользователей кластера:

   1
   mws mpostgres user list --cluster <имя кластера>

8. Найдите имя нужного пользователя в столбце NAME и сохраните его.

9. Убедитесь, что у вас есть ВМ в сервисе Compute, подключенная к одной сети с кластером. Если нет, создайте ее.

10. Подключитесь к ВМ по SSH.

11. Скачайте по прямой ссылке сертификат шифрования. Он сохранится в файле с именем mws-root-ca.crt.

12. Установите утилиту psql:

    1
    sudo apt install postgresql-client-common

13. Выполните команду:

    1
    psql "
    2
      host=<внутренний IPv4-адрес эндпоинта кластера или узла>
    3
      dbname=<имя базы данных БД>
    4
      user=<имя пользователя>
    5
      sslmode=verify-ca
    6
      sslrootcert=<путь до сертификата>/mws-root-ca.crt
    7
    "

14. Введите пароль пользователя.

При успешном подключении будет выведено имя БД и приглашение к вводу.

1. Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

2. Узнайте имя кластера, в котором развернута база данных:

   1
   curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
   2
     -H "Authorization: Bearer <IAM-токен>"

3. Получите информацию о кластере:

   1
   curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера> \
   2
     -H "Authorization: Bearer <IAM-токен>"

4. Найдите и сохраните внутренний IPv4-адрес эндпоинта, к которому будете подключаться. Нужный параметр зависит от того, к какому объекту вы подключаетесь:

   • к кластеру:

     • status.network.primaryAddresses.ip — если подключаетесь к primary-эндпоинту для записи и чтения;
     • status.network.readOnlyAddresses.ip — если подключаетесь к readOnly-эндпоинту только для чтения.
   • к конкретному узлу — status.network.directAddresses.ip.

5. Получите список баз данных кластера:

   1
   curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>/databases \
   2
     -H "Authorization: Bearer <IAM-токен>"

6. Найдите значение параметра id вида mpostgres/projects/<имя проекта>/clusters/<имя кластера>/databases/<имя базы данных> для нужной БД.

   Сохраните имя базы данных.

7. Получите список пользователей кластера:

   1
   curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>/users \
   2
     -H "Authorization: Bearer <IAM-токен>"

8. Найдите значение параметра id вида mpostgres/projects/<имя проекта>/clusters/<имя кластера>/users/<имя пользователя> для нужного пользователя.

   Сохраните имя пользователя.

9. Убедитесь, что у вас есть ВМ в сервисе Compute, подключенная к одной сети с кластером. Если нет, создайте ее.

10. Подключитесь к ВМ по SSH.

11. Скачайте по прямой ссылке сертификат шифрования. Он сохранится в файле с именем mws-root-ca.crt.

12. Установите утилиту psql:

    1
    sudo apt install postgresql-client-common

13. Выполните команду:

    1
    psql "
    2
      host=<внутренний IPv4-адрес эндпоинта кластера или узла>
    3
      dbname=<имя базы данных БД>
    4
      user=<имя пользователя>
    5
      sslmode=verify-ca
    6
      sslrootcert=<путь до сертификата>/mws-root-ca.crt
    7
    "

14. Введите пароль пользователя.

При успешном подключении будет выведено имя БД и приглашение к вводу.

1. В веб-консоли выберите нужный проект.

2. Для сети, к которой подключен кластер, добавьте правило файрвола для входящего трафика:

   • источник трафика — IP-адрес клиента;
   • назначение трафика — внутренний IP-адрес эндпоинта;
   • протокол и порт — TCP:5432.

3. В списке сервисов выберите Managed PostgreSQL.

4. Нажмите на имя нужного кластера.

5. Перейдите на вкладку Сети.

6. Скопируйте внешний IPv4-адрес нужного эндпоинта, в зависимости от типа подключения:

   • Подключение к кластеру — подключение через эндпоинт кластера. Выберите нужный эндпоинт:

     • Primary — если подключаетесь для записи и чтения;
     • ReadOnly — если подключаетесь только для чтения.

   • Подключение к узлам — подключение к конкретному узлу кластера.

   Сохраните внешний IPv4-адрес эндпоинта из соответствующего блока.

7. Перейдите на вкладку Базы данных.

8. Нажмите на имя нужной БД.

9. Найдите идентификатор БД вида .../<имя базы данных>. Сохраните имя базы данных.

10. Перейдите на вкладку Пользователи.

11. В списке пользователей найдите и сохраните имя нужного пользователя.

12. Скачайте по прямой ссылке сертификат шифрования. Он сохранится в файле с именем mws-root-ca.crt.

13. Установите утилиту psql:

    1
    sudo apt install postgresql-client-common

14. Выполните команду:

    1
    psql "
    2
      host=<внешний IPv4-адрес эндпоинта кластера или узла>
    3
      dbname=<имя базы данных БД>
    4
      user=<имя пользователя>
    5
      sslmode=verify-ca
    6
      sslrootcert=<путь до сертификата>/mws-root-ca.crt
    7
    "

15. Введите пароль пользователя.

При успешном подключении будет выведено имя БД и приглашение к вводу.

1. Если у вас нет утилиты MWS CLI:

   1. Установите утилиту.

   2. Инициализируйте профиль.

2. Для сети, к которой подключен кластер, добавьте правило файрвола для входящего трафика:

   • источник трафика — IP-адрес клиента;
   • назначение трафика — внутренний IP-адрес эндпоинта;
   • протокол и порт — TCP:5432.

3. Узнайте имя кластера, в котором развернута база данных:

   1
   mws mpostgres cluster list

4. Получите информацию о кластере:

   1
   mws mpostgres cluster get <имя кластера>

5. Найдите и сохраните внешний IPv4-адрес эндпоинта, к которому будете подключаться. Нужный параметр зависит от того, к какому объекту вы подключаетесь:

   • к кластеру:

     • status.network.primaryAddresses.external.ip — если подключаетесь к primary-эндпоинту для записи и чтения;
     • status.network.readOnlyAddresses.external.ip — если подключаетесь к readOnly-эндпоинту только для чтения.
   • к конкретному узлу — status.network.directAddresses.external.ip.

6. Получите список баз данных кластера:

   1
   mws mpostgres database list --cluster <имя кластера>

7. Найдите имя нужной БД в столбце NAME и сохраните его.

8. Получите список пользователей кластера:

   1
   mws mpostgres user list --cluster <имя кластера>

9. Найдите имя нужного пользователя в столбце NAME и сохраните его.

10. Скачайте по прямой ссылке сертификат шифрования. Он сохранится в файле с именем mws-root-ca.crt.

11. Установите утилиту psql:

    1
    sudo apt install postgresql-client-common

12. Выполните команду:

    1
    psql "
    2
      host=<внешний IPv4-адрес эндпоинта кластера или узла>
    3
      dbname=<имя базы данных БД>
    4
      user=<имя пользователя>
    5
      sslmode=verify-ca
    6
      sslrootcert=<путь до сертификата>/mws-root-ca.crt
    7
    "

13. Введите пароль пользователя.

При успешном подключении будет выведено имя БД и приглашение к вводу.

1. Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.
2. Для сети, к которой подключен кластер, добавьте правило файрвола для входящего трафика:

• источник трафика — IP-адрес клиента;
• назначение трафика — внутренний IP-адрес эндпоинта;
• протокол и порт — TCP:5432.

1. Узнайте имя кластера, в котором развернута база данных:

   1
   curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters \
   2
     -H "Authorization: Bearer <IAM-токен>"

2. Получите информацию о кластере:

   1
   curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера> \
   2
     -H "Authorization: Bearer <IAM-токен>"

3. Найдите и сохраните внешний IPv4-адрес эндпоинта, к которому будете подключаться. Нужный параметр зависит от того, к какому объекту вы подключаетесь:

   • к кластеру:

     • status.network.primaryAddresses.external.ip — если подключаетесь к primary-эндпоинту для записи и чтения;
     • status.network.readOnlyAddresses.external.ip — если подключаетесь к readOnly-эндпоинту только для чтения.
   • к конкретному узлу — status.network.directAddresses.external.ip.

4. Получите список баз данных кластера:

   1
   curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>/databases \
   2
     -H "Authorization: Bearer <IAM-токен>"

5. Найдите значение параметра id вида mpostgres/projects/<имя проекта>/clusters/<имя кластера>/databases/<имя базы данных> для нужной БД.

   Сохраните имя базы данных.

6. Получите список пользователей кластера:

   1
   curl -X GET https://mpostgres.mwsapis.ru/mpostgres/v1/projects/<имя проекта>/clusters/<имя кластера>/users \
   2
     -H "Authorization: Bearer <IAM-токен>"

7. Найдите значение параметра id вида mpostgres/projects/<имя проекта>/clusters/<имя кластера>/users/<имя пользователя> для нужного пользователя.

   Сохраните имя пользователя.

8. Скачайте по прямой ссылке сертификат шифрования. Он сохранится в файле с именем mws-root-ca.crt.

9. Установите утилиту psql:

   1
   sudo apt install postgresql-client-common

10. Выполните команду:

    1
    psql "
    2
      host=<внешний IPv4-адрес эндпоинта кластера или узла>
    3
      dbname=<имя базы данных БД>
    4
      user=<имя пользователя>
    5
      sslmode=verify-ca
    6
      sslrootcert=<путь до сертификата>/mws-root-ca.crt
    7
    "

11. Введите пароль пользователя.

При успешном подключении будет выведено имя БД и приглашение к вводу.