Dokumentacja tabeli systemu tagów podlegających

Na tej stronie opisano schemat tabeli systemowej tagów zarządzanych i zawiera przykładowe zapytania. Tabela zawiera rekord dla każdego klucza tagu zarządzanego na koncie, w tym tagi utworzone przez klienta i wygenerowane przez system. Służy do programowego określania, które tagi na twoim koncie podlegają.

Ścieżka tabeli: system.tags.governed_tags

Ważna

Ta tabela systemowa znajduje się w wersji beta.

Tabela systemu tagów zarządzanych zawiera bieżącą migawkę wszystkich definicji tagów zarządzanych, w tym usuniętych. Po usunięciu deleted_at tagu zarządzanego zostanie wypełniony znacznik czasu. Aby uzyskać bieżącą listę zarządzanych tagów, przefiltruj wiersze, w których deleted_at znajduje się null. Zobacz Pobieranie zarządzanych tagów dla konta.

Schemat tabeli tagów podlegających

Tabela systemowa tagów zarządzanych używa następującego schematu:

Nazwa kolumny Typ danych Description Example
account_id ciąg Identyfikator konta, do którego należy ten zarządzany tag. 7af234db-66d7-4db3-bbf0-956098224879
id ciąg Identyfikator zarządzanego tagu, który jest używany do zarządzania uprawnieniami. ca886134-876c-4671-a38b-332edf48c602
tag_key ciąg Nazwa zarządzanego klucza tagu. system.certification_status
deleted_at sygnatura czasowa Czas usunięcia tagu zarządzanego. null jeśli tag nie został usunięty. 2025-02-20T23:26:27.655Z
change_time sygnatura czasowa Czas ostatniego zmiany tagu zarządzanego. 2025-02-20T23:26:27.655Z

Klucz podstawowy jest account_id połączony z elementem id.

Przykłady zapytań

Przed uruchomieniem zastąp wartości parametrów własnymi wartościami.

Pobieranie zarządzanych tagów dla konta

Odfiltruj usunięte tagi, aby uzyskać bieżącą listę zarządzanych tagów dla konta:

SELECT
  account_id,
  id,
  tag_key,
  change_time
FROM system.tags.governed_tags
WHERE deleted_at IS NULL;

Użyj zestawu wyników jako kanonicznej listy bieżących zarządzanych tagów dla konta.

Określanie, które przypisania tagów podlegają

Dołącz tagi zarządzane za pomocą tagów kolumn w schemacie informacji, aby określić, które przypisania tagów wykazu aparatu Unity używają klucza tagu zarządzanego:

WITH governed_tags AS (
  SELECT account_id, id, tag_key
  FROM system.tags.governed_tags
  WHERE deleted_at IS NULL
),
assignments AS (
  SELECT
    catalog_name, schema_name, table_name, column_name, tag_name, tag_value
  FROM system.information_schema.column_tags
)
SELECT
  a.catalog_name,
  a.schema_name,
  a.table_name,
  a.column_name,
  a.tag_name,
  a.tag_value,
  CASE WHEN g.tag_key IS NOT NULL THEN TRUE ELSE FALSE END AS is_governed
FROM assignments a
LEFT JOIN governed_tags g
  ON a.tag_name = g.tag_key;

Każde przypisanie tagu kolumny obejmuje is_governed = true , gdy jego klucz tagu pasuje do klucza tagu zarządzanego.