Condividi tramite

CLI di Unity Catalog (obsoleto)

Importante

Questa documentazione è stata ritirata e potrebbe non essere aggiornata.

Queste informazioni si applicano alle versioni legacy del Databricks CLI 0.18 e precedenti. Databricks consiglia di usare invece la versione 0.205 o successiva dell'interfaccia della riga di comando. Consultare Che cos'è il Databricks CLI?. Per trovare la versione del Databricks CLI, eseguire databricks -v.

Per eseguire la migrazione dalla CLI di Databricks versione 0.18 o precedente alla CLI di Databricks versione 0.205 o successiva, vedere Migrazione della CLI di Databricks.

Nota

L'interfaccia CLI di Unity Catalog è Sperimentale.

L'interfaccia a riga di comando di Unity Catalog richiede Legacy Databricks CLI versione 0.17.0 o successiva, configurata con autenticazione. Per aggiornare l'interfaccia della riga di comando di Databricks o per elencare la versione installata, vedere Aggiornare l'interfaccia della riga di comando.

I valori di esempio di opzione e campo negli esempi seguenti sono solo a scopo illustrativo.

Usare l'interfaccia della riga di comando di Unity Catalog per lavorare con:

  • Risorse del catalogo Unity, ad esempio metastore, credenziali di archiviazione, posizioni esterne, cataloghi, schemi, tabelle e relative autorizzazioni.
  • Delta Sharing, risorse quali condivisioni, destinatari e provider.

È possibile eseguire i sottocomandi CLI di Unity Catalog aggiungendoli a databricks unity-catalog. Questi sottocomandi chiamano l'API del Catalogo Unity, che include anche l'API di Condivisione Delta.

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog --help.

Risultato:

Usage: databricks unity-catalog [OPTIONS] COMMAND [ARGS]...

  Utility to interact with Databricks Unity Catalog.

Options:
  -v, --version  0.17.1
  -h, --help     Show this message and exit.

Commands:
  catalogs
  external-locations
  lineage
  metastores
  permissions
  providers
  recipients
  schemas
  shares
  storage-credentials
  tables

Metastore

Usare il unity-catalog metastores sottocomando per lavorare con metastore.

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog metastores --help.

Creare un metastore

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog metastores create --help. Consulta anche Creare un metastore del catalogo Unity.

Nota

La creazione di un metastore non associa automaticamente il metastore a un'area di lavoro o a una credenziale di archiviazione. Per completare queste attività, vedere Collegare un metastore a un'area di lavoro, Creare credenziali di archiviazione e Aggiornare le impostazioni di un metastore.

Se si esegue questo comando in un'area di lavoro che dispone già di un metastore assegnato, si aggiornerà il metastore assegnato all'area di lavoro.

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog metastores assign --help.

databricks unity-catalog metastores assign --workspace-id 1234567890123456 \
                                           --metastore-id 12a345b6-7890-1cd2-3456-e789f0a12b34 \
                                           --default-catalog-name main

Per ottenere l'ID dell'area di lavoro, vedere Nomi, URL e ID dell'istanza dell'area di lavoro.

Per ottenere l'ID metastore, eseguire databricks unity-catalog metastores get-summary. Per un esempio, vedere Ottenere informazioni riepilogate sul metastore corrente.

Risultato:

{}

Consulta anche Creare un metastore del catalogo Unity.

Aggiornare le impostazioni di un metastore

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog metastores update --help.

databricks unity-catalog metastores update --id 12a345b6-7890-1cd2-3456-e789f0a12b34 \
                                           --json-file update-metastore.json

Per ottenere l'ID metastore, eseguire databricks unity-catalog metastores get-summary. Per un esempio, vedere Ottenere informazioni riepilogate sul metastore corrente.

update-metastore.json:

{
  "storage_root_credential_id": "12a345b6-7890-1cd2-3456-e789f0a12b34"
}

Per ottenere l'ID credenziale radice di archiviazione, vedere Ottenere informazioni su una credenziale di archiviazione.

Elencare i metastore disponibili

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog metastores list --help.

databricks unity-catalog metastores list

Ottenere informazioni su un metastore

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog metastores get --help.

databricks unity-catalog metastores get --id 12a345b6-7890-1cd2-3456-e789f0a12b34

Per ottenere l'ID metastore, eseguire databricks unity-catalog metastores get-summary. Per un esempio, vedere Ottenere informazioni riepilogate sul metastore corrente.

Ottenere informazioni riepilogate sul metastore corrente

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog metastores get-summary --help.

databricks unity-catalog metastores get-summary

Ottenere l'assegnazione del metastore corrente per un'area di lavoro

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog metastores get-assignment --help.

databricks unity-catalog metastores get-assignment

Risultato:

{
  "workspace_id": 1234567890123456,
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "default_catalog_name": "main"
}

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog metastores unassign --help.

databricks unity-catalog metastores unassign --workspace-id 1234567890123456 \
                                             --metastore-id 12a345b6-7890-1cd2-3456-e789f0a12b34

Per ottenere l'ID dell'area di lavoro, vedere Nomi, URL e ID dell'istanza dell'area di lavoro.

Per ottenere l'ID metastore, eseguire databricks unity-catalog metastores get-summary. Per un esempio, vedere Ottenere informazioni riepilogate sul metastore corrente.

Risultato:

{}

Eliminare un metastore

Avviso

Prima di eliminare un metastore, è necessario eliminare tutte le aree di lavoro che usano il metastore o rimuovere il collegamento del metastore a tali aree di lavoro. Contattare il supporto di Azure Databricks per assistenza per la rimozione dei collegamenti metastore dalle aree di lavoro.

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog metastores delete --help.

Per eliminare forzatamente il metastore, usare l'opzione --force .

databricks unity-catalog metastores delete --id 12a345b6-7890-1cd2-3456-e789f0a12b34

Per ottenere l'ID metastore, eseguire databricks unity-catalog metastores get-summary. Per un esempio, vedere Ottenere informazioni riepilogate sul metastore corrente.

Se l'operazione ha esito positivo, non vengono restituiti risultati.

Credenziali di archiviazione

Usare il unity-catalog storage-credentials sottocomando per usare le credenziali di archiviazione. Consultare Creare credenziali di archiviazione per la connessione ad Azure Data Lake Storage.

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog storage-credentials --help.

Creare credenziali di archiviazione

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog storage-credentials create --help.

Consulta anche Creare credenziali di archiviazione per la connessione ad Azure Data Lake Storage.

Aggiornare le impostazioni delle credenziali di archiviazione

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog storage-credentials update --help.

Elencare le credenziali di archiviazione disponibili

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog storage-credentials list --help.

databricks unity-catalog storage-credentials list

Ottenere informazioni su una credenziale di archiviazione

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog storage-credentials get --help.

databricks unity-catalog storage-credentials get --name my-storage-root-credential

Eliminare una credenziale di archiviazione

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog storage-credentials delete --help.

Per eliminare forzatamente le credenziali di archiviazione, usare l'opzione --force .

databricks unity-catalog storage-credentials delete --name my-storage-root-credential

Se l'operazione ha esito positivo, non vengono restituiti risultati.

Posizioni esterne

Usare il unity-catalog external-locations sottocomando per lavorare con posizioni esterne. Vedere Panoramica delle posizioni esterne.

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog external-locations --help.

Creare un percorso esterno

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog external-locations create --help. Vedere anche Panoramica delle posizioni esterne.

Validare una posizione esterna e una coppia di credenziali

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog external-locations validate --help.

Convalidare un nome di localizzazione esterna e una coppia di credenziali dopo averli creati

databricks unity-catalog external-locations validate --name my-external-location \
                                                     --cred-name my-storage-root-credential

Risultato:

{
  "isDir": true,
  "results": [
    {
      "operation": "READ",
      "result": "PASS"
    },
    {
      "operation": "LIST",
      "result": "PASS"
    },
    {
      "operation": "WRITE",
      "result": "PASS"
    },
    {
      "operation": "DELETE",
      "result": "PASS"
    }
  ]
}

