변환 성공이라는 초록색 표시, 결과까지 정답일까?
오래 쓰던 보고서 프로그램을 새 시스템으로 옮기는 상황을 상상해 보자. AI가 코드를 자동으로 바꿔 주더니 화면에 초록색으로 ‘성공’이라고 뜬다.
이제 안심하고 보고서를 배포해도 될까? 중요한 건 변환 도구가 작업을 완료했다는 사실과, 옛 보고서와 새 보고서의 숫자가 완전히 같다는 사실은 다르다는 것이다.
1. Databricks의 초록색 표시가 뜻하는 것
Databricks의 공식 안내에서 agentic code converter는 T-SQL, Snowflake SQL, Redshift SQL, Oracle, BigQuery, Teradata 등의 SQL을 Databricks용 SQL로 변환할 수 있다. SQL 대상 변환 기능은 2026년 10월 15일 일반 제공(GA)으로 안내됐다. Notebook 대상은 별도 Beta 조건을 가진다.
변환 프로젝트의 파일 상태는 네 가지다.
- Green: 변환 성공
- Yellow: 검토 필요
- Red: 변환 실패
- Gray: 작업 진행 중
도구는 변환 과정에서 코드 오류를 분석하고 수정도 시도한다. 즉, 자동 검사 기능이 아예 없다는 뜻이 아니다. 그럼에도 제조사 가이드는 결과 코드를 실행하고 동등한 테스트 데이터로 원본·변환 쿼리의 결과를 비교하라고 권고한다.
2. 왜 결과까지 확인해야 할까?
아래 숫자는 실제 Databricks 오류가 아닌, 검증 방법을 설명하기 위한 가상의 주문표다.
원본 주문 금액: 10만 원 + 20만 원 + 30만 원 = 총 60만 원, 3건 가상의 변환 결과: 10만 원 + 20만 원 = 총 30만 원, 2건
컴퓨터가 새로운 코드를 문제없이 실행하더라도, 필터 조건이 달라졌다면 숫자는 다르게 나올 수 있다. 위와 같은 차이를 찾아내는 검사가 필요한 것이다. 이 예시는 실제 제품에서 이런 오작동이 일어났다는 증거가 아니다.
3. 가장 간단한 비교는 세 번이다
첫째, 실행되는가? 변환된 SQL을 Databricks SQL 편집기 등 실제 대상 환경에서 실행하고 오류가 없는지 확인한다.
둘째, 건수와 합계가 같은가? 가능하면 같은 테스트 데이터에 대해 원본 쿼리와 변환 쿼리의 행 수, 중복 수, 집계값, 누락·NULL 결과를 비교한다. 어느 표가 비교 대상인지도 기록한다.
셋째, 경계에서도 같은가? 날짜 경계, 시간대, NULL, 집계 그룹, 원본 SQL 방언에 특유한 표현처럼 의미가 달라질 수 있는 사례를 따로 준비한다. 테스트 데이터가 원본과 다르면 비교 결과를 그대로 일치·불일치라고 판정할 수 없다.
원본 SQL은 보존하고, 변환된 SQL의 수정 이력과 검사 결과를 버전별로 저장하면 재검증할 때 도움이 된다.
4. 파일 300개를 한 번에 돌릴 때도 조심
공식 문서는 하나의 변환 배치가 최대 300파일이며, Teradata BTEQ 스크립트는 지원하지 않는다고 설명한다. 새로운 Notebook 대상 변환은 Beta 조건을 확인해야 한다.
가장 큰 프로젝트부터 모두 자동 변환하기보다, 공식 문서가 권하는 것처럼 소수 파일로 먼저 시험하고 실제 결과를 대조하는 편이 해석하기 쉽다.
5. 자주 묻는 질문
Q. 초록색이면 오류가 하나도 없다는 뜻인가요? A. 공식 파일 상태상 ‘변환 성공’이지만, 실제 데이터 분석 결과까지 독립적으로 보장한다는 뜻으로 해석하면 안 된다.
Q. Databricks가 의미 검증을 안 해 주나요? A. 자동 변환 과정에서 유효성 검사를 수행한다. 다만 공식 가이드는 실제 실행과 의미적 결과 비교를 추가로 권고한다.
Q. 우리 회사 쿼리도 틀린 건가요? A. 이 글은 특정 회사의 코드를 실행하지 않았다. 실제 오류·정확도·비용을 측정한 결과가 아니다.
기억할 한 문장: ‘변환 성공’ 표시보다 중요한 건 같은 데이터를 넣었을 때 같은 답이 나오는지다.
출처 및 데이터 고지
Databricks 공식 Agentic Code Converter 가이드(2026-10-16 갱신), Databricks 2026년 10월 제품 릴리스 노트. 주문표·변환 오류 예시는 모두 가상 데이터다. 실제 SQL 변환을 실행하지 않았다.