詳細情報:
Snowflake 接続
Snowflake から CRM Analytics にデータを同期するには、Snowflake コネクタを使用してリモート接続を作成します。このコネクタは、認証に非公開鍵または OAuth 2.0 をサポートします。OAuth 2.0 を使用するには、Snowflake での追加の設定手順と Salesforce ログイン情報が必要です。
OAuth を使用した Snowflake への接続
OAuth 接続で CRM Analytics Snowflake コネクタを使用するには、Snowflake、Salesforce、CRM Analytics、外部 OAuth 認証サーバーを設定する必要があります。
手順の概要を次に示します。組織のセキュリティ要件に一致する設定が必要な場合は、ネットワークセキュリティ部門または IT 部門にお問い合わせください。
- Snowflake および選択した外部認証サーバーを設定します。この Snowflake のヘルプには、Okta などのサービスへの接続に関する詳細な手順が示されています。
- 認証サーバーを設定したら、「OpenID Connect を使用した認証プロバイダーの設定」の「Salesforce で認証プロバイダーを定義する」の手順に従います。
- Okta を使用している場合、この Okta の手順に従って Salesforce にサービスを追加します。
- 認証プロバイダーを Salesforce に追加したら、Salesforce で指定ログイン情報を定義します。OAuth 2.0 認証プロトコルおよび指定ユーザー ID 種別を選択します。外部ログイン情報の使用はサポートされていません。
- Snowflake テスト手順の手順に従って OAuth フローを確認します。Salesforce 外部ログイン情報のプリンシパルアクセス権から検証することもできます。[Authenticate (認証)] をクリックし、[Authentication Status (認証状況)] が [Configured (設定済み)] に更新されていることを確認します。
- Snowflake 接続を追加します。[認証種別] 設定に「OAuth」と入力します。
接続の詳細
Snowflake 非公開鍵のドキュメントを使用して、Snowflake 非公開鍵と非公開鍵パスフレーズを生成します。Snowflake 非公開鍵を循環することを選択した場合、手動で新しい鍵を使用した接続プロパティを更新します。
- [データマネージャー接続] タブで、[新しい接続] をクリックします。
- コネクタの名前をクリックし、[次へ] をクリックします。
- コネクタ設定を入力します。
- 設定を検証してソースへの接続を試みるには、[保存 & テスト] をクリックします。接続に失敗すると、考えられる理由が CRM Analytics に表示されます。
特に明記されていない限り、すべての設定で値が必要です。
| 設定 | 説明 |
|---|---|
| 接続名 | 接続を識別します。異なる接続を区別しやすい規則を使用します。 |
| API 参照名 | 接続の API 参照名。この名前にスペースを含めることはできません。API 参照名は、この接続を介して抽出されたデータをレシピで参照するために使用します。接続の作成後に API 参照名を変更することはできません。 |
| 説明 | 説明 |
| ユーザー名 | Snowflake アカウントのユーザー名。 |
| パスワード | 省略可能な設定*。Snowflake アカウントのパスワード。 |
| 認証種別 | この接続に使用される認証の種類。使用できる値は、「OAuth」、「Password」、または「PrivateKey」です。最も安全なオプションとして「PrivateKey」をお勧めします。
|
| 指定ログイン情報 | Salesforce 組織に保存されている指定ログイン情報の [名前] 項目。 |
| 非公開鍵 | 省略可能な設定*。Snowflake アカウントに関連付けられた非公開鍵。 メモ Advanced Encryption Standard (AES) で生成された暗号化された非公開鍵とパスワードを使用する必要があります。詳細な手順は、Snowflake ヘルプの「キーペア認証とキーペアの循環」を参照してください。 openssl コマンドを使用して暗号化キーを生成する場合は、des3 を aes256 に置き換えて、高度な暗号化が使用されていることを確認してください。 |
| 非公開鍵パスフレーズ | 省略可能な設定*。指定された非公開鍵に関連付けられたパスフレーズ。 |
| アカウント | Snowflake アカウントの名前。 アカウント名は、Snowflake URL のドメインの最初の区分です。たとえば、123abc は https://123abc.snowflakecomputing.com のアカウント名です。 |
| ウェアハウス | Snowflake ウェアハウス名。この設定は、大文字と小文字を区別するため、Snowflake に表示されているとおりに値を入力してください。 |
| ロール | 省略可能な設定。接続に使用しているユーザーに割り当てられた Snowflake ロール。 |
| 追加の JDBC URL パラメーター | 省略可能な設定。1 つ以上の JDBC 接続パラメーター。次の形式で入力します。 parameter1=value;parameter2=value;parameter3=value 次に例を示します。 user=joates;warehouse=mywh;db=mydb&schema=public |
| データベース | Snowflake データベース名。この設定は、大文字と小文字を区別するため、Snowflake に表示されているとおりに値を入力してください。 |
| スキーマ | Snowflake スキーマ名。この設定は、大文字と小文字を区別するため、Snowflake に表示されているとおりに値を入力してください。 |
*パスワードを入力するか、非公開鍵と非公開鍵パスフレーズの両方を入力します。非公開鍵の詳細は、Snowflake 非公開鍵のドキュメントを参照してください。
CRM Analytics に同期するデータの絞り込み
データ同期検索条件を使用して、不要なデータや機密データを CRM Analytics との同期から除外します。検索条件はソースオブジェクトで実行されます。検索条件を使用すると、必要なデータのみが CRM Analytics に取り込まれるため、データ同期の時間を短縮できます。除外したデータを将来使用する予定がある場合、データ同期検索条件ではなくレシピ検索条件を使用して、データセットに書き込まれるデータを制限します。
- データマネージャーから、[接続] タブをクリックします。
- 絞り込むオブジェクトに関連付けられた接続を選択します。
- 絞り込むオブジェクトの名前をクリックします。
- [データ同期検索条件] をクリックします。
- 検索条件を入力します。
- [保存] をクリックします。
Snowflake コネクタの場合、Snowflake WHERE のドキュメントの説明に従って SQL 検索条件を入力します。
Snowflake コネクタを使用するときは、次の点に留意してください。
- 接続済みオブジェクト名は、先頭が文字で、文字、数字、またはアンダースコアのみが含まれている必要があります。オブジェクト名の末尾をアンダースコアにすることはできません。
- 英数字、ドット、アンダースコア、ダッシュの文字を組み合わせた項目名のみがサポートされます。コネクタに、スペースや括弧などの他の文字を含んだ項目名がある場合、同期に失敗します。
- Snowflake でコネクタにデータを送信するクエリを実行すると、浮動小数点数で丸めエラーが発生する可能性があります。詳細は、Snowflake ヘルプの浮動小数点数のデータ型を参照してください。Snowflake で ID が浮動小数点数として指定されている場合、これらのエラーにより誤った ID がコネクタに送信される可能性があります。Snowflake の ID には NUMBER または同等のデータ型を使用します。
- コネクタは、オブジェクトあたり最大 1 億行または 50 GB のいずれか先に制限に達したものを同期できます。 このコネクタを使用する場合、Salesforce Government Cloud 組織のデータは高度な暗号化を使用して転送中に保護され、接続済みオブジェクトごとに最大 1,000 万行または 5 GB のいずれか先に制限に達したものを同期できます。
- Snowflake ウェアハウスを自動的に再開または一時停止するように設定できます。これらの機能の最適な使用方法についての詳細は、Snowflake ドキュメントを参照してください。
- 指定ログイン情報の ID 種別に [指定ユーザー] を使用し、状況は [認証済み] である必要があります。
- 従来のバージョンの Snowflake コネクタを使用している場合、[Private Key (非公開鍵)] 設定と [Private Key Passphrase (非公開鍵パスフレーズ)] 設定は使用されません。[Password (パスワード)] プロパティは必須です。
