CSV Advancedコネクター
はじめに
文字区切り値(CSV)ファイルは、表形式データをプレーンテキスト形式で保存します。Domo CSV Advancedコネクターを使うと、SFTPサーバーにアップロードしたCSVファイルにアクセスすることができます。 HTTPSコールでファイルをインポートすることもできます。
CSVファイルには、Data Centerから接続します。このトピックでは、CSV Advancedコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は 「データコネクターを使ってDataSetを追加する」で説明しています。
主な使用事例 |
このコネクターを使ってSFTPサーバーからCSVファイルにアクセスする。 |
主なメトリクス |
該当なし |
社内における主な権限 |
アナリスト |
平均導入時間 |
1時間 |
使いやすさ(1~10の段階。1が「最も使いやすい」) |
4 |
ベストプラクティス
SFTPを使っている場合、認証情報の準備ができており、認証情報がSSHキーで証明されていることを確認してください。HTTPSを使っている場合は、使うリソースが保護されていることを 確認する だけで十分です。
必要条件
SFTPサーバーに接続してCSVファイルにアクセスする場合は、そのサーバーに認証するためのユーザー名とパスワードが必要です。HTTPS経由でCSVファイルにアクセスする場合は、ソースが保護されている場合にのみ認証情報が必要となります。
CSVファイルにアクセスする
このセクションでは [CSV Advancedコネクター] ページの[認証情報] や [詳細]、[高度] ペインのオプションについて説明します。 このページの他のペインの項目である [スケジュール設定] や [DataSetの名前と説明] に関しては、ほとんどのタイプのコネクターで共通しています。詳細については「データコネクターを使ってDataSetを追加する」を参照してください。
[認証情報] ペイン
このペインでは、 CSV データにアクセスするとき使うプロトコルと、データが保護されているかに応じて、ユーザー名とパスワードの入力が必要となる場合があります。SFTPサーバーに接続してCSVファイルにアクセスする場合は、そのサーバーの認証情報(ユーザー名、パスワード、ホスト名)をこちらに入力する必要があります。HTTPS経由でファイルにアクセスする場合は、リソースが保護されている場合にのみ認証情報の入力が必要になります。また、サーバーのホワイトリストに次のIPアドレスをホワイトリスト化する必要があります。
54.208.95.237
54.208.87.122
54.208.95.167
54.208.94.194
50.207.240.162
50.207.241.62
52.18.90.222
52.62.103.83
34.198.214.100
詳細については 「IPアドレスをホワイトリスト化する」を参照してください。
どちらの場合でも、一度 [次へ] をクリックすると、このCSVアカウントが保存され、いつでも同じアカウントを使って新しいCSV Advanced DataSetを作成できます。コネクターアカウントは、Data Centerの [アカウント] タブで管理できます。このタブの詳細については「コネクターのユーザーアカウントを管理する」を参照してください。
URLからCSVファイルをインポートできる場合もあります。その場合はURLに加え、ソースの要件によってはユーザー名とパスワードも必要になる場合があります。
[詳細] ペイン
このペインではプロトコル(HTTPリクエストまたはSFTPファイル転送)を選択し、そのプロトコルの詳細情報を入力します。このペインには以下のフィールドとメニューが含まれています。
メニュー |
説明 |
---|---|
プロトコル |
CSVファイルへのアクセスに使う プロトコルを選択します。 SFTPサーバーにある CSVファイル にアクセスするときは 、SFTPを使います。 HTTP GETリクエストを使ってCSVファイルにアクセスするときは、HTTPリクエストを使います。このリクエストは、 CSVファイルを提供するサービスで定義された固有のURLパラメータを使うとトリガーされます。 |
URL |
CSVファイルのURLを入力します。 ファイル転送プロトコルを使う場合は、CSVファイルが保存されているフォルダのURLを入力します。例:sftp://hostname/home/test 注記:セキュリティ上の懸念により、DomoではFTPでのデータアップロードが許可されなくなりました。FTPの代わりにSFTPをサポートするように、必要に応じてサーバー設定を更新してください。
HTTPリクエストプロトコルを使う場合は、CSVファイルの完全なURLを入力します。これは、URL だけでなくファイル名を含む完全修飾パスを入力する必要があります。例:http://www.ferc.gov/docs-filing/eqr/...v/contract.txt また、特定の日付のファイルをリクエストすることもできます。file_[yyyyMMdd]_suffix.csvというフォーマットでファイルの名前を付けます。 また、filenameprefix_[latest]というフォーマットを使うと最近のファイルを選択できます。 |
ファイルの場所の指定方法 |
指定したディレクトリから特定のファイルを選択するか、ファイル名で検索するかを選択します。 |
ファイル名 |
検索するファイル名を入力します。 |
ディレクトリファイル |
指定したディレクトリからファイルを選択します。解析するCSVまたはGZファイルか、解凍するZIPファイルを選択できます。 |
ファイルタイプ |
アクセスするファイルのファイルタイプを選択します。 |
HTTPヘッダー |
必要に応じてHTTP/HTTPS CSV URLの追加ヘッダーを入力します。 header Name1 = 'headerValue1' and headerName2 = 'headerValue2'というフォーマットを使います。 |
HTTボディ |
必要に応じてHTTPS CSV URLの追加リクエストボディを入力します。 |
[高度] ペイン
このペインでは CSV ファイルの区切り文字を選択します。
メニュー |
説明 |
---|---|
区切り文字 |
CSVファイルの列を区切る文字を選択します。 |
その他のペイン
スケジュール設定、再試行、オプションの更新など、コネクターのインターフェースに搭載された残りのセクションの詳細については「データコネクターを使ってDataSetを 追加する 」を参照してください。
トラブルシューティング
-
認証情報が正しいことを確認する
-
SFTPで接続できないときは、ファイアウォール設定を確認する
よくある質問
データ更新の頻度はどのくらいですか?
データ更新は1時間おきに行われます。
注意すべきAPI制限はありますか?
ありません。
同一のCSV Advancedアカウントを複数のDataSetに使えますか?
はい。
SFTPで接続できないときは、どうすればよいですか?
SFTPで接続できないときは、ファイアウォール設定を確認してください。