Request data sharing via listings¶

アプリからのプロバイダーまたはサードパーティとのデータ共有¶

一部 Snowflake Native Apps には、さまざまなビジネス目的で、プロバイダー、またはサードパーティのSnowflakeアカウントとデータを共有する必要があります。主なユースケースには、次が含まれます。

• コンプライアンスレポート: 監査ログまたはコンプライアンスデータの規制アカウントと共有

• テレメトリーと分析: 製品改善のために使用状況メトリックをプロバイダーに送り返す

• データの前処理: 変換済みデータのパートナーアカウントとの共有

• サポートとトラブルシューティング: サポートチームへの診断データの提供

アプリからのデータ共有を有効にするには、アプリが共有とリストの両方を提供する必要があります。共有には共有されるデータベースオブジェクトが含まれ、リストはアカウントとリージョン間でデータを共有するメカニズムを提供します。

データ共有の詳細については、Secure Data Sharingについて をご参照ください。

リストを使用してデータを共有するようにアプリを構成するには、以下の手順に従います。

1. 権限の自動付与 を使用してコンシューマーに共有やリストを作成する権限をリクエストします。

2. 共有を作成し、データベースオブジェクトを付与します。

3. 共有に添付された外部リストを作成します。

4. 特定のターゲットアカウントとデータを共有する許可をコンシューマーにリクエストするには、アプリケーション仕様 を使用します。

データ共有のためのアプリ仕様ワークフロー¶

リストを使用してデータを共有するようにアプリを構成するには、次の一般的なワークフローに従います。

1. プロバイダーは、アプリの :doc:` 権限の自動付与 <requesting-auto-privs>` 構成します。これにより、アプリに共有とリストを作成する権限が付与されます。

   注釈

   アプリの仕様ではマニフェストファイルに manifest_version: 2 を設定する必要があります。

2. プロバイダーは CREATESHARE および CREATELISTING 権限 マニフェストファイルに追加します。

3. プロバイダーが追加 必要に応じて、次のオブジェクトを作成するためにセットアップスクリプトに SQL のステートメントを実行します。

   • 共有

   • 外部リスト

   • ジョブ仕様

   セットアップスクリプトは、アプリがインストールまたはアップグレードされたときに共有とリストを作成します。アプリの仕様は、セットアップ中に作成することも、実行時にストアドプロシージャを通じて作成することもできます。

4. アプリを構成する場合、コンシューマーはリストのターゲットアカウントと自動フルフィルメントの設定を確認して承認します。自動フルフィルメントの設定は、クロスリージョンの共有にのみ適用されます。コンシューマーがアプリ仕様を表示し、承認する方法については、 Approve app specifications をご参照ください。

データ共有のためのアプリ仕様定義¶

タイプ LISTING のアプリ仕様の場合、アプリ仕様定義には以下のエントリが含まれます。

• TARGET_ACCOUNTS:データ共有するターゲットアカウントのコンマ区切りリスト（一重引用符で囲む）。各アカウントは OrgName.AccountName の形式で指定する必要があります。例: 'ProviderOrg.ProviderAccount,PartnerOrg.PartnerAccount'

• LISTING:アプリによって作成されたリストオブジェクトの識別子。

• AUTO_FULFILLMENT_REFRESH_SCHEDULE:オプション。クロスリージョンデータ共有のリフレッシュスケジュール。<num>MINUTE または USINGCRON<expression> として指定可能です。

マニフェストファイルのバージョンを指定します。¶

アプリに対する権限の自動付与を有効にするには、次の例に示すように、マニフェストファイルの先頭でバージョンを設定します。

manifest_version: 2

CREATESHARE および CREATELISTING 権限をマニフェストファイルに追加します。¶

その CREATESHARE および CREATELISTING 権限により、インストール中またはアップグレード時にアプリは共有やリストを作成できます。

