Anslutningssträngar

En Lakebase-anslutningssträng innehåller rollen, värdnamnet och databasnamnet. För intern Postgres-lösenordsautentisering innehåller anslutningssträngen även lösenordet. För OAuth-autentisering anger du en OAuth-token i stället för ett lösenord. Se Hämta en OAuth-token.

Format för anslutningssträng

OAuth 2.0-autentisering:

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

Intern Postgres-lösenordsautentisering:

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

Anmärkning

Värdnamnet innehåller beräkningens UID, en systemgenererad identifierare med ett ep- prefix (till exempel ep-abc-123). Detta skiljer sig från det beräkningsnamn som du anger när du skapar beräkningen. Se Beräkningsidentifierare.

Om du använder anslutningspooler är värdnamnsformatet annorlunda. Se Använda anslutningspooler.

Anslutningssträngskomponenter

Du kan konfigurera Postgres antingen med separata miljövariabler eller med en enda DATABASE_URL, beroende på vad ditt program eller ramverk förväntar sig.

Så här använder du enskilda komponenter:

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

Så här använder du en enskild miljövariabel:

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

Anslutningssäkerhet

  • SSL/TLS-kryptering: Lakebase Autoscaling kräver att alla anslutningar använder SSL/TLS-kryptering. Parametern sslmode=require tillämpar det här kravet. Alla anslutningssträngar som anges i Lakebase-appen innehåller den här parametern som standard.

Hamn

Lakebase använder postgres-standardporten 5432.

Konfiguration av nätverk

När du ansluter till lakebase-databasen bör du tänka på följande nätverkskrav:

  • Klassiska beräkningsanslutningar: Om du vill ansluta klassisk beräkning till PostgreSQL öppnar du TCP-port 5432 i nätverkssäkerhetsgruppen till din arbetsytas IP ACL-adress eller -intervall.

  • Brandväggar på klientsidan: Om du har en brandvägg på klientsidan lägger du till DEN IP-adress som används av Lakebase Autoscaling i listan över tillåtna värden. Information om hur du visar IP-adresser efter region finns i IP-adresser och domäner för Azure Databricks-tjänster och -tillgångar.

Nästa steg