Squirrel SQL Client からAcumatica のデータに連携

Acumatica に接続し、Squirrel SQL Client でクエリを実行します。

古川えりか
コンテンツスペシャリスト

最終更新日:2022-10-03

この記事で実現できるAcumatica 連携のシナリオ

こんにちは!ドライバー周りのヘルプドキュメントを担当している古川です。

CData JDBC Driver for Acumatica を使用して、Squirrel SQL Client などのツールでAcumatica へのクエリを実行できます。この記事では、JDBC data source for Acumatica を作成し、クエリを実行します。

JDBC Driver for Acumatica を追加する

以下のステップに従ってドライバーJAR を追加します。

  1. Squirrel SQL で[Windows]->[View Drivers]と進みます。
  2. プラスアイコンをクリックし、[Add Driver]ウィザードを開きます。
  3. [Name]ボックスで、CData JDBC Driver for Acumatica のようなドライバーのわかりやすい名前を入力します。
  4. [Example URL]ボックスで、jdbc:acumatica: と入力します。
  5. [Extra Class Path]タブで[Add]をクリックします。
  6. 表示される[file explorer]ダイアログで、インストールディレクトリのlib サブフォルダにあるドライバーのJAR ファイルを選択します。
  7. [List Drivers]をクリックして[Class Name]メニューにドライバーのクラス名(cdata.jdbc.acumatica.AcumaticaDriver) を入力します。
The definition for the JDBC data source.(Salesforce is shown.)

接続プロパティを定義する

以下のステップに従って、接続プロパティをドライバーエイリアスに保存します。

  1. [Windows]->[View Aliases]と進みます。
  2. エイリアスが一覧表示されているペインで、プラスアイコンをクリックします。
  3. 表示される[Add Alias]ウィザードで、JDBC ドライバーには以下のフィールドが要求されます。

    • Name:CData Acumatica Source のようなエイリアスの名前を入力します。
    • Driver:CData JDBC Driver for Acumatica を選択します。
    • URL:jdbc:acumatica: と入力します。
    • User Name:ユーザー名を入力すると、JDBC URL に追加されます。
    • Password:パスワードを入力すると、JDBC URL に追加されます。
    The alias definition, containing the connection parameters.(Salesforce is shown.)
  4. 追加のプロパティを定義する場合は、[Properties]をクリックします。
  5. 表示されるダイアログの[Driver properties]タブで、[Use driver properties]のチェックボックスを選択します。
  6. [Specify]カラムで必要な接続プロパティのチェックボックスを選択します。

    Acumatica 接続プロパティの取得・設定方法

    Acumatica への接続

    Acumatica データソースに接続するには、次の接続プロパティを指定する必要があります。

    • Url:(必須)Acumatica ERP インスタンスのベースURL。例:https://domain.acumatica.com/
    • Schema:(オプション)異なるデータを含む2つのスキーマがあります。デフォルトはREST で、Acumatica REST コントラクトベースのAPI を使用し、OData スキーマはAcumatica OData API を使用します。OData スキーマはAcumatica Generic Inquiries へのクエリに使用されます。
    • Company:(一部必須)会社名またはテナント名に設定。Schema がOData に設定されている場合は必須です。
    • EndpointVersion:(オプション)Web Services エンドポイントのバージョン。例:17.200.001。これはREST スキーマにのみ適用されます。
    • EndpointName:(オプション)Web Services エンドポイントの名前。例:Default。これはREST スキーマにのみ適用されます。
    詳細はヘルプドキュメントの「接続の確立」セクションを参照してください。

    Acumatica への認証

    Acumatica データソースへの接続に使用できる認証方法は2つあります。Basic およびOAuth です。 Basic 認証では、AuthSchemeBasic に設定し、UserPassword をログイン資格情報に設定します。 OAuth 認証については、ヘルプドキュメントの「接続の確立」セクションにある「OAuth」を参照してください。

    以下は一般的な接続文字列です。

    jdbc:acumatica:Url = https://try.acumatica.com/ISV/entity/Default/17.200.001/;User=user;Password=password;Company=CompanyName; Connection properties automatically detected by Squirrel SQL.(Salesforce is shown.)
  7. [OK]をクリックし、表示されるダイアログで[connect]をクリックして接続を確認します。

スキーマを検出しAcumatica のデータをクエリする

メタデータが読み込まれると、Acumatica のデータソースの新しいタブが表示されます。[Objects]サブタブでは、使用可能なテーブルやビューなどのスキーマ情報を見つけることができます。

Column metadata for a table.(Salesforce is shown.)

テーブルデータを表示するには[Objects]タブでテーブルを選択します。その後、テーブルデータが[Content]タブのグリッドに読み込まれます。

Tables can be edited on the Content tab.(Salesforce is shown.)

SQL クエリを実行するには、[SQL]タブにクエリを入力し、[Run SQL](ランナーアイコン)をクリックします。例:

SELECT Id, location_displayname FROM Events A query and the results.(Salesforce is shown.)

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。