​

はじめに

​

MoEngage × Redshift

​

連携

​

ステップ 1：Redshift クラスターがパブリックにアクセス可能であることを確認する

• 新しい Redshift クラスターを作成する場合は、“Network and Security” セクションで “Turn on Publicly accessible” オプションを選択します。
• すでに Redshift クラスターがある場合は、Properties タブで Network and Security セクションを探します。“Edit” ボタンをクリックします。

プロパティで Publicly accessible をオンにして保存します

​

ステップ 2：MoEngage 用の新しいデータベースユーザーを作成する

-- create a new user with a strong password
CREATE USER <username> PASSWORD <password>;
-- create a new schema where MoEngage will dump data
-- you can skip this if you want to use existing schema
CREATE SCHEMA IF NOT EXISTS <schema_name>;
-- grant create access on the above schema or existing schema
GRANT CREATE, USAGE ON SCHEMA <schema_name> TO <username>;

​

ステップ 3：MoEngage の IP がクラスターにアクセスできるようにする

​

新しいセキュリティグループを作成する

1. セキュリティグループに名前と、任意で説明を付けます。
2. VPC を選択します（デフォルトでは選択済みです）。
3. 以下の詳細で新しいインバウンドルールを追加します。

4. アウトバウンドルールは空のままにします。
5. 完了したら “Create security group” をクリックします。

​

既存のセキュリティグループを編集する

1. セキュリティグループのページで “Actions” ボタンをクリックし、“Edit inbound rules” を選択します。
2. 上記の表に従って、新しいインバウンドルールを追加します。
3. 完了したら “Save rules” をクリックします。

​

セキュリティグループを Redshift クラスターにアタッチする

1. Redshift コンソールで、Redshift クラスターを開きます。Properties タブに移動します。
2. “Network & Security settings” セクションで、“Edit” ボタンをクリックします。
3. VPC security groups で、作成または編集したセキュリティグループを選択します。
4. 完了したら “Save changes” をクリックします。

​

ステップ 4：新しい IAM ポリシーを作成する

1. IAM コンソールの Access Management で、Policies に移動します。“Create policy” ボタンをクリックします。
2. Create Policy ページで JSON タブに切り替え、以下のポリシーを貼り付けます。
   JSON

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Sid": "VisualEditor1",
               "Effect": "Allow",
               "Action": [
                   "s3:Get*",
                   "s3:List*"
               ],
               "Resource": [ "<bucket-arn>",
                             "<bucket-arn>/*"]
           }
       ]
   }
   

“Next” をクリックし、任意でタグを追加します。次に “Next: Review” をクリックします。

3. ポリシーに名前と、任意で説明を付けます。準備ができたら “Create policy” をクリックします。

​

ステップ 5：新しい Redshift IAM ロールを作成する

1. IAM コンソールの Access Management で、Roles に移動します。“Create role” ボタンをクリックします。
2. Trusted entity type として “AWS service” を選択します。Use Case で、“Use cases for other AWS services” から “Redshift ” を選択します。Redshift のユースケースの種類で、“Redshift - Customizable ” を選択します。準備ができたら “Next” をクリックします。
3. 次のステップで、ステップ 4 で作成したポリシーを選択します。完了したら Next をクリックします。
4. ロールに名前を付け、先ほど作成した正しいポリシーがアタッチされているかを確認します。準備ができたら Create Role をクリックします。

​

ステップ 6：このロールを Redshift クラスターにアタッチする

1. Properties タブで、“Associated IAM roles” セクションに移動します。
2. “Manage IAM roles” ボタンをクリックし、“Associate IAM roles” オプションを選択します。
3. ポップアップのモーダルから、ステップ 5 で作成したロールを選択します。

4. “Associate IAM roles” をクリックして、このロールを Redshift クラスターにアタッチします。

​

ステップ 7：MoEngage App Marketplace で Redshift 連携を有効にする

1. MoEngage ダッシュボードで、App Marketplace に移動します。
2. “Redshift” を検索します。
3. “Integrate” タブに移動し、”+ Add Integration” をクリックします。

4. Redshift クラスターの接続の詳細を入力します。

フィールド	説明	例
Connection Name	この接続に識別しやすい名前を付けます。	My Redshift Instance 1
Host Name	AWS コンソールで Redshift クラスターに移動します。General information の下に、ホスト名が Redshift エンドポイントとして表示されます。コロン : より前の部分を貼り付けます。 たとえば、Endpoint が redshift-cluster-1.xxxxxxxzgxxx.us-east-1.redshift.amazonaws.com:5439/dev の場合、Host Name は redshift-cluster-1.xxxxxxxzgxxx.us-east-1.redshift.amazonaws.com になります。	形式は [name].[id].[region].redshift.amazonaws.com である必要があります
Port	ポート番号を入力します。AWS コンソールで Redshift クラスターに移動します。Properties タブの Database configurations で、ポート番号とデータベース名を確認できます。デフォルトでは、Redshift のポート番号は 5439 です。	5439
Database	Redshift データベースの名前です。	moengage_exports
Username	MoEngage が接続に使用するユーザー名を入力します。既存のユーザー、または ステップ 2 で作成したユーザーのいずれかを指定できます。	—
Password	データベースユーザーのパスワードを入力します。	—
IAM Role ARN	ステップ 5 で作成した IAM ロールの ARN を入力します。ARN を確認するには、AWS コンソールで IAM コンソールに移動します。サイドメニューの Access Management で、Roles をクリックします。ステップ 5 で作成した IAM ロールを選択します。Summary セクションに ARN が表示されています。これをコピーして入力フィールドに貼り付けます。	形式は arn:aws:iam::[aws-account-id]:role/[role-name] である必要があります
Export into schema	MoEngage は指定されたスキーマにテーブルを作成します。特に構成していない限り、スキーマ名の通常の値は “public” です。	—
Select events to export	Redshift クラスターにエクスポートするイベントを選択します。	—

5. 任意で、接続をテストできます。MoEngage は入力された詳細が正しいかどうかを検証します。問題がある場合はエラーが表示されるので、修正できます。
6. 接続テストが成功したら、接続の詳細を保存できます。MoEngage は間もなく Redshift クラスターへのイベントのエクスポートを開始します。

​

データを正しく受信しているかを確認する

1. test_connection_moengage - このテーブルは、接続の詳細が有効かどうかを定期的に確認するために使用します。
2. moengage_events - すべてのイベントをこのテーブルにダンプ（追加）します。

​

サポートされている日時形式

​

テーブル構造のサンプル

​

エクスポートの頻度

​

よくある質問