CRUD & 집계 API

이 페이지의 내용

개요

CRUD 작업
쿼리 연산자
연산자 업데이트
대량 쓰기 작업
쿼리 옵션
집계
집계 메서드
집계 파이프라인 가용성
집계 파이프라인 연산자 가용성
데이터베이스 명령
데이터베이스 명령 가용성

Atlas Device Sync, 데이터 API 및 HTTPS 엔드포인트는 더 이상 사용되지 않습니다. 자세한 내용은지원 중단 페이지를 참조하세요.

개요

이 페이지에서는 MongoDB 명령, 연산자, 옵션 및 집계 단계에 대한 MongoDB 데이터 소스 지원 목록을 확인하실 수 있습니다.

함수에서 MongoDB의 데이터를 읽고 쓰는 방법에 대한 자세한 내용은 MongoDB Atlas 쿼리를 참조하세요.

지원되는 기능 및 제한 사항에 대한 자세한 내용은 서비스 제한 사항을 참조하세요.

참고

작업 지원은 애플리케이션 사용자로 작업을 실행하는지, 시스템 사용자로 작업을 실행하는지에 따라 달라질 수 있습니다.

사용자 기능은 특정 애플리케이션 사용자의 컨텍스트에서 실행되며 데이터 액세스 권한 및 스키마 유효성 검사를 집행하므로 일부 작업을 수행할 수 없게 됩니다.
시스템 기능은 시스템 사용자로 실행되며, 규칙이나 스키마 유효성 검사의 대상이 아닙니다. 일부 작업은 시스템 기능에서만 사용할 수 있습니다.

CRUD 작업

쿼리 연산자

Atlas App Services 는 사용자 함수 에서 실행 되는 쿼리에 대해 대부분의쿼리 연산자 를 지원합니다. 그러나 일부 평가 연산자와 모든 지리 공간적 연산자 및 비트 연산자는 시스템 기능에서만 사용할 수 있습니다.

비교 연산자 가용성

작업	사용자 기능	시스템 기능
$eq	예	예
$gt	예	예
$gte	예	예
$in	예	예
$lt	예	예
$lte	예	예
$ne	예	예
$nin	예	예

논리 연산자 가용성

작업	사용자 기능	시스템 기능
$and	예	예
$not	예	예
$nor	예	예
$or	예	예

배열 연산자 가용성

작업	사용자 기능	시스템 기능
$all	예	예
$elemMatch	예	예
$size	예	예

요소 연산자 가용성

작업	사용자 기능	시스템 기능
$exists	예	예
$type	예	예

평가 연산자 가용성

작업	사용자 기능	시스템 기능
$mod	예	예
$expr	No	예
$jsonSchema	No	예
정규식	No	예
$text	No	예
어디	No	예

지리 공간적 연산자 가용성

작업	사용자 기능	시스템 기능
$geoIntersects	No	예
$geoWithin	No	예
$near	No	예
$nearSphere	No	예

비트 단위 연산자 가용성

작업	사용자 기능	시스템 기능
$bitsAllClear	No	예
$bitsAllSet	No	예
$bitsAnyClear	No	예
$bitsAnySet	No	예

연산자 업데이트

Atlas App Services는 사용자 함수 에서 실행되는 쿼리에 대해 대부분의 업데이트 연산자 를 지원합니다. 그러나 일부 배열 업데이트 연산자는 시스템 기능에서만 사용할 수 있습니다.

필드 업데이트 연산자 가용성

작업	사용자 기능	시스템 기능
$currentDate	예	예
$inc	예	예
$min	예	예
$max	예	예
$mul	예	예
$rename	예	예
$set	예	예
$setOnInsert	예	예
$unset	예	예

배열 업데이트 연산자 가용성

작업	사용자 기능	시스템 기능
$ (위치 업데이트)	예	예
$addToSet	예	예
$pop	예	예
$pull	예	예
$push	예	예
$pullAll	예	예
$[] (모든 위치 업데이트)	예	예
$[element] (필터링된 위치 업데이트)	예	예

배열 업데이트 연산자 수정자 가용성

Modifier	사용자 기능	시스템 기능
$each	예	예
$position	예	예
$slice	예	예
$sort	예	예

비트 단위 업데이트 연산자 가용성

연산자	사용자 기능	시스템 기능
비트	예	예

대량 쓰기 작업

App Services 는 MongoDB Node.js 운전자 와 동일한 API 를 사용하여 대량 쓰기 (write) 작업을 지원합니다.

팁

App Services는 또한 대량 쓰기 작업을 위한 collection.bulkWrite() 메서드를 제공합니다.

