Condividi tramite

Gestire le connessioni per la federazione Lakehouse

  • Articolo

Questo articolo descrive come elencare tutte le connessioni della Lakehouse Federation definite in un metastore di Unity Catalog, ottenere i dettagli di connessione, concedere i permessi di connessione e rilasciare connessioni usando Catalog Explorer e istruzioni SQL nei notebook o nell'editor di query SQL di Databricks. Una connessione è un oggetto protetto 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

  1. Nell'area di lavoro di Azure Databricks, fare clic sull'icona CatalogCatalog.

  2. Nella parte superiore del riquadro catalogo, fare clic sull'icona a forma di ingranaggio e selezionare Connessioni dal menu.

    In alternativa, nella 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

  1. Nell'area di lavoro di Azure Databricks fare clic sull'icona CatalogoCatalogo.

  2. Nella parte superiore del riquadro Catalogo, clicca sull'icona a forma di ingranaggio e seleziona Connessioni dal menu.

    In alternativa, dalla pagina Accesso rapido, fare clic sul pulsante Dati esterni > e passare alla scheda Connessioni.

  3. 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 conferisce la possibilità di creare un catalogo esterno come mirror di sola lettura di un database nell'origine dei dati descritta dalla connessione.
  • USE CONNECTION offre la possibilità di usare la connessione in Delta Live Tables per inserire i dati dall'origine dati in Azure Databricks. Tuttavia, se concesso a livello di metastore, consente solo di visualizzare i dettagli delle connessioni nel metastore. Gli utenti devono comunque avere i permessi USE CONNECTION sulle singole connessioni per usarla.

Autorizzazioni necessarie: amministratore metastore o proprietario della connessione.

Esploratore di Cataloghi

Per concedere l'autorizzazione per l'uso di una connessione:

  1. Nell'area di lavoro di Azure Databricks, fare clic sull'icona del catalogo .

  2. Nella parte superiore del riquadro catalogo fare clic sull'icona a forma di ingranaggio e selezionare Connessioni dal menu.

    In alternativa, nella pagina accesso rapido, fare clic sul pulsante dati esterni > e passare alla scheda Connessioni.

  3. Trovare la connessione e selezionarla.

  4. Nella scheda autorizzazioni, fare clic su Concedi.

  5. Nel dialogo Grant 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.

  6. Selezionare i privilegi da concedere.

    Vedere le descrizioni dei privilegi nella sezione introduttiva.

  7. Fai clic su Concedi.

Per revocare un privilegio di connessione:

  1. Seguire i passaggi precedenti per accedere alla scheda Autorizzazioni per la connessione.
  2. Selezionare l'utente o il gruppo il cui privilegio si vuole revocare.
  3. Clicca Revoca sia nella scheda che nella finestra di dialogo 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>;

Interrompere le connessioni

Autorizzazioni necessarie: proprietario della connessione

Esploratore di Cataloghi

  1. Nell'area di lavoro di Azure Databricks fare clic sull'icona CatalogoCatalogo.

  2. 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.

  3. Trovare la connessione e selezionarla.

  4. Fare clic sul menu kebab e selezionare Elimina.

  5. 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>;