类别：

系统函数 （系统信息）

SYSTEM$IS_LISTING_TRIAL

基于使用者是在试用作为 受限试用列表 一部分的应用程序，还是有权访问完整的数据产品，限制 Snowflake Native App 的功能。

如果使用者账户正在试用作为受限试用列表的一部分的数据产品，则返回 TRUE，否则将返回 FALSE。

在安全视图、安全 UDF 或 Streamlit 应用程序中使用本系统函数来管理对 Snowflake Native App 功能的访问，并且仅向有权访问完整数据产品的使用者显示某些输出。

小心

请勿使用此系统函数来限制试用付费列表的使用者对功能的访问。请改用 SYSTEM$IS_LISTING_PURCHASED。

此函数推断与包含安全视图、安全 UDF 或 Streamlit 应用程序的应用程序包关联的列表，并确定运行查询的账户是否正在试用作为有限试用列表一部分的列表。有关更多详细信息，请参阅 限制试用使用者使用 Snowflake Native App 的功能。

语法

SYSTEM$IS_LISTING_TRIAL()
Copy

实参

无。

返回

该函数返回 BOOLEAN 类型的值。

示例

在此示例中，创建安全视图，将一部分行返回给试用使用者，但将所有行返回给对数据产品具有完全访问权限的使用者。您可以使用此系统函数控制安全视图的输出和数据列的值，以确定要向哪些使用者显示哪些数据。

在此示例中，用来自名为 exclusive_access_table 的表的数据创建安全视图 limited_functionality_view。在该表中，定义 BOOLEAN 类型列 is_trial，其中的某些数据行具有设置为 TRUE 的 is_trial，用于表示应向试用的使用者显示这些行中的数据。其他行具有设置为 FALSE 的 is_trial，表示这些行中的数据应仅向具有 Snowflake Native App 完全访问权限的使用者显示。

根据此示例视图的设置，仅在具有 Snowflake Native App 完全访问权限的使用者账户进行查询时才返回所有行，否则仅返回 is_trial 设置为 TRUE 的行。

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

在 限制试用使用者使用 Snowflake Native App 的功能 中查看更多示例和详细信息。

语言: 中文