AFFICHER LES STRATÉGIES

S’applique à :coche marqué oui Databricks SQL coche marqué oui Databricks Runtime 16.4 et versions ultérieures coche marqué oui Unity Catalog uniquement

Répertorie les stratégies associées à un élément sécurisable. Deux formulaires sont pris en charge :

  1. SHOW POLICIES : répertorie uniquement les stratégies directement associées à l’élément sécurisable cible.
  2. SHOW EFFECTIVE POLICIES : répertorie les stratégies directement associées à la cible sécurisable et les stratégies héritées des parents dans la hiérarchie des ressources.

Pour exécuter cette déclaration, vous devez avoir le READ METADATA privilège ou MANAGE sur le sécurisé cible, ou en être propriétaire. READ METADATA accorde une visibilité en lecture seule des politiques ; MANAGE ou la propriété est toujours requise pour créer, modifier ou supprimer des politiques. Pour lister les politiques ON METASTORE (Bêta), vous devez avoir READ METADATA un site sur le metastore ou être administrateur du metastore.

La même autorisation est vérifiée pour les deux formulaires. Aucune autorisation supplémentaire n’est requise sur les éléments sécurisables parents. Par exemple, l’affichage de stratégies effectives sur une table ne nécessite pas l’autorisation d’afficher des stratégies sur le schéma ou le catalogue.

Syntaxe

SHOW [ EFFECTIVE ] POLICIES ON { METASTORE | CATALOG catalog_name | SCHEMA schema_name | TABLE table_name
  | { MODEL SERVICE | MODEL PROVIDER SERVICE | MCP SERVICE | AGENT SERVICE | SKILL } securable_name }

Paramètres

  • EFFICACE

    Optionnel. Lorsqu’elles sont spécifiées, répertorie les stratégies directement associées à l’élément sécurisable cible et aux stratégies héritées des parents dans la hiérarchie de ressources. En cas d’omission, répertorie uniquement les stratégies directement associées à l’élément sécurisable cible.

  • catalog_name

    Nom du catalogue. Les stratégies définies sur ce catalogue sont répertoriées.

  • schema_name

    Nom du schéma. Les stratégies définies sur ce schéma sont répertoriées.

  • table_name

    Nom de la table. Les stratégies définies sur cette table sont répertoriées.

  • securable_name

    Le nom pleinement qualifié d’un sécurisé non conteneur supporté.

Résultat

L’instruction retourne une table de résultats.

AFFICHER LES STRATÉGIES

  • Policy Name STRING NOT NULL : Nom de la stratégie.
  • Policy Type CHAÎNE NON NULLE : Type de la politique (par exemple, ROW_FILTER, COLUMN_MASK, ou GRANT).
  • Catalog STRING NOT NULL : catalogue de l’élément sécurisable sur lequel la stratégie est définie.
  • Schema STRING : Schéma de l’élément sécurisable ou NULL lorsque la cible est un catalogue.
  • Table STRING : Nom de table lorsque la stratégie est définie sur une table ou NULL dans le cas contraire.
  • Comment STRING : Commentez la stratégie, le cas échéant.
  • on_securable_type STRING : Type de garantie à laquelle la police est attachée.
  • on_securable_fullname STRING : Nom entièrement qualifié du garant auquel la police est attachée.

AFFICHER LES STRATÉGIES EFFECTIVES

  • Policy Name STRING NOT NULL : Nom de la stratégie.
  • Policy Type CHAÎNE NON NULLE : Type de la politique (par exemple, ROW_FILTER, COLUMN_MASK, ou GRANT).
  • Catalog STRING NOT NULL : Catalogue où la stratégie est définie (directe ou héritée).
  • Schema STRING : Schéma où la stratégie est définie ou NULL lorsqu’elle est définie sur un catalogue.
  • Table STRING : Table où la stratégie est définie ou NULL lorsqu’elle est définie sur le catalogue ou le schéma.
  • Comment STRING : Commentez la stratégie, le cas échéant.
  • on_securable_type STRING : Type de garantie à laquelle la police est attachée.
  • on_securable_fullname STRING : Nom entièrement qualifié du garant auquel la police est attachée.

La table inclut des stratégies directement sur l’élément sécurisable cible et, pour SHOW EFFECTIVE POLICIES, les stratégies héritées des parents dans la hiérarchie des ressources. Pour afficher les détails complets d’une stratégie, utilisez DESCRIBE POLICY.

Exemples

> SHOW POLICIES ON SCHEMA mycatalog.myschema;
> SHOW EFFECTIVE POLICIES ON SCHEMA mycatalog.myschema;