CData Tableau Connector for HubDB はじめに：インストールから接続まで

Dibyendu Datta
Dibyendu Datta
Lead Technology Evangelist
CData Tableau Connector for HubDB のインストール、ライセンス認証、接続設定の完全ガイドです。

このガイドでは、CData Tableau Connector for HubDB の使い方を詳しく解説します。コネクタのインストールとライセンス認証、初回接続の設定、そしてアプリケーションで HubDB のデータ を操作するための次のステップをご紹介します。

このセットアップガイドは、Tableau Desktop、Tableau Prep、および Tableau Server 環境に適用されます。

インストールとライセンス認証

CData Tableau Connector for HubDB を使用すると、Tableau Desktop、Tableau Prep、および Tableau Server からライブの HubDB のデータ に直接接続できます。このセクションでは、インストールの前提条件、プラットフォームサポート、コネクタのデプロイ、およびライセンス要件について詳しく説明します。

システム要件

このコネクタは、Tableau Desktop、Tableau Prep、または Tableau Server が利用可能な環境でサポートされています。CData Tableau Connector for HubDB は Windows と macOS の両方のプラットフォームをサポートしています。

オペレーティングシステムのサポート

Windows

  • Windows 10（64 ビット）
  • Windows 11（64 ビット）
  • Windows Server 2016、2019、または 2022（Tableau Server デプロイメント用）

macOS

  • macOS 10.14 以降

Tableau コンポーネント

  • Tableau Desktop 2020.3 以降（自動インストールの場合）、Tableau Desktop 2020.1 以降（手動登録の場合）
  • Tableau Prep Builder 2020.4.1 以降
  • Tableau Server 2020.1 以降

古いバージョンの Tableau を使用している場合は、代わりに CData ODBC Driver または JDBC Driver for HubDB をご利用ください。

ソフトウェアの依存関係

  • Java Runtime Environment（JRE）- 最新バージョンの Java が必要です

Tableau Connector のインストール

Windows

  1. CData Tableau Connector for HubDB をダウンロードします。
  2. インストーラーを実行し、インストールウィザードに従います。
  3. インストーラーがコネクタをデフォルトのインストールディレクトリにデプロイします：C:\Program Files\CData\CData Tableau Connector for HubDB 20XX
  4. Tableau Desktop 2020.3 以降をお使いの場合、セットアップによりコネクタが自動的に個人の Tableau リポジトリにインストールされます。
  5. インストールが完了したら、完了をクリックします。

Note：Tableau Prep または Tableau Desktop の古いバージョン（2020.3 より前）を使用している場合、セットアップは Tableau のインストールを検出できず、コネクタを手動で登録する必要があります（以下の手動登録を参照）。

macOS

  1. CData Tableau Connector for HubDB をダウンロードします。
  2. インストーラーパッケージを実行し、インストールウィザードに従います。
  3. インストーラーがコネクタを以下の場所にデプロイします：/Applications/CData Tableau Connector for HubDB 20XX
  4. Tableau Desktop 2020.3 以降をお使いの場合、セットアップによりコネクタが自動的に個人の Tableau リポジトリにインストールされます。
  5. インストールが完了したら、完了をクリックします。

手動登録（Tableau Desktop または Tableau Prep）

自動登録が行われなかった場合は、以下の手順に従ってください：

  1. コネクタのインストールディレクトリを確認します：
    • Windows：C:\Program Files\CData\CData Tableau Connector for HubDB 20XX
    • macOS：/Applications/CData Tableau Connector for HubDB 20XX
  2. Tableau リポジトリを確認します：
    • Windows：Documents\My Tableau Repository（Prep の場合は「My Tableau Prep Repository」）
    • macOS：/Users/[username]/Documents/My Tableau Repository
  3. コネクタのインストールディレクトリを開き、lib フォルダに移動します。
  4. cdata.hubdb.legacy.taco を Tableau リポジトリ内の Connectors ディレクトリにコピーします。

Note：Tableau Prep 21.2 以降のバージョンでは、レガシー .taco ファイルの代わりに標準 .taco ファイルがサポートされています。

ライセンスの認証

CData Tableau Connector for HubDB は、ライセンスキーによる認証ではなく、ファイルベースのライセンスを使用します。ライセンスファイルはインストールパッケージに含まれています。

