Unity Catalog CLI (örökölt)

Fontos

Ez a dokumentáció ki lett állítva, és lehet, hogy nem frissül.

Ezek az információk az örökölt Databricks CLI 0.18-s és újabb verzióira vonatkoznak. A Databricks azt javasolja, hogy helyette a Databricks CLI 0.205-ös vagy újabb verzióját használja. Lásd a Databricks parancssori felületét. A Databricks parancssori felület verziójának megkereséséhez futtassa a következőt databricks -v: .

Ha a Databricks CLI 0.18-os vagy újabb verziójáról a Databricks CLI 0.205-ös vagy újabb verziójára szeretne migrálni, tekintse meg a Databricks parancssori felület migrálását.

Feljegyzés

A Unity Catalog parancssori felülete kísérleti.

A Unity Catalog parancssori felület használatához a régi Databricks CLI 0.17.0 vagy újabb verziójára van szükség, konfigurálva hitelesítéssel. A Databricks parancssori felületének frissítéséhez vagy a telepített verzió listázásához tekintse meg a parancssori felület frissítését.

Az alábbi példákban szereplő beállítás- és mezőmintaértékek csak szemléltető célokra szolgálnak.

A Unity Catalog parancssori felületének használatával a következőkkel dolgozhat:

• Unity Catalog-erőforrások , például metaadattárak, tárolási hitelesítő adatok, külső helyek, katalógusok, sémák, táblák és azok engedélyei.
• OpenSharing-erőforrások , például megosztások, címzettek és szolgáltatók.

A Unity Catalog CLI alparancsait databricks unity-catalog hozzáfűzésével futtathatja. Ezek az alparancsok a Unity Catalog API-t hívják, amely magában foglalja az OpenSharing API-t is.

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog --help:

Kimenet:

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

Metaadattárak

Használja az unity-catalog metastores alparancsot a metaadattárak használatához.

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog metastores --help:

• Metaadattár létrehozása
• Metaadattár összekapcsolása munkaterülettel
• Metaadattár beállításainak frissítése
• Elérhető metaadattárak listázása
• Metaadattár adatainak lekérése
• Összegzett információk lekérése az aktuális metaadattárról
• Munkaterület aktuális metaadattár-hozzárendelésének lekérése
• Metaadattár leválasztása egy munkaterületről
• Metaadattár törlése

Metaadattár létrehozása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog metastores create --help: Lásd még : Unity Catalog-metaadattár létrehozása.

Feljegyzés

A metaadattár létrehozása nem társítja automatikusan a metaadattárat egy munkaterülethez vagy egy tároló hitelesítő adataihoz. A feladatok elvégzéséhez lásd: Metaadattár csatolása munkaterülethez, Tároló hitelesítő adatainak létrehozása és Metaadattár beállításainak frissítése.

Metaadattár összekapcsolása munkaterülettel

Ha olyan munkaterületen futtatja ezt a parancsot, amely már rendelkezik hozzárendelt metaadattáral, frissíteni fogja a munkaterület hozzárendelt metaadattárát.

A használati dokumentáció megjelenítéséhez futtassa a következőt 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

A munkaterület-azonosító lekéréséhez tekintse meg a munkaterület példányneveit, URL-címeit és azonosítóit.

A metaadattár azonosítójának lekéréséhez futtassa a következőt databricks unity-catalog metastores get-summary: . Példa: Az aktuális metaadattár összesített adatainak lekérése.

Kimenet:

{}

Lásd még : Unity Catalog-metaadattár létrehozása.

Metaadattár beállításainak frissítése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog metastores update --help:

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

A metaadattár azonosítójának lekéréséhez futtassa a következőt databricks unity-catalog metastores get-summary: . Példa: Az aktuális metaadattár összesített adatainak lekérése.

update-metastore.json:

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

A tárológyökér hitelesítő azonosítójának lekéréséhez tekintse meg a tároló hitelesítő adatainak lekérése című témakört.