Aggiornare le impostazioni di una posizione esterna

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog external-locations update --help.

databricks unity-catalog external-locations update --name my-external-location \
                                                   --json-file update-external-location.json

udpate-external-location.json:

{
  "name": "my-external-location-2"
}

Elencare le posizioni esterne disponibili

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog external-locations list --help.

databricks unity-catalog external-locations list

Ottenere informazioni su una posizione esterna

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog external-locations get --help.

databricks unity-catalog external-locations get --name my-external-location

Eliminare un percorso esterno

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog external-locations delete --help.

Per eliminare forzatamente la posizione esterna, usare l'opzione --force .

databricks unity-catalog external-locations delete --name my-external-location

Se l'operazione ha esito positivo, non vengono restituiti risultati.

Cataloghi

Usare il unity-catalog catalogs sottocomando per lavorare con i cataloghi.

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog catalogs --help.

Creazione di un catalogo

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog catalogs create --help. Vedere anche Creare cataloghi.

databricks unity-catalog catalogs create --name my-catalog

Risultato:

{
  "name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656113178995,
  "created_by": "someone@example.com",
  "updated_at": 1656113178995,
  "updated_by": "someone@example.com",
  "catalog_type": "MANAGED_CATALOG"
}

Aggiornare le impostazioni di un catalogo

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog catalogs update --help.

databricks unity-catalog catalogs update --name my-catalog \
                                         --json-file update-catalog.json

update-catalog.json:

{
  "name": "my-catalog-2",
  "owner": "someone@example.com"
}

Risultato:

{
  "name": "my-catalog-2",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656355967835,
  "created_by": "someone@example.com",
  "updated_at": 1656356095989,
  "updated_by": "someone@example.com",
  "catalog_type": "MANAGED_CATALOG"
}

Elencare i cataloghi disponibili

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog catalogs list --help.

databricks unity-catalog catalogs list

Risultato:

{
  "catalogs": [
    {
      "name": "main",
      "owner": "someone@example.com",
      "comment": "Main catalog (auto-created)",
      "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656112029355,
      "created_by": "someone@example.com",
      "updated_at": 1656112029355,
      "updated_by": "someone@example.com",
      "catalog_type": "MANAGED_CATALOG"
    },
    {
      "...": "..."
    }
  ]
}

Ottenere informazioni su un catalogo

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog catalogs get --help.

databricks unity-catalog catalogs get --name my-catalog

Risultato:

{
  "name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "created_at": 1656113178995,
  "created_by": "someone@example.com",
  "updated_at": 1656113178995,
  "updated_by": "someone@example.com",
  "catalog_type": "MANAGED_CATALOG"
}

Eliminare un catalogo

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog catalogs delete --help. Vedere anche Eliminare un catalogo.

Per eliminare forzatamente un catalogo, usare l'opzione --purge .

databricks unity-catalog catalogs delete --name my-catalog

Se l'operazione ha esito positivo, non vengono restituiti risultati.

Schemi

Usare il unity-catalog schemas sottocomando per lavorare con gli schemi.

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog schemas --help.

Creare uno schema

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog schemas create --help. Vedere anche Creare schemi.

databricks unity-catalog schemas create --catalog-name my-catalog \
                                        --name my-schema

Risultato:

{
  "name": "my-schema",
  "catalog_name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "full_name": "my-catalog.my-schema",
  "created_at": 1656113607800,
  "created_by": "someone@example.com",
  "updated_at": 1656113607800,
  "updated_by": "someone@example.com"
}

Modificare le impostazioni di uno schema

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog schemas update --help.

databricks unity-catalog schemas update --full-name my-catalog.my-schema \
                                        --json-file update-schema.json

update-schema.json:

{
  "name": "my-schema-2",
  "owner": "someone@example.com"
}

Risultato:

