Google BigQueryコネクタ

最後の更新
PDFとして保存

重要 - 画像/情報は四半期ごとのリリースで更新されます!

四半期ごとのリリースにて、最新の機能・情報を反映し、画像を含めた情報は更新されます。

重要: Gainsight は、Horizon Experience を使用して Connectors 2.0 をアップグレードしています。この記事は、Horizon Experience for Connectors 2.0 にアップグレードされたテナントに適用されます。以前のバージョンでコネクタ 2.0 を使用している場合は、ここでドキュメントを参照できます。

この記事では、GainsightからBigQueryへの接続を作成する方法、データジョブを作成する方法、データセットをマージする方法、Gainsightでジョブチェーンまたはジョブチェーンを変換および構成する方法を管理者に説明します。

メモ: このドキュメントでは、ジョブごとにユースケースが異なり、独自の構成が必要なため、接続の作成とジョブのセットアップに関する一般的なガイダンスを提供します。ジョブ作成の詳細については、この記事の最後にある「その他のリソース」セクションの「ジョブリスト」ページを参照してください。

[概要]

Google BigQuery は、ビジネスの俊敏性を重視して設計された、サーバーレスで拡張性の高いクラウドデータウェアハウスです。ユーザーはGoogle BigQueryにデータセットを保存し、これらのデータセットをGainsight組織に統合できます。

GainsightとGoogle BigQueryの統合により、顧客データをGainsightの標準オブジェクト（会社/個人など）とカスタムオブジェクトに取り込むことができます。

この統合のメリット

Gainsightが提供するビジネスソリューションを、Google BigQueryのデータに基づいて導き出します。たとえば、更新管理、カスタマーヘルススコアリング、アドプションエクスプローラーを使用した使用状況データ分析などです。
GainsightのGoogle BigQueryデータに基づいて行動を促すフレーズ（CTA）を作成して、カスタマーサクセスチーム間の調整を行います。

Google BigQueryで認証情報を作成する

Google BigQuery の認証情報は、Gainsightが BigQuery データにアクセスできるようにするために使用されます。認証情報には、クライアント ID とクライアントシークレットが含まれます。これらは Gainsight の [管理] > [コネクタ 2.0] > [接続] ページから BigQuery 接続を作成するために必要なクライアント ID とクライアントキーです。

前提条件: 管理者または BigQuery プロジェクトへのアクセス権を持つユーザーは、Google BigQuery で証明書を作成できます。

Google BigQuery で認証情報を作成するには:

Google BigQuery インスタンスにログインします。
[API とサービス] > [認証情報] に移動します。認証情報ページが表示されます。

Image 1.jpg

[+認証情報を作成] をクリックし、[OAuth クライアント ID] を選択します。「OAuth クライアント ID の作成」ページが表示されます。

Image 2.jpg

[アプリケーションの種類] ドロップダウンから、[Web アプリケーション] を選択します。

Image 3.jpg

OAuth 2.0 クライアントの名前を入力します。
「承認済みリダイレクト URI」セクションで 「+URI を追加」をクリックし、Gainsight の組織の所在地に基づいて次の URL を入力します。

ヨーロッパ: https://eu-app.gainsight.com/v1.0/ap...tType=BIGQUERY
米国: https://app.gainsight.com/v1.0/api/a...tType=BIGQUERY

「作成」をクリックします。新しい認証情報は正常に作成されました。

Image 4.jpg

BigQuery の認証情報ページで認証情報名をクリックすると、次の図のようにクライアント ID とクライアントシークレットが表示されます。

Image 5.jpg

クライアントIDとクライアントシークレットをコピーして、GainsightがGoogle BigQuery接続を作成するときに使用します。

接続を作成

接続の作成は、それぞれのソースシステムからのデータをGainsightに同期するようにGainsightコネクタを設定するための最初のステップです。

Google ビッグクエリ接続を作成するには:

[管理] > [コネクタ 2.0] に移動します。
「接続を作成」をクリックします。[接続の作成] ダイアログが表示されます。
コネクタのドロップダウンリストから BigQuery を選択します。
次のフィールドに詳細を入力します。

接続の名前: 接続の名前を入力します。
プロジェクト ID: Google BigQuery で作成されたプロジェクトの ID を入力します。
データセット ID: Google BigQuery のプロジェクトで作成したデータセットの ID を入力します。
OAuth API キー: Google BigQuery から収集したクライアント ID を [API とサービス] > [認証情報] ページに入力します。
OAuth シークレットキー: Google BigQuery から収集したクライアントシークレットを [API とサービス] > [認証情報] ページに入力します。

