CLI katalogu Unity (původní verze)

Důležité

Tato dokumentace byla vyřazena a nemusí být aktualizována.

Tyto informace platí pro starší verze Rozhraní příkazového řádku Databricks, verze 0.18 a nižší. Databricks doporučuje místo toho použít novější rozhraní příkazového řádku Databricks verze 0.205 nebo vyšší. Vizte Databricks CLI. Pokud chcete zjistit svou verzi rozhraní příkazového řádku Databricks, spusťte databricks -vpříkaz .

Pokud chcete migrovat z Rozhraní příkazového řádku Databricks verze 0.18 nebo novější na Databricks CLI verze 0.205 nebo novější, přečtěte si téma Migrace rozhraní příkazového řádku Databricks.

Poznámka:

Rozhraní příkazového řádku Katalogu Unity je experimentální.

Rozhraní příkazového řádku katalogu Unity vyžaduje Legacy Databricks CLI 0.17.0 nebo vyšší configurované s ověřováním. Pokud chcete aktualizovat rozhraní příkazového řádku Databricks nebo zobrazit seznam nainstalované verze, přečtěte si téma Aktualizace rozhraní příkazového řádku.

Ukázkové hodnoty možností a polí v následujících příkladech jsou určené pouze pro ilustrativní účely.

Použijte rozhraní příkazového řádku katalogu Unity k práci s:

• Katalog Unity, jako jsou metastory, přihlašovací údaje k úložišti, externí umístění, katalogy, schémata, tabulky a jejich oprávnění.
• Delta Sharing zdroje, jako jsou data, příjemci a poskytovatelé.

Podpříkazy rozhraní příkazového řádku katalogu Unity spustíte tak, že je připojíte k databricks unity-catalog. Tyto dílčí příkazy volají API katalogu Unity, které zahrnuje také Delta Sharing API.

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog --helppříkaz .

Výstup:

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

Metasklady

Pomocí podpříkazu unity-catalog metastores můžete pracovat s metastory.

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog metastores --helppříkaz .

• Vytvořte metastore
• Propojte metastore s pracovním prostorem
• Aktualizace nastavení metastoru
• Seznam dostupných metastorů
• Získat informace o metastore
• Získejte souhrnné informace o aktuálním metastore
• Získejte aktuální přiřazení metastore pro pracovní prostor
• Odpojení metastoru od pracovního prostoru
• Odstranění metastoru

Vytvořte metastore

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog metastores create --helppříkaz . Viz také Vytvořit metastore katalogu Unity.

Poznámka:

Vytvoření metastoru automaticky nepřidružuje metastor k pracovnímu prostoru nebo přihlašovacím údajům úložiště. Pokud chcete tyto úlohy dokončit, přečtěte si téma Propojení metastoru s pracovním prostorem, vytvoření přihlašovacích údajů úložiště a aktualizace nastavení metastoru.

Propojte metastore s pracovním prostorem

Pokud tento příkaz spustíte v pracovním prostoru, který už má přiřazený metastor, aktualizujete přiřazený metastor pracovního prostoru.

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog metastores assign --helppříkaz .

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

ID pracovního prostoru získáte v části Názvy instancí pracovního prostoru, adresy URL a ID.

Id metastoru získáte spuštěním databricks unity-catalog metastores get-summarypříkazu . Pro příklad viz Získání souhrnných informací o aktuálním metastoru.

Výstup:

{}

Viz také Vytvořit metastore katalogu Unity.

Aktualizujte nastavení metastoru

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog metastores update --helppříkaz .

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

Id metastoru získáte spuštěním databricks unity-catalog metastores get-summarypříkazu . Pro příklad viz Získání souhrnných informací o aktuálním metastoru.

update-metastore.json:

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

Pokud chcete získat ID přihlašovacích údajů kořenového úložiště, přečtěte si téma Získání informací o přihlašovacích údaji úložiště.