순서가 지정된 대량 쓰기 작업 가용성

컬렉션.initializeOrderedBulkOp() 를 호출하여 순서가 지정된 대량 작업을 정의합니다. 및 OrderedBulkOperation 조작 반환하는 객체 입니다.

App Services는 다음 OrderedBulkOperation 메서드를 지원합니다.

작업	사용자 기능	시스템 기능
실행	예	예
찾기	예	예
insert	예	예

순서가 지정되지 않은 대량 쓰기 작업 가용성

컬렉션.initializeUnorderedBulkOp() 를 호출하여 순서가 지정되지 않은 대량 작업을 정의합니다. 및 OrderedBulkOperation 조작 반환하는 객체 입니다.

App Services는 다음 UnorderedBulkOperation 메서드를 지원합니다.

작업	사용자 기능	시스템 기능
실행	예	예
찾기	예	예
insert	예	예

쿼리 옵션

App Services는 사용자 기능의 CRUD 작업에 대해 다음 옵션 구성을 지원하지 않습니다. 시스템 기능에서는 모든 쿼리 옵션을 사용할 수 있습니다.

쿼리 옵션 가용성

옵션	사용자 컨텍스트	시스템 컨텍스트
읽기 격리 (읽기 고려)	No	예
쓰기 확인 응답 (쓰기 고려)	No	예
데이터 정렬	No	예

집계

집계 메서드

App Services는 다음 명령을 사용하여 데이터베이스 및 컬렉션 수준 모두에서 집계를 지원합니다.

집계 파이프라인 가용성

시스템 사용자 는 $indexStats 을 제외한 모든 집계 파이프라인 단계 를 사용할 수 있습니다. 그러나 App Services 는 애플리케이션 사용자 의 컨텍스트에서 집계 파이프라인 을 실행 때 다음 집계 파이프라인 단계 를 지원 하지 않습니다.

작업	참고 사항
$collStats
$facet
$geoNear
$graphLookup
$indexStats
$lookup
$merge
$out	By default, `$merge` and `$out` route the entire aggregation operation to the cluster's primary node. If you want to force these stages to respect your configured cluster read preference, set the `enforceReadPref` option to `true`.
MongoDB 집계 파이프라인 단계를 사용하여	App Services performs `$search` operations as a system user and enforces field-level rules on the returned search results. This means that a user may search on a field for which they do not have read access. In this case, the search is based on the specified field but no returned documents include the field. The $$SEARCH_META aggregation variable is only available for functions that run as system or if the first role on the searched collection has its `apply_when` and `read` expressions set to `true`. If neither of these two scenarios apply, `$$SEARCH_META` is undefined and the aggregation will fail.
$unionWith

집계 파이프라인 연산자 가용성

Atlas App Services는 시스템 사용자 컨텍스트에서 집계 파이프라인을 실행할 때 모든 집계 파이프라인 연산자 를 지원합니다.

App Services는 다음 연산자를 제외하고 애플리케이션 사용자 컨텍스트에서 모든 파이프라인 연산자를 지원합니다.

데이터베이스 명령

App Services 는 클라이언트 SDK 또는 함수 에서 데이터베이스 명령 을 지원 하지 않습니다. 그러나 App Services 유선 프로토콜을 통해 MongoDB cluster 에 연결된 경우 데이터베이스 명령의 제한된 하위 집합을 호출할 수 있습니다.

다음의 데이터베이스 명령은 유선 프로토콜을 통해 부분적으로 지원됩니다. 각 명령에 대해 지원되지 않는 옵션이 아래에 나열되어 있습니다.

참고

App Services Apps는 데이터베이스에서 admin 명령을 실행할 수 없습니다.

데이터베이스 명령 가용성

명령	지원되지 않는 옵션	App Services 관련 옵션
찾기	`hint` `skip` `batchSize` `comment` `maxScan` `maxTimeMS` `readConcern` `max` `min` `returnKey` `showRecordId` `tailable` `awaitData` `oplogReplay` `noCursorTimeout` `allowPartialResults` `collation`
집계	`distinct` `explain` `allowDiskUse` [1] `readConcern` `collation` `bypassDocumentValidation` `hint` `comment` `writeConcern`	`enforceReadPref`
카운트	`limit` `skip` `hint` `readConcern`
insert	`writeConcern` `bypassDocumentValidation`
update	`bypassDocumentValidation` `collation`
삭제	`collation`

[1]	App Services는 시스템 수준 권한이 있는 Function 또는 Triggers에서 실행될 `allowDiskUse`를 지원합니다.

돌아가기

MongoDB 데이터 소스에 연결

클라이언트 앱에서 Atlas 쿼리