[認証] をクリックして接続を検証します。

[承認] をクリックすると、BigQuery OAuth ページが表示され、BigQuery の認証情報を入力して承認を完了できます。

メモ: Gainsightは、OAuthで使用しているユーザーにアクセス権が付与されているフィールドにアクセスできますが、取得するのはジョブにマップされたフィールドだけです。

Google BigQueryでサービスアカウントを作成する

サービスアカウントは、Google Cloud プロジェクトに関連付けられた Google アカウントです。エンドユーザーの認証情報ではなく、サービスアカウントを使用して Gainsight の BigQuery コネクタを認証できます。

この認証を行うには、サービスアカウントユーザーを作成する必要があります。このユーザーの JSON キーファイルが認証に使用されます。

前提条件: BigQuery プロジェクトにアクセスできる管理者は、Google BigQuery でサービスアカウントを作成できます。

Google BigQuery でサービスアカウントを作成するには:

Google BigQuery インスタンスにログインします。
[IAM と管理] > [サービスアカウント] に移動します。「サービスアカウント」ページが表示されます。
[+ サービスアカウントを作成] をクリックします。「サービスアカウントの作成」ページが表示されます。
「サービスアカウント名」フィールドに、アカウントの名前を入力します。
[作成して続行] をクリックします。
ドロップダウンから必要なロールを選択します。

メモ: サービスアカウントユーザーには、BigQuery データ転送サービスエージェントと BigQuery データ閲覧者のロールが必要です。

「完了」をクリックします。新しく追加されたサービスアカウントは、サービスアカウントページに追加されます。

新しいサービスアカウントの秘密鍵の作成

各サービスアカウントは秘密鍵で構成されています。サービスアカウント認証情報APIは、この内部キーペアを使用してJSON Webトークン (JWT) を作成します。

プライベートキーを作成するには:

[IAM と管理] > [サービスアカウント] に移動します。[サービスアカウント] ページが表示されます。
上記のセクションで作成した目的のアカウントの電子メール ID をクリックします。これで、サービスアカウントの詳細ページが表示されます。
「KEYS」タブをクリックします。
[キーを追加] ボタンをクリックし、[新しいキーを作成] を選択します。[秘密鍵の作成] ウィンドウが表示されます。
JSON オプションを選択し、「作成」をクリックします。パソコンの確認ウィンドウに保存された秘密鍵が、システムにダウンロードされた JSON ファイルとともに表示されます。

サービスアカウント認証

これで、BigQuery 接続をサービスアカウントで承認できるようになりました。Gainsightアプリケーションでは、以下のアクションが実行されます。

前提条件: サービスアカウントユーザーには以下のロールが必要です。

BigQuery データ転送サービスエージェント
ビッグクエリデータビューア

サービスアカウントを認証するには:

[管理] > [コネクタ 2.0] に移動します。
「接続を作成」をクリックします。[接続の作成] ダイアログが表示されます。
コネクタのドロップダウンリストから BigQuery を選択します。
接続の名前を入力します。
「認証タイプ」セクションから、「サービスアカウント」を選択します。

メモ: サービスアカウントから Oauth 認証タイプに切り替えたら、接続を再検証します。

次のフィールドに詳細を入力します。

プロジェクト ID: Google BigQuery で作成されたプロジェクトの ID を入力します。
データセット ID: Google BigQuery のプロジェクトで作成したデータセットの ID を入力します。
指定されたフィールドにサービスアカウントキーファイル (json) をアップロードします。

メモ: この場合、ダウンロードしたのと同じ JSON ファイルを新しいサービスアカウントの秘密鍵として使用する必要があります。

「保存」をクリックします。

Image 6.jpg

これで、Gainsightアプリケーションのサービスアカウント認証プロセスは完了です。

コンテキストメニューオプション

接続を許可したら、必要に応じて次のコンテキストメニューオプションのいずれかを使用して接続を設定します。

接続を編集: このオプションを使用して、Google BigQuery 接続の詳細を変更します。
接続を再認証: 既存の接続が取り消されたり、Google BigQuery 組織の認証情報が変更されたりした場合は、このオプションを使用して Google BigQuery 接続を再認証し、新しい認証情報セットを指定します。

メモ: Google BigQuery 組織のパスワードを変更すると、Gainsightから Google BigQuery への接続が取り消されます。

承認を取り消す: このオプションを選択すると、Gainsightからの Google BigQuery との接続が取り消されます。
接続を削除: 関連するタスクチェーンとデータタスクが削除された場合は、Google BigQuery 接続を削除します。

ジョブの作成

