Dela via

Unity Catalog CLI (äldre)

  • Artikel

Viktigt!

Den här dokumentationen har dragits tillbaka och kanske inte uppdateras.

Den här informationen gäller för äldre Databricks CLI-versioner 0.18 och senare. Databricks rekommenderar att du använder nyare Databricks CLI version 0.205 eller senare i stället. Se Vad är Databricks CLI?. Kör för att hitta din version av Databricks CLI databricks -v.

Information om hur du migrerar från Databricks CLI version 0.18 eller senare till Databricks CLI version 0.205 eller senare finns i Databricks CLI-migrering.

Kommentar

Unity Catalog CLI är experimentellt.

Unity Catalog CLI kräver Databricks CLI (äldre) 0.17.0 eller senare, konfigurerat med autentisering. Information om hur du uppdaterar Databricks CLI eller om du vill visa en lista över den installerade versionen finns i Uppdatera CLI.

Alternativ- och fältexempelvärdena i följande exempel är endast för illustrativa ändamål.

Använd Unity Catalog CLI för att arbeta med:

Du kör Cli-underkommandon för Unity Catalog genom att lägga till dem i databricks unity-catalog. Dessa underkommandon anropar Unity Catalog-API:et, som även innehåller API:et för deltadelning.

Om du vill visa användningsdokumentationen kör du databricks unity-catalog --help.

Utdata:

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

Metaarkiv

unity-catalog metastores Använd underkommandot för att arbeta med metaarkiv.

Om du vill visa användningsdokumentationen kör du databricks unity-catalog metastores --help.

Skapa ett metaarkiv

Om du vill visa användningsdokumentationen kör du databricks unity-catalog metastores create --help. Se även Skapa ett Unity Catalog-metaarkiv.

Kommentar

När du skapar ett metaarkiv associeras inte metaarkivet automatiskt med en arbetsyta eller en lagringsautentiseringsuppgift. Information om hur du utför dessa uppgifter finns i Länka ett metaarkiv med en arbetsyta, Skapa en lagringsautentiseringsuppgift och Uppdatera inställningarna för ett metaarkiv.

Om du kör det här kommandot på en arbetsyta som redan har ett tilldelat metaarkiv uppdaterar du den arbetsytans tilldelade metaarkiv.

Om du vill visa användningsdokumentationen kör du 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

Information om hur du hämtar arbetsytans ID finns i Namn på arbetsyteinstanser, URL:er och ID:er.

Hämta metaarkiv-ID:t genom att köra databricks unity-catalog metastores get-summary. Ett exempel finns i Hämta sammanfattad information om det aktuella metaarkivet.

Utdata:

{}

Se även Skapa ett Unity Catalog-metaarkiv.

Uppdatera inställningarna för ett metaarkiv

Om du vill visa användningsdokumentationen kör du databricks unity-catalog metastores update --help.

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

Hämta metaarkiv-ID:t genom att köra databricks unity-catalog metastores get-summary. Ett exempel finns i Hämta sammanfattad information om det aktuella metaarkivet.

update-metastore.json:

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

Information om hur du hämtar lagringsrotens autentiserings-ID finns i Hämta information om en lagringsautentiseringsuppgift.

Lista tillgängliga metaarkiv

Om du vill visa användningsdokumentationen kör du databricks unity-catalog metastores list --help.

databricks unity-catalog metastores list

Hämta information om ett metaarkiv

Om du vill visa användningsdokumentationen kör du databricks unity-catalog metastores get --help.

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

Hämta metaarkiv-ID:t genom att köra databricks unity-catalog metastores get-summary. Ett exempel finns i Hämta sammanfattad information om det aktuella metaarkivet.

Hämta sammanfattad information om det aktuella metaarkivet

Om du vill visa användningsdokumentationen kör du databricks unity-catalog metastores get-summary --help.

databricks unity-catalog metastores get-summary

Hämta den aktuella metaarkivtilldelningen för en arbetsyta

Om du vill visa användningsdokumentationen kör du databricks unity-catalog metastores get-assignment --help.

databricks unity-catalog metastores get-assignment

Utdata:

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

Om du vill visa användningsdokumentationen kör du databricks unity-catalog metastores unassign --help.

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

Information om hur du hämtar arbetsytans ID finns i Namn på arbetsyteinstanser, URL:er och ID:er.

Hämta metaarkiv-ID:t genom att köra databricks unity-catalog metastores get-summary. Ett exempel finns i Hämta sammanfattad information om det aktuella metaarkivet.

Utdata:

{}

Ta bort ett metaarkiv

Varning

