DBArtisan で Gong のデータ を JDBC データソースとして管理

CData JDBC Driver for Gong を使えば、Gong のデータ をデータベースとしてアクセスできるようになり、DBArtisan などのデータベース管理ツールとシームレスに連携できます。この記事では、DBArtisan で Gong の JDBC データソースを作成する方法を説明します。一度接続すれば、データを視覚的に編集したり、標準 SQL を実行したりすることができます。

Gong のデータ を DBArtisan プロジェクトに統合

以下のステップに従って、プロジェクトに Gong のデータ をデータベースインスタンスとして登録します。

1. DBArtisan で、Data Source -> Register Datasource をクリックします。
2. Generic JDBC を選択します。
3. Manage をクリックします。
4. 表示されたダイアログで、New をクリックします。ドライバーの名前を入力し、Add をクリックします。次に表示されるダイアログで、ドライバー JAR ファイルを指定します。ドライバー JAR はインストールディレクトリの lib サブフォルダ内にあります。
5. Connection URL ボックスに、資格情報やその他の必要な接続プロパティを JDBC URL 形式で入力します。

   Gong への認証では、Gong の API Key と API Secret を使った API キー認証を利用できます。

   認証

   Gong への認証では、Gong の API Key と API Secret、およびテナントの Domain を指定する必要があります。これらの認証情報は結合され、Base64 エンコードされて、すべての API リクエストで使われる Basic 認証ヘッダーを形成します。

   API キー認証の設定

   API キーで認証するには、Gong のアカウント設定から API Key と API Secret を取得します。

   取得したら、AuthScheme を APIKey に設定し、認証情報を指定して接続します：

   • AuthScheme：APIKey に設定します。
   • APIKey：Gong の API Key に設定します。
   • APISecret：Gong の API Secret に設定します。
   • Domain：Gong のテナントドメインに設定します（例：us-36533.api.gong.io）。

   接続文字列の例

   Profile=C:\profiles\Gong.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_key;APISecret=your_api_secret;Domain=your-tenant.api.gong.io';
   

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

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

   java -jar cdata.jdbc.api.jar
   

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

   

   一般的な接続文字列は以下のとおりです。

   jdbc:api:Profile=C:\profiles\Gong.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_key;APISecret=your_api_secret;Domain=your-tenant.api.gong.io';

6. ウィザードを完了して、Gong のデータ に接続します。Gong エンティティが Datasource Explorer に表示されます。

これで、他のデータベースと同じように Gong のデータ を操作できます。 Gong API でサポートされるクエリの詳細については、ドライバーのヘルプドキュメントを参照してください。