各製品の資料を入手。
詳細はこちら →
製品をチェック
Python でReckon Accounts Hosted のデータを変換・出力するETL 処理を作る方法
CData Python Connector とpetl モジュールを使って、Reckon Accounts Hosted のデータを変換後にCSV ファイルに吐き出すETL 処理を実装します。
最終更新日：2023-09-23
この記事で実現できるReckon Accounts Hosted 連携のシナリオ
こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
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')
関連コンテンツ
