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

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

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

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

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

   ドライバーはOAuth 2.0 のリソースオーナーパスワードクレデンシャル（ROPC）グラントを使用してSuadeo に認証します。認証は直接資格情報を使用して行われます。ブラウザーベースの認証フローやリフレッシュトークンはありません。

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

   • URL：Suadeo インスタンスのベースURL。
   • User：Suadeo のユーザー名。
   • Password：Suadeo のパスワード。
   • AuthenticationName：Suadeo インスタンスの認証設定の名前識別子。異なる環境やユースケースに対して異なる認証名を設定できます。

   接続すると、ドライバーは資格情報をSuadeo のOAuth トークンエンドポイントに送信してアクセストークンを受け取り、以降のすべてのリクエストに使用します。セッション中に必要に応じて新しいアクセストークンが自動的に取得されます。

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

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

   java -jar cdata.jdbc.suadeo.jar
   

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

   

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

   jdbc:suadeo:URL=https://mysuadeoinstance;User=username;Password=password;AuthenticationName=your_auth_name;

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

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