Snowflake Extension for Visual Studio Code¶

SQL 파일 열기 또는 만들기¶

1. VS Code에서 File » Open 을 선택하고 SQL 파일의 위치를 찾아서 엽니다.

   SQL 파일을 생성하려면 File » New File 을 선택하고 Snowflake SQL File 유형의 파일을 생성합니다.

2. 하나 이상의 Snowflake SQL 문을 파일에 추가합니다.

3. (선택 사항) Snowflake: Execute All Statements ()를 클릭하여 명령을 실행합니다.

명령 또는 쿼리 실행하기¶

VS 코드에서 다음 옵션 중 하나를 선택합니다.

• 파일에 있는 모든 SQL 문을 실행하려면 Snowflake: Execute All Statements ()를 클릭합니다.

• 특정 명령을 실행하려면 실행하려는 문에 커서를 놓고 Execute 를 클릭합니다.

• 여러 명령을 실행하려면 실행하려는 문을 선택한 다음 Execute 를 클릭합니다. 명령은 위에서 아래로 순서대로 실행됩니다.

키보드 단축키를 사용하여 문을 실행하려면 실행할 SQL 문을 선택하고 Mac 키보드에서는 + [enter], Windows 키보드에서는 + [enter]를 누릅니다.

실행된 SQL 문 결과가 SNOWFLAKE 패널에 표시됩니다.

진행 중인 쿼리를 취소하려면 QUERY HISTORY 목록에서 쿼리를 선택하고 Cancel query ()를 클릭합니다.

쿼리 기록 보기¶

1. VS Code에서 Query History 를 확장합니다.

2. 문을 선택합니다.

3. SNOWFLAKE 패널에서 결과를 검토합니다.

4. (선택 사항) 다음 중 하나를 선택합니다.

   1. Snowflake: Copy to Clipboard ()를 클릭하여 쿼리 텍스트를 클립보드에 복사합니다.

   2. Snowflake: Remove Query ()를 클릭하여 쿼리를 삭제합니다.

쿼리 결과 작업하기¶

쿼리 결과를 정렬, 재정렬, 숨기기 또는 고정하거나 디스크에 저장할 수 있습니다.

1. QUERY HISTORY 에서 쿼리를 선택합니다.

2. SNOWFLAKE 패널에서 열을 선택합니다.

3. 확장 화살표(↓)를 선택하고 Sort Ascending, Sort Descending, Hide column “column name” 또는 Freeze columns up to “column name” 중에 하나를 선택합니다.

   열이 이전에 숨겨진 경우 다른 열을 선택하고 Unhide N columns 를 선택합니다.

4. (선택 사항) 다음 중 하나를 선택합니다.

   1. Cloud ()를 클릭하여 결과를 압축된 gzip 파일로 저장합니다.

   2. Save ()를 클릭하여 쉼표로 구분된(CSV) 파일로 결과를 저장합니다.

Snowpark Python 함수 디버깅하기¶

1. 첫 번째 매개 변수가 Snowpark Session 오브젝트인 Python 함수에 Snowflake 저장 프로시저를 작성합니다.

2. 인라인 Snowflake: Debug 옵션은 함수 이름 위에 표시됩니다. 확장 프로그램을 통해 현재 활성 세션을 사용하여 함수에서 저장 프로시저를 실행하려면 이 옵션을 선택합니다. 디버그 중단점을 설정할 수도 있습니다.

SQL 문을 자동으로 감지하기¶

자동 SQL 구문 강조 표시를 설정하려면 확장 프로그램 설정 Auto Detect Sql in Python 을 활성화하십시오. 확장 프로그램은 다음 이미지와 같이 모든 대문자로 된 SQL 키워드를 Python 문자열의 첫 번째 단어로 검색하여 SQL 문을 자동으로 감지합니다.

SQL 문을 수동으로 표시하기¶

1. (선택 사항) 확장 프로그램 설정 Auto Detect Sql in Python 을 비활성화합니다.

