Snowflake Extension for Visual Studio Code¶

Snowflake는 Snowflake 사용자가 VS Code에서 직접 Snowflake SQL 문을 작성하고 실행할 수 있도록 Visual Studio Code (VS Code)의 확장 프로그램을 제공합니다. 확장 프로그램은 종종 서드 파티에서 제공하는 미리 패키지된 기능으로, VS Code에 새로운 특징과 기능을 추가합니다.

이 항목의 내용:

Snowflake Extension for Visual Studio Code 설치하기
- Visual Studio Marketplace에서 설치하기
- .vsix 파일에서 설치하기
로그인하기
- SnowSQL 구성 파일로 Snowflake Extension for Visual Studio Code 사용하기
Snowflake Extension for Visual Studio Code 인터페이스 탐색하기
SQL 파일 사용하기
세션 컨텍스트 변경하기
데이터베이스 탐색기로 탐색하기
- 스테이지 작업하기
확장 프로그램 세부 정보 보기
확장 프로그램 설정
확장 프로그램 제거하기

Snowflake Extension for Visual Studio Code 설치하기¶

Snowflake 사용자는 Visual Studio Marketplace에서 직접 VS Code 확장 프로그램을 설치하거나 .xsix 파일로 패키지된 확장 프로그램을 다운로드한 다음 설치할 수 있습니다.

Visual Studio Marketplace에서 설치하기¶

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

Visual Studio Code를 엽니다.
Code » Preferences » Extensions 를 선택합니다.

View » Extensions 를 선택하거나 VS Code Activity Bar에서 확장 프로그램 버튼 을 클릭할 수도 있습니다.
Search Extensions 입력란에 Snowflake 라는 텍스트를 입력하여 Snowflake Visual Studio 확장 프로그램을 검색합니다.
확장 프로그램 세트에서 Snowflake가 작성한 확장 프로그램을 선택하고 Install 을 클릭합니다.

.vsix 파일에서 설치하기¶

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

확장 프로그램을 다운로드합니다.
1. Snowflake Visual Studio Code 확장 프로그램 페이지를 엽니다.
2. Version History 탭을 선택합니다.
3. 다운로드할 버전을 선택하고 Download 를 클릭합니다. 파일이 다운로드되는 위치에 유의하십시오.
Visual Studio Code를 엽니다.
Code » Preferences » Extensions 를 선택합니다.

View » Extensions 를 선택하거나 Activity Bar에서 확장 프로그램 버튼 을 클릭할 수도 있습니다.
더 보기(…) 메뉴에서 Install from VSIX 를 선택합니다.

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

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

로그인하기¶

SQL 문을 실행하려면 먼저 Snowflake 계정에 로그인해야 합니다.

Snowflake 계정 식별자, 사용자 이름, 비밀번호를 사용하거나 SAML SSO를 사용하여 Snowflake에 페더레이션 인증을 사용하여 Snowflake에 로그인할 수 있습니다.

VS Code 확장 프로그램에서 Snowflake에 처음 로그인할 때 Snowflake 계정의 계정 식별자 또는 Snowflake에 연결하는 데 사용하는 URL을 입력하여 계정을 추가해야 합니다.

계정 식별자 결정 방법에 대한 자세한 내용은 계정 식별자 섹션을 참조하십시오.

VS Code 확장 프로그램에서 Snowflake에 로그인하려면 다음을 수행하십시오.

Activity Bar 에서 Snowflake 아이콘을 클릭합니다.

측면 표시줄 패널이 Snowflake 탐색으로 변경되고 Add Account 또는 Sign in 대화 상자가 표시됩니다.
Add Account 아래에 계정 식별자를 입력하고 Continue 를 선택합니다.

Add Account 는 이전에 아무런 계정도 지정되지 않은 경우에만 표시됩니다.

선택한 계정의 사용자 이름과 비밀번호를 입력하고 Sign in 을 선택합니다.

로그인에 성공하면 사이드바가 바뀌면서 세션 컨텍스트(ACCOUNT), 기본 역할의 사용자에 대한 DATABASE EXPLORER, QUERY HISTORY 를 표시합니다.

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

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

참고

연결 구성 값만 사용됩니다. 다른 SnowSQL 구성 값은 무시됩니다.

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

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

