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. Zoho DataPrepでこれらのページ分割の設定を使用できるのは、APIの提供元が許可している場合のみです。
5. 認証の種類を選択し、このデータ連携に名前を付けます。
- ［認証なし］ - 指定したURLに認証は不要です。
- ［ベーシック認証］ - 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スコープの詳細はこちら。
関連情報