はじめに
Amazon S3は、オンラインファイルストレージのWebサービスです。Webを使っていつでも、どこからでも、どんな量のデータも保存、取得することができます。Amazon S3 APIについて詳しくは、製品ページ(http://docs.aws.amazon.com/AmazonS3/...I/Welcome.html)を参照してください。
Amazon S3接続はData Centerで設定します。このトピックでは、ユーザー固有の許可を持つAmazon S3コネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報については、「データコネクターを使用してDataSetを追加する」を参照してください。
必要条件
Amazon S3アカウントに接続してDataSetを作成するには、以下が必要です。
-
AWSアクセスキー。これは、AWS Consoleの[Security Credentials]セクションで確認できます。または、IAMを使用している場合は、[Users]から確認できます。
-
AWSシークレットキー。これはアクセスキーを作成したときに提供されたものです。新しいシークレットキーは、AWS Consoleで生成することができます。
-
ファイルを取得したいAWS S3バケットの名前。
-
データを取得するファイルのプレフィックスパス。Domoは最初に([認証]セクションの中の)プレフィックスパスから存在するすべてのS3オブジェクトを事前設定し、入力フォーマット、部分ファイル名、([詳細]セクションとの)ファイル名一致に基づいてこれらの結果をフィルターします。プレフィックスは次のような形式になります:/path/directory/subdir/subdir/subdir/。
Amazon S3アカウントに接続する
このセクションでは、Amazon S3 Connectorページの[認証情報]および[詳細]ペインのオプションについて説明します。このページのほかのペインの項目にある[スケジュール設定]や[DataSetの名前と説明]に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「データコネクターを使用してDataSetを追加する」を参照してください。
[認証情報]ペイン
このペインには、Amazon S3アカウントにアクセスするための認証情報を入力するフィールドがあります。下表では、各フィールドに必要な内容を説明しています。
フィールド |
説明 |
---|---|
アクセスキー |
AWSアクセスキーを入力します。アクセスキーを検索する方法については、上述の「必要条件」を参照してください。 |
シークレットキー |
AWSシークレットキーを入力します。シークレットキーを検索する方法については、上述の「必要条件」を参照してください。 |
バケット |
ファイルを取得するAmazon S3バケットを入力します。 |
プレフィックス |
取得するファイルのプレフィックスパスを入力します。プレフィックスパスの詳細については、上記の「必要条件」を参照してください。 |
有効なAmazon S3認証情報を一度入力しておくと、いつでも同じアカウントを使用してユーザー固有の許可を持つ新しいAmazon S3 DataSetを作成することができます。コネクターアカウントは、Data Centerの[アカウント]タブで管理できます。このタブについて詳しくは、「コネクターのユーザーアカウントを管理する」を参照してください。
[詳細]ペイン
このペインには、メインとなる[レポート]メニューのほか、選択したレポートタイプに応じて表示/非表示になる様々なメニューが含まれています。
メニュー |
説明 |
||||||
---|---|---|---|---|---|---|---|
インポートするファイルタイプ |
Domoにインポートするファイルのタイプを選択します。利用可能なファイルタイプは、CSV、JSON、XML、XLS、TSV、TXTです。 |
||||||
ファイル名の選択方法 |
Domoがファイルを識別する方法を選択します。オプションは以下のとおりです。
|
||||||
部分的ファイル名 |
インポートするAmazon S3ファイルの名前を入力します。 |
||||||
ファイル名のマッチタイプ |
取得するファイル名が、部分ファイル名フィールドに入力したテキストで始まるか、またはそのテキストを含んでいるかどうかを指定します。 |
||||||
ファイル圧縮タイプ |
取得するファイルの圧縮タイプを選択します。ファイルが圧縮されていない場合は、[なし]を選択します。 |
||||||
ZIPファイルのエンコーディング |
ZIPファイルのエンコーディングタイプを選択します。 |
||||||
ZIP内のファイルの選択方法 |
ZIPファイルの名前を入力するか、またはファイルを発見させるかを選択します。 |
||||||
ZIP内にファイル名を入力 |
取得するZIPファイル内のファイル名を入力します。 |
||||||
CSVファイルのヘッダーの有無 |
インポートするCSV/TSVファイルがヘッダーを含んでいる場合は[はい]を、それ以外の場合は[いいえ]を選択します。 |
||||||
区切り文字を選択 |
取得するCSV/TSVファイルで使用する区切り文字を選択します。区切り文字がリストにない場合は、[その他]を選択します。 |
||||||
区切り文字を指定 |
取得するCSV/TSVファイルで使用するカスタム区切り文字を入力します。 |
||||||
引用文字 |
取得するCSV/TSVファイルを解析する引用文字を選択します。CSVの標準は二重引用符(")です。 |
||||||
エスケープ文字 |
取得するCSV/TSVファイルを解析するエスケープ文字を選択します。CSVの標準はバックスラッシュ(\)です。 |
||||||
カスタムエスケープ文字 |
取得するCSV/TSVファイルで使用するカスタムエスケープ文字を入力します。 |
||||||
ファイル名列を追加 |
[はい]を選択すると、インポートされたファイル名を指定する列がデータに追加されます。この列は「BATCH_FILE_NAME_」という名前です。 |
||||||
ファイルのエンコーディング |
ファイルのエンコーディングを選択します。デフォルトはUTF-8です。 |
||||||
大きなJSONファイルの解析を有効にしますか? |
大きなJSONファイルの解析を有効にするかどうかを指定します。 |
||||||
平面化するサブリストを入力(オプション) |
データで平面化するカンマ区切りのリストを入力します。 |
||||||
JSONテキストは、行のリーダーを必要としますか? |
JSONファイルのテキストで、複数の行を読み込む必要があるかを指定します。 |
||||||
バックスラッシュは、エスケープする必要がありますか? |
JSONファイルのテキストに、エスケープする必要のあるバックスラッシュが含まれているかを指定します。 |
||||||
データに属性を必要としますか? |
データの一部として属性値を必要としている場合は、[はい]を選択します。 |
||||||
データタグを入力(オプション) |
JSONまたはXMLファイルのデータのタグを入力します。 |
||||||
除外するフィールドを入力(オプション) |
JSON/XMLのインポートで除外したいフィールドを、カンマで区切ったリストとして指定します。 |
||||||
ヘッダータグを入力(オプション) |
JSONまたはXMLファイルのヘッダーのタグを入力します。 |
||||||
パスワード保護されていますか? |
取得するファイルがパスワードで保護されている場合は、[はい]を選択します。保護されていない場合は、[いいえ]を選択します。 |
||||||
ヘッダー開始行 |
取得するExcelファイルのヘッダー行の番号を入力します。 |
||||||
データ開始行 |
取得するExcelファイルの最初のデータ行の番号を入力します。 |
||||||
フッター |
取得するExcelファイルのフッター行の番号を入力します。 |
||||||
空白行 |
空白行が見つかった場合に取るべきアクションを選択します。[空白行をスキップ]を選択すると、空白行がスキップされます。[最初の空白列で停止]を選択すると、空白行が見つかった列でインポートが停止します。 |
||||||
空白の列ヘッダー |
空白の列ヘッダーにが見つかった場合にどうするかを指定します。[空白列を追加]を選択した場合、新規の列には列名が自動的に生成されます。[最初の空白列で停止]を選択した場合、空白のヘッダーが見つかると、データのインポートが停止します。 |
その他のペイン
スケジュール設定、再試行、オプションの更新など、コネクターインターフェースのその他のペインに表示されるオプションについては、「データコネクターを使用してDataSetを追加する」を参照してください。
よくある質問
コネクターがデータを取得していないのはなぜですか?
ファイルがS3バケットに存在することを確認し、コネクター設定で正しいファイルタイプを指定します。また、NULL値列を削除してコネクターがデータを取得できるようにします。
サブディレクトリーからファイルをインポートするにはどうすればよいですか?
Domoは最初に(認証セクションの中の)プレフィックスパスから存在するすべてのS3オブジェクトを事前設定し、入力フォーマット、部分ファイル 名、(詳細セクションとの)ファイル名一致に基づいてこれらの結果をフィルターします。プレフィックスは次のような形式になります:/path/directory/subdir/subdir/subdir/。
データ更新の頻度はどのくらいですか?
必要に応じて何回でも更新できます。
同一のAmazon S3アカウントを複数のDataSetに使えますか?
使えます。
DataSetの中に予定したファイルが見つかりません。一体何が起こっているのでしょう?
このコネクターは1つのファイルのみを取得します。部分ファイル名を選択し、プレフィックスパスの中に一致する複数のファイルがある場合、コネクターは一番最近変更されたファイルのみをインポートします。
Amazon S3バケットから複数のファイルを1つのDataSetにインポートしたいと思います。どのようにすればよいですか?
このコネクターは1つのファイルのみを取得します。1つのDomo DataSet内に複数のAmazon S3ファイルを必要とする場合は、Amazon S3 Advancedコネクターを使用してください(ドキュメント作成中)。
コメント
0件のコメント
サインインしてコメントを残してください。