문서 메뉴
문서 홈
/ /
Atlas Device SDK
/ /

동기화 구독 관리 - React Native SDK

이 페이지의 내용

  • 전제 조건
  • 백엔드 앱과 구독 정렬
  • 쿼리 구독
  • 쿼리 구독
  • 쿼리 구독이 동기화될 때까지 기다리기
  • 쿼리 구독 취소
  • 수동으로 구독 관리하기
  • 모든 구독에 액세스
  • 구독 추가
  • 초기 구독으로 Realm 구성
  • 구독 상태 확인
  • 구독 상태 "완료"
  • 새 쿼리로 구독 업데이트하기
  • 구독 제거
  • 쿼리로 구독 제거
  • 이름으로 구독 제거
  • 참조로 구독 제거
  • 개체 유형에서 모든 구독 제거
  • 이름 없는 모든 구독 제거
  • 모든 구독 제거
  • 성능 고려 사항
  • API 효율성
  • 성능 향상을 위한 그룹 업데이트
  • Flexible Sync RQL 요구 사항 및 제한 사항
  • 인덱싱된 쿼리 가능 필드 구독 요구 사항
  • 유연한 동기화에서 지원되지 않는 쿼리 연산자
  • 목록 쿼리
  • 임베디드 또는 링크된 객체
  • 쿼리 크기 제한

Flexible Sync는 구독 및 권한을 사용하여 앱과 동기화할 데이터를 결정합니다. Flexible Sync가 활성화된 영역에서 읽기 또는 쓰기 (write)를 하려면 먼저 구독이 하나 이상 있어야 합니다. @realm/react 라이브러리는 동기화 구독에 대한 권한 및 쿼리를 간소화합니다.

쿼리 구독을 추가, 업데이트 및 제거하여 클라이언트 기기에 동기화할 데이터를 제어할 수 있습니다. Realm.js v12.0.0 이상에서는 수동으로 구독을 관리하는 대신 또는 추가로 쿼리를 구독할 수 있습니다.

데이터 수집비대칭 객체 는 App Services 백엔드로만 데이터를 전송하기 때문에 구독을 만들 수 없습니다.

중요

Flexible Sync 쿼리 제한 사항

Flexible Sync 구독은 RQL 쿼리 연산자의 하위 집합만 지원합니다. 지원되지 않는 연산자에 대한 자세한 내용은 Flexible Sync RQL 제한 사항 문서 를 참조하세요.

React Native SDK와 함께 Atlas Device Sync를 사용하려면 먼저 다음 요구 사항을 충족해야 합니다.

React Native 클라이언트에 유연한 동기화 구독을 추가하려면:

  1. 백엔드에서 유연한 동기화 구성

  2. 앱 클라이언트 초기화

  3. 클라이언트에서 사용자 인증

  4. 동기화된 Realm 구성

클라이언트 측 구독 쿼리는 백엔드 App Services 앱의 Device Sync 구성과 일치해야 합니다.

구독 쿼리는 해당 유형의 모든 객체를 반환합니다. 하나 이상의 쿼리 가능한 필드가 포함된 Realm Query Language 쿼리로 결과를 필터링할 수 있습니다.

쿼리 가능 필드 구성에 대해 자세히 알아보려면 App Services 문서에서 쿼리 가능 필드를 참조하세요.

Flexible Sync와 함께 Realm Query Language를 사용할 때의 제한 사항에 대해 자세히 알아보려면 Flexible Sync RQL 제한 사항 섹션을 참조하세요.

버전 realm@12.0.0의 새로운 기능

realm@12.0.0 쿼리 결과를 구독하거나 구독 취소하는 실험적 API 추가. 이러한 API는 수동으로 구독을 추가하고 제거하는 세부 사항을 단순화합니다.

모든 구독에 인증된 사용자Flexible Sync Realm이 필요합니다.

버전 realm@12.3.0에서 변경됨: Atlas Device Sync에서 지원되는 지리 공간적 데이터

Realm.js v12.3.0 이상에서는 지리 공간적 쿼리에 대한 구독을 생성할 수 있습니다. 이전 버전의 SDK에서 지리 공간적 쿼리를 구독하려고 하면 보정용 쓰기와 함께 서버 오류가 발생합니다.

자세한 내용은 지리 공간적 - React Native SDK를 참조하세요.

