Unity Catalog CLI (verouderd)

Belangrijk

Deze documentatie is buiten gebruik gesteld en wordt mogelijk niet bijgewerkt.

Deze informatie is van toepassing op verouderde Databricks CLI-versies 0.18 en lager. Databricks raadt u aan om in plaats daarvan nieuwere Databricks CLI versie 0.205 of hoger te gebruiken. Zie Wat is de Databricks CLI? Voer de opdracht uit databricks -vom uw versie van de Databricks CLI te vinden.

Als u wilt migreren van Databricks CLI versie 0.18 of lager naar Databricks CLI versie 0.205 of hoger, raadpleegt u de Cli-migratie van Databricks.

Notitie

De Unity Catalog CLI is experimenteel.

Voor de Unity Catalog CLI is Databricks CLI (verouderd) 0.17.0 of hoger vereist, geconfigureerd met verificatie. Zie De CLI bijwerken om de Databricks CLI bij te werken of om de geïnstalleerde versie weer te geven.

Waarden voor optie- en veldvoorbeelden in de volgende voorbeelden zijn alleen bedoeld voor illustratieve doeleinden.

Gebruik de Unity Catalog CLI om te werken met:

• Unity Catalog-resources zoals metastores, opslagreferenties, externe locaties, catalogi, schema's, tabellen en hun machtigingen.
• Delta Sharing-resources , zoals shares, ontvangers en providers.

U voert Unity Catalog CLI-subopdrachten uit door ze toe te voegen aan databricks unity-catalog. Deze subopdrachten roepen de Unity Catalog-API aan, die ook de Delta Sharing-API omvat.

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog --help.

Uitvoer:

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

Metastores

Gebruik de unity-catalog metastores subopdracht om te werken met metastores.

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog metastores --help.

• Een metastore maken
• Een metastore koppelen aan een werkruimte
• De instellingen van een metastore bijwerken
• Beschikbare metastores weergeven
• Informatie ophalen over een metastore
• Samengevatte informatie over de huidige metastore ophalen
• De huidige metastore-toewijzing voor een werkruimte ophalen
• Een metastore loskoppelen van een werkruimte
• Een metastore verwijderen

Een metastore maken

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog metastores create --help. Zie ook Een Unity Catalog-metastore maken.

Notitie

Het maken van een metastore koppelt de metastore niet automatisch aan een werkruimte of een opslagreferentie. Zie Een metastore koppelen aan een werkruimte, een opslagreferentie maken en de instellingen van een metastore bijwerken om deze taken te voltooien.

Een metastore koppelen aan een werkruimte

Als u deze opdracht uitvoert op een werkruimte die al een toegewezen metastore heeft, werkt u de toegewezen metastore van die werkruimte bij.

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit 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

Als u de werkruimte-id wilt ophalen, raadpleegt u de namen, URL's en id's van het werkruimte-exemplaar.

Voer uit databricks unity-catalog metastores get-summaryom de metastore-id op te halen. Zie Samengevatte informatie over de huidige metastore ophalen voor een voorbeeld.

Uitvoer:

{}

Zie ook Een Unity Catalog-metastore maken.

De instellingen van een metastore bijwerken

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog metastores update --help.

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

Voer uit databricks unity-catalog metastores get-summaryom de metastore-id op te halen. Zie Samengevatte informatie over de huidige metastore ophalen voor een voorbeeld.

update-metastore.json:

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

Zie Informatie over een opslagreferentie ophalen om de referentie-id van de opslagmap op te halen.

Beschikbare metastores weergeven

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog metastores list --help.

databricks unity-catalog metastores list

Informatie ophalen over een metastore

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog metastores get --help.

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

Voer uit databricks unity-catalog metastores get-summaryom de metastore-id op te halen. Zie Samengevatte informatie over de huidige metastore ophalen voor een voorbeeld.

Samengevatte informatie over de huidige metastore ophalen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog metastores get-summary --help.

databricks unity-catalog metastores get-summary

De huidige metastore-toewijzing voor een werkruimte ophalen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog metastores get-assignment --help.

databricks unity-catalog metastores get-assignment

Uitvoer:

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

Een metastore loskoppelen van een werkruimte

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog metastores unassign --help.

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

Als u de werkruimte-id wilt ophalen, raadpleegt u de namen, URL's en id's van het werkruimte-exemplaar.

Voer uit databricks unity-catalog metastores get-summaryom de metastore-id op te halen. Zie Samengevatte informatie over de huidige metastore ophalen voor een voorbeeld.

Uitvoer:

{}

Een metastore verwijderen

Waarschuwing

