다음을 통해 공유


복제본 메타데이터에 액세스

Metadata Storage Service에서는 메타데이터의 두 그룹을 저장합니다. 하나는 전체 복제본을 나타내는 그룹이고, 다른 하나는 동기화할 개별 항목을 나타내는 그룹입니다. 이러한 두 그룹은 ReplicaMetadata(관리 코드의 경우) 또는 IReplicaMetadata(비관리 코드의 경우)를 통해 조작됩니다.

참고

  속성 변경 내용은 단순히 복제본 메타데이터 또는 항목 메타데이터 개체의 속성을 설정하여 메타데이터 저장소에 저장되지는 않습니다. 속성 변경 내용은 SaveReplicaMetadataSaveItemMetadata(관리 코드의 경우) 또는 IReplicaMetadata::SaveReplicaMetadataIReplicaMetadata::SaveItemMetadata(비관리 코드의 경우)를 통해 저장됩니다.

복제본 메타데이터

저장된 복제본 메타데이터에는 복제본 ID, 복제본의 틱 수, 복제본의 현재 정보 및 복제본의 잊어버린 정보가 포함되어 있습니다. 메타데이터 저장소에서는 복제본에 연결된 모든 공급자별 메타데이터를 저장하는 데 사용할 수 있는 사용자 지정 메타데이터 필드도 제공합니다. CustomReplicaMetadata 속성(관리 코드의 경우) 또는 IReplicaMetadata::SetCustomFieldMetadata 메서드(비관리 코드의 경우)를 사용하여 이 필드를 설정할 수 있습니다.

항목 메타데이터

항목 메타데이터에는 항목의 전역 ID, 현재 버전 및 생성 버전, 항목이 항목 저장소에서 삭제되었는지 여부를 나타내는 값, 복제본 메타데이터가 초기화되었을 때 지정된 사용자 지정 필드가 들어 있습니다. 복제본 메타데이터 개체는 새 항목 메타데이터를 만들거나, 항목 메타데이터를 삭제하거나, 항목의 전역 ID 또는 사용자 지정 필드 값에 따라 항목 메타데이터를 찾는 데 사용할 수 있는 메서드를 제공합니다.

관리 코드 항목 메타데이터는 ItemMetadata 개체로 나타냅니다. 인덱스 필드 값을 사용하여 항목을 검색하려면 FindItemMetadataByIndexedField에 필드 이름과 값을 전달합니다.

비관리 코드 항목 메타데이터는 IItemMetadata 개체로 나타냅니다. 인덱스 필드 값을 사용하여 항목을 검색하려면 IReplicaMetadata::CreateEmptyFieldValue를 사용하여 빈 IFieldValue 개체를 만듭니다. IFieldValue 개체에 검색할 값을 설정하고 IReplicaMetadata::FindItemMetadataByIndexedFields를 호출합니다.

Security note보안 참고

항목이 삭제된 것으로 표시되는 경우 사용자 데이터를 보호하려면 사용자 지정 인덱스 필드와 같은 모든 사용자 데이터를 해당 항목의 메타데이터에서 제거해야 합니다. 항목이 삭제된 것으로 표시되는 경우 Metadata Storage Service에서 해당 항목의 변경 단위 정보가 모두 자동으로 제거됩니다.

캐싱

복제본 메타데이터 및 항목 메타데이터와 개체에서는 해당 복제본이나 항목에 대한 메타데이터의 메모리 내 캐시를 사용합니다. 메타데이터 개체가 초기화될 때 캐시가 디스크에서 채워지며, 이후에는 새로 고쳐지지 않습니다. 따라서 다음과 같은 특정 조건에서는 메모리의 내용과 메타데이터 저장소 파일의 내용이 서로 다를 수 있습니다.

  • 메타데이터 개체에 대한 업데이트가 설정되었고 저장 메서드 중 하나를 통해 저장되었지만 디스크에 아직 기록되지 않은 경우(예: 명시적 트랜잭션이 커밋되지 않은 경우)

  • 같은 복제본 또는 항목에 대해 둘 이상의 메타데이터 개체가 만들어졌으며 인스턴스 중 하나에서 업데이트를 만들어 커밋한 경우. 이러한 경우 변경하지 않은 개체는 최신 상태가 아니며, 이 개체의 메타데이터를 가져오기 위해 호출하면 업데이트 전의 값이 반환됩니다.

참고 항목

참조

IReplicaMetadata 인터페이스
IItemMetadata 인터페이스
IFieldValue 인터페이스
ReplicaMetadata
ItemMetadata

기타 리소스

Sync Framework Metadata Storage Service