Docs Menu
Docs Home
/ /
Atlas CLI
/ / /

Atlas API queryShapeInsights getGroupClusterQueryShapeInsightSummaries

공개 미리 보기: 피드백 제공하세요: 지정된 클러스터에 대한 쿼리 형태 통계 요약 목록을 반환합니다.

MongoDB Atlas Admin API 에서 자동으로 생성된 Atlas API 하위 명령은 Admin API 에 대한 전체 범위를 제공하며 현재 Public Preview(공개 미리 보기) 중입니다( 피드백 https://피드백.mongodb.com/forums/930808-Atlas-cli). 관리자 API 기능에는 자체 출시하다 수명 주기가 있으며, 이는 제공된 API 엔드포인트 문서 링크를 통해 확인할 수 있습니다.

쿼리 형태 통계는 MongoDB 쿼리에 대한 성능 인사이트를 제공하여 사용자가 문제가 있는 쿼리 패턴과 잠재적 최적화를 식별하는 데 도움이 됩니다.

이 명령은 자동으로 생성되며 1:1 Atlas API 엔드포인트 https://www.mongodb.com/ko-kr/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterqueryshapeinsightsummaries에 해당합니다. .

자세한 내용과 예시는 위에 링크된 참조 API 문서를 참조하세요.

명령 구문
atlas api queryShapeInsights getGroupClusterQueryShapeInsightSummaries [options]
이름
유형
필수 사항
설명

--clusterName

문자열

true

클러스터를 식별하는 사람이 읽을 수 있는 라벨입니다.

--commands

&

거짓

지정된 MongoDB 명령과 일치하는 쿼리 형태 통계를 조회합니다. 여러 명령을 포함하려면 각 명령 사이에 앰퍼샌드(&)로 구분하여 매개변수를 여러 번 전달합니다. 현재 지원되는 매개변수는 찾기, 고유, 애그리게이션입니다. 지원되는 모든 명령에 대한 결과를 반환하려면 이 매개변수를 생략합니다.

--envelope

envelope

거짓

애플리케이션이 응답을 엔벨로프 JSON 객체 로 래핑할지 여부를 나타내는 플래그입니다. 일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스 할 수 없습니다. 이 문제를 해결하려면 쿼리 에서 envelope=true 를 설정하다 . 결과 목록을 반환하는 엔드포인트는 결과 객체 엔벨로프로 사용합니다. 애플리케이션은 응답 본문에 상태 매개변수를 추가합니다.

--groupId

문자열

true

프로젝트 식별하는 고유한 24-16진수 문자열입니다. [/groups](# 태그를 지정하다 /Projects/operation/listProjects) 엔드포인트를 사용하여 인증된 사용자가 액세스 할 수 있는 모든 프로젝트를 조회 .

참고: 그룹과 프로젝트는 동의어입니다. 그룹 ID는 프로젝트 ID와 동일합니다. 기존 그룹의 경우, 그룹/프로젝트 ID는 동일하게 유지됩니다. 리소스 및 해당 엔드포인트는 그룹이라는 용어를 사용합니다.

-h, --help

거짓

getGroupClusterQueryShapeInsightSummaries에 대한 도움말

--nSummaries

int

거짓

반환할 쿼리 통계 요약의 최대 개수입니다.

--namespaces

.

거짓

쿼리 형태 통계를 조회 할 네임스페이스입니다. 네임스페이스 데이터베이스 한 개와 .: <database>.<collection>로 작성된 컬렉션 리소스 한 개로 구성됩니다. 여러 네임스페이스를 포함하려면 각 네임스페이스 사이에 앰퍼샌드(&)로 구분하여 매개변수를 여러 번 전달합니다. 모든 네임스페이스에 대한 결과를 반환하려면 이 매개변수를 생략합니다.

-o, --output

문자열

거짓

기본 설정 API 형식은 ["JSON", go- Template] 일 수 있습니다. 이 값의 기본값은 "JSON" 입니다.

--outputFile

문자열

거짓

API 출력을 쓰기 (write) 파일 입니다. 이 플래그는 엔드포인트의 출력이 바이너리(예: gzip)이고 명령이 파이프되지 않은 경우(예: Atlas 명령 > out.zip)에 필요합니다.

--pretty

거짓

응답 본문이 프리티프린트 형식이어야 하는지 여부를 나타내는 플래그입니다.

--processIds

mongod

거짓

쿼리 형태 통계를 조회 할 ProcessIds입니다. processId는 MongoDB 프로세스 제공하는 호스팅하다 와 포트의 조합입니다. 호스팅하다 MongoDB 프로세스 (mongod 또는 mongos)를 실행하는 호스팅하다 의 호스트 이름, FQDN, IPv4 주소 또는 IPv6 주소 여야 합니다. 포트는 MongoDB 프로세스 요청을 수신하는 IANA 포트여야 합니다. 여러 processId를 포함하려면 각 processId 사이에 앰퍼샌드(&)로 구분하여 매개변수를 여러 번 전달합니다.

--queryShapeHashes

&

거짓

원하는 쿼리 형태의 SHA256 해시 목록, $queryStats 및 $explain 또는 느린 쿼리 로그와 같은 MongoDB 명령의 출력입니다. 여러 시리즈를 포함하려면 각 시리즈 사이에 앰퍼샌드(&)로 구분하여 매개변수를 여러 번 전달합니다. 사용 가능한 모든 시리즈에 대한 결과를 반환하려면 이 매개변수를 생략합니다.

--series

&

거짓

조회 형태 통계 데이터 시리즈를 쿼리합니다. 시리즈는 쿼리 실행에 대한 특정 지표를 나타냅니다. 여러 시리즈를 포함하려면 각 시리즈 사이에 앰퍼샌드(&)로 구분하여 매개변수를 여러 번 전달합니다. 사용 가능한 모든 시리즈에 대한 결과를 반환하려면 이 매개변수를 생략합니다.

--since

int

거짓

쿼리 형태 통계를 조회 할 날짜 및 시간입니다. 이 매개변수는 [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time) 이후 경과된 시간(밀리초)으로 값을 표현합니다.

  • until 매개변수를 지정하지 않으면 엔드포인트는 since 값과 현재 시간을 포함하는 데이터를 반환합니다.

  • since 또는 until 매개 변수를 지정하지 않으면 엔드포인트는 이전 24시간 동안의 데이터를 반환합니다.

--until

int

거짓

쿼리 형태 통계를 조회 할 최대 날짜 및 시간입니다. 이 매개변수는 [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time) 이후 경과된 시간(밀리초)으로 값을 표현합니다.

  • until 매개변수를 지정하는 경우 since 매개변수를 지정해야 합니다.

  • since 또는 until 매개 변수를 지정하지 않으면 엔드포인트는 이전 24시간 동안의 데이터를 반환합니다.

--version

문자열

거짓

API 호출 시 사용할 API 버전 [옵션: "2025-03-12"], 기본값은 최신 버전 또는 프로필 api_version 구성 값( 설정하다 경우) 이 값 기본값은 '2025-03-12".

이름
유형
필수 사항
설명

-P, --profile

문자열

거짓

구성 파일 에서 사용할 프로필의 이름입니다. Atlas CLI 의 프로필에 대해 학습 https://dochub.mongodb.org/core/atlas-cli-save-connection-settings를 참조하세요.

atlas api queryShapeInsights getGroupClusterQueryShapeInsightSummaries --version 2025-03-12 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8

돌아가기

getGroupClusterQueryShapeInsightDetails

이 페이지의 내용