CData JDBC Driver for HubDB で SAP BusinessObjects ユニバースを作成

この記事では、CData JDBC Driver for HubDB を使用して、SAP BusinessObjects Business Intelligence アプリケーションから HubDB に接続する方法を説明します。Information Design Tool を使用してHubDB のデータを分析し、CData JDBC Driver for HubDB 上にユニバースを作成します。その後、Web Intelligence からユニバースに接続します。

HubDB への JDBC 接続を作成

以下の手順に従って、Information Design Tool で HubDB JDBC データソースへの接続を作成します。

1. CData の JAR ファイルと .lic ファイルを BusinessObjects インストールディレクトリの dataAccess\connectionServer\jdbc\drivers\jdbc サブフォルダにコピーします。CData の JAR ファイルは、インストールディレクトリの lib サブフォルダにあります。
2. プロジェクトを右クリックし、New -> New Relational Connection をクリックします。
3. 表示されるウィザードで、Generic -> Generic JDBC datasource -> JDBC Drivers をクリックします。
4. ウィザードの次のページで、接続の詳細を入力します。

5. 次のページで、Authentication Mode オプションを「Use specified username and password」に設定します。ユーザー名、パスワード、JDBC URL を入力します。JDBC URL は jdbc:hubdb: で始まり、セミコロン区切りの接続プロパティが続きます。

   HubDBデータソースへの接続には、パブリックHubSpotアプリケーションを使用したOAuth認証とプライベートアプリケーショントークンを使用した認証の2つの方法があります。

   カスタムOAuthアプリを使用する

   すべてのOAuthフローでAuthSchemeを"OAuth"に設定する必要があります。特定の認証ニーズ（デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン）に必要な接続プロパティについては、ヘルプドキュメントを確認してください。

   アプリケーションを登録し、OAuthクライアント認証情報を取得するには、以下の手順を実行してください。

   1. HubSpotアプリ開発者アカウントにログインします。
      • アプリ開発者アカウントである必要があります。標準のHubSpotアカウントではパブリックアプリを作成できません。
   2. 開発者アカウントのホームページで、アプリタブをクリックします。
   3. アプリを作成をクリックします。
   4. アプリ情報タブで、ユーザーが接続する際に表示される値を入力し、必要に応じて変更します。これらの値には、パブリックアプリケーション名、アプリケーションロゴ、アプリケーションの説明が含まれます。
   5. 認証タブで、「リダイレクトURL」ボックスにコールバックURLを入力します。
      • デスクトップアプリケーションを作成する場合は、http://localhost:33333のようなローカルにアクセス可能なURLに設定します。
      • Webアプリケーションを作成する場合は、ユーザーがアプリケーションを承認した際にリダイレクトされる信頼できるURLに設定します。
   6. アプリを作成をクリックします。HubSpotがアプリケーションとそれに関連する認証情報を生成します。
   7. 認証タブで、クライアントIDとクライアントシークレットを確認します。これらは後でドライバーを設定する際に使用します。

   8. スコープの下で、アプリケーションの意図する機能に必要なスコープを選択します。

      テーブルにアクセスするには、最低限以下のスコープが必要です：

      • hubdb
      • oauth
      • crm.objects.owners.read
   9. 変更を保存をクリックします。
   10. 統合に必要な機能にアクセスできる本番ポータルにアプリケーションをインストールします。
       • 「インストールURL（OAuth）」の下で、完全なURLをコピーをクリックして、アプリケーションのインストールURLをコピーします。
       • コピーしたリンクをブラウザで開きます。アプリケーションをインストールする標準アカウントを選択します。
       • アプリを接続をクリックします。結果のタブは閉じて構いません。

   プライベートアプリを使用する

   HubSpotプライベートアプリケーショントークンを使用して接続するには、AuthSchemeプロパティを"PrivateApp"に設定します。

   以下の手順に従ってプライベートアプリケーショントークンを生成できます：

   1. HubDBアカウントで、メインナビゲーションバーの設定アイコン（歯車）をクリックします。
   2. 左サイドバーメニューで、統合 > プライベートアプリに移動します。
   3. プライベートアプリを作成をクリックします。
   4. 基本情報タブで、アプリケーションの詳細（名前、ロゴ、説明）を設定します。
   5. スコープタブで、プライベートアプリケーションがアクセスできるようにしたい各スコープに対して読み取りまたは書き込みを選択します。
   6. テーブルにアクセスするには、最低限hubdbとcrm.objects.owners.readが必要です。
   7. アプリケーションの設定が完了したら、右上のアプリを作成をクリックします。
   8. アプリケーションのアクセストークンに関する情報を確認し、作成を続行をクリックし、その後トークンを表示をクリックします。
   9. コピーをクリックして、プライベートアプリケーショントークンをコピーします。

   接続するには、PrivateAppTokenを取得したプライベートアプリケーショントークンに設定します。

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

   JDBC URL の構成については、HubDB JDBC Driver に組み込まれている接続文字列デザイナを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。

   java -jar cdata.jdbc.hubdb.jar
   

   接続プロパティを入力し、接続文字列をクリップボードにコピーします。

   

   JDBC URL を設定する際に、Max Rows 接続プロパティの設定も検討してください。返される行数を制限することで、特にレポートやビジュアライゼーションの設計時にパフォーマンスを向上させることができます。

   以下は一般的な JDBC URL です：

   jdbc:hubdb:AuthScheme=OAuth;OAuthClientID=MyOAuthClientID;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;
   

