ABAC_POLICY_DEFINITIONS

Dotyczy:zaznaczone jako tak Databricks SQL zaznaczone jako tak Databricks Runtime zaznaczone jako tak tylko katalog Unity

Ważna

Ta funkcja jest dostępna w publicznej wersji testowej.

INFORMATION_SCHEMA.ABAC_POLICY_DEFINITIONS zwraca jeden wiersz dla każdej polityki ABAC przypisanej do obiektu zabezpieczalnego. W każdym wierszu opisano definicję zasad, w tym zakres załącznika, typ zasad, uwzględnione i wykluczone podmioty zabezpieczeń oraz warunek używany do wymuszania zasad.

Aby wypisać polityki na poziomie metastore (Beta), wraz z każdą polityką ABAC w metastore, należy zapytać SYSTEM.INFORMATION_SCHEMA.ABAC_POLICY_DEFINITIONS.

Polisy będą zwracane tylko wtedy, gdy masz READ METADATAMANAGE lub na zabezpieczeniu, gdzie polisa jest przymocowana lub jest jej właścicielem. Jest to zgodne ze wzorcem dostępu OPISANYCH ZASAD.

Ta relacja jest rozszerzeniem standardowego schematu informacyjnego SQL.

Definicja

Relacja ABAC_POLICY_DEFINITIONS zawiera następujące kolumny:

Name Typ danych Zanullowalny Description
POLICY_ID STRING No Unikatowy identyfikator zasad.
POLICY_NAME STRING No Nazwa zasad.
POLICY_TYPE STRING No Typ zasad. Na przykład , ROW_FILTER, COLUMN_MASK, GRANTlub DENY.
CATALOG_NAME STRING Yes Nazwa wykazu, do którego są dołączone zasady lub który zawiera schemat lub tabelę, do których są dołączone zasady. NULL dla polityk powiązanych z metastore (Beta).
SCHEMA_NAME STRING Yes Nazwa schematu, do którego są dołączone zasady lub która zawiera tabelę, do którą są dołączone zasady. NULL dla polityk związanych z metastorem i katalogu.
SECURABLE_NAME STRING Yes Nazwa zabezpieczanego obiektu, do którego są dołączone zasady. NULL dla polityk powiązanych z metastorem, katalogiem i schematem.
ON_SECURABLE_TYPE STRING No Typ zabezpieczalnego obiektu, do którego polityka jest przypisana: METASTORE (Beta), CATALOG, SCHEMA, lub TABLE.
TO_PRINCIPALS ARRAY<STRING> No Zasady mają zastosowanie do podmiotów zabezpieczeń (użytkowników, grup lub jednostek usługi). Pusta tablica [] , gdy żadna z nich nie jest ustawiona.
EXCEPT_PRINCIPALS ARRAY<STRING> No Podmioty zabezpieczeń wykluczone z aplikacji zasad. Pusta tablica [] , gdy żadna z nich nie jest wykluczona.
FOR_SECURABLE_TYPE STRING No Rodzaj zabezpieczalnych celów politycznych. Na przykład TABLE dla filtrów wierszowych i masek kolumnowych, lub MODEL, MODEL_SERVICE, MODEL_PROVIDER_SERVICE, MCP_SERVICE, ( AGENT_SERVICE Beta), albo SKILL (Beta) dla GRANT polityk. W DENY politykach typ zabezpieczalny, na którym przywilej jest odmawiany, taki jak CATALOG, SCHEMA, lub TABLE.
PRIVILEGES ARRAY<STRING> Yes Przywileje przyznane lub odrzucone przez polisę. NULL dla ROW_FILTER zasad i COLUMN_MASK .
WHEN_CONDITION STRING Yes Wyrażenie warunkowe, w którym mają zastosowanie zasady. Na przykład wyrażenie logiczne zgodne z tabelami na podstawie ich tagów podlegających.
MATCH_COLUMNS ARRAY<STRING> Yes Kolumny przywoływanych przez zasady. NULL dla GRANT zasad i DENY .
GOVERNED_TAGS ARRAY<STRUCT<tag_key: STRING, tag_value: STRING>> No Zarządzane tagi odwoływane przez politykę. tag_value to sytuacja, NULL gdy referencja określa tylko klucz. Odniesienia o tym samym kluczu i różnych wartościach pojawiają się jako oddzielne elementy. Pusta tablica [] , gdy polityka odnosi się do żadnych regulowanych tagów.
CREATED_BY STRING No Podmiot zabezpieczeń , który utworzył zasady.

Examples

-- List every GRANT policy in the current catalog.
> SELECT *
    FROM information_schema.abac_policy_definitions
    WHERE policy_type = 'GRANT';

-- List every DENY policy in the current catalog.
> SELECT *
    FROM information_schema.abac_policy_definitions
    WHERE policy_type = 'DENY';

-- Find all row filters and column masks attached to securable objects in a schema.
> SELECT policy_name, policy_type, on_securable_type, securable_name, when_condition, match_columns
    FROM information_schema.abac_policy_definitions
    WHERE policy_type IN ('ROW_FILTER', 'COLUMN_MASK')
      AND catalog_name = 'my_catalog'
      AND schema_name = 'my_schema';

-- Find policies that reference the `priority` governed tag.
> SELECT policy_name, policy_type, on_securable_type, securable_name
    FROM information_schema.abac_policy_definitions
    WHERE exists(governed_tags, tag -> tag.tag_key = 'priority');