{
  "name": "my-schema-2",
  "catalog_name": "my-catalog",
  "owner": "someone@example.com",
  "comment": "Default schema (auto-created)",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "full_name": "my-catalog.my-schema-2",
  "created_at": 1656355967837,
  "created_by": "someone@example.com",
  "updated_at": 1656356592786,
  "updated_by": "someone@example.com"
}

Elencare gli schemi disponibili

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog schemas list --help.

databricks unity-catalog schemas list --catalog-name my-catalog

Risultato:

{
  "schemas": [
    {
      "name": "default",
      "catalog_name": "my-catalog",
      "owner": "someone@example.com",
      "comment": "Default schema (auto-created)",
      "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "full_name": "my-catalog.default",
      "created_at": 1656113178996,
      "created_by": "someone@example.com",
      "updated_at": 1656113178996,
      "updated_by": "someone@example.com"
    },
    {
      "...": "..."
    }
  ]
}

Ottenere informazioni su uno schema

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog schemas get --help.

databricks unity-catalog schemas get --full-name my-catalog.my-schema

Risultato:

{
  "name": "my-schema",
  "catalog_name": "my-catalog",
  "owner": "someone@example.com",
  "metastore_id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
  "full_name": "my-catalog.my-schema",
  "created_at": 1656113607800,
  "created_by": "someone@example.com",
  "updated_at": 1656113607800,
  "updated_by": "someone@example.com"
}

Eliminare uno schema

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog schemas delete --help. Vedere anche Eliminare uno schema.

Per eliminare forzatamente uno schema, usare l'opzione --purge .

databricks unity-catalog schemas delete --full-name my-catalog.my-schema

Se l'operazione ha esito positivo, non vengono restituiti risultati.

Tabelle

Usare il unity-catalog tables sottocomando per lavorare con le tabelle.

Nota

La creazione di tabelle con l'interfaccia della riga di comando di Unity Catalog non è supportata. Per creare tabelle, vedere Tabelle di Azure Databricks ed Esercitazione: Creare la prima tabella e concedere privilegi.

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog tables --help.

Elencare le tabelle disponibili

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog tables list --help.

databricks unity-catalog tables list --catalog-name main \
                                     --schema-name default

Elencare i riepiloghi delle tabelle disponibili

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog tables list-summaries --help.

databricks unity-catalog tables list-summaries --catalog-name main

Risultato:

{
  "tables": [
    {
      "full_name": "main.default.mytable",
      "table_type": "MANAGED"
    },
    {
      "...": "..."
    }
  ]
}

Ottenere informazioni su una tabella

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog tables get --help.

databricks unity-catalog tables get --full-name main.default.mytable

Elimina una tabella

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog tables delete --help.

databricks unity-catalog tables delete --full-name main.default.mytable

Se l'operazione ha esito positivo, non vengono restituiti risultati.

Lignaggi

Usare il unity-catalog lineage sottocomando per lavorare con le linee guida di tabella e colonna.

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog lineage --help.

Elencare la derivazione di una tabella

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog lineage table --help.

databricks unity-catalog lineage table --table-name main.default.mytable \
                                       --level 1

Elencare la derivazione di una colonna

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog lineage column --help.

databricks unity-catalog lineage column --table-name main.default.mytable \
                                        --column-name id

Autorizzazioni

Utilizzare il unity-catalog permissions sottocomando per gestire le autorizzazioni per gli oggetti proteggibili. Consulta anche Gestire i privilegi nel catalogo Unity.

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog permissions --help.

ottenere informazioni sulle autorizzazioni per un oggetto proteggibile

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog permissions get --help. Vedere anche Privilegi del catalogo Unity e oggetti proteggibili.

Catalogo

databricks unity-catalog permissions get --catalog main

Risultato:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": ["USE CATALOG"]
    }
  ]
}

Diagramma

databricks unity-catalog permissions get --schema main.default

Risultato:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": ["USE SCHEMA"]
    }
  ]
}

Tabella

databricks unity-catalog permissions get --table main.default.mytable

Risultato:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": ["SELECT"]
    }
  ]
}

Credenziali di archiviazione

