MongoCollection
extension MongoCollection
-
collection에 대한 MongoDB change stream을 열어 변경 사항을 확인합니다. 결과 스트림은 구성된 MongoDB 규칙에 따라 활성 사용자에게 볼 권한이 있는 이 collection의 모든 이벤트에 대한 알림을 받습니다.
선언
Swift
public func watch(delegate: ChangeEventDelegate, queue: DispatchQueue = .main) -> ChangeStream
매개변수
delegate
결과 change stream에서 이벤트 및 오류에 React 위임입니다.
queue
대기열이 제공되지 않은 경우 스트리밍 이벤트를 선택적 대기열로 전달합니다.
반환 값
managed 이벤트를 ChangeStream입니다.
-
collection에 대한 MongoDB change stream을 열어 변경 사항을 확인합니다. 제공된 BSON 문서는 스트림에서 발생하는 변경 이벤트에 대한 일치 표현식 필터로 사용됩니다.
https://mongodb.com/ko-kr/docs/manual/reference/operator/aggregation/match/ 를 참조하세요. 일치 필터를 정의하는 방법에 대한 문서를 참조하세요.
ChangeEvents를 필터하다 하기 위해 일치 표현식 을 정의하는 것은 트리거에 대한 일치 표현식 을 정의하는 것과 유사합니다: https://mongodb.com/ko-kr/docs/ 영역/triggers/database-triggers/
선언
Swift
public func watch(matchFilter: Document, delegate: ChangeEventDelegate, queue: DispatchQueue = .main) -> ChangeStream
매개변수
matchFilter
수신 변경 이벤트에 적용할 $match 필터
delegate
결과 change stream에서 이벤트 및 오류에 React 위임입니다.
queue
대기열이 제공되지 않은 경우 스트리밍 이벤트를 선택적 대기열로 전달합니다.
반환 값
managed 이벤트를 ChangeStream입니다.
-
특정 문서의 변경 사항을 감시하기 위해 컬렉션에 대한 MongoDB 변경 스트림을 엽니다. 감시할 문서는 _id로 명시적으로 지정되어야 합니다.
선언
Swift
public func watch(filterIds: [ObjectId], delegate: ChangeEventDelegate, queue: DispatchQueue = .main) -> ChangeStream
매개변수
filterIds
Collection에서 관찰할 ID의 목록입니다.
delegate
결과 change stream에서 이벤트 및 오류에 React 위임입니다.
queue
대기열이 제공되지 않은 경우 스트리밍 이벤트를 선택적 대기열로 전달합니다.
반환 값
managed 이벤트를 ChangeStream입니다.
-
제공된 값을 BSON에 인코딩하고 삽입합니다. 값에 식별자가 누락된 경우 식별자가 생성됩니다.
선언
Swift
@preconcurrency public func insertOne(_ document: Document, _ completion: @escaping MongoInsertBlock)
매개변수
document
문서 삽입할
Document
값입니다.completion
삽입을 시도한 결과입니다. 성공하면 삽입된 객체에 대한 ID가 반환됩니다.
-
제공된 값을 BSON에 인코딩하고 삽입합니다. 식별자가 누락된 값이 있으면 생성됩니다.
선언
Swift
@preconcurrency public func insertMany(_ documents: [Document], _ completion: @escaping MongoInsertManyBlock)
매개변수
documents
삽입할 bson 배열의
Document
값입니다.completion
삽입 결과는 문서 ID가 순서대로 삽입된 배열을 반환합니다.
-
이 collection에서 제공된 필터와 일치하는 문서를 찾습니다.
선언
Swift
@preconcurrency public func find(filter: Document, options: FindOptions = FindOptions(), _ completion: @escaping MongoFindBlock)
매개변수
filter
쿼리와 일치해야 하는
Document
as bson입니다.options
FindOptions
명령을 실행할 때 사용합니다.completion
문서 또는 오류의 결과 bson 배열(발생한 경우)
-
컬렉션 또는 보기에서 제공된 필터와 일치하는 문서 하나를 반환합니다. 여러 문서가 쿼리를 충족하는 경우, 이 메서드는 쿼리의 정렬 순서 또는 기본 순서에 따라 첫 번째 문서를 반환합니다.
선언
Swift
@preconcurrency public func findOneDocument(filter: Document, options: FindOptions = FindOptions(), _ completion: @escaping MongoFindOneBlock)
매개변수
filter
쿼리와 일치해야 하는
Document
as bson입니다.options
FindOptions
명령을 실행할 때 사용합니다.completion
결과 bson 또는 오류(발생한 경우)
-
이 collection에 대해 집계 프레임워크 파이프라인을 실행합니다.
선언
Swift
@preconcurrency public func aggregate(pipeline: [Document], _ completion: @escaping MongoFindBlock)
매개변수
pipeline
수행할 애그리게이션 작업의 파이프라인을 포함하는
Documents
으)로 구성된 bson 배열입니다.completion
문서 또는 오류의 결과 bson 배열(발생한 경우)
-
이 collection에서 제공된 필터와 일치하는 문서 수를 계산합니다.
선언
Swift
@preconcurrency public func count(filter: Document, limit: Int? = nil, _ completion: @escaping MongoCountBlock)
매개변수
filter
쿼리와 일치해야 하는
Document
as bson입니다.limit
계산할 문서의 최대 개수
completion
필터와 일치하는 문서 수를 반환합니다.
-
collection에서 일치하는 단일 문서를 삭제합니다.
선언
Swift
@preconcurrency public func deleteOneDocument(filter: Document, _ completion: @escaping MongoCountBlock)
매개변수
filter
쿼리와 일치해야 하는
Document
as bson입니다.completion
삭제를 수행한 결과입니다. 삭제된 객체 수를 반환합니다.
-
여러 문서 삭제
선언
Swift
@preconcurrency public func deleteManyDocuments(filter: Document, _ completion: @escaping MongoCountBlock)
매개변수
filter
일치 기준을 나타내는 문서
completion
삭제를 수행한 결과입니다. 삭제 횟수를 반환합니다.
-
이 collection에 제공된 필터와 일치하는 단일 문서를 업데이트합니다.
선언
Swift
@preconcurrency public func updateOneDocument(filter: Document, update: Document, upsert: Bool = false, _ completion: @escaping MongoUpdateBlock)
-
이 collection에 제공된 필터와 일치하는 여러 문서를 업데이트합니다.
선언
Swift
@preconcurrency public func updateManyDocuments(filter: Document, update: Document, upsert: Bool = false, _ completion: @escaping MongoUpdateBlock)
-
쿼리 필터를 기반으로 collection의 단일 문서를 업데이트하고 업데이트 전 또는 업데이트 후 형식으로 문서를 반환합니다.
updateOneDocument
과 달리 이 조치를 사용하면 동일한 명령을 사용하여 원자적으로 문서를 찾고, 업데이트하고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.선언
Swift
@preconcurrency public func findOneAndUpdate(filter: Document, update: Document, options: FindOneAndModifyOptions = .init(), _ completion: @escaping MongoFindOneBlock)
-
쿼리 필터를 기반으로 컬렉션의 단일 문서를 덮어쓰고 문서를 대체 전 또는 대체 후 형식으로 반환합니다.
updateOneDocument
과 달리 이 작업을 사용하면 동일한 명령을 사용하여 원자적으로 문서를 찾고, 바꾸고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.선언
Swift
@preconcurrency public func findOneAndReplace(filter: Document, replacement: Document, options: FindOneAndModifyOptions = .init(), _ completion: @escaping MongoFindOneBlock)
매개변수
filter
쿼리와 일치해야 하는
Document
입니다.replacement
대체를 설명하는
Document
입니다.options
FindOneAndModifyOptions
명령을 실행할 때 사용합니다.completion
문서 교체 시도의 결과입니다.
-
쿼리 필터를 기반으로 컬렉션에서 단일 문서를 제거하고 삭제되기 직전의 문서와 동일한 형식의 문서를 반환합니다.
deleteOneDocument
와 달리 이 작업을 사용하면 동일한 명령으로 문서를 원자적으로 찾고 삭제할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 삭제 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.선언
Swift
@preconcurrency public func findOneAndDelete(filter: Document, options: FindOneAndModifyOptions = .init(), _ completion: @escaping MongoFindOneBlock)
매개변수
filter
쿼리와 일치해야 하는
Document
입니다.options
FindOneAndModifyOptions
명령을 실행할 때 사용합니다.completion
문서 삭제 시도의 결과입니다.
-
insertOne(_:
비동기식) 제공된 값을 BSON에 인코딩하고 삽입합니다. 값에 식별자가 누락된 경우 식별자가 생성됩니다.
매개변수
document
삽입할
Document
값입니다.반환 값
삽입된 문서의 객체 ID입니다.
-
insertMany(_:
비동기식) 제공된 값을 BSON에 인코딩하고 삽입합니다. 식별자가 누락된 값이 있으면 생성됩니다.
매개변수
documents
삽입할 bson 배열의
Document
값입니다.반환 값
삽입된 문서의 객체 ID입니다.
-
이 collection에서 제공된 필터와 일치하는 문서를 찾습니다.
-
컬렉션 또는 보기에서 제공된 필터와 일치하는 문서 하나를 반환합니다. 여러 문서가 쿼리를 충족하는 경우, 이 메서드는 쿼리의 정렬 순서 또는 기본 순서에 따라 첫 번째 문서를 반환합니다.
-
이 collection에서 제공된 필터와 일치하는 문서를 찾습니다.
선언
Swift
public func find(filter: Document, options: FindOptions = .init(), _isolation: isolated (any Actor)? = #isolation) async throws -> [Document]
매개변수
filter
쿼리와 일치해야 하는
Document
as bson입니다.options
FindOptions
명령을 실행할 때 사용합니다.반환 값
Document
의 배열이 필터링되었습니다. -
컬렉션 또는 보기에서 제공된 필터와 일치하는 문서 하나를 반환합니다. 여러 문서가 쿼리를 충족하는 경우, 이 메서드는 쿼리의 정렬 순서 또는 기본 순서에 따라 첫 번째 문서를 반환합니다.
선언
Swift
public func findOneDocument(filter: Document, options: FindOptions = .init(), _isolation: isolated (any Actor)? = #isolation) async throws -> Document?
매개변수
filter
쿼리와 일치해야 하는
Document
as bson입니다.options
FindOptions
명령을 실행할 때 사용합니다.반환 값
Document
필터링되었습니다. -
aggregate(pipeline:
비동기식) 이 collection에 대해 집계 프레임워크 파이프라인을 실행합니다.
매개변수
pipeline
수행할 애그리게이션 작업의 파이프라인을 포함하는
Documents
으)로 구성된 bson 배열입니다.반환 값
애그리게이션 연산의
Document
결과의 배열입니다. -
count(filter:
비동기식limit: ) -
여러 문서 삭제
선언
Swift
public func deleteManyDocuments(filter: Document) async throws -> Int
매개변수
filter
일치 기준을 나타내는 문서
반환 값
Int
삭제된 문서 수입니다. -
이 collection에 제공된 필터와 일치하는 단일 문서를 업데이트합니다.
선언
Swift
public func updateOneDocument(filter: Document, update: Document, upsert: Bool? = nil) async throws -> UpdateResult
매개변수
filter
일치 기준을 나타내는 bson
Document
입니다.update
일치하는 문서에 적용될 업데이트를 나타내는 bson
Document
입니다.upsert
true이면 쿼리와 일치하는 문서가 없는 경우 새 문서를 만듭니다.
반환 값
UpdateResult
updateOne
작업의 결과입니다. -
이 collection에 제공된 필터와 일치하는 여러 문서를 업데이트합니다.
선언
Swift
public func updateManyDocuments(filter: Document, update: Document, upsert: Bool? = nil) async throws -> UpdateResult
매개변수
filter
일치 기준을 나타내는 bson
Document
입니다.update
일치하는 문서에 적용될 업데이트를 나타내는 bson
Document
입니다.upsert
true이면 쿼리와 일치하는 문서가 없는 경우 새 문서를 만듭니다.
반환 값
UpdateResult
updateMany
작업의 결과입니다. -
쿼리 필터를 기반으로 collection의 단일 문서를 업데이트하고 업데이트 전 또는 업데이트 후 형식으로 문서를 반환합니다.
updateOneDocument
과 달리 이 조치를 사용하면 동일한 명령을 사용하여 원자적으로 문서를 찾고, 업데이트하고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다. -
쿼리 필터를 기반으로 컬렉션의 단일 문서를 덮어쓰고 문서를 대체 전 또는 대체 후 형식으로 반환합니다.
updateOneDocument
과 달리 이 작업을 사용하면 동일한 명령을 사용하여 원자적으로 문서를 찾고, 바꾸고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다. -
쿼리 필터를 기반으로 컬렉션에서 단일 문서를 제거하고 삭제되기 직전의 문서와 동일한 형식의 문서를 반환합니다.
deleteOneDocument
와 달리 이 작업을 사용하면 동일한 명령으로 문서를 원자적으로 찾고 삭제할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 삭제 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다. -
쿼리 필터를 기반으로 collection의 단일 문서를 업데이트하고 업데이트 전 또는 업데이트 후 형식으로 문서를 반환합니다.
updateOneDocument
과 달리 이 조치를 사용하면 동일한 명령을 사용하여 원자적으로 문서를 찾고, 업데이트하고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.선언
Swift
public func findOneAndUpdate(filter: Document, update: Document, options: FindOneAndModifyOptions = .init(), _isolation: isolated (any Actor)? = #isolation) async throws -> Document?
매개변수
filter
일치 기준을 나타내는 bson
Document
입니다.update
일치하는 문서에 적용될 업데이트를 나타내는 bson
Document
입니다.options
RemoteFindOneAndModifyOptions
명령을 실행할 때 사용합니다.반환 값
Document
문서를 업데이트하려고 시도한 결과이거나 문서를 찾을 수 없는 경우nil
입니다. -
쿼리 필터를 기반으로 컬렉션의 단일 문서를 덮어쓰고 문서를 대체 전 또는 대체 후 형식으로 반환합니다.
updateOneDocument
과 달리 이 작업을 사용하면 동일한 명령을 사용하여 원자적으로 문서를 찾고, 바꾸고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.선언
Swift
public func findOneAndReplace(filter: Document, replacement: Document, options: FindOneAndModifyOptions = .init(), _isolation: isolated (any Actor)? = #isolation) async throws -> Document?
매개변수
filter
쿼리와 일치해야 하는
Document
입니다.replacement
대체를 설명하는
Document
입니다.options
FindOneAndModifyOptions
명령을 실행할 때 사용합니다.반환 값
Document
문서를 다시 시도한 결과이거나 문서를 찾을 수 없는 경우nil
입니다. -
쿼리 필터를 기반으로 컬렉션에서 단일 문서를 제거하고 삭제되기 직전의 문서와 동일한 형식의 문서를 반환합니다.
deleteOneDocument
와 달리 이 작업을 사용하면 동일한 명령으로 문서를 원자적으로 찾고 삭제할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 삭제 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.선언
Swift
public func findOneAndDelete(filter: Document, options: FindOneAndModifyOptions = .init(), _isolation: isolated (any Actor)? = #isolation) async throws -> Document?
매개변수
filter
쿼리와 일치해야 하는
Document
입니다.options
FindOneAndModifyOptions
명령을 실행할 때 사용합니다.반환 값
Document
문서를 삭제하려고 시도한 결과 또는nil
문서를 찾을 수 없는 경우)입니다. -
MongoDB collection이 변경될 때마다 AnyBSON 변경 이벤트를 발생시키는 출판사를 생성합니다.
선언
Swift
public func watch() -> Publishers.WatchPublisher
반환 값
collection이 변경될 때마다 AnyBSON 변경 이벤트를 발생시키는 출판사입니다.
-
MongoDB collection이 변경될 때마다 AnyBSON 변경 이벤트를 발생시키는 출판사를 생성합니다.
선언
Swift
public func watch(filterIds: [ObjectId]) -> Publishers.WatchPublisher
매개변수
filterIds
Collection에서 관찰할 ID의 목록입니다.
반환 값
collection이 변경될 때마다 AnyBSON 변경 이벤트를 발생시키는 출판사입니다.
-
MongoDB collection이 변경될 때마다 AnyBSON 변경 이벤트를 발생시키는 출판사를 생성합니다.
선언
Swift
public func watch(matchFilter: Document) -> Publishers.WatchPublisher
매개변수
matchFilter
수신 변경 이벤트에 적용할 $match 필터입니다.
반환 값
collection이 변경될 때마다 AnyBSON 변경 이벤트를 발생시키는 출판사입니다.
-
MongoDB collection의 각 변경 사항에 대한 정보가 포함된 비동기 AnyBSON 값 시퀀스입니다.
선언
Swift
public var changeEvents: AsyncThrowingPublisher<Publishers.WatchPublisher> { get }
-
MongoDB collection의 각 변경 사항에 대한 정보가 포함된 비동기 AnyBSON 값 시퀀스입니다.
선언
Swift
public func changeEvents(onOpen: @Sendable @escaping () -> Void) -> AsyncThrowingPublisher<Publishers.WatchPublisher>
매개변수
onOpen
감시 스트림이 서버에서 초기화될 때 호출되는 콜백입니다. 이 콜백이 호출되기 전에 트리거된 서버 측 변경 사항은 변경 이벤트를 생성하지 않을 수 있습니다.
-
MongoDB 컬렉션 내
filterIds
에 포함된 ID를 가진 객체에 대한 각 변경 사항에 대한 정보가 포함된 비동기 AnyBSON 값 시퀀스입니다.선언
Swift
public func changeEvents(filterIds: [ObjectId], onOpen: (@Sendable () -> Void)? = nil) -> AsyncThrowingPublisher<Publishers.WatchPublisher>
매개변수
filterIds
변경 이벤트를 생성해야 하는 문서 ID
onOpen
감시 스트림이 서버에서 초기화될 때 호출되는 선택적 콜백입니다. 이 콜백이 호출되기 전에 트리거된 서버 측 변경 사항은 변경 이벤트를 생성하지 않을 수 있습니다.
-
지정된 $match 필터와 일치하는 MongoDB collection 내 객체의 각 변경 사항에 대한 정보가 포함된 AnyBSON 값의 비동기 시퀀스입니다.
선언
Swift
public func changeEvents(matchFilter: Document, onOpen: (@Sendable () -> Void)? = nil) -> AsyncThrowingPublisher<Publishers.WatchPublisher>
매개변수
matchFilter
$match 필터를 사용하여 변경 이벤트를 생성하는 문서를 필터링합니다.
onOpen
감시 스트림이 서버에서 초기화될 때 호출되는 선택적 콜백입니다. 이 콜백이 호출되기 전에 트리거된 서버 측 변경 사항은 변경 이벤트를 생성하지 않을 수 있습니다.
-
제공된 값을 BSON에 인코딩하고 삽입합니다. 값에 식별자가 누락된 경우 식별자가 생성됩니다.
매개변수
document
삽입할
Document
값입니다.반환 값
최종적으로 삽입된 문서의 객체 ID 또는
Error
를 반환하는 출판사입니다. -
제공된 값을 BSON에 인코딩하고 삽입합니다. 식별자가 누락된 값이 있으면 생성됩니다.
매개변수
documents
삽입할 bson 배열의
Document
값입니다.반환 값
최종적으로 삽입된 문서 또는
Error
의 객체 ID를 반환하는 출판사입니다. -
이 collection에서 제공된 필터와 일치하는 문서를 찾습니다.
선언
Swift
func find(filter: Document, options: FindOptions) -> Future<[Document], Error>
매개변수
filter
쿼리와 일치해야 하는
Document
as bson입니다.options
FindOptions
명령을 실행할 때 사용합니다.반환 값
최종적으로 문서의
[ObjectId]
또는Error
을 반환하는 출판사입니다. -
이 collection에서 제공된 필터와 일치하는 문서를 찾습니다.
매개변수
filter
쿼리와 일치해야 하는
Document
as bson입니다.반환 값
최종적으로 문서의
[ObjectId]
또는Error
을 반환하는 출판사입니다. -
컬렉션 또는 보기에서 제공된 필터와 일치하는 문서 하나를 반환합니다. 여러 문서가 쿼리를 충족하는 경우, 이 메서드는 쿼리의 정렬 순서 또는 기본 순서에 따라 첫 번째 문서를 반환합니다.
선언
Swift
func findOneDocument(filter: Document, options: FindOptions) -> Future<Document?, Error>
매개변수
filter
쿼리와 일치해야 하는
Document
as bson입니다.options
FindOptions
명령을 실행할 때 사용합니다.반환 값
최종적으로
Document
또는Error
을(를) 반환하는 출판사입니다. -
이 collection에 대해 집계 프레임워크 파이프라인을 실행합니다.
매개변수
pipeline
수행할 애그리게이션 작업의 파이프라인을 포함하는
Documents
으)로 구성된 bson 배열입니다.반환 값
최종적으로
Document
또는Error
을(를) 반환하는 출판사입니다. -
여러 문서 삭제
선언
Swift
func deleteManyDocuments(filter: Document) -> Future<Int, Error>
매개변수
filter
일치 기준을 나타내는 문서
반환 값
최종적으로
Int
의 삭제된 문서 수 또는Error
를 반환하는 출판사입니다. -
이 collection에 제공된 필터와 일치하는 단일 문서를 업데이트합니다.
선언
Swift
func updateOneDocument(filter: Document, update: Document, upsert: Bool) -> Future<UpdateResult, Error>
매개변수
filter
일치 기준을 나타내는 bson
Document
입니다.update
일치하는 문서에 적용될 업데이트를 나타내는 bson
Document
입니다.upsert
true이면 쿼리와 일치하는 문서가 없는 경우 새 문서를 만듭니다.
반환 값
최종적으로
UpdateResult
또는Error
을(를) 반환하는 출판사입니다. -
이 collection에 제공된 필터와 일치하는 단일 문서를 업데이트합니다.
선언
Swift
func updateOneDocument(filter: Document, update: Document) -> Future<UpdateResult, Error>
반환 값
최종적으로
UpdateResult
또는Error
을(를) 반환하는 출판사입니다. -
이 collection에 제공된 필터와 일치하는 여러 문서를 업데이트합니다.
선언
Swift
func updateManyDocuments(filter: Document, update: Document, upsert: Bool) -> Future<UpdateResult, Error>
매개변수
filter
일치 기준을 나타내는 bson
Document
입니다.update
일치하는 문서에 적용될 업데이트를 나타내는 bson
Document
입니다.upsert
true이면 쿼리와 일치하는 문서가 없는 경우 새 문서를 만듭니다.
반환 값
최종적으로
UpdateResult
또는Error
을(를) 반환하는 출판사입니다. -
이 collection에 제공된 필터와 일치하는 여러 문서를 업데이트합니다.
선언
Swift
func updateManyDocuments(filter: Document, update: Document) -> Future<UpdateResult, Error>
반환 값
최종적으로
UpdateResult
또는Error
을(를) 반환하는 출판사입니다. -
쿼리 필터를 기반으로 collection의 단일 문서를 업데이트하고 업데이트 전 또는 업데이트 후 형식으로 문서를 반환합니다.
updateOneDocument
과 달리 이 조치를 사용하면 동일한 명령을 사용하여 원자적으로 문서를 찾고, 업데이트하고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.선언
Swift
func findOneAndUpdate(filter: Document, update: Document, options: FindOneAndModifyOptions) -> Future<Document?, Error>
매개변수
filter
일치 기준을 나타내는 bson
Document
입니다.update
일치하는 문서에 적용될 업데이트를 나타내는 bson
Document
입니다.options
RemoteFindOneAndModifyOptions
명령을 실행할 때 사용합니다.반환 값
문서를 찾을 수 없는 경우
Document
또는nil
또는Error
를 반환하는 출판사입니다. -
쿼리 필터를 기반으로 collection의 단일 문서를 업데이트하고 업데이트 전 또는 업데이트 후 형식으로 문서를 반환합니다.
updateOneDocument
과 달리 이 조치를 사용하면 동일한 명령을 사용하여 원자적으로 문서를 찾고, 업데이트하고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.반환 값
문서를 찾을 수 없는 경우
Document
또는nil
또는Error
를 반환하는 출판사입니다. -
쿼리 필터를 기반으로 컬렉션의 단일 문서를 덮어쓰고 문서를 대체 전 또는 대체 후 형식으로 반환합니다.
updateOneDocument
과 달리 이 작업을 사용하면 동일한 명령을 사용하여 원자적으로 문서를 찾고, 바꾸고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.선언
Swift
func findOneAndReplace(filter: Document, replacement: Document, options: FindOneAndModifyOptions) -> Future<Document?, Error>
매개변수
filter
쿼리와 일치해야 하는
Document
입니다.replacement
대체를 설명하는
Document
입니다.options
FindOneAndModifyOptions
명령을 실행할 때 사용합니다.반환 값
문서를 찾을 수 없는 경우
Document
또는nil
또는Error
를 반환하는 출판사입니다. -
쿼리 필터를 기반으로 컬렉션의 단일 문서를 덮어쓰고 문서를 대체 전 또는 대체 후 형식으로 반환합니다.
updateOneDocument
과 달리 이 작업을 사용하면 동일한 명령을 사용하여 원자적으로 문서를 찾고, 바꾸고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.선언
반환 값
문서를 찾을 수 없는 경우
Document
또는nil
또는Error
를 반환하는 출판사입니다. -
쿼리 필터를 기반으로 컬렉션에서 단일 문서를 제거하고 삭제되기 직전의 문서와 동일한 형식의 문서를 반환합니다.
deleteOneDocument
와 달리 이 작업을 사용하면 동일한 명령으로 문서를 원자적으로 찾고 삭제할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 삭제 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.선언
Swift
func findOneAndDelete(filter: Document, options: FindOneAndModifyOptions) -> Future<Document?, Error>
매개변수
filter
쿼리와 일치해야 하는
Document
입니다.options
FindOneAndModifyOptions
명령을 실행할 때 사용합니다.반환 값
문서를 찾을 수 없는 경우
Document
또는nil
또는Error
를 반환하는 출판사입니다.