含まれていない場合は、CData Orders チームからメールでライセンスキーを受け取っているはずです。ライセンスキーは次のような形式です：XXXX-XXXX-XXXX-XXXX-XXXX

ライセンス認証の手順

  1. コネクタのインストールディレクトリ内の lib フォルダに移動します：
    • Windows：C:\Program Files\CData\CData Tableau Connector for HubDB 20XX\lib
    • macOS：/Applications/CData Tableau Connector for HubDB 20XX/lib
  2. ライセンスファイルを確認します：cdata.tableau.hubdb.lic
  3. .lic ファイルをコネクタの JAR ファイル（cdata.tableau.hubdb.jar）と同じフォルダに配置します。

自動インストールプロセスでは、ドライバー JAR とライセンスファイルの両方を登録しようとします。JAR ファイルは以下のいずれかの場所にコピーされます：

  • Windows：C:\Users[username]\My Tableau Repository\Drivers
  • macOS：/Users/[username]/Documents/My Tableau Repository/Drivers

Note：試用版を実行している場合、試用版ライセンスファイルはインストーラーに含まれています。追加の認証手順は必要ありません。

Tableau Server へのデプロイ

Windows

  1. Tableau Server マシンに CData Tableau Connector for HubDB をインストールします。
  2. コネクタファイルを確認します：cdata.hubdb.taco
  3. .taco ファイルを Tableau Server のコネクタディレクトリにコピーします：[TableauServerRoot]\data absvc\vizqlserver\Connectors
    • ほとんどの場合、TableauServerRoot は「C:\ProgramData」の下にあります
  4. JAR ファイル（cdata.tableau.hubdb.jar）とライセンスファイル（cdata.tableau.hubdb.lic）が Tableau Server のドライバディレクトリにあることを確認します。
  5. Tableau Server を再起動します。

Linux

  1. setup.zip アーカイブを解凍します。「/opt/cdata/.hubdb」のようなディレクトリを作成することをお勧めします。
  2. インストールディレクトリの下の lib サブディレクトリに移動します。
  3. ライセンスツールを実行し、プロンプトに従ってライセンスファイルを生成します： 
    java -jar cdata.tableau.hubdb.jar -l
  4. cdata.tableau.hubdb.jar と cdata.tableau.hubdb.lic をドライバディレクトリにコピーします：/opt/tableau/tableau_driver/jdbc
  5. cdata.hubdb.taco をコネクタディレクトリにコピーします：/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Connectors
  6. Tableau Server を再起動します。

Note：java コマンドを実行できない場合は、Java Runtime Environment（JRE）をインストールする必要があります。

ライセンスに関するよくある質問

ライセンスは複数のマシンで使用できますか？

はい、サブスクリプションプランによります。注文確認メールを確認するか、アカウント担当者にお問い合わせください。アカウント担当者が不明な場合は、[email protected] までお問い合わせください。

ライセンスキーを紛失しました。どうすれば取得できますか？

注文番号を添えて [email protected] までメールでお問い合わせいただければ、ライセンスキーを再送いたします。

ライセンスを別のマシンに移行できますか？

はい。ライセンスを別のマシンに移行するには、以下のリンクからライセンス移行リクエストを送信する必要があります：

https://www.cdata.com/lic/transfer/

ライセンス移行リクエストが送信され、正常に処理されると、プロダクトキーにアクティベーションが追加され、別のマシンで正規ライセンスを認証できるようになります。このプロセスが完了すると、以前のマシンのライセンスは無効になります。

ライセンスに関するその他のご質問は、[email protected] までお問い合わせください。ライセンスの確認とアップグレードは、セルフサービスポータル portal.cdata.com から行えます。

接続設定

コネクタをインストールしたら、接続して HubDB のデータ のデータソースを作成できます。

以下の手順でデータに接続します：

  1. Tableau Desktop を開きます。
  2. 接続 > サーバーへで、その他...をクリックします
  3. HubDB by CData というデータソースを選択します。
  4. 接続に必要な情報を入力します。
  5. サインインをクリックします。

コネクタは、最も一般的な接続プロパティを Tableau で直接利用できるようにしています。ただし、より詳細な設定が必要な場合や接続の問題をトラブルシューティングする場合は、コネクタには Tableau の外部で接続を作成してテストできる別の接続ビルダーが含まれています。