Voordat u een metastore verwijdert, moet u werkruimten verwijderen die gebruikmaken van de metastore of de metastore-koppeling naar die werkruimten verwijderen. Neem contact op met de ondersteuning van Azure Databricks voor hulp bij het verwijderen van metastore-koppelingen uit werkruimten.

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog metastores delete --help.

Gebruik de --force optie om de metastore geforceerd te verwijderen.

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

Voer uit databricks unity-catalog metastores get-summaryom de metastore-id op te halen. Zie Samengevatte informatie over de huidige metastore ophalen voor een voorbeeld.

Als de bewerking is geslaagd, worden er geen resultaten geretourneerd.

Opslagreferenties

Gebruik de unity-catalog storage-credentials subopdracht om te werken met opslagreferenties. Zie Een opslagreferentie maken om verbinding te maken met Azure Data Lake Storage Gen2.

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog storage-credentials --help.

• Een opslagreferentie maken
• De instellingen van een opslagreferentie bijwerken
• Beschikbare opslagreferenties weergeven
• Informatie ophalen over een opslagreferentie
• Een opslagreferentie verwijderen

Een opslagreferentie maken

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog storage-credentials create --help.

Zie ook Een opslagreferentie maken om verbinding te maken met Azure Data Lake Storage Gen2.

De instellingen van een opslagreferentie bijwerken

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog storage-credentials update --help.

Beschikbare opslagreferenties weergeven

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog storage-credentials list --help.

databricks unity-catalog storage-credentials list

Informatie ophalen over een opslagreferentie

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog storage-credentials get --help.

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

Een opslagreferentie verwijderen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog storage-credentials delete --help.

Als u de opslagreferenties geforceerd wilt verwijderen, gebruikt u de --force optie.

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

Als de bewerking is geslaagd, worden er geen resultaten geretourneerd.

Externe locaties

Gebruik de unity-catalog external-locations subopdracht om met externe locaties te werken. Zie Een externe locatie maken om cloudopslag te verbinden met Azure Databricks.

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog external-locations --help.

• Een externe locatie maken
• Een externe locatie en referentiepaar valideren
  • Een externe locatienaam en referentiepaar valideren nadat u deze hebt gemaakt
• De instellingen van een externe locatie bijwerken
• Beschikbare externe locaties weergeven
• Informatie over een externe locatie ophalen
• Een externe locatie verwijderen

Een externe locatie maken

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog external-locations create --help. Zie ook Een externe locatie maken om cloudopslag te verbinden met Azure Databricks.

Een externe locatie en referentiepaar valideren

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog external-locations validate --help.

Een externe locatienaam en referentiepaar valideren nadat u deze hebt gemaakt

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

Uitvoer:

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

De instellingen van een externe locatie bijwerken

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit 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"
}

Beschikbare externe locaties weergeven

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog external-locations list --help.

databricks unity-catalog external-locations list

Informatie over een externe locatie ophalen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog external-locations get --help.

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

Een externe locatie verwijderen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog external-locations delete --help.

Als u de externe locatie geforceerd wilt verwijderen, gebruikt u de --force optie.

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

Als de bewerking is geslaagd, worden er geen resultaten geretourneerd.

Catalogi

Gebruik de unity-catalog catalogs subopdracht om met catalogi te werken.

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog catalogs --help.

• Een catalogus maken
• De instellingen van een catalogus bijwerken
• Beschikbare catalogussen weergeven
• Informatie over een catalogus ophalen
• Een catalogus verwijderen

Een catalogus maken

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog catalogs create --help. Zie ook Catalogussen maken.

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

Uitvoer:

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

De instellingen van een catalogus bijwerken

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit 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"
}

Uitvoer:

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

Beschikbare catalogussen weergeven

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog catalogs list --help.

databricks unity-catalog catalogs list

Uitvoer:

{
  "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"
    },
    {
      "...": "..."
    }
  ]
}

Informatie over een catalogus ophalen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog catalogs get --help.

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

Uitvoer:

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

Een catalogus verwijderen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog catalogs delete --help. Zie ook Een catalogus verwijderen.

Als u een catalogus geforceerd wilt verwijderen, gebruikt u de --purge optie.

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

Als de bewerking is geslaagd, worden er geen resultaten geretourneerd.

Schema's

Gebruik de unity-catalog schemas subopdracht om met schema's te werken.

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog schemas --help.

• Een schema maken
• De instellingen van een schema wijzigen
• Beschikbare schema's weergeven
• Informatie over een schema ophalen
• Een schema verwijderen

Een schema maken

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog schemas create --help. Zie ook Schema's maken.

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

Uitvoer:

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

De instellingen van een schema wijzigen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit 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"
}

