Coginiti Pro からリアルタイムHubDB のデータにアクセス

Dibyendu Datta
Dibyendu Datta
Lead Technology Evangelist
SQL アナリティクスツール「Coginiti Pro」のGUI を使用してHubDB のデータに接続し、クエリを実行します。

Coginiti Pro は、データエンジニア、アナリスト、データサイエンティスト向けに設計された SQL データおよびアナリティクスのための統合ツールです。CData JDBC Driver for HubDBと組み合わせることで、Coginiti Pro からリアルタイムでHubDB のデータにアクセスしてクエリを実行できます。この記事では、Coginiti Pro からHubDB のデータに接続してクエリを実行する方法を説明します。

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

接続プロパティの取得と接続文字列の作成

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

NOTE: Coginiti Pro で JDBC ドライバーを使用するには、ライセンス（製品版またはトライアル版）とランタイムキー（RTK）が必要な場合があります。ライセンス（またはトライアル）の取得について詳しくは、営業チームまでお問い合わせください。

組み込みの接続文字列デザイナー

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

java -jar cdata.jdbc.hubdb.jar

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

HubDB のデータ用の JDBC データソースを作成

  1. Coginiti Pro を開き、File メニューから「Edit Drivers」を選択します。
  2. 表示されたウィザードで「Add」をクリックし、「Generic」を選択します。

  3. 「JDBC Drivers」ウィザードで、以下のドライバープロパティを設定し、「Create Driver」をクリックします。

    • JDBC Driver Name に「CData JDBC Driver for HubDB」などのわかりやすい名前を設定します。
    • 「Add Files」をクリックして、インストールディレクトリの「lib」フォルダから JAR ファイル（例：cdata.jdbc.hubdb.jar）を追加します。
    • Class Name で cdata.jdbc.hubdb.HubDBDriver を選択します。

CData JDBC Driver for HubDBを使用した接続の作成

  1. File メニューから「Edit Connections」をクリックします。
  2. 表示されたウィザードで「Add」をクリックし、「Generic」を選択します。
  3. 「Connections」ウィザードで、接続プロパティを設定します。
    • Connection name に識別しやすい名前を設定します。
    • Database JDBC driver に先ほど設定したドライバーを設定します。
    • JDBC URL に組み込みの接続文字列デザイナーで設定した JDBC URL を設定します（例：jdbc:hubdb:AuthScheme=OAuth;OAuthClientID=MyOAuthClientID;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;）。
  4. 「Test」をクリックして接続が正しく設定されていることを確認します。「Save」をクリックします。

SQL でHubDBにクエリを実行

  1. データベースアイコン（）をクリックして Connections タブを開きます。
  2. プラス記号（）をクリックして新しいクエリタブを追加します。

  3. クエリコンソールが開いたら、実行する SQL スクリプトを記述し、「Run at Cursor」をクリックします。

    NOTE: 左側のエクスプローラーを使用して、テーブル／ビュー名やカラム名を確認できます。

    エクスプローラーの使用方法

    1. 「Select connection」フィールドで、クエリを実行する接続を選択します。
    2. 作成した接続を展開し、「CData」カタログを展開してから、HubDBカタログを展開します。
    3. 「Tables」または「Views」を展開して、クエリを実行するエンティティを見つけます。
    4. 選択したエンティティを展開して、フィールド（カラム）を確認します。

無料トライアルと詳細情報

CData JDBC Driver for HubDBの30日間の無料トライアルをダウンロードして、Coginiti Pro でリアルタイムHubDB のデータを活用してください。ご質問がございましたら、サポートチームまでお問い合わせください。

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

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

 ダウンロード

詳細：

HubDB Icon HubDB JDBC Driver お問い合わせ

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

この記事の内容

関連記事