接続ビルダーにアクセスするには 2 つの方法があります：

  • Windows では、スタートメニューの「CData Tableau Connector for HubDB」フォルダにある Connection Builder というショートカットを使用します。
  • ドライバーのインストールディレクトリ（デフォルトでは C:/Program Files/CData/CData Tableau Connector for HubDB）に移動し、lib ディレクトリの .jar ファイルを実行します。

接続ビルダーでは、接続プロパティの値を設定し、接続テストをクリックして動作を確認できます。また、クリップボードにコピーボタンを使用して接続文字列を保存することもできます。この接続文字列は、Tableau のコネクタ接続ウィンドウに含まれる接続文字列オプションに渡すことができます。

接続プロパティの設定

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

Tableau Desktop または Tableau Prep Builder で HubDB データを取得

HubDB のデータ への接続を確立したら、可視化するエンティティを設定できます：

  1. 可視化したいテーブルとビューを結合エリアにドラッグします。複数のテーブルを含めることができます。
  2. 今すぐ更新または自動更新を選択します：
    • 今すぐ更新では、データソースの最初の 10,000 行をプレビューできます（または、行テキストボックスに表示したい行数を入力します）。
    • 自動更新では、変更がプレビューエリアに自動的に反映されます。

Tableau Desktop でビジュアライゼーションを作成

データソースが設定されたら、ビジュアライゼーションを作成できます：

  1. ワークシートのタブをクリックします。
  2. カラムはデータ型に応じてディメンションとメジャーとしてリストされます。CData Tableau Connector はデータ型を自動的に検出するため、Tableau の強力なデータ処理およびビジュアライゼーション機能を活用できます。
  3. ディメンションまたはメジャーエリアからフィールドを行または列にドラッグします。Tableau が列または行のヘッダーを作成します。
  4. 表示形式タブからグラフの種類を選択します。
  5. Tableau が選択したグラフの種類を表示します。

カスタム SQL クエリを使用して、取得する HubDB のデータ をさらにカスタマイズすることもできます。データソースペインで新しいカスタム SQLをクリックし、SQL クエリを入力して HubDB から特定のデータを取得します。

Tableau Prep Builder でデータを準備

CData Tableau Connector for HubDB をインストールすると、Tableau Prep Builder でデータ準備フローを構築できます：

  1. Tableau Prep Builder を開き、データに接続をクリックします。
  2. コネクタリストで HubDB by CData を検索します。
  3. 認証情報を入力して接続を設定し、サインインをクリックします。コネクタは Login、OAuth、SSO 認証方法をサポートしています。
  4. 接続したら、接続ペインからフローキャンバスにテーブルをドラッグして、入力ステップとして追加します。
  5. Tableau Prep の組み込みツールを使用して、フィルター、計算フィールド、集計、ピボット、結合のステップを追加することで、HubDB のデータ をクリーニング、整形、変換します。
  6. 出力ステップを追加して、準備したデータを hyper エクストラクト、パブリッシュされたデータソース、または CSV ファイルとして保存します。

Tableau Prep Builder を使用すると、HubDB のデータ を結合、クレンジング、フィルタリング、集計して、再利用可能で反復可能なフローを作成できます。入力ステップを追加する際に新しいカスタム SQLをクリックして、フローに取り込む HubDB のデータ を定義するカスタム SQL クエリを使用することもできます。

よくある接続の問題

認証エラー

解決策： 資格情報が最新であることを確認してください。OAuth 認証の場合、HubDB の接続アプリ設定で CData を再認可する必要がある場合があります。ベーシック認証を使用している場合は、セキュリティトークンが有効であることを確認してください。パスワードを変更するとトークンをリセットする必要があります。認可のサポートについては [email protected] までお問い合わせください。

サーバーに接続できない

解決策： ファイアウォールとプロキシ設定を確認してください。HubDB エンドポイントへのアウトバウンド HTTPS（ポート 443）アクセスが許可されていることを確認してください。ProxyServer、ProxyPort、ProxyUser 接続プロパティを使用してプロキシ設定を構成できます。特定のポート要件については [email protected] までお問い合わせください。

コネクタが Tableau に表示されない

解決策： TACO ファイルが正しくインストールされていることを確認してください。Tableau Desktop 2020.3 以降の場合、インストーラーは自動的に「My Tableau Repository/Connectors」フォルダに配置します。手動インストールの場合は、コネクタの lib ディレクトリから「cdata.hubdb.legacy.taco」を Tableau の Connectors フォルダにコピーしてください。インストール後に Tableau を再起動してください。

