Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Uwaga / Notatka
Te informacje dotyczą interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej. Interfejs CLI Databricks jest w publicznej wersji testowej.
Korzystanie z interfejsu wiersza polecenia usługi Databricks podlega licencjom usługi Databricks i powiadomieniom o ochronie prywatności usługi Databricks, w tym wszelkim przepisom dotyczącym danych użycia.
Grupa entity-tag-assignments poleceń w interfejsie wiersza polecenia usługi Databricks zawiera polecenia służące do tworzenia, aktualizowania, usuwania i wyświetlania listy przypisań tagów w jednostkach wykazu aparatu Unity. Tagi to atrybuty, które zawierają klucze i opcjonalne wartości, których można użyć do organizowania i kategoryzowania jednostek w wykazie aparatu Unity. Zobacz Stosowanie tagów do obiektów mogących podlegać zabezpieczeniu w Unity Catalog.
databricks entity-tag-assignments create
Utwórz przypisanie tagu dla jednostki wykazu aparatu Unity.
Aby dodać tagi do jednostek wykazu aparatu Unity, musisz być właścicielem jednostki lub mieć następujące uprawnienia:
- ZASTOSUJ TAG w jednostce
- USE SCHEMA w schemacie nadrzędnym jednostki
- USE CATALOG w katalogu nadrzędnym jednostki
Aby dodać zarządzany tag do jednostek wykazu aparatu Unity, musisz również mieć uprawnienie ASSIGN or MANAGE dla zasad tagu. Zobacz Zarządzanie uprawnieniami zasad tagów.
databricks entity-tag-assignments create ENTITY_NAME TAG_KEY ENTITY_TYPE [flags]
Arguments
ENTITY_NAME
W pełni kwalifikowana nazwa jednostki, do której przypisano tag.
TAG_KEY
Klucz tagu.
ENTITY_TYPE
Typ jednostki, do której przypisano tag. Dozwolone wartości to: catalogs, , tablesschemas, columns, volumes.
Opcje
--json JSON
Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania
--tag-value string
Wartość tagu.
Przykłady
W poniższym przykładzie utworzono przypisanie tagu dla tabeli:
databricks entity-tag-assignments create my_catalog.my_schema.my_table environment tables --tag-value production
W poniższym przykładzie utworzono przypisanie tagu przy użyciu formatu JSON:
databricks entity-tag-assignments create my_catalog.my_schema.my_table department tables --json '{"tag_value": "finance"}'
databricks entity-tag-assignments delete
Usuń przypisanie tagu dla jednostki wykazu aparatu Unity według jego klucza.
Aby usunąć tagi z jednostek wykazu aparatu Unity, musisz być właścicielem jednostki lub mieć następujące uprawnienia:
- ZASTOSUJ TAG w jednostce
- USE_SCHEMA w schemacie nadrzędnym jednostki
- USE_CATALOG w katalogu nadrzędnym jednostki
Aby usunąć tag zarządzany z jednostek wykazu aparatu Unity, musisz również mieć uprawnienie PRZYPISZ lub ZARZĄDZAJ w zasadach tagów. Zobacz Zarządzanie uprawnieniami zasad tagów.
databricks entity-tag-assignments delete ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]
Arguments
ENTITY_TYPE
Typ jednostki, do której przypisano tag. Dozwolone wartości to: catalogs, , tablesschemas, columns, volumes.
ENTITY_NAME
W pełni kwalifikowana nazwa jednostki, do której przypisano tag.
TAG_KEY
Klucz tagu do usunięcia.
Opcje
Przykłady
Poniższy przykład usuwa przypisanie tagu z tabeli:
databricks entity-tag-assignments delete tables my_catalog.my_schema.my_table environment
databricks entity-tag-assignments get
Pobierz przypisanie tagu dla jednostki wykazu aparatu Unity według klucza tagu.
databricks entity-tag-assignments get ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]
Arguments
ENTITY_TYPE
Typ jednostki, do której przypisano tag. Dozwolone wartości to: catalogs, , tablesschemas, columns, volumes.
ENTITY_NAME
W pełni kwalifikowana nazwa jednostki, do której przypisano tag.
TAG_KEY
Klucz tagu.
Opcje
Przykłady
Poniższy przykład pobiera przypisanie tagu dla tabeli:
databricks entity-tag-assignments get tables my_catalog.my_schema.my_table environment
databricks entity-tag-assignments list
Wyświetlanie listy przypisań tagów dla jednostki wykazu aparatu Unity.
Ważne
Interfejs API jest domyślnie podzielony na strony. Strona może zawierać zero wyników, a jednocześnie dostarczać next_page_token. Klienci muszą kontynuować odczytywanie stron do czasu braku next_page_token, co jest jedynym wskazaniem, że osiągnięto koniec wyników.
databricks entity-tag-assignments list ENTITY_TYPE ENTITY_NAME [flags]
Arguments
ENTITY_TYPE
Typ jednostki, do której przypisano tag. Dozwolone wartości to: catalogs, , tablesschemas, columns, volumes.
ENTITY_NAME
W pełni kwalifikowana nazwa jednostki, do której przypisano tag.
Opcje
--max-results int
Maksymalna liczba wyników do zwrócenia.
--page-token string
Token do pobrania następnej strony wyników.
Przykłady
W poniższym przykładzie wymieniono wszystkie przypisania tagów dla tabeli:
databricks entity-tag-assignments list tables my_catalog.my_schema.my_table
W poniższym przykładzie wymieniono przypisania tagów z podziałem na strony:
databricks entity-tag-assignments list tables my_catalog.my_schema.my_table --max-results 10
aktualizacja atrybutów entity-tag-assignments usługi databricks
Aktualizowanie istniejącego przypisania tagu dla jednostki wykazu aparatu Unity.
Aby zaktualizować tagi do jednostek wykazu aparatu Unity, musisz być właścicielem jednostki lub mieć następujące uprawnienia:
- ZASTOSUJ TAG w jednostce
- USE SCHEMA w schemacie nadrzędnym jednostki
- USE CATALOG w katalogu nadrzędnym jednostki
Aby zaktualizować zarządzany tag do jednostek wykazu aparatu Unity, musisz również mieć uprawnienie ASSIGN or MANAGE dla zasad tagu. Zobacz Zarządzanie uprawnieniami zasad tagów.
databricks entity-tag-assignments update ENTITY_TYPE ENTITY_NAME TAG_KEY UPDATE_MASK [flags]
Arguments
ENTITY_TYPE
Typ jednostki, do której przypisano tag. Dozwolone wartości to: catalogs, , tablesschemas, columns, volumes.
ENTITY_NAME
W pełni kwalifikowana nazwa jednostki, do której przypisano tag.
TAG_KEY
Klucz tagu.
UPDATE_MASK
Maska pól musi być pojedynczym ciągiem z wieloma polami rozdzielonymi przecinkami (bez spacji). Ścieżka pola jest względna względem obiektu zasobu, używając kropki (.), aby nawigować po polach podrzędnych (np. author.given_name). Specyfikacja elementów w polach sekwencji lub mapowania jest niedozwolona, ponieważ można określić tylko całe pole kolekcji. Nazwy pól muszą być dokładnie zgodne z nazwami pól zasobów.
Symbol gwiazdki (*) w maskowaniu pola wskazuje pełne zastąpienie. Zaleca się, aby zawsze jawnie wyświetlać listę aktualizowanych pól i unikać używania symboli wieloznacznych, ponieważ może to prowadzić do niezamierzonych wyników, jeśli interfejs API ulegnie zmianie w przyszłości.
Opcje
--json JSON
Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania
--tag-value string
Wartość tagu.
Przykłady
Poniższy przykład aktualizuje przypisanie tagu dla tabeli:
databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --tag-value staging
Poniższy przykład aktualizuje przypisanie tagu przy użyciu formatu JSON:
databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --json '{"tag_value": "development"}'
Flagi globalne
--debug
Czy włączyć logowanie debugowe.
-h lub --help
Wyświetl pomoc dla Databricks CLI lub dla powiązanej grupy poleceń czy pojedynczego polecenia.
--log-file łańcuch znaków
Ciąg tekstowy reprezentujący plik do zapisywania logów wyjściowych. Jeśli ta flaga nie zostanie określona, wartością domyślną jest zapisywanie dzienników wyjściowych w programie stderr.
--log-format formatowanie
Format typu logu text lub json. Domyślna wartość to text.
--log-level łańcuch znaków
Ciąg reprezentujący poziom formatu zapisu dziennika. Jeśli nie zostanie określony, poziom formatu dziennika jest wyłączony.
-o, --output typ
Typ danych wyjściowych polecenia: text lub json. Domyślna wartość to text.
-p, --profile łańcuch znaków
Nazwa profilu w pliku ~/.databrickscfg, który ma być użyty do uruchomienia polecenia. Jeśli ta flaga nie zostanie określona, to jeśli istnieje, zostanie użyty profil o nazwie DEFAULT.
--progress-format formatowanie
Format wyświetlania dzienników postępu: default, , appendinplacelubjson
-t, --target łańcuch znaków
Jeśli ma to zastosowanie, docelowy obiekt pakietu do użycia