メタデータの要件

レプリカ ID

同期コミュニティにおけるレプリカの一意の識別子。レプリカ ID はフレキシブル ID であるため、コミュニティのスキーマによって定義することが可能です。16 バイトの GUID をお勧めします。Sync Framework のメソッドに渡されるレプリカ ID の形式は、プロバイダによって指定された形式と一致している必要があります。

マネージ コード : 形式は SyncIdFormatGroup クラスの ReplicaIdFormat プロパティによって指定されます。ID は SyncId クラスで表されます。

アンマネージ コード : 形式は ID_PARAMETERS 構造体 構造体の replicaId フィールドによって指定されます。ID は SYNC_ID 構造体で表されます。

レプリカ キー マップ

レプリカ ID と 4 バイト キーのマッピング。メタデータではレプリカ ID (16 バイトの GUID を推奨) が繰り返し出現するため、テーブルを使用して、より小さい 4 バイトのキーにマップすることによって、レプリカ ID を表現した方が効率的です。これらのキーは、他の場所で特定のレプリカへの参照が必要になったときに使用されます。

マネージ コード : ReplicaKeyMap を使用して表されます。

アンマネージ コード : IReplicaKeyMap を使用して表されます。

忘れられたナレッジ

パートナー レプリカが、削除された項目について把握していない場合に、その事実を検出できるようにします。たとえば、項目の廃棄標識がクリーンアップされた場合に、このようなことが起こります。忘れられたナレッジは、メタデータ サービスを通じて操作されます。

マネージ コード : ForgottenKnowledge を使用して表されます。

アンマネージ コード : IForgottenKnowledge を使用して表されます。

廃棄標識ログ

レプリカからの項目の削除に関する情報を保存するログ。削除変更を同期コミュニティに正しく反映し、削除された項目が意図せずに再挿入されることを防ぎます。レプリカには、廃棄標識ログが維持される必要があります。廃棄標識ログの表現はレプリカによって決定され、必ずしもこのログへのアクセス権を Sync Framework に与える必要はありません。

グローバル ID

レプリカに格納されている項目の識別子。グローバル ID はレプリカによって生成されます。したがって、レプリカでは、列挙がより効率的になるようなグローバル ID を割り当てることができます。たとえば、コミュニティでは、そのグローバル ID を 8 バイトのプレフィックスを持つ GUID 形式として定義できます。さらに、このプレフィックスを使用すれば、グローバル ID の並べ替え順序を制御することが可能です。これにより、プロバイダは、範囲に基づいて容易に変更を列挙できるようになります。項目を順序付けされたグループとして表現すると、1 つの範囲に多数の項目を含めることができるため、ナレッジの構造がよりコンパクトになります。グローバル ID の形式の詳細については、「フレキシブル ID」を参照してください。

マネージ コード : 形式は SyncIdFormatGroup クラスの ItemIdFormat プロパティによって指定されます。ID は SyncId クラスで表されます。

アンマネージ コード : 形式は ID_PARAMETERS 構造体 構造体の itemId フィールドによって指定されます。ID は SYNC_ID 構造体で表されます。

作成バージョン

項目が作成された時点のバージョン。作成バージョンには、項目を作成したレプリカのキーと、項目が作成されたときのレプリカのティック数が含まれています。

マネージ コード : SyncVersion で表されます。

アンマネージ コード : SYNC_VERSION で表されます。

グローバル ID

24 (GUID + 8 バイトのプレフィックス)

作成バージョン

12 (4 バイトのレプリカ キー + 8 バイトのティック数)