Azure Cosmos DB는 Microsoft의 세계적으로 유통된 멀티 모델 데이터베이스 서비스입니다. 오픈 소스 MongoDB 클라이언트 드라이버를 사용하여 Azure Cosmos DB for MongoDB와 통신할 수 있습니다. Azure Cosmos DB for MongoDB를 사용하면 MongoDB 유선 프로토콜에 따라 기존 클라이언트 드라이버를 사용할 수 있습니다.
Azure Cosmos DB for MongoDB를 사용하면 Azure Cosmos DB가 제공하는 모든 엔터프라이즈 기능과 함께 익숙한 MongoDB의 이점을 누릴 수 있습니다. 이러한 기능에는 글로벌 배포, 자동 분할, 가용성 및 대기 시간 보장, 미사용 암호화, 백업 등이 포함됩니다.
참고 항목
Azure Cosmos DB for MongoDB 버전 3.6은 현재 EOL(수명 종료) 계획이 없습니다. 향후 EOL에 대한 최소 알림은 3년입니다.
프로토콜 지원
Azure Cosmos DB for MongoDB는 새 계정의 경우 기본적으로 MongoDB 서버 버전 3.6과 호환됩니다. 지원되는 연산자 및 제한 사항이나 예외는 다음과 같습니다. 이러한 프로토콜을 인식하는 모든 클라이언트 드라이버는 Azure Cosmos DB for MongoDB에 연결할 수 있습니다. Azure Cosmos DB API for MongoDB 계정을 만드는 경우 3.6 버전의 계정에는 *.mongo.cosmos.azure.com 형식의 엔드포인트가 있지만 3.2 버전의 계정에는 *.documents.azure.com 형식의 엔드포인트가 있습니다.
쿼리 언어 지원
Azure Cosmos DB for MongoDB는 MongoDB 쿼리 언어 구문을 포괄적으로 지원합니다. 다음 섹션에서는 Azure Cosmos DB에서 현재 지원되는 서버 작업, 연산자, 단계, 명령 및 옵션에 대한 자세한 목록을 보여줍니다.
참고 항목
이 문서에서는 지원되는 서버 명령만 나열하고 클라이언트 쪽 래퍼 함수는 제외합니다. deleteMany() 및 updateMany()와 같은 클라이언트 쪽 래퍼 함수는 내부적으로 delete() 및 update() 서버 명령을 활용합니다. 지원되는 서버 명령을 활용하는 함수는 Azure Cosmos DB for MongoDB와 호환됩니다.
데이터베이스 명령
Azure Cosmos DB for MongoDB는 다음과 같은 데이터베이스 명령을 지원합니다.
$lookup은 서버 버전 3.6에 도입된 상관 관계가 없는 하위 쿼리 기능을 아직 지원하지 않습니다. let 및 pipeline 필드에서 $lookup 연산자를 사용하려고 하면 let is not supported가 포함된 오류 메시지가 표시됩니다.
부울 식
명령
지원됨
and
예
not
예
or
예
식 설정
명령
지원됨
setEquals
예
setIntersection
예
setUnion
예
setDifference
예
setIsSubset
예
anyElementTrue
예
allElementsTrue
예
비교 식
참고 항목
API for MongoDB는 쿼리에서 배열 리터럴이 있는 비교 식을 지원하지 않습니다.
명령
지원됨
cmp
예
eq
예
gt
예
gte
예
lt
예
lte
예
ne
예
in
예
nin
예
산술 식
명령
지원됨
abs
예
add
예
ceil
예
divide
예
exp
예
floor
예
ln
예
log
예
log10
예
mod
예
multiply
예
pow
예
sqrt
예
subtract
예
trunc
예
문자열 식
명령
지원됨
concat
예
indexOfBytes
예
indexOfCP
예
split
예
strLenBytes
예
strLenCP
예
strcasecmp
예
substr
예
substrBytes
예
substrCP
예
toLower
예
toUpper
예
텍스트 검색 연산자
명령
지원됨
meta
아니요
배열 식
명령
지원됨
arrayElemAt
예
arrayToObject
예
concatArrays
예
filter
예
indexOfArray
예
isArray
예
objectToArray
예
range
예
reverseArray
예
reduce
예
size
예
slice
예
zip
예
in
예
변수 연산자
명령
지원됨
map
예
let
예
시스템 변수
명령
지원됨
$$CURRENT
예
$$DESCEND
예
$$KEEP
예
$$PRUNE
예
$$REMOVE
예
$$ROOT
예
리터럴 연산자
명령
지원됨
literal
예
날짜 식
명령
지원됨
dayOfYear
예
dayOfMonth
예
dayOfWeek
예
year
예
month
예
week
예
hour
예
minute
예
second
예
millisecond
예
dateToString
예
isoDayOfWeek
예
isoWeek
예
dateFromParts
예
dateToParts
예
dateFromString
예
isoWeekYear
예
조건부 식
명령
지원됨
cond
예
ifNull
예
switch
예
데이터 형식 연산자
명령
지원됨
type
예
누적기 식
명령
지원됨
sum
예
avg
예
first
예
last
예
max
예
min
예
push
예
addToSet
예
stdDevPop
예
stdDevSamp
예
Merge 연산자
명령
지원됨
mergeObjects
예
데이터 형식
명령
지원됨
Double
예
String
예
Object
예
Array
예
Binary Data
예
ObjectId
예
Boolean
예
Date
예
Null
예
32-bit Integer (int)
예
Timestamp
예
64-bit Integer (long)
예
MinKey
예
MaxKey
예
Decimal128
예
Regular Expression
예
JavaScript
예
JavaScript (with scope)
예
Undefined
예
인덱스 및 인덱스 속성
인덱스
명령
지원됨
Single Field Index
예
Compound Index
예
Multikey Index
예
Text Index
없음
2dsphere
네
2d Index
없음
Hashed Index
아니요
인덱스 속성
명령
지원됨
TTL
예
Unique
예
Partial
없음
Case Insensitive
아니요
Sparse
아니요
Background
예
연산자
논리 연산자
명령
지원됨
or
예
and
예
not
예
nor
예
요소 연산자
명령
지원됨
exists
예
type
예
평가 쿼리 연산자
명령
지원됨
expr
예
jsonSchema
없음
mod
예
regex
예
text
아니요(지원되지 않습니다. 대신 $regex를 사용합니다.)
where
아니요
$regex 쿼리에서 왼쪽에 고정된 식은 인덱스 검색을 허용합니다. 그러나 ‘i’ 한정자(대/소문자 구분 없음) 및 ‘m’ 한정자(여러 줄)를 사용하면 모든 식에서 컬렉션 검사가 수행됩니다.
$ 또는 |를 포함해야 하는 경우 두 개 이상의 정규식 쿼리를 만드는 것이 가장 좋습니다. 예를 들어, 다음 원래 쿼리가 find({x:{$regex: /^abc$/})인 경우 이를 다음과 같이 수정해야 합니다.
find({x:{$regex: /^abc/, x:{$regex:/^abc$/}})
첫 번째 부분은 인덱스를 사용하여 ^abc로 시작하는 문서로 검색을 제한하며, 두 번째 부분은 정확한 항목의 일치를 확인합니다. 막대 연산자 |는 “or” 함수 역할을 하고, find({x:{$regex: /^abc |^def/}) 쿼리는 x 필드에 "abc" 또는 "def"로 시작하는 값이 있는 문서를 일치하는 항목으로 검색합니다. 인덱스를 사용하려면 쿼리를 $or 연산자 find( {$or : [{x: $regex: /^abc/}, {$regex: /^def/}] })에 의해 조인된 두 개의 서로 다른 쿼리로 나누는 것이 좋습니다.
배열 연산자
명령
지원됨
all
예
elemMatch
예
size
예
설명 연산자
명령
지원됨
comment
예
프로젝션 연산자
명령
지원됨
elemMatch
예
meta
없음
slice
예
업데이트 연산자
필드 업데이트 연산자
명령
지원됨
inc
예
mul
예
rename
예
setOnInsert
예
set
예
unset
예
min
예
max
예
currentDate
예
배열 업데이트 연산자
명령
지원됨
$
예
$[]
예
$[\<identifier\>]
예
addToSet
예
pop
예
pullAll
예
pull
예
push
예
pushAll
예
한정자 업데이트
명령
지원됨
each
예
slice
예
sort
예
position
예
비트 업데이트 연산자
명령
지원됨
bit
예
bitsAllSet
없음
bitsAnySet
아니요
bitsAllClear
아니요
bitsAnyClear
아니요
지리 공간적 연산자
연산자
지원됨
$geoWithin
예
$geoIntersects
예
$near
예
$nearSphere
예
$geometry
예
$minDistance
예
$maxDistance
예
$center
없음
$centerSphere
아니요
$box
아니요
$polygon
아니요
정렬 작업
findOneAndUpdate 작업을 사용하는 경우 단일 필드에 대한 정렬 작업이 지원되지만 여러 필드에 대한 정렬 작업은 지원되지 않습니다.
인덱싱
API for MongoDB는 여러 필드에 대한 정렬을 사용하도록 설정하고, 쿼리 성능을 향상시키고, 고유성을 적용할 수 있도록 다양한 인덱스를 지원합니다.
GridFS
Azure Cosmos DB는 GridFS 호환 MongoDB 드라이버를 통해 GridFS를 지원합니다.
복제
Azure Cosmos DB는 가장 낮은 계층에서 자동의 네이티브 복제를 지원합니다. 이 논리는 또한 짧은 대기 시간, 글로벌 복제를 달성하기 위해 확장됩니다. Azure Cosmos DB는 수동 복제 명령을 지원하지 않습니다.
다시 시도 가능한 쓰기
Azure Cosmos DB는 아직 다시 시도 가능한 쓰기를 지원하지 않습니다. 클라이언트 드라이버가 연결 문자열에 retryWrites=false를 추가해야 합니다.
분할
Azure Cosmos DB는 서버 측 자동 분할을 지원합니다. 분할 만들기, 배치 및 분산을 자동으로 관리합니다. Azure Cosmos DB는 수동 분할 명령을 지원하지 않으므로 addShard, balancerStart, moveChunk 등의 명령을 호출할 필요가 없습니다. 컨테이너를 만들거나 데이터를 쿼리하는 동안만 분할 키를 지정하면 됩니다.
세션
Azure Cosmos DB는 아직 서버 쪽 세션 명령을 지원하지 않습니다.
TTL(Time to Live)
Azure Cosmos DB는 문서의 타임스탬프를 기반으로 TTL(Time to Live)을 지원합니다. Azure Portal에서 컬렉션에 TTL을 사용하도록 설정할 수 있습니다.
사용자 및 역할 관리
Azure Cosmos DB는 아직 사용자 및 역할을 지원하지 않습니다. 그러나 Azure Portal의 연결 문자열 창을 통해 가져올 수 있는 Azure RBAC(Azure 역할 기반 액세스 제어)와 읽기-쓰기 및 읽기 전용 암호 또는 키를 지원합니다.
쓰기 문제
일부 애플리케이션은 쓰기 작업 중에 필요한 응답 수를 지정하는 쓰기 문제를 사용합니다. 강력한 일관성을 사용하는 경우 Azure Cosmos DB에서 복제를 처리하는 방법으로 인해 모든 쓰기는 기본적으로 과반수 쿼럼을 자동으로 사용합니다. 클라이언트 코드를 통해 지정된 모든 쓰기 문제는 무시됩니다. 자세히 알아보려면 일관성 수준을 사용하여 가용성 및 성능 최대화 문서를 참조하세요.
MongoDB