Seznam dostupných metastorů

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog metastores list --helppříkaz .

databricks unity-catalog metastores list

Získejte informace o metastoru

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog metastores get --helppříkaz .

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

Id metastoru získáte spuštěním databricks unity-catalog metastores get-summarypříkazu . Pro příklad viz Získání souhrnných informací o aktuálním metastoru.

Získejte souhrnné informace o aktuálním metastoru

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog metastores get-summary --helppříkaz .

databricks unity-catalog metastores get-summary

Získejte aktuální přiřazení metastoru pro pracovní prostor

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog metastores get-assignment --helppříkaz .

databricks unity-catalog metastores get-assignment

Výstup:

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

Odpojení metastoru od pracovního prostoru

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog metastores unassign --helppříkaz .

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

ID pracovního prostoru získáte v části Názvy instancí pracovního prostoru, adresy URL a ID.

Id metastoru získáte spuštěním databricks unity-catalog metastores get-summarypříkazu . Pro příklad viz Získání souhrnných informací o aktuálním metastoru.

Výstup:

{}

Odstranění metastoru

Varování

Před odstraněním metastoru musíte odstranit všechny pracovní prostory, které používají metastor, nebo odebrat propojení metastoru s těmito pracovními prostory. Pokud potřebujete pomoc s odebráním odkazů metastoru z pracovních prostorů, obraťte se na podporu Azure Databricks.

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog metastores delete --helppříkaz .

Pokud chcete vynutit odstranění metastoru, použijte tuto --force možnost.

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

Id metastoru získáte spuštěním databricks unity-catalog metastores get-summarypříkazu . Pro příklad viz Získání souhrnných informací o aktuálním metastoru.

Pokud je operace úspěšná, nevrátí se žádné výsledky.

Přihlašovací údaje k úložišti

Pomocí podpříkazu unity-catalog storage-credentials můžete pracovat s přihlašovacími údaji úložiště. Viz Vytvořte přihlašovací údaje úložiště pro připojení k Azure Data Lake Storage.

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog storage-credentials --helppříkaz .

• Vytvoření přihlašovacích údajů úložiště
• Aktualizace nastavení přihlašovacích údajů úložiště
• Výpis dostupných přihlašovacích údajů k úložišti
• Získání informací o přihlašovacích údaji úložiště
• Odstranění přihlašovacích údajů úložiště

Vytvoření přihlašovacích údajů úložiště

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog storage-credentials create --helppříkaz .

Viz také Vytvoření přihlašovacích údajů úložiště pro připojení k Azure Data Lake Storage.

Aktualizace nastavení přihlašovacích údajů úložiště

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog storage-credentials update --helppříkaz .

Výpis dostupných přihlašovacích údajů k úložišti

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog storage-credentials list --helppříkaz .

databricks unity-catalog storage-credentials list

Získání informací o přihlašovacích údaji úložiště

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog storage-credentials get --helppříkaz .

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

Odstranění přihlašovacích údajů úložiště

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog storage-credentials delete --helppříkaz .

Pokud chcete vynutit odstranění přihlašovacích údajů úložiště, použijte tuto --force možnost.

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

Pokud je operace úspěšná, nevrátí se žádné výsledky.

Externí lokace

Pomocí podpříkazu unity-catalog external-locations můžete pracovat s externími umístěními. Viz Přehled externích umístění.

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog external-locations --helppříkaz .

• Vytvořte externí umístění
• Ověřit externí umístění a pár přihlašovacích údajů
  • Po vytvoření validujte dvojici názvu externího umístění a přihlašovacích údajů.
• Aktualizace nastavení externího umístění
• Výpis dostupných externích umístění
• Získání informací o externím umístění
• Odstraňte externí umístění

Vytvořte externí umístění

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog external-locations create --helppříkaz . Viz také Přehled externích umístění.

Ověřte externí umístění a páry přihlašovacích údajů

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog external-locations validate --helppříkaz .

