はじめに
文字区切り値(CSV)ファイルは、表形式データをプレーンテキスト形式で保存します。Domo CSV Advancedコネクターを使うと、SFTPサーバーにアップロードしたCSVファイルにアクセスすることができます。HTTPSコールでファイルをインポートすることもできます。主な使用事例 | このコネクターを使ってSFTPサーバーからCSVファイルにアクセスする。 |
主なメトリクス | 該当なし |
社内における主な権限 | アナリスト |
平均導入時間 | 1時間 |
使いやすさ(1から10までのスケールで、1が「最も使いやすい」) | 4 |
ベストプラクティス
SFTPを使っている場合、認証情報の準備ができており、認証情報がSSHキーで証明されていることを確認してください。キーに使用できるフォーマットは、DESまたはRSAです。HTTPSを使っている場合は、使うリソースが保護されていることを確認するだけで十分です。必要条件
SFTPサーバーに接続してCSVファイルにアクセスする場合は、そのサーバーに認証するためのユーザー名とパスワードが必要です。HTTPS経由でCSVファイルにアクセスする場合は、ソースが保護されている場合にのみ認証情報が必要となります。 CSVファイルに関連付けられているユーザ名とパスワードが必要です。また、SSHキーとSSHキーのパスフレーズも必要です。CSVファイルにアクセスする
このセクションではCSV Advancedコネクターページの [認証情報] 、 [詳細] 、 [高度] ペインのオプションについて説明します。このページのほかのペインの項目である [スケジュール設定] や [DataSetに名前を付け、説明を入力] に関しては、ほとんどのタイプのコネクターで共通しています。詳細については「 コネクターを使ってDataSetを追加する 」を参照してください。[認証情報]ペイン
このペインでは、CSV データにアクセスするとき使うプロトコルと、データが保護されているかに応じて、ユーザー名とパスワードの入力が必要となる場合があります。SFTPサーバーに接続してCSVファイルにアクセスする場合は、そのサーバーの認証情報(ユーザー名、パスワード、ホスト名)をこちらに入力する必要があります。HTTPS経由でファイルにアクセスする場合は、リソースが保護されている場合にのみ認証情報の入力が必要になります。また、「 コネクターのIPアドレスをホワイトリストに登録する 」の記事にしたがって、サーバー上のIPアドレスをホワイトリストに登録する必要があります。 どちらの場合でも、一度 [Next] をクリックすると、このCSVアカウントが保存され、いつでも同じアカウントを使って新しいCSV Advanced DataSetを作成できます。コネクターアカウントは、Data Centerの [アカウント] タブで管理できます。このタブの詳細については「 コネクターのユーザーアカウントを管理する 」を参照してください。 URLからCSVファイルをインポートすることも可能です。その場合はURLに加え、ソースの要件によってはユーザー名とパスワードも必要になる場合があります。[詳細]ペイン
このペインではプロトコル(HTTPリクエストまたはSFTPファイル転送)を選択し、そのプロトコルの詳細情報を入力します。このペインには以下のフィールドとメニューが含まれています。メニュー | 説明 |
|---|---|
Protocol | CSVファイルへのアクセスに使うプロトコルを選択します。 SFTPサーバーにあるCSVファイルにアクセスするときは、SFTPを使います。 HTTP GETリクエストを使ってCSVファイルにアクセスするときは、HTTPリクエストを使います。このリクエストは、CSVファイルを提供するサービスで定義された固有のURLパラメータを使うとトリガーされます。 |
URL | CSVファイルのURLを入力します。 ファイル転送プロトコルを使う場合は、CSVファイルが保存されているフォルダのURLを入力します。例:s ftp://hostname/home/test また、SFTPサーバが標準のポート22で動作するように設定されていない場合は、URLにポートに含める必要があります。1234ポートを指定するURLは「s ftp://hostname:1234/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] というフォーマットを使うと最新のファイルを選択できます。 |
File Location Method | 指定したディレクトリから特定のファイルを選択するか、ファイル名で検索するかを選択します。 |
File Name | 検索するファイル名を入力します。 |
Directory File | 指定したディレクトリからファイルを選択します。解析するCSVまたはGZファイルか、解凍するZIPファイルを選択できます。 |
File Type | アクセスするファイルのファイルタイプを選択します。 |
HTTP Headers | 必要に応じてHTTP/HTTPS CSV URLの追加ヘッダーを入力します。 header Name1 = ‘headerValue1’ と headerName2 = ‘headerValue2’ というフォーマットを使います。 |
HTTP Body | 必要に応じてHTTPS CSV URLの追加リクエストボディを入力します。 |
[高度]ペイン
このペインでは CSV ファイルの区切り文字を選択します。メニュー | 説明 |
|---|---|
Delimiter Character | CSVファイルの列を区切る文字を選択します。 |
その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。トラブルシューティング
- 認証情報が正しいことを確認する。
- SFTPで接続できないときは、ファイアウォール設定を確認する。
よくある質問
# データ更新の頻度はどのくらいですか?
# データ更新の頻度はどのくらいですか?
# 注意すべきAPI制限はありますか?
# 注意すべきAPI制限はありますか?
# 同一のCSV Advancedアカウントを複数のDataSetに使えますか?
# 同一のCSV Advancedアカウントを複数のDataSetに使えますか?
# SFTPで接続できないときは、どうすればよいですか?
# SFTPで接続できないときは、どうすればよいですか?