新しいRESTコネクションの作成

フォローする
BIMEでは、RESTコネクタを使用してデータをインポートすることができます。この記事では、 「コネクタデザイナー」を使用して新しいRESTコネクションを確立する方法を説明します。コネクタデザイナーは、エンドポイントからデータを取得するためのBIMEツールです。この記事では、REST APIデータソースのみを扱い、BIMEのAPIについては触れません。BIME APIの詳細については、「 BIME API reference(BIME APIリファレンス) 」を参照してください。
メモ: REST APIには、次の制限および制約事項が含まれています。
  • RAフィールドとページネーションはサポートされていません。
  • リフレッシュトークンは許可されません。
  • 直接コネクションのサイズ制限:20MB/100kライン
  • 格納されたコネクションサイズ制限:30MB

新しいRESTコネクションを作成するには

  1. 左パネルの データソースライブラリ アイコン( )をクリックします。
  2. +New 」をクリックして、新しいコネクションを追加します。
  3. RESTデータソースアイコン( )を選択します。
  4. Create a new REST configuration 」ボタンをクリックします。

  5. コネクトデザイナーで、エンドポイントのURLを貼り付けます。この例では、場所を条件にして再生可能エネルギー資源のデータセットを取得するためにオープンAPIを使用しています。以下の例のURLを使用してRESTコネクタをテストできます。
    https://developer.nrel.gov/api/solar/data_query/v1.json?api_key=DEMO_KEY&lat=40&lon=-105&radius=1000&all=1

  6. ドロップダウンリストから、 GET または POST データを選択します。
    • GETを選択すると、データはエンドポイントから取得されます。
    • POSTを選択すると、取得した結果の中に新たにデータを追加できるようになります。これらを変更しても、データベースに影響することはありませんが、BIME上には変更が反映されます。 Body パネルで、さらにJSONまたはXMLを追加できます。

  7. データセットをJSONまたはXMLのどちらでフォーマットするか選択します。
  8. データ配列が回答内にネストされている場合は、結果へのパスを入力します。上記の例では、要求の結果を見つけるために、パス$.outputs.all_stationsを使用しています。
  9. 問い合わせに認証が必要な場合は、 Basic HTTP または Digest Authentication オプションのいずれかを選択できます。認証情報の入力が求められます。

  10. また、各 パラメータ パネルで結果にオプションのパラメータを追加することができます。ヘッダーまたはクエリパラメータの追加のいずれかを選択できます。上記の例では、URLの最後に列挙したLat、IonおよびRadiusのパラメータがクエリに代入されています。
    • 権限付与のような、REST APIでのデータ交換全体に関わる情報を指定したい場合は、「 Header 」を選択します。
    • 特定の場所など、このコネクションに限定した情報を指定したい場合は、「 Query 」を選択します。

  11. 操作が完了したら、「 Test 」をクリックします。結果のサンプルが表示されます。

  12. Save 」をクリックしてコネクタを作成します。
    メモ: コネクタデザイナーで「 Save 」をクリックしても、データはインポートされません。 データソースビルダーで次の手順を完了する必要があります。
  13. Next 」をクリックして、データソースビルダーの「 Schema 」ステップへ進みます。
  14. 「Measures」および「Attributes」列の真ん中にあるオプションを使用して、要素の位置を編集します(「 Editing your data(データを編集する)」 を参照)。
  15. Next 」をクリックします。
  16. ストレージオプションを選択します(「 Selecting a storage option(ストレージオプションを選択する) 」を参照)。
  17. Advanced 」タブをクリックして、キャッシュ、タイムゾーン、クエリブレンダーまたは計算の設定を編集します。
  18. 操作を完了したら、「 Save 」をクリックします。データがインポートされ、自動的にクエリビルダーにリダイレクトされます。
他にご質問がございましたら、リクエストを送信してください

0 コメント

ログインしてコメントを残してください。
Powered by Zendesk