Snowflake のデータからクエリを実行するには、まず MoEngage を Snowflake データウェアハウスに接続する必要があります。

新しいSnowflake接続を作成する手順

1. あなたのMoEngageダッシュボードで、 アプリマーケットプレイス に移動します。
2. Snowflakeを検索します。
3. 「 統合タブ 」に移動し、「 接続を追加 」をクリックします
4. Snowflake データウェアハウスの詳細を提供してください。

Snowflake に次のフィールドを入力してください。

1. 接続名: この接続に識別可能な名前を付けてください。例: My Snowflake Prod
2. Snowflake アカウント識別子
   • 常にあなたのSnowflake URLの最初に見つかります。例えば;(https://ACCOUNT_IDENTIFIER.snowflakecomputing.com)。

   • フォーマットは、Snowflakeアカウントの年齢に基づいて異なる場合があります。詳細については、 Snowflakeのドキュメントを参照してください。

3. Snowsightを使用している場合は、左側のナビゲーションの下部に アカウント名 があります。インポートしたいアカウントを選択し、「コピー」アイコンをクリックしてアカウントIDをコピーします。最新の情報と詳細については、 Snowflakeのドキュメントを参照してください。
4. 倉庫: MoEngageがクエリを実行するために使用するウェアハウスの名前。例えば、COMPUTE _WAREHOUSE
5. データベース: MoEngageがテーブルを読み取るために使用すべきデータベース。ウェアハウスセグメント/インポート/エクスポートを設定する際にスキーマを選択できます。例：MY_DEMO_DB
6. ユーザー名: MoEngageがテーブルを読み込むために使用すべきデータベース。倉庫セグメント/インポート/エクスポートを設定する際にスキーマを選択できます。
7. 認証方法: MoEngageは、2つの方法を使用してSnowflakeインスタンスに接続できます：
   • パスワード: パスワードを選択する場合は、上記に入力したデータベースユーザー（ユーザー名）のパスワードを提供してください。
   • キー: 認証方法として「キー」を選択した場合は、以下の手順を実行してください。
   • 「キーを生成」をクリックすると、MoEngageがあなたの公開鍵を表示します。この公開鍵をデータベースユーザーに追加する必要があります。これを設定するための手順については、 Snowflakeのヘルプドキュメント を参照してください: キー - MoEngageはキー ペア認証方式を使用してあなたのSnowflakeインスタンスに接続できます。この方法を使用するには:
     
   • データベースユーザーにこのキーを追加したら、「接続テスト」をクリックしてください。MoEngageが資格情報を確認しようとします。
8. MoEngageは、キーの回転もサポートしています。ITポリシーでキーの回転が必要な場合は、以下の手順に従って行うことができます：
   • アプリマーケットプレイス > Snowflake > 接続を統合して編集します。
   • 新しいキーを生成するアイコンをクリックします：
   • 確認のためのレビューを求められます。指示をよく読んでください。新しく生成されたキーで接続を保存すると、MoEngageは以前のキーを使用しなくなります。新しいキーがデータベースユーザーに第二のRSAキーとして添付されていることを確認する必要があります（回転が正しく機能するために、 Snowflake のヘルプドキュメントを参照）。接続を保存した後に新しいキーが添付されていない場合、インポートとエクスポートが破損する可能性があります：
   • 新しいキーが生成され、あなたに表示されます。この時点で、この新しいキーをコピーし、 Snowflakeヘルプドキュメント に記載されている手順に従って、Snowflakeデータベースユーザーに追加のキーとして添付することを強くお勧めします。 新しいキーを添付した後、回転を完了するために接続を正常にテストする必要があります。
   • 編集フォームを閉じることに決めるか、新しいキーを生成した後に 接続 をクリックしなかった場合、古い（既存の）キーは以前のように使用され続け、新しく生成されたキーはシステムから削除されます。
9. 役割: この役割は、MoEngageからのクエリを実行するために使用されます。

Snowflake接続を設定すると、それを使用してMoEngageでウェアハウスセグメント、インポート、エクスポートを設定できます。あなたのSnowflakeインスタンスが公開されておらず、AWS上にある場合は、 AWS Private Link をMoEngageのAWSアカウントと設定することをお勧めします。この件についての詳細は、アカウントマネージャーにお問い合わせください。

Databricksのデータに対してクエリを実行するには、MoEngageをDatabricksのデータウェアハウスに接続する必要があります。Databricksプラットフォームで管理者権限を持っていることを確認してください。

MoEngageへの読み取りアクセスを付与する手順

1. Databricksにサービスプリンシパルを追加する
2. Databricks ワークスペースにサービス プリンシパルを割り当てる
3. サービス プリンシパルにデータ リーダー アクセスを提供する
4. サービスプリンシパルにSQLウェアハウスの計算権限を付与する
5. 個人アクセストークン (PAT) を作成する
6. HTTPパスとホスト名を取得する
7. アプリマーケットプレイスでDatabricksを接続する

Databricksにサービスプリンシパルを追加する

アカウント管理者は、アカウントコンソールを使用してDatabricksアカウントにサービスプリンシパルを追加できます。詳細については、 こちら を参照してください。

サービス プリンシパルを追加するには、次の手順を実行します:

1. Databricksの管理者として アカウントコンソール にログインします。
2. サイドバーで ユーザー管理 をクリックします。
3. 「 サービス プリンシパル 」タブで、 サービス プリンシパルの追加 をクリックします。
4. サービスプリンシパルの名前を入力してください。
5. クリックして 追加 します。

Databricks ワークスペースにサービス プリンシパルを割り当てる

管理者として、 アカウントコンソール を使用してワークスペースにサービスプリンシパルを割り当てます。詳細については、 こちら を参照してください。

次の手順に従って権限を割り当てます：

1. Databricksで管理者としてアカウントコンソールにログインします。
2. サイドバーで 作業スペース をクリックします。
3. ワークスペース名をクリックしてください。
4. 「 権限 」タブで、 権限を追加 をクリックします。
5. サービス プリンシパルを検索して選択し、権限レベル (ワークスペース ユーザー ) を割り当てます。ワークスペース管理者設定ページで ワークスペース管理者ロール を割り当てることができます。
6. クリックして 保存 します。

サービス プリンシパルにデータ リーダー アクセスを提供します

サービスプリンシパルに対して、以下のようにワークスペース全体または個々のスキーマへのデータリーダーアクセスを提供し、MoEngageでクエリを実行したいテーブルがスキーマ内で利用可能であることを確認してください。

SQL ウェアハウスでのサービス プリンシパルの権限を提供します

コンピュート権限を付与するには、以下の手順を実行してください：

1. Databricks ダッシュボードで、 設定 > コンピュート > SQL ウェアハウス をクリックします。

2. サービス プリンシパルによってアクセスされる必要がある倉庫を選択してください。

3. クリックして 権限 を選択します。リストから、サービスプリンシパルに対して 使用可能 を選択します。

Personal Access Token (PAT)を作成する

Databricks CLIを使用してサービスプリンシパルのPATを作成できます。詳細については、 こちら を参照してください。

HTTPパスとホスト名を取得する

MoEngageがあなたのDatabricksワークスペースにアクセスするために必要なHTTPパスとサーバーホスト名を取得するには、以下の手順を実行してください。

1. あなたのDatabricksワークスペースで、 SQLワarehouse を選択します。
2. 倉庫を選択してください。
3. クリックして 接続の詳細 タブを開き、MoEngageに必要なホスト名とHTTPパスをコピーしてください。

アプリマーケットプレイスでDatabricksを接続する

AppマーケットプレイスでDatabricksに接続するには、次の手順を実行してください：

1. MoEngageダッシュボードの左側のナビゲーションメニューで、 アプリマーケットプレイス をクリックします。
2. アプリマーケットプレイスページで Databricks を検索します。
3. クリックして Databricks タイルを選択します。
4. Databricks ページで、 統合 タブに移動し、+ 接続を追加 をクリックします。
5. 以下の詳細を入力してください：
   

   フィールド	必須	説明
   接続名	はい	Databricks接続の名前を入力してください。
   ホスト名	はい	これは特定のクラスターに割り当てられた一意の識別子を指します。接続したいホスト名を入力してください。サーバーホスト名を見つけるには、Databricksウェブコンソールにアクセスし、クラスターを見つけてください。次に、詳細オプションを表示するためにクリックし、JDBC/ODBCタブに移動します。
   ポート	オプション	Databricksサーバーに接続するポートを入力してください。デフォルトは443です。
   HTTPパス	はい	Databricksの計算リソースのHTTPパスを入力してください。HTTPパスを見つけるには、Databricksワークスペースに移動し、ウェアハウスを見つけて、接続の詳細タブからHTTPパスを取得します。
   アクセストークン	はい	これはDatabricks APIに安全にアクセスするために使用される認証トークンです。アクセストークンを入力してください。これにより、必要な権限を持ってDatabricksサーバーに対して認可されたリクエストを行うことができます。 Databricksワークスペースで、 設定 > 開発者 > アクセストークン > トークンを管理 に移動します。
   カタログ	はい	MoEngageがアクセスするDatabricksカタログ名を入力してください。

   
   
6. クリックして 接続 します。あなたのDatabricks接続は現在統合されています。

Databricks 接続を設定した後、MoEngage でさまざまなインポートおよびエクスポートを設定するために使用できます。

Redshiftのデータに対してクエリを実行するには、MoEngageをRedshiftウェアハウスに接続し、Redshiftプラットフォームで管理者権限を持っていることを確認する必要があります。

MoEngageへのアクセスを提供するためのIAMロールの作成手順

ステップ 1: アカウントにアイデンティティとアクセス管理 (IAM) ロールを作成します

1. あなたのAWSアカウントに AWS Management Console でサインインしてください。
2. In the Find Services search box, search for IAM. You will be directed to the IAM dashboard.
   
3. IAM ダッシュボードで、 ロール タブを選択します。
4. クリックして 役割を作成 します。
5. 選択してください AWSアカウント .
   
6. 信頼できるエンティティを 選択 セクションで、 カスタム信頼ポリシーを選択します。
7. Paste the Trust Policy JSON obtained from MoEngage, as shown below. MoEngage's AWS Account ID is 612427630422. Ensure this ID is present in the trusted relationship JSON.
   

   {
   "Version": "2012-10-17",
   "Statement": [
   {
   "Effect": "Allow",
   "Principal": {
   "Service": [
   "redshift.amazonaws.com",
   "ec2.amazonaws.com"
   ]
   },
   "Action": "sts:AssumeRole"
   },
   {
   "Effect": "Allow",
   "Principal": {
   "AWS": "arn:aws:iam::612427630422:root"
   },
   "Action": "sts:AssumeRole"
   }
   ]
   }

8. このアカウントのオプションから 役割の引き受けを許可 を選択します。
9. 次へ Next > 権限。
10. ctvtvgd4t 以下の権限を追加してください:

    redshift_finegrained (カスタマー管理ポリシー)

    
    {
    "Version": "2012-10-17",
    "Statement": [
    {
    "Sid": "DataAPIPermissions",
    "Action": [
    "redshift-data:ExecuteStatement",
    "redshift-data:CancelStatement",
    "redshift-data:ListStatements",
    "redshift-data:GetStatementResult",
    "redshift-data:DescribeStatement",
    "redshift-data:ListDatabases",
    "redshift-data:ListSchemas",
    "redshift-data:ListTables",
    "redshift-data:DescribeTable"
    ],
    "Effect": "Allow",
    "Resource": "*"
    },
    {
    "Sid": "Redshiftminimal",
    "Action": [
    "redshift:Get*",
    "redshift:Describe*"
    ],
    "Effect": "Allow",
    "Resource": "*"
    },
    {
    "Effect": "Allow",
    "Action": "iam:CreateServiceLinkedRole",
    "Resource": "arn:aws:iam::*:role/aws-service-role/redshift.amazonaws.com/AWSServiceRoleForRedshift",
    "Condition": {
    "StringLike": {
    "iam:AWSServiceName": "redshift.amazonaws.com"
    }
    }
    }
    ]
    }

    stsAssumerRole (カスタマーマネージドポリシー)

    {
    "Version": "2012-10-17",
    "Statement": [
    {
    "Sid": "123",
    "Effect": "Allow",
    "Action": [
    "sts:AssumeRole"
    ],
    "Resource": [
    "*"
    ]
    }
    ]
    }

11. ポリシーエディターでオプションを選択することにより、特定のdbグループやユーザーへのアクセスを任意で制限できます。
    
12. 次に 進む をクリックしてください。
13. In the タグを追加 セクションで、Add new tagボタンをクリックして、このIAMロールに必要なタグを追加します。
14. 次に 進む をクリックしてください。 レビュー。
15. In 役割名 ボックスに、あなたの役割の名前を入力してください（例えば、moengage-redshift-data-access-role）。
    
16. 「 Create IAM role 」をクリックします。
    

ステップ2：MoEngageに詳細を共有する

以下の詳細を warehousesegments@moengage.com に送信して、ワークスペースでRedshiftの倉庫セグメントを有効にしてください：

• ARN (Amazon Resource Name):
  • あなたのAWSマネジメントコンソールで、IAMダッシュボードに移動し、ステップ1で作成したIAMロールを選択します。
  • IAMロールのARNをコピーします。

    MoEngageは、このARNを使用して、あなたのアカウント内のIAMロールを引き受け、Redshiftクラスタにアクセスします。

    

• データベース名: デフォルトのRedshiftデータベース名は、実行されるクエリに使用されます。各データベースに対して別々の接続を作成することをお勧めします。
• Redshift クラスター識別子名: 各プロビジョニングされた Redshift クラスターに対して別々の接続を作成することをお勧めします。

  #{
  "role_arn" : "arn:aws:iam::5822XXXX730:role/Segmentation_Redshift",
  "aws_regions" : "ap-south-1",
  "cluster_identifier" : "redshift-segmentation-cluster",
  "default_db" : "dev",
  }