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šší. Viz Co je to příkazové rozhraní Databricks? 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ření přihlašovacích údajů úložiště pro připojení ke službě 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í ke službě 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 tabulky Azure Databricks a kurz: 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é oprávnění katalogu Unity a zabezpečitelné objekty.

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é oprávnění katalogu Unity a zabezpečitelné objekty.

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 uživatel Azure Databricks sdílí data mimo organizaci uživatele Azure Databricks. 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. Podívejte se na Správa Delta Sharing poskytovatelů (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.