Uitvoer:

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

Beschikbare schema's weergeven

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog schemas list --help.

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

Uitvoer:

{
  "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"
    },
    {
      "...": "..."
    }
  ]
}

Informatie over een schema ophalen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog schemas get --help.

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

Uitvoer:

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

Een schema verwijderen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog schemas delete --help. Zie ook Een schema verwijderen.

Als u een schema geforceerd wilt verwijderen, gebruikt u de --purge optie.

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

Als de bewerking is geslaagd, worden er geen resultaten geretourneerd.

Tabellen

Gebruik de unity-catalog tables subopdracht om met tabellen te werken.

Notitie

Het maken van tabellen met de Unity Catalog CLI wordt niet ondersteund. Als u tabellen wilt maken, raadpleegt u Wat zijn tabellen en weergaven? en Zelfstudie: Uw eerste tabel maken en bevoegdheden verlenen.

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog tables --help.

• Beschikbare tabellen weergeven
• Overzichten van beschikbare tabellen weergeven
• Informatie over een tabel ophalen
• Een tabel verwijderen

Beschikbare tabellen weergeven

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog tables list --help.

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

Overzichten van beschikbare tabellen weergeven

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog tables list-summaries --help.

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

Uitvoer:

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

Informatie over een tabel ophalen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog tables get --help.

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

Een tabel verwijderen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog tables delete --help.

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

Als de bewerking is geslaagd, worden er geen resultaten geretourneerd.

Herkomsten

Gebruik de unity-catalog lineage subopdracht om te werken met tabel- en kolomherkomsten.

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog lineage --help.

• De herkomst van een tabel weergeven
• De herkomst van een kolom weergeven

De herkomst van een tabel weergeven

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog lineage table --help.

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

De herkomst van een kolom weergeven

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog lineage column --help.

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

Machtigingen

Gebruik de unity-catalog permissions subopdracht om te werken met machtigingen voor beveiligbare objecten. Zie ook Bevoegdheden beheren in Unity Catalog.

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog permissions --help.

• Informatie ophalen over machtigingen voor een beveiligbaar object
  • Catalogus
  • Schema
  • Tabel
  • Opslagreferenties
  • Externe locatie
• De machtigingen van een beveiligbaar object bijwerken
  • Catalogus
  • Schema
  • Tabel
  • Opslagreferenties
  • Externe locatie

Informatie ophalen over machtigingen voor een beveiligbaar object

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog permissions get --help. Zie ook Unity Catalog-bevoegdheden en beveiligbare objecten.

Catalogus

databricks unity-catalog permissions get --catalog main

Uitvoer:

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

Schema

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

Uitvoer:

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

Tabel

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

Uitvoer:

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

Opslagreferentie

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

Uitvoer:

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

Externe locatie

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

Uitvoer:

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

De machtigingen van een beveiligbaar object bijwerken

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog permissions update --help. Zie ook Unity Catalog-bevoegdheden en beveiligbare objecten.

Catalogus

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

Tabel

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

Opslagreferentie

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

Externe locatie

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

Shares

Gebruik de unity-catalog shares subopdracht om te werken met shares. Dit zijn objecten die verzamelingen tabellen bevatten in een met Delta Sharing ingeschakelde Unity Catalog-metastore die u wilt delen als groep met ontvangers van Delta Sharing. Een share kan tabellen uit slechts één metastore bevatten. Zie Shares maken en beheren voor Delta Sharing.

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog shares --help.

• Een share maken
• De instellingen van een share bijwerken
  • Een tabel toevoegen aan een share
  • Een tabel uit een share verwijderen
• Machtigingen van een share bijwerken
• Beschikbare shares weergeven
• Informatie over een share ophalen
• De machtigingen van een share weergeven
• Een share verwijderen

Een share maken

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog shares create --help. Zie ook Shares maken en beheren voor Delta Sharing.

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

Uitvoer:

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

De instellingen van een share bijwerken

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog shares update --help. Zie ook Updateshares.

Een tabel toevoegen aan een share

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

Uitvoer:

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

Zie ook Tabellen toevoegen aan een share.

Een tabel uit een share verwijderen

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

Uitvoer:

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

Zie ook Tabellen toevoegen aan een share.

Machtigingen van een share bijwerken

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog shares update-permissions --help. Zie ook Toegang tot Delta Sharing-gegevensshares beheren (voor providers).

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

Beschikbare shares weergeven

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog shares list --help. Zie ook Shares weergeven en details delen.

databricks unity-catalog shares list

Uitvoer:

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

Informatie over een share ophalen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog shares get --help. Zie ook Shares weergeven en details delen.

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

Uitvoer:

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