6. ドライバークラスを入力します：cdata.jdbc.hubdb.HubDBDriver
7. 接続プーリングとカスタムパラメータのデフォルト値でウィザードを完了します。

Information Design Tool で HubDB のデータ を分析

JDBC 接続を使用して、Information Design Tool でHubDB のデータを分析できます。

1. Local Projects ビューで、接続（.cnx ファイル）をダブルクリックして HubDB データソースを開きます。
2. Show Values タブでは、テーブルデータをロードしたり SQL クエリを入力したりできます。テーブルデータを表示するには、テーブルのノードを展開し、テーブルを右クリックして Show Values をクリックします。値が Raw Data タブに表示されます。
3. Analysis タブでは、カラムをチャートの軸にドラッグ＆ドロップしてデータを分析できます。

ローカル接続を公開

ユニバースを CMS に公開するには、接続も公開する必要があります。

1. Local Projects ビューで、接続を右クリックし、Publish Connection to a Repository をクリックします。
2. リポジトリのホストとポート、接続の認証情報を入力します。
3. 接続を公開するフォルダを選択します。
4. 表示される成功ダイアログで Yes をクリックして、接続のショートカットを作成します。

JDBC Driver for HubDB でユニバースを作成

以下の手順に従って、JDBC ドライバー上にユニバースを作成します。この例のユニバースはリポジトリに公開されるため、前のステップで作成した公開済み接続を使用します。

1. Information Design Tool で、File -> New Universe をクリックします。
2. プロジェクトを選択します。
3. リレーショナルデータソース上にユニバースを作成するオプションを選択します。
4. 公開済み接続へのショートカットを選択します。
5. Data Foundation の名前を入力します。
6. オブジェクトとしてアクセスしたいテーブルとカラムをインポートします。
7. Business Layer の名前を入力します。

ユニバースを公開

以下の手順に従って、ユニバースを CMS に公開します。

1. Local Projects ビューで、ビジネスレイヤーを右クリックし、Publish -> To a Repository をクリックします。
2. Publish Universe ダイアログで、インポート前の整合性チェックを入力します。
3. ユニバースを公開するリポジトリ上のフォルダを選択または作成します。

Web Intelligence で HubDB のデータ をクエリ

公開されたユニバースを使用して、Web Intelligence から HubDB に接続できます。

1. cdata.jdbc.hubdb.lic ファイルを BusinessObjects インストールディレクトリの \dataAccess\connectionServer\jdbc\drivers\jdbc サブフォルダにコピーします。ライセンスファイルは、インストールディレクトリの lib サブフォルダにあります。
2. BusinessObjects ランチパッドから Web Intelligence を開き、新しいドキュメントを作成します。
3. データソースとして Universe オプションを選択します。
4. HubDB ユニバースを選択します。これによりクエリパネルが開きます。Result Objects ペインにオブジェクトをドラッグして、クエリで使用します。