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)

    매개변수

    filter

    일치 기준을 나타내는 bson Document 입니다.

    update

    일치하는 문서에 적용될 업데이트를 나타내는 bson Document 입니다.

    upsert

    true이면 쿼리와 일치하는 문서가 없는 경우 새 문서를 만듭니다.

    completion

    문서 업데이트 시도의 결과입니다.

  • 이 collection에 제공된 필터와 일치하는 여러 문서를 업데이트합니다.

    선언

    Swift

    @preconcurrency
    public func updateManyDocuments(filter: Document, update: Document, upsert: Bool = false,
                                    _ completion: @escaping MongoUpdateBlock)

    매개변수

    filter

    일치 기준을 나타내는 bson Document 입니다.

    update

    일치하는 문서에 적용될 업데이트를 나타내는 bson Document 입니다.

    upsert

    true이면 쿼리와 일치하는 문서가 없는 경우 새 문서를 만듭니다.

    completion

    문서 업데이트 시도의 결과입니다.

  • 쿼리 필터를 기반으로 collection의 단일 문서를 업데이트하고 업데이트 전 또는 업데이트 후 형식으로 문서를 반환합니다. updateOneDocument 과 달리 이 조치를 사용하면 동일한 명령을 사용하여 원자적으로 문서를 찾고, 업데이트하고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.

    선언

    Swift

    @preconcurrency
    public func findOneAndUpdate(filter: Document, update: Document,
                                 options: FindOneAndModifyOptions = .init(),
                                 _ completion: @escaping MongoFindOneBlock)

    매개변수

    filter

    일치 기준을 나타내는 bson Document 입니다.

    update

    일치하는 문서에 적용될 업데이트를 나타내는 bson Document 입니다.

    options

    RemoteFindOneAndModifyOptions 명령을 실행할 때 사용합니다.

    completion

    문서 업데이트 시도의 결과입니다.

  • 쿼리 필터를 기반으로 컬렉션의 단일 문서를 덮어쓰고 문서를 대체 전 또는 대체 후 형식으로 반환합니다. 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에 인코딩하고 삽입합니다. 값에 식별자가 누락된 경우 식별자가 생성됩니다.

    선언

    Swift

    public func insertOne(_ document: Document) async throws -> AnyBSON

    매개변수

    document

    삽입할 Document 값입니다.

    반환 값

    삽입된 문서의 객체 ID입니다.

  • insertMany(_:) 비동기식

    제공된 값을 BSON에 인코딩하고 삽입합니다. 식별자가 누락된 값이 있으면 생성됩니다.

    선언

    Swift

    public func insertMany(_ documents: [Document]) async throws -> [AnyBSON]

    매개변수

    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에 대해 집계 프레임워크 파이프라인을 실행합니다.

    선언

    Swift

    public func aggregate(pipeline: [Document]) async throws -> [Document]

    매개변수

    pipeline

    수행할 애그리게이션 작업의 파이프라인을 포함하는 Documents 으)로 구성된 bson 배열입니다.

    반환 값

    애그리게이션 연산의 Document 결과의 배열입니다.

  • count(filter:limit:) 비동기식

    이 collection에서 제공된 필터와 일치하는 문서 수를 계산합니다.

    선언

    Swift

    public func count(filter: Document, limit: Int? = nil) async throws -> Int

    매개변수

    filter

    쿼리와 일치해야 하는 Document as bson입니다.

    limit

    계산할 문서의 최대 개수

    반환 값

    필터와 일치하는 문서 수입니다.

  • collection에서 일치하는 단일 문서를 삭제합니다.

    선언

    Swift

    public func deleteOneDocument(filter: Document) async throws -> Int

    매개변수

    filter

    쿼리와 일치해야 하는 Document as bson입니다.

    반환 값

    Int 삭제된 문서 수입니다.

  • 여러 문서 삭제

    선언

    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이면 쿼리와 일치하는 문서가 없는 경우 새 문서를 만듭니다.

    반환 값

    UpdateResultupdateOne 작업의 결과입니다.

  • 이 collection에 제공된 필터와 일치하는 여러 문서를 업데이트합니다.

    선언

    Swift

    public func updateManyDocuments(filter: Document,
                                    update: Document,
                                    upsert: Bool? = nil) async throws -> UpdateResult

    매개변수

    filter

    일치 기준을 나타내는 bson Document 입니다.

    update

    일치하는 문서에 적용될 업데이트를 나타내는 bson Document 입니다.

    upsert

    true이면 쿼리와 일치하는 문서가 없는 경우 새 문서를 만듭니다.

    반환 값

    UpdateResultupdateMany 작업의 결과입니다.

  • 쿼리 필터를 기반으로 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에 인코딩하고 삽입합니다. 값에 식별자가 누락된 경우 식별자가 생성됩니다.

    선언

    Swift

    func insertOne(_ document: Document) -> Future<AnyBSON, Error>

    매개변수

    document

    삽입할 Document 값입니다.

    반환 값

    최종적으로 삽입된 문서의 객체 ID 또는 Error 를 반환하는 출판사입니다.

  • 제공된 값을 BSON에 인코딩하고 삽입합니다. 식별자가 누락된 값이 있으면 생성됩니다.

    선언

    Swift

    func insertMany(_ documents: [Document]) -> Future<[AnyBSON], Error>

    매개변수

    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에서 제공된 필터와 일치하는 문서를 찾습니다.

    선언

    Swift

    func find(filter: Document) -> Future<[Document], Error>

    매개변수

    filter

    쿼리와 일치해야 하는 Document as bson입니다.

    반환 값

    최종적으로 문서의 [ObjectId] 또는 Error 을 반환하는 출판사입니다.

  • 컬렉션 또는 보기에서 제공된 필터와 일치하는 문서 하나를 반환합니다. 여러 문서가 쿼리를 충족하는 경우, 이 메서드는 쿼리의 정렬 순서 또는 기본 순서에 따라 첫 번째 문서를 반환합니다.

    선언

    Swift

    func findOneDocument(filter: Document, options: FindOptions) -> Future<Document?, Error>

    매개변수

    filter

    쿼리와 일치해야 하는 Document as bson입니다.

    options

    FindOptions 명령을 실행할 때 사용합니다.

    반환 값

    최종적으로 Document 또는 Error 을(를) 반환하는 출판사입니다.

  • 컬렉션 또는 보기에서 제공된 필터와 일치하는 문서 하나를 반환합니다. 여러 문서가 쿼리를 충족하는 경우, 이 메서드는 쿼리의 정렬 순서 또는 기본 순서에 따라 첫 번째 문서를 반환합니다.

    선언

    Swift

    func findOneDocument(filter: Document) -> Future<Document?, Error>

    매개변수

    filter

    쿼리와 일치해야 하는 Document as bson입니다.

    반환 값

    문서를 찾을 수 없는 경우 Document 또는 nil 또는 Error 를 반환하는 출판사입니다.

  • 이 collection에 대해 집계 프레임워크 파이프라인을 실행합니다.

    선언

    Swift

    func aggregate(pipeline: [Document]) -> Future<[Document], Error>

    매개변수

    pipeline

    수행할 애그리게이션 작업의 파이프라인을 포함하는 Documents 으)로 구성된 bson 배열입니다.

    반환 값

    최종적으로 Document 또는 Error 을(를) 반환하는 출판사입니다.

  • 이 collection에서 제공된 필터와 일치하는 문서 수를 계산합니다.

    선언

    Swift

    func count(filter: Document, limit: Int) -> Future<Int, Error>

    매개변수

    filter

    쿼리와 일치해야 하는 Document as bson입니다.

    limit

    계산할 문서의 최대 개수

    반환 값

    최종적으로 Int 개의 문서 수 또는 Error 를 반환하는 출판사입니다.

  • 이 collection에서 제공된 필터와 일치하는 문서 수를 계산합니다.

    선언

    Swift

    func count(filter: Document) -> Future<Int, Error>

    매개변수

    filter

    쿼리와 일치해야 하는 Document as bson입니다.

    반환 값

    최종적으로 Int 개의 문서 수 또는 Error 를 반환하는 출판사입니다.

  • collection에서 일치하는 단일 문서를 삭제합니다.

    선언

    Swift

    func deleteOneDocument(filter: Document) -> Future<Int, Error>

    매개변수

    filter

    쿼리와 일치해야 하는 Document as bson입니다.

    반환 값

    최종적으로 Int 의 삭제된 문서 수 또는 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>

    매개변수

    filter

    일치 기준을 나타내는 bson Document 입니다.

    update

    일치하는 문서에 적용될 업데이트를 나타내는 bson Document 입니다.

    반환 값

    최종적으로 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>

    매개변수

    filter

    일치 기준을 나타내는 bson Document 입니다.

    update

    일치하는 문서에 적용될 업데이트를 나타내는 bson Document 입니다.

    반환 값

    최종적으로 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 과 달리 이 조치를 사용하면 동일한 명령을 사용하여 원자적으로 문서를 찾고, 업데이트하고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.

    선언

    Swift

    func findOneAndUpdate(filter: Document, update: Document) -> Future<Document?, Error>

    매개변수

    filter

    일치 기준을 나타내는 bson Document 입니다.

    update

    일치하는 문서에 적용될 업데이트를 나타내는 bson Document 입니다.

    반환 값

    문서를 찾을 수 없는 경우 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 과 달리 이 작업을 사용하면 동일한 명령을 사용하여 원자적으로 문서를 찾고, 바꾸고, 반환할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 업데이트 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.

    선언

    Swift

    func findOneAndReplace(filter: Document, replacement: Document) -> Future<Document?, Error>

    매개변수

    filter

    쿼리와 일치해야 하는 Document 입니다.

    replacement

    대체를 설명하는 Document 입니다.

    반환 값

    문서를 찾을 수 없는 경우 Document 또는 nil 또는 Error 를 반환하는 출판사입니다.

  • 쿼리 필터를 기반으로 컬렉션에서 단일 문서를 제거하고 삭제되기 직전의 문서와 동일한 형식의 문서를 반환합니다. deleteOneDocument 와 달리 이 작업을 사용하면 동일한 명령으로 문서를 원자적으로 찾고 삭제할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 삭제 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.

    선언

    Swift

    func findOneAndDelete(filter: Document, options: FindOneAndModifyOptions) -> Future<Document?, Error>

    매개변수

    filter

    쿼리와 일치해야 하는 Document 입니다.

    options

    FindOneAndModifyOptions 명령을 실행할 때 사용합니다.

    반환 값

    문서를 찾을 수 없는 경우 Document 또는 nil 또는 Error 를 반환하는 출판사입니다.

  • 쿼리 필터를 기반으로 컬렉션에서 단일 문서를 제거하고 삭제되기 직전의 문서와 동일한 형식의 문서를 반환합니다. deleteOneDocument 와 달리 이 작업을 사용하면 동일한 명령으로 문서를 원자적으로 찾고 삭제할 수 있습니다. 이렇게 하면 별도의 찾기 작업과 삭제 작업 간에 다른 업데이트 작업으로 인해 문서가 변경되는 위험을 방지할 수 있습니다.

    선언

    Swift

    func findOneAndDelete(filter: Document) -> Future<Document?, Error>

    매개변수

    filter

    쿼리와 일치해야 하는 Document 입니다.

    반환 값

    문서를 찾을 수 없는 경우 Document 또는 nil 또는 Error 를 반환하는 출판사입니다.