Kori 8월 23일에 포스트됨 8월 23일에 포스트됨 원문 정보 (최종 번역일: 2026년 8월 23일): 제목: Migrate to FireDAC in a Day with reFind and Kai 작성자: Antonio Zapater - 2026년 8월 링크 https://blogs.embarcadero.com/migrate-to-firedac-in-a-day-with-refind-and-kai/ 만약 여러분이 BDE, ADO, IBX, dbExpress 중 하나를 통해 여전히 데이터베이스와 통신하는 Delphi(델파이) 애플리케이션을 유지보수하고 있다면, FireDAC(파이어댁)로 마이그레이션하는 것을 한 번쯤은(아마 여러 번) 고민해 보았을 것이다. 이 전환을 가로막는 것은 대개 FireDAC 자체에 대한 의구심이 아니다. 마이그레이션 작업에 대한 두려움 때문이다. 몇 주에 걸쳐, 기계적인 이름 변경 작업, 깨진 DFM과 수백 개 유닛에 걸친 컴파일 오류 수정 작업이 될까 우려한다. RAD Studio(라드 스튜디오)에는 이미 reFind(리파인드)라는 대량 처리 마이그레이션 엔진이 포함되어 있다. 여기에는 BDE, ADO, dbExpress, IBX용 규칙 템플릿들도 들어 있다(게다가, AnyDAC과 API 이름 변경 키트도 포함). 또한, IDE 안에 내장된 에이전틱 AI 어시스턴트인 Kai(카이)를 사용하면, 대규모 코드 기반을 분석하고, 그 템플릿을 여러분의 프로젝트에 맞게 가볍게 커스터마이징한 다음, reFind를 실행하고, 애플리케이션이 FireDAC를 사용해 빌드될 때까지 Kai를 수정 반복 모드로 구동할 수 있다. 일반적인 업무용 애플리케이션이라면, 이는 흔히 하루 정도의 작업으로 끝난다. 수작업이었다면 몇 주가 걸렸을 일이다. 이 글은 이 작업흐름을 위한 실전 플레이북이다. 목차 많은 개발자가 열어보지 않는 도구 핵심 아이디어: 대량 작업은 reFind, 판단은 Kai 하루짜리 플레이북 1. 정찰(Scout) (Kai와 함께 15~30분) 2. 공식 템플릿에서부터 시작하기 3. 가볍게 커스터마이징하기 (AI가 빛을 발하는 지점) 4. reFind 실행하기 5. Kai의 컴파일-수정 반복 작업으로 마무리하기 "하루"가 현실적으로 의미하는 것 자신이 없다면, 먼저 샘플로 연습해 보자 프롬프트와 스킬 마무리 참고: reFind는 데이터베이스 컴포넌트 전용이 아니다 많은 개발자가 열어보지 않는 도구 reFind.exe는 RAD Studio의 bin 폴더 안에 있다. 이것은 명령줄 기반 검색-치환 유틸리티다. Perl 호환 정규 표현식과 Delphi 마이그레이션 지시문을 지원한다. #unuse: uses에서 유닛 제거 #remove: PAS/DFM에서 프로퍼티 제거 #migrate: 타입 이름 변경, 멤버 이름 변경, 필요하면 유닛 추가 엠바카데로(Embarcadero)는 이미 만들어진 규칙 파일도 "FireDAC" Samples 트리 아래에 함께 제공한다(아직 설치하지 않았다면, RAD Studio 설치 시 Samples도 함께 설치해야 한다): C:\Users\Public\Documents\Embarcadero\Studio\<버전>\Samples\Object Pascal\Database\FireDAC\Tool\reFind <버전> 부분은 C:\Users\Public\Documents\Embarcadero\Studio\ 아래에 있는 "Studio 버전 폴더 이름"으로 바꾸면 된다(주요 릴리스마다 값이 달라진다. 예를 들어 13.1 플로렌스는 37.0이다). 만약 이 트리가 보이지 않는다면, Samples를 설치하지 않은 것이다. 미리 정의되어 있는 마이그레이션 키트는 다음과 같다: FireDAC_Migrate_BDE.txt: BDE ➜ FireDAC FireDAC_Migrate_ADO.txt: ADO ➜ FireDAC FireDAC_Migrate_DBX.txt: dbExpress ➜ FireDAC FireDAC_Migrate_IBX.txt: InterBase Express(IBX) ➜ FireDAC 그 외에 AnyDAC ➜ FireDAC 키트와 FireDAC API 이름 변경 키트(AD2FDMigration, XE72XE8Migration)도 있다 이 규칙 파일들을 열어봤다가 곧바로 닫아버린 적이 있다면, 당신만의 그런 게 아니다. 이것의 문장 규칙 자체는 매우 강력하다. 하지만, 조금 난해하다. 잘못 쓰기도 쉽다. 그래서 reFind를 발견한 대부분의 팀은 한 가지 패턴을 따른다. 프로젝트 사본에서 기본 템플릿을 실행한다. 대량 이름 변경 결과에 반가워 한다. 그러다가, 템플릿이 표현할 수 없는 부분에 봉착한다. 그리고 그만둔다. 연결 정의, 지원되지 않는 API, 빠져 있는 FireDAC 연관 코드, TQuery나 TADOConnection을 감싼 자체 제작 래퍼 같은 것들을 만나면, 그렇게 된다. 바로 이 지점에서 Kai가 유용하다. Kai는 프로젝트 고유의 코드를 검사하고, 마이그레이션 규칙에 추가할 내용을 제안하고, reFind가 자동으로 처리하지 못하는 부분을 함께 처리해 준다. 핵심 아이디어: 대량 작업은 reFind, 판단은 Kai 여기서 중요한 구분이 있다. reFind는 기계적인 변환을 담당한다. reFind는 여러분의 애플리케이션을 어떻게 설계해야 하는지 결정해서는 안 된다. Kai는 이런 부분 즉, 기존 코드에 대한 이해가 필요한 부분에서 도움이 된다. 패턴들을 식별하고, 마이그레이션 규칙에 작은 변경들을 제안하고, 대량 변환 이후 남은 부분을 처리하는 일들이다. 아무것도 하기 전에, 미리 수천 개 유닛짜리 애플리케이션 전체를 Kai에게 입력할 필요는 없다. 데이터 모듈, 연결 설정, 대표적인 폼 몇 개로 시작하자. 그 정도면 전체 작업을 AI가 주도하는 전면 재작성으로 만들지 않으면서도, 주요 마이그레이션 패턴을 파악하기에 충분한 맥락을 전달할 수 있다. 하루짜리 플레이북 무엇이든 손대기 전에 가장 먼저 할 일: 브랜치에서 작업하자. 아직 버전 관리를 사용하고 있지 않다면, 지금 시작하자. MyApp_backup이라는 이름의 zip 파일은, 그 이름이 아무리 믿음직스럽게 들리더라도 버전 관리라고 쳐주지 않는다. 버전 관리는 단일한 진실의 원천을 제공한다. 지금까지 만든 모든 변경 사항을 담은 완전한 타임머신도 제공한다. 또한 프로덕션을 망가뜨리거나 zip 파일을 주고받을 필요 없이, 팀과 진행 상황을 쉽게 공유하는 방법도 제공한다. BDE를 사용하는 프로젝트에 대한 첫 번째 Kai 분석 1. 정찰(Scout) (Kai와 함께 15~30분) Kai에게 맨 처음 요청할 것은 데이터 모듈들과 데이터베이스를 여는 유닛부터 살펴보라는 것이다. 그런 레거시 컴포넌트 타입들이 몇 번 등장하는지 세어보라고 한다. 그리고 애플리케이션이 연결을 어떻게 맺는 지 그 방식을 파악하라고 한다. BDE 별칭, dbxconnections.ini, ADO 연결 문자열, DFM에 하드코딩된 파라미터 등 다양하다. TAppQuery나 TMyConnection처럼 눈에 띄는 커스텀 자식 클래스들을 눈에 띄도록 표시해 달라고 요청하는 것도 좋다. 우리에게 필요한 것은 짧은 마이그레이션 요약이다. 어떤 데이터베이스 라이브러리를 사용하는지, 대략 얼마나 많은 코드가 영향을 받는지, 위험한 부분은 어디인지 등이다. 2. 공식 템플릿에서부터 시작하기 설치된 Samples 트리에서 해당하는 규칙 파일을 선택하자. 예를 들면: C:\Users\Public\Documents\Embarcadero\Studio\<버전>\Samples\Object Pascal\Database\FireDAC\Tool\reFind\BDE2FDMigration\FireDAC_Migrate_BDE.txt (또는 이에 대응하는 규칙 파일 들 즉, ADO / dbExpress / IBX 파일). <버전> 부분의 요령은 위와 같다. 폴더가 보이지 않는다면 Samples를 설치하지 않은 것임을 기억하자. 이미 이 파일들에는 흔한 BDE→FireDAC 변경 사항들에 대한 매핑 규칙들이 담겨 있다. TQuery ➜ TFDQuery, DatabaseName ➜ ConnectionName, 트랜잭션 열거형, #remove SessionName 등등이다. 또한 직접 지원되지 않는 항목들도 주석으로 문서화되어 있다. 그 주석들을 활용해 여러분의 위험 요소 체크리스트로 활용하자. 3. 가볍게 커스터마이징하기 (AI가 빛을 발하는 지점) 그 템플릿 그리고 여러분이 분석한 결과를 Kai에게 입력하자. Kai에게 요청해 reFind 규칙을 여러분의 프로젝트에 맞게 조정해 달라고 하자. 필요하다면, 여러분의 자체 래퍼를 해당 FireDAC 타입들에 매핑하고, 프로젝트 고유의 프로퍼티 이름 변경 몇 개를 추가하고, 추가로 #unuse나 #remove 줄을 넣어서 이미 사라진 것을 알고 있는 유닛에 대해 반영하도록 할 수도 있다. Kai가 제안하는 줄들을 검토하자. 영리한 정규식보다는 작고 지루한 규칙을 선호하자. 그런 다음 공식 파일 옆에 다른 이름으로 저장하자. 예를 들어, FireDAC_Migrate_BDE_MyApp.txt 같은 이름을 지정할 수 있다. 일단 여러분이 분석 결과에 만족한다면, 그리고 하고 Kai가 잠재적인 문제들을 모두 찾아냈다면, 그 계획을 하드 드라이브에 저장해 달라고 요청하자. 그러면 여러분이 향후에 프롬프트 안에서 그 계획 파일을 활용하는데 도움이 된다. 뭔가 문제가 생겼을 때 대응하기 좋다. 또한, 토큰과 시간도 함께 절약할 수 있다. 4. reFind 실행하기 실행할 때는 새로 만든 브랜치에서 해야 한다. Samples 폴더 안의 migrate.bat 파일들은 다음과 같은 패턴을 따른다: reFind.exe MyApp_FireDAC\*.pas MyApp_FireDAC\*.dfm /S /X:FireDAC_Migrate_BDE_MyApp.txt Kai는 IDE의 에이전트 작업흐름 안에서 이 명령을 구성하고 실행해 줄 수 있다. 하지만 대규모 트리를 대상으로 실행하기 전에, 경로와 규칙 파일을 직접 확인해 볼 것을 권한다. 5. Kai의 컴파일-수정 반복 작업으로 마무리하기 reFind를 실행한 뒤에는, 남은 작업이 있을 수 있다. 이는 정상이다. 예전에는 "몇 달"처럼 보였던 부분이 바로 이것이다. 대표적인 잔여 작업은 다음과 같다: FireDAC 연결 정의( FDConnectionDefs.ini / ConnectionDefName 사용): BDE 별칭, dbExpress ini 파일, 순수 ADO 문자열을 교체한다. 드라이버 링크들과 TFDGUIxWaitCursor 규칙 파일에 "지원되지 않음"으로 표시된 API들 (TSQLMonitor, 몇몇 ADO 레코드셋 패턴들, load-params 헬퍼들,...) 여전히 예전 컴포넌트 이름을 딴 이벤트 핸들러들 FireDAC 방식으로 다시 작성해야 하는 SQL 또는 트랜잭션 패턴들 마이그레이션된 프로젝트를 RAD Studio 안에서 연다. Kai에게 빌드 오류를 가리켜 준 다음, 반복시키자. 수정 ➜ 컴파일 ➜ 메시지 읽기 ➜ 다시 수정. IDE 밖으로 나가지 말자. 바로 이 반복 루프가 일반 채팅창 이용과 차이점이다. 채팅에서 얻은 마이그레이션 조언을 복사해 붙여넣는 방식과 실제로 프로젝트를 완성시킬 수 있는 에이전트는 분명히 차이가 난다. BDE에서 FireDAC로 전체 마이그레이션을 한 이후 잔여 작업을 분석하기 "하루"가 현실적으로 의미하는 것 목표는 하루 안에 마이그레이션을 완전히 끝내는 것을 보장하는 게 아니다. 목표는, "어디에나 레거시 데이터 접근이 있는" 상태에서 컴파일되는 FireDAC 기반 기준선까지 하루 만에 도달하는 것이다. 어느 정도 평범한 애플리케이션이라면 하루면 된다. 아주 큰 프로젝트(수천 개 유닛, 깊게 커스터마이징된 데이터 계층, 무거운 ADO 레코드셋 사용)라면, 첫날 하루 이후에도 짧은 안정화 스프린트가 필요할 수 있다. 그런 경우에도 우리가 얻게 되는 이득은 똑같다. 기계적인 대량 작업과 첫 번째 컴파일 기반 기준선 도달을 얻게 된다. 그러면, 더 이상 몇 주씩 걸리는 수렁이 되지 않는다. 자신이 없다면, 먼저 샘플로 연습해 보자 엠바카데로의 FireDAC 도구 데모(앞서 언급한 설치된 Samples 경로 아래)가 가장 안전한 리허설이다: BDE: MastApp (reFind\BDE2FDMigration\Demo 아래에 있다) dbExpress: MeetingOrganizer (reFind\DBX2FDMigration\Demo 아래에 있다) IBX: IB MastApp (reFind\IBX2FDMigration\Demo 아래에 있다) 로컬에 있는 migrate.bat을 실행한다. 생성된 FireDAC 사본을 연다. 그런 다음, Kai로 마무리하는 과정을 연습한다. 연결 정의, 웨이트 커서(wait cursor), 더 이상 쓰지 않는 ini 로딩 코드에 주석 처리하기, 깨끗하게 빌드될 때까지 반복하기다. 일단 여러분이 이 작업흐름을 이해하고 나면, 이제 여러분 자신의 애플리케이션을 진행할 준비가 된 것이다. 프롬프트와 스킬 작업흐름은 그대로 넘겨주는 편이 설명하는 것보다 더 쉽다. 그래서 우리는 이 작업흐름을 하나의 작은 팩으로 제공하고 있다. 여러분은 이것을 기반으로 사용하면 된다. 그러면, 이 절차를 더 잘 이해할 수 있다. 이 저장소에 접근하기 이 저장소에는 에이전트 스킬 2개와 프롬프트 7개가 들어 있다: firedac-migrate: 처음부터 끝까지의 작업흐름이다. 또한, BDE·ADO·dbExpress·IBX별 치트시트(무엇을 찾아야 하는지, 어떤 공식 템플릿에서 시작해야 하는지, reFind가 고치지 못하는 것은 무엇인지)가 추가로 제공된다. refind-rulesmith: 프로젝트에 필요할 수 있는 추가 규칙 몇 가지 초안을 어떻게 작성하는지, 언제 멈춰서 그 대신 코드를 직접 고쳐야 하는지 프롬프트 00–06: 같은 플레이북을 한 단계씩 진행하는 프롬프트들. 짧은 설정 점검과 잔여 작업 점검도 포함되어 있다. 단계 하나만 실행하거나 스킬을 지원하지 않는 에이전트와 작업할 때 사용한다 스킬 하나는 폴더 하나로 되어 있다. 그 폴더마다 안에는 SKILL.md가 들어 있다. 이 작업흐름 팩의 루트로부터: .\install-skills.ps1 이 스크립트는 두 스킬을 %USERPROFILE%\.agents\skills로 복사한다. 이곳은 대체로 스킬들이 위치하는 곳이다(에이전트에 따라 다를 수 있음). 그런 다음, 새 채팅을 시작한다. 그러면 해당 스킬이 인식된다. 다른 에이전트용 경로와, 스킬을 지원하지 않는 경우에 대한 대안은 저장소 README에 있다. 이 프롬프트들은 범용으로 만들어졌다. 의도적으로 그렇게 했다. 이렇게 사용하면 된다. 여러분 자신의 기반 클래스들을 검색 목록에 추가한다. 구조 단계에서는 여러분 자신의 연결 헬퍼를 추가해야 한다. 스킬은 공식 reFind 템플릿을 대체하지 않는다. 스킬은 에이전트에게 그 템플릿을 사용하는 방법을 가르친다. 그리고, 어떤 API가 FireDAC 대응 항목이 없다고 템플릿이 알려줄 때 멈추도록 하는 방법을 가르친다. 마무리 BDE, ADO, dbExpress, IBX 애플리케이션을 유지보수하고 있다면, FireDAC 마이그레이션을 전면 재작성이라고 취급할 필요가 전혀 없다. 이미 제공된 reFind 템플릿에서 시작하고, Kai를 사용해 프로젝트 고유의 빈틈을 찾아내고, 브랜치에서 변환을 실행한 다음, Kai가 컴파일러 오류를 분석하고 처리하도록 하면 된다. 어느 정도 평범한 업무용 애플리케이션이라면, 마이그레이션을 몇 주짜리 기계적인 작업이라고 여기지 않아도 된다. 기반 기준선에 도달하는데 까지 하루 만에 해낼 수 있다. 참고: reFind는 데이터베이스 컴포넌트 전용이 아니다 TQuery를 TFDQuery로 마이그레이션하는 동일한 엔진이, 기타 대량 현대화 작업들도 이끌 수 있다: RAD Studio 버전 간 API 이름 변경, 더 이상 쓰지 않는 DFM 프로퍼티 제거, 사내 명명 규칙 강제 적용, 써드-파티(Third-Party) 패턴 교체 등을 신중하게 검토된 규칙 파일을 통해 할 수 있다. 만약 여러분이 현대화와 리팩토링 작업흐름, 코드 마이그레이션 등에 대한 블로그 글을 더 보고 싶다면, 댓글로 원하는 내용을 알려주기 바란다. 그 아이디어들을 다뤄보겠다. 인용하기
Recommended Posts
이 토의에 참여하세요
지금 바로 의견을 남길 수 있습니다. 그리고 나서 가입해도 됩니다. 이미 회원이라면, 지금 로그인하고 본인 계정으로 의견을 남기세요.