Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Dowiedz się, jak uwierzytelniać połączenia bazy danych z usługą Lakebase Postgres. Aby uzyskać instrukcje krok po kroku dotyczące połączenia, zobacz Szybki start.
Przegląd
Usługa Lakebase obsługuje dwie metody uwierzytelniania, z których każda jest przeznaczona dla różnych przypadków użycia:
Uwierzytelnianie tokenów OAuth: Używa tożsamości Azure Databricks z tokenami OAuth ograniczonymi czasowo. Najlepsze dla:
- Interaktywne sesje, w których można odświeżyć tokeny
- Przepływy pracy zintegrowane z obszarem roboczym
- Aplikacje, które mogą implementować rotację tokenów
- Jeśli chcesz zarządzać uwierzytelnianiem przez Azure Databricks
Natywne uwierzytelnianie hasłem Postgres: Używa tradycyjnych ról Postgres z hasłami. Najlepsze dla:
- Aplikacje, które nie mogą odświeżać poświadczeń co godzinę
- Długotrwałe procesy
- Narzędzia, które nie obsługują rotacji tokenów
Uwaga / Notatka
Zarządzanie platformą a dostęp do bazy danych: Ta strona koncentruje się na uwierzytelnianiu bazy danych (tokeny OAuth i hasła Postgres do łączenia się z bazą danych). Aby uzyskać informacje na temat uwierzytelniania zarządzania platformą, dotyczących tworzenia projektów, gałęzi i obliczeń, zobacz Uprawnienia projektowe.
Przekroczenia limitu czasu połączenia
Wszystkie połączenia z bazą danych podlegają następującym limitom niezależnie od metody uwierzytelniania:
- 24-godzinny limit bezczynności: Połączenia bez aktywności przez 24 godziny są automatycznie zamykane.
- Maksymalny okres połączenia wynoszący 3 dni: Połączenia, które były aktywne dłużej niż 3 dni, mogą zostać zamknięte niezależnie od aktywności.
Zaprojektuj aplikacje tak, aby obsługiwały limity czasu połączenia bezpiecznie, implementując logikę ponawiania prób połączenia z odpowiednimi ustawieniami limitu czasu.
Uwierzytelnianie tokenem OAuth
Uwierzytelnianie tokenu OAuth umożliwia nawiązywanie połączenia przy użyciu tożsamości Azure Databricks. Generujesz token OAuth ograniczony czasowo i używasz go jako hasła podczas nawiązywania połączenia z bazą danych Postgres.
Rola OAuth właściciela projektu jest tworzona automatycznie. Aby włączyć uwierzytelnianie OAuth dla innych tożsamości Azure Databricks, należy utworzyć ich role Postgres za pomocą rozszerzenia databricks_auth oraz SQL. Zobacz Tworzenie roli OAuth dla tożsamości bazy danych przy użyciu języka SQL.
Jak działają tokeny OAuth
- Czas życia tokena: Tokeny OAuth wygasają po godzinie.
- Wymuszanie wygaśnięcia: Wygaśnięcie tokena jest egzekwowane tylko przy logowaniu. Otwarte połączenia pozostają aktywne nawet po wygaśnięciu tokenu.
- Odświeżanie tokenów: Dla sesji interaktywnych generuj nowy token, gdy jest to potrzebne. W przypadku aplikacji z długotrwałymi połączeniami zaimplementuj rotację tokenów , aby automatycznie odświeżyć poświadczenia.
Wymagania i ograniczenia
-
Wymagana odpowiednia rola Postgres: Twoja tożsamość Azure Databricks musi mieć odpowiadającą rolę Postgres. Rola właściciela projektu jest tworzona automatycznie. W przypadku innych tożsamości Azure Databricks utwórz ich role przy użyciu rozszerzenia
databricks_auth. - Zakres przestrzeni roboczej: tokeny OAuth mają zakres przestrzeni roboczej i muszą należeć do tej samej przestrzeni roboczej, która jest właścicielem projektu. Uwierzytelnianie tokenu między obszarami roboczymi nie jest obsługiwane.
-
Wymagane SSL: uwierzytelnianie oparte na tokenach wymaga połączeń SSL. Wszyscy klienci muszą być skonfigurowani do używania protokołu SSL (zazwyczaj
sslmode=require). - Pula połączeń: Użytkownicy i jednostki usługi mogą łączyć się za pomocą wbudowanego pulera połączeń PgBouncer za pomocą tokena OAuth z interfejsu Lakebase UI lub API poświadczeń bazy danych. Role grupowe, tokeny innych klientów OAuth oraz tokeny z uprawnieniami do tabel wymagają bezpośredniego połączenia. Zobacz role OAuth.
Uzyskaj token OAuth w przepływie między użytkownikiem a maszyną
Jeśli jesteś właścicielem bazy danych, administratorem lub posiadasz tożsamość Azure Databricks z odpowiednią rolą Postgres dla bazy danych, możesz uzyskać token OAuth z interfejsu użytkownika, interfejsu API usługi Databricks, CLI lub jednego z zestawów SDK usługi Databricks.
W przypadku innych użytkowników tożsamości Azure Databricks zobacz Autoryzowanie dostępu użytkowników do Azure Databricks za pomocą OAuth dla instrukcji autoryzacji na poziomie obszaru roboczego dotyczących uzyskiwania tokenów OAuth.
interfejs użytkownika
W przypadku korzystania z klientów SQL, takich jak psql lub DBeaver, użyj interfejsu użytkownika usługi Lakebase do generowania tokenów:
- Przejdź do projektu w aplikacji Lakebase.
- Wybierz gałąź i jednostkę obliczeniową, z którą chcesz nawiązać połączenie.
- Kliknij pozycję Połącz i postępuj zgodnie z instrukcjami, aby wygenerować token OAuth.
Aby uzyskać pełne instrukcje, zobacz Nawiązywanie połączenia z rolą OAuth .
CLI
# Generate OAuth token for database connection (1-hour expiration)
databricks postgres generate-database-credential projects/my-project/branches/production/endpoints/my-compute --output json
Odpowiedź:
{
"token": "eyJraWQiOiI1NDdkNjFjNzQ2YTk3M2Q3M2ViNjM2YWRiMWY2Nz...",
"expire_time": "2026-01-22T17:07:00Z"
}
Użyj wartości token jako hasła podczas nawiązywania połączenia z bazą danych.
zestaw SDK Python
Token OAuth można wygenerować przy użyciu zestawu SDK usługi Databricks dla Python.
from databricks.sdk import WorkspaceClient
w = WorkspaceClient()
# Generate OAuth token for database connection (1-hour expiration)
credential = w.postgres.generate_database_credential(
endpoint="projects/my-project/branches/production/endpoints/my-compute"
)
print(f"Token: {credential.token}")
print(f"Expires: {credential.expire_time}")
# Use the token to connect to Postgres
import psycopg
conn = psycopg.connect(
host="ep-example.database.region.databricks.com",
port=5432,
dbname="databricks_postgres",
user="your.email@company.com",
password=credential.token,
sslmode="require"
)
zestaw SDK Java
Token OAuth można wygenerować przy użyciu zestawu SDK usługi Databricks dla Java.
import com.databricks.sdk.WorkspaceClient;
import com.databricks.sdk.service.postgres.*;
WorkspaceClient w = new WorkspaceClient();
// Generate OAuth token for database connection (1-hour expiration)
DatabaseCredential credential = w.postgres().generateDatabaseCredential(
new GenerateDatabaseCredentialRequest()
.setEndpoint("projects/my-project/branches/production/endpoints/my-compute")
);
System.out.println("Token: " + credential.getToken());
System.out.println("Expires: " + credential.getExpireTime());
Uzyskaj token OAuth w przepływie maszyna-maszyna
Aby włączyć bezpieczny, zautomatyzowany (komputer-komputer) dostęp do bazy danych, należy uzyskać token OAuth przy użyciu jednostki usługi Azure Databricks. Ten proces obejmuje skonfigurowanie jednostki usługi, wygenerowanie poświadczeń i wybicie tokenów OAuth na potrzeby uwierzytelniania.
- Skonfiguruj jednostkę usługi z poświadczeniami o nieokreślonym terminie ważności. Aby uzyskać instrukcje, zobacz Autoryzuj dostęp głównego podmiotu usługi do Azure Databricks za pomocą OAuth.
- Wygeneruj nowe tokeny OAuth jako jednostka usługi.
CLI
# Generate OAuth token for database connection (1-hour expiration)
databricks postgres generate-database-credential projects/my-project/branches/production/endpoints/my-compute --output json
Odpowiedź:
{
"token": "eyJraWQiOiI1NDdkNjFjNzQ2YTk3M2Q3M2ViNjM2YWRiMWY2Nz...",
"expire_time": "2026-01-22T17:07:00Z"
}
Użyj wartości token jako hasła podczas nawiązywania połączenia z bazą danych.
zestaw SDK Python
Token OAuth można wygenerować przy użyciu zestawu SDK usługi Databricks dla Python.
from databricks.sdk import WorkspaceClient
w = WorkspaceClient(
host="https://<YOUR WORKSPACE URL>/",
client_id="<YOUR SERVICE PRINCIPAL ID>",
client_secret="REDACTED"
)
# Generate OAuth token for database connection (1-hour expiration)
credential = w.postgres.generate_database_credential(
endpoint="projects/my-project/branches/production/endpoints/my-compute"
)
print(f"Token: {credential.token}")
print(f"Expires: {credential.expire_time}")
zestaw SDK Java
Token OAuth można wygenerować przy użyciu zestawu SDK usługi Databricks dla Java.
import com.databricks.sdk.WorkspaceClient;
import com.databricks.sdk.core.DatabricksConfig;
import com.databricks.sdk.service.postgres.*;
// Initialize with service principal credentials
DatabricksConfig config = new DatabricksConfig()
.setHost("https://<YOUR WORKSPACE URL>/")
.setClientId("<YOUR SERVICE PRINCIPAL ID>")
.setClientSecret("REDACTED");
WorkspaceClient w = new WorkspaceClient(config);
// Generate OAuth token for database connection (1-hour expiration)
DatabaseCredential credential = w.postgres().generateDatabaseCredential(
new GenerateDatabaseCredentialRequest()
.setEndpoint("projects/my-project/branches/production/endpoints/my-compute")
);
System.out.println("Token: " + credential.getToken());
System.out.println("Expires: " + credential.getExpireTime());
Uwaga / Notatka
Odnów tokeny OAuth przed godzinnym wygaśnięciem.
- Sprawdź czas wygaśnięcia tokenu OAuth dla każdego użycia i odświeżaj w razie potrzeby.
- Alternatywnie skonfiguruj wątek w tle, aby okresowo odświeżyć bieżący token OAuth.
Przykłady rotacji tokenów
Ponieważ tokeny OAuth wygasają po godzinie, aplikacje, które utrzymują długotrwałe połączenia z bazą danych, muszą okresowo implementować rotację tokenów w celu odświeżenia poświadczeń. W poniższych przykładach pokazano, jak automatycznie obracać tokeny w kodzie aplikacji.
Uwaga / Notatka
Wymagania dla tych przykładów:
- Musisz być uwierzytelniony do obszaru roboczego właściciela projektu. Narzędzie
WorkspaceClient()używa poświadczeń protokołu OAuth obszaru roboczego do generowania tokenów bazy danych. - Twoja tożsamość Azure Databricks musi być członkiem obszaru roboczego, gdzie projekt został utworzony.
- Pobierz parametry połączenia (host, baza danych, punkt końcowy) z okna dialogowego Łączenie w aplikacji Lakebase. Aby uzyskać szczegółowe informacje, zobacz Szybki start .
- Parametr
endpointużywa formatu:projects/{project-id}/branches/{branch-id}/endpoints/{endpoint-id}
Aby uzyskać informacje o konfiguracji uwierzytelniania obszaru roboczego, zobacz Autoryzuj dostęp użytkowników do Azure Databricks za pomocą protokołu OAuth lub Autoryzuj dostęp jednostki usługi do Azure Databricks za pomocą protokołu OAuth.
Python: psycopg3
W tym przykładzie użyto puli połączeń psycopg3 z niestandardową klasą połączenia, która generuje nowy token OAuth za każdym razem, gdy zostanie utworzone nowe połączenie. Takie podejście sprawia, że każde połączenie z puli ma zawsze aktualny, prawidłowy token.
%pip install "psycopg[binary,pool]"
from databricks.sdk import WorkspaceClient
import psycopg
from psycopg_pool import ConnectionPool
w = WorkspaceClient()
class CustomConnection(psycopg.Connection):
@classmethod
def connect(cls, conninfo='', **kwargs):
# Generate a fresh OAuth token for each new connection
endpoint = "projects/<project-id>/branches/<branch-id>/endpoints/<endpoint-id>"
credential = w.postgres.generate_database_credential(endpoint=endpoint)
kwargs['password'] = credential.token
return super().connect(conninfo, **kwargs)
# Configure connection parameters (get these from the Connect dialog in the Lakebase App)
username = "your.email@company.com" # Your DB identity
host = "ep-example.database.region.databricks.com" # Your compute endpoint hostname
port = 5432
database = "databricks_postgres"
# Create connection pool with custom connection class
pool = ConnectionPool(
conninfo=f"dbname={database} user={username} host={host} sslmode=require",
connection_class=CustomConnection,
min_size=1,
max_size=10,
open=True
)
# Use the connection pool
with pool.connection() as conn:
with conn.cursor() as cursor:
cursor.execute("SELECT version()")
for record in cursor:
print(record)
Python: SQLAlchemy
W tym przykładzie użyto puli połączeń SQLAlchemy z odbiornikiem zdarzeń, który automatycznie odświeża token OAuth przed wygaśnięciem. Odbiornik zdarzeń uruchamia się przed utworzeniem każdego nowego fizycznego połączenia z puli i odnawia token, jeśli znajduje się w ciągu 2 minut przed wygaśnięciem, co zapewnia, że aplikacja ma zawsze ważny token bez potrzeby interwencji ręcznej.
%pip install sqlalchemy==2.0.36 "psycopg[binary]==3.2.3" databricks-sdk==0.79.0
from databricks.sdk import WorkspaceClient
import time
from sqlalchemy import create_engine, text, event
w = WorkspaceClient()
# Configure connection parameters (get these from the Connect dialog in the Lakebase App)
endpoint = "projects/<project-id>/branches/<branch-id>/endpoints/<endpoint-id>"
username = "your.email@company.com" # Your DB identity
host = "ep-example.database.region.databricks.com" # Your compute endpoint hostname
port = 5432
database = "databricks_postgres"
# Create SQLAlchemy engine
connection_pool = create_engine(f"postgresql+psycopg://{username}:@{host}:{port}/{database}?sslmode=require")
# Global variables for token management
postgres_password = None
token_expiry = 0.0 # Unix timestamp when the current token expires
@event.listens_for(connection_pool, "do_connect")
def provide_token(dialect, conn_rec, cargs, cparams):
global postgres_password, token_expiry
# Refresh token if None or expiring within 2 minutes
if postgres_password is None or time.time() >= token_expiry - 120:
print("Refreshing PostgreSQL OAuth token")
credential = w.postgres.generate_database_credential(endpoint=endpoint)
postgres_password = credential.token
token_expiry = credential.expire_time.seconds
cparams["password"] = postgres_password
# Use the connection pool
with connection_pool.connect() as conn:
result = conn.execute(text("SELECT version()"))
for row in result:
print(f"Connected to PostgreSQL database. Version: {row}")
Uwierzytelnianie hasłem Postgres
Uwaga / Notatka
Połączenia przy użyciu hasła są domyślnie wyłączone dla nowych projektów Lakebase. Aby je włączyć, zobacz Zarządzanie połączeniami haseł.
Natywne uwierzytelnianie haseł postgres używa tradycyjnych ról Postgres z hasłami. W przeciwieństwie do tokenów OAuth te hasła nie wygasają po godzinie, co czyni je odpowiednimi dla aplikacji, które nie mogą obsługiwać częstej rotacji poświadczeń.
Kiedy należy używać haseł bazy danych Postgres
Użyj uwierzytelniania za pomocą hasła Postgres, gdy:
- Aplikacja lub narzędzie nie może odświeżać poświadczeń co godzinę
- Masz długotrwałe procesy, które wymagają stabilnych poświadczeń
- Biblioteka klienta nie obsługuje rotacji tokenów OAuth
- Aby uzyskać zgodność, potrzebujesz tradycyjnego uwierzytelniania bazy danych
Jak działają hasła postgres
- Czas życia haseł: hasła nie wygasają automatycznie
- Brak integracji z workspace: uwierzytelnianie obsługuje Postgres, a nie uwierzytelnianie obszaru roboczego Azure Databricks
- Ręczne zarządzanie: hasła muszą być ręcznie rotowane i rozpowszechniane między użytkownikami
- Limity czasu połączenia nadal obowiązują: Mimo że hasła nie wygasają, połączenia podlegają 24-godzinnemu limitowi bezczynności i maksymalnemu 3-dniowemu okresowi życia połączenia
Zagadnienia dotyczące zabezpieczeń
- Przechowywanie haseł: Bezpiecznie przechowuj hasła za pomocą zmiennych środowiskowych lub systemów zarządzania sekretami
-
Wymagane SSL: Wszystkie połączenia muszą korzystać z SSL (
sslmode=require)
Buforowanie połączeń
Natywne role haseł Postgres obsługują wbudowany moduł puli połączeń PgBouncer. Menedżer połączeń zmniejsza narzut połączenia dla aplikacji o wysokiej przepływności. Zobacz Korzystanie z buforowania połączeń.