구독에 이름을 지정하는 것이 좋습니다. 이렇게 하면 구독을 더 쉽게 찾고 관리할 수 있습니다. 구독 이름은 고유해야 합니다. 기존 구독과 동일한 이름으로 구독을 추가하려면 기존 구독을 덮어씁니다.

쿼리를 구독하려면 다음과 같이 하세요:

  1. 읽고 쓰고자 하는 개체를 쿼리합니다.

  2. 쿼리 결과에 대해 subscribe() 호출하여 쿼리와 일치하는 객체에 대한 동기화 구독을 만듭니다.

  3. SubscriptionOptions객체에 name 속성을 포함시켜 subscribe() 함수에 전달합니다.

import React, {useEffect, useState} from 'react';
import {useRealm, useQuery} from '@realm/react';
import {View, Text, FlatList} from 'react-native';
import {Bird} from '../../models';
import {Subscription} from 'realm/dist/bundle';
export const BasicSubscription = () => {
const realm = useRealm();
// Get all local birds that have not been seen yet.
const seenBirds = useQuery(Bird, collection =>
collection.filtered('haveSeen == true'),
);
const [seenBirdsSubscription, setSeenBirdsSubscription] =
useState<Subscription | null>();
useEffect(() => {
// Create an async function so that we can `await` the
// promise from `.subscribe()`.
const createSubscription = async () => {
await seenBirds.subscribe({
name: 'Birds I have seen',
});
};
createSubscription().catch(console.error);
// Get the subscription...
const subscription = realm.subscriptions.findByName('Birds I have seen');
// ... and set it to a stateful variable or manage it in `useEffect`.
setSeenBirdsSubscription(subscription);
}, []);
return (
// Work with the subscribed results list or modify the subscription...
<></>
);
};

대부분의 경우 구독에 이름을 지정해야 합니다. 그렇지 않으면 이름이 null로 설정됩니다.

이름이 지정되지 않은 쿼리 구독에 filtered() 를 사용하는 경우 구독 식별자는 filtered 쿼리를 기반으로 합니다. 이는 쿼리 문자열이 변경될 때마다 subscribe()가 새 구독을 생성한다는 의미입니다.

API 참조

쿼리 결과를 구독하는 경우 동기화된 데이터가 다운로드될 때까지 결과에는 객체가 포함되지 않습니다. 동기화된 객체의 다운로드가 완료될 때까지 기다려야 하는 경우 waitForSync 옵션을 구성합니다.

이 예제에서는 기본 동작인 FirstTime 옵션을 사용합니다. FirstTime 동작이 있는 구독은 구독이 처음 생성될 때 동기화가 완료될 때까지만 기다립니다.

import React, {useEffect, useState} from 'react';
import {BSON, WaitForSync} from 'realm';
import {useRealm, useQuery} from '@realm/react';
import {View, Text, Button, TextInput, FlatList} from 'react-native';
import {Bird} from '../../models';
import {Subscription} from 'realm/dist/bundle';
export const WaitFirstTime = () => {
const realm = useRealm();
const [birdName, setBirdName] = useState('Change me!');
// Get local birds that have been marked as "haveSeen".
const seenBirds = useQuery(Bird, collection =>
collection.filtered('haveSeen == true'),
);
const [seenBirdsSubscription, setSeenBirdsSubscription] =
useState<Subscription | null>();
useEffect(() => {
const createSubscription = async () => {
// Only wait for sync to finish on the initial sync.
await seenBirds.subscribe({
behavior: WaitForSync.FirstTime,
name: 'First time sync only',
});
};
createSubscription().catch(console.error);
// Get the subscription...
const subscription = realm.subscriptions.findByName('First time sync only');
// ... and set it to a stateful variable or manage it in `useEffect`.
setSeenBirdsSubscription(subscription);
}, []);
return (
// Work with the subscribed results list or modify the subscription...
<></>
);
};

지원되는 다른 WaitForSync 옵션은 다음과 같습니다.

  • Always: 앱이 실행될 때마다 일치하는 객체를 다운로드할 때까지 기다립니다. 앱을 실행할 때마다 인터넷에 연결되어 있어야 합니다.

  • Never: 일치하는 객체를 다운로드하기 위해 기다리지 마세요. 앱을 처음 실행할 때는 사용자가 인증하기 위해 인터넷 연결이 필요하지만, 이후 실행 시 캐시된 자격 증명을 사용하여 오프라인으로 열 수 있습니다.