Elérhető metaadattárak listázása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog metastores list --help:

databricks unity-catalog metastores list

Metaadattár adatainak lekérése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog metastores get --help:

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

A metaadattár azonosítójának lekéréséhez futtassa a következőt databricks unity-catalog metastores get-summary: . Példa: Az aktuális metaadattár összesített adatainak lekérése.

Összegzett információk lekérése az aktuális metaadattárról

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog metastores get-summary --help:

databricks unity-catalog metastores get-summary

Munkaterület aktuális metaadattár-hozzárendelésének lekérése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog metastores get-assignment --help:

databricks unity-catalog metastores get-assignment

Kimenet:

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

Metaadattár leválasztása munkaterületről

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog metastores unassign --help:

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

A munkaterület-azonosító lekéréséhez tekintse meg a munkaterület példányneveit, URL-címeit és azonosítóit.

A metaadattár azonosítójának lekéréséhez futtassa a következőt databricks unity-catalog metastores get-summary: . Példa: Az aktuális metaadattár összesített adatainak lekérése.

Kimenet:

{}

Metaadattár törlése

Figyelmeztetés

A metaadattár törlése előtt törölnie kell minden olyan munkaterületet, amely a metaadattárat használja, vagy el kell távolítania a metaadattár ezen munkaterületekre mutató hivatkozását. Forduljon Azure Databricks támogatási szolgálatához, amely segítséget nyújt a metaadattár-hivatkozások munkaterületekről való eltávolításához.

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog metastores delete --help:

A metaadattár kényszerített törléséhez használja a --force lehetőséget.

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

A metaadattár azonosítójának lekéréséhez futtassa a következőt databricks unity-catalog metastores get-summary: . Példa: Az aktuális metaadattár összesített adatainak lekérése.

Ha a művelet sikeres, a rendszer nem ad vissza eredményt.

Tárolási hitelesítő adatok

A unity-catalog storage-credentials alparancs használata lehetővé teszi a tárolási hitelesítő adatok kezelését. Lásd: Az ADLS Gen2-hez hozzáférő tároló hitelesítő adatainak létrehozása.

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog storage-credentials --help:

• Tároló hitelesítő adatainak létrehozása
• A tároló hitelesítő adatainak beállításainak frissítése
• Elérhető tárolási hitelesítő adatok listázása
• Adatok lekérése a tároló hitelesítő adatairól
• Tároló hitelesítő adatainak törlése

Tároló hitelesítő adatainak létrehozása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog storage-credentials create --help:

Lásd még : Az ADLS Gen2-hez hozzáférő tároló hitelesítő adatainak létrehozása.

A tároló hitelesítő adatainak beállításainak frissítése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog storage-credentials update --help:

Elérhető tárolási hitelesítő adatok listázása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog storage-credentials list --help:

databricks unity-catalog storage-credentials list

Információ lekérése a tároló hitelesítő adatairól

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog storage-credentials get --help:

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

Tároló hitelesítő adatainak törlése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog storage-credentials delete --help:

A tárolási hitelesítő adatok kényszerített törléséhez használja a --force lehetőséget.

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

Ha a művelet sikeres, a rendszer nem ad vissza eredményt.

Külső helyek

unity-catalog external-locations Az alparancs használatával külső helyekkel dolgozhat. Lásd a külső helyek áttekintését.

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog external-locations --help:

• Külső hely létrehozása
• Külső hely és hitelesítőadat-pár érvényesítése
  • Hitelesítse a külső hely nevének és hitelesítő adatainak párját a létrehozásuk után
• Külső hely beállításainak frissítése
• Elérhető külső helyek listázása
• Külső hely adatainak lekérése
• Külső hely törlése

Külső hely létrehozása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog external-locations create --help: Lásd még a külső helyek áttekintését.

Külső hely és hitelesítőadat-pár ellenőrzése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog external-locations validate --help:

