Строки подключения

Это важно

Автомасштабирование Lakebase — это последняя версия Lakebase с автомасштабированием вычислений, масштабированием до нуля, ветвлением и мгновенным восстановлением. Сведения о поддерживаемых регионах см. в разделе "Доступность регионов". Если вы являетесь пользователем Lakebase Provisioned, см. Lakebase Provisioned.

Строка подключения Lakebase включает имя роли, имя узла и имя базы данных. Для собственной проверки подлинности паролей Postgres строка подключения также содержит пароль. Для проверки подлинности OAuth вы предоставляете маркер OAuth вместо пароля. См. раздел "Получение маркера OAuth".

Формат строки подключения

Проверка подлинности OAuth:

postgresql://your-email@example.com@ep-abc-123.databricks.com/databricks_postgres?sslmode=require
             ^                      ^                         ^
       role -|                      |- hostname               |- database

Собственная проверка подлинности паролей Postgres:

postgresql://role_name:password@ep-abc-123.databricks.com/databricks_postgres?sslmode=require
             ^         ^        ^                         ^
       role -|         |        |- hostname               |- database
                       |
                       |- password

Замечание

Имя узла включает идентификатор пользовательского интерфейса вычислений, созданный системой идентификатор с ep- префиксом (например, ep-abc-123). Это отличается от имени вычислений, указанного при создании вычислений. Ознакомьтесь с идентификаторами вычислений.

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

Postgres можно настроить либо с отдельными переменными среды, либо с одним DATABASE_URL, в зависимости от ожидаемого приложения или платформы.

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

PGHOST=ep-abc-123.databricks.com
PGDATABASE=databricks_postgres
PGUSER=role_name
PGPASSWORD=<your-password-or-oauth-token>
PGPORT=5432

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

DATABASE_URL="postgresql://role_name:password@ep-abc-123.databricks.com/databricks_postgres?sslmode=require"

Безопасность соединения

  • Шифрование SSL/TLS: Автомасштабирование Lakebase требует, чтобы все подключения использовали шифрование SSL/TLS. Параметр sslmode=require применяет это требование. Все строки подключения, предоставляемые в приложении Lakebase, включают этот параметр по умолчанию.

Порт

Lakebase использует порт Postgres по умолчанию 5432.

Конфигурация сети

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

  • Классические вычислительные подключения: Чтобы подключить классические вычисления к PostgreSQL, откройте TCP-порт 5432 в группе безопасности сети к IP-адресу или диапазону IP-адресов рабочей области.

  • Брандмауэры на стороне клиента: Если у вас есть брандмауэр на стороне клиента, добавьте IP-адрес, используемый автомасштабированием Lakebase в список разрешений. Сведения о просмотре IP-адресов по регионам см. в разделах IP-адресов и доменов для служб и ресурсов Azure Databricks.

Дальнейшие шаги

  • Last updated on