NetBeans で Gumroad のデータ に接続

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
データソース設定ウィザードを使用して NetBeans で Gumroad のデータ に接続。



CData JDBC Driver for Gumroad は、JDBC をサポートする IDE にリアルタイム Gumroad のデータ 接続を統合します。JDBC 標準により、ビルトインのデータアクセスウィザードや迅速な開発をサポートするその他のツールを使用できます。この記事では、NetBeans で Gumroad のデータ に接続する方法を説明します。接続を作成し、テーブルエディターで ロードを行います。

NetBeans で Gumroad 用の JDBC データソースを作成

JDBC データソースを作成するには、サービスウィンドウで Database ノードを展開し、Drivers ノードを右クリックして New Driver を選択します。表示される New Driver ウィザードで、以下の情報を入力します:

  • Driver File(s):Add をクリックし、表示されるファイルエクスプローラーダイアログで cdata.jdbc.api.jar ファイルを選択します。ドライバー JAR はインストールディレクトリの lib サブフォルダにあります。
  • Driver Class:Find をクリックして JAR 内のドライバークラスを検索します。次に、メニューから cdata.jdbc.api.APIDriver を選択します。
  • Name:ドライバーの名前を入力します。
JDBC ドライバー定義。(Salesforce の例)

接続パラメータの定義

以下の手順で、必要な接続プロパティを定義します:

  1. サービスウィンドウで Database ノードを右クリックし、New Connection をクリックします。

  2. New Connection Wizard で、以下の接続プロパティを入力します:

    • Driver Name:メニューから CData JDBC Driver for Gumroad を選択します。
    • User Name:ユーザー名を入力します。これは JDBC URL でも定義できます。
    • Password:パスワードを入力します。これは JDBC URL でも定義できます。
    • JDBC URL:JDBC URL を指定します。

      OAuth 認証の設定

      Gumroad への認証では、OAuth 2.0 標準を使って自分自身のデータに接続する場合はもちろん、他のユーザーが各自のデータに接続できるようにする場合にも利用できます。これが推奨される認証方式です。

      まず、Gumroad に OAuth アプリケーションを登録する必要があります。https://app.gumroad.com/settings/advanced の Gumroad アカウント設定にアクセスし、Applications セクションに移動して OAuth アプリケーションを作成できます。

      以下の接続プロパティを設定して接続を確立してください:

      • AuthScheme:OAuth に設定します。
      • InitiateOAuth:GETANDREFRESH に設定します。CData API Profile for Gumroad が OAuth プロセスを自動的に進め、アクセストークンを取得します。
      • OAuthClientID:アプリ設定で指定された client_id に設定します。
      • OAuthClientSecret:アプリ設定で指定された client_secret に設定します。
      • CallbackURL:アプリ設定で指定したリダイレクト URI に設定します。

      接続文字列の例

      Profile=C:\profiles\Gumroad.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;
      

      ビルトイン接続文字列デザイナー

      JDBC URL の作成には、Gumroad JDBC Driver にビルトインされている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。

      
      java -jar cdata.jdbc.api.jar
      

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

      ビルトイン接続文字列デザイナーで JDBC URL を生成。(Salesforce の例)

      一般的な JDBC URL は次のとおりです:

      jdbc:api:Profile=C:\profiles\Gumroad.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;
JDBC URL で定義された必須の接続プロパティ。(Salesforce の例)

Gumroad のデータ のクエリ

Gumroad のデータ に接続するには、Database ノードで接続を右クリックし、Connect をクリックします。接続が確立されたら、展開してスキーマ情報を確認できます。

Data Views ウィンドウにテーブルをロードするには、テーブルを右クリックして View Data をクリックします。。

NetBeans でのクエリ結果。(Salesforce の例)

はじめる準備はできましたか?

API Driver で Gumroad のライブデータに接続

Gumroad に接続