Ellenőrizze egy külső hely nevét és hitelesítő adatainak párját a létrehozásuk után.

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

Kimenet:

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

Külső hely beállításainak frissítése

A használati dokumentáció megjelenítéséhez futtassa a következőt 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"
}

Elérhető külső helyek listázása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog external-locations list --help:

databricks unity-catalog external-locations list

Külső hely adatainak lekérése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog external-locations get --help:

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

Külső hely törlése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog external-locations delete --help:

A külső hely kényszerített törléséhez használja a --force lehetőséget.

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

Ha a művelet sikeres, a rendszer nem ad vissza eredményt.

Katalógusok

Használja az unity-catalog catalogs alparancsot a katalógusok használatához.

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog catalogs --help:

• Katalógus létrehozása
• Katalógus beállításainak frissítése
• Elérhető katalógusok listázása
• Katalógussal kapcsolatos információk lekérése
• Katalógus törlése

Katalógus létrehozása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog catalogs create --help: Lásd még : Katalógusok létrehozása.

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

Kimenet:

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

Katalógus beállításainak frissítése

A használati dokumentáció megjelenítéséhez futtassa a következőt 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"
}

Kimenet:

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

Elérhető katalógusok listázása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog catalogs list --help:

databricks unity-catalog catalogs list

Kimenet:

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

Katalógussal kapcsolatos információk lekérése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog catalogs get --help:

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

Kimenet:

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

Katalógus törlése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog catalogs delete --help: Lásd még : Katalógus törlése.

Katalógus kényszerített törléséhez használja a --purge lehetőséget.

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

Ha a művelet sikeres, a rendszer nem ad vissza eredményt.

Sémák

Használja az unity-catalog schemas alparancsot a sémák használatához.

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog schemas --help:

• Séma létrehozása
• Séma beállításainak módosítása
• Elérhető sémák listázása
• Séma adatainak lekérése
• Séma törlése

Séma létrehozása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog schemas create --help: Lásd még : Sémák létrehozása.

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

Kimenet:

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

Séma beállításainak módosítása

A használati dokumentáció megjelenítéséhez futtassa a következőt 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"
}

Kimenet:

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

Elérhető sémák listázása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog schemas list --help:

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

Kimenet:

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

Séma adatainak lekérése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog schemas get --help:

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

Kimenet:

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

Séma törlése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog schemas delete --help: Lásd még : Séma törlése.

Séma kényszerített törléséhez használja a --purge lehetőséget.

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

Ha a művelet sikeres, a rendszer nem ad vissza eredményt.

Táblák

Használja az unity-catalog tables alparancsot a táblák használatához.

Feljegyzés

A Unity Catalog parancssori felülettel nem lehet táblákat létrehozni. Táblák létrehozásához lásd: Azure Databricks táblák és Tutorial: Az első tábla létrehozása és jogosultságok megadása.

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog tables --help:

• Elérhető táblák listázása
• Az elérhető táblák összegzésének listázása
• Információk lekérése egy tábláról
• Tábla törlése

Elérhető táblák listázása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog tables list --help:

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

Az elérhető táblák összegzésének listázása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog tables list-summaries --help:

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

Kimenet:

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

Információk lekérése egy tábláról

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog tables get --help:

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

Tábla törlése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog tables delete --help:

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

Ha a művelet sikeres, a rendszer nem ad vissza eredményt.

Leszármazási vonalak

unity-catalog lineage Az alparancs használatával táblázat- és oszlopsorokat használhat.

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog lineage --help:

• Tábla életútjának listázása
• Egy oszlop származásának listázása

Tábla származásának listázása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog lineage table --help:

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

Oszlop eredetének listázása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog lineage column --help:

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

Engedélyek

unity-catalog permissions Az alparancs használatával biztonságos objektumok engedélyeivel dolgozhat. Lásd még : Jogosultságok kezelése a Unity Katalógusban.

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog permissions --help:

