複数CouchDB アカウントをレプリケーション
CData Sync for ApacheCouchDB は、データベースにサンドボックスや製品インスタンスをレプリケートするなどの、レプリケーションの多様なシナリオに対する解決策を提供するスタンドアロンアプリケーションです。Sync for Windows およびSync for Java はどちらもコマンドラインインターフェース(CLI)を含んでおり、複数のCouchDB 接続を簡単に管理できます。この記事では、CLI を使って複数のCouchDB アカウントをレプリケートする方法について説明します。
CouchDB 接続の構成
接続およびE メール通知設定をXML 設定ファイルに保存できます。複数のCouchDB アカウントをレプリケートするには、複数の設定ファイルを使います。以下にCouchDB をSQLite にレプリケートする設定例を示します。
Windows
<?xml version="1.0" encoding="UTF-8" ?> <CDataSync> <DatabaseType>SQLite</DatabaseType> <DatabaseProvider>System.Data.SQLite</DatabaseProvider> <ConnectionString>Url=http://localhost:5984;User=abc123;Password=abcdef;</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>Url=http://localhost:5984;User=abc123;Password=abcdef;</ConnectionString> <ReplicateAll>False</ReplicateAll> <NotificationUserName></NotificationUserName> <DatabaseConnectionString>Data Source=C:\my.db</DatabaseConnectionString> </CDataSync>
Apache CouchDB 接続プロパティの取得・設定方法
それでは、Apache CouchDB に接続していきましょう。Url 接続プロパティをApache CouchDB インスタンスのURL に設定します。例:http://localhost:5984
ユーザー(またはJWT)が特定のデータベースだけにアクセスできるようにしたい場合は、Apache CouchDB インスタンスで"admin_only_all_dbs" オプションを設定し、テーブルをリストするためにCData 製品が必要とする"/_all_dbs" エンドポイントへのアクセス権をすべてのユーザーに付与する必要があります。
Apache CouchDB への認証
続いて、認証方法を設定しましょう。CData 製品では、3種類の認証をサポートしています。
- Basic:基本的なユーザー名 / パスワード認証
- JWT:JWT 認証
- None:パブリックなデータベースへの匿名アクセス
Basic 認証
データに接続するには、以下のプロパティを設定してください。
- AuthScheme:Basic
- User:認証に使用されるApache CouchDB ユーザーアカウント
- Password:認証するユーザーに関連付けられたApache CouchDB パスワード
その他の認証方法については、ヘルプドキュメントの「接続の確立」セクションをご確認ください。
各CouchDB インスタンスにクエリを設定
Sync を使うと標準SQL でレプリケーションを制御できます。REPLICATE ステートメントはハイレベルなコマンドで、データベースにテーブルをキャッシュして維持します。CouchDB API がサポートするあらゆるSELECT クエリを定義できます。下記のステートメントは、CouchDB のデータ のテーブルをキャッシュしてインクリメンタルに更新します。
REPLICATE Movies;
特定のデータベースを更新するために使用するレプリケーションクエリを含むファイルを指定することができます。レプリケーションステートメントはセミコロンで区切ります。次のオプションは、複数のCouchDB アカウントを同じデータベースにレプリケートする場合に便利です。
REPLICATE SELECT ステートメントでは、異なるテーブルのプレフィックスを使用できます。
REPLICATE PROD_Movies SELECT * FROM Movies
異なるスキーマを使用することもできます。
REPLICATE PROD.Movies SELECT * FROM Movies
Sync の実行
接続文字列およびレプリケーションクエリの設定が完了したら、次のコマンドラインオプションを使ってSync を実行できます。
Windows
ApacheCouchDBSync.exe -g MyProductionApacheCouchDBConfig.xml -f MyProductionApacheCouchDBSync.sql
Java
java -Xbootclasspath/p:c:\sqlitejdbc.jar -jar ApacheCouchDBSync.jar -g MyProductionApacheCouchDBConfig.xml -f MyProductionApacheCouchDBSync.sql