QuerySurge で NetSuite のデータ を検証

Jerod Johnson
Jerod Johnson
Senior Technology Evangelist
CData JDBC Driver を使用して、QuerySurge からNetSuite のデータにアクセスし、データを検証します。

QuerySurge は、データの検証とテストを自動化するスマートなデータテストソリューションです。CData JDBC Driver for NetSuite と組み合わせることで、QuerySurge からライブのNetSuite のデータを操作できます。この記事では、QuerySurge からNetSuite のデータに接続する方法を説明します。

CData JDBC Driver は最適化されたデータ処理機能を備えており、ライブのNetSuite のデータとのやり取りにおいて比類のないパフォーマンスを提供します。NetSuite に複雑な SQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされている SQL 操作を直接 NetSuite にプッシュし、サポートされていない操作（主に SQL 関数や JOIN 操作）はクライアント側の組み込み SQL エンジンで処理します。また、ビルトインの動的メタデータクエリ機能により、ネイティブなデータ型を使用してNetSuite のデータを操作・分析できます。

NetSuite データ連携について

CData は、Oracle NetSuite のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています：

  • Standard、CRM、OneWorld を含む、すべてのエディションの NetSuite にアクセスできます。
  • SuiteTalk API（SOAP ベース）のすべてのバージョンと、SQL のように機能し、より簡単なデータクエリと操作を可能にする SuiteQL に接続できます。
  • Saved Searches のサポートにより、事前定義されたレポートとカスタムレポートにアクセスできます。
  • トークンベースおよび OAuth 2.0 で安全に認証でき、あらゆるユースケースで互換性とセキュリティを確保します。
  • SQL ストアドプロシージャを使用して、ファイルのアップロード・ダウンロード、レコードや関連付けのアタッチ・デタッチ、ロールの取得、追加のテーブルやカラム情報の取得、ジョブ結果の取得などの機能的なアクションを実行できます。

お客様は、Power BI や Excel などのお気に入りの分析ツールからライブ NetSuite データにアクセスするために CData ソリューションを使用しています。また、CData Sync を直接使用するか、Azure Data Factory などの他のアプリケーションとの CData の互換性を活用して、NetSuite データを包括的なデータベースやデータウェアハウスに統合しています。CData は、Oracle NetSuite のお客様が NetSuite からデータを取得し、NetSuite にデータをプッシュするアプリを簡単に作成できるよう支援し、他のソースからのデータを NetSuite と統合することを可能にしています。

当社の Oracle NetSuite ソリューションの詳細については、ブログをご覧ください：Drivers in Focus Part 2: Replicating and Consolidating ... NetSuite Accounting Data


はじめに


QuerySurge から NetSuite のデータ に接続

QuerySurge からライブのNetSuite のデータに接続するには、JDBC Driver の JAR ファイルを QuerySurge Agent にデプロイし、QuerySurge の Admin ビューから新しい接続を追加する必要があります。

JDBC Driver をデプロイ

  1. CData JDBC Driver for NetSuite のインストーラをダウンロードし、パッケージを解凍して JAR ファイルを実行し、ドライバーをインストールします。
  2. ドライバーのインストールが完了したら、Agent Service を停止します。
  3. インストール先（通常は C:\Program Files\CData\CData JDBC Driver for NetSuite\lib\）から JAR ファイル（ライセンスファイルがある場合はそれも）を Agent（QuerySurge_install_dir\agent\jdbc）にコピーします。
  4. Agent Service を再起動します。

QuerySurge への JDBC ドライバーのデプロイについての詳細は、QuerySurge ナレッジベースをご参照ください。

