NetBeans で Aha のデータ に接続
CData JDBC Driver for Aha は、JDBC をサポートする IDE にリアルタイム Aha のデータ 接続を統合します。JDBC 標準により、ビルトインのデータアクセスウィザードや迅速な開発をサポートするその他のツールを使用できます。この記事では、NetBeans で Aha のデータ に接続する方法を説明します。接続を作成し、テーブルエディターで ロードを行います。
NetBeans で Aha 用の JDBC データソースを作成
JDBC データソースを作成するには、サービスウィンドウで Database ノードを展開し、Drivers ノードを右クリックして New Driver を選択します。表示される New Driver ウィザードで、以下の情報を入力します:
- Driver File(s):Add をクリックし、表示されるファイルエクスプローラーダイアログで cdata.jdbc.api.jar ファイルを選択します。ドライバー JAR はインストールディレクトリの lib サブフォルダにあります。
- Driver Class:Find をクリックして JAR 内のドライバークラスを検索します。次に、メニューから cdata.jdbc.api.APIDriver を選択します。
- Name:ドライバーの名前を入力します。
接続パラメータの定義
以下の手順で、必要な接続プロパティを定義します:
サービスウィンドウで Database ノードを右クリックし、New Connection をクリックします。
New Connection Wizard で、以下の接続プロパティを入力します:
- Driver Name:メニューから CData JDBC Driver for Aha を選択します。
- User Name:ユーザー名を入力します。これは JDBC URL でも定義できます。
- Password:パスワードを入力します。これは JDBC URL でも定義できます。
JDBC URL:JDBC URL を指定します。
まず、Profile 接続プロパティをディスク上のAha! プロファイルの場所に設定します(例:C:\profiles\aha.apip)。次に、ProfileSettings 接続プロパティをAha! の接続文字列に設定します(以下を参照)。
Aha! API プロファイル設定
Aha! API はOAuth ベースの認証を使用します。
まず、Aha! でOAuth アプリを登録する必要があります。これはAha! アカウントの「Settings」>「Personal」>「Developer」>「OAuth Applications」から行えます。また、Aha アカウントのドメイン名にあるDomain を設定します。例えば、Aha アカウントがacmeinc.aha.io の場合、Domain は「acmeinc」となります。
以下の項目を接続文字列に設定すると、接続できるようになります。
- AuthScheme:OAuth に設定します。
- InitiateOAuth:GETANDREFRESH に設定します。InitiateOAuth を使用して、OAuthAccessToken を取得するプロセスを管理できます。
- OAuthClientId:アプリ設定で指定されたclient_id に設定します。
- OAuthClientSecret:アプリ設定で指定されたclient_secret に設定します。
- CallbackURL:アプリ設定で指定したRedirect URI に設定します。
- Domain:ProfileSettings でAha ドメインに設定します。
ビルトイン接続文字列デザイナー
JDBC URL の作成には、Aha JDBC Driver にビルトインされている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
java -jar cdata.jdbc.api.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
一般的な JDBC URL は次のとおりです:
jdbc:api:Profile=C:\profiles\aha.apip;ProfileSettings='Domain=acmeinc';Authscheme=OAuth;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;
Aha のデータ のクエリ
Aha のデータ に接続するには、Database ノードで接続を右クリックし、Connect をクリックします。接続が確立されたら、展開してスキーマ情報を確認できます。
Data Views ウィンドウにテーブルをロードするには、テーブルを右クリックして View Data をクリックします。。