databricks unity-catalog permissions get --storage-credential my-storage-root-credential

Risultato:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": ["READ_FILES"]
    }
  ]
}

Posizione esterna

databricks unity-catalog permissions get --external-location my-external-location

Risultato:

{
  "privilege_assignments": [
    {
      "principal": "account users",
      "privileges": ["READ_FILES"]
    }
  ]
}

Aggiornare le autorizzazioni di un oggetto proteggibile

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog permissions update --help. Vedere anche Privilegi del catalogo Unity e oggetti proteggibili.

Catalogo

databricks unity-catalog permissions update --catalog \
                                            --json-file update-catalog-permissions.json

update-catalog-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "add": ["USE CATALOG"],
      "remove": ["CREATE SCHEMA"]
    }
  ]
}

Diagramma

databricks unity-catalog permissions update --schema \
                                            --json-file update-schema-permissions.json

update-schema-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "add": ["USE SCHEMA"],
      "remove": ["CREATE TABLE"]
    },
    {
      "principal": "admin team",
      "add": ["CREATE TABLE"]
    }
  ]
}

Tabella

databricks unity-catalog permissions update --table \
                                            --json-file update-table-permissions.json

update-table-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "add": ["SELECT"],
      "remove": ["MODIFY"]
    },
    {
      "principal": "admin team",
      "add": ["ALL"]
    }
  ]
}

Credenziali di archiviazione

databricks unity-catalog permissions update --storage-credential \
                                            --json-file update-storage-credential-permissions.json

update-storage-credential-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "remove": ["READ FILES"]
    },
    {
      "principal": "storage team",
      "add": ["READ FILES", "WRITE FILES", "CREATE EXTERNAL TABLE"]
    },
    {
      "principal": "admin team",
      "add": ["ALL"]
    }
  ]
}

Posizione esterna

databricks unity-catalog permissions update --external-location \
                                            --json-file update-external-location-permissions.json

update-external-location-permissions.json:

{
  "changes": [
    {
      "principal": "account users",
      "remove": ["READ FILES"]
    },
    {
      "principal": "storage team",
      "add": ["READ FILES", "WRITE FILES", "CREATE EXTERNAL TABLE"]
    },
    {
      "principal": "admin team",
      "add": ["ALL"]
    }
  ]
}

Azioni

Usare il unity-catalog shares sottocomando per lavorare con le condivisioni, ovvero oggetti che contengono raccolte di tabelle in un metastore del catalogo Unity abilitato per Delta Sharing e che si desidera condividere come gruppo con i destinatari di Delta Sharing. Una condivisione può contenere tabelle da un solo metastore. Vedere Creare e gestire le condivisioni in Delta Sharing.

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog shares --help.

Creare una condivisione

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog shares create --help. Consulta anche Creare e gestire condivisioni per Delta Sharing.

databricks unity-catalog shares create --name my-share

Risultato:

