Python でReckon Accounts Hosted データを変換・出力するETL 処理を作る方法

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

Pythonエコシステムには多くのモジュールがあり、システム構築を素早く効率的に行うことができます。本記事では、CData Python Connector for ReckonAccountsHosted とpetl フレームワークを使って、Reckon Accounts Hosted データにPython から接続してデータを変換、CSV に出力するETL 変換を実装してみます。

CData Python Connector は効率的なデータ処理によりReckon Accounts Hosted データ にPython から接続し、高いパフォーマンスを発揮します。Reckon Accounts Hosted にデータをクエリする際、ドライバーはフィルタリング、集計などがサポートされている場合SQL 処理を直接Reckon Accounts Hosted 側に行わせ、サポートされていないSQL 処理については、組み込みのSQL エンジンによりクライアント側で処理を行います（JOIN やSQL 関数など）。

必要なモジュールのインストール

pip で必要なモジュールおよびフレームワークをインストールします：

pip install petl
pip install pandas

Python でReckon Accounts Hosted データをETL 処理するアプリを構築

モジュールとフレームワークをインストールしたら、ETL アプリケーションを組んでいきます。コードのスニペットは以下の通りです。フルコードは記事の末尾に付いています。

CData Connector を含むモジュールをインポートします。

import petl as etl
import pandas as pd
import cdata.reckonaccountshosted as mod

接続文字列で接続を確立します。connect 関数を使って、CData Reckon Accounts Hosted Connector からReckon Accounts Hosted への接続を行います

cnxn = mod.connect("SubscriptionKey=my_subscription_key;CountryVersion=2021.R2.AU;CompanyFile=Q:/CompanyName.QBW;User=my_user;Password=my_password;CallbackURL=http://localhost:33333;OAuthClientId=my_oauth_client_id;OAuthClientSecret=my_oauth_client_secret;InitiateOAuth=GETANDREFRESH;OAuthSettingsLocation=/PATH/TO/OAuthSettings.txt")")

CData 製品 はOAuth 経由でReckon Accounts Hosted にリクエストを作成します。次の接続プロパティを指定します。

• User： 必須。企業ファイルのユーザー名。
• Password： 必須。企業ファイルのパスワード。
• CompanyFile: 必須。企業ファイルへのパス。
• InitiateOAuth：アクセストークンの処理をドライバーに任せる場合はGETANDREFRESH に設定。
• CountryVersion：デフォルトは、2021.R2.AU です。

カスタムOAuth アプリケーションを作成し、以下の追加の接続プロパティを指定することもできます。

• SubscriptionKey：Azure Platform 上のReckon Portal から取得したAPI キー。
• OAuthClientId：アプリケーション設定のクライアントID に設定。
• OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。
• CallbackURL：カスタムOAuth アプリのリダイレクトURI。

CData は、OAuth デスクトップ認証を簡略化する埋め込みOAuth アプリケーションを提供します。ほかのOAuth 認証方法（Web、ヘッドレスなど）、カスタムOAuth アプリケーションの作成、その理由などについては、ヘルプドキュメントを参照してください。

Reckon Accounts Hosted をクエリするSQL 文の作成

Reckon Accounts Hosted にはSQL でデータアクセスが可能です。Accounts エンティティからのデータを読み出します。

sql = "SELECT Name, Balance FROM Accounts WHERE IsActive = 'true'"

Reckon Accounts Hosted データ のETL 処理

DataFrame に格納されたクエリ結果を使って、petl でETL（抽出・変換・ロード）パイプラインを組みます。この例では、Reckon Accounts Hosted データ を取得して、Balance カラムでデータをソートして、CSV ファイルにデータをロードします。

table1 = etl.fromdb(cnxn,sql)

table2 = etl.sort(table1,'Balance')

etl.tocsv(table2,'accounts_data.csv')

CData Python Connector for ReckonAccountsHosted を使えば、データベースを扱う場合と同感覚で、Reckon Accounts Hosted データ を扱うことができ、petl のようなETL パッケージから直接データにアクセスが可能になります。

おわりに

Reckon Accounts Hosted Python Connector の30日の無償トライアル をぜひダウンロードして、Reckon Accounts Hosted データ への接続をPython アプリやスクリプトから簡単に作成しましょう。

フルソースコード

import petl as etl
import pandas as pd
import cdata.reckonaccountshosted as mod

cnxn = mod.connect("SubscriptionKey=my_subscription_key;CountryVersion=2021.R2.AU;CompanyFile=Q:/CompanyName.QBW;User=my_user;Password=my_password;CallbackURL=http://localhost:33333;OAuthClientId=my_oauth_client_id;OAuthClientSecret=my_oauth_client_secret;InitiateOAuth=GETANDREFRESH;OAuthSettingsLocation=/PATH/TO/OAuthSettings.txt")")

sql = "SELECT Name, Balance FROM Accounts WHERE IsActive = 'true'"

table1 = etl.fromdb(cnxn,sql)

table2 = etl.sort(table1,'Balance')

etl.tocsv(table2,'accounts_data.csv')