선택적으로 timeout 값을 지정하여 동기화 다운로드가 실행되는 시간을 제한할 수 있습니다.

export const AlwaysWait = () => {
const realm = useRealm();
// Get all local birds that have not been seen yet.
const unSeenBirds = useQuery(Bird, collection =>
collection.filtered('haveSeen == false'),
);
const [unSeenBirdsSubscription, setUnseenBirdsSubscription] =
useState<Subscription | null>();
useEffect(() => {
const createSubscription = async () => {
// Add subscription with timeout.
// If timeout expires before sync is completed, currently-downloaded
// objects are returned and sync download continues in the background.
await unSeenBirds.subscribe({
behavior: WaitForSync.Always,
name: 'Always wait',
timeout: 500,
});
};
createSubscription().catch(console.error);
// Get the subscription...
const subscription = realm.subscriptions.findByName('Always wait');
// ... and set it to a stateful variable or manage it in `useEffect`.
setUnseenBirdsSubscription(subscription);
}, []);
return (
// Work with the subscribed results list or modify the subscription...
<></>
);
};

API 참조

구독을 취소하지 않는 한 구독은 사용자 세션 전반에 걸쳐 유지됩니다. unsubscribe()을(를) 사용하여 쿼리 결과의 구독을 취소할 수 있습니다.

이렇게 하면 수동으로 구독을 제거하는 것과 유사하게 활성 구독 목록에서 구독이 제거됩니다.

겹치는 객체가 포함된 다른 구독이 있는 경우 unsubscribe()을(를) 호출한 후에도 결과 목록에 여전히 객체가 포함될 수 있습니다.

unsubscribe()을(를) 호출하면 연결된 구독이 제거됩니다. 구독은 이름으로 제거됩니다. 이름이 없으면 unsubscribe()은(는) unsubscribe()을(를) 호출한 쿼리와 정확히 일치하는 쿼리를 모두 제거합니다.

제거된 구독과 일치하는 객체가 영역에서 삭제되기 전에 unsubscribe() 메서드가 반환됩니다. 동기화는 새 구독 세트를 기반으로 백그라운드에서 계속됩니다.

import React, {useEffect, useState} from 'react';
import {useRealm, useQuery} from '@realm/react';
import {View, Text, Button} from 'react-native';
import {Bird} from '../../models';
import {Subscription} from 'realm/dist/bundle';
export const Unsubscribe = () => {
const realm = useRealm();
const birds = useQuery(Bird);
const unsubscribeFromQuery = () => {
birds.unsubscribe();
};
return (
<View>
<Button
title="Unsubscribe"
onPress={() => {
unsubscribeFromQuery();
}}
/>
</View>
);
};

API 참조

구독 API를 사용하여 쿼리 가능 필드의 특정 쿼리에 대한 구독 세트를 수동으로 관리할 수 있습니다.

Realm.subscriptions API를 사용하여 쿼리 가능 필드에 대한 특정 쿼리에 대한 구독 세트를 관리할 수 있습니다.

@realm/react을(를) 사용하는 경우 적절하게 구성된 영역Provider 내에서 영역 구독을 관리할 수 있습니다. use영역() 훅을 사용하면 현재 열려 있는 영역에 액세스할 수 있습니다.

구독으로 다음을 수행할 수 있습니다:

데이터가 구독과 일치하고 인증된 사용자에게 적절한 권한이 있는 경우, Device Sync는 백엔드 데이터를 클라이언트 앱과 동기화합니다.

구독을 생성하면 Realm은 특정 객체 유형에 대한 쿼리와 일치하는 데이터를 찾습니다. 여러 가지 다른 객체 유형에 대한 구독을 가질 수 있습니다. 동일한 객체 유형에 대해 여러 개의 쿼리를 가질 수도 있습니다.

중요

객체 링크

링크된 객체를 보려면 객체와 해당 링크된 객체를 모두 구독 세트에 추가해야 합니다.

구독 결과에 결과에 포함되지 않은 객체에 연결되는 속성이 있는 객체가 포함된 경우 해당 링크는 null로 표시됩니다. 해당 속성 값이 실제 null인지, 아니면 링크된 객체가 존재하지만 쿼리 구독의 표시 영역에서 벗어난 것인지 구분할 방법이 없습니다.

Flexible Sync를 위해 구성된 RealmProvider 내에서 SubscriptionSet에 액세스할 수 있습니다. SubscriptionSet은 앱에 대한 모든 구독의 컬렉션입니다.

