전역 검색 (Global Search)
전역 검색은 D.Hub 허브 전체를 가로지르는 단일 검색 명령 팔레트입니다. 컬렉션 경계를 넘는 데이터 자산, 온톨로지, 에이전트는 물론, 사이드바 메뉴와 페이지 자체까지 한 번의 검색으로 도달할 수 있습니다.
docs 사이트(현재 보고 있는 사용자 매뉴얼)의 검색은 별개입니다. 좌측 사이드바 상단의 검색 입력을 사용하거나 ⌘K / Ctrl+K 단축키로 docs 사이트 내 페이지·헤더를 검색하세요. docs 사이트 검색은 introduction의 검색 사용법 절을 참고하세요.
열기
- 키보드 단축키:
⌘K(macOS) 또는Ctrl+K(Windows) - 사이드바 첫 메뉴 —
검색…: 모든 페이지에서 사이드바 1급 메뉴(Home 바로 아래)로 진입합니다. 접힘 모드에서도 동일한 아이콘으로 노출됩니다. - 홈 Hero 검색 트리거: 홈 화면의 Hero 영역에 노출되는 큰 검색 버튼. 사이드바 메뉴와 동일한 모달을 엽니다.
사이드바 메뉴의 라벨은 검색… / Search… (말줄임표 …)입니다. 클릭 즉시 페이지 이동이 아니라 다이얼로그가 열림을 의미하는 관습적 표기입니다.
이전 버전의 상단 중앙 검색 입력 막대는 제거되었습니다. 화면 상단의 페이지 타이틀·도구 영역이 더 넓게 보입니다.
검색 대상
| 섹션 | 포함 유형 |
|---|---|
| 바로 가기 | 사이드바 메뉴 / 페이지 라우트 / 예제 시나리오 (예: 파이프라인 빌더, 그래프 탐색기, 설정·커넥터) |
| 카탈로그 | 컬렉션, 데이터셋, 파이프라인, 코드, 지식, 대시보드 |
| 온톨로지 | 온톨로지 모델, 엔티티, 관계 |
| 에이전트 | 에이전트, 도구(Tool), 액터(Actor) |
바로 가기 (Jump to)
자산 결과 위쪽에 표시되는 섹션으로, 사이드바 메뉴와 페이지로 즉시 이동할 수 있는 명령 팔레트입니다. 모달에는 바로 가기라는 제목으로 노출됩니다.
- 노출 방식: 검색어가 사이드바 메뉴 또는 페이지 라벨·키워드·경로에 매칭되면 상위 5건이 표시됩니다.
- 우측 뱃지: 모든 바로 가기 항목에는
페이지뱃지가 붙어 자산과 시각적으로 구분됩니다. - 즉시 노출: 자산 결과가 로딩 중이어도 바로 가기 섹션은 정적 데이터 기반이라 즉시 그려집니다.
- 권한·기능 플래그: 관리자 전용 메뉴(
/settings/users,/settings/groups)는 권한이 있을 때만, Labs Reports는 기능 플래그가 켜진 사용자에게만 노출됩니다. - 필터와 직교: 자산 유형 필터를 켜도 바로 가기 섹션은 영향받지 않습니다 — 메뉴는 항상 도달 가능해야 합니다.
매칭 우선순위는 정확 일치 → 접두 일치 → 단어 경계 일치 → 부분 일치 → 키워드 일치 → 경로 일치 순입니다. 한국어/영문 키워드 모두 검색 가능하도록 별칭이 등록되어 있습니다(예: "pipeline" ↔ "파이프라인", "graph" ↔ "그래프").
자산 결과: 필터 필 (Filter Pills)
검색 모달 상단에는 자산 유형별 필터 필이 섹션 그룹으로 배치됩니다. 바로 가기 섹션과 별개로 동작합니다.
- 전체: 모든 유형
- 카탈로그 섹션:
컬렉션 / 데이터셋 / 파이프라인 / 코드 / 지식 / 대시보드 - 온톨로지 섹션:
모델 / 엔티티 / 관계 - 에이전트 섹션:
에이전트 / 도구 / 액터 - 각 필의 아이콘은 자산 유형 아이콘과 동일하여 결과 목록과 시각 일관성을 유지합니다.
- 일부 필에는 힌트 문구가 함께 표시됩니다(예: 컬렉션, 엔티티).
- 선택된 필은 primary 색상으로 강조됩니다.
- 검색어를 입력하면 결과가 있는 유형의 필만 남고,
전체필은 항상 표시됩니다.
자산 결과 구성
- 그룹화: 자산 결과는 유형별 그룹으로 나뉩니다. 그룹 제목은
카탈로그 · 컬렉션,데이터셋,온톨로지 · 엔티티등 한국어 라벨을 사용합니다. - 유형당 최대 노출: 유형별로 상위 5건이 노출됩니다. 더 많은 결과는 해당 섹션 필터를 선택해 확인합니다.
- 온톨로지 딥 링크: 엔티티 결과를 클릭하면 해당 모델의 엔티티 편집 위치로 바로 이동합니다.
- 보조 라벨: 결과 이름 아래에 소속 컬렉션(데이터셋·코드·파이프라인·지식·에이전트·도구·액터) 또는 설명(컬렉션·대시보드·엔티티)이 보조 라벨로 표시됩니다. 관계는
소스 → 타깃양 끝 노드가 표시되어, 다른 팀의 자산도 맥락과 함께 식별할 수 있습니다. - 별칭 우선 표시: 자산에 별칭이 설정되어 있으면 별칭이, 없으면 시스템 이름이 라벨로 표시됩니다.
키보드 네비게이션
↑/↓: 바로 가기 섹션과 자산 섹션을 가로지르는 단일 통합 커서로 이동합니다.Enter: 현재 선택된 항목으로 이동합니다.Esc: 모달을 닫습니다.
초기 상태와 최근 검색
검색어를 입력하기 전 모달을 열면 최근 항목(홈과 동일한 데이터 자산, 최대 6건)과 최근 검색이 둘러보기 형태로 표시되며, ↑ / ↓로 이동하고 Enter로 바로 열 수 있습니다.
- 검색 결과나 바로 가기를 선택하면 그때 입력한 검색어가 최근 검색에 저장됩니다.
- 최근 검색은 최대 5건까지 브라우저 로컬 스토리지(
dhub2-recent-searches키)에 보관됩니다. - 최근 검색어를 클릭하면 그 검색어로 다시 검색합니다.
홈 최근 항목과의 관계
홈 화면의 최근 항목은 데이터 자산(컬렉션·코드·파이프라인·지식)만 표시하는 축약 뷰입니다. 온톨로지 엔티티와 에이전트를 포함한 전체 최근 항목은 최근 항목 페이지에서 확인할 수 있으며, 전역 검색의 자산 결과와 동일한 유형 그룹을 공유합니다.
팁
- 여러 필드 검색: 자산은 별칭·시스템 이름·설명(일부 유형은 소속 컬렉션 이름, 관계는 태그·양 끝 노드)을 부분 일치로 검색합니다. 자산 결과는 유형별로 묶여 유형당 5건까지 표시되며 적합도 정렬은 적용되지 않습니다 — 적합도 점수 기반 정렬은 바로 가기에만 적용됩니다.
- 권한 필터: 접근 권한이 없는 자산은 결과에 포함되지 않습니다.
- 단축키 조합:
⌘K→ 검색어 입력 → Enter로 첫 바로 가기 또는 첫 자산 결과로 즉시 이동.