はじめに
Amazon S3は、Amazon Web Servicesが提供するオンラインファイルストレージのWebサービスです。Webを使っていつでも、どこからでも、どんな量のデータも保存、取得することができます。セッションに想定される権限を使用して、Domo DataSetからAmazon S3バケットにデータをエクスポートするには、DomoのAmazon S3 AssumeRole Writebackコネクターを使用します。Amazon S3 APIについて詳しくは、製品ドキュメント（ http://docs.aws.amazon.com/AmazonS3/…I/Welcome.html ）を参照してください。 データはData CenterのS3バケットにエクスポートします。このトピックでは、DomoからS3 AssumeRole Writebackコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「 コネクターを使用してDataSetを追加する 」を参照してください。注記： Writeback DataSetの所有者は、入力DataSetの所有者または共同所有者である必要があります。
必要条件
Amazon S3アカウントに接続してDataSetを作成するには、以下が必要です。- DomoクライアントIDとクライアントシークレット。
- 引き受ける権限のAmazonリソースネーム（ARN）。
- 引き受けた権限のセッションの識別子。信頼ポリシーの設定が必要です。このことについては、以下で説明します。
- サードパーティが顧客のアカウントで権限を引き受ける時に使う一意の識別子。
- データの引き込み元となるAmazon S3バケットの名前。
信頼ポリシーの設定
権限のセッション識別子に対する信頼ポリシーは、以下の通りです。{"Effect": "Allow","Principal": {"AWS": "arn:aws:iam::*accountId*:root"},"Action": "sts:AssumeRole","Condition": {\
"StringEquals": {\
"sts:ExternalId": "*customer externalID*"}}}
Domo環境のアカウントIDは、以下の通りです。
- 米国：339405024189
- オーストラリア：010251424122
- ヨーロッパ、中東、アフリカ（IE）：687132894031
- 日本：622384692065
- カナダ：710710207408
{"Effect": "Allow","Principal": {"AWS": "arn:aws:iam::46822464880681:user/myIAMuser123 "},"Action": "sts:AssumeRole","Condition": {\
"StringEquals": {\
"sts:ExternalId": "010251424122"}}}
DomoクライアントIDとクライアントシークレットを取得するには：
- Domoデベロッパーアカウント にログインします。
- 右上の ［My Accounts］ > ［New Client］ をクリックします。
- アプリケーション名と説明を入力します。
- ［Data］ と ［User］ のチェックボックスを選択して、アプリケーションのスコープを提供します。
- ［Create］ をクリックします。
接続を設定する
このセクションでは、 Amazon S3 AssumedRole Writeback コネクターページの ［認証情報］ および ［詳細］ ペインのオプションについて説明します。このページのほかのペインの項目である ［スケジュール設定］ や ［DataSetに名前を付け、説明を入力］ に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「 コネクターを使用してDataSetを追加する 」を参照してください。［認証情報］ペイン
このペインには、Domo開発者アカウントとS3バケットに接続するための認証情報の入力フィールドがあります。下表は、各フィールドに必要な内容を説明しています。フィールド | 説明 |
|---|---|
| Domo Client ID | DomoクライアントIDを入力します。詳細は 必要条件 を参照してください。 |
| Domo Client Secret | Domoクライアントシークレットを入力します。詳細は 必要条件 を参照してください。 |
| Role Session Name | 引き受けた権限セッションに対する識別子を入力します。 |
| Role ARN | 引き受ける権限のAmazonリソースネーム（ARN）を入力します。 |
| External ID | サードパーティが顧客のアカウントで権限を引き受けるときに使う一意の識別子を入力します。 |
| Bucket | ファイルを取得したいAmazon S3バケットを入力します。 |
| Region | ファイルがあるS3バケット地域を選択します。 |
［詳細］ペイン
このペインには、データを指定してデータの送信先を示すための多数のフィールドがあります。メニュー | 説明 |
|---|---|
| How Would You Like to Select Your Folder Path? | フォルダーパスを検索するか手動で入力するかを指定します。 |
| Select Folder Path | 使用するフォルダーのパスを選択します。 |
| Path | Amazon S3バケットに保存するファイルのフォルダーパスを入力します。 |
| Overwrite | Amazon S3バケット内の既存のファイルを選択したファイル名で上書きする場合は、このチェックボックスを選択します。 |
| How Would You Like to Select Your Input DataSet? | DataSet IDを検索するか手動で入力するかを指定します。 |
| DataSet ID | 使用するDataSet IDを選択します。 |
| Input DataSet ID | S3バケットにコピーするDataSet ID（GUID）を入力します。 Data CenterでDataSetの詳細ビューを開き、URLのdatasources/に続く箇所で、DataSet IDを見つけることができます。例えば、URL https://mycompany.domo.com/datasourc…tails/overview で、DataSet IDは845305d8-da3d-4107-a9d6-13ef3f86d4a4です。 |
| Select Filename | DataSetの参照に、 ［Input DataSet ID］ 、 ［Input DataSet Name］ 、出力ファイル名のいずれを使用するかを選択します。 ［Use Input Dataset Name］ または ［Enter File Name］ を選択し、DataSet名にスペースのないマクロ<current_date>または<current_date-1>を指定すると、<current_date>は今日の日付に、<current_date-1>は昨日の日付に、-31は31日前にyyyy-MM-dd形式で置き換えられます。 |
| Filename | 出力ファイル名を入力します。 現在の日付をファイル名に追加するには、マクロ<current_date>か<current_date-1>を使ってください。例えば、ファイル名が domo_<current_date> の場合、S3バケットで生成される出力ファイルはdomo_2019-07-16のようにdomo_（yyyy-mm-dd形式の今日の日付）になります。 |
| Only Writeback New Data | 入力DataSetから最後の実行データのみを取り出し、それをS3オブジェクトにエクスポートするには、このボックスにチェックマークを入れます。 |
| File Extension | 出力ファイルの拡張子として使用する拡張子を選択します。 |
| Delimiter | 出力ファイルの区切り文字に使用する文字を選択します。 |
| Choose the Escape character | 入力データセットのエスケープ文字を選択します。 |
| Compression | 出力ファイルに使用する圧縮方式を選択します。 |
| Encryption Method | 出力ファイルに使用する暗号化方式を選択します。 |
| Encryption Key | 暗号化キーを入力します。 |