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

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

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

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

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

   API キー認証の設定

   Vercel は Bearer トークン認証を使用します。API キーとして、パーソナルアクセストークンまたは OAuth アクセストークンのいずれかを使用できます。

   パーソナルアクセストークンを取得するには、以下のステップで進めます：

   1. https://vercel.com/ で Vercel アカウントにログインします
   2. Account Settings > Tokens に移動します。
   3. Create Token をクリックし、名前と有効期限を入力して Create をクリックします。
   4. 生成されたトークンをコピーします（一度しか表示されません）。

   トークンを取得したら、以下の接続プロパティを設定します：

   • AuthScheme：APIKey に設定します。
   • APIKey：Vercel のパーソナルアクセストークンまたは OAuth アクセストークンに設定します。

   接続文字列の例

   Profile=C:\profiles\Vercel.apip;AuthScheme=APIKey;APIKey=your_access_token;
   

   チームの利用

   Vercel のリソースの多くは、チームにスコープされています。すべてのリクエストを特定のチームにスコープするには、TeamId 接続プロパティにチームの ID を設定します。チーム ID は、Teams テーブルをクエリするか、Vercel ダッシュボードで確認できます。あるいは、サポートされている場合は SQL クエリの WHERE 句で TeamId を指定することもできます。

   Vercel への接続

   認証を設定すると、Vercel に接続して、Projects、Deployments、Teams、Domains などの利用可能なテーブルからデータをクエリできます。

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

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

   java -jar cdata.jdbc.api.jar
   

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

   

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

   jdbc:api:Profile=C:\profiles\Vercel.apip;AuthScheme=APIKey;APIKey=your_access_token;

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

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