검색 대상#
현재 Organization의 System·Service·API·Endpoint·Workflow·Database·Kafka Cluster·Kafka Topic·Repository를 찾습니다.
- 이름·요약·설명에서 찾습니다. Endpoint는 Path를, Workflow는 Key를 함께 찾습니다.
- 대소문자를 구분하지 않는 부분 일치입니다. 정규식·와일드카드·형태소 분석은 지원하지 않습니다.
- 이름이 같은 항목, 이름으로 시작하는 항목, 이름에 포함하는 항목, 요약·설명이 일치하는 항목 순으로 보여 줍니다.
- Table·Collection·Key Pattern 같은 Database 소속 구조와 스펙 문서는 검색하지 않습니다.
Web UI#
상단의 검색 창을 누르거나 ⌘K·Ctrl+K를 누릅니다. 유형별 칩으로 결과를 좁히고, 결과를 고르면 그 항목의 상세로 이동합니다.
검색어가 없으면 이 브라우저에서 최근에 연 항목을 보여 줍니다.
stly#
stly catalog search --q 주문
stly catalog search --q orders --type endpoint --limit 10| 옵션 | 내용 |
|---|---|
--q | 검색어. 빈 값이면 빈 결과입니다 |
--type | system·service·api·endpoint·workflow·database·messaging-cluster·kafka-topic·repository 중 하나로 좁힘 |
--limit | 1~50. 기본 20 |
{"status":200,"etag":null,"location":null,"data":{"items":[{"type":"api","id":"4pkKFh2ojXs","name":"Orders API","summary":"주문 생성·조회·취소 API","matched_field":"summary"}],"counts":{"api":1,"database":0,"endpoint":0,"kafka-topic":0,"messaging-cluster":0,"repository":0,"service":0,"system":0,"workflow":0},"has_more":false}}counts는 --type과 관계없이 유형별 전체 일치 건수입니다. has_more가 true이면 --limit보다 많은 결과가 있습니다.
목록 검색과의 차이#
각 Catalog의 목록 명령(stly apis list --q 등)은 그 Catalog 하나를 대소문자를 구분해 찾고 페이지를 나눠 조회합니다.
항목이 어느 Catalog에 있는지 모를 때는 통합 검색을, 한 Catalog 안에서 정렬·페이지가 필요할 때는 목록 검색을 사용합니다.