Gestire le connessioni in Partner Connect
È possibile eseguire attività amministrative con le connessioni dell'area di lavoro Azure Databricks alle soluzioni dei partner, ad esempio:
- Gestione degli utenti degli account partner.
- Gestione dell'entità servizio di Azure Databricks e del token di accesso personale di Azure Databricks correlato usato da una connessione.
- Disconnettere un'area di lavoro da un partner.
Per amministrare Partner Connect, è necessario accedere all'area di lavoro come amministratore dell'area di lavoro. Per altre informazioni, si veda Gestire gli utenti.
Gestire gli utenti dell'account partner
Per i partner che consentono agli utenti di utilizzare Partner Connect per accedere all'account o al sito web del partner (come Fivetran e Rivery), quando una persona dell'organizzazione si connette per la prima volta da una delle aree di lavoro di Azure Databricks a un partner, diventa amministratore dell'account partner per quel partner in tutte le aree di lavoro dell'organizzazione. Per consentire ad altri utenti all'interno dell'organizzazione di accedere a quel partner, l'amministratore dell'account partner deve prima aggiungere quegli utenti all'account partner dell'organizzazione. Alcuni partner consentono all'amministratore dell'account partner di delegare anche questa autorizzazione. Per informazioni dettagliate, si veda la documentazione sul sito Web del partner.
Se nessuno può aggiungere utenti all'account partner dell'organizzazione (ad esempio, se l'amministratore dell'account partner non è più disponibile), contattare il partner per ricevere assistenza. Per i collegamenti di supporto, si veda l'elenco dei partner Azure Databricks Partner Connect.
Connettere i dati gestiti dal catalogo Unity alle soluzioni partner
Se l'area di lavoro è abilitata per il catalogo Unity, è possibile connettere le soluzioni partner selezionate ai dati gestiti dal catalogo Unity. Quando si crea la connessione tramite Partner Connect, è possibile scegliere se il partner usa il metastore Hive legacy (hive_metastore
) oppure un altro catalogo di cui si è proprietari. Gli amministratori metastore possono selezionare qualsiasi catalogo nel metastore assegnato all'area di lavoro.
Nota
Se una soluzione partner non supporta il catalogo Unity con Partner Connect, si potrà usare solo il catalogo predefinito dell'area di lavoro. Se il catalogo predefinito non è hive_metastore
e non si è proprietari del catalogo predefinito, verrà generato un errore.
Per un elenco dei partner che supportano il catalogo Unity con Partner Connect, si veda l'elenco dei partner di Azure Databricks Partner Connect.
Per informazioni sulla risoluzione dei problemi di connessione, si veda Risoluzione dei problemi di Partner Connect.
Gestire le entità servizio e i token di accesso personale
Per i partner che richiedono entità servizio di Azure Databricks, quando un utente dell'area di lavoro di Azure Databricks si connette a un partner specifico per la prima volta, Partner Connect crea un'entità servizio di Azure Databricks nell'area di lavoro per l'uso con tale partner. Partner Connect genera nomi visualizzati dell'entità servizio usando il formato <PARTNER-NAME>_USER
. Ad esempio, per il partner Fivetran, il nome visualizzato dell'entità servizio è FIVETRAN_USER
.
Partner Connect crea anche un token di accesso personale di Azure Databricks e lo associa all'entità servizio di Azure Databricks. Partner Connect fornisce il valore di questo token al partner in background per completare la connessione a quel partner. Non è possibile visualizzare o ottenere il valore del token. Questo token non scade finché non viene eliminato dall'utente o da un altro utente. Si veda anche Disconnettersi da un partner.
Partner Connect concede le seguenti autorizzazioni di accesso alle entità servizio di Azure Databricks nell'area di lavoro:
Partner | Autorizzazioni |
---|---|
Fivetran, Matillion, Power BI, Tableau, erwin Data Modeler, Precisely Data Integrity Suite | Queste soluzioni non richiedono entità servizio di Azure Databricks. |
dbt Cloud, Hevo Data, Rivery, Rudderstack, Snowplow | - Autorizzazione CAN USE token per creare un token di accesso personale. - Autorizzazione per la creazione di Warehouse SQL. - Accesso all'area di lavoro. - Accesso a Databricks SQL. - (Catalogo Unity) Privilegio USE CATALOG per il catalogo selezionato.- (Catalogo Unity) Privilegio CREATE SCHEMA per il catalogo selezionato.- (metastore Hive legacy) Privilegio USAGE nel catalogo hive_metastore .- (metastore Hive legacy) Privilegio CREATE nel catalogo hive_metastore in modo che Partner Connect possa creare oggetti nel metastore Hive legacy per conto dell'utente.- Proprietà delle tabelle create. L'entità servizio non può eseguire query su tabelle che non ha creato. |
Prophecy | - Autorizzazione CAN USE token per creare un token di accesso personale. - Accesso all'area di lavoro. - Autorizzazione per la creazione di cluster. L'entità servizio non può eseguire accessi a cluster che non ha creato. - Autorizzazione per la creazione di processi. L'entità servizio non può eseguire accessi a processi che non ha creato. |
John Snow Labs, Labelbox | - Autorizzazione CAN USE token per creare un token di accesso personale. - Accesso all'area di lavoro. |
Anomalo, AtScale, Census, Hex, Hightouch, Lightup, Monte Carlo, Preset, Privacera, Qlik Sense, Sigma, Stardog | - Autorizzazione CAN USE token per creare un token di accesso personale. - Privilegio CAN USE nel Warehouse SQL Databricks selezionato. - Privilegio SELECT nello schema selezionato.- (Catalogo Unity) Privilegio USE CATALOG per il catalogo selezionato.- (Catalogo Unity) Privilegio USE SCHEMA nello schema selezionato.- (metastore Hive legacy) Privilegio USAGE nello schema selezionato.- (metastore Hive legacy) Privilegio READ METADATA per lo schema selezionato. |
Dataiku | - Autorizzazione CAN USE token per creare un token di accesso personale. - Autorizzazione per la creazione di Warehouse SQL. - (Catalogo Unity) Privilegio USE CATALOG per il catalogo selezionato.- (Catalogo Unity) Privilegio USE SCHEMA per gli schemi selezionati.- (Catalogo Unity) Privilegio CREATE SCHEMA per il catalogo selezionato.- (metastore Hive legacy) Privilegio USAGE per il catalogo hive_metastore e lo schema selezionati.- (metastore Hive legacy) Privilegio CREATE nel catalogo hive_metastore in modo che Partner Connect possa creare oggetti nel metastore Hive legacy per conto dell'utente.- (metastore Hive legacy) Privilegio SELECT per gli schemi selezionati. |
SuperAnnotate | - Autorizzazione CAN USE token per creare un token di accesso personale. - Privilegio CAN USE nel Warehouse SQL Databricks selezionato. - Privilegio SELECT per gli schemi selezionati.- (Catalogo Unity) Privilegio USE CATALOG per il catalogo selezionato.- (Catalogo Unity) Privilegio USE SCHEMA per gli schemi selezionati.- (metastore Hive legacy) Privilegio USAGE per il catalogo hive_metastore e lo schema selezionati.- (metastore Hive legacy) Privilegio SELECT per gli schemi selezionati. |
Integrazione di Informatica Cloud Data | - Autorizzazione CAN USE token per creare un token di accesso personale. - Privilegio CAN MANAGE nel Warehouse SQL Databricks selezionato. - Privilegi CREATE e USAGE sugli oggetti dati.- (Catalogo Unity) Privilegio USE CATALOG per il catalogo selezionato.- (Catalogo Unity) Privilegio USE SCHEMA per gli schemi selezionati.- (metastore Hive legacy) Privilegi USAGE e CREATE per il catalogo hive_metastore e lo schema selezionato.- (metastore Hive legacy) Privilegio SELECT per gli schemi selezionati. |
Disconnettersi da un partner.
Se il riquadro per un partner ha un'icona dei segno di spunta, significa che un utente dell'area di lavoro di Azure Databricks ha già creato una connessione a quel partner. Per disconnettersi da quel partner, reimpostare il riquadro del partner in Partner Connect. La reimpostazione del riquadro di un partner esegue le seguenti operazioni:
- Cancella l'icona del segno di spunta dal riquadro del partner.
- Elimina il cluster o il warehouse SQL associato se il partner ne richiede uno.
- Elimina l'entità servizio di Azure Databricks associata, se il partner ne richiede una. L'eliminazione di un'entità servizio elimina anche il token di accesso personale di Azure Databricks correlato all'entità servizio. Il valore di questo token è ciò che completa la connessione tra l'area di lavoro e il partner. Per altre informazioni, si veda Come gestire le entità servizio e i token di accesso personale.
Avviso
L'eliminazione di un warehouse SQL, di un cluster, di un'entità servizio di Azure Databricks o del token di accesso personale di un'entità srevizio di Azure Databricks è un'operazione irreversibile e non può essere annullata.
La reimpostazione del riquadro di un partner non comporta l'eliminazione dell'account partner correlato dell'organizzazione o la modifica delle impostazioni di connessione correlate con il partner. Tuttavia, la reimpostazione del riquadro di un partner interrompe la connessione tra l'area di lavoro e l'account partner correlato. Per riconnettersi, è necessario creare una nuova connessione dall'area di lavoro al partner, per poi modificare manualmente le impostazioni di connessione originali nell'account partner correlato in modo che corrispondano alle nuove impostazioni di connessione.
Per reimpostare il riquadro di un partner, fare clic sul riquadro e poi su Elimina connessione e seguire le istruzioni visualizzate.
In alternativa, è possibile disconnettere manualmente un'area di lavoro di Azure Databricks da un partner eliminando l'entità servizio di Azure Databricks correlata nell'area di lavoro associata a quel partner. Questa operazione può essere utile se si desidera scollegare l'area di lavoro da un partner, mantenendo però le altre risorse associate e mantenendo l'icona del segno di spunta nel riquadro. L'eliminazione di un'entità servizio elimina anche il token di accesso personale correlato all'entità servizio. Il valore di questo token è ciò che completa la connessione tra l'area di lavoro e il partner. Per altre informazioni, si veda Come gestire le entità servizio e i token di accesso personale.
Per eliminare un'entità servizio di Azure Databricks, usare l'API REST di Databricks come indicato di seguito:
- Ottenere l'ID applicazione dell'entità servizio di Azure Databricks chiamando l'operazione
GET /preview/scim/v2/ServicePrincipals
nell'API Entità servizio dell'area di lavoro. Prendere nota dei valori dell'entità servizioapplicationId
nella risposta. - Utilizzare l'entità servizio
applicationId
di Azure Databricks chiamando l'operazioneDELETE /preview/scim/v2/ServicePrincipals
nell'API Entità servizio dell'area di lavoro.
Ad esempio, per ottenere l'elenco dei nomi visualizzati e degli ID applicazione dell'entità servizio disponibili per un'area di lavoro, è possibile chiamare curl
come segue:
curl --netrc --request GET \
https://<databricks-instance>/api/2.0/preview/scim/v2/ServicePrincipals \
| jq '[ .Resources[] | { displayName: .displayName, applicationId: .applicationId } ]'
Sostituire <databricks-instance>
con l'URL di Azure Databricks per area di lavoro, ad esempio adb-1234567890123456.7.azuredatabricks.net
per l'area di lavoro.
Il nome visualizzato dell'entità servizio si trova nel campo dell'output displayName
. Partner Connect genera nomi visualizzati dell'entità servizio usando il formato <PARTNER-NAME>_USER
. Ad esempio, per il partner Fivetran, il nome visualizzato dell'entità servizio è FIVETRAN_USER
.
Il valore dell'ID applicazione dell'entità servizio si trova nel campo dell'output applicationId
, ad esempio 123456a7-8901-2b3c-45de-f678a901b2c
.
Per eliminare l'entità servizio, è possibile chiamare curl
come segue:
curl --netrc --request DELETE \
https://<databricks-instance>/api/2.0/preview/scim/v2/ServicePrincipals/<application-id>
Sostituire:
- Sostituire
<databricks-instance>
con l'URL per area di lavoro, ad esempioadb-1234567890123456.7.azuredatabricks.net
per l'area di lavoro. <application-id>
con il valore dell’ID applicazione dell'entità servizio.
Gli esempi precedenti usano un file .netrc e jq. Si noti che in questo caso, il file.netrc
usa il valore del token di accesso personale, non quello per l'entità servizio.
Dopo aver disconnesso l'area di lavoro da un partner, è possibile pulire tutte le risorse correlate create dal partner nell'area di lavoro. Può includere un'istanza di Warehouse SQL o un cluster e qualsiasi percorso di archiviazione dei dati correlato. Per altre informazioni, si veda Connettersi a un'istanza di SQL Warehouse oppure Eliminare un ambiente di calcolo.
Se si è certi che nell'organizzazione non vi siano altre aree di lavoro collegate al partner, si potrebbe anche eliminare l'account dell'organizzazione con il partner in questione. A tale scopo, contattare il partner per ricevere assistenza. Per i collegamenti di supporto, consultare la guida alla connessione del relativo partner.