측면 표시줄 패널이 Snowflake 탐색으로 변경되고 Add Account 또는 Sign in 대화 상자가 표시됩니다.
Username 드롭다운을 선택한 다음 Sign in to another account 를 선택합니다.
Use SnowSQL Config 를 선택합니다. Snowflake Extension for Visual Studio Code 의 Visual Studio 코드 설정 페이지가 열리는데 SnowSQL Config Path 가 선택되어 있습니다.
유효한 SnowSQL 구성 파일의 경로를 입력합니다.

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

Snowflake Extension for Visual Studio Code 인터페이스 탐색하기¶

Snowflake Extension for Visual Studio Code 에는 다음과 같은 주요 섹션이 있습니다.

사이드바 패널(1): 가장 왼쪽 패널은 계정, 데이터베이스 탐색, 쿼리 기록 창입니다.

이 패널을 사용하여 계정 세부 정보를 지정하고 데이터베이스 오브젝트와 쿼리 결과를 검사합니다.
Snowflake SQL 패널(2): Snowflake SQL 패널에는 Snowflake SQL 파일이 표시됩니다.
쿼리 결과 패널(3): 쿼리 결과 패널에 쿼리 결과가 표시됩니다.

Side Bar » Query History 에서 쿼리를 선택하여 실행 결과(패널 4)를 표시합니다.
Side Bar (4)의 쿼리 기록 섹션: 쿼리 기록에는 최근 쿼리가 표시됩니다.
현재 세션(5): 현재 역할, 데이터베이스, 스키마 및 활성 웨어하우스를 포함한 현재 세션 정보입니다.
Snowflake 아이콘(번호가 매겨지지 않음) - Side Bar 패널을 표시하거나 숨기려면 Snowflake 아이콘을 선택하십시오.

The Snowflake SQL extension in use showing its main areas: the sidebar panel, the sql panel and the query results panel.

SQL 파일 사용하기¶

Snowflake Extension for Visual Studio Code 을 사용하여 SQL 파일을 만들고 로드할 수 있습니다. SQL 파일은 하나 이상의 SQL 문을 포함하는 간단한 텍스트 파일입니다.

SQL 파일 열기¶

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

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

기존 SQL 파일이 없는 경우 새 파일을 만들 수 있습니다. File » New File 을 선택하고 Snowflake SQL File 유형의 파일을 만듭니다. 또는 데이터베이스 탐색기 패널에서 ()을 선택하여 새 SQL 파일을 만듭니다.
하나 이상의 Snowflake SQL 문을 파일에 추가합니다.
행을 선택하고 행 위에서 [Execute]를 눌러 명령을 실행합니다.

명령 또는 쿼리 실행하기¶

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

선택한 SQL 파일에 대한 을 선택하여 해당 파일의 모든 문을 실행합니다.
실행할 문에 커서를 놓아 실행할 행을 선택합니다.

둘 이상의 명령 선택 - 선택한 명령이 전부 실행됩니다.
선택한 첫 번째 명령 위에 있는 [Execute] 버튼을 누릅니다.

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

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

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

팁

진행 중인 쿼리는 취소할 수 있습니다. 진행 중인 쿼리를 취소하려면 QUERY HISTORY 에서 쿼리를 찾고 쿼리 취소()를 선택합니다.

쿼리 기록 사용하기¶

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

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

Query History 를 확장합니다.
문을 선택합니다.
Output 창의 SNOWFLAKE:QUERY RESULTS 탭에서 결과를 검사합니다.

팁

Query History 를 사용하여 쿼리를 다시 실행하거나(), 쿼리 텍스트를 클립보드에 복사하거나(), 쿼리를 삭제할 수 있습니다().

쿼리 결과 사용하기¶

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

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

QUERY HISTORY 에서 쿼리를 선택합니다.
QUERY RESULTS 에서 열을 선택합니다.
아래쪽 화살표(↓)를 선택한 다음 SORT A-Z (내림차순), Sort Z-A (오름차순), Hide column 《column name》 또는 Freeze columns up to 《column name》 중 하나를 선택합니다.

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

팁

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

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

세션 컨텍스트 변경하기¶

