カテゴリ:

システム関数 （システム情報）

SYSTEM$IS_LISTING_TRIAL

コンシューマーが 限定トライアルリスト の一部としてアプリケーションをトライアルしているか、または完全なデータ製品にアクセスしているかに基づいて、 Snowflake Native App の機能を制限します。

コンシューマーアカウントが限定トライアルリストの一部としてデータ製品を試用している場合は TRUE を返し、そうでない場合は FALSE を返します。

このシステム関数をセキュアビュー、セキュア UDF、またはStreamlitアプリで使用し、 Snowflake Native App の機能へのアクセスを管理し、完全なデータ製品にアクセスできるコンシューマーのみに特定の出力を表示します。

注意

このシステム関数を使用して、有料リストを試用しているコンシューマーの機能性へのアクセスを制限しないでください。代わりに、 SYSTEM$IS_LISTING_PURCHASED を使用してください。

この関数は、セキュアビュー、セキュア UDF、またはStreamlitアプリが含まれるアプリケーションパッケージに関連付けられたリストを推測し、クエリを実行しているアカウントが限定トライアルリストの一部としてそのリストをトライアルしているかどうかを判断します。詳細については、 トライアルコンシューマー向けにSnowflakeネイティブアプリ機能を制限 をご参照ください。

構文

SYSTEM$IS_LISTING_TRIAL()
Copy

引数

なし。

戻り値

この関数は、 BOOLEAN 型の値を返します。

例

この例では、トライアルコンシューマーには行のサブセットを返し、データ製品にフルアクセスできるコンシューマーにはすべての行を返す、セキュアビューを作成します。このシステム関数とデータ列の値を使用して、どのデータをどのコンシューマーに表示するかを決定し、セキュリティビューの出力を制御できます。

この例では、 exclusive_access_table というテーブルのデータを使用したセキュアビュー limited_functionality_view を作成します。そのテーブルで、BOOLEAN 型の列、 is_trial を定義します。ここで、データのいくつかの行は、 is_trial を TRUE に設定し、それらの行のデータがトライアルのコンシューマーに表示される必要があることを示します。他の行では is_trial が FALSE に設定されており、これらの行のデータは 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ネイティブアプリ機能を制限 をご参照ください。

言語: 日本語