문서 목차
피처스토어
ML 학습에 사용할 피처를 그룹으로 정의하고, 피처 구성을 버전별로 관리합니다.
QUANTUM C&S
ML 학습에 사용할 피처를 그룹으로 정의하고, 피처 구성을 버전별로 관리합니다.
메뉴 분석 > 피처스토어(/analysis/feature-store)에서 엽니다. 예전 주소 /datasets/features 로 접속해도 이 화면으로 이동합니다.
핵심 개념
| 용어 | 설명 |
|---|---|
| 피처 그룹 | 같은 기준(엔티티)으로 묶인 피처의 모음입니다. 예: 배치별 공정 피처 |
| Entity Key | 피처를 조인할 기준 컬럼입니다. 예: batch_id, vessel_id, user_id |
| 피처 | 학습 입력으로 쓰는 컬럼 하나입니다. 이름 · 타입 · 설명 · 통계를 가집니다. |
| 피처 버전 | 어느 피처를 학습에 포함(ON)하고 제외(OFF)할지의 스냅샷입니다. 피처 엔지니어링 분석의 결과 데이터셋과 연결됩니다. |
| 누적 카탈로그 | 그룹에 등록된 모든 피처입니다. OFF 인 피처도 카탈로그에는 남고 학습에서만 빠집니다. |
| 상태 | 설명 |
|---|---|
| Draft | 작성 중입니다. ON/OFF 를 바꾸면 그 자리에서 반영됩니다. |
| Active | 사용 중입니다. ON/OFF 를 바꾸면 새 Draft 버전이 자동으로 만들어집니다. |
| Deprecated | 더 이상 쓰지 않습니다. |
참고 Active 버전은 분석 · 서빙에 쓰이고 있을 수 있으므로 직접 고치지 않습니다. ON/OFF 를 바꾸면 "변경은 ○○ draft 로 저장됨. 다음 분석 (feature_engineer) 에 적용됩니다." 알림과 함께 새 Draft 버전으로 저장되고, 다음 피처 엔지니어링 분석에 적용됩니다.
주요 기능
| 기능 | 설명 |
|---|---|
| 피처 그룹 관리 | 그룹을 만들고 검색하며, 상태를 Active · Deprecated 로 바꾸거나 삭제합니다. |
| 피처 매핑 | 버전별로 피처를 ON(포함) · OFF(제외)하고, 여러 피처를 한꺼번에 바꿉니다. |
| 피처 통계 | 피처별 샘플 수 · Null 비율 · 평균 · 표준편차 · 최소 · 중앙값 · 최대 · 카디널리티 · 상위 값을 봅니다. |
| 버전 이력 | 버전별 상태 · 피처 수 · 행 수 · 크기 · 결과 데이터셋을 확인하고, 필요 없는 버전을 삭제합니다. |
| 분석 연계 | 피처 엔지니어링 분석이 피처 버전을 채우고, 학습 분석이 그 결과 데이터셋을 입력으로 씁니다. |
화면 구성
| 영역 | 설명 |
|---|---|
| 머리글 | 피처 그룹 생성 버튼 |
| 그룹 목록(왼쪽) | 피처 그룹 검색과 그룹 카드. 카드에는 이름, 상태, 설명, Entity Key, 피처 수, 버전 수가 보입니다. |
| 그룹 상세(오른쪽) | 왼쪽에서 그룹을 고르면 나타납니다. 고르기 전에는 "왼쪽에서 피처 그룹을 선택하세요"가 보입니다. |
| 상세 영역 | 설명 |
|---|---|
| 그룹 정보 | 이름, 설명, Entity Key, 소유자 |
| 상태 버튼 | Active(Active 가 아닐 때), Deprecate(Deprecated 가 아닐 때), 그룹 삭제 |
| 피처 매핑 | 버전 선택 상자와 (ON 수 ON / 전체 수 총). 선택한 버전 시점의 스냅샷으로, ON 피처가 학습 입력으로 쓰입니다. |
| 피처 목록 | 피처마다 선택 칸, ON/OFF 스위치, 이름, 타입, 자동 판단 사유(예: 시간/날짜 타입), 평균 · 표준편차 요약. 화살표를 누르면 통계 패널이 펼쳐집니다. |
| 누적 카탈로그 줄 | 카탈로그 피처 수, 통계 채우기, 피처 추가 |
| 버전 이력 | 버전 표와 일괄 삭제 버튼 |
| 피처 타입 | 설명 |
|---|---|
| int · float | 수치형 |
| string | 문자열 |
| bool | 참 · 거짓 |
| timestamp | 시간 · 날짜 |
| embedding | 벡터 |
| json | 구조화 값 |
피처 그룹 만들기
피처 그룹은 이 화면에서 만들거나, 분석 작업의 피처 엔지니어링 설정에서 + 새 그룹으로 만들 수 있습니다.
1단계: 생성 창 열기
오른쪽 위 피처 그룹 생성을 누르세요.
2단계: 정보 입력
| 항목 | 설명 | 규칙 |
|---|---|---|
| 그룹 이름 | 예: vessel-features |
필수 |
| Entity Key | 피처를 조인할 기준 컬럼. 예: vessel_id, user_id |
필수 |
| 설명 | 이 피처 그룹의 용도 | 선택 |
3단계: 생성
생성을 누르세요. 왼쪽 목록에 그룹이 추가됩니다.
팁 분석 화면의 + 새 그룹을 쓰면 데이터셋의 컬럼을 미리 분석해 ON/OFF 를 자동 제안하고, 피처 그룹과 v1.0 Draft 를 한 번에 만듭니다. 조인 키 · 시간 타입 · 문자열 ID 컬럼은 자동으로 OFF 됩니다.
피처 ON/OFF 바꾸기
1단계: 버전 선택
그룹을 고른 뒤 피처 매핑 옆 버전 선택 상자에서 버전을 고르세요.
2단계: 스위치 전환
피처의 스위치를 누르면 포함(ON) · 제외(OFF)가 바뀝니다. 여러 피처를 체크하면 위쪽 도구 모음의 일괄 ON (포함) · 일괄 OFF (제외) 로 한꺼번에 바꿉니다. 선택 해제로 체크를 지웁니다.
3단계: 결과 확인
Draft 버전은 그 자리에서 바뀌고, Active 버전은 새 Draft 버전이 만들어져 그 버전이 선택됩니다.
4단계: 다음 분석에 적용
분석 작업에서 피처 엔지니어링을 실행하면 바뀐 구성이 반영된 결과 데이터셋이 만들어집니다.
피처 통계와 카탈로그 관리
| 작업 | 방법 |
|---|---|
| 통계 보기 | 피처 이름 왼쪽 화살표를 눌러 통계 패널을 펼칩니다. 샘플 수, Null %, 평균, 표준편차, 최소, 중앙값, 최대, 카디널리티, 상위 값이 보입니다. |
| 통계 채우기 | 통계 채우기를 누르면 통계가 비어 있는 피처를 최신 피처 버전의 컬럼 통계로 채웁니다. 이미 채워진 피처는 건너뜁니다. |
| 피처 추가 | 피처 추가를 누르고 피처 이름(예: avg_speed_24h), 타입, 설명, 변환 SQL 을 입력합니다. |
참고 통계가 없으면 "통계 정보 없음" 안내가 보입니다. 최신 피처 버전에 컬럼 통계가 있을 때 통계 채우기로 보강할 수 있습니다.
버전 이력
그룹 상세 아래 버전 이력 표에서 버전을 관리합니다. 한 쪽에 10개씩 보입니다.
| 열 | 설명 |
|---|---|
| 버전 | 버전 이름 |
| 상태 | Draft · Active · Deprecated |
| 피처 | 포함된 피처 수 |
| 행 / 크기 | 결과 데이터셋의 행 수와 크기 |
| 결과 데이터셋 | 연결된 데이터셋. 아직 없으면 미연결 |
| 기반 | 이 버전이 만들어진 기반 버전 |
| 생성일 | 만든 날짜 |
| 삭제 방식 | 동작 |
|---|---|
| 일괄 삭제 (active 건너뜀) | 선택한 버전을 삭제하되 Active 버전은 자동으로 건너뜁니다. |
| 강제 삭제 | Active 버전까지 삭제합니다. 분석 · 서빙에 영향을 줄 수 있습니다. |
주의 그룹 삭제는 그룹 안의 모든 피처와 버전을 함께 영구 삭제하며 되돌릴 수 없습니다.
권한
| 작업 | 필요한 권한 |
|---|---|
| 그룹 · 피처 보기 | 피처 그룹 읽기 권한 |
| 그룹 생성 | 피처 그룹 생성 권한 |
| ON/OFF · 피처 추가 · 통계 채우기 · 상태 변경 | 그룹 쓰기 권한 |
| 버전 · 피처 · 그룹 삭제 | 그룹 삭제 권한 |
권한은 IGA(권한 관리) 정책으로 판정합니다.
다음 단계
- 분석 작업에서 피처 엔지니어링을 실행해 피처 버전을 채우세요.
- 채워진 피처 버전의 결과 데이터셋으로 분류 · 회귀 분석을 실행해 모델을 학습하세요.