Side Bar 패널의 Account 섹션을 사용하여 역할, 데이터베이스, 스키마, 웨어하우스를 선택할 수 있습니다. 관련 드롭다운을 사용하여 각각 적절히 선택합니다.

팁

계정 드롭다운을 사용하여 로그인하거나 다양한 계정 간에 전환합니다.

데이터베이스 탐색기로 탐색하기¶

Side Bar 패널의 DATABASE EXPLORER 섹션을 사용하여 데이터베이스 오브젝트의 특성을 검사하고 표시합니다.

데이터베이스 오브젝트를 검사하려면 다음을 수행하십시오.

계정에 로그인합니다.
Sidebar 패널의 DATABASE EXPLORER 섹션을 확장합니다.
데이터베이스를 선택하고 확장합니다.
스키마를 선택하고 확장합니다.
하위 구성 요소로 이동합니다.
Output 창의 SNOWFLAKE:OBJECT DETAILS 탭에서 특성을 확인할 요소를 선택합니다.

팁

연결된 오브젝트의 세부 정보를 표시하려면 오브젝트 세부 정보 보기 버튼()을 사용하십시오. 오브젝트 생성에 사용된 DML을 표시하려면 . 오브젝트 DML 보기 버튼()을 사용하십시오.

테이블, 뷰, 구체화된 뷰 또는 유사한 오브젝트와 관련된 세부 정보를 검사할 때 미리 보기()를 선택하면 최대 100행의 내용에 대한 미리 보기가 표시됩니다.

스테이지 작업하기¶

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

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

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

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

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

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

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

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

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

스테이지로 이동합니다.

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

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

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

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

파일을 선택합니다.

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

참고

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

확장 프로그램 세부 정보 보기¶

언제든지 Snowflake SQL Visual Studio Code 확장 프로그램 정보를 볼 수 있습니다.

다음을 포함하여 확장 프로그램에 대한 다음 세부 정보를 볼 수 있습니다.

버전 정보: 현재 설치된 확장 프로그램의 버전.
변경 로그: 추가, 변경 또는 업데이트된 기능에 대한 버전별 정보.
기능 둘러보기.

또한 활성화/비활성화 드롭다운을 사용하여 확장 프로그램을 비활성화하거나 활성화할 수 있습니다.

확장 프로그램 정보를 보려면 다음을 수행하십시오.

Code » Preferences » Extensions 를 선택합니다.
Snowflake VS Code SQL 확장 프로그램을 선택합니다.

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

확장 프로그램 설정¶

Snowflake Extension for Visual Studio Code 에서는 다음 설정을 지원합니다.

설정	설명	기본값
CSV 내보내기 » 구분 기호	열 구분 기호를 지정합니다.	쉼표
CSV 내보내기 » 헤더	내보낸 CSV 파일에 헤더 행 포함을 활성화합니다.	활성화됨
CSV 내보내기 » 빈 행 포함	내보낸 CSV 파일에 빈 행 포함을 활성화합니다.	제외
CSV 내보내기 » 따옴표	내보낸 CSV 파일의 모든 값을 큰따옴표로 묶습니다.	활성화됨
쿼리 강조 표시	현재 SQL 문에서 배경 강조 표시를 활성화합니다.	활성화됨
문 위에 실행 표시	각 문 위에서 클릭 가능한 실행 작업을 활성화합니다.	활성화됨
Snowsql 구성 경로	설정된 경우 이 파일에서 연결 구성이 로드됩니다.	설정 해제

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

Windows/Linux에서는 File » Preferences » Settings 를 선택합니다. . macOS에서는 Code » Preferences » Settings 를 선택합니다.
Search settings 텍스트 상자에 Snowflake 를 입력합니다.
User 또는 Workspace 탭을 선택하여 사용자별 설정 또는 작업 공간별 설정을 보거나 수정합니다.
Settings 탭을 닫습니다.

확장 프로그램 제거하기¶

확장 프로그램을 비활성화하거나 제거하려면 다음을 수행하십시오.

Code » Preferences » Extensions 를 선택합니다.
확장 프로그램을 선택합니다.
마우스 오른쪽 버튼을 클릭하고 Disable 또는 Uninstall 을 선택합니다.