Snowflakeのセットアップ - Kameleoon Documentation

Kameleoonに権限を付与するまで、Kameleoonは Snowflake アカウントの読み取りも書き込みもできません。このページでは、Snowflake 識別子、Kameleoonが使用するユーザーとロール、各方向で必要なスキーマ、Kameleoonで入力するフィールドについて説明します。Snowflake ワークシートで SQL コマンドを実行する権限が必要です。ソースとデスティネーションでは同じユーザーとロールを使用し、それぞれの方向で専用のスキーマを追加します。

Kameleoon UI

Snowflake ウェアハウスとの接続を作成するには、まず次のフィールドに入力する必要があります。

以下のセクションでは、各フィールドについて説明し、Snowflake アカウントでそれらを設定する方法を示します。

Snowflake 識別子

Snowflake 識別子は、Snowflake ドキュメントに記載されているアカウント識別子です。Kameleoonのバックエンドは、この識別子をアカウントに接続する完全な URLに挿入します：https://account_identifier.snowflake-computing.com 完全な URLではなく、部分文字列 account_identifierのみを入力してください。

Snowflake ユーザーを作成する

パスワード認証

Snowflake 連携は 2 つの認証方式をサポートしています。1 つ目はパスワード認証です。パスワード認証を使用するには、Snowflake ワークシートで次のコマンドを実行して、KAMELEOON_USERという名前のユーザーを作成します。例のパスワードは、独自の強力なパスワードに置き換えてください：

CREATE USER KAMELEOON_USER PASSWORD='MySecurePassword';

連携を設定する際に、このパスワードを Kameleoonに入力します。

パスワード認証は、Snowflakeをソースとして使用する場合にのみ機能します。Snowflakeをデスティネーションとして使用する場合は、次のセクションで説明するキーペア認証を使用してください。

キーペア認証

2 つ目の認証方式は RSA キーペアを使用します。RSA キーペアは、RSA 秘密鍵と RSA 公開鍵で構成されます。Kameleoonはバックエンドでこのキーペアを生成し、公開鍵を提供します。秘密鍵は Kameleoonのサーバーに保存され、ウェアハウスへの接続に使用されます。 Confirm をクリックすると、Kameleoon UIに公開鍵と、公開鍵を作成したユーザーに割り当てるコマンドが表示されます。UIには公開鍵が再表示されないため、画面を離れる前に公開鍵をコピーしてください。公開鍵を紛失した場合は、接続を削除して再設定すると、新しいキーペアが生成されます。

Snowflakeをデスティネーションとして使用する場合は、パスワード認証ではなく、キーペア認証を選択する必要があります。

Snowflake ロール

ロールを作成する

次のコマンドを実行して KAMELEOON_ROLEという名前のロールを作成し、KAMELEOON_USER ユーザーに割り当てます。独自の命名規則を使用してもかまいません。ロール名は Kameleoonの Role フィールドに入力します。

CREATE ROLE KAMELEOON_ROLE;
GRANT ROLE KAMELEOON_ROLE TO USER KAMELEOON_USER;

ロールに権限を付与する

ロールにウェアハウスへのアクセスを許可します。この例では、MY_WAREHOUSEという名前のウェアハウスを使用します：

GRANT USAGE ON WAREHOUSE MY_WAREHOUSE TO ROLE KAMELEOON_ROLE;

Kameleoonには **KAMELEOON**という名前のデータベースが必要です。この名前を正確に使用し、ロールにデータベースの使用と、そのスキーマでのテーブル作成を許可します：

CREATE DATABASE KAMELEOON;
GRANT USAGE ON DATABASE KAMELEOON TO ROLE KAMELEOON_ROLE;
GRANT USAGE ON FUTURE SCHEMAS IN DATABASE KAMELEOON TO ROLE KAMELEOON_ROLE;
GRANT CREATE TABLE ON FUTURE SCHEMAS IN DATABASE KAMELEOON TO ROLE KAMELEOON_ROLE;

FUTUREの付与は、次の手順で作成するスキーマに適用されます。

Snowflakeをソースとして使用する場合

Snowflakeをソースとして使用する予定がある場合は、**KAMELEOON_CONFIGURATION**という名前のスキーマを作成します。この名前を正確に使用してください：

CREATE SCHEMA KAMELEOON.KAMELEOON_CONFIGURATION;

次に、オーディエンスの元データに対する読み取り権限を Kameleoon ロールに付与します。たとえば、オーディエンスが MY_DATA データベースの MY_AUDIENCES スキーマにある場合は、次のコマンドを実行します：

GRANT USAGE ON DATABASE MY_DATA TO ROLE KAMELEOON_ROLE;
GRANT USAGE ON SCHEMA MY_DATA.MY_AUDIENCES TO ROLE KAMELEOON_ROLE;
GRANT SELECT ON ALL TABLES IN SCHEMA MY_DATA.MY_AUDIENCES TO ROLE KAMELEOON_ROLE;

Snowflakeをデスティネーションとして使用する場合

Snowflakeをデスティネーションとして使用する予定がある場合は、**KAMELEOON_EVENTS**という名前のスキーマを作成します。この名前を正確に使用してください。Kameleoonは、このスキーマにイベントテーブルを書き込みます：

CREATE SCHEMA KAMELEOON.KAMELEOON_EVENTS;

セットアップは完了です。次に、Snowflakeをソースとして、デスティネーションとして、またはその両方を有効化します。

データリージョン

この連携のデータは、お使いのアカウントのデータリージョン（米国または EU）に保存されます。

連携

​Kameleoon UI

​Snowflake 識別子

​Snowflake ユーザーを作成する

​パスワード認証

​キーペア認証

​Snowflake ロール

​ロールを作成する

​ロールに権限を付与する

​Snowflakeをソースとして使用する場合

​Snowflakeをデスティネーションとして使用する場合

​データリージョン