MySQL Record Manager

MySQL 데이터베이스에 기록을 저장하거나 갱신하는 작업을 관리하기 위한 노드입니다. LLM의 응답이나 워크플로우 결과를 구조화된 형태로 MySQL에 자동 저장할 수 있으며, 기존 데이터를 식별 기준에 따라 덮어쓰기(upsert)하거나 새로운 레코드로 추가하는 기능을 지원합니다.

---

주요 기능

• MySQL 데이터베이스에 연결하여 레코드 저장 및 업데이트(upsert) 기능 제공

• Namespace, SourceId Key 등 식별자 기준에 따른 정교한 기록 관리

• 자동 테이블 생성 및 관리(기본 테이블명: upsertion_records)

• Cleanup 옵션을 통해 기록 정리 조건 설정 가능

• 다양한 LLM 결과나 사용자 입력 데이터를 DB에 저장하는 워크플로우에 활용 가능

WindyFlo MySQL Record Manager

WindyFlo MySQL Record Manager Parameters

입력값 (Inputs)

항목	설명	필수 여부
Connect Credential	MySQL 접속 정보를 담은 Credential에 등록된 항목 선택	필수
Host	MySQL 서버 주소 또는 도메인	필수
Database	기록을 저장할 대상 데이터베이스 이름	필수
Port	접속 포트 번호 (기본값: 3306)	선택

Additional Parameters

항목	설명	필수 여부
Table Name	데이터를 저장할 테이블 이름 (기본값: upsertion_records)	선택
Namespace	레코드를 그룹화할 논리적 구분값. 복수 워크플로우 구분 시 활용	선택
Cleanup	기존 레코드 정리 기준. None, full, partial 등 선택 가능	필수
SourceId Key	중복 판단 기준이 되는 필드명. 기본값: source	선택

---

출력값 (Outputs)

출력 항목	설명
MySQLRecordManager	구성된 레코드 관리자 객체. 이후 워크플로우에서 저장 처리에 사용됨

---

활용 예시

• LLM 응답 결과를 자동 저장하고 싶을 때 (예: 상담 기록, 요약 결과 등)

• 반복되는 워크플로우 결과를 식별 기준(SourceId Key) 으로 관리하고 싶을 때

• DB 기반으로 프롬프트 결과 추적 및 리포트 작성 워크플로우에 활용할 때

• 복수 워크플로우를 Namespace 기준으로 구분하여 기록 관리하고자 할 때

---

사용 팁

• Cleanup을 full로 설정하면 이전 데이터 전체 삭제 후 저장되므로 백업이 필요할 수 있습니다.

• SourceId Key는 LLM 응답에 포함되는 고유 키를 지정하면 자동 upsert에 유리합니다.

• Namespace를 활용하면 같은 테이블 내에서도 프로젝트 단위로 데이터 분리 관리가 가능합니다.

---

주의사항

• Connect Credential은 사전에 WindyFlo의 Credential에 등록된 유효한 MySQL 정보여야 합니다.

• Host, Database, Port 정보 중 하나라도 누락되면 연결에 실패합니다.

• 테이블이 존재하지 않으면 자동 생성되지만, 구조 변경이 필요한 경우 수동 설정 필요

• Cleanup 설정이 적절하지 않으면 불필요한 데이터 중복 또는 손실 발생 가능성 있음