`$collStats`

이 페이지의 내용

구문

필드
출력
예시
오류

$collStats 지정된 컬렉션 에 대한 통계를 반환합니다. $collstats 은 집계 파이프라인 의 첫 번째 단계여야 합니다. 자세한 내용은 $collStats 를 참조하세요. Data Federation 에서 $collStats 는 지정된 컬렉션 또는 뷰의 파티션에 대한 정보를 조회 하는 데만 사용할 수 있습니다.

구문

Atlas Data Federation에서 $collStats 는 빈 문서를 허용합니다. 선택적 필드 count 만 지원하며 지원되지 않는 옵션이 지정된 경우 오류를 반환합니다.

db.<collection-name>|<view-name>.aggregate([{ "$collStats" : { "count" : {} } }])

필드

필드	유형	설명	필요성
`count`	문서	파티션에 있는 총 문서 수를 반환 문서에 추가합니다.	옵션

출력

$collStats 는 각 파티션에 대해 문서에서 다음 필드를 반환합니다.

필드

유형

설명

count

숫자

파티션에 있는 총 문서 수입니다. count 옵션을 지정한 경우에만 이 값이 반환됩니다.

ns

문자열

[database].[collection|view] 형식의 현재 collection 또는 뷰의 네임스페이스입니다.

partition

문서

소스, 형식, 크기, 파티션 속성(있는 경우) 등 파티션에 대한 세부 정보입니다.

partition.format

문자열

파일 의 형식입니다. 값은 cloud 저장 의 데이터에 대해 지원되는 MONGO 데이터 형식이거나 Atlas cluster 의 데이터에 대해 일 수 있습니다.

partition.attributes

문서

이 파티션의 path 파티션 속성은 cloud 저장 파티션의 에 정의되어 있습니다. 빈 문서 는 파티션의 데이터 소스 에 파티션 속성이 없음을 나타냅니다.

partition.size

int

파티션의 크기입니다.

partition.source

문자열

파티션의 소스입니다. 값은 다음 중 하나일 수 있습니다.

cloud 저장 에 있는 파일 의 경로입니다.
Atlas의 파티션에 대한 cluster 이름입니다.

partition.version

문자열

Atlas cluster의 MongoDB 버전입니다. $collStats 단계는 Atlas cluster 데이터 저장소에 대해서만 이 필드를 반환합니다. 값의 형식은 다음과 같습니다.

<major-version-number>.<minor-version-number>.<patch-version-number>

예를 들어 7.0.1입니다.

예시

다음 예시 에서는 cloud 저장 연합 데이터베이스 인스턴스 저장 의 파일이 있는 컬렉션 에서 파티션을 검색하기 위한 $collStats 구문을 보여 s3Db.abc 줍니다.3

use s3Db
db.abc.aggregate([ {$collStats: {}} ])

앞의 명령은 다음 출력을 반환합니다.

{ "ns" : "s3Db.abc", "partition" : { "format" : "JSON", "attributes" : { "year" : NumberLong(2018) }, "size" : 139, "source" : "s3://my-bucket/s3Db/abc/2018/1.json?delimiter=%2F&region=us-east-1" } }
{ "ns" : "s3Db.abc", "partition" : { "format" : "JSON", "attributes" : { "year" : NumberLong(2017) }, "size" : 124, "source" : "s3://my-bucket/s3Db/abc/2017/1.json?delimiter=%2F&region=us-east-1" } }
{ "ns" : "s3Db.abc", "partition" : { "format" : "JSON", "attributes" : { "year" : NumberLong(2017) }, "size" : 130, "source" : "s3://my-bucket/s3Db/abc/2017/2.json?delimiter=%2F&region=us-east-1" } }

다음 예시 에서는 mySandboxCluster 라는 Atlas cluster 의 atlasDb.sampleColl 컬렉션 에서 파티션을 검색하기 위한 $collStats 구문을 보여줍니다.

use atlasDb
db.sampleColl.aggregate([ {$collStats: {}} ])

앞의 명령은 다음 출력을 반환합니다.

{ "ns" : "atlasDb.sampleColl", "partition" : { "format" : "MONGO", "attributes" : {  }, "size" : 94362191, "source" : "mySandboxCluster" } }

다음 예시 는 파티션에 있는 총 문서 수를 검색하기 위한 $collStats 구문을 보여줍니다.

use s3Db
db.abc.aggregate([ {$collStats: {"count" : {} }} ])

앞의 명령은 다음 출력을 반환합니다.

{ "ns" : "atlasDb.sampleColl", "partition" : { "format" : "MONGO", "attributes" : {  }, "size" : 94362191, "source" : "mySandboxCluster" }, "count" : 23530}

오류

collStats 인수 문서에 MongoDB 서버에서는 허용되지만 Atlas Data Federation에서는 허용되지 않는 옵션이 포함된 경우 다음과 유사한 오류가 반환됩니다.

{
       "ok" : 0,
       "errmsg" : "$collStats param 'latencyStats' is not valid for Data Federation, correlationID = 1622929884a47d16f4888a1c",
       "code" : 9,
       "codeName" : "FailedToParse"
}

돌아가기

집계 파이프라인

$lookup