Pentaho Data Integration でGumroad のデータを連携

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
Pentaho Data Integration で Gumroad のデータ をベースにした ETL パイプラインを構築します。



CData API Driver for JDBC を使用すると、データパイプラインからリアルタイムデータにアクセスできます。Pentaho Data Integration は、ETL(Extraction, Transformation, and Loading)エンジンであり、データをクレンジングし、アクセス可能な統一フォーマットでデータを格納します。この記事では、Gumroad のデータ に JDBC データソースとして接続し、Pentaho Data Integration で Gumroad のデータ をベースにしたジョブやトランスフォーメーションを構築する方法を説明します。

Gumroad への接続を設定

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 を設定する際には、Max Rows 接続プロパティの設定も検討してください。これにより返される行数が制限され、レポートやビジュアライゼーションの設計時にパフォーマンスを向上させることができます。

一般的な 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;

接続文字列を保存して、Pentaho Data Integration で使用します。

Pentaho DI から Gumroad に接続

Pentaho Data Integration を開き、「Database Connection」を選択して CData API Driver for JDBC への接続を設定します。

  1. 「General」をクリックします。
  2. Connection name を設定します(例:Gumroad Connection)。
  3. Connection type を「Generic database」に設定します。
  4. Access を「Native (JDBC)」に設定します。
  5. Custom connection URL に Gumroad の接続文字列を設定します(例:
    jdbc:api:Profile=C:\profiles\Gumroad.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;
    )。
  6. Custom driver class name を「cdata.jdbc.api.APIDriver」に設定します。 JDBC Driver 接続の設定
  7. 接続をテストし、「OK」をクリックして保存します。 接続の保存

Gumroad のデータパイプラインを作成

CData JDBC Driver を使用して Gumroad への接続が設定されたら、新しいトランスフォーメーションまたはジョブを作成する準備が整いました。

  1. 「File」>>「New」>>「Transformation/job」をクリックします。
  2. 「Table input」オブジェクトをワークフローパネルにドラッグし、Gumroad 接続を選択します。 Table input オブジェクトの設定
  3. 「Get SQL select statement」をクリックし、Database Explorer を使用して利用可能なテーブルとビューを表示します。 データの選択(QuickBooks Online の例)
  4. テーブルを選択し、必要に応じてデータをプレビューして確認します。 データのプレビュー(QuickBooks Online の例)

ここから、適切な同期先を選択し、レプリケーション中にデータを変更、フィルタリング、その他の処理を行うトランスフォーメーションを追加することで、トランスフォーメーションまたはジョブを続行できます。

完成したトランスフォーメーション/ジョブ

無料トライアルと詳細情報

CData API Driver for JDBC の 30日間無料トライアルをダウンロードして、Pentaho Data Integration で Gumroad のデータ のリアルタイムデータを今すぐ活用しましょう。

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

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

Gumroad に接続