URLからのデータのインポート
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
CSV、TSV、JSON、HTML、XLS、XLSX、XMLファイルのURLを入力できます。DataPrepでは、認証が必要なURLからのインポートにも対応しています。
URLからファイルをインポートするには
1. ワークスペースを作成するか、既存のワークスペースを開きます。こちらをクリックして、ワークスペースの作成方法を確認してください。
2. ［URL］を、［データソースを選択してください］セクションでクリックします。
2. データを取得するためのデータセット名とリクエストURLを入力します。
［サンプルを試す］リンクをクリックしてデータセットのサンプルをインポートし、動作を確認することもできます。
3. 必要なパラメーターとヘッダーを入力します。
たとえば、データ型、コンテンツ形式、使用する言語を指定して、パラメーターとヘッダーを定義できます。
4. データをページ単位でインポートする場合は、いずれかのページネーション設定を選択します。
メモ：標準では、［なし］が選択されています。
ページネーション
i）［ページ番号］-データが複数のページに保存されており、同じ順序でインポートする場合は、この設定を選択します。この設定を使用する場合は、次の詳細を指定する必要があります。
- ［ページ番号のパラメーター］：API/URLプロバイダーから提供されたページパラメーターの名前です。
- ［初期値］：インポートを開始する最初のページ番号です。
- ［リクエスト数］：順番に実行するリクエストの数です。
上の画像では、10ページを取得しています。URLは次のように10回実行されます。
ここでは、パラメーター名はPage、リクエスト数は10です。
ii）［オフセットと上限］-大規模なデータセットがあり、各バッチの開始位置とバッチサイズを指定してデータをバッチ単位でインポートする場合は、この設定を選択します。この設定を使用する場合は、次の詳細を指定する必要があります。
- ［オフセットパラメーター］：APIプロバイダーから提供されたオフセットパラメーター名です。
- ［初期値］：オフセットの初期値を指定します。
- ［リクエスト数］：順番に実行するリクエストの数です。
- ［上限パラメーター］：APIプロバイダーから提供された上限パラメーターの名前です。
- ［上限値］：オフセットから取得するデータ件数です。
オフセットと上限のパラメーターに対応するURL http://dataprepubuntu2.csez.zylker.com/Pagination_Data/JSONData から1,000件のデータを取得するには、API呼び出し1回につき100件として、次のように10回呼び出す必要があります。
2回目以降のリクエストでは、オフセットパラメーター値は、前回のオフセット値に上限を加えた値になります。
ここでは、［オフセットパラメーター］名はOffset、［上限パラメーター］名はLimitです。［上限値］は100、［リクエスト数］は10です。
iii）［次のページのURL］-データが複数のページに分かれており、各ページに次のページのURLが含まれている場合は、この設定を選択します。この設定を使用する場合は、次の詳細を指定する必要があります。
［URLのプロパティパス］：次のページのURLを取得できるプロパティ名です。
上の画像では、次のページのURLプロパティは/next_page_URL.です。次のページはJSONプロパティ/next_page_URL.から取得されます。この処理は、/next_page_URLプロパティが空になるか、null値になるまで続きます。
メモ：
1. 次のページのURLによるページネーションは、JSONファイルとXMLファイルにのみ適用できます。
2. これらのページネーション設定は、APIプロバイダーによって許可されている場合にのみZoho DataPrepで使用できます。
5. いずれかの認証方式を選択し、このデータ連携の名前を入力します。
- ［認証なし］-指定するURLでは認証が不要です。
- ［Basic認証］-URLを認証してデータをインポートするには、［ユーザー名］と［パスワード］が必要です。
- ［OAuth2.0］-URLはOAuth2.0認証方式で保護されています。URLを認証してインポートを許可するには、［クライアントID］、［クライアントシークレット］、［アクセストークン］、［更新トークン］が必要です。
メモ：今後URLからインポートする際に使用できるよう、認証設定が保存されます。認証情報は安全に暗号化して保存されます。
6. ［データ連携名］のテキストボックスに、データ連携の名前を入力します。
7. URLからデータを取得するには、［認証する］をクリックします。
8. データのインポートが完了するとデータセットが開き、すぐにデータの準備を開始できます。
メモ：インポートを予約するには、ワークスペース内のデータセットで利用できる［インポートを予約する］設定、またはDataPrepのStudioページ上部のバーにある［インポート］メニューを使用できます。詳細については、こちらをクリックしてください。
URLのデータ連携を編集するには
DataPrepでは、データソースやエクスポート先に連携するたびに認証情報を入力する手間を省くため、データ連携が保存されます。保存済みのデータ連携は、［データ連携を編集する］設定を使用して、いつでも新しいパラメーターや認証情報に更新できます。
1. 新しいデータセットの作成時に、［保存済みのデータ連携］を［データソースを選択］ボックスから選択します。
2. データのインポート画面から、保存済みのデータ連携を直接管理できます。三点リーダー（3点）アイコンをクリックすると、データ連携の［共有］、［編集］、［概要の表示］、［削除］を行えます。
3. ［データ連携を編集する］オプションをクリックして、新しいパラメーターや認証情報で保存済みのデータ連携を更新します。
4. データをページ単位でインポートする場合は、［ページ分割］タブで次の設定を編集することもできます。
- ［ページ番号］
- ［位置の指定値（オフセット）と上限］
- ［次のページのURL］
こちらをクリックしてページ分割の詳細をご確認ください。
5. データ連携を更新するには、［更新］ボタンをクリックします。
よくある質問
1. ODataフィードURLを使用してMicrosoft Dynamics 365に接続すると、「AADSTS54005: OAuth2 Authorization code was already redeemed」というエラーが表示されるのはなぜですか？
このエラーは、Microsoft Dynamics 365への接続時にoffline_accessスコープが含まれていない場合に発生します。
このスコープがない場合、Microsoftからの応答にはaccess_tokenのみが含まれ、refresh_tokenは生成されません。Zoho DataPrepでは、現在のアクセストークンの有効期限が切れた後に新しいアクセストークンを生成するためにrefresh_tokenが必要なため、データ連携に失敗して前述のエラーが発生します。そのため、Zoho DataPrepのようなサービスで認証とトークンの更新をシームレスに行うには、「offline_access」スコープを含める必要があります。
この問題を回避するには、認証時に使用するスコープと併せてoffline_accessスコープを追加してください。このスコープを追加すると、Zoho DataPrepでリフレッシュトークンが自動的に使用され、毎回新しい認証コードを取得しなくてもデータ連携を維持できます。offline_accessスコープの詳細はこちら。
関連情報