Innan du tar bort ett metaarkiv måste du ta bort alla arbetsytor som använder metaarkivet eller ta bort metaarkivlänken till dessa arbetsytor. Kontakta Azure Databricks-supporten om du vill ha hjälp med att ta bort metaarkivlänkar från arbetsytor.

Om du vill visa användningsdokumentationen kör du databricks unity-catalog metastores delete --help.

Om du vill ta bort metaarkivet med två två skäl använder du alternativet --force .

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

Hämta metaarkiv-ID:t genom att köra databricks unity-catalog metastores get-summary. Ett exempel finns i Hämta sammanfattad information om det aktuella metaarkivet.

Om åtgärden lyckas returneras inga resultat.

Autentiseringsuppgifter för lagring

unity-catalog storage-credentials Använd underkommandot för att arbeta med autentiseringsuppgifter för lagring. Se Skapa en lagringsautentiseringsuppgift för anslutning till Azure Data Lake Storage Gen2.

Om du vill visa användningsdokumentationen kör du databricks unity-catalog storage-credentials --help.

Skapa en lagringsautentiseringsuppgift

Om du vill visa användningsdokumentationen kör du databricks unity-catalog storage-credentials create --help.

Se även Skapa en lagringsautentiseringsuppgift för anslutning till Azure Data Lake Storage Gen2.

Uppdatera inställningarna för en lagringsautentiseringsuppgift

Om du vill visa användningsdokumentationen kör du databricks unity-catalog storage-credentials update --help.

Visa en lista över tillgängliga autentiseringsuppgifter för lagring

Om du vill visa användningsdokumentationen kör du databricks unity-catalog storage-credentials list --help.

databricks unity-catalog storage-credentials list

Hämta information om en lagringsautentiseringsuppgift

Om du vill visa användningsdokumentationen kör du databricks unity-catalog storage-credentials get --help.

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

Ta bort en lagringsautentiseringsuppgift

Om du vill visa användningsdokumentationen kör du databricks unity-catalog storage-credentials delete --help.

Om du vill ta bort lagringsautentiseringsuppgifterna med två två skäl använder du alternativet --force .

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

Om åtgärden lyckas returneras inga resultat.

Externa platser

unity-catalog external-locations Använd underkommandot för att arbeta med externa platser. Se Skapa en extern plats för att ansluta molnlagring till Azure Databricks.

Om du vill visa användningsdokumentationen kör du databricks unity-catalog external-locations --help.

Skapa en extern plats

Om du vill visa användningsdokumentationen kör du databricks unity-catalog external-locations create --help. Se även Skapa en extern plats för att ansluta molnlagring till Azure Databricks.

Verifiera en extern plats och ett par med autentiseringsuppgifter

Om du vill visa användningsdokumentationen kör du databricks unity-catalog external-locations validate --help.

Verifiera ett externt platsnamn och autentiseringsuppgiftspar när du har skapat dem

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

Utdata:

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

Uppdatera inställningarna för en extern plats

Om du vill visa användningsdokumentationen kör du 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"
}

Visa en lista över tillgängliga externa platser

Om du vill visa användningsdokumentationen kör du databricks unity-catalog external-locations list --help.

databricks unity-catalog external-locations list

Hämta information om en extern plats

Om du vill visa användningsdokumentationen kör du databricks unity-catalog external-locations get --help.

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

Ta bort en extern plats

Om du vill visa användningsdokumentationen kör du databricks unity-catalog external-locations delete --help.

Om du vill ta bort den externa platsen med två två skäl använder du alternativet --force .

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

Om åtgärden lyckas returneras inga resultat.

Kataloger

unity-catalog catalogs Använd underkommandot för att arbeta med kataloger.

Om du vill visa användningsdokumentationen kör du databricks unity-catalog catalogs --help.

Skapa en katalog

Om du vill visa användningsdokumentationen kör du databricks unity-catalog catalogs create --help. Se även Skapa kataloger.

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

Utdata:

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

Uppdatera en katalogs inställningar

Om du vill visa användningsdokumentationen kör du 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"
}

Utdata:

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

Lista tillgängliga kataloger

Om du vill visa användningsdokumentationen kör du databricks unity-catalog catalogs list --help.

databricks unity-catalog catalogs list

Utdata:

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

Hämta information om en katalog

Om du vill visa användningsdokumentationen kör du databricks unity-catalog catalogs get --help.

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

Utdata:

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

Ta bort en katalog

Om du vill visa användningsdokumentationen kör du databricks unity-catalog catalogs delete --help. Se även Ta bort en katalog.

Om du vill ta bort en katalog med två två skäl använder du alternativet --purge .

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

Om åtgärden lyckas returneras inga resultat.

Scheman

unity-catalog schemas Använd underkommandot för att arbeta med scheman.

