Apache Spark でNetSuite のデータをSQL で操作する方法

Apache Spark は大規模データ処理のための高速エンジンです。CData JDBC Driver for NetSuite と組み合わせると、Spark はリアルタイムでNetSuite のデータに連携して処理ができます。本記事では、Spark シェルに接続してNetSuite をクエリする方法について解説します。

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

CData JDBC Driver for NetSuite をインストール

まずは、本記事右側のサイドバーからNetSuite JDBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

Spark Shell を起動してNetSuite のデータに接続

1. ターミナルを開き、Spark shell でCData JDBC Driver for NetSuite JAR file をjars パラメータに設定します:

   $ spark-shell --jars /CData/CData JDBC Driver for NetSuite/lib/cdata.jdbc.netsuite.jar
   

2. Shell でJDBC URL を使ってNetSuite に接続し、SQL Context load() function でテーブルを読み込みます。

   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 = アクセストークン作成時のトークンシークレット

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

   組み込みの接続文字列デザイナー

   JDBC 接続文字列URL の作成には、NetSuite JDBC Driver にビルトインされたデザイナを使用できます。JAR ファイルをダブルクリックするか、コマンドラインでJAR ファイルを実行するとデザイナが開きます。

   java -jar cdata.jdbc.netsuite.jar
   

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

   scala> val netsuite_df = spark.sqlContext.read.format("jdbc").option("url", "jdbc:netsuite:AccountId=XABC123456;Schema=SuiteTalk;AuthScheme=Token;OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;OAuthAccessToken=MyOAuthAccessToken;OAuthAccessTokenSecret=MyOAuthAccessTokenSecret;").option("dbtable","SalesOrder").option("driver","cdata.jdbc.netsuite.NetSuiteDriver").load()
   

3. 接続が完了し、データがロードされたら、テーブルスキーマが表示されます。

4. NetSuite をテンポラリーテーブルとして登録します:

   scala> netsuite_df.registerTable("salesorder")

5. データに対して、次のようなカスタムSQL クエリを実行します。

   scala> netsuite_df.sqlContext.sql("SELECT CustomerName, SalesOrderTotal FROM SalesOrder WHERE Class_Name = Furniture : Office").collect.foreach(println)

   コンソールで、次のようなNetSuite のデータを取得できました！これでNetSuite との連携は完了です。

   

CData JDBC Driver for NetSuite をApache Spark で使って、NetSuite に対して、複雑かつハイパフォーマンスなクエリを実行できます。30日の無償評価版 をダウンロードしてぜひお試しください。

Apache Spark の設定