연결 문자열

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

연결 풀링을 사용하는 경우 호스트 이름 형식이 다릅니다. 연결 풀링 사용을 참조하세요.

연결 문자열 구성 요소

애플리케이션 또는 프레임워크에 예상되는 사항에 따라 별도의 환경 변수를 사용하거나 단일 DATABASE_URL환경 변수를 사용하여 Postgres를 구성할 수 있습니다.

개별 구성 요소를 사용하려면 다음을 수행합니다.

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 ACL 주소 또는 범위로 엽니다.

• 클라이언트 쪽 방화벽: 클라이언트 쪽 방화벽이 있는 경우 Lakebase 자동 크기 조정에서 사용하는 IP 주소를 허용 목록에 추가합니다. 지역별 IP 주소를 보려면 Azure Databricks 서비스 및 자산에 대한 IP 주소 및 도메인을 참조하세요.

다음 단계

• 빠른 시작: 데이터베이스에 연결
• 프레임워크 예제
• 인증에 대해 알아보기