Swift 동시성 - Swift SDK

Realm 동시성 주의 사항

앱에서 동시성 기능을 구현할 때 Realm의 스레딩 모델과 Swift 동시성 스레딩 동작에 대한 이 주의 사항을 고려하세요.

비동기/대기 API

Atlas App Services 앱 또는 동기화된 영역으로 작업하는 많은 Realm Swift API는 비동기/대기 구문과 호환됩니다. 다음 예시를 확인해보세요.

• Async/Await 로그인

• 이메일/비밀번호 사용자 관리

• 사용자 ID 연결 - 비동기/대기

• 동기화된 영역 또는 로컬 영역열기

• 다른 행위자의 알림 대기

• Flexible Sync 구독 관리

• 서버리스 함수 비동기/대기 호출

• 비동기/대기 쿼리 MongoDB

• 비동기/대기 CRUD 작업

Swift 비동기/대기 API와 관련된 특정 기능 요청이 있는 경우 Realm용 MongoDB 피드백 엔진을 확인하세요. Realm Swift SDK 팀은 커뮤니티 피드백과 Swift 동시성 진화를 기반으로 동시성 관련 기능을 계속 개발할 계획입니다.

작업 및 작업 그룹

Swift 동시성은 작업 관리를 위한 API를 제공합니다. 및 TaskGroups . Swift 동시성 문서 는 작업을 프로그램의 일부로 비동기적으로 실행할 수 있는 작업 단위로 정의합니다. 작업을 사용하면 비동기 작업의 단위를 구체적으로 정의할 수 있습니다. TaskGroup을 사용하면 상위 TaskGroup 아래에서 실행할 Tasks 컬렉션을 단위로 정의할 수 있습니다.

작업 및 TaskGroups는 스레드를 다른 중요한 작업에 양보하거나 다른 작업을 차단할 수 있는 장기 실행 작업을 취소하는 기능을 제공합니다. 이러한 이점을 얻으려면 작업 및 TaskGroups를 사용하여 백그라운드에서 영역 쓰기를 관리할 수 있습니다.

그러나 위의 Suspending Execution with Await (대기 상태로 실행 일시 중단)에 설명된 스레드 제한 제약 조건은 작업 컨텍스트에 적용 . 작업에 await 지점이 포함된 경우 후속 코드가 다른 스레드에서 실행 되거나 재개되어 Realm의 스레드 제한을 위반할 수 있습니다.

Realm에 액세스하는 코드가 메인 스레드에서만 실행되도록 하려면 @MainActor을(를) 사용하여 작업 컨텍스트에서 실행하는 함수에 주석을 달아야 합니다. 이로 인해 작업 기능 사용의 일부 장점을 활용하지 못하게 되며 사용자 관리와 같은 네트워킹 활동에만 작업을 사용하는 경우가 아니라면 Realm을 사용하는 앱에서는 좋은 디자인 선택이 아니라는 것을 의미할 수 있습니다.

행위자 격리

행위자 격리는 Realm 액세스를 전용 행위자로 제한하는 인식을 제공하므로 비동기 컨텍스트에서 Realm 액세스를 관리하는 안전한 방법처럼 보입니다.

그러나 @MainActor이(가) 아닌 비동기 함수에서 Realm을 사용하는 것은 현재 지원되지 않습니다.

이는 Swift 5.6에서 종종 우연히 작동합니다. await 이후의 실행은 대기 중인 항목이 실행된 스레드에서 계속됩니다. 비동기 함수에서 await Realm()을(를) 사용하면 다음에 행위자 격리 함수를 호출할 때까지 메인 스레드에서 코드를 실행하게 됩니다.

대신 Swift 5.7은 행위자 격리 컨텍스트를 변경할 때마다 스레드를 홉합니다. 격리되지 않은 비동기 함수는 항상 백그라운드 스레드에서 실행됩니다.

await Realm()을(를) 사용하고 5.6에서 작동하는 코드가 있는 경우 함수를 @MainActor(으)로 표시하면 Swift 5.7에서 작동하게 됩니다. 5.6에서 의도치 않게 작동하던 방식 그대로 작동합니다.

동시성 코드 관련 오류

대부분의 경우 동시성 코드를 통해 Realm에 액세스하는 것과 관련하여 표시되는 오류는 Realm accessed from incorrect thread.입니다. 이는 이 페이지에 설명된 스레드 격리 문제 때문입니다.

Swift 동시성 기능을 사용하는 코드에서 스레딩 관련 문제를 방지하려면 다음을 수행합니다.

• 행위자가 격리된 영역을 지원하는 Realm Swift SDK 버전으로 업그레이드하고 이를 수동으로 스레딩을 관리하는 대신 사용할 수 있습니다. 자세한 내용은 행위자와 함께 Realm 사용 - Swift SDK를 참조하세요.

• 영역에 액세스할 때 실행 컨텍스트를 변경하지 않도록 합니다. UI에 데이터를 제공하기 위해 메인 스레드에서 영역을 여는 경우 @MainActor을(를) 사용하여 영역에 비동기적으로 액세스하는 후속 함수에 주석을 달아 해당 영역이 항상 메인 스레드에서 실행되도록 합니다. await은(는) 다른 스레드로 변경될 수 있는 일시 중지 지점을 표시한다는 점을 기억합니다.

• 행위자 격리 영역을 사용하지 않는 앱은 writeAsync API를 사용하여 백그라운드 쓰기를 수행할 수 있습니다. 이렇게 하면 사용자가 직접 특수 코드를 작성할 필요 없이 스레드 안전 방식으로 영역 액세스를 관리할 수 있습니다. 이는 비동기 컨텍스트에서 실행하기 위해 쓰기 프로세스의 일부(안전한 경우)를 아웃소싱하는 특수 API입니다. 행위자가 격리된 영역에 쓰는 경우가 아니라면 Swift의 async/await 구문과 함께 이 메서드를 사용하지 않습니다. 코드에서 이 메서드를 동기식으로 사용합니다. 또는 비동기 영역에 쓰기를 기다릴 때 Swift의 async/await 구문과 함께 asyncWrite API를 사용할 수 있습니다.

• 영역 액세스가 스레드 안전 방식으로 수행되는 경우 행위자가 격리되지 않은 동시성 코드를 명시적으로 작성하려면 해당되는 스레드 간에 인스턴스를 명시적으로 전달하여 스레드 관련 충돌을 방지할 수 있습니다. 이를 위해서는 Realm의 스레딩 모델을 잘 이해하고 Swift 동시성 스레딩 동작을 염두에 두어야 합니다.

전송 가능, 전송 불가능 및 스레드 제한 유형

Realm Swift SDK 퍼블릭 API에는 크게 세 가지 범주로 분류되는 유형이 포함되어 있습니다.

• 전송 가능

• 전송 불가능 및 스레드 제한 없음

• 스레드 제한

전송이 불가능한 유형과 스레드 간에 스레드로 제한되지 않은 유형을 공유할 수 있지만 이를 동기화해야 합니다.

스레드에 한정된 유형은 동결되지 않는 한 격리 컨텍스트에 한정됩니다. 동기화를 사용해도 이러한 컨텍스트 간에 전달할 수 없습니다.