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
public func insertOne(_ document: Document, _ completion: @escaping MongoInsertBlock)
매개변수
document
문서 삽입할
Document
값입니다.completion
삽입을 시도한 결과입니다. 성공하면 삽입된 객체에 대한 ID가 반환됩니다.
-
제공된 값을 BSON에 인코딩하고 삽입합니다. 식별자가 누락된 값이 있으면 생성됩니다.
선언
Swift
public func insertMany(_ documents: [Document], _ completion: @escaping MongoInsertManyBlock)
매개변수
documents
삽입할 bson 배열의
Document
값입니다.completion
삽입 결과는 문서 ID가 순서대로 삽입된 배열을 반환합니다.
-
이 collection에서 제공된 필터와 일치하는 문서를 찾습니다.
선언
Swift
public func find(filter: Document, options: FindOptions, _ completion: @escaping MongoFindBlock)
매개변수
filter
쿼리와 일치해야 하는
Document
as bson입니다.options
FindOptions
명령을 실행할 때 사용합니다.completion
문서 또는 오류의 결과 bson 배열(발생한 경우)
-
이 collection에서 제공된 필터와 일치하는 문서를 찾습니다.
선언
Swift
public func find(filter: Document, _ completion: @escaping MongoFindBlock)
매개변수
filter
쿼리와 일치해야 하는
Document
as bson입니다.completion
문서 또는 오류의 결과 bson 배열(발생한 경우)
-
컬렉션 또는 보기에서 제공된 필터와 일치하는 문서 하나를 반환합니다. 여러 문서가 쿼리를 충족하는 경우, 이 메서드는 쿼리의 정렬 순서 또는 기본 순서에 따라 첫 번째 문서를 반환합니다.
선언
Swift
public func findOneDocument(filter: Document, options: FindOptions, _ completion: @escaping MongoFindOneBlock)
매개변수
filter
쿼리와 일치해야 하는
Document
as bson입니다.options
FindOptions
명령을 실행할 때 사용합니다.completion
결과 bson 또는 오류(발생한 경우)
-
컬렉션 또는 보기에서 제공된 필터와 일치하는 문서 하나를 반환합니다. 여러 문서가 쿼리를 충족하는 경우, 이 메서드는 쿼리의 정렬 순서 또는 기본 순서에 따라 첫 번째 문서를 반환합니다.
선언
Swift
public func findOneDocument(filter: Document, _ completion: @escaping MongoFindOneBlock)
매개변수
filter
쿼리와 일치해야 하는
Document
as bson입니다.completion
결과 bson 또는 오류(발생한 경우)
-
이 collection에 대해 집계 프레임워크 파이프라인을 실행합니다.
선언
Swift
public func aggregate(pipeline: [Document], _ completion: @escaping MongoFindBlock)
매개변수
pipeline
수행할 애그리게이션 작업의 파이프라인을 포함하는
Documents
으)로 구성된 bson 배열입니다.completion
문서 또는 오류의 결과 bson 배열(발생한 경우)
-
이 collection에서 제공된 필터와 일치하는 문서 수를 계산합니다.
선언
Swift
public func count(filter: Document, limit: Int, _ completion: @escaping MongoCountBlock)
매개변수
filter
쿼리와 일치해야 하는
Document
as bson입니다.limit
계산할 문서의 최대 개수
completion
필터와 일치하는 문서 수를 반환합니다.
-
이 collection에서 제공된 필터와 일치하는 문서 수를 계산합니다.
선언
Swift
public func count(filter: Document, _ completion: @escaping MongoCountBlock)
매개변수
filter
쿼리와 일치해야 하는
Document
as bson입니다.completion
필터와 일치하는 문서 수를 반환합니다.
-
collection에서 일치하는 단일 문서를 삭제합니다.
선언
Swift
public func deleteOneDocument(filter: Document, _ completion: @escaping MongoCountBlock)
매개변수
filter
쿼리와 일치해야 하는
Document
as bson입니다.completion
삭제를 수행한 결과입니다. 삭제된 객체 수를 반환합니다.
-
여러 문서 삭제
선언
Swift
public func deleteManyDocuments(filter: Document, _ completion: @escaping MongoCountBlock)
매개변수
filter
일치 기준을 나타내는 문서
completion
삭제를 수행한 결과입니다. 삭제 횟수를 반환합니다.
-
이 collection에 제공된 필터와 일치하는 단일 문서를 업데이트합니다.
선언
Swift
public func updateOneDocument(filter: Document, update: Document, upsert: Bool, _ completion: @escaping MongoUpdateBlock)
-
이 collection에 제공된 필터와 일치하는 단일 문서를 업데이트합니다.
선언
Swift
public func updateOneDocument(filter: Document, update: Document, _ completion: @escaping MongoUpdateBlock)
-
이 collection에 제공된 필터와 일치하는 여러 문서를 업데이트합니다.
선언
Swift
public func updateManyDocuments(filter: Document, update: Document, upsert: Bool, _ completion: @escaping MongoUpdateBlock)
-
이 collection에 제공된 필터와 일치하는 여러 문서를 업데이트합니다.
선언
Swift
public func updateManyDocuments(filter: Document, update: Document, _ completion: @escaping MongoUpdateBlock)
-
쿼리 필터를 기반으로 collection의 단일 문서를 업데이트하고 업데이트 전 또는 업데이트 후 형식으로 문서를 반환합니다.
updateOneDocument
과 달리 이 조치를 사용하면 동일한 명령을 사용하여 원자적으로 문서를 찾고, 업데이트하고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.선언
Swift
public func findOneAndUpdate(filter: Document, update: Document, options: FindOneAndModifyOptions, _ completion: @escaping MongoFindOneBlock)
-
쿼리 필터를 기반으로 collection의 단일 문서를 업데이트하고 업데이트 전 또는 업데이트 후 형식으로 문서를 반환합니다.
updateOneDocument
과 달리 이 조치를 사용하면 동일한 명령을 사용하여 원자적으로 문서를 찾고, 업데이트하고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.선언
Swift
public func findOneAndUpdate(filter: Document, update: Document, _ completion: @escaping MongoFindOneBlock)
-
쿼리 필터를 기반으로 컬렉션의 단일 문서를 덮어쓰고 문서를 대체 전 또는 대체 후 형식으로 반환합니다.
updateOneDocument
과 달리 이 작업을 사용하면 동일한 명령을 사용하여 원자적으로 문서를 찾고, 바꾸고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.선언
Swift
public func findOneAndReplace(filter: Document, replacement: Document, options: FindOneAndModifyOptions, _ completion: @escaping MongoFindOneBlock)
매개변수
filter
쿼리와 일치해야 하는
Document
입니다.replacement
대체를 설명하는
Document
입니다.options
FindOneAndModifyOptions
명령을 실행할 때 사용합니다.completion
문서 교체 시도의 결과입니다.
-
쿼리 필터를 기반으로 컬렉션의 단일 문서를 덮어쓰고 문서를 대체 전 또는 대체 후 형식으로 반환합니다.
updateOneDocument
과 달리 이 작업을 사용하면 동일한 명령을 사용하여 원자적으로 문서를 찾고, 바꾸고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.선언
Swift
public func findOneAndReplace(filter: Document, replacement: Document, _ completion: @escaping MongoFindOneBlock)
-
쿼리 필터를 기반으로 컬렉션에서 단일 문서를 제거하고 삭제되기 직전의 문서와 동일한 형식의 문서를 반환합니다.
deleteOneDocument
와 달리 이 작업을 사용하면 동일한 명령으로 문서를 원자적으로 찾고 삭제할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 삭제 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.선언
Swift
public func findOneAndDelete(filter: Document, options: FindOneAndModifyOptions, _ completion: @escaping MongoFindOneBlock)
매개변수
filter
쿼리와 일치해야 하는
Document
입니다.options
FindOneAndModifyOptions
명령을 실행할 때 사용합니다.completion
문서 삭제 시도의 결과입니다.
-
쿼리 필터를 기반으로 컬렉션에서 단일 문서를 제거하고 삭제되기 직전의 문서와 동일한 형식의 문서를 반환합니다.
deleteOneDocument
와 달리 이 작업을 사용하면 동일한 명령으로 문서를 원자적으로 찾고 삭제할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 삭제 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.선언
Swift
public func findOneAndDelete(filter: Document, _ completion: @escaping MongoFindOneBlock)
매개변수
filter
쿼리와 일치해야 하는
Document
입니다.completion
문서 삭제 시도의 결과입니다.
-
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 변경 이벤트를 발생시키는 출판사입니다.
-
제공된 값을 BSON 에 인코딩하여 삽입합니다. 값에 식별자가 없는 경우 식별자가 생성됩니다. @param 문서: 삽입할
Document
값입니다. @returns 삽입된 문서 의 객체 ID 또는Error
을(를) 반환하는 출판사입니다. -
제공된 값을 BSON 에 인코딩하고 삽입합니다. 식별자가 누락된 값이 있는 경우 해당 값이 생성됩니다. @param 문서: 삽입할 BSON 배열 의
Document
값입니다. @returns 삽입된 문서 또는Error
의 객체 ID를 최종적으로 반환하는 게시자입니다. -
이 컬렉션 에서 제공된 필터하다 와 일치하는 문서를 찾습니다. @param 필터하다: 쿼리 와 일치해야 하는 BSON 으로서의
Document
입니다. @param options:FindOptions
명령을 실행할 때 사용합니다. @returns 최종적으로 문서의[ObjectId]
또는Error
을 반환하는 출판사입니다.선언
Swift
func find(filter: Document, options: FindOptions) -> Future<[Document], Error>
-
이 컬렉션 에서 제공된 필터하다 와 일치하는 문서를 찾습니다. @param 필터하다: 쿼리 와 일치해야 하는 BSON 으로서의
Document
입니다. @returns 최종적으로 문서의[ObjectId]
또는Error
을 반환하는 출판사입니다. -
제공된 필터하다 와 일치하는 컬렉션 또는 보기에서 하나의 문서 를 반환합니다. 여러 문서가 쿼리 를 충족하는 경우 이 메서드는 쿼리의 정렬 순서 또는 기본 순서 에 따라 첫 번째 문서 를 반환합니다. @param 필터하다: 쿼리 와 일치해야 하는 BSON 으로서의
Document
입니다. @param options:FindOptions
명령을 실행할 때 사용합니다. @returns 최종적으로Document
또는Error
을 반환하는 게시자입니다.선언
Swift
func findOneDocument(filter: Document, options: FindOptions) -> Future<Document?, Error>
-
이 컬렉션 에 대해 집계 프레임워크 파이프라인 을 실행합니다. @param 파이프라인 : 수행할 집계 작업의 파이프라인 을 포함하는
Documents
로 구성된 BSON 배열 입니다. @returns 최종적으로Document
또는Error
를 반환하는 게시자입니다. -
여러 문서를 삭제합니다. @param 필터하다: 일치 기준을 나타내는 문서 @returns 최종적으로 삭제된 문서의
Int
개수 또는Error
을 반환하는 게시자입니다.선언
Swift
func deleteManyDocuments(filter: Document) -> Future<Int, Error>
-
이 컬렉션 에 제공된 필터하다 와 일치하는 단일 문서 를 업데이트합니다. @param 필터하다: 일치 기준을 나타내는 BSON
Document
입니다. @param 업데이트 : 일치하는 문서 에 적용할 업데이트 를 나타내는 BSONDocument
입니다. @param 업서트 : true이면 쿼리 와 일치하는 문서 가 없는 경우 새 문서 를 만듭니다. @returns 최종적으로UpdateResult
또는Error
을 반환하는 게시자입니다.선언
Swift
func updateOneDocument(filter: Document, update: Document, upsert: Bool) -> Future<UpdateResult, Error>
-
이 컬렉션 에 제공된 필터하다 와 일치하는 단일 문서 를 업데이트합니다. @param 필터하다: 일치 기준을 나타내는 BSON
Document
입니다. @param 업데이트 : 일치하는 문서 에 적용할 업데이트 를 나타내는 BSONDocument
입니다. @returns 최종적으로UpdateResult
또는Error
을 반환하는 게시자입니다.선언
Swift
func updateOneDocument(filter: Document, update: Document) -> Future<UpdateResult, Error>
-
이 컬렉션 에 제공된 필터하다 와 일치하는 여러 문서를 업데이트합니다. @param 필터하다: 일치 기준을 나타내는 BSON
Document
입니다. @param 업데이트 : 일치하는 문서 에 적용할 업데이트 를 나타내는 BSONDocument
입니다. @param 업서트 : true이면 쿼리 와 일치하는 문서 가 없는 경우 새 문서 를 만듭니다. @returns 최종적으로UpdateResult
또는Error
을 반환하는 게시자입니다.선언
Swift
func updateManyDocuments(filter: Document, update: Document, upsert: Bool) -> Future<UpdateResult, Error>
-
이 컬렉션 에 제공된 필터하다 와 일치하는 여러 문서를 업데이트합니다. @param 필터하다: 일치 기준을 나타내는 BSON
Document
입니다. @param 업데이트 : 일치하는 문서 에 적용할 업데이트 를 나타내는 BSONDocument
입니다. @returns 최종적으로UpdateResult
또는Error
을 반환하는 게시자입니다.선언
Swift
func updateManyDocuments(filter: Document, update: Document) -> Future<UpdateResult, Error>
-
쿼리 필터하다 를 기반으로 컬렉션 의 단일 문서 를 업데이트하고 업데이트 전 또는 업데이트 후 형식으로 문서 를 반환합니다.
updateOneDocument
과 달리 이 조치 을 사용하면 동일한 명령으로 문서 를 원자적으로 찾고, 업데이트 하고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 사이에 다른 업데이트 작업으로 인해 문서 가 변경될 위험을 방지할 수 있습니다. @param 필터하다: 일치 기준을 나타내는 BSONDocument
. @param 업데이트 : 일치하는 문서 에 적용될 업데이트 를 나타내는 BSONDocument
입니다. @param options:RemoteFindOneAndModifyOptions
명령을 실행할 때 사용할 수 있습니다. @returns 문서 를 찾을 수 없는 경우 결국Document
또는nil
또는Error
을 반환하는 출판사입니다.선언
Swift
func findOneAndUpdate(filter: Document, update: Document, options: FindOneAndModifyOptions) -> Future<Document?, Error>
-
쿼리 필터하다 를 기반으로 컬렉션 의 단일 문서 를 업데이트하고 업데이트 전 또는 업데이트 후 형식으로 문서 를 반환합니다.
updateOneDocument
과 달리 이 조치 을 사용하면 동일한 명령으로 문서 를 원자적으로 찾고, 업데이트 하고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 사이에 다른 업데이트 작업으로 인해 문서 가 변경될 위험을 방지할 수 있습니다. @param 필터하다: 일치 기준을 나타내는 BSONDocument
. @param 업데이트 : 일치하는 문서 에 적용될 업데이트 를 나타내는 BSONDocument
입니다. @returns 문서 를 찾을 수 없는 경우 최종적으로Document
또는nil
또는Error
을 반환하는 출판사입니다. -
쿼리 필터하다 를 기반으로 컬렉션 의 단일 문서 를 덮어쓰고 대체 전 또는 대체 후 형식으로 문서 를 반환합니다.
updateOneDocument
과 달리 이 조치 을 사용하면 동일한 명령을 사용하여 원자적으로 문서 를 찾고, 바꾸고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 사이에 다른 업데이트 작업으로 인해 문서 가 변경될 위험을 방지할 수 있습니다. @param 필터하다: 쿼리 와 일치해야 하는Document
입니다. @param 대체: 대체를 설명하는Document
입니다. @param options:FindOneAndModifyOptions
명령을 실행할 때 사용할 수 있습니다. @returns 문서 를 찾을 수 없는 경우 결국Document
또는nil
또는Error
을 반환하는 출판사입니다.선언
Swift
func findOneAndReplace(filter: Document, replacement: Document, options: FindOneAndModifyOptions) -> Future<Document?, Error>
-
쿼리 필터하다 를 기반으로 컬렉션 의 단일 문서 를 덮어쓰고 대체 전 또는 대체 후 형식으로 문서 를 반환합니다.
updateOneDocument
과 달리 이 조치 을 사용하면 동일한 명령을 사용하여 원자적으로 문서 를 찾고, 바꾸고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 사이에 다른 업데이트 작업으로 인해 문서 가 변경될 위험을 방지할 수 있습니다. @param 필터하다: 쿼리 와 일치해야 하는Document
입니다. @param 대체: 대체를 설명하는Document
입니다. @returns 문서 를 찾을 수 없는 경우 최종적으로Document
또는nil
또는Error
을 반환하는 출판사입니다.선언
-
쿼리 필터하다 를 기반으로 컬렉션 에서 단일 문서 를 제거하고 삭제되기 직전의 문서 와 동일한 형식의 문서 를 반환합니다.
deleteOneDocument
과 달리 이 조치 을 사용하면 동일한 명령으로 문서 를 원자적으로 찾고 삭제 수 있습니다. 이렇게 하면 별도의 찾기 작업과 삭제 작업 사이에 다른 업데이트 작업으로 인해 문서 가 변경될 위험을 방지할 수 있습니다. @param 필터하다: 쿼리 와 일치해야 하는Document
입니다. @param options:FindOneAndModifyOptions
명령을 실행할 때 사용할 수 있습니다. @returns 문서 를 찾을 수 없는 경우 최종적으로Document
또는nil
또는Error
을 반환하는 출판사입니다.선언
Swift
func findOneAndDelete(filter: Document, options: FindOneAndModifyOptions) -> Future<Document?, Error>
-
쿼리 필터하다 를 기반으로 컬렉션 에서 단일 문서 를 제거하고 삭제되기 직전의 문서 와 동일한 형식의 문서 를 반환합니다.
deleteOneDocument
과 달리 이 조치 을 사용하면 동일한 명령으로 문서 를 원자적으로 찾고 삭제 수 있습니다. 이렇게 하면 별도의 찾기 작업과 삭제 작업 사이에 다른 업데이트 작업으로 인해 문서 가 변경될 위험을 방지할 수 있습니다. @param 필터하다: 쿼리 와 일치해야 하는Document
입니다. @returns 문서 를 찾을 수 없는 경우 최종적으로Document
또는nil
또는Error
를 반환하는 출판사입니다.