複数Gumroad アカウントをレプリケーション
CData Sync for API は、データベースにサンドボックスや製品インスタンスをレプリケートするなどの、レプリケーションの多様なシナリオに対する解決策を提供するスタンドアロンアプリケーションです。Sync for Windows およびSync for Java はどちらもコマンドラインインターフェース(CLI)を含んでおり、複数のGumroad 接続を簡単に管理できます。この記事では、CLI を使って複数のGumroad アカウントをレプリケートする方法について説明します。
Gumroad 接続の構成
接続およびE メール通知設定をXML 設定ファイルに保存できます。複数のGumroad アカウントをレプリケートするには、複数の設定ファイルを使います。以下にGumroad をSQLite にレプリケートする設定例を示します。
Windows
<?xml version="1.0" encoding="UTF-8" ?>
<CDataSync>
<DatabaseType>SQLite</DatabaseType>
<DatabaseProvider>System.Data.SQLite</DatabaseProvider>
<ConnectionString>Profile=C:\profiles\Gumroad.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;</ConnectionString>
<ReplicateAll>False</ReplicateAll>
<NotificationUserName></NotificationUserName>
<DatabaseConnectionString>Data Source=C:\my.db</DatabaseConnectionString>
<TaskSchedulerStartTime>09:51</TaskSchedulerStartTime>
<TaskSchedulerInterval>Never</TaskSchedulerInterval>
</CDataSync>
Java
<?xml version="1.0" encoding="UTF-8" ?>
<CDataSync>
<DatabaseType>SQLite</DatabaseType>
<DatabaseProvider>org.sqlite.JDBC</DatabaseProvider>
<ConnectionString>Profile=C:\profiles\Gumroad.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;</ConnectionString>
<ReplicateAll>False</ReplicateAll>
<NotificationUserName></NotificationUserName>
<DatabaseConnectionString>Data Source=C:\my.db</DatabaseConnectionString>
</CDataSync>
OAuth 認証を使用する
Gumroad に認証し、自身のデータに接続する、または他のユーザーが自身のデータに接続できるようにするには、OAuth 2.0 標準を使用できます。これは推奨される認証方式です。
まず、Gumroad で OAuth アプリケーションを登録する必要があります。OAuth アプリケーションは、https://app.gumroad.com/settings/advanced の Gumroad アカウント設定にアクセスし、Applications セクションに移動して作成できます。
次に、以下を設定します。
- AuthScheme:OAuth に設定します。
- InitiateOAuth:GETANDREFRESH に設定します。CData API Profile for Gumroad が、アクセストークンを取得するための OAuth プロセスを自動的に実行します。
- OAuthClientID:アプリ設定で指定されている client_id を設定します。
- OAuthClientSecret:アプリ設定で指定されている client_secret を設定します。
- CallbackURL:アプリ設定で指定したリダイレクト URI を設定します。
各Gumroad インスタンスにクエリを設定
Sync を使うと標準SQL でレプリケーションを制御できます。REPLICATE ステートメントはハイレベルなコマンドで、データベースにテーブルをキャッシュして維持します。Gumroad API がサポートするあらゆるSELECT クエリを定義できます。下記のステートメントは、Gumroad のデータ のテーブルをキャッシュしてインクリメンタルに更新します。
REPLICATE CustomFields;
特定のデータベースを更新するために使用するレプリケーションクエリを含むファイルを指定することができます。レプリケーションステートメントはセミコロンで区切ります。次のオプションは、複数のGumroad アカウントを同じデータベースにレプリケートする場合に便利です。
REPLICATE SELECT ステートメントでは、異なるテーブルのプレフィックスを使用できます。
REPLICATE PROD_CustomFields SELECT * FROM CustomFields
異なるスキーマを使用することもできます。
REPLICATE PROD.CustomFields SELECT * FROM CustomFields
Sync の実行
接続文字列およびレプリケーションクエリの設定が完了したら、次のコマンドラインオプションを使ってSync を実行できます。
Windows
APISync.exe -g MyProductionAPIConfig.xml -f MyProductionAPISync.sql
Java
java -Xbootclasspath/p:c:\sqlitejdbc.jar -jar APISync.jar -g MyProductionAPIConfig.xml -f MyProductionAPISync.sql