Ověřte název externího umístění a dvojici přihlašovacích údajů po jejich vytvoření.

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

Výstup:

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

Aktualizace nastavení externího umístění

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog external-locations update --helppříkaz .

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

Výpis dostupných externích umístění

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog external-locations list --helppříkaz .

databricks unity-catalog external-locations list

Získání informací o externím umístění

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog external-locations get --helppříkaz .

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

Odstraňte externí umístění

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog external-locations delete --helppříkaz .

Pokud chcete vynutit odstranění externího umístění, použijte možnost --force.

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

Pokud je operace úspěšná, nevrátí se žádné výsledky.

Katalogy

Pomocí podpříkazu unity-catalog catalogs můžete pracovat s katalogy.

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog catalogs --helppříkaz .

• Vytvoření katalogu
• Aktualizace nastavení katalogu
• Seznam dostupných katalogů
• Získání informací o katalogu
• Odstranění katalogu

Vytvoření katalogu

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog catalogs create --helppříkaz . Viz také Vytváření katalogů.

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

Výstup:

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

Aktualizace nastavení katalogu

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog catalogs update --helppříkaz .

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

update-catalog.json:

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

Výstup:

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

Seznam dostupných katalogů

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog catalogs list --helppříkaz .

databricks unity-catalog catalogs list

Výstup:

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

Získání informací o katalogu

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog catalogs get --helppříkaz .

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

Výstup:

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

Odstranění katalogu

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog catalogs delete --helppříkaz . Viz také Odstranění katalogu.

Pokud chcete vynutit odstranění katalogu, použijte tuto --purge možnost.

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

Pokud je operace úspěšná, nevrátí se žádné výsledky.

Schémata

Pomocí podpříkazu unity-catalog schemas můžete pracovat se schématy.

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog schemas --helppříkaz .

• Vytvoření schématu
• Změna nastavení schématu
• Výpis dostupných schémat
• Získání informací o schématu
• Odstranit schéma

Vytvoření schématu

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog schemas create --helppříkaz . Viz také Vytváření schémat.

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

Výstup:

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

Změna nastavení schématu

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog schemas update --helppříkaz .

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

Výstup:

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

Výpis dostupných schémat

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog schemas list --helppříkaz .

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

Výstup:

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

Získání informací o schématu

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog schemas get --helppříkaz .

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

Výstup:

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

Odstranění schématu

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog schemas delete --helppříkaz . Viz také Odstranění schématu.

Pokud chcete vynutit odstranění schématu, použijte tuto --purge možnost.

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

Pokud je operace úspěšná, nevrátí se žádné výsledky.

Tabulky

Pomocí podpříkazu unity-catalog tables můžete pracovat s tabulkami.

Poznámka:

Vytváření tabulek pomocí rozhraní příkazového řádku katalogu Unity se nepodporuje. Pokud chcete vytvářet tabulky, podívejte se na Azure Databricks tabulky a Tutorial: Vytvoření první tabulky a udělení oprávnění.

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog tables --helppříkaz .

• Výpis dostupných tabulek
• Výpis souhrnů dostupných tabulek
• Získání informací o tabulce
• Odstranění tabulky

Výpis dostupných tabulek

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog tables list --helppříkaz .

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

Výpis souhrnů dostupných tabulek

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog tables list-summaries --helppříkaz .

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

Výstup:

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

Získání informací o tabulce

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog tables get --helppříkaz .

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

Odstranit tabulku

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog tables delete --helppříkaz .

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

Pokud je operace úspěšná, nevrátí se žádné výsledky.

Rodokmeny

Pomocí podpříkazu unity-catalog lineage můžete pracovat s rodokmeny tabulek a sloupců.

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog lineage --helppříkaz .

• Výpis historie tabulky
• Původ sloupce

Zobrazit historii původu tabulky

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog lineage table --helppříkaz .

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

Výpis historie sloupce

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog lineage column --helppříkaz .

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

Oprávnění

