SnowConvert AI - 마이그레이션 어시스턴트 - 시작하기¶
이 가이드에서는 SQL 코드에서 변환 후 문제를 해결하기 위한 SnowConvert AI 마이그레이션 어시스턴트의 기본 단계를 안내합니다.
전제 조건¶
Snowflake Visual Studio Code 확장 프로그램 버전 GA 1.14.0 이상이 설치되어 있습니다.
경고
버전 1.17.0의 변경 사항을 반영하여 설명서가 업데이트되었습니다. 스트리밍 기능은 일부 지침 변경 사항(예: 청구)과 함께 버전 1.17.0 이상에서만 사용할 수 있습니다.
SnowConvert의 EWIs가 포함된 .sql 파일이 있습니다.
지원되는 모든 모델에 액세스할 수 있는 Snowflake 계정이 있습니다. 자세한 내용은 모델 기본 설정 설명서를 참조하세요.
단계¶
1. Install the Snowflake Visual Studio Code extension¶
Visual Studio Marketplace 또는 .vsix 파일에서 설치하는 방법에 대한 Snowflake 설명서를 참조하세요.
버전 GA 1.14.0을 사용 중인지 확인합니다.
2. Sign in to Snowflake with the Visual Studio Code extension¶
VS 코드 확장 프로그램을 사용하여 Snowflake에 로그인하는 방법에 대한 Snowflake 설명서를 참조하세요.
3. Enable SnowConvert AI Migration Assistant in the Snowflake VS Code Extension Settings¶
VS 코드 설정 패널을 열고 Extensions로 이동합니다. Snowflake 확장 프로그램을 선택하고 Snowflake 확장 프로그램의 설정 패널을 엽니다.

Settings panel > Extensions

Snowflake extension > settings
Snowflake 확장 프로그램 설정에서 다음을 수행해야 합니다.
“Enable SnowConvert AI Migration Assistant” 선택

Enable SnowConvert AI Migration Assistant setting
4. Set up Model Preference¶
모델 기본 설정을 지정하는 방법에 대한 자세한 내용은 모델 기본 설정 설명서를 참조하세요.
5. Open a workspace folder containing SnowConvert AI migration results¶
먼저, Visual Studio Code에서 작업 공간 폴더가 열려 있는지 확인합니다. 그런 다음 왼쪽의 활동 표시줄에서 아이콘을 선택하여 Snowflake 확장 프로그램에 액세스합니다. “SnowConvert AI Issues” 패널이 Snowflake 확장 프로그램의 뷰 내 하단에 표시됩니다. 이 패널에는 현재 작업 공간 내에서 SnowConvert AI 마이그레이션 문제가 발견된 모든 폴더 및 파일 목록으로 자동으로 표시됩니다. 선택한 작업 공간이 없으면 SnowConvert AI Issues 패널에 “No SnowConvert AI Migration issues found.”라는 메시지가 표시됩니다.

SnowConvert AI Issue panel
SnowConvert AI 마이그레이션 문제가 포함된 작업 공간 폴더가 열리면 “SnowConvert AI Issues” 패널 위로 마우스를 가져가 도구 모음에 액세스할 수 있습니다. 패널의 왼쪽 상단에 있는 이 도구 모음을 사용하면 식별된 마이그레이션 문제 목록과 상호 작용할 수 있습니다.

SnowConvert AI Issues panel toolbar
🏠 (작업 공간 루트로 돌아가기): 이 아이콘을 클릭하면 뷰가 재설정되어 전체 작업 공간 폴더의 초기 상태가 표시됩니다.
📁 (폴더 선택): 작업 공간 내에서 특정 하위 폴더로 이동하여 선택해 문제 목록에 집중할 수 있습니다.
🔄 (문제 새로 고침): 이 아이콘을 사용하여 SnowConvert AI 마이그레이션 문제 목록을 수동으로 업데이트합니다. 또한 문제가 해결되거나 새로운 문제가 감지될 때마다 목록이 자동으로 업데이트됩니다.
➖ (모두 축소): 더 간략하게 볼 수 있도록 문제 목록에서 확장된 모든 항목을 축소합니다.
6. See SnowConvert AI Migration Issues and click the sparkles for help resolving¶
마이그레이션 문제가 있는 .sql 파일이 포함된 폴더를 열면 해당 폴더의 모든 EWIs, FDMs, PRFs 및 이를 포함하는 파일 목록이 표시됩니다. 목록에서 마이그레이션 문제를 하나 클릭하면 코드 편집기가 문제가 발견된 코드 줄에 초점을 맞춥니다.

SnowConvert AI Migration Issues panel
참고
EWIs는 ⚠️ 아이콘으로 표시됩니다.
FDMs 및 PRFs는 ℹ️ 아이콘으로 표시됩니다.
폴더 아이콘은 상태를 반영하기 위해 📁(축소)에서 📂(확장)으로 변경됩니다.
마이그레이션 문제에 대한 AI 기반 어시스턴트 및 권장 솔루션를 받는 방법은 두 가지가 있습니다.
목록에서 마이그레이션 문제 옆에 있는 불꽃 아이콘을 클릭합니다.
![]()
Get explanation and suggestion by sparkles icon
모든 마이그레이션 문제 위에 있는 _SnowConvert AI로 식별된 CodeLenses를 클릭합니다.

Get explanation and suggestion by CodeLens
7. Get help¶
불꽃 아이콘 또는 CodeLenses를 클릭하면 SnowConvert AI 마이그레이션 어시스턴트가 마이그레이션 문제 및 해당 문제를 둘러싼 코드 컨텍스트의 스니펫을 사용하여 Snowflake Cortex AI를 쿼리합니다. Cortex에 대한 호출은 Snowflake VS 코드 확장 프로그램에서 구성한 연결 세부 정보를 사용하여 전적으로 Snowflake 계정 내에서 발생합니다.
결과가 생성되면 코드 편집기 오른쪽의 패널에 표시됩니다. 결과에는 코드의 컨텍스트에서 마이그레이션 문제에 대한 설명 및 Snowflake에서 코드를 올바르게 실행하기 위한 제안된 수정 사항이 포함됩니다. 어시스턴트는 높은 신뢰도로 응답을 생성할 수 없는 경우 권장 솔루션 제공을 중단합니다.

Explanation and suggestion panel
8. Interacting with the Migration Assistant¶
솔루션 구체화: AI 제안이 올바르지 않거나 다른 접근 방식을 선호하는 경우 채팅 상자에 원하는 변경 사항이나 지침을 입력합니다.
SQL 관련 질문하기: 제안 사항이 올바른 경우 SQL 관련 항목에 대한 설명이나 추가 설명을 요청할 수 있습니다.
코드 수정 요청: 스크립트에 헤더 추가와 같이 특정 코드 변경을 요청할 수도 있습니다.

SnowConvert AI Migration Assistant chat interaction
참고
어시스턴트는 SQL과 관련되지 않은 질문의 답변을 자제합니다.

Non-SQL related question abstension message