Aqua Data Studio で REST のデータに接続

Jerod Johnson
Senior Technology Evangelist

Visual Query Builder やテーブルデータエディターなど、Aqua Data Studio のツールから REST のデータにアクセスできます。

CData JDBC Driver for REST は、Aqua Data Studio などの IDE のウィザードや分析機能と REST のデータを連携できます。本記事では、接続マネージャーを使って REST のデータに接続し、クエリを実行する方法を説明します。

JDBC データソースの作成

接続マネージャーを使用して接続プロパティを定義し、新しい JDBC データソースとして保存できます。作成した REST データソースは、Aqua Data Studio の各ツールからアクセスできるようになります。

Aqua Data Studio で、Servers メニューから Register Server を選択します。
Register Server フォームで、「Generic - JDBC」接続を選択します。
以下の JDBC 接続プロパティを入力します：
- Name: データソースの名前を入力します（例：REST）。
- Driver Location: Browse ボタンをクリックし、インストールディレクトリの lib サブフォルダにある cdata.jdbc.rest.jar ファイルを選択します。
- Driver: ドライバーのクラス名 cdata.jdbc.rest.RESTDriver を入力します。
- URL: JDBC URL を入力します。URL は jdbc:rest: から始まり、その後にセミコロン区切りで接続プロパティを指定します。
  
  データソースへの認証については、データプロバイダーのヘルプドキュメントの「はじめに」を参照してください: データプロバイダーはREST API を双方向データベーステーブルとして、XML/JSON ファイル（ローカルファイル、一般的なクラウドサービスに保存されているファイル、FTP サーバー）を読み取り専用のビューとしてモデル化します。HTTP Basic、Digest、NTLM、OAuth、FTP などの主要な認証スキームがサポートされています。認証についての詳細は、ヘルプドキュメントの「はじめに」を参照してください。
  
  URI を設定し、認証値を指定したら、Format を"XML" または"JSON" に設定して、データ表現をデータ構造により厳密に一致させるようにDataModel を設定します。
  
  DataModel プロパティは、データをどのようにテーブルに表現するかを制御するプロパティで、以下の基本的な設定を切り替えます。
  - Document （デフォルト）：REST データのトップレベルのドキュメントビューをモデル化します。データプロバイダーはネストされたエレメントをデータの集計として返します。
  - FlattenedDocuments：ネストされたドキュメントとその親を単一テーブルとして暗黙的に結合します。
  - Relational：階層データから個々の関連テーブルを返します。テーブルには、親ドキュメントにリンクする主キーと外部キーが含まれます。
  リレーショナル表現の構成について詳しくは、「REST データのモデル化」を参照してください。次の例で使用されているサンプルデータもあります。データには、人、所有している車、およびそれらの車で行われたさまざまなメンテナンスサービスのエントリが含まれています。The data includes entries for people, the cars they own, and various maintenance services performed on those cars.
  
  組み込みの接続文字列デザイナー
  
  JDBC URL の作成には、REST JDBC Driver に組み込まれている接続文字列デザイナーをご利用いただけます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。
```
java -jar cdata.jdbc.rest.jar
```
  接続プロパティを入力し、接続文字列をクリップボードにコピーします。
  一般的な JDBC URL は以下のとおりです：
```
jdbc:rest:DataModel=Relational;URI=C:/people.xml;Format=XML;
```