import React, {useEffect, useState} from 'react';
import {Text, FlatList} from 'react-native';
import {useRealm, useQuery} from '@realm/react';
import {Bird} from '../Models/Bird';
function SubscriptionManager() {
const realm = useRealm();
// Pass object model to useQuery and filter results.
// This does not create a subscription.
const seenBirds = useQuery(Bird, birds => {
return birds.filtered('haveSeen == true');
});
const [subscriptions, setSubcriptions] = useState<
App.Sync.SubscriptionSet | undefined
>();
useEffect(() => {
const createSubscription = async () => {
// Create subscription for filtered results.
await realm.subscriptions.update(mutableSubs => {
mutableSubs.add(seenBirds, {name: 'seen birds'});
});
};
createSubscription().catch(console.error);
// Set to state variable.
setSubcriptions(realm.subscriptions);
}, []);
return (
<FlatList
data={subscriptions}
keyExtractor={subscription => subscription.id.toString()}
renderItem={({item}) => <Text>{item.name}</Text>}
/>
);
}

API 참조

다음 예제에서는 completedprogressMinutes이(가) App Services App에서 쿼리 가능한 필드로 설정되어 있습니다. 클라이언트 코드에서 필터링된 쿼리를 생성한 다음 그 결과를 구독합니다.

  • 완료된 작업

  • 120 이상 걸린 완료된 작업 progressMinutes

결과를 반환하려면 useQuery()에 활성 구독이 필요합니다. 아직 구독이 추가되지 않은 경우 useQuery()은(는) MutableSubscriptionSet.add()에 대해 유효한 query 이(가) 아닌 빈 결과를 반환합니다.

import React, {useEffect} from 'react';
import {Text, FlatList} from 'react-native';
import {useRealm, useQuery} from '@realm/react';
function SubscriptionManager() {
const realm = useRealm();
const seenBirds = useQuery(Bird, birds => {
return birds.filtered('haveSeen == true');
});
useEffect(() => {
realm.subscriptions.update(
(mutableSubs: Realm.App.Sync.MutableSubscriptionSet) => {
// Create subscription for filtered collection.
mutableSubs.add(seenBirds, {name: 'seenBirds'});
},
);
});
return (
<FlatList
data={seenBirds}
keyExtractor={item => item._id.toString()}
renderItem={({item}) => <Text>{item._id.toString()}</Text>}
/>
);
}

Flexible Sync Realm에서 읽거나 쓰려면 먼저 구독이 하나 이상 있어야 합니다. 초기 구독을 사용하면 동기화된 Realm을 구성할 때 구독을 정의할 수 있습니다.

초기 구독으로 동기화된 영역을 열려면 initialSubscriptions 속성을 RealmProvider의 동기화 구성에 추가합니다.

초기 구독을 설정할 때 @realm/react 라이브러리 훅 useQueryuseObject을(를) 사용할 수 없습니다. 대신 Realm.js 읽기 및 쓰기 (write) 작업을 사용하세요.

import React from 'react';
import {AppProvider, UserProvider} from '@realm/react';
// get realm context from createRealmContext()
import {RealmContext} from '../RealmConfig';
import {Text, FlatList} from 'react-native';
const {RealmProvider, useQuery} = RealmContext;
function AppWrapper() {
return (
<AppProvider id={APP_ID}>
<UserProvider fallback={LogIn}>
<RealmProvider
sync={{
flexible: true,
initialSubscriptions: {
update(subs, realm) {
subs.add(realm.objects('Turtle'));
},
},
onError: console.log,
}}>
<SubscriptionManager />
</RealmProvider>
</UserProvider>
</AppProvider>
);
}
function SubscriptionManager() {
// Pass object model to useQuery to get all objects of type `Turtle`.
// These results automatically update with changes from other devices
// because we created a subscription with `initialSubscriptions`.
const allTurtles = useQuery('Turtle');
return (
<FlatList
data={allTurtles}
keyExtractor={turtle => turtle._id.toString()}
renderItem={({item}) => <Text>{item._id}</Text>}
/>
);
}

기본적으로 초기 구독은 영역이 처음 열릴 때만 생성됩니다. 앱이 시작될 때마다 이 초기 구독을 다시 실행해야 하는 경우 rerunOnOpen을(를) true(으)로 설정할 수 있습니다. 동적 시간 범위 또는 구독에 대한 정적 변수를 다시 계산해야 하는 기타 쿼리를 재실행하려면 이 작업을 수행해야 할 수 있습니다.

