giip
SES Proposal
2 min read

CQE ์‹คํ–‰ ์ด๋ ฅ ๊ฐ€์ด๋“œ

CQE(Custom Query Engine) ์Šคํฌ๋ฆฝํŠธ๊ฐ€ ์—ฌ๋Ÿฌ ์„œ๋ฒ„์—์„œ ์‹คํ–‰๋œ ์ด๋ ฅ์„ ์กฐํšŒํ•˜๊ณ  ํŽ˜์ด์ง€ ๋‹จ์œ„๋กœ ์‚ดํŽด๋ณด๋Š” ๋ฐฉ๋ฒ•์„ ์•ˆ๋‚ดํ•ฉ๋‹ˆ๋‹ค.

๐Ÿš€ CQE ์‹คํ–‰ ์ด๋ ฅ ํŽ˜์ด์ง€๋กœ ์ด๋™ โ†’

๐Ÿ“‹ ๊ฐœ์š”

CQE Run List๋Š” CQE ์Šคํฌ๋ฆฝํŠธ๊ฐ€ ๊ฐ ๋…ผ๋ฆฌ ์„œ๋ฒ„(LSVR)์—์„œ ์‹คํ–‰๋œ ๊ธฐ๋ก์„ ์ตœ์‹ ์ˆœ์œผ๋กœ ๋ณด์—ฌ์ฃผ๋Š” ์กฐํšŒ ํ™”๋ฉด์ž…๋‹ˆ๋‹ค. ์‹คํ–‰ ์ด๋ ฅ์„ ํŽ˜์ด์ง€ ๋‹จ์œ„๋กœ ๋„˜๊ฒจ๋ณด๋ฉฐ ์–ด๋–ค ์Šคํฌ๋ฆฝํŠธ๊ฐ€ ์–ธ์ œ ์–ด๋А ์„œ๋ฒ„์—์„œ ์ฒ˜๋ฆฌ๋˜์—ˆ๋Š”์ง€ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ด ํŽ˜์ด์ง€๋Š” ๋กœ๊ทธ์ธ๊ณผ ํ”„๋กœ์ ํŠธ ์„ ํƒ์ด ์ „์ œ๋ฉ๋‹ˆ๋‹ค. ์ƒ๋‹จ์—์„œ ํ”„๋กœ์ ํŠธ(csn)๊ฐ€ ์„ ํƒ๋˜์–ด ์žˆ์ง€ ์•Š์œผ๋ฉด ๋ชฉ๋ก ๋Œ€์‹  ์•ˆ๋‚ด ๋ฉ”์‹œ์ง€๊ฐ€ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค.

๐Ÿ” ํ™”๋ฉด ๊ตฌ์„ฑ

1. ์˜คํ”„์…‹ (Offset)

์กฐํšŒ๋ฅผ ์‹œ์ž‘ํ•  ์œ„์น˜๋ฅผ ์ง€์ •ํ•˜๋Š” ์ˆซ์ž ์ž…๋ ฅ๋ž€์ž…๋‹ˆ๋‹ค. 0์ด ๊ฐ€์žฅ ์ตœ๊ทผ ๊ธฐ๋ก์˜ ์‹œ์ž‘์ ์ด๋ฉฐ, ๊ฐ’์„ ๋Š˜๋ฆฌ๋ฉด ๋” ์ด์ „ ๊ธฐ๋ก๋ถ€ํ„ฐ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค.

2. ์‹คํ–‰ (Run)

ํ˜„์žฌ ์˜คํ”„์…‹ ๊ฐ’์œผ๋กœ ์‹คํ–‰ ์ด๋ ฅ์„ ๋‹ค์‹œ ๋ถˆ๋Ÿฌ์˜ต๋‹ˆ๋‹ค. ์กฐํšŒ ์ค‘์—๋Š” ๋ฒ„ํŠผ์ด ๋กœ๋”ฉ ์ƒํƒœ๋กœ ๋ฐ”๋€๋‹ˆ๋‹ค.

3. ์ด์ „ / ๋‹ค์Œ (Prev / Next)

ํ•œ ํŽ˜์ด์ง€๋Š” 15๊ฑด ๋‹จ์œ„๋กœ ๊ตฌ์„ฑ๋ฉ๋‹ˆ๋‹ค. [๋‹ค์Œ]์€ ์˜คํ”„์…‹์„ 15๋งŒํผ ๋Š˜๋ฆฌ๊ณ , [์ด์ „]์€ 15๋งŒํผ ์ค„์—ฌ(์ตœ์†Œ 0) ํŽ˜์ด์ง€๋ฅผ ์ด๋™ํ•ฉ๋‹ˆ๋‹ค.

4. ๊ฒฐ๊ณผ ํ…Œ์ด๋ธ”

๋ถˆ๋Ÿฌ์˜จ ์‹คํ–‰ ์ด๋ ฅ์ด ํ‘œ ํ˜•ํƒœ๋กœ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค. ๋ฐ์Šคํฌํ†ฑ์—์„œ๋Š” ํ…Œ์ด๋ธ”, ๋ชจ๋ฐ”์ผ์—์„œ๋Š” ์นด๋“œ ํ˜•ํƒœ๋กœ ๋‚˜ํƒ€๋‚ฉ๋‹ˆ๋‹ค. ์„œ๋ฒ„(๋…ผ๋ฆฌ ๋จธ์‹ ) ํ•ญ๋ชฉ์€ ๋งํฌ๋กœ ํ‘œ์‹œ๋˜๋ฉฐ, ํด๋ฆญํ•˜๋ฉด ํ•ด๋‹น ์„œ๋ฒ„์˜ ์ƒ์„ธ ํŽ˜์ด์ง€๋กœ ์ด๋™ํ•ฉ๋‹ˆ๋‹ค. ์‘๋‹ต์„ ํ‘œ๋กœ ํ•ด์„ํ•  ์ˆ˜ ์—†๋Š” ๊ฒฝ์šฐ์—๋Š” ์›๋ณธ ํ…์ŠคํŠธ๊ฐ€ ๊ทธ๋Œ€๋กœ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค.

๐Ÿ› ๏ธ ํ™œ์šฉ ํŒ

  • ์ตœ๊ทผ๋ถ€ํ„ฐ ํ›‘๊ธฐ: ์˜คํ”„์…‹์„ 0์œผ๋กœ ๋‘๊ณ  [์‹คํ–‰]์„ ๋ˆŒ๋Ÿฌ ๊ฐ€์žฅ ์ตœ๊ทผ ์‹คํ–‰๋ถ€ํ„ฐ ํ™•์ธํ•œ ๋’ค, [๋‹ค์Œ]์œผ๋กœ ๊ณผ๊ฑฐ ๊ธฐ๋ก์„ ๋„˜๊ฒจ๋ด…๋‹ˆ๋‹ค.
  • ์„œ๋ฒ„๋กœ ๋ฐ”๋กœ ์ด๋™: ํŠน์ • ์‹คํ–‰์ด ๋ฌธ์ œ๋กœ ๋ณด์ด๋ฉด ํ•ด๋‹น ํ–‰์˜ ์„œ๋ฒ„ ๋งํฌ๋ฅผ ๋ˆŒ๋Ÿฌ ์„œ๋ฒ„ ์ƒ์„ธ์—์„œ ์ƒํƒœ๋ฅผ ์ด์–ด์„œ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

๐Ÿ’ก ์œ ์˜ ์‚ฌํ•ญ

  • ๋ชฉ๋ก ๋Œ€์‹  "ํ”„๋กœ์ ํŠธ๊ฐ€ ์„ ํƒ๋˜์ง€ ์•Š์•˜์Šต๋‹ˆ๋‹ค(csn)" ์•ˆ๋‚ด๊ฐ€ ๋ณด์ด๋ฉด ์ƒ๋‹จ์—์„œ ํ”„๋กœ์ ํŠธ๋ฅผ ๋จผ์ € ์„ ํƒํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.
  • ์Šคํฌ๋ฆฝํŠธ์˜ ๋“ฑ๋กยท์‹คํ–‰ ์„ค์ •(ํ™œ์„ฑ/๋ฐ˜๋ณต/๊ฐ„๊ฒฉ)์€ ์ด ํŽ˜์ด์ง€๊ฐ€ ์•„๋‹ˆ๋ผ CQE ๋ ˆํฌ์ง€ํ† ๋ฆฌ ๋ชฉ๋ก์—์„œ ๊ด€๋ฆฌํ•ฉ๋‹ˆ๋‹ค.

