CData Sync CLI で Azure Active Directory のデータ を複数のデータベースにレプリケーションする方法

常時稼働のアプリケーションには、自動フェイルオーバー機能とリアルタイムのデータアクセスが欠かせません。CData Sync for Azure Active Directory を使えば、ミラーリングデータベース、常時稼働のクラウドデータベース、レポーティングサーバーなど、さまざまなデータベースにAzure Active Directory のデータをリアルタイム連携できます。Windows やJava が動作するあらゆるマシンから、リモートのAzure Active Directory のデータとの自動同期が可能です。

Sync のコマンドラインインターフェース（CLI）を使えば、レプリケーションのほぼすべての設定を簡単に制御できます。設定を変更することなく、Azure Active Directory のデータ を1つまたは複数のデータベースにレプリケーションすることが可能です。

Azure Active Directory のデータ に接続する

接続文字列やメール通知などの設定は、XML 設定ファイルに保存できます。

以下は、SQLite へレプリケーションする場合の設定例です。

Windows

<?xml version="1.0" encoding="UTF-8" ?>
<CDataSync><DatabaseType>SQLite</DatabaseType>
  <DatabaseProvider>System.Data.SQLite</DatabaseProvider>
  <ConnectionString>OAuthClientId=MyApplicationId;OAuthClientSecret=MySecretKey;CallbackURL=http://localhost:33333;</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>OAuthClientId=MyApplicationId;OAuthClientSecret=MySecretKey;CallbackURL=http://localhost:33333;</ConnectionString>
<ReplicateAll>False</ReplicateAll>
<NotificationUserName></NotificationUserName>
<DatabaseConnectionString>Data Source=C:\my.db</DatabaseConnectionString>
</CDataSync>

Azure Active Directory は、Entra ID（Azure AD）、Azure サービスプリンシパル、またはManaged Service Identity（MSI）による認証をサポートします。 認証手順は、ヘルプドキュメントの「Azure Active Directory への認証」セクションを参照してください。

レプリケーションクエリの設定

Sync では、標準 SQL を使ってレプリケーションを制御できます。REPLICATE 文は、データベース内のテーブルをキャッシュして維持するための高レベルコマンドです。 Azure Active Directory API がサポートする任意の SELECT クエリを定義できます。 以下の文は、Azure Active Directory のデータ のテーブルをキャッシュし、差分更新を行います：

REPLICATE Domains;

レプリケーションクエリを含むファイルを指定することもできます。これにより、同じレプリケーションクエリを使って複数のデータベースへレプリケーションできます。

Sync を実行する

接続文字列とレプリケーションクエリを設定したら、以下のコマンドラインオプションで Sync を実行できます：

Windows

AzureADSync.exe -g MySQLiteConfig.xml -f AzureADSync.sql

Java

java -Xbootclasspath/p:c:\sqlitejdbc.jar -jar AzureADSync.jar -g MySQLiteConfig.xml -f AzureADSync.sql