Om du vill visa användningsdokumentationen kör du databricks unity-catalog schemas --help.

Skapa ett schema

Om du vill visa användningsdokumentationen kör du databricks unity-catalog schemas create --help. Se även Skapa scheman.

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

Utdata:

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

Ändra inställningarna för ett schema

Om du vill visa användningsdokumentationen kör du 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"
}

Utdata:

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

Lista tillgängliga scheman

Om du vill visa användningsdokumentationen kör du databricks unity-catalog schemas list --help.

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

Utdata:

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

Hämta information om ett schema

Om du vill visa användningsdokumentationen kör du databricks unity-catalog schemas get --help.

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

Utdata:

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

Ta bort ett schema

Om du vill visa användningsdokumentationen kör du databricks unity-catalog schemas delete --help. Se även Ta bort ett schema.

Om du vill ta bort ett schema med två två skäl använder du alternativet --purge .

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

Om åtgärden lyckas returneras inga resultat.

Tabeller

unity-catalog tables Använd underkommandot för att arbeta med tabeller.

Kommentar

Det går inte att skapa tabeller med Unity Catalog CLI. Information om hur du skapar tabeller finns i Vad är tabeller och vyer? och Självstudie: Skapa din första tabell och bevilja behörigheter.

Om du vill visa användningsdokumentationen kör du databricks unity-catalog tables --help.

Lista tillgängliga tabeller

Om du vill visa användningsdokumentationen kör du databricks unity-catalog tables list --help.

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

Lista sammanfattningar av tillgängliga tabeller

Om du vill visa användningsdokumentationen kör du databricks unity-catalog tables list-summaries --help.

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

Utdata:

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

Hämta information om en tabell

Om du vill visa användningsdokumentationen kör du databricks unity-catalog tables get --help.

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

Ta bort en tabell

Om du vill visa användningsdokumentationen kör du databricks unity-catalog tables delete --help.

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

Om åtgärden lyckas returneras inga resultat.

Linjerna

unity-catalog lineage Använd underkommandot för att arbeta med tabell- och kolumnrader.

Om du vill visa användningsdokumentationen kör du databricks unity-catalog lineage --help.

Visa en lista över en tabells ursprung

Om du vill visa användningsdokumentationen kör du databricks unity-catalog lineage table --help.

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

Visa en lista över en kolumns ursprung

Om du vill visa användningsdokumentationen kör du databricks unity-catalog lineage column --help.

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

Behörigheter

unity-catalog permissions Använd underkommandot för att arbeta med behörigheter för skyddsbara objekt. Se även Hantera behörigheter i Unity Catalog.

Om du vill visa användningsdokumentationen kör du databricks unity-catalog permissions --help.

Hämta information om behörigheter för ett skyddsbart objekt

Om du vill visa användningsdokumentationen kör du databricks unity-catalog permissions get --help. Se även Behörigheter för Unity-katalogen och skyddsbara objekt.

Katalog

databricks unity-catalog permissions get --catalog main

Utdata:

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

Schema

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

Utdata:

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

Register

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

Utdata:

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

Autentiseringsuppgift för lagring

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

Utdata:

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

Extern plats

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

Utdata:

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

Uppdatera behörigheter för ett skyddsbart objekt

Om du vill visa användningsdokumentationen kör du databricks unity-catalog permissions update --help. Se även Behörigheter för Unity-katalogen och skyddsbara objekt.

Katalog

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

Register

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

Autentiseringsuppgift för lagring

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

Extern plats

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

Delningar

unity-catalog shares Använd underkommandot för att arbeta med resurser, som är objekt som innehåller samlingar av tabeller i ett deltadelningsaktiverat Unity Catalog-metaarkiv som du vill dela som en grupp med deltadelningsmottagare. En resurs kan bara innehålla tabeller från ett enda metaarkiv. Se Skapa och hantera resurser för deltadelning.

Om du vill visa användningsdokumentationen kör du databricks unity-catalog shares --help.

Skapa en resurs

Om du vill visa användningsdokumentationen kör du databricks unity-catalog shares create --help. Se även Skapa och hantera resurser för deltadelning.

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

Utdata:

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

Uppdatera en resurss inställningar

Om du vill visa användningsdokumentationen kör du databricks unity-catalog shares update --help. Se även Uppdatera resurser.

Lägga till en tabell i en resurs

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

Utdata:

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

Se även Lägg till tabeller i en resurs.

Ta bort en tabell från en resurs

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

Utdata:

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

Se även Lägg till tabeller i en resurs.

Uppdatera en resurss behörigheter

Om du vill visa användningsdokumentationen kör du databricks unity-catalog shares update-permissions --help. Se även Hantera åtkomst till deltadelningsdataresurser (för leverantörer).

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

