Snowflake Extension for Visual Studio Code¶

Visual Studio Marketplace에서 설치하기¶

Visual Studio Marketplace에서 직접 설치하려면 다음을 수행하십시오.

1. Visual Studio Code를 엽니다.

2. Code » Preferences » Extensions 를 선택합니다.

   View » Extensions 를 선택하거나 VS Code Activity Bar에서 확장 프로그램 버튼 을 클릭할 수도 있습니다.

3. Search Extensions 입력란에 Snowflake 라는 텍스트를 입력하여 Snowflake Visual Studio 확장 프로그램을 검색합니다.

4. 확장 프로그램 세트에서 Snowflake가 작성한 확장 프로그램을 선택하고 Install 을 클릭합니다.

.vsix 파일에서 설치하기¶

.vsix 파일을 다운로드하여 이 파일에서 확장 프로그램을 설치하려면 다음을 수행하십시오.

1. 확장 프로그램을 다운로드합니다.

   1. Snowflake Visual Studio Code 확장 프로그램 페이지를 엽니다.

   2. Version History 탭을 선택합니다.

   3. 다운로드할 버전을 선택하고 Download 를 클릭합니다. 파일이 다운로드되는 위치에 유의하십시오.

2. Visual Studio Code를 엽니다.

3. Code » Preferences » Extensions 를 선택합니다.

   View » Extensions 를 선택하거나 Activity Bar에서 확장 프로그램 버튼 을 클릭할 수도 있습니다.

4. 더 보기(…) 메뉴에서 Install from VSIX 를 선택합니다.

1. 컴퓨터에서 snowflake-x.y.z.vsix 파일을 찾아 선택한 다음 Install 을 선택합니다.

설치가 완료되면 VS Code에서 Extensions 메뉴의 INSTALLED 섹션에 Snowflake Extension for Visual Studio Code 이 나타납니다.

SnowSQL 구성 파일로 Snowflake Extension for Visual Studio Code 사용하기¶

Snowflake Extension for Visual Studio Code 는 연결 구성 로딩을 위해 Snow SQL 구성 파일 을 사용할 수 있습니다.

Snow SQL 구성 파일을 사용하도록 Snowflake Extension for Visual Studio Code 를 구성하려면 다음을 수행하십시오.

1. Activity Bar 에서 Snowflake 아이콘을 선택합니다.

   측면 표시줄 패널이 Snowflake 탐색으로 변경되고 Add Account 또는 Sign in 대화 상자가 표시됩니다.

2. Username 드롭다운을 선택한 다음 Sign in to another account 를 선택합니다.

3. Use SnowSQL Config 를 선택합니다. Snowflake Extension for Visual Studio Code 의 Visual Studio 코드 설정 페이지가 열리는데 SnowSQL Config Path 가 선택되어 있습니다.

4. 유효한 SnowSQL 구성 파일의 경로를 입력합니다.

지정된 구성 파일에 정의된 모든 연결을 포함하도록 계정 드롭다운이 업데이트됩니다.

SQL 파일 열기¶

Snowflake SQL 파일을 만들거나 열려면 다음을 수행하십시오.

1. File » Open 을 선택하고 SQL을 포함한 텍스트 파일을 찾아 엽니다.

   기존 SQL 파일이 없는 경우 새 파일을 만들 수 있습니다. File » New File 을 선택하고 Snowflake SQL File 유형의 파일을 만듭니다. 또는 데이터베이스 탐색기 패널에서 ()을 선택하여 새 SQL 파일을 만듭니다.

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

3. 행을 선택하고 행 위에서 [Execute]를 눌러 명령을 실행합니다.

명령 또는 쿼리 실행하기¶

하나 이상의 명령 또는 쿼리를 실행하려면 다음을 수행하십시오.

1. 선택한 SQL 파일에 대한 을 선택하여 해당 파일의 모든 문을 실행합니다.

2. 실행할 문에 커서를 놓아 실행할 행을 선택합니다.

   둘 이상의 명령 선택 - 선택한 명령이 전부 실행됩니다.

3. 선택한 첫 번째 명령 위에 있는 [Execute] 버튼을 누릅니다.

여러 명령을 선택하면 명령이 위에서 아래로 순서대로 실행됩니다.

바로 가기 키를 사용하여 문을 실행할 수도 있습니다. 실행하려는 SQL 문을 선택한 후 Mac 키보드에서는 + [enter], Windows 키보드에서는 + [enter]를 누릅니다.

Output 섹션의 SNOWFLAKE:QUERY RESULTS 테이블에서 SQL 문의 결과를 확인할 수 있습니다.