API 참조

구독 상태 를 확인하여 서버가 구독을 승인했는지, 장치가 로컬로 데이터를 다운로드했는지 확인할 수 있습니다.

구독 상태를 사용하여 다음을 수행할 수 있습니다.

  • 트리거 오류 처리

  • 트랜잭션이 보류 중인지 또는 완료되었는지 표시

  • 구독 세트 대체 시기를 확인하고 구독 변경 사항을 작성하려면 해당 구독 세트의 새 인스턴스를 가져와야 합니다

import React, {useEffect} from 'react';
import {Text, View} from 'react-native';
import {useRealm, useQuery} from '@realm/react';
import {Bird} from '../Models/Bird';
function SubscriptionManager() {
const realm = useRealm();
const seenBirds = useQuery(Bird, birds => {
return birds.filtered('haveSeen == true');
});
useEffect(() => {
realm.subscriptions.update(
(mutableSubs: Realm.App.Sync.MutableSubscriptionSet) => {
// Create subscription for filtered collection.
mutableSubs.add(seenBirds, {name: 'seenBirds'});
},
);
});
// Returns state of all subscriptions, not individual subscriptions.
// In this case, it's just the subscription for `Bird` objects where
// `haveSeen` is true.
const allSubscriptionState = realm.subscriptions.state;
return (
<View>
<Text >
Status of all subscriptions: {allSubscriptionState}
</Text>
</View>
);
}

버전 realm@12.0.0의 새로운 기능

Realm.js v12.0.0 에서 구독 상태를 가져오는 데 사용할 수 있는 SubscriptionSetState 열거형 을 추가했습니다.

구독 세트 상태 "완료" 는 "동기화가 완료됨" 또는 "모든 문서가 동기화됨" 을 의미하지 않습니다. "완료" 는 다음 두 가지를 의미합니다:

  • 구독이 현재 서버와 동기화되고 있는 활성 구독 세트가

  • 이제 구독이 서버로 전송될 때 구독과 일치했던 문서가 로컬 장치에 존재합니다. 여기에는 현재 구독과 일치하는 모든 문서가 반드시 포함되는 것은 아닙니다.

Realm SDK는 구독과 일치하는 모든 문서가 기기에 동기화되었는지 확인하는 방법을 제공하지 않습니다.

새 쿼리로 이름이 지정된 구독을 업데이트할 수 있습니다. 구독 쿼리를 업데이트하려면 업데이트하려는 구독 이름과 함께 새 쿼리와 구독 옵션을 MutableSubscriptionSet.add() 메서드에 전달합니다. 새 구독을 추가하는 것과 마찬가지로 subscriptions.update()를 호출하여 트랜잭션 내에서 구독을 업데이트해야 합니다.

다음 예에서는 장기 실행 작업을 180분 이상 걸리는 작업으로 재정의합니다.

realm.subscriptions.update((mutableSubs) => {
mutableSubs.add(
tasks.filtered('status == "completed" && progressMinutes > 180'),
{
name: "longRunningTasksSubscription",
}
);
});

참고

SubscriptionOptions.throwOnUpdate 필드가 true로 설정된 구독을 업데이트하려고 하면 예외가 발생합니다.

API 참조

구독 세트는 더 이상 코드에 구독을 포함하지 않더라도 세션 전반에 걸쳐 유지됩니다. 구독 정보는 동기화된 영역의 데이터베이스 파일에 저장됩니다. 일치하는 데이터 동기화 시도를 중지하려면 구독을 명시적으로 제거해야 합니다.

다음과 같은 방법으로 구독을 제거할 수 있습니다.

  • 특정 쿼리로 단일 구독 제거

  • 특정 이름으로 단일 구독 제거

  • 특정 객체 모델에 대한 모든 구독 제거

  • 이름 없는 모든 구독 제거

  • 모든 구독 삭제

구독 쿼리를 제거하면 서버는 클라이언트 장치에서 동기화된 데이터도 제거합니다.

이 섹션의 예제에서는 @realm/react올바르게 구성된 RealmProvider로 작업하고 있다고 가정합니다.

import {useEffect} from 'react';
// get realm context from createRealmContext()
import {RealmContext} from '../RealmConfig';
const {useRealm} = RealmContext;
function SubscriptionManager() {
const realm = useRealm();
useEffect(() => {
realm.subscriptions.update(mutableSubs => {
// Remove subscription for object type `Turtle`,
// which we added in `initialSubscriptions`.
mutableSubs.removeByObjectType('Turtle');
});
});
return (
// ...
);
}