管理者はジョブページからジョブを作成して、必要なソースオブジェクト (テーブルとビュー) のデータをGainsightと同期できます。データソースを選択すると、左側のペインの [データソース] フィールドにすべての BigQuery テーブルとビューが表示されます。ソースオブジェクトを準備画面にドラッグアンドドロップして、ジョブの作成を開始します。

メモ: 新しく作成したビューを Bigquery から Gainsight に同期するには、管理者が接続ページから BigQuery 接続を再認証する必要があります。

詳細については、この記事の最後にある「その他のリソース」セクションのタスクリストページを参照してください。

Image 8.jpg

接続内のデータジョブが相互に依存している場合は、ジョブチェーンを作成し、ジョブチェーンに合わせてスケジュールを設定します。詳細については、この記事の最後にある「その他のリソース」セクションの「タスクチェーン」ページを参照してください。

データセットの結合

2 つ以上のデータを集約して、出力データセットを作成できます。たとえば、Bitcoin Cryptocurrencyと会社のデータセットに関連するデータセットをマージして、各企業のトランザクションのリストを把握し、Company ARRなどの出力データセットを作成できます。マージの詳細については、この記事の最後にある「その他のリソース」セクションのタスクリストページを参照してください。

データ変換

コネクタジョブの準備段階では、管理者はデータを変換してケースフィールドを追加し、顧客データからより有意義な洞察を得ることができます。

ビジネスユースケース: Transform 関数は、新しいケースフィールドを作成または変更する機能を提供します。新しいケースフィールドを使用して、Gainsightデータモデルの消費要件に基づいて外部フィールドを変更できます。ケースフィールドは、ケース条件ごとに異なる値を入力するように定義できます。たとえば、「新規」、「オープン」、「クローズ」などの外部選択リストの値を、Gainsightの選択リストの値と一致するように「有効」と「非アクティブ」に変更できます。

目的地を追加

最終的な出力データセットが準備できたら、出力データセットに宛先を追加して、ソースからのデータをターゲットの Gainsight オブジェクトに同期できます。宛先を追加する方法の詳細については、この記事の最後にある「その他のリソース」の「ジョブリストページ」を参照してください。

ダイレクトマッピング

ダイレクトマッピングを使用して外部システムから Gainsight にデータを同期するには、外部システムのソースオブジェクトのフィールドを Gainsight のターゲットオブジェクトにマッピングする必要があります。データ同期は、設定されたフィールドマッピングに基づいて行われます。ダイレクトマッピングの詳細については、この記事の最後にある「その他のリソース」の「ジョブリストページ」を参照してください。

派生マッピング

(オプション) 派生マッピングを使用して、(GSID データ型の) オブジェクトのフィールドの値に、同じまたは別の標準 Gainsight オブジェクトの値を入力できます。これにはルックアップが使用され、ルックアップでは最大 6 つの列を照合できます。

メモ: 派生マッピングを使用するには、ターゲットオブジェクトに GSID のデータ型のフィールドが少なくとも 1 つ必要です。

派生マッピングの詳細については、この記事の最後にある「その他のリソース」の「タスクリストページ」を参照してください。

ジョブチェーン

ジョブチェーン機能を使用すると、特定の順序で実行する必要がある関連ジョブのグループをスケジュールするプロセスを簡略化できます。このシーケンスは、ジョブチェーンのスケジュールされた時間に基づいています。

たとえば、ジョブAとBが順番に並んでいる場合、「ジョブA」が完了するとすぐに「ジョブB」が自動的に開始されるため、ジョブを個別にスケジュールする必要はありません。

メモ: ジョブがジョブチェーンに追加された場合、個々のジョブスケジュールは無視され、ジョブチェーンのスケジュールが考慮され、ジョブはジョブチェーン内のジョブの順序に従って実行されます。

派生マッピングの詳細については、この記事の最後にある「その他のリソース」セクションの「タスクチェーン」ページを参照してください。

ジョブまたはジョブチェーンの設定

管理者は、タスクまたはタスクチェーンのスケジュールを準備した後に設定できます。

接続に複数のジョブが相互に依存している場合、Gainsightはジョブチェーンを作成してデータを順番に同期するオプションを提供しています。詳細については、この記事の最後にある「その他のリソース」セクションの「ジョブまたはジョブチェーンスケジュールの設定」を参照してください。

ジョブアクティビティ

アクティビティページでは、すべてのデータジョブの実行アクティビティと更新アクティビティを表示できます。このページからジョブのエラーログをダウンロードして、構成の問題を解決することもできます。詳細については、この記事の最後にある「その他のリソース」セクションの「アクティビティページ」記事を参照してください。