PowerBuilder から JDBC 経由で Webex のデータ に接続
CData JDBC ドライバー for Webex は、 PowerBuilder を含む、JDBC をサポートするあらゆるプラットフォームや開発技術から使用できる標準ベースのコントロールです。 この記事では、PowerBuilder で CData JDBC Driver for Webex を使用する方法について説明します。
ここでは、CData JDBC Driver for Webex を使用してデータを取得する基本的な PowerBuilder アプリケーションの作成方法を説明します。
PowerBuilder から Webex のデータ に接続
以下の手順に従って、Database Painter ツールを使用し、Webex 用の JDBC URL に基づくデータベースプロファイルを作成します。データベースプロファイルを使用して接続プロパティを保存できます。Database Painter では、データをグラフィカルに操作したり、SQL クエリを実行したりできます。
ドライバーの JAR ファイルを PowerBuilder のクラスパスに追加します。CLASSPATH システム環境変数を、インストールディレクトリの lib サブフォルダにあるドライバー JAR へのパスに設定します。
Note: PowerBuilder Classic を使用している場合は、Tools -> System Options -> Java をクリックしてドライバー JAR へのパスを追加することもできます。
- Tools -> Database Painter をクリックします。
- JDBC ノードを右クリックし、New Profile をクリックします。
- Database Profile Setup ダイアログで、以下の情報を入力します。
- Profile Name: プロファイルのわかりやすい名前を入力します。
- Driver Name: ドライバーのクラス名を入力します: cdata.jdbc.api.APIDriver
- URL: JDBC URL を入力します。
Webex への認証では、OAuth 標準を使って自分のデータに接続したり、他のユーザーが各自のデータに接続できるようにしたりできます。
OAuth 認証の設定
まず、Webex に OAuth アプリケーションを登録する必要があります。登録するには、Webex Developer Portal に移動して、新しいインテグレーションを作成します。OAuth アプリケーションには client id と client secret が割り当てられます。
以下の接続プロパティを設定して接続を確立してください:
- AuthScheme:OAuth に設定します。
- InitiateOAuth:GETANDREFRESH に設定します。InitiateOAuth を使うと、OAuthAccessToken を取得するプロセスを管理できます。
- OAuthClientId:アプリ設定で指定された client_id に設定します。
- OAuthClientSecret:アプリ設定で指定された client_secret に設定します。
- CallbackURL:アプリ設定で指定されたリダイレクト URI に設定します。
- Scope:ProfileSettings に設定して、認可時にリクエストする OAuth スコープを指定します。複数のスコープはスペースで区切ることができます(例:ProfileSettings='Scope=spark:all spark:kms')。
接続文字列の例:
Profile=C:\profiles\Webex.apip;Authscheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;ProfileSettings='Scope=your_scopes';
組み込みの接続文字列デザイナー
JDBC URL の構築には、Webex JDBC Driver に組み込まれている接続文字列デザイナーが便利です。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
java -jar cdata.jdbc.api.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。一般的な JDBC URL は以下のとおりです。
jdbc:api:Profile=C:\profiles\Webex.apip;Authscheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;ProfileSettings='Scope=your_scopes';
- テーブルを表示および編集するには、テーブルを右クリックして Edit Data -> Grid をクリックします。
PowerBuilder コントロールで Webex のデータ を使用
標準の PowerBuilder オブジェクトを使用して JDBC データソースに接続し、クエリを実行できます。以下の例では、Webex のデータ を DataWindow に取得する方法を示します。以下のコードを open メソッドに追加できます。
SQLCA.DBMS = "JDBC" SQLCA.AutoCommit = False SQLCA.DBParm = "Driver='cdata.jdbc.api.APIDriver',URL='jdbc:api:Profile=C:\profiles\Webex.apip;Authscheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;ProfileSettings='Scope=your_scopes';"; CONNECT USING SQLCA; dw_adminauditevents.SetTransObject(SQLCA); dw_adminauditevents.Retrieve();