Denodo Platform で HubDB のデータ に接続

Jerod Johnson
Jerod Johnson
Senior Technology Evangelist
CData ドライバーを使用して、Denodo Virtual DataPort Administrator で HubDB のデータ 用の仮想データソースを作成する方法を説明します。

Denodo Platform は、エンタープライズデータベースのデータを統合的に扱うことができるデータ仮想化製品です。CData JDBC Driver for HubDB と組み合わせることで、Denodo ユーザーは他のエンタープライズデータソースと並んでライブ HubDB のデータ を扱うことができます。本記事では、Denodo Virtual DataPort Administrator で HubDB 用の仮想データソースを作成する方法を解説します。

CData JDBC Driver は、最適化されたデータ処理機能を内蔵しており、ライブ HubDB のデータ とのやり取りにおいて比類のないパフォーマンスを提供します。HubDB に対して複雑な SQL クエリを発行すると、ドライバーはフィルターや集計などのサポートされている SQL 操作を直接 HubDB にプッシュし、内蔵の SQL エンジンを使用してサポートされていない操作（主に SQL 関数や JOIN 操作）をクライアントサイドで処理します。また、動的メタデータクエリ機能を内蔵しているため、ネイティブデータ型を使用して HubDB のデータ を操作・分析できます。

HubDB 仮想ポートの作成

Denodo からライブ HubDB のデータ に接続するには、JDBC Driver の JAR ファイルを Denodo の外部ライブラリディレクトリにコピーし、Virtual DataPort Administrator ツールで新しい JDBC データソースを作成します。

  1. CData JDBC Driver for HubDB インストーラーをダウンロードし、パッケージを解凍して JAR ファイルを実行してドライバーをインストールします。
  2. インストール先（通常は C:\Program Files\CData\CData JDBC Driver for HubDB\lib\）から JAR ファイル（およびライセンスファイルが存在する場合はそれも）を Denodo 外部ライブラリディレクトリ（C:\Denodo\Denodo Platform\lib-external\jdbc-drivers\cdata-hubdb-19）にコピーします。
  3. Denodo Virtual DataPort Administrator ツールを開き、Server Explorer タブに移動します。
  4. "admin" を右クリックし、New -> Data source -> JDBC を選択します。
  5. JDBC 接続を設定します:
    • Name: 任意の名前（例: hubdb）
    • Database adapter: Generic
    • Driver class path: C:\Denodo\Denodo Platform\lib-external\jdbc-drivers\cdata-hubdb-19
    • Driver class: cdata.jdbc.hubdb.HubDBDriver

    • Database URI: 必要な接続プロパティを使用して JDBC URL を設定します。例:

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

      Database URI の作成方法は以下のとおりです:

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

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

      	java -jar cdata.jdbc.hubdb.jar

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

      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を取得したプライベートアプリケーショントークンに設定します。

  6. "Test connection" ボタンをクリックして設定を確認し、Save をクリックします。

VirtualPort Administrator ツールで HubDB のデータ を表示

データソースを作成したら、Denodo Platform で使用する HubDB のデータ のベースビューを作成できます。

  1. 新しく作成した VirtualPort (admin.HubDB) で "Create base view" ボタンをクリックします。
  2. オブジェクトツリーを展開し、インポートするオブジェクト（テーブル）を選択します。
  3. "Create selected" ボタンをクリックして、HubDB のデータ のビューを作成します。
    オプション: "Create associations from foreign keys" をクリックして、オブジェクト間のリレーションシップを定義できます。
  4. ビューが作成されたら、Server Explorer で対象テーブル（cdata_hubdb_northwindproducts）に移動し、選択したテーブルをダブルクリックします。
  5. 新しいタブで "Execution panel" をクリックしてクエリパネルを開きます。
  6. "Execute" タブでクエリをカスタマイズするか、デフォルトのクエリを使用します: 
    SELECT * FROM cdata_hubdb_northwindproducts CONTEXT ('i18n'='us_est', 'cache_wait_for_load'='true')
  7. Execute をクリックしてデータを表示します。

ベースビューの作成後は、Denodo Platform の他のデータソースと同様にライブ HubDB のデータ を扱うことができます。たとえば、Denodo Data Catalog で HubDB をクエリできます。

CData JDBC Driver for HubDB の 30日間無料トライアルをダウンロードして、Denodo Platform でライブ HubDB のデータ の活用を始めましょう。ご不明な点がございましたら、サポートチーム までお問い合わせください。

はじめる準備はできましたか？

HubDB Driver の無料トライアルをダウンロードしてお試しください：

 ダウンロード

詳細：

HubDB Icon HubDB JDBC Driver お問い合わせ

HubDB データと連携するパワフルなJava アプリケーションを短時間・低コストで作成して配布できます。

この記事の内容

関連記事