2. 주석을 사용하여 SQL 문의 시작과 끝을 나타냅니다. 다음 마커를 원하는 대로 조합하여 사용할 수 있습니다.

   • 시작 마커: -–startsql, -–beginsql, -–start-sql, -–begin-sql

   • 종료 마커: –-endsql, –-end-sql

   다음 이미지는 --begin-sql 및 --end-sql 마커가 SQL 문을 수동으로 표시하는 방법을 보여줍니다.

Python 문자열에서 SQL 자동 완성 사용하기¶

1. Python 파일에서 VS Code 확장 프로그램을 사용하여 활성 Snowflake 세션에 연결된 상태에서 Python 문자열을 생성합니다.

2. SQL 문을 작성합니다. 자동 완성 제안이 표시됩니다.

   예를 들어, SELECT * FROM db1.public 과 같은 문 작성을 시작하면 확장 프로그램에서 자동으로 테이블 이름을 제안합니다.

   마찬가지로, 테이블을 참조하는 SELECT 문 안에 열을 채우기 시작하면 다음 이미지와 같이 확장 프로그램에서 자동으로 열 이름을 제안합니다.

Jinja 템플릿 구문 강조 표시¶

기본적으로 VS Code 확장 프로그램은 다음 이미지와 같이 Snowflake SQL에서 Jinja 템플릿 을 작성할 때 기본 구문 강조 표시 및 대괄호 자동 완성 기능을 추가합니다.

다음 경우에 Snowflake Native App 를 만듭니다.¶

1. VS Code에서 Snowflake VS Code 확장 프로그램을 열고 Snowflake에 로그인합니다.

2. NATIVE APP 창을 확장하고 Create new from template 을 클릭합니다.

3. 다음 중 하나를 선택합니다.

   1. Snowflake Native App 을 생성할 폴더 이름을 입력한 다음 Enter 를 누릅니다.

   2. Enter 를 눌러 기본 디렉터리를 Snowflake Native App 의 위치로 수락합니다.

4. 다음 중 하나를 선택합니다.

   1. Snowflake Native App 템플릿이 저장되어 있는 GitHub 리포지토리의 URL을 입력한 다음 Enter 를 누릅니다.

   2. Enter 를 눌러 기본 GitHub Snowflake Native App 템플릿 리포지토리 URL을 수락합니다.

5. 다음 템플릿 중 하나를 선택합니다.

   1. basic 을 선택하면 최소한의 코드 예제와 안내가 포함된 Snowflake Native App 을 생성할 수 있습니다.

   2. streamlit-python 을 선택하여 Python 확장 프로그램 코드와 Streamlit 코드 예제가 포함된 Snowflake Native App 을 생성합니다.

   3. streamlit-java 를 선택하여 Java 확장 프로그램 코드와 Streamlit 코드 예제가 포함된 Snowflake Native App 을 생성합니다.

   4. spcs-basic 를 선택하여 SPCS 확장 프로그램 코드와 Streamlit 코드 예제가 포함된 Snowflake Native App 을 생성합니다.

Snowflake Native App 배포하고 열기¶

Run (deploy and re-install) 또는 Deploy 옵션을 사용하는 경우, NATIVE APP 창에 나열된 첫 번째 snowflake.yml 파일이 사용됩니다. 여러 개의 snowflake.yml 파일을 사용할 수 있는 경우 메시지가 표시되고 배포에 사용할 snowflake.yml 파일을 선택할 수 있습니다.

Snowflake Native App 을 배포한 후에는 Snowflake에서 열어 액세스 관리, 앱 패키지 보기, 추가 및 유효성 검사, 로그 및 이벤트 보기, 권한 수정 등의 작업을 수행할 수 있습니다.

1. 다음 중 하나를 선택합니다.

   1. VS Code 확장 프로그램의 NATIVE APP 창에서 Run (deploy and re-install) 을 클릭합니다. 상당한 변경을 했고 애플리케이션 오브젝트가 필요한 경우 이 옵션을 사용하는 것이 좋습니다.

   2. VS Code 확장 프로그램의 NATIVE APP 창에서 Deploy 을 클릭합니다. 이 옵션은 애플리케이션 패키지와 스테이지 파일을 배포하고 애플리케이션 오브젝트가 필요하지 않은 경우에 권장됩니다.