API ์ฐธ์กฐ

์ด ๊ธฐ๋Šฅ์˜ API ์ƒ์„ธ ์‚ฌ์–‘์€ ๋ณ„๋„ ๊ฐ€์ด๋“œ๋ฅผ ์ฐธ์กฐํ•˜์„ธ์š”.

๐Ÿ“˜ ์‹œ์Šคํ…œ ๊ด€๋ฆฌ API ๋ ˆํผ๋Ÿฐ์Šค

๋ฌธ์ œ ํ•ด๊ฒฐ

์ฆ์ƒ์›์ธํ•ด๊ฒฐ
๋ชฉ๋ก ๋Œ€์‹  "ํ”„๋กœ์ ํŠธ๊ฐ€ ์„ ํƒ๋˜์ง€ ์•Š์•˜์Šต๋‹ˆ๋‹ค(csn)"๊ฐ€ ํ‘œ์‹œ๋จ์„ธ์…˜์— ์„ ํƒ๋œ ํ”„๋กœ์ ํŠธ(csn)๊ฐ€ ์—†์Œ์ƒ๋‹จ์—์„œ ํ”„๋กœ์ ํŠธ๋ฅผ ์„ ํƒํ•œ ๋’ค [์‹คํ–‰]์„ ๋‹ค์‹œ ๋ˆ„๋ฆ…๋‹ˆ๋‹ค.
๊ฒฐ๊ณผ๊ฐ€ ํ‘œ๊ฐ€ ์•„๋‹Œ ์›๋ณธ ํ…์ŠคํŠธ๋กœ ํ‘œ์‹œ๋จ์‘๋‹ต์„ ํ‘œ ํ˜•ํƒœ๋กœ ํ•ด์„ํ•  ์ˆ˜ ์—†๊ฑฐ๋‚˜ ์˜ค๋ฅ˜ ๋ฉ”์‹œ์ง€๊ฐ€ ๋ฐ˜ํ™˜๋จํ‘œ์‹œ๋œ ์›๋ณธ ํ…์ŠคํŠธ์˜ ๋‚ด์šฉ์„ ํ™•์ธํ•˜๊ณ , ์˜คํ”„์…‹์„ ์กฐ์ •ํ•ด ๋‹ค์‹œ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค.
[๋‹ค์Œ]์„ ๋ˆŒ๋Ÿฌ๋„ ์ƒˆ ๊ธฐ๋ก์ด ์—†์Œํ•ด๋‹น ์˜คํ”„์…‹ ์ดํ›„์— ๋” ์ด์ƒ ์‹คํ–‰ ์ด๋ ฅ์ด ์—†์Œ[์ด์ „]์œผ๋กœ ๋Œ์•„๊ฐ€๊ฑฐ๋‚˜ ์˜คํ”„์…‹์„ 0์œผ๋กœ ๋˜๋Œ๋ฆฝ๋‹ˆ๋‹ค.
์„œ๋ฒ„ ํ•ญ๋ชฉ์ด ๋งํฌ๋กœ ํ‘œ์‹œ๋˜์ง€ ์•Š์Œ์‘๋‹ต์— ์„œ๋ฒ„(๋…ผ๋ฆฌ ๋จธ์‹ ) ์‹๋ณ„ ์ปฌ๋Ÿผ์ด ์—†์Œ๊ฐ’์€ ๊ทธ๋Œ€๋กœ ํ™•์ธํ•˜๊ณ , ์„œ๋ฒ„ ์ƒ์„ธ๋Š” ๋‹ค๋ฅธ ๋ชฉ๋ก ํŽ˜์ด์ง€์—์„œ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค.

๋ฒ„์ „: 1.0 ์ตœ์ข… ์—…๋ฐ์ดํŠธ: 2026-07-22 ์†Œ์Šค ํŒŒ์ผ: giipv3/public/help/cqerunlist.ko.md