Docs Menu
Docs Home
/ /

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

์ด ํŽ˜์ด์ง€์˜ ๋‚ด์šฉ