Catégories :

Fonctions système (Informations système)

SYSTEM$IS_LISTING_TRIAL

Limite les fonctionnalités d’une Snowflake Native App suivant qu’un consommateur essaie l’application dans le cadre d’une annonce d’essai limitée ou qu’il a accès au produits de données complet.

Renvoie TRUE si le compte du consommateur essaie le produit de données dans le cadre d’une annonce d’essai limitée ; sinon, renvoie FALSE.

Utilisez cette fonction système dans une vue sécurisée, une UDF sécurisée ou une application Streamlit pour gérer l’accès aux fonctionnalités de votre site Snowflake Native App et afficher une sortie spécifique uniquement aux consommateurs ayant accès au produit de données complet.

Prudence

N’utilisez pas cette fonction système pour limiter l’accès aux fonctionnalités pour les consommateurs qui essaient une annonce payante. Utilisez plutôt SYSTEM$IS_LISTING_PURCHASED.

Cette fonction déduit l’annonce associée au paquet d’application qui contient la vue sécurisée, l’UDF sécurisée ou l’application Streamlit et détermine si le compte qui exécute la requête essaie l’annonce dans le cadre d’une annonce d’essai limitée. Pour plus de détails, voir Limiter les fonctionnalités de votre Snowflake Native App pour les consommateurs en version d’essai.

Syntaxe

SYSTEM$IS_LISTING_TRIAL()
Copy

Arguments

Aucun.

Renvoie

La fonction renvoie une valeur de type BOOLEAN.

Exemples

Dans cet exemple, créez une vue sécurisée qui renvoie un sous-ensemble de lignes aux consommateurs en phase d’essai, mais qui renvoie toutes les lignes aux consommateurs ayant un accès complet à votre produit de données. Vous pouvez contrôler la sortie de la vue sécurisée à l’aide de cette fonction système et de la valeur d’une colonne de données afin de déterminer quelles données afficher à quels consommateurs.

Dans cet exemple, créez une vue sécurisée limited_functionality_view avec vos données provenant d’une table nommée exclusive_access_table. Dans cette table, définissez une colonne de type BOOLEAN, is_trial, dans laquelle certaines lignes de données ont is_trial défini sur TRUE pour indiquer que les données de ces lignes doivent être affichées aux consommateurs de l’essai. Pour d’autres lignes, is_trial est défini sur FALSE, ce qui indique que les données de ces lignes ne doivent être affichées qu’aux consommateurs disposant d’un accès complet à votre Snowflake Native App.

Cette vue en exemple est configurée pour renvoyer toutes les lignes uniquement lorsqu’elle est interrogée par un compte de consommateur qui a un accès complet à votre Snowflake Native App, sinon elle renvoie uniquement les lignes pour lesquelles is_trial est défini sur TRUE.

CREATE SECURE VIEW limited_functionality_view
  AS
  SELECT
    *
  FROM
    exclusive_access_table
  WHERE
    is_trial
    OR
    SYSTEM$IS_LISTING_TRIAL() = TRUE;
Copy

Vous trouverez plus d’exemples et de détails à la section Limiter les fonctionnalités de votre Snowflake Native App pour les consommateurs en version d’essai.