Pomocí podpříkazu unity-catalog permissions můžete pracovat s oprávněními pro zabezpečitelné objekty. Viz také Správa oprávnění v katalogu Unity.

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog permissions --helppříkaz .

• Získání informací o oprávněních pro zabezpečitelný objekt
  • Katalog
  • Schéma
  • Tabulka
  • Přihlašovací údaje úložiště
  • Externí umístění
• Aktualizace oprávnění zabezpečitelného objektu
  • Katalog
  • Schéma
  • Tabulka
  • Přihlašovací údaje úložiště
  • Externí umístění

Získání informací o oprávněních pro zabezpečitelný objekt

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog permissions get --helppříkaz . Viz také referenční informace k oprávněním katalogu Unity.

Katalog

databricks unity-catalog permissions get --catalog main

Výstup:

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

Schéma

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

Výstup:

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

Tabulka

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

Výstup:

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

Přihlašovací údaje úložiště

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

Výstup:

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

Externí umístění

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

Výstup:

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

Aktualizace oprávnění zabezpečitelného objektu

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog permissions update --helppříkaz . Viz také referenční informace k oprávněním katalogu Unity.

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

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

Tabulka

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

Přihlašovací údaje úložiště

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í umístění

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

Akcie

Pomocí podpříkazu unity-catalog shares můžete pracovat se sdíleními, což jsou objekty obsahující kolekce tabulek v metastoru Unity Catalog s aktivovaným Delta Sharing, které chcete sdílet jako skupinu s příjemci Delta Sharing. Sdílená složka může obsahovat tabulky pouze z jednoho metastoru. Viz Vytvořit a spravovat sdílení pro Delta Sharing.

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog shares --helppříkaz .

• Vytvořit sdílení
• Aktualizace nastavení sdílené složky
  • Přidání tabulky do sdílené složky
  • Odebrání tabulky ze sdílené složky
• Aktualizace oprávnění sdílené složky
• Seznam dostupných sdílených položek
• Získání informací o sdílení
• Výpis oprávnění sdílené složky
• Odstranit sdílení

Vytvořte sdílení

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog shares create --helppříkaz . Viz také Vytváření a správa sdílení pro Delta Sharing.

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

Výstup:

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

Aktualizace nastavení sdílení

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog shares update --helppříkaz . Viz také aktualizace podílů.

Přidání tabulky do sdílené složky

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

Výstup:

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

Viz také Přidání tabulek do sdílené složky.

Odebrat tabulku ze sdílení

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

Výstup:

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

Viz také Přidání tabulek do sdílené složky.

Aktualizace oprávnění sdílené složky

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog shares update-permissions --helppříkaz . Viz také Správa přístupu ke sdíleným složkám dat Delta (pro poskytovatele).

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

Seznam dostupných sdílení

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog shares list --helppříkaz . Viz také Zobrazit sdílení a podrobnosti o sdílení.

databricks unity-catalog shares list

Výstup:

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

Získání informací o sdílení

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog shares get --helppříkaz . Viz také Zobrazit sdílení a podrobnosti o sdílení.

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

Výstup:

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

Výpis oprávnění sdílení

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog shares list-permissions --helppříkaz . Podívejte se také na příjemce, kteří mají oprávnění ke sdílené složce.

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

Výstup:

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

Smazat sdílení

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog shares delete --helppříkaz . Viz také Odstranit sdílení.

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

Pokud je operace úspěšná, nevrátí se žádné výsledky.

Příjemci

Pomocí podpříkazu unity-catalog recipients můžete pracovat s příjemci dat pro metastory Unity Catalog s povoleným Delta Sharing. Příjemci dat jsou lidé nebo skupiny, se kterými Azure Databricks uživatel sdílí data mimo organizaci Azure Databricks uživatele. Viz Vytvoření a správa příjemců dat pro Delta Sharing (sdílení mezi Databricks-to-Databricks).

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog recipients --helppříkaz .