De machtigingen van een share weergeven

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog shares list-permissions --help. Zie ook De geadresseerden weergeven die machtigingen hebben voor een share.

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

Uitvoer:

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

Een share verwijderen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog shares delete --help. Zie ook Een share verwijderen.

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

Als de bewerking is geslaagd, worden er geen resultaten geretourneerd.

Ontvangers

Gebruik de unity-catalog recipients subopdracht om te werken met gegevensontvangers voor metastores met Unity Catalog met Delta Sharing ingeschakeld. Gegevensontvangers zijn personen of groepen met wie een Azure Databricks-gebruiker gegevens deelt buiten de organisatie van de Azure Databricks-gebruiker. Zie Gegevensontvangers maken en beheren voor Delta Sharing.

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog recipients --help.

• Een geadresseerde maken
• De instellingen van een geadresseerde wijzigen
• Het token van een geadresseerde draaien
• Beschikbare geadresseerden weergeven
• De sharemachtigingen van een geadresseerde weergeven
• Informatie over een geadresseerde ophalen
• Een geadresseerde verwijderen

Een geadresseerde maken

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog recipients create --help. Zie ook Gegevensontvangers maken en beheren voor Delta Sharing.

Als u een nieuwe activerings-URL voor een geadresseerde wilt genereren, voert u het volgende uit databricks unity-catalog recipients rotate-token. Zie Bijvoorbeeld het token van een geadresseerde draaien.

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

Uitvoer:

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

De instellingen van een geadresseerde wijzigen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit 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"
}

Uitvoer:

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

Het token van een geadresseerde draaien

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog recipients rotate-token --help. Zie ook Ontvangerstokens beheren (openen voor delen).

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

Uitvoer:

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

Beschikbare geadresseerden weergeven

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog recipients list --help. Zie ook Ontvangers weergeven.

databricks unity-catalog recipients list

Uitvoer:

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

De sharemachtigingen van een geadresseerde weergeven

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog recipients list-permissions --help. Zie ook De sharemachtigingen van een geadresseerde weergeven.

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

Uitvoer:

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

Informatie over een geadresseerde ophalen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog recipients get --help. Zie ook Details van geadresseerden weergeven.

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

Uitvoer:

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

Een geadresseerde verwijderen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog recipients delete --help. Zie ook Een geadresseerde verwijderen.

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

Als de bewerking is geslaagd, worden er geen resultaten geretourneerd.

Providers

Als u een ontvanger van gedeelde deltagegevens bent, gebruikt u de unity-catalog providers subopdracht om met Delta Sharing-gegevensproviders te werken. Zie Delta Sharing-providers beheren (voor gegevensontvangers).

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog providers --help.

• Een provider maken
• De instellingen van een provider bijwerken
• Beschikbare providers vermelden
• Informatie over een provider ophalen
• De beschikbare shares van een provider weergeven
• Een provider verwijderen

Een provider maken

Als u een ontvanger bent van gegevens die worden gedeeld met behulp van het open sharing-protocol en u een Databricks-werkruimte gebruikt die is gekoppeld aan een Unity Catalog-metastore, kunt u een providerobject maken in uw Unity Catalog-metastore. Vervolgens kunt u de toegang tot de gedeelde gegevens beheren met behulp van Unity Catalog.

Belangrijk

Dit scenario is zeldzaam. Als u een Databricks-werkruimte gebruikt die is ingeschakeld voor Unity Catalog en een andere Databricks-klant gegevens met u deelt, moeten ze Databricks-to-Databricks delen. Met het delen van Databricks naar Databricks worden providerobjecten voor u gemaakt in Unity Catalog.

Als u een provider wilt maken, moet u het volgende doen:

• Wees een metastore-beheerder of gebruiker met de CREATE_PROVIDER bevoegdheid voor de metastore.
• Toegang hebben tot het gedownloade referentiebestand. Zie Toegang krijgen in het open sharing-model.

Voer de volgende opdracht uit, waarbij my-provider u vervangt door de naam die u aan de provider wilt geven en config.share door het pad naar het gedownloade referentiebestand, dat standaard de naam config.share heeft.

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

De instellingen van een provider bijwerken

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog providers update --help.

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

Beschikbare providers vermelden

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog providers list --help.

databricks unity-catalog providers list

Informatie over een provider ophalen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog providers get --help.

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

De beschikbare shares van een provider weergeven

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog providers list-shares --help.

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

Een provider verwijderen

Als u de gebruiksdocumentatie wilt weergeven, voert u het volgende uit databricks unity-catalog providers delete --help.

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

Als de bewerking is geslaagd, worden er geen resultaten geretourneerd.