Sdílet prostřednictvím

Rozhraní příkazového řádku katalogu Unity (starší verze)

  • Článek

Důležité

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

Tyto informace platí pro starší verzi Rozhraní příkazového řádku Databricks verze 0.18 a novější. Databricks doporučuje místo toho použít novější rozhraní příkazového řádku Databricks verze 0.205 nebo vyšší. Podívejte se, co je rozhraní příkazového řádku 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 rozhraní příkazového řádku Databricks (starší verze) 0.17.0 nebo novější, nakonfigurované 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.

Práce s rozhraním příkazového řádku katalogu Unity:

  • Prostředky katalogu 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í.
  • Rozdílové sdílení prostředků, jako jsou sdílené složky, 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í rozhraní API katalogu Unity, které zahrnuje také rozhraní 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

Metastory

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ření metastoru

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog metastores create --helppříkaz . Viz také Vytvoření metastoru 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.

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 . Příklad najdete v tématu Získání souhrnných informací o aktuálním metastoru.

Výstup:

{}

Viz také Vytvoření metastoru katalogu Unity.

Aktualizace 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 . Příklad najdete v tématu 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ě.

Výpis 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ískání informací 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 . Příklad najdete v tématu Získání souhrnných informací o aktuálním metastoru.

Získání souhrnných informací 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ískání aktuálního 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"
}

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 . Příklad najdete v tématu Získání souhrnných informací o aktuálním metastoru.

Výstup:

{}

Odstranění metastoru

Upozorňující

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 . Příklad najdete v tématu 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í k Azure Data Lake Storage Gen2.

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ě

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 Gen2.

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

Pomocí podpříkazu unity-catalog external-locations můžete pracovat s externími umístěními. Viz Vytvoření externího umístění pro připojení cloudového úložiště k Azure Databricks.

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

Vytvoření externího umístění

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog external-locations create --helppříkaz . Viz také Vytvoření externího umístění pro připojení cloudového úložiště k Azure Databricks.

Ověření externího umístění a páru přihlašovacích údajů

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

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

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

Odstranění externího 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 tuto --force možnost.

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

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

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 vytvořit tabulky, přečtěte si téma Co je tabulka? 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

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

Odstraní 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 rodokmenu 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 rodokmenu 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

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

Table

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

Table

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

Sdílení

Pomocí podpříkazu unity-catalog shares můžete pracovat se sdílenými složkami, což jsou objekty, které obsahují kolekce tabulek v metastoru Unity s podporou rozdílového sdílení, které chcete sdílet jako skupinu s příjemci rozdílového sdílení. Sdílená složka může obsahovat tabulky pouze z jednoho metastoru. Viz Vytvoření a správa sdílených složek pro rozdílové sdílení.

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

Vytvoření sdílené složky

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ých složek pro rozdílové sdílení.

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é složky

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog shares update --helppříkaz . Viz také aktualizace sdílených složek.

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.

Odebrání tabulky ze sdílené složky

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ých složek

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog shares list --helppříkaz . Viz také Zobrazení sdílených složek a podrobností 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é složce

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog shares get --helppříkaz . Viz také Zobrazení sdílených složek a podrobností 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é složky

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

Odstranění sdílené složky

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

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 metastore katalogu Unity s povoleným rozdílovým sdílením. Příjemci dat jsou lidé nebo skupiny, se kterými uživatel Azure Databricks sdílí data mimo organizaci uživatele Azure Databricks. Viz Vytváření a správa příjemců dat pro rozdílové sdílení.

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

Vytvoření příjemce

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog recipients create --helppříkaz . Viz také Vytvoření a správa příjemců dat pro rozdílové 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é Správa tokenů příjemců (otevřené sdílení).

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í ke sdílené složce příjemce

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks unity-catalog recipients list-permissions --helppříkaz . Viz také 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é Zobrazení podrobností 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 rozdílového sdílení, použijte unity-catalog providers podpříkaz pro práci s zprostředkovateli dat Delta Sharing. Viz Správa poskytovatelů rozdílového 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

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, který je povolený pro Katalog Unity, a jiný zákazník Databricks s vámi sdílí data, měl by použít sdílení Databricks do Databricks. Se sdílením Databricks-to-Databricks se objekty zprostředkovatele 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 slož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.