• Információk lekérése egy biztonságos objektum engedélyeiről
  • Katalógus
  • Séma
  • Tábla
  • Tárhely hitelesítője
  • Külső hely
• Biztonságos objektumok engedélyeinek frissítése
  • Katalógus
  • Séma
  • Tábla
  • Tárhely hitelesítője
  • Külső hely

Információk lekérése egy biztonságos objektum engedélyeiről

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog permissions get --help: Lásd még Unity Catalog engedélyek hivatkozása.

Katalógus

databricks unity-catalog permissions get --catalog main

Kimenet:

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

Séma

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

Kimenet:

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

Tábla

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

Kimenet:

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

Tároló hitelesítő adatai

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

Kimenet:

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

Külső hely

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

Kimenet:

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

Biztonságos objektumok engedélyeinek frissítése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog permissions update --help: Lásd még Unity Catalog engedélyek hivatkozása.

Katalógus

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

Séma

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

Tábla

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

Tároló hitelesítő adatai

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

Külső hely

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

Megosztások

unity-catalog shares Az alparancs használatával olyan megosztásokkal dolgozhat, amelyek olyan objektumok, amelyek egy OpenSharing-kompatibilis Unity Catalog-metaadattárban lévő táblázatgyűjteményeket tartalmaznak, amelyeket csoportként szeretne megosztani az OpenSharing-címzettekkel. A megosztások csak egyetlen metaadattárból tartalmazhatnak táblákat. Lásd: Megosztások létrehozása az OpenSharinghoz.

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog shares --help:

• Megosztás létrehozása
• Megosztás beállításainak frissítése
  • Egy tábla hozzáadása a megosztáshoz
  • Tábla eltávolítása megosztásból
• Megosztás engedélyeinek frissítése
• Elérhető megosztások listázása
• Információk lekérése egy megosztásról
• Megosztás engedélyeinek listázása
• Megosztás törlése

Megosztás létrehozása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog shares create --help: Lásd még: Megosztások létrehozása az OpenSharinghoz.

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

Kimenet:

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

Megosztás beállításainak frissítése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog shares update --help: Lásd még Megosztások frissítése.

Tábla hozzáadása a megosztáshoz

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

Kimenet:

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

Lásd még : Táblák hozzáadása megosztáshoz.

Tábla eltávolítása megosztásból

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

Kimenet:

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

Lásd még : Táblák hozzáadása megosztáshoz.

Megosztás engedélyeinek frissítése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog shares update-permissions --help: Lásd még: OpenSharing-adatmegosztásokhoz való hozzáférés kezelése (szolgáltatók számára).

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

Elérhető megosztások listázása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog shares list --help: Lásd még : Megosztások és megosztási adatok megtekintése.

databricks unity-catalog shares list

Kimenet:

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

Információk lekérése egy megosztásról

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog shares get --help: Lásd még : Megosztások és megosztási adatok megtekintése.

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

Kimenet:

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

Megosztás engedélyeinek listázása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog shares list-permissions --help: Lásd még : A megosztáshoz engedélyekkel rendelkező címzettek megtekintése.

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

Kimenet:

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

Megosztás törlése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog shares delete --help: Lásd még: Megosztások törlése.

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

Ha a művelet sikeres, a rendszer nem ad vissza eredményt.

Címzettek

unity-catalog recipients Az alparancs használatával együttműködhet az OpenSharing által engedélyezett Unity Catalog-metaadattárak adatátvevőivel. Az adat címzettjei azok a személyek vagy csoportok, akikkel egy Azure Databricks felhasználó adatokat oszt meg a Azure Databricks felhasználó szervezetén kívül. Lásd: Adatfogadók létrehozása az OpenSharinghez (Databricks–Databricks megosztás).

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog recipients --help:

• Címzett létrehozása
• Címzett beállításainak módosítása
• Címzett jelének elforgatása
• Elérhető címzettek listázása
• Egy címzett megosztási engedélyeinek listázása
• Információ kérése egy címzettről
• Címzett törlése

Címzett létrehozása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog recipients create --help: Lásd még: Adatok címzettjeinek létrehozása az OpenSharinghez (Databricks-to-Databricks-megosztás).

Ha új aktiválási URL-címet szeretne létrehozni egy címzett számára, futtassa a következőt databricks unity-catalog recipients rotate-token: . Például lásd: Címzett jogkivonatának elforgatása.

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

Kimenet:

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

Címzett beállításainak módosítása

A használati dokumentáció megjelenítéséhez futtassa a következőt 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"
}

Kimenet:

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

Címzett tokenjének elforgatása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog recipients rotate-token --help: Lásd még: Címzett tokenek kezelése.

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

Kimenet:

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

Elérhető címzettek listázása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog recipients list --help: Lásd még : Címzettek megtekintése.

databricks unity-catalog recipients list

Kimenet:

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

Címzett megosztási engedélyeinek listázása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog recipients list-permissions --help: Lásd még : Címzett megosztási engedélyeinek megtekintése.

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

Kimenet:

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

Címzett adatainak lekérése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog recipients get --help: Lásd még : Címzett adatainak megtekintése.

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

Kimenet:

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

Címzett törlése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog recipients delete --help: Lásd még : Címzett törlése.

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

Ha a művelet sikeres, a rendszer nem ad vissza eredményt.

Szolgáltatók

Ha Ön OpenSharing megosztott adatok címzettje, használja az alparancsot az unity-catalog providers OpenSharing-adatszolgáltatókkal való együttműködésre. Lásd: OpenSharing-szolgáltatók kezelése az adatátvevők számára.

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog providers --help:

• Szolgáltató létrehozása
• Szolgáltató beállításainak frissítése
• Elérhető szolgáltatók listázása
• Szolgáltató adatainak lekérése
• Szolgáltató elérhető megosztásainak listázása
• Szolgáltató törlése

Szolgáltató létrehozása

Ha Ön a Databricks-to-Open megosztóprotokoll használatával megosztott adatok címzettje, és egy Unity Catalog-metaadattárhoz csatolt Databricks-munkaterületet használ, létrehozhat egy szolgáltatóobjektumot a Unity Catalog-metaadattárban. Ezután a Unity Catalog használatával kezelheti a megosztott adatokhoz való hozzáférést.

Fontos

Ez a forgatókönyv ritka. Ha a Unity Cataloghoz engedélyezett Databricks-munkaterületet használ, és egy másik Databricks-ügyfél megosztja Önnel az adatokat, a Databricks-to-Databricks megosztást kell használnia. Az Databricks-to-Databricks megosztás során az Ön számára automatikusan létrejönnek a szolgáltatói objektumok a Unity Katalógusban.

Szolgáltató létrehozásához a következőt kell tennie:

• Legyen metaadattár-rendszergazda vagy a CREATE PROVIDER metaadattárhoz tartozó jogosultsággal rendelkező felhasználó.
• Hozzáféréssel rendelkezik a letöltött hitelesítőadat-fájlhoz. Lásd: Hozzáférés kérése a Databricks-to-Open megosztási modellben.

Futtassa a következő parancsot, a my-provider helyére írja a szolgáltatónak kívánt nevet, a config.share helyére pedig a letöltött hitelesítőadat-fájl elérési útját, amelynek alapértelmezett neve config.share.

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

Szolgáltató beállításainak frissítése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog providers update --help:

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

Elérhető szolgáltatók listázása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog providers list --help:

databricks unity-catalog providers list

Szolgáltató adatainak lekérése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog providers get --help:

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

Szolgáltató elérhető megosztásainak listázása

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog providers list-shares --help:

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

Szolgáltató törlése

A használati dokumentáció megjelenítéséhez futtassa a következőt databricks unity-catalog providers delete --help:

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

Ha a művelet sikeres, a rendszer nem ad vissza eredményt.