• これらの権限をリクエストするようにアプリを構成するには、マニフェストファイルの privileges セクションに次のコードを追加します。

  CopyExpand

  manifest_version: 2
  ...
  privileges:
    - CREATE SHARE:
        description: "Create a share for sharing compliance data with provider"
    - CREATE LISTING:
        description: "Create a listing for cross-region sharing of compliance data"
  ...
  

  Show lessSee more

  Scroll to top

マニフェストファイルで manifest_version を2に設定した場合、Snowflakeは、インストールまたはアップグレード中にアプリに CREATE SHARE および CREATE LISTING 権限を自動的に付与します。

共有の作成とオブジェクトの付与¶

1. データ共有用の共有を作成するには、次の例に示すように、セットアップスクリプトに CREATE SHARE コマンドを追加します。

CREATE SHARE IF NOT EXISTS compliance_share;

1. 次の例に示すように、共有するデータベースオブジェクトを付与します。

CopyExpand

GRANT USAGE ON DATABASE app_created_db TO SHARE compliance_share;
GRANT USAGE ON SCHEMA app_created_db.reporting TO SHARE compliance_share;
GRANT SELECT ON TABLE app_created_db.reporting.metrics TO SHARE compliance_share;

Show lessSee more

Scroll to top

外部リストを作成する¶

1. 共有に添付された外部リストを作成するには、次の例に示すように CREATE LISTING コマンドをセットアップスクリプトに追加します。

   CopyExpand

   CREATE EXTERNAL LISTING IF NOT EXISTS compliance_listing
   SHARE compliance_share
     AS
     $$
       title: "Compliance Data Share"
       subtitle: "Regulatory compliance reporting data"
       description: "Share compliance and audit data with authorized accounts"
       listing_terms:
         type: "OFFLINE"
     $$
     PUBLISH = FALSE
     REVIEW = FALSE;
   

   Show lessSee more

   Scroll to top

リストのアプリ仕様の作成¶

1. リストのアプリ仕様を作成するには、この例に従います。

   CopyExpand

   ALTER APPLICATION SET SPECIFICATION shareback_spec
     TYPE = LISTING
     LABEL = 'Compliance Data Sharing'
     DESCRIPTION = 'Share compliance data with provider for regulatory reporting'
     TARGET_ACCOUNTS = 'ProviderOrg.ProviderAccount,AuditorOrg.AuditorAccount'
     LISTING = compliance_listing
     AUTO_FULFILLMENT_REFRESH_SCHEDULE = '720 MINUTE';
   

   Show lessSee more

   Scroll to top

   このコマンドは、指定されたターゲットアカウントとデータを共有する許可をリクエストする shareback_spec という名前のアプリ仕様を作成します。

2. クロスリージョンの共有の場合 AUTO_FULFILLMENT_REFRESH_SCHEDULE パラメーターは必須です。次のいずれかの値に設定できます。

   • '<num> MINUTE':分数（最低10分）

   • 最大8日間または11520分（8日間）

   • 'USING CRON <expression> <time_zone>':タイムゾーン付きCRON式

コンシューマー承認ワークフロー¶

コンシューマーがアプリ仕様を表示し、承認する方法については、 Approve app specifications をご参照ください。

LISTING アプリ仕様のコンシューマー承認がこのワークフローをトリガーします。

• Snowflakeは、ターゲットアカウントを自動的にリストに追加します。

• 指定された場合、Snowflakeは自動フルフィルメントの更新スケジュールを構成します。

• リストはターゲットアカウントに表示されます。

• リストに添付されたデータは、承認されたアカウントからクエリできます。

LISTING アプリ仕様のコンシューマーによる拒否がこのワークフローをトリガーします。

• 自動フルフィルメントが無効になっています。

• リストは公開されたままになり、コンシューマーは共有データを引き続き表示できます。

• アプリがインストールされている現在のアカウントを除き、すべてのターゲットアカウントがリストから削除されます。

• リストに添付されたデータは、現在のアカウント以外のターゲットアカウントではクエリできなくなります。

リスト構成の検証¶

