Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Hinweis
Diese Informationen gelten für Databricks CLI-Versionen 0.205 und höher. Die Databricks CLI befindet sich in der öffentlichen Vorschau.
Die Verwendung von Databricks CLI unterliegt der Datenbricks-Lizenz - und Databricks-Datenschutzerklärung, einschließlich der Bestimmungen zu Nutzungsdaten.
Die entity-tag-assignments Befehlsgruppe in der Databricks CLI enthält Befehle zum Erstellen, Aktualisieren, Löschen und Auflisten von Tagzuweisungen in Unity-Katalogentitäten. Tags sind Attribute, die Schlüssel und optionale Werte enthalten, die Sie zum Organisieren und Kategorisieren von Entitäten im Unity-Katalog verwenden können. Weitere Informationen finden Sie unter Anwenden von Tags auf sicherungsfähige Unity Catalog-Objekte.
databricks entity-tag-assignments create
Erstellen Sie eine Tagzuweisung für eine Unity-Katalogentität.
Zum Hinzufügen von Tags zu Unity-Katalogentitäten müssen Sie über die Entität verfügen oder über die folgenden Berechtigungen verfügen:
- APPLY TAG für die Entität
- USE SCHEMA im übergeordneten Schema der Entität
- USE CATALOG im übergeordneten Katalog der Entität
Um ein geregeltes Tag zu Unity-Katalogentitäten hinzuzufügen, müssen Sie auch über die Berechtigung ASSIGN oder MANAGE für die Tagrichtlinie verfügen. Siehe Verwalten von Tagrichtlinienberechtigungen.
databricks entity-tag-assignments create ENTITY_NAME TAG_KEY ENTITY_TYPE [flags]
Argumente
ENTITY_NAME
Der vollqualifizierte Name der Entität, der das Tag zugewiesen ist.
TAG_KEY
Der Schlüssel des Tags.
ENTITY_TYPE
Der Typ der Entität, der das Tag zugewiesen ist. Zulässige Werte sind: catalogs, schemas, , tables, columns. volumes
Options
--json JSON
Die Inline-JSON-Zeichenfolge oder der @path zur JSON-Datei mit dem Anforderungstext
--tag-value string
Der Wert des Tags.
Beispiele
Im folgenden Beispiel wird eine Tagzuweisung für eine Tabelle erstellt:
databricks entity-tag-assignments create my_catalog.my_schema.my_table environment tables --tag-value production
Im folgenden Beispiel wird eine Tagzuweisung mithilfe von JSON erstellt:
databricks entity-tag-assignments create my_catalog.my_schema.my_table department tables --json '{"tag_value": "finance"}'
databricks entity-tag-assignments delete
Löschen Sie eine Tagzuweisung für eine Unity-Katalogentität anhand ihres Schlüssels.
Um Tags aus Unity-Katalogentitäten zu löschen, müssen Sie über die Entität verfügen oder über die folgenden Berechtigungen verfügen:
- APPLY TAG für die Entität
- USE_SCHEMA im übergeordneten Schema der Entität
- USE_CATALOG im übergeordneten Katalog der Entität
Um ein geregeltes Tag aus Unity-Katalogentitäten zu löschen, müssen Sie auch über die Berechtigung ASSIGN oder MANAGE für die Tagrichtlinie verfügen. Siehe Verwalten von Tagrichtlinienberechtigungen.
databricks entity-tag-assignments delete ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]
Argumente
ENTITY_TYPE
Der Typ der Entität, der das Tag zugewiesen ist. Zulässige Werte sind: catalogs, schemas, , tables, columns. volumes
ENTITY_NAME
Der vollqualifizierte Name der Entität, der das Tag zugewiesen ist.
TAG_KEY
Der Schlüssel des zu löschenden Tags.
Options
Beispiele
Im folgenden Beispiel wird eine Tagzuweisung aus einer Tabelle gelöscht:
databricks entity-tag-assignments delete tables my_catalog.my_schema.my_table environment
databricks entity-tag-assignments get
Rufen Sie eine Tagzuweisung für eine Unity-Katalogentität nach Tagschlüssel ab.
databricks entity-tag-assignments get ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]
Argumente
ENTITY_TYPE
Der Typ der Entität, der das Tag zugewiesen ist. Zulässige Werte sind: catalogs, schemas, , tables, columns. volumes
ENTITY_NAME
Der vollqualifizierte Name der Entität, der das Tag zugewiesen ist.
TAG_KEY
Der Schlüssel des Tags.
Options
Beispiele
Im folgenden Beispiel wird eine Tagzuweisung für eine Tabelle angezeigt:
databricks entity-tag-assignments get tables my_catalog.my_schema.my_table environment
databricks entity-tag-assignments list
Auflisten von Tagzuweisungen für eine Unity-Katalogentität.
Von Bedeutung
Die API ist standardmäßig paginiert, eine Seite kann null Ergebnisse enthalten und gleichzeitig eine next_page_token bereitstellen. Clients müssen das Lesen von Seiten fortsetzen, bis next_page_token nicht vorhanden ist. Dies ist der einzige Hinweis darauf, dass das Ende der Ergebnisse erreicht wurde.
databricks entity-tag-assignments list ENTITY_TYPE ENTITY_NAME [flags]
Argumente
ENTITY_TYPE
Der Typ der Entität, der das Tag zugewiesen ist. Zulässige Werte sind: catalogs, schemas, , tables, columns. volumes
ENTITY_NAME
Der vollqualifizierte Name der Entität, der das Tag zugewiesen ist.
Options
--max-results int
Maximale Anzahl der zurückzugebenden Ergebnisse.
--page-token string
Token zum Abrufen der nächsten Seite der Ergebnisse.
Beispiele
Im folgenden Beispiel werden alle Kategorienzuweisungen für eine Tabelle aufgelistet:
databricks entity-tag-assignments list tables my_catalog.my_schema.my_table
Im folgenden Beispiel werden Tagzuweisungen mit Paginierung aufgelistet:
databricks entity-tag-assignments list tables my_catalog.my_schema.my_table --max-results 10
databricks entity-tag-assignments update
Aktualisieren einer vorhandenen Tagzuweisung für eine Unity-Katalogentität.
Um Tags auf Unity-Katalogentitäten zu aktualisieren, müssen Sie über die Entität verfügen oder über die folgenden Berechtigungen verfügen:
- APPLY TAG für die Entität
- USE SCHEMA im übergeordneten Schema der Entität
- USE CATALOG im übergeordneten Katalog der Entität
Um ein geregeltes Tag auf Unity-Katalogentitäten zu aktualisieren, müssen Sie auch über die Berechtigung ASSIGN oder MANAGE für die Tagrichtlinie verfügen. Siehe Verwalten von Tagrichtlinienberechtigungen.
databricks entity-tag-assignments update ENTITY_TYPE ENTITY_NAME TAG_KEY UPDATE_MASK [flags]
Argumente
ENTITY_TYPE
Der Typ der Entität, der das Tag zugewiesen ist. Zulässige Werte sind: catalogs, schemas, , tables, columns. volumes
ENTITY_NAME
Der vollqualifizierte Name der Entität, der das Tag zugewiesen ist.
TAG_KEY
Der Schlüssel des Tags.
UPDATE_MASK
Das Feldformat muss eine einzelne Zeichenfolge sein, wobei mehrere Felder durch Kommas getrennt sind (keine Leerzeichen). Der Feldpfad ist relativ zum Ressourcenobjekt, wobei ein Punkt (.) zum Navigieren zwischen Unterfeldern (z. B author.given_name. ) verwendet wird. Die Angabe von Elementen in Sequenz- oder Zuordnungsfeldern ist nicht zulässig, da nur das gesamte Sammlungsfeld angegeben werden kann. Feldnamen müssen exakt mit den Ressourcenfeldnamen übereinstimmen.
Ein Sternchen-*-Feldmaske gibt den vollständigen Ersatz an. Es wird empfohlen, die zu aktualisierenden Felder immer explizit auflisten und die Verwendung von Wildcards zu vermeiden, da sie zu unbeabsichtigten Ergebnissen führen kann, wenn sich die API in zukunft ändert.
Options
--json JSON
Die Inline-JSON-Zeichenfolge oder der @path zur JSON-Datei mit dem Anforderungstext
--tag-value string
Der Wert des Tags.
Beispiele
Im folgenden Beispiel wird eine Tagzuweisung für eine Tabelle aktualisiert:
databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --tag-value staging
Im folgenden Beispiel wird eine Tagzuweisung mithilfe von JSON aktualisiert:
databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --json '{"tag_value": "development"}'
Globale Kennzeichnungen
--debug
Gibt an, ob die Debugprotokollierung aktiviert werden soll.
-h oder --help
Hilfe für die Databricks CLI oder die zugehörige Befehlsgruppe oder den zugehörigen Befehl anzeigen.
--log-file Schnur
Eine Zeichenfolge, die die Datei darstellt, in die Ausgabeprotokolle geschrieben werden sollen. Wenn dieses Flag nicht angegeben ist, werden Ausgabeprotokolle standardmäßig in stderr geschrieben.
--log-format Format
Der Protokollformattyp text oder json. Der Standardwert ist text.
--log-level Schnur
Eine Zeichenfolge, die die Protokollformatebene darstellt. Wenn nicht angegeben, ist die Protokollformatebene deaktiviert.
-o, --output Typ
Der Befehlsausgabetyp text oder json. Der Standardwert ist text.
-p, --profile Schnur
Der Name des Profils in der ~/.databrickscfg Datei, das zum Ausführen des Befehls verwendet werden soll. Wenn dieses Flag nicht angegeben wird, wird, falls vorhanden, das Profil mit dem Namen DEFAULT verwendet.
--progress-format Format
Das Format zum Anzeigen von Statusprotokollen: default, , append, inplaceoder json
-t, --target Schnur
Falls zutreffend, das zu verwendende Bündelziel