구독 세트에서 트랜잭션을 실행하여 쿼리를 통해 특정 구독을 제거할 수 있습니다. 쓰기 트랜잭션(write transaction) 내에서 MutableSubscriptionSet.remove() 에 쿼리를 전달합니다.

realm.subscriptions.update((mutableSubs) => {
// remove a subscription with a specific query
mutableSubs.remove(tasks.filtered('owner == "Ben"'));
});

이름으로 특정 구독을 제거하려면 구독 세트에서 트랜잭션을 실행합니다. 트랜잭션 내에서 이름을 MutableSubscriptionSet.removeByName()에 전달합니다.

realm.subscriptions.update((mutableSubs) => {
// remove a subscription with a specific name
mutableSubs.removeByName("longRunningTasksSubscription");
});

구독에 대한 참조가 있는 경우 해당 구독을 제거할 수 있습니다. 이렇게 하려면 구독 세트에서 트랜잭션을 실행합니다. 트랜잭션 내에서 참조 변수를 MutableSubscriptionSet.removeSubscription()에 전달합니다.

let subscriptionReference;
realm.subscriptions.update((mutableSubs) => {
subscriptionReference = mutableSubs.add(realm.objects("Task"));
});
// later..
realm.subscriptions.removeSubscription(subscriptionReference);

특정 객체 유형에 대한 모든 구독을 제거하려면 구독 세트에서 트랜잭션을 실행합니다. 트랜잭션 내에서 객체 유형을 string 로 MutableSubscriptionSet.removeByObjectType()에 전달합니다.

realm.subscriptions.update((mutableSubs) => {
mutableSubs.removeByObjectType("Team");
});

버전 realm@v12.0.0의 새로운 기능

일시적이거나 동적으로 생성된 이름 없는 구독을 제거하고 이름이 지정된 구독은 그대로 두는 것이 좋습니다.

mutableSubs에서 .removeUnnamed()을(를) 호출하여 구독 세트에서 명명되지 않은 모든 구독을 제거할 수 있습니다. .removeUnnamed()은(는) 제거된 명명되지 않은 구독 수를 반환합니다.

// Remove unnamed subscriptions.
let numberRemovedSubscriptions = 0;
await realm.subscriptions.update((mutableSubs) => {
numberRemovedSubscriptions = mutableSubs.removeUnnamed();
});

API 참조

구독 세트에서 모든 구독을 제거하려면 구독 세트에서 트랜잭션을 실행합니다. 쓰기 트랜잭션(write transaction) 내에서 MutableSubscriptionSet.removeAll() 을 호출합니다.

realm.subscriptions.update((mutableSubs) => {
mutableSubs.removeAll();
});

쿼리 구독 섹션에 설명된 subscribe()unsubscribe() API를 사용하여 여러 구독을 관리하는 것은 수동으로 구독을 관리할 때 배치 업데이트를 수행하는 것보다 효율성이 떨어집니다.

구독을 여러 번 변경할 때 성능을 향상하려면 subscriptions API를 사용하여 단일 트랜잭션으로 모든 구독을 업데이트합니다. 방법을 알아보려면 수동으로 구독 관리하기를 참조하세요.

구독 세트에 대한 모든 쓰기 트랜잭션에는 성능이 소모됩니다. 세션 중에 Realm 객체를 여러 번 업데이트해야 하는 경우 모든 변경이 완료될 때까지 편집한 객체를 메모리에 보관하는 것이 좋습니다. 이렇게 하면 모든 변경 사항 대신 완전하고 업데이트된 객체만 영역에 기록하므로 동기화 성능이 향상됩니다.

앱에 인덱싱된 쿼리 가능 필드 를 추가하면 강력하게 분할된 데이터에 대한 간단한 쿼리의 성능을 향상시킬 수 있습니다. 예를 들어 user_id == $0, “641374b03725038381d2e1fb” 와 같이 쿼리가 데이터를 기기, 스토어 또는 사용자에 강력하게 매핑하는 앱은 인덱싱된 쿼리 가능 필드의 좋은 후보입니다. 그러나 인덱싱된 쿼리 가능 필드에는 쿼리 구독에 사용하기 위한 특정 요구 사항이 있습니다.

  • 인덱싱된 쿼리 가능 필드는 모든 구독 쿼리에서 사용해야 합니다. 쿼리에서 누락되어서는 안 됩니다.

  • 인덱싱된 쿼리 가능 필드는 구독 쿼리에서 상수에 대해 == 또는 IN 비교를 한 번 이상 사용해야 합니다. 예를 들어 user_id == $0, "641374b03725038381d2e1fb" 또는 store_id IN $0, {1,2,3}입니다.