2. (선택 사항) 쿼리 결과 패널에서 OUTPUT 탭을 클릭하면 배포 진행 상황을 볼 수 있습니다.

3. NATIVE APP 창에서 Open 을 클릭합니다.

Snowflake Native App 애플리케이션 오브젝트 상태 보기¶

• VS Code 확장 프로그램의 NATIVE APP 창에서 사용자의 애플리케이션을 확장합니다.

  설치가 취소된 애플리케이션 오브젝트는 파란색입니다.

디버그 모드 활성화하기¶

디버그 모드를 사용하면 컨슈머에게 표시되지 않는 애플리케이션 오브젝트를 표시할 수 있습니다. 예를 들어, 공유 내용 오브젝트나 특정 데이터베이스 역할에 부여되지 않은 오브젝트가 있습니다. 디버그 모드 및 프로그래밍 방식으로 켜는 방법에 대한 자세한 내용은 디버그 모드 활성화하기 섹션을 참조하십시오.

1. VS Code 확장 프로그램의 NATIVE APP 창에서 Debug Mode 를 클릭합니다.

2. Enable Debug Mode 를 클릭합니다.

3. Enable debug mode for all Native Apps operations 를 선택합니다.

Snowflake Native App 패키지 및 애플리케이션 오브젝트 삭제¶

Teardown 옵션을 사용하여 해결된 프로젝트 정의에 정의된 애플리케이션 오브젝트 및 패키지를 삭제합니다.

• VS Code 확장 프로그램의 NATIVE APP 창에서 Teardown 을 클릭합니다. 해체가 완료되면 확인 메시지가 표시됩니다.

스테이지의 모든 파일 나열¶

1. VS Code OBJECT EXPLORER 에서 스테이지로 이동합니다.

2. 스테이지를 확장하면 스테이징된 파일을 전부 볼 수 있습니다.

로컬 파일 시스템에서 스테이지로 파일 업로드하기¶

Snowflake Extension for Visual Studio Code 는 내부 스테이지의 업로드만 지원하고 다른 모든 작업은 내부 및 외부 스테이지에 모두 작동합니다.

1. VS Code OBJECT EXPLORER 에서 스테이지로 이동하고 Upload ()를 클릭합니다.

2. 업로드 작업에 대한 선택적 매개 변수를 입력합니다. 선택적 매개 변수의 목록은 PUT 섹션을 참조하십시오.

3. 업로드 파일이 들어 있는 폴더로 이동한 다음, 하나 이상의 파일을 선택하여 업로드합니다.

스테이지에서 로컬 파일 시스템으로 파일 다운로드¶

1. VS Code OBJECT EXPLORER 에서 스테이지로 이동합니다.

2. Download ()를 클릭하여 모든 파일을 다운로드하거나 스테이지를 확장합니다.

3. 파일을 선택하여 다운로드합니다.

4. 디렉터리를 선택하여 다운로드를 완료합니다.

스테이지에서 파일 제거¶

REMOVE 도 참조하십시오.

1. VS Code OBJECT EXPLORER 에서 스테이지로 이동합니다.

2. 파일을 선택합니다.

3. Remove () 를 클릭합니다.

VS Code 확장 미리 보기 설정¶

다음 테이블에는 VS Code 확장 프로그램 미리 보기 설정이 나열되어 있습니다.

VS Code 확장 프로그램 설정 변경하기¶

1. 다음 중 하나를 선택합니다.

   1. Windows/Linux에서는 File » Preferences » Settings 를 선택합니다.

   2. macOS에서 Code » Settings » Settings 를 선택합니다.

2. Search settings 필드에 Snowflake 를 입력합니다.

3. User 또는 Workspace 탭을 선택하여 사용자별 설정 또는 작업 공간별 설정을 보거나 수정합니다.

4. Settings 탭을 닫습니다.