接続に関するその他のトラブルシューティングについては、具体的なエラーメッセージを添えて [email protected] までお問い合わせください。

次のステップ

コネクタのインストール、ライセンス認証、接続設定が完了しました。以下のシナリオを参考に、Tableau Connector をさらに活用してみてください：

Tableau記事タイトル
Tableau PrepTableau Prep で HubDB データにリアルタイム接続してビジュアライズする方法
Tableau SetupCData Tableau Connector for HubDB はじめに：インストールから接続まで

インストールとライセンス

コネクタのインストールには管理者権限が必要ですか？

はい。CData Tableau Connector のインストールには管理者権限が必要です。インストーラーがシステムディレクトリに書き込み、必要なコンポーネントを登録するためです。

コネクタは Windows と Mac の両方で利用できますか？

はい。CData Tableau Connector for HubDB は Windows と macOS の両方のプラットフォームで利用できます。コネクタは Tableau のネイティブコネクタギャラリーに直接表示され、HubDB のデータ へのアクセスが効率化されます。

どのバージョンの Tableau がサポートされていますか？

CData Tableau Connector は Tableau Desktop 2020.3 以降および Tableau Prep Builder 2020.4.1 以降が必要です。古いバージョンの Tableau を使用している場合は、代わりに CData ODBC Driver または JDBC Driver for HubDB をご利用ください。

ライセンスファイルはどこに配置しますか？

インストールディレクトリの lib フォルダからバンドルされた .lic ファイル（cdata.tableau.hubdb.lic）をコネクタの JAR ファイルと同じフォルダに配置してください。

サポート

ご不明な点がございましたら、お気軽にお問い合わせください：

接続

接続ビルダーを使用して接続をテストできますか？

はい。コネクタには、Tableau の外部で接続を作成してテストできる別の接続ビルダーツールが含まれています。スタートメニューのショートカット（Windows）またはコネクタの lib ディレクトリの .jar ファイルを実行してアクセスします。接続テストボタンを使用して設定を検証します。

複数の HubDB アカウントに接続するにはどうすればよいですか？

Tableau で個別のデータソースを作成し、それぞれ異なる HubDB 資格情報で設定します。OAuth を使用する場合、各接続はそれぞれの HubDB アカウントでの認証を求めます。各データソースは独自の接続設定を個別に保存します。

プロキシサーバー経由で接続できますか？

はい。以下の接続プロパティを使用してプロキシ設定を構成できます：

  • ProxyServer：プロキシサーバーのホスト名または IP アドレス
  • ProxyPort：プロキシサーバーの TCP ポート
  • ProxyUser と ProxyPassword：必要な場合の認証資格情報
  • ProxyAuthScheme：認証スキーム（BASIC、DIGEST、NTLM など）

デフォルトでは、コネクタはシステムプロキシを使用します。別のプロキシを使用するには ProxyAutoDetect を false に設定します。SOCKS プロキシの場合は、FirewallServer、FirewallPort を使用し、FirewallType を SOCKS5 に設定します。

必要なプロパティとサポートされているプロキシシナリオについては、ドキュメントの Firewall & Proxy セクションを参照してください。

パフォーマンスとトラブルシューティング

クエリが遅いのはなぜですか？

以下を確認してください：

  • 大規模なデータセットや複雑な変換を行う場合は、エクストラクトモードを使用してください。エクストラクトモードはデータをローカルにキャッシュし、ライブ API 呼び出しの回数を減らします。
  • ライブ接続はリアルタイムデータが必要な場合のみ使用してください。すべてのクエリが HubDB にリアルタイムで送信されます。
  • 読み込み前にデータセットのサイズを削減するため、Tableau でフィルターを適用してください。
  • 必要なカラムのサブセットのみ必要な場合は、すべてのカラムを選択しないでください - 必要なテーブル/フィールドのみをドラッグしてください。
  • HubDB API の制限を監視してください。パフォーマンスが制限される場合があります。
  • 集計操作を HubDB サーバーにプッシュするには ServerSideAggregation を有効にしてください。

クエリ最適化とベストプラクティスについては [email protected] までお問い合わせください。

トラブルシューティング用のログを有効にするにはどうすればよいですか？

