Birst でStripe データのビジュアライゼーションを構築

加藤龍彦
デジタルマーケティング

CData JDBC Driver とBirst クラウドエージェントを使用して、Birst でStripe のデータのリアルタイムの視覚化を構築します。

Birst は、組織が複雑なプロセスを迅速に理解し、最適化することを支援するクラウドビジネスインテリジェンス（BI）ツールおよび分析プラットフォームです。CData JDBC Driver for Stripe と組み合わせると、Birst Cloud Agent を経由してリアルタイムStripe のデータに接続し、ビジュアライズを構築できます。ここでは、Cloud Agent を使用してStripe に連携し、Birst で動的レポートを作成する方法を段階的に説明します。

強力なデータ処理機能により、CData JDBC Driver はBirst のStripe のデータ操作に高いパフォーマンスを提供します。Birst からStripe への複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作を直接Stripe にプッシュし、組込みSQL エンジンを利用してクライアント側でサポートしない操作を処理します。組み込みの動的メタデータクエリにより、JDBC ドライバーはネイティブのBirst データ型を使用してStripe のデータを視覚化および分析することを可能にします。

Birst でStripe データへのJDBC 接続を設定

Birst プロジェクトを作成する前に、JDBC Driver を操作するためのBirst Cloud Agent をインストールする必要があります。また、JDBC ドライバーのJAR ファイル(および存在する場合はLIC ファイル)をCloud Agent のインストール場所の/drivers/ ディレクトリにコピーします。

ドライバーとCloud Agent のインストールが完了したら、開始できます。

Birst で新しいプロジェクトを作成します。
接続に名前を付けます。(e.g. CDataStripe)
Live Access を選択します。
エージェントを選択します。
Database Type をOther に設定します。

SQL タイプをMSSQL に設定します。
接続文字列を設定します。
Stripeへの接続

それでは、Stripe への接続について説明していきましょう。Stripe では、本番API キーまたはOAuth のいずれかによる認証をサポートしています。

本番API キー

本番API キーで接続するには、以下の2つの設定パラメータを設定する必要があります。
- AuthScheme = APIKey
- LiveAPIKey = 本番API キーの値
本番API キーの値を取得するには、以下の手順で確認できます：
1. Stripe ダッシュボードにログインします
2. 開発者 → API キー → シークレットキー → 本番環境のキーを表示 に移動します
Stripe では、テストモードで作成されたシークレットキーを使用して、'StripeV2' データモデルのエンティティにはアクセスできませんのでご注意ください。ライブモードまたはサンドボックスモードで作成されたシークレットキーをご利用ください。さらに、制限付きキーを使用して'StripeV2' データモデルのエンティティにアクセスすることも許可されていません。

OAuth については、ヘルプドキュメントの「接続の確立」をご確認ください。

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

JDBC URL の構成については、Stripe JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
```
java -jar cdata.jdbc.stripe.jar
```
接続プロパティを入力し、接続文字列をクリップボードにコピーします。

JDBC URL を構成する際、Max Rows 接続プロパティを設定することもできます。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。

以下はStripe の一般的なJDBC 接続文字列です。
```
jdbc:stripe:OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;
```
Driver Name cdata.jdbc.stripe.StripeDriver を設定し、［Save］をクリックします。