인덱싱된 쿼리 가능 필드가 == 또는 IN을 사용하여 상수와 한 번 이상 직접 비교되는 경우, 선택적으로 AND 비교를 포함할 수 있습니다. 예를 들어 store_id IN {1,2,3} AND region=="Northeast" 또는 store_id == 1 AND (active_promotions < 5 OR num_employees < 10) 입니다.

인덱싱된 쿼리 가능 필드에 대한 유효하지 않은 Flexible Sync 쿼리에는 다음과 같은 쿼리가 포합됩니다.

  • 인덱싱된 쿼리 가능 필드가 AND를 나머지 쿼리와 함께 사용하지 않는 경우.예를 들어 store_id IN {1,2,3} OR region=="Northeast"AND 대신 OR을 사용하므로 유효하지않습니다. 마찬가지로 store_id == 1 AND active_promotions < 5 OR num_employees < 10AND가 전체 쿼리가 아니라 옆에 있는 용어에만 적용되므로 유효하지 않습니다.

  • 인덱싱된 쿼리 가능 필드가 동등 연산자에 사용되지 않는 경우.예를 들어 store_id > 2 AND region=="Northeast"> 연산자만 인덱싱된 쿼리 가능 필드에 사용하고 동등 비교는 없기 때문에 유효하지 않습니다.

  • 인덱싱된 쿼리 가능 필드가 쿼리에서 완전히 누락된 경우.예를 들어region=="Northeast 또는 truepredicate는 인덱싱된 쿼리 가능 필드를 포함하지 않으므로 유효하지 않습니다.

Flexible Sync는 RQL 연산자를 사용할 때 몇 가지 제한 사항이 있습니다. 동기화할 데이터를 결정하는 쿼리 구독 을 작성할 때 서버는 이러한 쿼리 연산자를 지원하지 않습니다. 그러나 전체 RQL 기능을 사용하여 클라이언트 애플리케이션에서 동기화된 데이터 세트를 쿼리할 수 있습니다.

연산자 유형
지원되지 않는 연산자
집계 연산자
@avg, @count, @max, @min, @sum
쿼리 접미사
DISTINCT, SORT, LIMIT

대소문자를 구분하지 않는 쿼리([c])은(는) 인덱스를 효과적으로 사용할 수 없습니다. 대소문자를 구분하지 않는 쿼리는 성능 문제를 일으킬 수 있으므로 사용하지 않는 것이 좋습니다.

유연한 동기화는 배열 필드에 대해 @count만 지원합니다.

유연한 동기화는 IN 연산자를 사용하여 목록 쿼리를 지원합니다.

상수 목록을 쿼리하여 쿼리 가능 필드 값이 포함되어 있는지 확인할 수 있습니다:

// Query a constant list for a queryable field value
"priority IN { 1, 2, 3 }"

쿼리 가능한 필드에 배열 값이 있는 경우 해당 에 상수 값이 포함되어 있는지 쿼리할 수 있습니다.

// Query an array-valued queryable field for a constant value
"'comedy' IN genres"

경고

유연한 동기화 쿼리에서는 두 목록을 비교하는 것이 불가능합니다. 이 구문은 유연한 동기화 쿼리 외에는 유효한 Realm Query Language 구문이라는 점에 유의하세요.

// Invalid Flexible Sync query. Do not do this!
"{'comedy', 'horror', 'suspense'} IN genres"
// Another invalid Flexible Sync query. Do not do this!
"ANY {'comedy', 'horror', 'suspense'} != ANY genres"

유연한 동기화는 포함된 객체 또는 링크의 속성에 대한 쿼리를 지원하지 않습니다. 예를 들어 obj1.field == "foo"이 있습니다.

구독 세트에 있는 특정 쿼리 구독의 크기 제한256 KB 입니다. 이 제한을 초과하면 LimitsExceeded 오류가 발생합니다.

돌아가기

동기화된 Realm 구성

다음

동기화 세션 관리