はじめに
Amazon S3は、Amazon Web Servicesが提供するオンラインファイルストレージのウェブサービスです。ウェブを使用していつでも、どこからでも、どんな量のデータも保存および取得することができます。Amazon S3 APIについて詳しくは、製品ページ（http://docs.aws.amazon.com/AmazonS3/...I/Welcome.html）を参照してください。
Amazon S3コネクターとAmazon S3 Advancedコネクターは、ほぼ同じです。唯一の違いは、コネクターの［詳細］セクションで指定したプレフィックス文字列で始まる複数のファイルの処理方法です。標準のAmazon S3コネクターでは、変更された最新のファイルのみインポートされます。Amazon S3 Advancedコネクターでは、同じプレフィックスのファイルは同じスキーマを使用するという前提で、指定したプレフィックスを持つすべてのファイルがインポートされます。しかし、Amazon S3 Advancedコネクターは、最後の実行以降に変更されたファイルまたは最初の実行後に作成された新規ファイルのみを取得します。コネクターの標準バージョンについて詳しくは、「Amazon S3コネクター」を参照してください。
Amazon S3 Advancedコネクターは「ファイル」コネクターです。つまり、ファイルを取得してDomoに出力します。Data Centerでこれを含むほかのファイルコネクターのページにアクセスするには、ウィンドウ上部のツールバーで［ファイル］をクリックします。
Amazon S3のアカウントには、Data Centerから接続します。このトピックでは、Amazon S3 Advancedコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報については、「データコネクターを使用してDataSetを追加する」を参照してください。
|
主な使用事例 |
このコネクターは、APIが使用できない状況でフラットファイルを取得するための最善の方法です。 |
|
主なメトリクス |
該当なし |
|
社内における主な権限 |
|
|
平均導入時間 |
適切なタイプのファイルがS3にあれば、1時間以内です。 |
|
使いやすさ（1から10のスケールで、1が「最も使いやすい」） |
4 |
ベストプラクティス
S3に保存されたデータと、ほかのS3データベースとの関係を理解していると、このコネクターを使用する上で大変役立ちます。
必要条件
Amazon S3アカウントに接続してDataSetを作成するには、以下が必要です。
-
AWSアクセスキー。これは、AWS Consoleの［Security Credentials］セクションで確認できます。または、IAMを使用している場合は、［Users］の中にもあります。
-
アクセスキーの作成時に提供されたAWSシークレットキー。新しいシークレットキーは、AWS Consoleで生成することができます。
-
ファイルを取得したいAWS S3バケットの名前。
適切な権限が付与されたユーザーを作成する
DomoでS3データに接続する前に、IAM Amazon Consoleで適切な権限を有するユーザーを作成する必要があります。
IAM Amazon Consoleでユーザーを設定するには、以下の手順を実行します。
-
新規ユーザーを追加し、次のオプションを設定します。
-
［Details］ペインの［Select AWS access type］で［Programmatic Access］のボックスをチェックします。
-
［Permissions］ペインで、［Attach existing policies directly］を選択し、［Amazon S3FullAccess］または［Amazon S3ReadOnlyAccess］のボックスをチェックします。
カスタマー管理ポリシーは使用できません。
-
［Review］ペインで、［Create User］をクリックします。
-
-
ユーザーを作成したら、使用するアクセスキーとシークレットキーをコピーし、Domoの［認証情報］ペインに入力します。
Amazon S3アカウントに接続する
このセクションでは、Amazon S3 Advancedコネクターページの［認証情報］ペインおよび［詳細］ペインのオプションについて説明します。このページのほかのペインの項目にある［スケジュール設定］と［DataSetの名前と説明］に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「データコネクターを使用してDataSetを追加する」を参照してください。
［認証情報］ペイン
このペインには、Amazon S3アカウントにアクセスするための認証情報を入力するフィールドがあります。下表では、各フィールドに必要な内容を説明しています。
|
フィールド |
説明 |
|---|---|
|
アクセスキー |
AWSアクセスキーを入力します。アクセスキーを検索する方法については、上述の「必要条件」を参照してください。 |
|
シークレットキー |
AWSシークレットキーを入力します。シークレットキーを検索する方法については、上述の「必要条件」を参照してください。 |
|
バケット |
ファイルを引き込みたいAmazon S3バケットを入力します。 |
|
領域 |
使用したいAmazon S3バケット領域を選択します。 |
有効なAmazon S3認証情報を一度入力しておくと、いつでも同じアカウントを使用して新しいAmazon S3 Advanced DataSetを作成することができます。コネクターアカウントは、Data Centerの［アカウント］タブで管理できます。このタブについて詳しくは、「コネクターのユーザーアカウントを管理する」を参照してください。
詳細ペイン
このペインには、Domoに引き込みたいファイルを検索、設定するための様々なメニューがあります。
|
メニュー |
説明 |
||||||
|---|---|---|---|---|---|---|---|
|
インポートするファイルタイプ |
Domoにインポートしたいファイルのタイプを、CSV、JSON、XMLから選択します。 |
||||||
|
ファイル名はどのようにして選択しますか？ |
Domoがファイルを識別する方法を選択します。オプションは以下のとおりです。
|
||||||
|
プレフィックス（オプション） |
結果にフィルターを適用するためのプレフィックスを入力します。プレフィックスにより、指定したプレフィックスで始まるキーのみに結果が絞り込まれます。S3コネクターの高度なバージョンでは、同じプレフィックスのファイルは同じスキーマを使用するという前提で、指定したプレフィックスを持つすべてのファイルがインポートされます。 |
||||||
|
完全ファイルパスを入力 |
使用するファイルの完全パスを入力します。 |
||||||
|
ファイル名 |
インポートしたいファイル名を入力します。ファイルパスはあってもなくても構いません。例：folder_name/file_name |
||||||
|
ファイル名のマッチタイプ |
取得したいファイルの名前が、［ファイル名］で入力したテキストから始まるのか、またはそれを含んでいるのかを指定します。 |
||||||
|
ファイル圧縮タイプ |
取得するファイルの圧縮タイプを選択します。ファイルが圧縮されていない場合は、［なし］を選択します。 |
||||||
|
CSVファイルにヘッダーはありますか？ |
CSVファイルのヘッダーがある場合は［はい］を、それ以外の場合は［いいえ］を選択します。 |
||||||
|
ファイルのリスト |
取得したいファイルを選択します。 |
||||||
|
区切り文字を選択 |
取得したいCSVファイルで使用されている区切り文字を選択します。区切り文字がリストにない場合は、［その他］を選択します。 |
||||||
|
引用文字 |
取得したいCSVファイルを解析する引用符を選択します。CSVの標準は二重引用符（"）です。 |
||||||
|
エスケープ文字 |
取得したいCSVファイルを解析するエスケープ文字を選択します。CSVの標準はバックスラッシュ（\）です。 |
||||||
|
大きなJSONファイルの解析を有効にしますか？ |
大きなJSONファイルの解析を有効にするかを指定します。 |
||||||
|
JSONテキストは、行のリーダーを必要としますか？ |
JSONファイルのテキストで、複数の行を読み込む必要があるかを指定します。 |
||||||
|
バックスラッシュは、エスケープする必要がありますか？ |
JSONファイルのテキストに、エスケープする必要のあるバックスラッシュが含まれているかを指定します。 |
||||||
|
データタグを入力 |
JSONまたはXMLファイルのデータのタグを入力します。 |
||||||
|
除外するフィールドを入力 |
JSON/XMLのインポートで除外したいフィールドを、カンマで区切ったリストとして指定します。 |
||||||
|
ヘッダータグを入力 |
JSONまたはXMLファイルのヘッダーのタグを入力します。 |
||||||
|
データに属性を必要としますか？ |
XMLデータの一部として属性値を必要とするかを指定します。 |
||||||
|
XPath式を入力 |
XPath式を入力します。 |
||||||
|
パスワード保護されていますか？ |
取得するファイルがパスワードで保護されている場合は、［はい］を選択します。保護されていない場合は、［いいえ］を選択します。 |
||||||
|
ヘッダー開始行 |
取得するExcelファイルのヘッダー行の番号を入力します。 |
||||||
|
データ開始行 |
取得するExcelファイルの最初のデータ行の番号を入力します。 |
||||||
|
フッター |
取得するExcelファイルのフッター行の番号を入力します。 |
||||||
|
空白行 |
空白行が見つかった場合に取るべきアクションを選択します。［空白行をスキップ］を選択すると、空白行がスキップされます。［最初の空白列で停止］を選択すると、空白行が見つかった列でインポートが停止します。 |
||||||
|
空白の列ヘッダー |
空白の列ヘッダーにが見つかった場合にどうするかを指定します。［空白列を追加］を選択した場合、新規の列には列名が自動的に生成されます。［最初の空白列で停止］を選択した場合、空白のヘッダーが見つかったときに、データのインポートが停止します。 |
その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのそのほかのペインに表示されるオプションについては、「データコネクターを使用してDataSetを追加する」を参照してください。
トラブルシューティング
-
S3バケットにファイルが存在しており、そしてコネクターの設定で正しいファイルタイプが指定されていることを確認します。
-
コネクターがデータを取得するには、NULL列を削除する必要があります。
-
CSVファイルをインポートしようとしたときに「インポートに失敗しました」エラーが発生した場合は、［引用文字］メニューのオプションを［引用文字なし］に変更することによって回避できることがあります。
よくある質問
Domoにインポートしたいファイルのタイプを、CSV、JSON、XMLから選択します。
必要に応じて何回でも更新できます。
同じアカウントを使用して複数のDataSetを作成することはできますか？
はい。
注意すべきAPI制限はありますか？
アカウントあたりのAmazon S3バケットが100個に制限される場合があります。
コネクターがデータを引き込めないのはなぜですか？
S3バケットにファイルが存在しており、コネクターの設定で正しいファイルタイプが指定されていることを確認します。また、コネクターがデータを引き込めるように、NULL列を削除します。
標準のAmazon S3コネクターと高度なバージョンとの違いは何ですか？
Amazon S3コネクターとAmazon S3 Advancedコネクターは、どちらも同じSDKを使用しています。2つのコネクターの違いは、複数のファイルを処理する方法にあります。
Amazon S3コネクターでは、Amazon S3バケットにコネクターの［詳細］セクションで指定したプレフィックスで始まる複数のファイルがある場合、最後に変更されたファイルのみがインポートされます。Amazon S3 Advancedコネクターでは、同じプレフィックスのファイルは同じスキーマを使用するという前提で、指定したプレフィックスを持つすべてのファイルがインポートされます。
コメント
0件のコメント
サインインしてコメントを残してください。