注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

Snowflake

Foundry と Snowflake を接続して、Snowflake と Foundry 間でデータの読み込みと同期を行います。

サポートされている機能

機能	ステータス
一括インポート	🟢 一般提供
エクスポートタスク	🟢 一般提供
探索	🟢 一般提供
インクリメンタル	🟢 一般提供
仮想テーブル	🟢 一般提供

セットアップ

データ接続アプリケーションを開き、画面右上の**+ 新規ソース** を選択します。
利用可能なコネクタタイプから Snowflake を選択します。
インターネット経由で直接接続を使用するか、中間エージェント経由で接続するかを選択します。
以下のセクションの情報を使用して、コネクタの設定を続けるための追加の設定プロンプトに従います。

Foundry でコネクタをセットアップする方法について詳しくは、こちらをご覧ください。

接続詳細

オプション	必須？	説明
`Account identifier`	はい	これは ".snowflakecomputing.com" に先行する識別子です。詳細については、Snowflake の公式ドキュメント（外部）を参照してください。
`Roles`	いいえ	提供された資格情報が複数のロールにアクセスできる場合、接続で使用されるデフォルトのロールです。
`Database`	はい	接続後に使用するデフォルトのデータベースを指定します。
`Schema`	いいえ	接続後に使用するデフォルトのスキーマを指定するオプションです。指定しない場合、資格情報の範囲内にあるすべてのスキーマが利用可能になります。
`Warehouse`	いいえ*	接続後に使用する仮想ウェアハウスです。登録された仮想テーブルの場合、これはソース側のコンピューティングに使用されます。
`Credentials`	はい	オプション 1: ユーザー名とパスワードユーザー名とパスワードを提供します。個々のユーザー資格情報ではなく、サービス資格情報の使用を推奨します。オプション 2: キーペア認証ユーザー名と秘密鍵を提供します。キーペア認証の設定方法については、Snowflake の公式ドキュメント（外部）を参照してください。すべての資格情報オプションで、提供されたユーザーとロールが対象のデータベースとスキーマの使用権限、および対象テーブルの選択権限を持っていることを確認してください。仮想テーブルを登録する場合、ユーザーとそのロールは、ウェアハウスの使用権限も持っている必要があります。
`Network Connectivity`	はい**	Snowflake で `SELECT SYSTEM$ALLOWLIST()` を実行し、Foundry の出口ポリシーに `SNOWFLAKE_DEPLOYMENT` と `STAGE` のエントリが少なくとも追加されていることを確認します。詳細については、以下のネットワーキングセクションを参照してください。

* ウェアハウスの詳細は、Foundry データセットの同期にはオプションですが、仮想テーブルの登録には必須です。
** ネットワーク出口ポリシーは、直接接続に必要ですが、エージェントベースの接続には必要ありません。

ネットワーキング

Snowflake と Foundry 間の直接接続を有効にするには、Data Connection アプリケーションでソースを設定する際に、適切な出口ポリシーを追加する必要があります。

Snowflake アカウントのホスト名とポート番号を許可リストに追加するには、Snowflake コンソールで以下のコマンドを実行します。 Foundry の出口ポリシーに SNOWFLAKE_DEPLOYMENT と STAGE のエントリが少なくとも追加されていることを確認してください。

Copied!1
2
3
4
5
-- 次のクエリは、システムの許可リストから情報を取得します。
SELECT t.VALUE:type::VARCHAR as type,  -- type列をVARCHAR型として取得
       t.VALUE:host::VARCHAR as host,   -- host列をVARCHAR型として取得
       t.VALUE:port as port             -- port列を取得
FROM TABLE(FLATTEN(input => PARSE_JSON(SYSTEM$ALLOWLIST()))) AS t;  -- システムの許可リストをJSON形式で解析し、結果をフラット化してテーブルにします。

Snowflake の公式ドキュメント（外部リンク）で、許可リストに登録するホスト名やポート番号の特定方法についての追加情報をご覧ください。

限られたケース（Foundry と Snowflake の環境によります）では、PrivateLink 経由で接続を確立する必要がある場合があります。これは、Foundry と Snowflake の両方が同じ CSP（例：AWS-AWS、Azure-Azure）でホストされている場合に一般的です。この状況がユーザーのセットアップに適用されると考える場合は、追加のガイダンスのために Palantir の担当者に連絡してください。

仮想テーブル

このセクションでは、Snowflake ソースを使用した仮想テーブルに関する追加の詳細情報を提供します。このセクションは、Foundry データセットに同期する場合には適用されません。

仮想テーブルの機能	ステータス
ソース形式	🟢 一般提供：テーブル、ビュー、マテリアライズドビュー
手動登録	🟢 一般提供
自動登録	🟢 一般提供
プッシュダウン計算	🟢 一般提供；Snowflake Spark コネクタ（外部リンク）を介して利用可能
インクリメンタル	🟢 一般提供：`APPEND` のみ

仮想テーブルを使用する際には、以下のソース設定の要件を忘れないでください。

ソースを直接接続として設定する必要があります。仮想テーブルは中間エージェントの使用をサポートしていません。
接続の詳細でウェアハウスを指定する必要があります。
提供された資格情報は、ウェアハウスの使用権限を持つ必要があります。

詳細については、上記の Connection Details セクションを参照してください。

さらに、Foundry 仮想テーブルによってバックアップされたパイプラインのインクリメンタルサポートを有効にするために、Snowflake のソーステーブルで以下の設定が有効になっていることを確認してください。

Change Tracking（外部リンク）
適切な保持期間の Time Travel（外部リンク）

データモデル

array（外部リンク）、object（外部リンク）、および variant（外部リンク）タイプの行は、Foundry で string タイプとして解析されることに注意してください。これは、ソースの可変型のためです。

例えば、Snowflake の配列 [ 1, 2, 3 ] は、Foundry で "[1,2,3]" という文字列として解釈されます。

詳細については、Snowflake の公式ドキュメント（外部リンク）を参照してください。