Condividi tramite

CLI di Unity Catalog (legacy)

  • Articolo

Importante

Questa documentazione è stata ritirata e potrebbe non essere aggiornata.

Queste informazioni si applicano all'interfaccia della riga di comando di Databricks 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 della riga di comando di Unity Catalog è Sperimentale.

L'interfaccia della riga di comando di Unity Catalog richiede l'interfaccia della riga di comando di Databricks (legacy) 0.17.0 o versione successiva, configurata con l'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.
  • Risorse di condivisione differenziale, ad esempio condivisioni, destinatari e provider.

È possibile eseguire sottocomandi dell'interfaccia della riga di comando di Unity Catalog aggiungendoli a databricks unity-catalog. Questi sottocomandi chiamano l'API catalogo unity, che include anche l'API di condivisione delta.

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

Output:

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 i 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. Vedere 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.

Output:

{}

Vedere 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

Output:

{
  "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.

Output:

{}

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. Vedere Creare credenziali di archiviazione per la connessione ad Azure Data Lake Storage Gen2.

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.

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

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.

Posizione esterna

Usare il unity-catalog external-locations sottocomando per lavorare con posizioni esterne. Si veda Creare una posizione esterna per connettere la memorizzazione cloud ad Azure Databricks.

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 Creare una posizione esterna per connettere l'archiviazione cloud ad Azure Databricks.

Convalidare una coppia di credenziali e una posizione esterna

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

Convalidare un nome di percorso esterno e una coppia di credenziali dopo averli creati

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

Output:

{
  "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

Output:

{
  "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"
}

Output:

{
  "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

Output:

{
  "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

Output:

{
  "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

Output:

{
  "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"
}

Output:

{
  "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

Output:

{
  "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

Output:

{
  "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 Che cosa sono tabelle e viste? e 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

Output:

{
  "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

Usare il unity-catalog permissions sottocomando per usare le autorizzazioni per gli oggetti a protezione diretta. Vedere 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 a protezione diretta

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

Catalogo

databricks unity-catalog permissions get --catalog main

Output:

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

Schema

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

Output:

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

Tabella

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

Output:

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

Credenziali di archiviazione

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

Output:

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

Posizione esterna

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

Output:

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

Aggiornare le autorizzazioni di un oggetto a protezione diretta

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

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" ]
    }
  ]
}

Schema

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" ]
    }
  ]
}

Condivisioni

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 la condivisione differenziale che si vuole condividere come gruppo con destinatari di condivisione differenziale. 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. Vedere anche Creare e gestire condivisioni per la condivisione delta.

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

Output:

{
  "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

Output:

{
  "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

Output:

{
  "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. Vedere anche Gestire l'accesso alle condivisioni dati di condivisione differenziale (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

Output:

{
  "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

Output:

{
  "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

Output:

{
  "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 una condivisione.

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 lavorare con i destinatari dei dati per i metastore del catalogo Unity abilitati per la condivisione differenziale. 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. Vedere Creare e gestire i destinatari dei dati per Delta Sharing.

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 la condivisione delta.

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

Output:

{
  "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"
}

Output:

{
  "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 (condivisione aperta).

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

Output:

{
  "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

Output:

{
  "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

Output:

{
  "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

Output:

{
  "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 con condivisione differenziale, usare il unity-catalog providers sottocomando per lavorare con i provider di dati di condivisione differenziale. Vedere Gestire i provider di condivisione delta (per i destinatari dei dati).

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

Creazione di 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 un amministratore o un utente del metastore con il CREATE_PROVIDER privilegio 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.