各製品の資料を入手。
詳細はこちら →
製品をチェック
Python でKintone のデータを変換・出力するETL 処理を作る方法
CData Python Connector とpetl モジュールを使って、Kintone のデータを変換後にCSV ファイルに吐き出すETL 処理を実装します。
最終更新日：2023-09-23
この記事で実現できるKintone 連携のシナリオ
こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
Pythonエコシステムには多くのモジュールがあり、システム構築を素早く効率的に行うことができます。本記事では、CData Python Connector for Kintone とpetl フレームワークを使って、Kintone のデータにPython から接続してデータを変換、CSV に出力するETL 変換を実装してみます。
CData Python Connector は効率的なデータ処理によりKintone のデータ にPython から接続し、高いパフォーマンスを発揮します。Kintone にデータをクエリする際、ドライバーはフィルタリング、集計などがサポートされている場合SQL 処理を直接Kintone 側に行わせ、サポートされていないSQL 処理については、組み込みのSQL エンジンによりクライアント側で処理を行います（JOIN やSQL 関数など）。
必要なモジュールのインストール
pip で必要なモジュールおよびフレームワークをインストールします：
pip install petl pip install pandas
Python でKintone のデータをETL 処理するアプリを構築
モジュールとフレームワークをインストールしたら、ETL アプリケーションを組んでいきます。コードのスニペットは以下の通りです。フルコードは記事の末尾に付いています。
CData Connector を含むモジュールをインポートします。
import petl as etl import pandas as pd import cdata.kintone as mod
接続文字列で接続を確立します。connect 関数を使って、CData Kintone Connector からKintone への接続を行います
cnxn = mod.connect("User=myuseraccount;Password=mypassword;URL=http://subdomain.domain.com;")
Kintone 接続プロパティの設定方法
Kintone に接続するには、以下の接続プロパティを設定する必要があります。
- URL：Kintone のアクセスURL（例：https://yoursitename.cybozu.com または https://yoursitename.kintone.com）
- User：アカウントのユーザー名
- Password：アカウントのパスワード
- AuthScheme：Password を指定
パスワード認証の代わりにAPI トークン認証を利用する場合は、ヘルプドキュメントの「接続の設定」セクションをご参照ください。
Basic 認証の設定
ご利用のKintone ドメインでBasic 認証を有効にしている場合は、接続プロパティの「詳細」設定で以下の項目を追加設定してください。
- BasicAuthUser：Basic認証のユーザー名
- BasicAuthPassword：Basic認証のパスワード
クライアント証明書認証の設定
Basic認証の代わりにクライアント証明書による認証を利用する場合は、以下の項目を設定してください。
- SSLClientCert：クライアント証明書のパス
- SSLClientCertType：証明書の種類
- SSLClientCertSubject：証明書のサブジェクト
- SSLClientCertPassword：証明書のパスワード
Kintone をクエリするSQL 文の作成
Kintone にはSQL でデータアクセスが可能です。Apps エンティティからのデータを読み出します。
sql = "SELECT Name, Description FROM Apps WHERE AppId = '1354841'"
Kintone データ のETL 処理
DataFrame に格納されたクエリ結果を使って、petl でETL（抽出・変換・ロード）パイプラインを組みます。この例では、Kintone のデータ を取得して、Description カラムでデータをソートして、CSV ファイルにデータをロードします。
table1 = etl.fromdb(cnxn,sql) table2 = etl.sort(table1,'Description') etl.tocsv(table2,'apps_data.csv')
CData Python Connector for Kintone を使えば、データベースを扱う場合と同感覚で、Kintone のデータ を扱うことができ、petl のようなETL パッケージから直接データにアクセスが可能になります。
おわりに
Kintone Python Connector の30日の無償トライアル をぜひダウンロードして、Kintone のデータ への接続をPython アプリやスクリプトから簡単に作成しましょう。
フルソースコード
import petl as etl
import pandas as pd
import cdata.kintone as mod
cnxn = mod.connect("User=myuseraccount;Password=mypassword;URL=http://subdomain.domain.com;")
sql = "SELECT Name, Description FROM Apps WHERE AppId = '1354841'"
table1 = etl.fromdb(cnxn,sql)
table2 = etl.sort(table1,'Description')
etl.tocsv(table2,'apps_data.csv')
CData で実現できるkintone 連携のユースケース
関連コンテンツ