ログは、接続ビルダーまたは Tableau のコネクタ接続プロパティで有効にできます。

以下のプロパティを設定します：

  • Logfile：ログファイルの名前と場所を指定するファイルパス（例：C:\logs[rootadoname|tolower].log）
  • Verbosity：ログの詳細度を決定する数値（1-5）
  • MaxLogFileSize：最大ログファイルサイズ（デフォルトは 100 MB）
  • MaxLogFileCount：保持する最大ログファイル数

Verbosity レベル：

  • 1 - エラーのみ（通常運用時に推奨）
  • 2 - 警告とエラー
  • 3 - リクエスト/レスポンスの本文を含む情報メッセージ
  • 4-5 - バイナリ転送データを含むデバッグレベルの詳細

Note：通常運用時は Verbosity を 1 より大きく設定しないでください。高い Verbosity レベルでは大量のデータがログに記録され、実行時間が遅くなる可能性があります。Verbosity 3 以上では機密情報がキャプチャされる可能性があります。

分析のために [email protected] にお問い合わせの際は、ログファイルをアップロードしてください。

コネクタにはどのポートへのアクセスが必要ですか？

ほとんどの HubDB 接続では、アウトバウンド HTTPS（ポート 443）アクセスが必要です。ファイアウォールで HubDB エンドポイントへのアウトバウンドセキュアトラフィックを許可していることを確認してください。

プロキシや追加のセキュリティレイヤーを使用している環境では、コネクタドキュメントの Firewall & Proxy セクションを参照してください。

コネクタを Linux コンテナや Docker で使用できますか？

はい、いくつかの考慮事項があります。CData Tableau Connector for HubDB は Tableau Server デプロイメント用に Linux で使用できます。

Linux 上の Tableau Server の場合：

  1. コネクタファイルを「/opt/tableau/connectors」または「/var/opt/tableau_server/data/tabsvc/vizqlserver/Connectors/」にコピーします。
  2. lib サブディレクトリでライセンスツールを実行してライセンスファイルを生成します。
  3. Tableau Server を再起動します。

Note：Tableau Desktop は Windows と macOS でのみ動作します。Tableau Cloud への接続については、CData Connect Cloud をご利用ください。

一般

サポートされている SQL 操作の完全なリストはどこで確認できますか？

HubDB コネクタドキュメントの SQL Compliance セクションを参照してください。コネクタは、フィルタリング、GROUP BY、JOIN、集計を含む包括的な ANSI-92 SQL をサポートしています。コネクタはサポートされている SQL 操作を HubDB に直接プッシュし、サポートされていない操作にはクライアント側の処理用の組み込み SQL エンジンを使用します。

Tableau のライブ接続とエクストラクトの違いは何ですか？

ライブ接続：すべてのインタラクションで HubDB をリアルタイムでクエリします。最新のデータ精度が必要なダッシュボードに最適です。API 呼び出しにより大規模なデータセットでは速度が遅くなる場合があります。

エクストラクト：Tableau の高パフォーマンスデータエンジンでデータのローカルスナップショットを作成します。大規模なデータセット、複雑な計算、またはオフラインで作業する場合に最適です。更新をスケジュールしてデータを最新に保ちます。API 呼び出しを減らし、パフォーマンスを向上させます。

コネクタはどのくらいの頻度で更新されますか？

CData は Tableau Connector のメジャーアップデートを毎年リリースし、必要に応じて定期的なメンテナンスアップデートを行います。最新バージョンについては、CData アカウントポータルを確認するか、[email protected] までお問い合わせください。

このコネクタで Tableau のカスタム SQL を使用できますか？

はい。カスタム SQL クエリを使用して、取得する HubDB のデータ をさらにカスタマイズできます。データソースペインで新しいカスタム SQL をクリックし、SQL クエリを入力します。コネクタは標準 SQL 構文をサポートし、クエリを変換して HubDB からデータを取得します。

この FAQ で解決しない場合は、[email protected] までお問い合わせください。

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

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

 ダウンロード

詳細：

HubDB Icon HubDB Tableau Connector お問い合わせ

最速かつ手軽なTableau とHubDB のデータ連携。ハイパフォーマンスなデータ接続、リアルタイム連携、包括的なメタデータ検索、SQL-92 サポートを提供します。

この記事の内容

関連記事