NetSuite への新しい接続を設定

  1. QuerySurge にログインし、Admin ビューに移動します。
  2. Administration Tree で Configuration -> Connections をクリックします。
  3. Add をクリックして新しい接続を作成します。
  4. QuerySurge Connection Wizard で Next をクリックします。
  5. 接続の名前を入力します（例：CData JDBC Connection to NetSuite）。
  6. Data Source を「All Other JDBC Connections (Connection Extensibility)」に設定し、Next をクリックします。
  7. Driver Class を cdata.jdbc.netsuite.NetSuiteDriver に設定し、Next をクリックします。

  8. NetSuite への認証に必要な接続プロパティを使用して Connection URL を設定します。Connection URL は以下のような形式になります：

    jdbc:netsuite:AccountId=XABC123456;Schema=SuiteTalk;AuthScheme=Token;OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;OAuthAccessToken=MyOAuthAccessToken;OAuthAccessTokenSecret=MyOAuthAccessTokenSecret;

    ビルトイン接続文字列デザイナ

    JDBC URL の構成については、NetSuite JDBC Driver に組み込まれている接続文字列デザイナを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。

    java -jar cdata.jdbc.netsuite.jar

    接続プロパティを入力し、接続文字列をクリップボードにコピーします。

    NetSuiteへの接続

    NetSuite では、2種類のAPI でデータにアクセスできます。どちらのAPI を使用するかは、Schema 接続プロパティで以下のいずれかを選択して指定してください。

    • SuiteTalk は、NetSuite との通信に使用されるSOAP ベースの従来から提供されているサービスです。幅広いエンティティをサポートし、INSERT / UPDATE / DELETE の操作も対応しています。ただし、SuiteQL API と比べるとデータの取得速度が劣ります。また、サーバーサイドでのJOIN に対応していないため、これらの処理はCData 製品がクライアントサイドで実行します。
    • SuiteQL は、より新しいAPI です。JOIN、GROUP BY、集計、カラムフィルタリングをサーバーサイドで処理できるため、SuiteTalk よりもはるかに高速にデータを取得できます。ただし、NetSuite データへのアクセスは読み取り専用となります。

    データの取得のみが目的でしたらSuiteQL をお勧めします。データの取得と変更の両方が必要な場合は、SuiteTalk をお選びください。

    NetSuite への認証

    CData 製品では、以下の認証方式がご利用いただけます。

    • トークンベース認証（TBA）はOAuth1.0に似た仕組みです。2020.2以降のSuiteTalk とSuiteQL の両方で利用できます。
    • OAuth 2.0 認証（OAuth 2.0 認可コードグラントフロー）は、SuiteQL でのみご利用いただけます。
    • OAuth JWT 認証は、OAuth2.0 クライアント認証フローの一つで、クライアント認証情報を含むJWT を使用してNetSuite データへのアクセスを要求します。

    トークンベース認証（OAuth1.0）

    トークンベース認証（TBA）は、基本的にOAuth 1.0 の仕組みです。この認証方式はSuiteTalk とSuiteQL の両方でサポートされています。管理者権限をお持ちの方がNetSuite UI 内でOAuthClientId、OAuthClientSecret、OAuthAccessToken、OAuthAccessTokenSecret を直接作成することで設定できます。 NetSuite UI でのトークン作成手順については、ヘルプドキュメントの「はじめに」セクションをご参照ください。

    アクセストークンを作成したら、以下の接続プロパティを設定して接続してみましょう。

    • AuthScheme = Token
    • AccountId = 接続先のアカウント
    • OAuthClientId = アプリケーション作成時に表示されるコンシューマーキー
    • OAuthClientSecret = アプリケーション作成時に表示されるコンシューマーシークレット
    • OAuthAccessToken = アクセストークン作成時のトークンID
    • OAuthAccessTokenSecret = アクセストークン作成時のトークンシークレット

    その他の認証方法については、ヘルプドキュメントの「はじめに」をご確認ください。

  9. 接続の Test Connection ボタンを有効にするため、Test Query を設定し（例：SELECT * FROM SalesOrder LIMIT 1）、Next をクリックします。
  10. Test Connection をクリックして接続が正しく設定されていることを確認し、Save をクリックして接続を追加します。

接続を追加したら、QuerySurge でNetSuite のデータに対して SQL クエリを実行できます。

QueryPair で NetSuite のデータ クエリを比較

接続を設定したら、以下の手順に従って QueryPair でNetSuite のデータのクエリを比較できます。

  1. Design メニューから「Design Library」を選択します
  2. QuerySurge Design の下の QueryPairs をクリックします
  3. 「Create New QueryPair」をクリックします
  4. QueryPair に名前を付けて Save をクリックします
  5. Source または Target ペインで、上記で作成した接続を選択します（NetSuite を2回クエリする場合は同じ接続を選択するか、比較を実行する場合は別の接続を選択します）
  6. 各ペインの Editor にクエリを入力します（例：SELECT * FROM SalesOrder）
  7. 「Design-Time Run」タブをクリックしてクエリを実行します
  8. クエリの実行が完了したら、「View Query Results」をクリックしてクエリから返されたNetSuite のデータを確認します

30 日間の無償トライアルをダウンロードして、QuerySurge でライブのNetSuite のデータを活用してみてください。ご不明な点がございましたら、サポートチームまでお問い合わせください。

はじめる準備はできましたか？

NetSuite Driver の無料トライアルをダウンロードしてお試しください：

 ダウンロード

詳細：

NetSuite Icon NetSuite JDBC Driver お問い合わせ

潜在顧客、連絡先、営業案件、アカウントなどのNetSuite アカウントデータを組み込んだパワフルなJava アプリケーションを短時間・低コストで作成して配布できます。

この記事の内容

関連記事