Gestire le connessioni per la federazione Lakehouse
Questo articolo descrive come elencare tutte le connessioni di Lakehouse Federation definite in un metastore di Unity Catalog, ottenere i dettagli delle connessioni, concedere le autorizzazioni per le connessioni ed eliminare le connessioni utilizzando Esplora cataloghi e istruzioni SQL nei notebook o nell'editor di query SQL di Databricks. Una connessione è un oggetto a protezione diretta in Unity Catalog che specifica un percorso e le credenziali per l'accesso a un sistema di database esterno.
Vedere anche Creare una connessione.
Se si preferisce usare l'API REST, vedere la documentazione di riferimento di Azure Databricks.
Elencare le connessioni
Autorizzazioni necessarie: l'elenco delle connessioni restituite dipende dal ruolo e dalle autorizzazioni. Gli utenti con il privilegio USE CONNECTION
nel metastore visualizzano tutte le connessioni. In caso contrario, è possibile visualizzare solo le connessioni per le quali si è il proprietario dell'oggetto connessione o disporre di alcuni privilegi.
Esploratore di Cataloghi
Nell'area di lavoro di Azure Databricks, fai clic sull'icona del Catalogo
.
Nella parte superiore del riquadro Catalogo, fare clic sull'icona a forma di ingranaggio
e selezionare Connessioni dal menu.
In alternativa, dalla pagina accesso rapido, fare clic sul pulsante dati esterni > e passare alla scheda Connessioni.
Le connessioni a cui si è autorizzati a visualizzare sono elencate, insieme all'URL, alla data di creazione, al proprietario e al commento.
SQL
Eseguire il seguente comando in un notebook o nell'editor di query SQL di Databricks. Facoltativamente, sostituire <pattern>
con un LIKE
predicato.
SHOW CONNECTIONS [LIKE <pattern>];
Ottenere i dettagli della connessione
Autorizzazioni necessarie: proprietario della connessione, USE CONNECTION
privilegio per il metastore o alcuni privilegi per la connessione.
Esploratore di Cataloghi
Nell'area di lavoro di Azure Databricks, fai clic sull'icona del Catalogo
.
Nella parte superiore del riquadro Catalogo, fare clic sull'icona a forma di ingranaggio
e selezionare Connessioni dal menu.
In alternativa, dalla pagina accesso rapido, fare clic sul pulsante dati esterni > e passare alla scheda Connessioni.
Trovare la connessione e selezionarla per visualizzare i dettagli.
SQL
Eseguire il seguente comando in un notebook o nell'editor di query SQL di Databricks.
DESCRIBE CONNECTION <connection-name>;
Concedere e revocare le autorizzazioni per le connessioni
È possibile concedere l'autorizzazione per usare una connessione per creare cataloghi stranieri o per visualizzare i dettagli relativi a una connessione:
-
CREATE FOREIGN CATALOG
concede la possibilità di creare un catalogo esterno come mirror di sola lettura di un database nell'origine dati descritta dalla connessione. -
USE CONNECTION
offre la possibilità di utilizzare la connessione in DLT per inserire dati dall'origine dati in Azure Databricks. Tuttavia, se concesso a livello di metastore, consente solo di visualizzare i dettagli delle connessioni nel metastore. Affinché gli utenti possano utilizzare le singole connessioni, devono comunque avere il permessoUSE CONNECTION
su di esse.
Autorizzazioni necessarie: amministratore metastore o proprietario della connessione.
Esploratore di Cataloghi
Per concedere l'autorizzazione per l'uso di una connessione:
Nell'area di lavoro di Azure Databricks, fai clic sull'icona del Catalogo
.
Nella parte superiore del riquadro Catalogo, fare clic sull'icona a forma di ingranaggio
e selezionare Connessioni dal menu.
In alternativa, dalla pagina accesso rapido, fare clic sul pulsante dati esterni > e passare alla scheda Connessioni.
Trovare la connessione e selezionarla.
Nella scheda Autorizzazioni, fare clic su Concedi.
Nella finestra di dialogo Concedi su
<connection-name>
, inizia a digitare il nome dell'utente o del gruppo, oppure fai clic sul menu utente per sfogliare e selezionare utenti e gruppi.Selezionare i privilegi da concedere.
Vedere le descrizioni dei privilegi nella sezione introduttiva.
Fare clic su Concedi.
Per revocare un privilegio di connessione:
- Seguire i passaggi precedenti per accedere alla scheda Permessi per la connessione.
- Selezionare l'utente o il gruppo il cui privilegio si vuole revocare.
- Clicca su Revoca sia nella scheda che nella finestra di conferma.
SQL
Per concedere la possibilità di creare un catalogo esterno usando una connessione, eseguire il comando seguente in un notebook o nell'editor di query SQL di Databricks.
GRANT CREATE FOREIGN CATALOG ON CONNECTION <connection-name> TO <user-name>;
Per concedere la possibilità di visualizzare la connessione, eseguire le operazioni seguenti:
GRANT USE CONNECTION ON CONNECTION <connection-name> TO <user-name>;
Per revocare un privilegio, eseguire quanto segue, dove <privilege>
è uno dei privilegi per la connessione concessa all'utente:
REVOKE <privilege> ON CONNECTION <connection-name> FROM <user-name>;
Eliminare le connessioni
Autorizzazioni necessarie: proprietario della connessione
Esploratore di Cataloghi
Nell'area di lavoro di Azure Databricks, fai clic sull'icona del Catalogo
.
Nella parte superiore del riquadro Catalogo, fare clic sull'icona a forma di ingranaggio
e selezionare Connessioni dal menu.
In alternativa, dalla pagina accesso rapido, fare clic sul pulsante dati esterni > e passare alla scheda Connessioni.
Trovare la connessione e selezionarla.
Fare clic sul menu kebab
e selezionare Elimina.
Nella finestra di dialogo di conferma fare clic su Elimina.
SQL
Eseguire il seguente comando in un notebook o nell'editor di query SQL di Databricks.
DROP CONNECTION [IF EXISTS] <connection-name>;