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 설치하기

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

Visual Studio Marketplace에서 설치하기

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

  1. Visual Studio Code를 엽니다.

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

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

  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에서 확장 프로그램 버튼 vsc-extensions-button 을 클릭할 수도 있습니다.

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

    In the Extensions page, select more and then Install from VSIX file.
  5. 컴퓨터에서 snowflake-x.y.z.vsix 파일을 찾아 선택한 다음 Install 을 선택합니다.

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

The Snowflake SQL extension, after being installed in Visual Studio Code.

로그인하기

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

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

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

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

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

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

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

  2. Add Account 아래에 계정 식별자를 입력하고 Continue 를 선택합니다.

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

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

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

SQL 파일 사용하기

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

SQL 파일 열기

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

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

    기존 SQL 파일이 없는 경우 새 파일을 만들 수 있습니다. File » New File 을 선택하고 Snowflake SQL File 유형의 파일을 만듭니다.

    Alternatively, click the (vsc-new-sql-file-button) button in the Database explorer panel to create a new SQL file.

    The Snowflake SQL extension database explorer panel with new SQL file button highlighted.
  2. 하나 이상의 Snowflake SQL 문을 파일에 추가합니다.

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

명령 또는 쿼리 실행하기

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

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

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

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

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

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

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

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

In-progress queries can be cancelled. To cancel a query in process, find the query in QUERY HISTORY and press the cancel query (vsc-cancel-query-button).

쿼리 기록 사용하기

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

쿼리 결과를 표시하려면 다음을 수행하십시오.

  1. Query History 를 확장합니다.

  2. 문을 선택합니다.

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

Example of executing a statement with result highlighted.

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

세션 컨텍스트 변경하기

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

The Snowflake sign in dialog.

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

Sign in to, or switch between accounts.

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

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

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

  • 버전 정보: 현재 설치된 확장 프로그램의 버전.

  • 변경 로그: 추가, 변경 또는 업데이트된 기능에 대한 버전별 정보.

  • 기능 둘러보기.

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

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

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

  2. Snowflake VS Code SQL 확장 프로그램을 선택합니다.

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

확장 프로그램 제거하기

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

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

  2. 확장 프로그램을 선택합니다.

  3. 마우스 오른쪽 버튼을 클릭하고 Disable 또는 Uninstall 을 선택합니다.