{
  "name": "my-share",
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

Aggiornare le impostazioni di una condivisione

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog shares update --help. Vedere anche Aggiornare le condivisioni.

Aggiungere una tabella a una condivisione

databricks unity-catalog shares update --name my-share \
                                       --add-table main.default.mytable

Risultato:

{
  "name": "my-share",
  "objects": [
    {
      "name": "main.default.mytable",
      "data_object_type": "TABLE",
      "added_at": 1656434168847,
      "added_by": "someone@example.com",
      "shared_as": "default.mytable",
      "cdf_enabled": false
    }
  ],
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

Vedere anche Aggiungere tabelle a una condivisione.

Rimuovere una tabella da una condivisione

databricks unity-catalog shares update --name my-share \
                                       --remove-table main.default.mytable

Risultato:

{
  "name": "my-share",
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

Vedere anche Aggiungere tabelle a una condivisione.

Aggiornare le autorizzazioni di una condivisione

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog shares update-permissions --help. Vedi anche Gestire l'accesso alle condivisioni dati di Delta Sharing (per i provider).

databricks unity-catalog shares update-permissions --name my-share \
                                                   --json-file update-share-permissions.json

update-share-permissions.json:

{
  "privilege_assignments": [
    {
      "principal": "my-recipient",
      "privileges": ["SELECT"]
    }
  ]
}

Elencare le condivisioni disponibili

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog shares list --help. Vedere anche Visualizzare le condivisioni e condividere i dettagli.

databricks unity-catalog shares list

Risultato:

{
  "shares": [
    {
      "name": "my-share",
      "created_at": 1656433327533,
      "created_by": "someone@example.com",
      "owner": "someone@example.com"
    },
    {
      "...": "..."
    }
  ]
}

Ottenere informazioni su una condivisione

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog shares get --help. Vedere anche Visualizzare le condivisioni e condividere i dettagli.

databricks unity-catalog shares get --name my-share

Risultato:

{
  "name": "my-share",
  "created_at": 1656433327533,
  "created_by": "someone@example.com",
  "owner": "someone@example.com"
}

Elencare le autorizzazioni di una condivisione

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog shares list-permissions --help. Vedere anche Visualizzare i destinatari che dispongono delle autorizzazioni per una condivisione.

databricks unity-catalog shares list-permissions --name my-share

Risultato:

{
  "privilege_assignments": [
    {
      "principal": "my-recipient",
      "privileges": ["SELECT"]
    }
  ]
}

Eliminare una condivisione

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog shares delete --help. Vedere anche Eliminare condivisioni.

databricks unity-catalog shares delete --name my-share

Se l'operazione ha esito positivo, non vengono restituiti risultati.

Destinatari

Usare il unity-catalog recipients sottocomando per gestire i destinatari dei dati nei metastore del catalogo Unity abilitati per Delta Sharing. I destinatari dei dati sono persone o gruppi che un utente di Azure Databricks condivide i dati con all'esterno dell'organizzazione dell'utente di Azure Databricks. Vedi Creare e gestire i destinatari dei dati per Delta Sharing (condivisione da Databricks a Databricks).

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog recipients --help.

Creare un destinatario

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog recipients create --help. Vedere anche Creare e gestire i destinatari dei dati per il Delta Sharing (condivisione da Databricks a Databricks).

Per generare un nuovo URL di attivazione per un destinatario, eseguire databricks unity-catalog recipients rotate-token. Per un esempio, vedere Ruotare il token di un destinatario.

databricks unity-catalog recipients create --name my-recipient

Risultato:

{
  "name": "my-recipient",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656521688006,
      "updated_at": 1656435288006,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656435288003,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

Modificare le impostazioni di un destinatario

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog recipients update --help.

databricks unity-catalog recipients update --name my-recipient \
                                           --json-file update-recipient-settings.json

update-recipient-settings.json:

{
  "name": "my-recipient-2"
}

Risultato:

{
  "name": "my-recipient-2",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "expiration_time": 1656436808507,
      "updated_at": 1656435908507,
      "updated_by": "someone@example.com"
    },
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435908509,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656522308510,
      "updated_at": 1656435908510,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656436740986,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

Ruotare il token di un destinatario

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog recipients rotate-token --help. Vedere anche Gestire i token dei destinatari.

databricks unity-catalog recipients rotate-token --name my-recipient \
                                                 --existing-token-expire-in-seconds 900

Risultato:

{
  "name": "my-recipient",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "expiration_time": 1656436808507,
      "updated_at": 1656435908507,
      "updated_by": "someone@example.com"
    },
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435908509,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656522308510,
      "updated_at": 1656435908510,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656435288003,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

Elencare i destinatari disponibili

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog recipients list --help. Vedere anche Visualizzare i destinatari.

databricks unity-catalog recipients list

Risultato:

{
  "recipients": [
    {
      "name": "my-recipient",
      "created_at": 1656435288003,
      "created_by": "someone@example.com",
      "tokens": [
        {
          "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
          "created_at": 1656435288005,
          "created_by": "someone@example.com",
          "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
          "expiration_time": 1656521688006,
          "updated_at": 1656435288006,
          "updated_by": "someone@example.com"
        }
      ],
      "authentication_type": "TOKEN",
      "updated_at": 1656435288003,
      "updated_by": "someone@example.com",
      "owner": "someone@example.com"
    }
  ]
}

Elencare le autorizzazioni di condivisione di un destinatario

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog recipients list-permissions --help. Vedere anche Visualizzare le autorizzazioni di condivisione di un destinatario.

databricks unity-catalog recipients list-permissions --name my-recipient

Risultato:

{
  "permissions_out": [
    {
      "share_name": "my-share",
      "privilege_assignments": [
        {
          "privileges": ["SELECT"]
        }
      ]
    }
  ]
}

Ottenere informazioni su un destinatario

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog recipients get --help. Vedere anche Visualizzare i dettagli del destinatario.

databricks unity-catalog recipients get --name my-recipient

Risultato:

{
  "name": "my-recipient",
  "created_at": 1656435288003,
  "created_by": "someone@example.com",
  "tokens": [
    {
      "id": "12a345b6-7890-1cd2-3456-e789f0a12b34",
      "created_at": 1656435288005,
      "created_by": "someone@example.com",
      "activation_url": "https://example.com/delta_sharing/retrieve_config.html?<unique-id>",
      "expiration_time": 1656521688006,
      "updated_at": 1656435288006,
      "updated_by": "someone@example.com"
    }
  ],
  "authentication_type": "TOKEN",
  "updated_at": 1656435288003,
  "updated_by": "someone@example.com",
  "owner": "someone@example.com"
}

Eliminare un destinatario

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog recipients delete --help. Vedere anche Eliminare un destinatario.

databricks unity-catalog recipients delete --name my-recipient

Se l'operazione ha esito positivo, non vengono restituiti risultati.

Provider

Se si è un destinatario di dati condivisi tramite Delta Sharing, usare il unity-catalog providers sottocomando per lavorare con i fornitori di dati Delta Sharing. Vedere Gestire i provider di condivisione delta (per i destinatari dei dati).

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog providers --help.

Crea un provider

Se si è un destinatario di dati condivisi usando il protocollo di condivisione aperto e si usa un'area di lavoro databricks collegata a un metastore del catalogo Unity, è possibile creare un oggetto provider nel metastore del catalogo Unity. È quindi possibile gestire l'accesso ai dati condivisi usando Unity Catalog.

Importante

Questo scenario è raro. Se si usa un'area di lavoro di Databricks abilitata per Unity Catalog e un altro cliente di Databricks condivide i dati con l'utente, è consigliabile usare la condivisione da Databricks a Databricks. Con la condivisione da Databricks a Databricks, gli oggetti provider vengono creati automaticamente in Unity Catalog.

Per creare un provider, è necessario:

  • Essere amministratore o utente del metastore con il privilegio CREATE PROVIDER per il metastore.
  • Avere accesso al file di credenziali scaricato. Vedere Ottenere l'accesso nel modello di condivisione aperta.

Eseguire il comando seguente, sostituendo my-provider con il nome che si vuole assegnare al provider e config.share con il percorso del file di credenziali scaricato, denominato config.share per impostazione predefinita.

databricks unity-catalog providers create --name my-provider  \
                  --recipient-profile-json-file config.share

Aggiornare le impostazioni di un provider

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog providers update --help.

databricks unity-catalog providers update --name my-provider \
                                          --new-name my-provider-2

Elencare i provider disponibili

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog providers list --help.

databricks unity-catalog providers list

Ottenere informazioni su un provider

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog providers get --help.

databricks unity-catalog providers get --name my-provider

Elencare le condivisioni disponibili di un provider

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog providers list-shares --help.

databricks unity-catalog providers list-shares --name my-provider

Eliminare un provider

Per visualizzare la documentazione sull'utilizzo, eseguire databricks unity-catalog providers delete --help.

databricks unity-catalog providers delete --name my-provider

Se l'operazione ha esito positivo, non vengono restituiti risultati.

  • Last updated on