Lista tillgängliga resurser

Om du vill visa användningsdokumentationen kör du databricks unity-catalog shares list --help. Se även Visa resurser och dela information.

databricks unity-catalog shares list

Utdata:

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

Hämta information om en resurs

Om du vill visa användningsdokumentationen kör du databricks unity-catalog shares get --help. Se även Visa resurser och dela information.

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

Utdata:

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

Visa en lista över en resurss behörigheter

Om du vill visa användningsdokumentationen kör du databricks unity-catalog shares list-permissions --help. Se även Visa mottagare som har behörighet för en resurs.

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

Utdata:

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

Ta bort en resurs

Om du vill visa användningsdokumentationen kör du databricks unity-catalog shares delete --help. Se även Ta bort en resurs.

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

Om åtgärden lyckas returneras inga resultat.

Mottagare

unity-catalog recipients Använd underkommandot för att arbeta med datamottagare för deltadelningsaktiverade Unity Catalog-metaarkiv. Datamottagare är personer eller grupper som en Azure Databricks-användare delar data med utanför Azure Databricks-användarens organisation. Se Skapa och hantera datamottagare för Deltadelning.

Om du vill visa användningsdokumentationen kör du databricks unity-catalog recipients --help.

Skapa en mottagare

Om du vill visa användningsdokumentationen kör du databricks unity-catalog recipients create --help. Se även Skapa och hantera datamottagare för deltadelning.

Om du vill generera en ny aktiverings-URL för en mottagare kör du databricks unity-catalog recipients rotate-token. Ett exempel finns i Rotera en mottagares token.

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

Utdata:

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

Ändra en mottagares inställningar

Om du vill visa användningsdokumentationen kör du 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"
}

Utdata:

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

Rotera en mottagares token

Om du vill visa användningsdokumentationen kör du databricks unity-catalog recipients rotate-token --help. Se även Hantera mottagartoken (öppen delning).

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

Utdata:

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

Lista tillgängliga mottagare

Om du vill visa användningsdokumentationen kör du databricks unity-catalog recipients list --help. Se även Visa mottagare.

databricks unity-catalog recipients list

Utdata:

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

Visa en lista över en mottagares resursbehörigheter

Om du vill visa användningsdokumentationen kör du databricks unity-catalog recipients list-permissions --help. Se även Visa en mottagares resursbehörigheter.

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

Utdata:

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

Hämta information om en mottagare

Om du vill visa användningsdokumentationen kör du databricks unity-catalog recipients get --help. Se även Visa mottagarinformation.

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

Utdata:

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

Ta bort en mottagare

Om du vill visa användningsdokumentationen kör du databricks unity-catalog recipients delete --help. Se även Ta bort en mottagare.

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

Om åtgärden lyckas returneras inga resultat.

Providers

Om du är mottagare av delade data i deltadelning använder du unity-catalog providers underkommandot för att arbeta med deltadelningsdataproviders. Se Hantera deltadelningsproviders (för datamottagare).

Om du vill visa användningsdokumentationen kör du databricks unity-catalog providers --help.

Skapa en provider

Om du är mottagare av data som delas med hjälp av det öppna delningsprotokollet och du använder en Databricks-arbetsyta som är kopplad till ett Unity Catalog-metaarkiv kan du skapa ett providerobjekt i unity catalog-metaarkivet. Du kan sedan hantera åtkomst till delade data med hjälp av Unity Catalog.

Viktigt!

Det här scenariot är sällsynt. Om du använder en Databricks-arbetsyta som är aktiverad för Unity Catalog och en annan Databricks-kund delar data med dig bör de använda Databricks-till-Databricks-delning. Med Databricks-till-Databricks-delning skapas providerobjekt åt dig i Unity Catalog.

Om du vill skapa en provider måste du:

Kör följande kommando och ersätt my-provider med det namn som du vill ge providern och config.share med sökvägen till den nedladdade autentiseringsfilen, som heter config.share som standard.

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

Uppdatera en providers inställningar

Om du vill visa användningsdokumentationen kör du databricks unity-catalog providers update --help.

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

Lista tillgängliga leverantörer

Om du vill visa användningsdokumentationen kör du databricks unity-catalog providers list --help.

databricks unity-catalog providers list

Hämta information om en leverantör

Om du vill visa användningsdokumentationen kör du databricks unity-catalog providers get --help.

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

Visa en lista över en providers tillgängliga resurser

Om du vill visa användningsdokumentationen kör du databricks unity-catalog providers list-shares --help.

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

Ta bort en leverantör

Om du vill visa användningsdokumentationen kör du databricks unity-catalog providers delete --help.

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

Om åtgärden lyckas returneras inga resultat.