Zoho Analytics を使用してHubDB データをインポート

CData Connect Server を使用してZoho Analytics からHubDB に接続し、リアルタイムHubDB データをインポートします。

古川えりか
コンテンツスペシャリスト
最終更新日：2022-12-13

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

Zoho Analytics はモダンなBI およびアナリティクスプラットフォームであり、データに接続、分析したりビジュアライゼーションやダッシュボードを作成して意思決定につながるインサイトを発見できます。 CData Connect Server と組み合わせると、Zoho Analytics はレポートや分析のためにHubDB データにクラウドベースで即座にアクセスできます。 Connect Server を使用してHubDB に接続し、Zoho Analytics でダッシュボードを作成してHubDB データを分析する方法を紹介します。

CData Connect Server は、HubDB にクラウドベースのインターフェースを提供し、ネイティブにサポートされているデータベースにデータを複製することなく、Zoho Analytics でHubDB データの分析を実現します。 CData Connect Server は、最適化されたデータ処理により、サポートされているすべてのSQL 操作（フィルタ、JOIN など）をHubDB に直接プッシュし、サーバー側の処理を利用して要求されたHubDB データを高速で返します。

ホスティングについて

Zoho Analytics からCData Connect Server に接続するには、利用するConnect Server インスタンスをネットワーク経由での接続が可能なサーバーにホスティングして、URL での接続を設定する必要があります。CData Connect がローカルでホスティングされており、localhost アドレス（localhost:8080 など）またはローカルネットワークのIP アドレス（192.168.1.x など）からしか接続できない場合、Zoho Analytics はCData Connect Server に接続することができません。

クラウドホスティングでの利用をご希望の方は、AWS Marketplace やGCP Marketplace で設定済みのインスタンスを提供しています。

HubDB データの仮想データベースを作成する

CData Connect Server は、シンプルなポイントアンドクリックインターフェースを使用してデータソースに接続し、データを取得します。まずは、右側のサイドバーのリンクからConnect Server をインストールしてください。

Connect Server にログインし、「CONNECTIONS」をクリックします。
一覧から「HubDB」を選択します。
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を取得したプライベートアプリケーショントークンに設定します。
「 Test Connection」をクリックします。
「Permission」->「 Add」とクリックし、適切な権限を持つ新しいユーザー(または既存のユーザー) を追加します。

仮想データベースが作成されたら、Zoho Analytics を含むお好みのクライアントからHubDB に接続できるようになります。

CData Connect Server を使用してZoho Analytics からHubDB へ接続

Zoho Analytics からCData Connect Server への接続を確立するには、次の手順を実行します

Zoho Analytics にログインします。

新しい接続を作成し、Cloud Databases を選択して接続モーダルを開きます。

次の情報を入力します。
- Database Type - MS SQL Server を選択。
- Endpoint - CONNECT_SERVER_URL を入力。
- SQL Server Instance Name - 空欄のまま。
- Port - 1433 を入力。
- Username - CData Connect Server のユーザー名を入力。ユーザー名はCData Connect Server のインターフェースの右上に表示されています。例えば[email protected] です。
- Password - Connect Server ユーザーのパスワード。
- Database Name - 接続したいCData Connect Server データソースのConnection Name を入力。例えばHubDB1です。
- 「Next」をクリック。
NorthwindProducts など、インポートしたいテーブルを選択します。