쿼리 기록 사용하기¶

쿼리 결과는 QUERY HISTORY 에서 추적됩니다.

이전에 실행한 쿼리 결과를 살펴보려면 다음을 수행하십시오.

1. Query History 를 확장합니다.

2. 문을 선택합니다.

3. Output 창의 SNOWFLAKE:QUERY RESULTS 탭에서 결과를 검사합니다.

쿼리 결과 사용하기¶

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

특정 쿼리의 표시를 수정하려면 다음을 수행하십시오.

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

2. QUERY RESULTS 에서 열을 선택합니다.

3. 아래쪽 화살표(↓)를 선택한 다음 SORT A-Z (내림차순), Sort Z-A (오름차순), Hide column “column name” 또는 Freeze columns up to “column name” 중 하나를 선택합니다.

내용 표시가 적절히 변경됩니다.

쿼리 결과를 디스크에 저장하려면 쿼리와 관련된 디스크() 또는 다운로드()를 선택하십시오. 압축된 gzip 또는 쉼표로 구분된 파일 형식으로 내용이 파일에 저장됩니다.

Snowpark Python 함수 디버깅하기¶

Snowpark Python 함수를 디버깅하려면 다음 안내를 따르십시오.

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

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

Python에서 SQL에 대한 구문 강조 표시 및 자동 완성¶

자동 감지를 활성화하거나 주석을 사용하여 SQL 문자열을 수동으로 표시함으로써 Python 코드에서 SQL의 구문 강조 표시를 추가할 수 있습니다.

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

자동 SQL 구문 강조 표시를 설정하려면 확장 프로그램 설정 Auto Detect Sql in Python 을 활성화하십시오. 확장 프로그램은 다음 스크린샷과 같이 Python 문자열의 첫 번째 단어가 모두 대문자로 된 SQL 키워드를 찾아서 SQL 문을 자동으로 감지합니다.

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

Python 문자열에서 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 자동 완성 사용하기¶

Python 문자열의 SQL 문에 자동 완성을 사용하려면 다음 안내를 따르십시오.

1. Python 파일에서 확장 프로그램을 통해 활성 Snowflake 세션에 연결된 동안 Python 문자열을 만듭니다.

2. SQL 문 작성을 시작하고 나타나는 자동 완성 제안을 확인하십시오.

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

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

Jinja 템플릿 구문 강조 표시¶

기본적으로, 확장 프로그램은 다음 스크린샷과 같이 Snowflake SQL에서 Jinja 템플릿 을 작성하기 위한 기본 구문 강조 표시 및 대괄호 자동 완성을 추가합니다.

스테이지 작업하기¶

Snowflake Extension for Visual Studio Code 는 데이터베이스 탐색기에서 직접 스테이지 콘텐츠 관리를 지원합니다. 다음을 할 수 있습니다.

• 스테이지의 모든 파일을 나열할 수 있습니다.

  1. 특정 스테이지로 이동합니다.

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

• PUT 과 유사하게 로컬 파일 시스템에서 스테이지로 파일을 업로드할 수 있습니다.

  1. 스테이지로 이동하여 업로드()를 선택합니다.

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

  3. 업로드할 파일이 포함된 폴더로 이동하여 파일을 하나 이상 선택하고 업로드합니다.

• GET 과 유사하게 스테이지에서 로컬 파일 시스템으로 파일을 다운로드합니다.

  1. 스테이지로 이동합니다.

  2. 스테이지에서 다운로드()를 선택하여 모든 파일을 다운로드하거나 스테이지를 확장합니다.

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

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

• REMOVE 와 유사하게 스테이지에서 파일을 제거합니다.

  1. 파일을 선택합니다.

  2. 관련 제거 버튼()을 선택합니다.

변경 로그 표시¶

확장 프로그램의 변경 로그를 확인하려면 Show Change Log 명령을 사용할 수도 있습니다.

1. Mac 키보드에서 CMD+Shift+P 를 누르거나 Windows 키보드에서 CTRL+Shift+P 를 눌러 Command Palette 를 엽니다.

2. 다음 명령을 입력합니다.

   Show Change Log
   

   Copy

미리 보기의 확장 프로그램 설정¶

현재 미리 보기로 사용할 수 있는 확장 프로그램 설정은 다음과 같습니다.

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

확장 프로그램 설정을 변경하려면 다음을 수행하십시오.

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

2. Search settings 텍스트 상자에 Snowflake 를 입력합니다.

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

4. Settings 탭을 닫습니다.