開発者 APIs を使用してテンプレートを順次実行する¶

中間結果について¶

プロバイダーが、あるテンプレートの結果をテンプレートチェーン内の後続のテンプレートでも利用できるようにしたい場合、テンプレートの結果のキャッシュを作成することができます。キャッシュを持つ各テンプレートには、そのキャッシュの有効期限もあります。

プロバイダーがテンプレートにキャッシュがあることを指定した場合、ユーザーがテンプレートチェーンを初めて実行すると、そのテンプレートの結果がクリーンルーム内のテーブルに格納されます。この基礎テーブルは、クリーンルーム自体からのみアクセス可能です。次にユーザーがテンプレートチェーンを実行するとき、 Snowflake Data Clean Rooms はテンプレートを実行する前にキャッシュの有効期限が切れていないか確認します。キャッシュされた結果を持つテンプレートは、キャッシュが期限切れにならない限り再実行されません。

テンプレートチェーンの後続のテンプレートは、テンプレートに適切なJinjaパラメーターを含めることで、キャッシュを入力として使用できます。

テンプレートチェーンの定義¶

プロバイダーは、 provider.add_template_chain コマンドを使ってテンプレートチェーンを作成します。プロバイダーが新しいテンプレートチェーンに追加したいテンプレートは、テンプレートチェーンを作成する前に存在している必要があります。

provider.add_template_chain コマンドは以下の引数を受け付けます。

• クリーンルームの名前（string）

• テンプレートチェーンの名前（string）

• テンプレートチェーンのテンプレート（JSON オブジェクトの配列）

provider.add_template_chain コマンドを使用してテンプレートチェーンを作成する例については、 例 をご参照ください。

CALL samooha_by_snowflake_local_db.provider.add_template_chain(
  'collab_clean_room',
  'insights_chain',
  [
    {
      'template_name': 'crosswalk',
      'cache_results': True,
      'output_table_name': 'crosswalk',
      'jinja_output_table_param': 'crosswalk_table_name',
      'cache_expiration_hours': 2190
    },
    {
      'template_name': 'transaction_insights',
      'cache_results': False
    }
  ]
);

テンプレートチェーンの実行¶

クリーンルームユーザーは、 consumer.run_analysis コマンドを実行してテンプレートチェーンを実行します。テンプレートチェーンを実行すると、チェーン内の各テンプレートがあらかじめ定義された順序で実行され、最終的な結果が得られます。

consumer.run_analysis コマンドは、テンプレートチェーン内のJinjaテンプレートに渡す引数を受け取ります。consumer.get_arguments_from_template_chain コマンドを実行することで、チェーン内のテンプレートがどのような引数を期待しているかを判断することができます。

consumer.run_analysis に渡される引数は、チェーン内の特定のテンプレートに固有のものであることも、チェーン内のすべてのテンプレートに対する引数であることもできます。

（ユニバーサル引数）

テンプレートチェーン内のすべてのテンプレートに引数を渡したい場合、構文は consumer.run_analysis を使って1つのテンプレートを実行するのと同様です。例えば、以下のコマンドは、 where_clause 引数の値をテンプレートチェーン内のすべてのテンプレートに渡します。

CALL samooha_by_snowflake_local_db.consumer.run_analysis(
  'collab_clean_room',
  'insights_chain',
  ['MY_CONSUMER_DB.C_SCHEMA.CONVERSIONS'],
  ['PROVIDER_DB.P_SCHEMA.EXPOSURES'],
  object_construct(
    'where_clause', 'p.EMAIL=c.EMAIL'
  )
);

Copy

テンプレート固有の引数

特定のテンプレートに引数を渡したい場合は、トップレベル object_construct の子として、テンプレート名をフィールド名とした別の object_construct を追加します。例えば、以下のコマンドは dimensions 引数の値を crosswalk_template テンプレートにのみ渡します。

CALL samooha_by_snowflake_local_db.consumer.run_analysis(
  'collab_clean_room',
  'insights_chain',
  ['MY_CONSUMER_DB.C_SCHEMA.CONVERSIONS'],
  ['PROVIDER_DB.P_SCHEMA.EXPOSURES'],
  object_construct(
    'where_clause', 'p.EMAIL=c.EMAIL',
    'crosswalk_template', object_construct(
      'dimensions', ['p.CAMPAIGN']
    )
  )
);

Copy

テンプレートチェーンコマンド¶

テンプレートチェーンを操作するには、以下のコマンドを使用できます。

これらのコマンドの詳細については、以下をご参照ください。

• Snowflakeデータクリーンルーム：プロバイダーAPIリファレンスガイド

• Snowflakeデータクリーンルーム：コンシューマーAPIリファレンスガイド