• Vytvoření příjemce
• Změna nastavení příjemce
• Otočení tokenu příjemce
• Seznam dostupných příjemců
• Seznam sdílených oprávnění příjemce
• Získání informací o příjemci
• Odstranění příjemce

Vytvoření příjemce

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog recipients create --helppříkaz . Viz také Vytváření a správa příjemců dat pro Delta Sharing (Databricks-to-Databricks sdílení).

Pokud chcete pro příjemce vygenerovat novou adresu URL aktivace, spusťte databricks unity-catalog recipients rotate-tokenpříkaz . Příklad najdete v tématu Obměna tokenu příjemce.

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

Výstup:

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

Změna nastavení příjemce

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog recipients update --helppříkaz .

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

update-recipient-settings.json:

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

Výstup:

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

Otočení tokenu příjemce

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog recipients rotate-token --helppříkaz . Viz také Spravovat tokeny příjemců.

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

Výstup:

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

Seznam dostupných příjemců

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog recipients list --helppříkaz . Viz také Zobrazit příjemce.

databricks unity-catalog recipients list

Výstup:

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

Výpis oprávnění sdílení příjemce

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog recipients list-permissions --helppříkaz . Viz též Zobrazení oprávnění ke sdílení příjemce.

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

Výstup:

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

Získání informací o příjemci

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog recipients get --helppříkaz . Viz také Zobrazit podrobnosti o příjemci.

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

Výstup:

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

Odstranění příjemce

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog recipients delete --helppříkaz . Viz také Odstranění příjemce.

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

Pokud je operace úspěšná, nevrátí se žádné výsledky.

Poskytovatelé

Pokud jste příjemcem sdílených dat Delta Sharing, použijte unity-catalog providers podřízený příkaz pro práci se zprostředkovateli dat Delta Sharing. Viz Správa poskytovatelů Delta sdílení pro příjemce dat.

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog providers --helppříkaz .

• Vytvoření zprostředkovatele
• Aktualizace nastavení poskytovatele
• Seznam dostupných poskytovatelů
• Získání informací o poskytovateli
• Výpis dostupných akcií poskytovatele
• Odstranění zprostředkovatele

Vytvoření zprostředkovatele

Pokud jste příjemcem dat sdílených pomocí otevřeného protokolu pro sdílení a používáte pracovní prostor Databricks, který je připojený k metastore katalogu Unity, můžete vytvořit objekt zprostředkovatele v metastoru katalogu Unity. Pak můžete spravovat přístup ke sdíleným datům pomocí katalogu Unity.

Důležité

Tento scénář je vzácný. Pokud používáte pracovní prostor Databricks s povoleným Katalogem Unity a jiný zákazník Databricks s vámi sdílí data, měl by použít sdílení Databricks-to-Databricks. Při sdílení Databricks-to-Databricks se objekty poskytovatele automaticky vytvářejí v katalogu Unity.

Pokud chcete vytvořit poskytovatele, musíte:

• Buďte správcem metastoru CREATE PROVIDER nebo uživatelem s oprávněním pro metastor.
• Získejte přístup ke staženého souboru přihlašovacích údajů. Viz Získání přístupu v otevřeném modelu sdílení.

Spusťte následující příkaz a nahraďte my-provider ho názvem, který chcete poskytovateli udělit, a config.share cestou ke staženého souboru přihlašovacích údajů, který má ve výchozím nastavení název config.share.

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

Aktualizace nastavení poskytovatele

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog providers update --helppříkaz .

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

Seznam dostupných poskytovatelů

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog providers list --helppříkaz .

databricks unity-catalog providers list

Získání informací o poskytovateli

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog providers get --helppříkaz .

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

Výpis dostupných sdílených položek poskytovatele

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog providers list-shares --helppříkaz .

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

Odstranění zprostředkovatele

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog providers delete --helppříkaz .

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

Pokud je operace úspěšná, nevrátí se žádné výsledky.