Compartir vía

Cadenas de conexión

Importante

El escalado automático de Lakebase es la versión más reciente de Lakebase, con proceso de escalado automático, escalado a cero, bifurcación y restauración instantánea. Para ver las regiones admitidas, consulte Disponibilidad de regiones. Si es un usuario aprovisionado de Lakebase, consulte Aprovisionamiento de Lakebase.

Una cadena de conexión de Lakebase incluye el rol, el nombre de host y el nombre de la base de datos. Para la autenticación de contraseña nativa de Postgres, la cadena de conexión también incluye la contraseña. Para la autenticación de OAuth, se proporciona un token de OAuth en lugar de una contraseña. Consulte Obtención de un token de OAuth.

Formato de la cadena de conexión

Autenticación de OAuth:

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

Autenticación de contraseña de Postgres nativa:

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

Nota:

El nombre de host incluye el UID del proceso, un identificador generado por el sistema con un ep- prefijo (por ejemplo, ep-abc-123). Esto es diferente del nombre de proceso que se proporciona al crear el proceso. Consulte Identificadores de proceso.

Componentes de cadena de conexión

Puede configurar Postgres con variables de entorno independientes o con un solo DATABASE_URL, en función de lo que espera la aplicación o el marco.

Para usar componentes individuales:

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

Para usar una sola variable de entorno:

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

Seguridad de la conexión

  • Cifrado SSL/TLS: el escalado automático de Lakebase requiere que todas las conexiones usen cifrado SSL/TLS. El sslmode=require parámetro aplica este requisito. Todas las cadenas de conexión proporcionadas en la aplicación Lakebase incluyen este parámetro de forma predeterminada.

Puerto

Lakebase usa el puerto de Postgres predeterminado, 5432.

Configuración de red

Al conectarse a la base de datos de Lakebase, tenga en cuenta estos requisitos de red:

  • Conexiones de proceso clásicas: Para conectar el proceso clásico a PostgreSQL, abra el puerto TCP 5432 en el grupo de seguridad de red a la dirección O intervalo ip del área de trabajo.

  • Firewalls del lado cliente: Si tiene un firewall del lado cliente, agregue la dirección IP que usa El escalado automático de Lakebase a la lista de permitidos. Para ver las direcciones IP por región, consulte Direcciones IP y dominios para los recursos y servicios de Azure Databricks.

Pasos siguientes

  • Last updated on