ABAC_POLICY_DEFINITIONS

Si applica a:con contrassegno sì Databricks SQL con contrassegno sì Databricks Runtime con contrassegno sì solo per Unity Catalog

Importante

Questa funzionalità è in Anteprima Pubblica.

INFORMATION_SCHEMA.ABAC_POLICY_DEFINITIONS restituisce una riga per ogni policy ABAC allegata a un oggetto sicurabile. Ogni riga descrive la definizione dei criteri, inclusi l'ambito dell'allegato, il tipo di criterio, le entità incluse ed esentate e la condizione usata per applicare i criteri.

Per elencare le policy a livello metastore (Beta), insieme a tutte le policy ABAC nel metastore, consulta SYSTEM.INFORMATION_SCHEMA.ABAC_POLICY_DEFINITIONS.

Vedrai le polizze restituite solo quando possiedi READ METADATA o MANAGE sul securable dove la polizza è allegata, o ne sei proprietaria. Corrisponde al modello di accesso di DESCRIBE POLICY.

Questa relazione è un'estensione dello schema delle informazioni standard di SQL.

Definition

La relazione ABAC_POLICY_DEFINITIONS contiene le colonne seguenti:

Name Tipo di dati Annulabile Description
POLICY_ID STRING No Identificatore univoco del criterio.
POLICY_NAME STRING No Nome dei criteri.
POLICY_TYPE STRING No Tipo di criteri. Ad esempio, ROW_FILTER, COLUMN_MASK, GRANTo DENY.
CATALOG_NAME STRING Yes Nome del catalogo a cui è associato il criterio o che contiene lo schema o la tabella a cui è associato il criterio. NULL per le policy associate al metastore (Beta).
SCHEMA_NAME STRING Yes Nome dello schema a cui è associato il criterio o che contiene la tabella a cui è associato il criterio. NULL per le politiche legate al metastore e al catalogo.
SECURABLE_NAME STRING Yes Nome dell'oggetto a protezione diretta a cui è associato il criterio. NULL per le policy legate al metastore, al catalogo e allo schema.
ON_SECURABLE_TYPE STRING No Tipo di oggetto garantibile a cui la policy è associata: METASTORE (Beta), CATALOG, SCHEMA, o TABLE.
TO_PRINCIPALS ARRAY<STRING> No Le entità (utenti, gruppi o entità servizio) a cui si applicano i criteri. [] Matrice vuota quando non è impostata nessuna.
EXCEPT_PRINCIPALS ARRAY<STRING> No Entità escluse dall'applicazione dei criteri. [] Matrice vuota quando non viene escluso nessuno.
FOR_SECURABLE_TYPE STRING No Tipo dell'oggetto a protezione diretta destinazioni dei criteri quando valutato. Ad esempio, TABLE per filtri a riga e maschere a colonna, oppure MODEL, MODEL_SERVICE, MODEL_PROVIDER_SERVICE, MCP_SERVICE, oppure AGENT_SERVICE per GRANT policy. Per le DENY policy, il tipo di sicurezza su cui il privilegio è negato, come CATALOG, SCHEMA, o TABLE.
PRIVILEGES ARRAY<STRING> Yes Privilegi concessi o negati dalla polizza. NULL per ROW_FILTER e COLUMN_MASK criteri.
WHEN_CONDITION STRING Yes Espressione condizionale con cui si applicano i criteri. Ad esempio, un'espressione booleana che corrisponde alle tabelle in base ai tag regolati.
MATCH_COLUMNS ARRAY<STRING> Yes Colonne a cui fa riferimento il criterio. NULL per GRANT e DENY criteri.
GOVERNED_TAGS ARRAY<STRUCT<tag_key: STRING, tag_value: STRING>> No Tag regolamentati menzionati dalla politica. tag_value è NULL quando un riferimento specifica solo una chiave. I riferimenti con la stessa chiave e valori diversi appaiono come elementi separati. Array [] vuoto quando la policy non fa riferimento a tag governati.
CREATED_BY STRING No Entità che ha creato i criteri.

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');
  • Ultimo aggiornamento: