Device Sync로 Atlas 데이터 보기
이 페이지의 내용
Realm Studio 에서 Device Sync 를 통해 MongoDB Atlas 에 연결할 수 있습니다. Realm Studio 는 Device Sync 를 사용하는 애플리케이션 과 유사한 동기화 클라이언트 역할을 합니다. 다음을 수행할 수 있습니다.
포커스가 있는 객체 스키마에서 구독을 추가 및 제거합니다.
Realm Studio에서 직접 Atlas 데이터와 상호 작용합니다.
Realm Studio 를 사용하여 개발 실행 앱 을 실행할 때 데이터에 대한 변경 사항을 확인하거나 권한 및 구독 변경을 실험해 볼 수 있습니다.
전제 조건
최소 Realm Studio 버전: 14.1.2.
Device Sync 는 Realm Studio 앱을 통해 를 Atlas App Services 백엔드에 Atlas App Services 연결하므로 시작하기 전에 다음을 수행해야 합니다.
인증 이 활성화된 Atlas App Services 앱. 방법을 학습 보려면 App Services 문서에서 App Services App 만들기 를 참조하세요.
App Services App ID 입니다. 앱 ID를 찾는 방법을 학습 보려면 앱 ID ID 를 참조하세요.
Realm Studio는 다음과 같은 인증 제공자 유형을 사용하여 Device Sync를 통해 연결할 수 있습니다.
익명
이메일 & 비밀번호
API 키
JSON web token
앱에서 이메일 및 비밀번호, API 키 또는 JSON 웹 토큰 인증을 사용하는 경우 Realm Studio 에서 연결할 때 사용할 적절한 유형의 자격 증명을 만들어야 합니다. 자격 증명 생성에 대한 자세한 내용은 Atlas App Services 설명서를 참조하세요.
Realm Studio 에서 Atlas 에 연결
동기화할 데이터 지정
Atlas 에 연결하면 Realm Studio 에 App Services App 의 스키마와 일치하는 객체 유형 목록이 표시됩니다.
App Services 스키마에 대한 자세한 내용은 App Services 설명서의 스키마를 참조하세요.
Realm Studio는 이러한 스키마를 Realm 객체에 매핑합니다. Device Sync를 사용하여 이러한 스키마를 Realm 객체에 매핑하는 방법에 대한 자세한 내용은 App Services 문서의 데이터 모델 매핑을 참조하세요.
각 객체 유형에 대한 구독을 추가할 때까지 객체 유형에 대한 데이터를 볼 수 없습니다. 구독과 앱 에 대해 정의한 권한에 따라 동기화할 데이터가 결정됩니다.
특정 객체 유형에 대한 데이터 보기를 시작하려면 구독을 추가합니다. 표시되는 데이터를 변경하려면 다음 중 하나를 수행하면 됩니다.
추가 필터링을 적용하려면 더 많은 구독을 추가합니다.
구독을 제거합니다.
Realm Studio 에 추가한 구독 은 변경할 수 없습니다. 구독을 변경하려면 구독 을 제거 하고 새 구독 을 추가합니다.
구독 추가
쿼리 제공
RQL (RQL)을 사용하여 Realm Studio 와 동기화 하려는 객체에 대한 쿼리 를 만듭니다. 쿼리 와 일치하는 객체만 Realm Studio 에 나타납니다. 애플리케이션 을 개발할 때 쿼리의 유효성을 빠르게 검사하는 방법으로 이 기능을 사용할 수 있습니다.
구독 쿼리에는 쿼리 가능 필드가 하나 이상 포함되어야 합니다. 쿼리 가능 필드에 대한 자세한 내용은 App Services 설명서의 쿼리 가능 필드를 참조하세요.
사용 가능한 쿼리 연산자에 대한 자세한 내용은 RQL 참조를 참조하세요.
Device Sync 는 동기화 구독 쿼리에서 RQL 연산자의 하위 집합 사용을 지원합니다. 이러한 제한 사항에 대한 자세한 내용은 Flexible Sync RQL 제한 사항을 참조하세요.
예시
템플릿 앱으로 Device Sync 를 부트스트랩 하는 경우 템플릿 앱이 사용하는 구독 은 다음과 같습니다.
`owner_id == "${user?.id}"`
Realm Studio 에서 해당 데이터를 보려면 특정 사용자 ID 와 함께 이 쿼리 를 사용합니다.
owner_id == "67ee25f483c29fa14cfd7295"
Realm Studio 에 제공한 자격 증명 에 적절한 권한이 있는 모든 데이터를 보려면 다음 쿼리 를 사용합니다.
TRUEPREDICATE
구독 제거
동기화된 변경 사항을 실시간으로 보기
구독 을 추가한 후 앱의 규칙에 따라 자격 증명 이 허용하는 경우 객체를 생성, 업데이트 및 삭제 수 있습니다. Device Sync 에 연결된 상태에서 객체를 변경하면 해당 변경 사항이 Atlas 및 다른 기기와 자동으로 동기화 됩니다. 변경 사항 실시간 반영된 것을 확인할 수 있습니다.
Realm Studio 에서 객체를 생성, 수정 및 삭제 하는 방법에 대한 자세한 내용은 Realm 파일에서 객체 수정 하기를 참조하세요. Device Sync 에 연결된 동안 변경 사항을 저장하기 위해 아무것도 할 필요가 없습니다. 이러한 변경 사항은 서버 와 자동으로 동기화 되고 Atlas 에 유지됩니다.
구독과 일치하지 않는 객체를 수정하거나 추가하려고 하거나 쓰기 권한이 없는 경우, Device Sync에서 보상 쓰기 오류를 발생시킵니다. Realm Studio는 이러한 변경 사항을 되돌리며, 해당 변경 사항은 Atlas 또는 다른 장치와 동기화되지 않습니다. 자세한 내용은 App Services 문서의 Flexible Sync 오류 섹션에서 ErrorCompensatingWrite를 참조하세요.