アプリは、以下のコマンドを実行することで、承認後にリストが適切に構成されたことを検証できます。

-- Check if the app specification is approved:
SHOW APPROVED SPECIFICATIONS IN APPLICATION;

-- Validate the listing configuration:
DESC LISTING compliance_listing;

LISTING アプリ仕様を使用するためのベストプラクティス¶

アプリの仕様を介してデータ共有を実装する場合は、次のベストプラクティスを考慮します。

• 共有の整合性: Snowflakeは、アプリケーションによって作成された共有をコンシューマーが変更することを防ぐことはできません。その結果、プロバイダーは、基礎となる共有データの整合性を保護するための対策を実施する責任があります。

• エラー処理: アプリ仕様が却下された場合や、まだ承認されていない場合に、適切なエラー処理を実装します。

• クロスリージョンの考慮事項: アプリのプロバイダーは、データの鮮度要件とコスト考慮のバランスをとるリフレッシュスケジュールを設定する責任があります。リストの自動フルフィルメントのコストはアプリのコンシューマーに請求されますが、アプリのコンシューマーの不要なコストを最小限に抑えるために、プロバイダーはコストを認識してスケジュールを選択する必要があります。

• コンプライアンス: アプリ仕様の説明に、共有するデータと共有する理由を明確に文書化します。

LISTING アプリ仕様でのコールバック関数の使用¶

アプリは、マニフェストファイルに以下のコードを追加することで、ライフサイクルコールバックを使用して、コンシューマーがリスト仕様を承認または却下した場合に応答することができます。

lifecycle_callbacks:
  specification_action: callbacks.on_spec_update

セットアップスクリプトで、次のコールバックストアドプロシージャを追加します。

CREATE OR REPLACE PROCEDURE callbacks.on_spec_update (
  name STRING,
  status STRING,
  payload STRING)
RETURNS STRING
LANGUAGE SQL
AS
$$
BEGIN
  IF (name = 'SHAREBACK_SPEC' AND status = 'APPROVED') THEN
    -- Start populating shared tables
    CALL populate_compliance_data();
  ELSEIF (name = 'SHAREBACK_SPEC' AND status = 'DECLINED') THEN
    -- Clean up or notify provider
    CALL cleanup_share_data();
  END IF;
  RETURN 'Processed specification update';
END;
$$;

プロシージャにより、アプリはアプリのデータ共有リクエストに関するコンシューマーの決定に適切に対応することができます。

Viewing shareback data as a provider¶

After a consumer approves the LISTING app specification and data is shared, the provider can view the shared listing and access the data. Providers can do this using either Snowsight or SQL.

Viewing shareback data as a consumer¶

Before approving a LISTING app specification, consumers should inspect the data that the app intends to share. This provides full visibility into the actual content of a share, allowing consumers to verify the following:

• The data being shared matches what the provider described in the app specification.

• No sensitive or unexpected data is included in the share.

• The data meets any internal compliance or governance requirements.

Consumers can inspect data prior to approval and continue to query it at any time after approval. Use either Snowsight or SQL to view the shared data.

SHOW SCHEMAS IN DATABASE NATIVEAPP$MY_LISTING;
SHOW OBJECTS IN SCHEMA NATIVEAPP$MY_LISTING.MY_SCHEMA;
SELECT * FROM NATIVEAPP$MY_LISTING.MY_SCHEMA.MY_TABLE;

制限事項¶

このセクションでは、アプリ仕様を使用する際の制限について説明します。

監査

Snowflakeは、アプリがプロバイダーと共有するデータに対する組み込みの監査を提供していません。コンシューマーに監査追跡を含むコンプライアンスまたは規制要件がある場合は、プロバイダーと直接調整して、独自の個別のモニターソリューションを実装する必要があります。

アプリケーション内からの共有

リストの自動フルフィルメントはこの方法で共有されるデータでは現在サポートされていないため、Snowflakeはアプリケーション内から直接プロバイダーとのデータ共有を推奨しません。