Skip to content

Docs/v2 migration#215

Merged
seyoung4503 merged 3 commits intomasterfrom
docs/v2-migration
Mar 2, 2026
Merged

Docs/v2 migration#215
seyoung4503 merged 3 commits intomasterfrom
docs/v2-migration

Conversation

@seyoung4503
Copy link
Collaborator

#️⃣ Issue Number

  • TBD

📝 요약(Summary)

v2 마이그레이션 후속 문서 정리 및 인터페이스 보완. deprecated 문서 제거, 튜토리얼 v2 API 반영,
CatalogLoaderPort 추가 및 DataHubCatalogLoader 계보 문서 로딩 기능 추가.

💬 To Reviewers (선택)

문서 정리

  • RunContext_ko.md 제거 — v2에서 RunContext가 컴포넌트 내부로 완전히 이관되어 별도 문서 불필요.
  • BaseFlow_ko.md에 SequentialFlow 알려진 제한사항 섹션 추가.
  • tutorials/의 IndexBuilder 참조 전면 제거 및 from_chunks() / split() 패턴으로 교체.

CatalogLoaderPort + DataHubCatalogLoader 보완 (core/ports.py, integrations/catalog/)

  • CatalogLoaderPort Protocol 추가 — 외부 카탈로그 소스를 교체 가능한 인터페이스로 분리.
  • DataHubCatalogLoaderload_lineage_documents() 추가 — 계보 정보를 TextDocument로 로드해
    VectorRetriever에 바로 주입 가능.

PR Checklist

  • 전체 회귀 테스트 통과
  • IndexBuilder 관련 튜토리얼 레거시 코드 제거 확인
  • DataHubCatalogLoader 변경사항 기존 load() 동작에 영향 없음 확인

reference) How to Code Review

  • 따봉(👍): 리뷰어가 리뷰이의 코드에서 칭찬의 의견을 남기고 싶을 때 사용합니다.
  • 느낌표(❗): 리뷰어가 리뷰이에게 필수적으로 코드 수정을 요청할 때 사용합니다.
  • 물음표 (❓): 리뷰어가 리뷰이에게 의견을 물어보고 싶을 때 사용합니다.
  • 알약 (💊): 리뷰어가 리뷰이의 코드에서 개선된 방법을 제안하지만 그것의 반영이 필수까지는 아닐 때 사용합니다.

  RunContext는 공개 API(__init__.py)에 포함되지 않으며
  v2 컴포넌트/플로우에서 사용되지 않음.
  문서 존재 시 사용자가 공개 API로 오인할 수 있어 삭제.
  다중 인자 컴포넌트 비호환, 컨텍스트 소실 문제와
  전용 Flow(BaselineNL2SQL 등) 사용을 권장하는 해결 방법 추가
  - vector-retriever: IndexBuilder 제거, BaselineNL2SQL retriever= 오류 수정 (HybridNL2SQL로 교체),
    add() 시그니처 수정(pre-split 필수), splitter 파라미터명 반영
  - v2-usage-guide: EnrichedNL2SQL 추가, embedding 6개/vectorstore 3개로 목록 현행화
  - getting-started-without-datahub: langchain import 제거, FAISSVectorStore/PGVectorStore 네이티브 코드로
   교체,
    pgvector 실행 방법 3가지(Docker, 직접 설치, 클라우드)로 확장
@seyoung4503 seyoung4503 merged commit 11e1379 into master Mar 2, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant