Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Poznámka:
Tyto informace platí pro Databricks CLI verze 0.205 a vyšší. Rozhraní příkazového řádku Databricks je ve veřejné ukázce.
Použití rozhraní příkazového řádku Databricks podléhá licenci Databricks a oznámení o ochraně osobních údajů Databricks, včetně všech ustanovení o využití.
Skupina entity-tag-assignments příkazů v rozhraní příkazového řádku Databricks obsahuje příkazy pro vytváření, aktualizaci, odstraňování a výpis přiřazení značek napříč entitami katalogu Unity. Značky jsou atributy, které obsahují klíče a volitelné hodnoty, které můžete použít k uspořádání a kategorizaci entit v katalogu Unity. Viz Použijte značky pro zabezpečitelné objekty Katalogu Unity.
Vytvoření přiřazení entity-tag-assignments databricks
Vytvořte přiřazení značky pro entitu katalogu Unity.
Pokud chcete přidat značky do entit katalogu Unity, musíte tuto entitu vlastnit nebo mít následující oprávnění:
- APPLY TAG on the entity
- USE SCHEMA u nadřazeného schématu entity
- USE CATALOG v nadřazeném katalogu entity
Pokud chcete přidat řízenou značku do entit katalogu Unity, musíte mít také oprávnění PŘIŘADIT nebo SPRAVOVAT k zásadám značek. Podívejte se na Správa oprávnění zásad značek.
databricks entity-tag-assignments create ENTITY_NAME TAG_KEY ENTITY_TYPE [flags]
Arguments
ENTITY_NAME
Plně kvalifikovaný název entity, ke které je značka přiřazena.
TAG_KEY
Klíč značky.
ENTITY_TYPE
Typ entity, ke které je značka přiřazena. Povolené hodnoty jsou: catalogs, schemas, tables, columns, volumes.
Možnosti
--json JSON
Vložený řetězec JSON nebo soubor JSON @path s tělem požadavku
--tag-value string
Hodnota značky.
Příklady
Následující příklad vytvoří přiřazení značky pro tabulku:
databricks entity-tag-assignments create my_catalog.my_schema.my_table environment tables --tag-value production
Následující příklad vytvoří přiřazení značek pomocí kódu JSON:
databricks entity-tag-assignments create my_catalog.my_schema.my_table department tables --json '{"tag_value": "finance"}'
Odstranění přiřazení entity-tag-assignments databricks
Odstranění přiřazení značky pro entitu katalogu Unity podle jeho klíče
Pokud chcete odstranit značky z entit katalogu Unity, musíte tuto entitu vlastnit nebo mít následující oprávnění:
- APPLY TAG on the entity
- USE_SCHEMA nadřazeného schématu entity
- USE_CATALOG v nadřazeném katalogu entity
Pokud chcete odstranit řízenou značku z entit katalogu Unity, musíte mít u zásad značek také oprávnění PŘIŘADIT nebo SPRAVOVAT . Podívejte se na Správa oprávnění zásad značek.
databricks entity-tag-assignments delete ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]
Arguments
ENTITY_TYPE
Typ entity, ke které je značka přiřazena. Povolené hodnoty jsou: catalogs, schemas, tables, columns, volumes.
ENTITY_NAME
Plně kvalifikovaný název entity, ke které je značka přiřazena.
TAG_KEY
Klíč značky, která se má odstranit.
Možnosti
Příklady
Následující příklad odstraní přiřazení značky z tabulky:
databricks entity-tag-assignments delete tables my_catalog.my_schema.my_table environment
Získání přiřazení entity-tag-assignments databricks
Získejte přiřazení značky pro entitu katalogu Unity podle klíče značky.
databricks entity-tag-assignments get ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]
Arguments
ENTITY_TYPE
Typ entity, ke které je značka přiřazena. Povolené hodnoty jsou: catalogs, schemas, tables, columns, volumes.
ENTITY_NAME
Plně kvalifikovaný název entity, ke které je značka přiřazena.
TAG_KEY
Klíč značky.
Možnosti
Příklady
Následující příklad získá přiřazení značky pro tabulku:
databricks entity-tag-assignments get tables my_catalog.my_schema.my_table environment
Seznam přiřazení entity-tag-assignments databricks
Zobrazení seznamu přiřazení značek pro entitu katalogu Unity
Důležité
Rozhraní API je ve výchozím nastavení stránkované, stránka může obsahovat nulové výsledky a současně poskytuje next_page_token. Klienti musí pokračovat ve čtení stránek, dokud next_page_token chybí, což je jediná indikace, že bylo dosaženo konce výsledků.
databricks entity-tag-assignments list ENTITY_TYPE ENTITY_NAME [flags]
Arguments
ENTITY_TYPE
Typ entity, ke které je značka přiřazena. Povolené hodnoty jsou: catalogs, schemas, tables, columns, volumes.
ENTITY_NAME
Plně kvalifikovaný název entity, ke které je značka přiřazena.
Možnosti
--max-results int
Maximální počet výsledků, které se mají vrátit.
--page-token string
Token pro načtení další stránky výsledků
Příklady
Následující příklad obsahuje seznam všech přiřazení značek pro tabulku:
databricks entity-tag-assignments list tables my_catalog.my_schema.my_table
Následující příklad uvádí přiřazení značek se stránkováním:
databricks entity-tag-assignments list tables my_catalog.my_schema.my_table --max-results 10
Aktualizace přiřazení entity-tag-assignments databricks
Aktualizace existujícího přiřazení značek pro entitu katalogu Unity
Pokud chcete aktualizovat značky na entity katalogu Unity, musíte tuto entitu vlastnit nebo mít následující oprávnění:
- APPLY TAG on the entity
- USE SCHEMA u nadřazeného schématu entity
- USE CATALOG v nadřazeném katalogu entity
Pokud chcete aktualizovat řízenou značku na entity katalogu Unity, musíte mít také oprávnění ASSIGN nebo MANAGE k zásadám značek. Podívejte se na Správa oprávnění zásad značek.
databricks entity-tag-assignments update ENTITY_TYPE ENTITY_NAME TAG_KEY UPDATE_MASK [flags]
Arguments
ENTITY_TYPE
Typ entity, ke které je značka přiřazena. Povolené hodnoty jsou: catalogs, schemas, tables, columns, volumes.
ENTITY_NAME
Plně kvalifikovaný název entity, ke které je značka přiřazena.
TAG_KEY
Klíč značky.
UPDATE_MASK
Maska pole musí být jediný řetězec, s tím, že více polí je odděleno čárkami (bez mezer). Cesta k poli je relativní vzhledem ke zdrojovému objektu, pomocí tečky (.) k navigaci mezi dílčími poli (např. author.given_name). Specifikace prvků v sekvenčních nebo mapových polích není povolena, protože lze zadat pouze celé pole kolekce. Názvy polí musí přesně odpovídat názvům polí zdroje.
Maska pole s hvězdičkou (*) označuje úplnou náhradu. Doporučujeme vždy explicitně vypsat aktualizovaná pole a vyhnout se použití zástupných znaků, protože může vést k nezamýšleným výsledkům, pokud se rozhraní API v budoucnu změní.
Možnosti
--json JSON
Vložený řetězec JSON nebo soubor JSON @path s tělem požadavku
--tag-value string
Hodnota značky.
Příklady
Následující příklad aktualizuje přiřazení značky pro tabulku:
databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --tag-value staging
Následující příklad aktualizuje přiřazení značek pomocí kódu JSON:
databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --json '{"tag_value": "development"}'
Globální příznaky
--debug
Zda povolit protokolování ladění.
-h nebo --help
Zobrazení nápovědy k rozhraní příkazového řádku Databricks nebo související skupině příkazů nebo souvisejícímu příkazu
--log-file řetězec
Řetězec představující soubor, do kterého se zapisují výstupní protokoly. Pokud tento příznak není zadaný, výchozí hodnota je zápis výstupních protokolů do stderru.
--log-format formát
Typ formátu protokolu, text nebo json. Výchozí hodnota je text.
--log-level řetězec
Řetězec představující úroveň formátu protokolu. Pokud není zadána, je úroveň formátu protokolu zakázaná.
-o, --output typ
Typ výstupu příkazu, text nebo json. Výchozí hodnota je text.
-p, --profile řetězec
Název profilu v ~/.databrickscfg souboru, který se má použít ke spuštění příkazu. Pokud tento příznak není zadán, použije se profil s názvem DEFAULT, pokud existuje.
--progress-format formát
Formát pro zobrazení protokolů průběhu: default, append, inplacenebo json
-t, --target řetězec
Pokud je to relevantní, cílový balíček, který se má použít