Aqua Data Studio でスマレジのデータに接続

Jerod Johnson
Senior Technology Evangelist

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

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

JDBC データソースの作成

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

Aqua Data Studio で、Servers メニューから Register Server を選択します。
Register Server フォームで、「Generic - JDBC」接続を選択します。
以下の JDBC 接続プロパティを入力します：
- Name: データソースの名前を入力します（例：スマレジ）。
- Driver Location: Browse ボタンをクリックし、インストールディレクトリの lib サブフォルダにある cdata.jdbc.smaregi.jar ファイルを選択します。
- Driver: ドライバーのクラス名 cdata.jdbc.smaregi.SmaregiDriver を入力します。
- URL: JDBC URL を入力します。URL は jdbc:smaregi: から始まり、その後にセミコロン区切りで接続プロパティを指定します。
  
  スマレジドライバーには、ContractId およびAccessToken パラメータが必要です。
  - スマレジにログイン後、「設定」->「システム連携」->「スマレジAPI 設定」に移動します。
  - 「API受信設定」セクションにある「受信機能を利用する」を「利用する」に変更し、「アクセストークンの生成」をクリックし、AccessToken を取得します。
  - 次に必要なAPI アクセスを有効にするため、「機能設定」セクションで必要な機能を「利用する」に変更します。
  ContractId： アカウントの契約ID。これは受信設定セクションでも確認できます。
  AccessToken： 受信設定セクションのアクセストークン。
  
  組み込みの接続文字列デザイナー
  
  JDBC URL の作成には、スマレジ JDBC Driver に組み込まれている接続文字列デザイナーをご利用いただけます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。
```
java -jar cdata.jdbc.smaregi.jar
```
  接続プロパティを入力し、接続文字列をクリップボードにコピーします。
  一般的な JDBC URL は以下のとおりです：
```
jdbc:smaregi:ContractId=mycontractid;AccessToken=myaccesstoken;
```