この記事では、Pendoデータ同期をSnowflakeに接続する方法について説明します。Snowflakeで専用のロール、ユーザー、ウェアハウス、データベースを作成し、Pendoが生成する公開鍵をインストールして、接続の詳細情報をPendoに入力します。Pendoはデータをお客様のSnowflakeアカウントにコピーするため、組織がそのデータを所有し、ストレージとコンピューティングの費用を負担します。
Pendoには、2種類のSnowflake宛先タイプがあります。この記事では、フォームで[ホスト(Host)]、[ポート(Port)]、[データベース(Database)]、[スキーマ(Schema)]、[ユーザー名(Username)]の入力を求められるSnowflake宛先について説明します。宛先が[レガシー(Snowflake)(Snowflake (legacy))]とラベル付けされている場合、またはフォームで[ロール(Role)]、[組織名(Organization name)]、[アカウント名(Account name)]、[コンピュートウェアハウス(Compute warehouse)]の入力を求められる場合は、Pendoデータ同期をSnowflake(レガシー)に接続する設定を参照してください。
注:このSnowflake宛先は、米国およびEUリージョンのPendoサブスクリプションでのみご利用いただけます。
認証の仕組み
Pendoは、キーペア認証を使用してSnowflakeに接続します。パスワードをPendoと共有する必要はありません。
- Pendoがキーペアを生成し、秘密鍵を保持します。お客様が目にするのは公開鍵のみです。
- 公開鍵をSnowflakeのサービスユーザーに関連付けます。Snowflakeはサービスユーザーのパスワードを段階的に廃止しているため、キーペア認証がサポートされる方法となっています。
- Pendoはそのユーザーとしてサインインし、デフォルトのロールとデフォルトのウェアハウスを使用します。そのロールに付与された権限によって、Pendoがアクセスできる範囲を制御できます。
開始する前に
開始する前に、以下を確認してください。
- Pendoサブスクリプションの管理者であるか、[データ同期を設定(Configure Data Sync)]権限を持っていること。
- このSnowflake宛先がサブスクリプションで有効になっていること。Pendoはサブスクリプションごとにこれを有効化します。有効にするには、Pendoのアカウント担当者にお問い合わせください。
- Snowflakeで
SECURITYADMINおよびSYSADMINロールを使用できること、またはそれらを使用できるSnowflake管理者がいること。 - Snowflakeアカウントのホスト名を把握していること。ホスト名は
.snowflakecomputing.comで終わります(例:myorg-myaccount.snowflakecomputing.com)。 - Snowflakeアカウントでネットワークポリシーが使用されているかどうかを把握していること。使用されている場合は、ステップ3でPendoのIPアドレスを許可します。
- ロール、ユーザー、ウェアハウス、データベース、スキーマの名前には、英字、数字、アンダースコアのみを使用してください。Snowflakeは、引用符で囲まれていない名前を大文字で保存します。
各Pendoサブスクリプションには、それぞれ固有の公開鍵があるため、専用のSnowflakeユーザーが必要です。ロール、ウェアハウス、データベースは、サブスクリプション間で共有できます。
ステップ1:Pendoで宛先を開始する
宛先フォームを開くとPendoが公開鍵を生成するため、まずPendoから作業を開始します。
- Pendoで、[設定(Settings)] > [データ同期(Data Sync)]に移動します。
- データ同期の設定フローで、Snowflakeを選択し、[宛先を選択(Select destination)]を選択します。
- [宛先の認証情報を入力(Enter the destination credentials)]で、[公開鍵(Public key)]をコピーします。これはステップ2のスクリプトに貼り付けます。
Snowflakeを設定している間は、設定フローを開いたままにしておいてください。使用しない鍵は30日後に失効します。鍵が失効した場合は、設定フローを再度開いて新しい鍵を取得し、Snowflakeユーザーを更新してください。
ステップ2:Snowflakeでロール、ユーザー、ウェアハウス、データベースを作成する
このスクリプトは、Pendo専用のロール、サービスユーザー、X-Smallウェアハウス、データベースを作成し、データ同期に必要な権限のみをそのロールに付与します。
- Snowflakeで、新しいSQLワークシートを開きます。
- 次のスクリプトをワークシートにコピーします。
<PUBLIC_KEY_FROM_PENDO>を、ステップ1でコピーした鍵に置き換えます。 - 必要に応じて、
SET行の名前を変更します。既存のウェアハウスまたはデータベースを使用する場合は、その名前を入力すると、スクリプトは作成処理をスキップします。ユーザー名とデータベース名を控えておいてください。これらはステップ4でPendoに入力します。 - スクリプトを実行します。
SET user_name = 'PENDO_DATASYNC_USER'; SET role_name = 'PENDO_DATASYNC_ROLE'; SET warehouse_name = 'PENDO_DATASYNC_WH'; SET database_name = 'PENDO_DATASYNC_DB'; USE ROLE SECURITYADMIN; -- Create the role for the transfer service CREATE ROLE IF NOT EXISTS IDENTIFIER($role_name); GRANT ROLE IDENTIFIER($role_name) TO ROLE SYSADMIN; -- Create the service user with the public key from Pendo CREATE USER IF NOT EXISTS IDENTIFIER($user_name) RSA_PUBLIC_KEY = '<PUBLIC_KEY_FROM_PENDO>' DEFAULT_ROLE = $role_name DEFAULT_WAREHOUSE = $warehouse_name TYPE = SERVICE; GRANT ROLE IDENTIFIER($role_name) TO USER IDENTIFIER($user_name); USE ROLE SYSADMIN; -- Create the warehouse and database for Pendo data CREATE WAREHOUSE IF NOT EXISTS IDENTIFIER($warehouse_name) WAREHOUSE_SIZE = XSMALL WAREHOUSE_TYPE = STANDARD AUTO_SUSPEND = 60 AUTO_RESUME = TRUE INITIALLY_SUSPENDED = TRUE; CREATE DATABASE IF NOT EXISTS IDENTIFIER($database_name); -- Grant the role access to the warehouse and database GRANT USAGE ON WAREHOUSE IDENTIFIER($warehouse_name) TO ROLE IDENTIFIER($role_name); GRANT CREATE SCHEMA, MONITOR, USAGE ON DATABASE IDENTIFIER($database_name) TO ROLE IDENTIFIER($role_name);
スキーマが存在しない場合、Pendoがそれを作成します。既存のスキーマを使用する場合は、CREATE SCHEMAに頼るのではなく、そのスキーマに対してALL PRIVILEGESをロールに付与してください。
Pendoのロールは、スキーマ内で作成したテーブルおよびステージの所有権を保持し続ける必要があります。そのスキーマ内のテーブルに対するFUTURE OWNERSHIPを他のロールに付与しないでください。
ステップ3:ネットワークポリシーを使用している場合はPendoのIPアドレスを許可する
Snowflakeアカウントにネットワークポリシーが設定されていない場合は、この手順をスキップしてください。確認するには、SHOW NETWORK POLICIES;を実行します。結果が返されない場合は、ステップ4に進みます。
Pendoユーザーに適用されるネットワークポリシーに、お客様のリージョンに対応するPendoのIPアドレスを追加します。既存のポリシーを更新するか、新しいポリシーを作成してPendoユーザーのみに関連付けることができます。
| Pendoリージョン | IPアドレス |
|---|---|
| 米国 | 136.114.218.147/32 |
| EU | EUのアドレスについては、Pendoサポートにお問い合わせください。 |
USE ROLE SECURITYADMIN;
CREATE NETWORK POLICY PENDO_DATASYNC_POLICY
ALLOWED_IP_LIST = ('136.114.218.147/32');
ALTER USER PENDO_DATASYNC_USER SET NETWORK_POLICY = PENDO_DATASYNC_POLICY;ステップ4:Pendoで宛先の設定を完了する
- Pendoに戻り、Snowflake宛先フォームを開きます。
-
[ホスト]を入力します。これはSnowflakeアカウントのホスト名で、プロトコルやパスを含みません(例:
myorg-myaccount.snowflakecomputing.com)。 -
[ポート]は
443のままにします。 - ステップ2で設定した[データベース]、[スキーマ]、[ユーザー名]を入力します。スキーマ名のみを入力してください。スキーマが存在しない場合は、Pendoがそれを作成します。
- [検証(Validate)]を選択し、続いてデータの選択に進みます。
ウェアハウスやロールの入力欄はありません。Pendoは、ステップ2のスクリプトで設定された、ユーザーのデフォルトのウェアハウスとデフォルトのロールを使用します。
検証が失敗した場合は、[エラーを表示(View error)]を選択して原因を確認し、その場で修正してから再度検証してください。よくある原因については、この記事のトラブルシューティングを参照してください。
ステップ5:同期するデータを選択する
同期するPendoアプリを選択します。アカウントおよび訪問者のメタデータも選択できます。データの選択は初期設定時には必須ではなく、後から完了することもできます。
宛先の設定とデータの選択が完了すると、最初の定期同期が翌日未明までに開始されます。以降の同期は、約24時間ごとに実行されます。各定期同期では新規および更新された行が増分的に読み込まれるため、完全な再読み込みは必要ありません。
データは、ステップ4で入力したスキーマ内にテーブルとして格納されます。使用可能なテーブルとフィールドについては、データ同期のスキーマ定義を参照してください。
Snowflakeの鍵をローテーションする
セキュリティポリシーで必要とされる場合は、鍵をローテーションしてください。新しい鍵を昇格するまでは現在の鍵が引き続き機能するため、ローテーション中も同期は継続されます。
- Pendoで、[設定] > [データ同期]に移動します。
- Snowflake宛先の[宛先を管理(Manage destination)]を選択します。
- [鍵をローテーション(Rotate key)]を選択します。
- [新しい鍵を生成(Generate new key)]を選択します。Pendoに[新しい公開鍵(New public key)]と、それをインストールするSQLが表示されます。新しい鍵は、昇格しない場合は30日で失効します。
- Snowflakeで、[新しい鍵をステージングするSQL(SQL to stage new key)]に表示されているSQLを実行します。これにより、Pendoユーザーの空いている鍵スロットに新しい鍵が追加され、現在の鍵はそのまま残ります。
- Pendoで、[新しい鍵を昇格(Promote new key)]を選択します。[鍵のローテーションが完了しました(Key rotation complete)]と表示されたら、Pendoは新しい鍵で接続します。
- Snowflakeで、[古い鍵スロットを削除するSQL(SQL to remove old key slot)]に表示されているSQLを実行します。
昇格に失敗した場合、宛先は引き続き現在の鍵を使用します。ステージングされた鍵がPendoユーザーにインストールされていることを確認してから、再度[新しい鍵を昇格]を選択してください。
宛先の更新または削除
ホスト、ポート、データベース、スキーマ、またはユーザー名を変更するには、[設定] > [データ同期]に移動し、[宛先を管理]を選択して各フィールドを更新した後、[宛先を検証して更新(Validate and update destination)]を選択します。公開鍵はここでは編集できません。変更するには、鍵をローテーションしてください。
宛先を削除するには、[宛先を管理] > [宛先を削除(Delete destination)]を選択します。宛先を削除すると、定期的な同期が無効になり、自動的に再作成されることはありません。検証エラーを解決するために宛先を削除しないでください。代わりに、その場でエラーを解決してください。
トラブルシューティング
| 症状 | 原因 | 解決方法 |
|---|---|---|
| セットアップスクリプトが権限不足エラーで失敗します。 | 実行者がSECURITYADMINまたはSYSADMINを使用できません。 |
SHOW GRANTS TO USER <your_username>;を実行して確認するか、Snowflake管理者にスクリプトの実行を依頼してください。 |
| Pendoがホストを拒否します。 | ホストが.snowflakecomputing.comで終わっていないか、https://やパスが含まれています。 |
アカウントのホスト名のみを入力してください(例:myorg-myaccount.snowflakecomputing.com)。 |
| 検証が認証エラーまたはJWTエラーで失敗します。 | 公開鍵がユーザーに設定されていない、貼り付けが不完全、または有効期限が切れています。 |
DESC USER <user_name>;を実行してRSA_PUBLIC_KEYを確認します。送信先フォームから鍵を再度コピーし、ALTER USER <user_name> SET RSA_PUBLIC_KEY='<key>';を実行して、もう一度検証してください。 |
| 検証がネットワークエラーまたはIPエラーで失敗します。 | Snowflakeのネットワークポリシーによって、Pendoがブロックされています。 | 手順3の説明に従って、お使いのリージョンのPendoのIPアドレスをポリシーに追加し、もう一度検証してください。 |
| ウェアハウスがアクティブでないため、検証が失敗します。 | ユーザーにデフォルトのウェアハウスが設定されていないか、役割がそのウェアハウスを使用できません。 | ユーザーにDEFAULT_WAREHOUSEを設定し、役割にウェアハウスのUSAGE権限を付与してください。 |
| Pendoは接続できますが、スキーマやテーブルを作成できません。 | 役割にデータベースへのCREATE SCHEMA権限がない、作成したスキーマへの権限がない、または別の役割がそのスキーマ内のテーブルを所有しています。 |
手順2の権限付与を再実行し、Pendoの役割が所有権を保持できるよう、FUTURE OWNERSHIP権限の付与を削除してください。 |
| 送信先のステータスが失敗に変わり、その送信先のデータ同期が無効になります。 | Snowflakeから報告された送信先側の問題により、転送が失敗しました。 | 送信先側の問題を解決してから、Pendoで検証を行い、送信先を再度有効にしてください。 |
| Snowflakeが送信先として表示されない、またはフォームで役割とコンピューティングウェアハウスの入力を求められます。 | このタイプの送信先がサブスクリプションで有効になっていないか、サブスクリプションがサポート対象のリージョンにありません。 | サブスクリプションが米国またはEUのリージョンにあることを確認し、Pendoのアカウント担当者に連絡して有効にしてもらってください。 |
次のステップ
- Pendoが同期するテーブルとフィールドについては、データ同期のスキーマ定義を参照してください。
- 送信先と同期のタイミングの概要については、Pendoデータ同期の概要を参照してください。