SnowSQL 설치하기

이 항목에서는 SnowSQL을 다운로드하여 지원되는 모든 플랫폼에 설치하는 방법에 대해 설명합니다.

SnowSQL 설치 관리자를 다운로드하려면 SnowSQL 다운로드 페이지로 이동하십시오.

참고

  • 새 패치 버전으로 업그레이드하기 위해 설치 관리자를 다운로드하여 실행할 필요는 없습니다. SnowSQL은 자동으로 업그레이드됩니다. 자세한 내용은 이 항목의 자동 업그레이드란 무엇입니까? 섹션을 참조하십시오.

이 항목의 내용:

설치 관리자를 사용하여 Linux에 SnowSQL 설치하기

이 섹션에서는 Linux에 SnowSQL을 설치하기 위해 설치 관리자 패키지를 다운로드, 확인 및 실행하는 방법에 대해 설명합니다.

기본적으로 설치 관리자는 패치 버전으로 자동으로 업그레이드하도록 SnowSQL을 설정합니다. 자동 업그레이드 기능에 대한 자세한 내용은 이 항목의 자동 업그레이드란 무엇입니까? 섹션을 참조하십시오.

SnowSQL을 수동으로 업그레이드하려는 경우(예: 소프트웨어 설치 정책에서 자동 업그레이드를 금지하는 경우) RPM 패키지를 사용하여 SnowSQL을 설치하십시오. RPM 패키지는 SnowSQL이 자동으로 업그레이드되도록 설정하지 않습니다. 지침은 이 항목의 RPM 패키지를 사용하여 Linux에 SnowSQL 설치하기 섹션을 참조하십시오.

다운로드 디렉터리 및 구성 파일 위치 설정하기

기본적으로 SnowSQL 설치 관리자는 다음 디렉터리에 바이너리를 다운로드합니다.

~/.snowsql

결과적으로, 구성 파일 은 다운로드 디렉터리에 위치합니다.

~/.snowsql/config

구성 파일의 다운로드 디렉터리 및 위치를 모두 변경하려면 WORKSPACE 환경 변수를 사용자가 쓸 수 있는 디렉터리로 설정하십시오. 이 접근 방식은 각 프로세스에 격리된 SnowSQL 환경이 있는 경우에 특히 유용합니다.

또한, 여러 SnowSQL 프로세스가 바이너리를 공유할 수 있도록 SNOWSQL_DOWNLOAD_DIR 환경 변수를 설정하여 구성 파일과 다운로드 디렉터리를 분리할 수 있습니다. 예:

$ SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h
Copy

SNOWSQL_DOWNLOAD_DIR 은 SnowSQL 1.1.70 부트스트랩 버전부터 지원됨에 유의하십시오. 현재 사용 중인 버전을 확인하려면 터미널 창 프롬프트에서 다음 명령을 실행합니다.

$ snowsql --bootstrap-version
Copy

SnowSQL 설치 관리자 다운로드하기

SnowSQL 다운로드 페이지로 이동하고 설치하려는 SnowSQL의 버전을 찾아 다음 파일 이름 확장명을 가진 파일을 다운로드합니다.

Curl을 사용하여 SnowSQL 설치 관리자 다운로드하기

스크립트나 터미널 윈도우에서(예: 웹 브라우저 대신 curl 을 사용하여) 설치 관리자를 다운로드하려면 Snowflake Client Repository 에서 직접 설치 관리자를 다운로드할 수 있습니다. 유연성을 향상하기 위해 Snowflake는 리포지토리를 위한 Amazon Web Services(AWS) 및 Azure 엔드포인트를 모두 제공합니다. 지원 클라우드 플랫폼에서 호스팅되는 계정의 경우 둘 중 한 엔드포인트에서 설치 관리자를 다운로드할 수 있습니다.

curl (또는 이와 동등한 명령줄 도구)을 실행하여 설치 관리자를 다운로드합니다. curl 구문은 다음과 같습니다.

AWS 엔드포인트
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/linux_x86_64/snowsql-<version>-linux_x86_64.bash
Copy
Microsoft Azure 엔드포인트
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/linux_x86_64/snowsql-<version>-linux_x86_64.bash
Copy

여기서

  • <버전> 은 SnowSQL 주, 부 및 패치 버전의 조합합니다. 예를 들어, 버전 1.2.3의 경우 주 버전은 1, 부 버전은 2, 패치 버전은 3입니다. 그러므로 버전은 1.2.3입니다.

  • <부트스트랩_버전> 은 SnowSQL 주 및 부 버전의 조합입니다. 예를 들어, 버전 1.2.3의 경우 주 버전은 1, 부 버전은 2이므로 부트스트랩 버전은 1.2입니다.

예를 들어, <부트스트랩_버전> 이 1.2이고 <버전> 이 1.2.31 인 SnowSQL 설치 관리자를 다운로드하려면:

AWS 엔드포인트
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.31-linux_x86_64.bash
Microsoft Azure 엔드포인트
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.31-linux_x86_64.bash

SnowSQL 버전에 대한 자세한 내용은 이 항목의 SnowSQL 버전 관리 이해하기 섹션을 참조하십시오.

패키지 서명 확인하기

다운로드한 패키지의 서명을 확인하는 방법은 다음과 같습니다.

  1. Classic Console 또는 공개 키 서버에서 최신 Snowflake GPG 공개 키를 다운로드하고 가져옵니다.

    웹 인터페이스에서 다운로드
    1. Classic Console 에서 Help Help tab » Download… 를 클릭하여 Downloads 대화 상자를 표시합니다.

    2. 왼쪽에서 CLI Client (snowsql) 을 선택한 후 오른쪽에서 Snowflake GPG Public Key 아이콘을 클릭합니다.

    키 서버에서 다운로드

    SnowSQL 버전과 연결된 GPG 키를 사용하여 다음 명령을 입력합니다.

    • SnowSQL 1.2.24 이상의 경우:

      $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 630D9F3CAB551AF3
    • SnowSQL 버전 1.2.11부터 1.2.23까지:

      $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 37C7086698CB005C
    • SnowSQL 버전 1.1.75부터 1.2.10까지:

      $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys EC218558EABB25A1
    • SnowSQL 버전 1.1.74 이하:

      $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 93DB296A69BE019A

    참고

    이 명령이 다음 오류와 함께 실패하는 경우:

    gpg: keyserver receive failed: Server indicated a failure
    
    Copy

    그리고 키 서버에 포트 80을 사용하도록 지정합니다.

    gpg --keyserver hkp://keyserver.ubuntu.com:80  ...
    
    Copy
  2. GPG 서명을 다운로드하고 확인합니다.

    # If you prefer to use curl to download the signature file, run this command:
    $ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.31-linux_x86_64.bash.sig
    
    # Verify the package signature.
    $ gpg --verify snowsql-1.2.31-linux_x86_64.bash.sig snowsql-1.2.31-linux_x86_64.bash

    또는 Azure 엔드포인트 에서 서명 파일을 다운로드하는 경우:

    # If you prefer to use curl to download the signature file, run this command:
    $ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.31-linux_x86_64.bash.sig
    
    # Verify the package signature.
    $ gpg --verify snowsql-1.2.31-linux_x86_64.bash.sig snowsql-1.2.31-linux_x86_64.bash

    참고

    서명을 확인하면 다음과 유사한 경고가 표시됩니다.

    gpg: Signature made Mon 24 Sep 2018 03:03:45 AM UTC using RSA key ID <gpg_key_id>
    gpg: Good signature from "Snowflake Computing <snowflake_gpg@snowflake.net>" unknown
    gpg: WARNING: This key is not certified with a trusted signature!
    gpg: There is no indication that the signature belongs to the owner.
    
    Copy

    경고를 방지하려면, Snowflake GPG 공개 키에 암시적 신뢰를 부여할 수 있습니다.

  3. 로컬 환경에는 여러 개의 GPG 키가 포함될 수 있지만, 보안상의 이유로 Snowflake는 공개 GPG 키를 주기적으로 순환합니다. 가장 좋은 방법은 서명된 최신 패키지에서 최신 키가 작동하는지 확인한 후 기존 공개 키를 삭제하는 것입니다. 예:

    $ gpg --delete-key "Snowflake Computing"
    
    Copy

설치 관리자를 사용하여 SnowSQL 설치하기

  1. 터미널 창을 엽니다.

  2. 다운로드한 위치에서 Bash 스크립트 설치 관리자를 실행합니다.

    $ bash snowsql-linux_x86_64.bash
    
    Copy
  3. 설치 관리자에서 제공되는 지침을 따릅니다.

참고

다음 환경 변수를 설정하여 설치를 자동화할 수 있습니다.

  • SNOWSQL_DEST: snowsql 실행 파일의 대상 디렉터리입니다.

  • SNOWSQL_LOGIN_SHELL: PATH 환경 업데이트가 포함된 로그인 셸 초기화 파일입니다.

$ SNOWSQL_DEST=~/bin SNOWSQL_LOGIN_SHELL=~/.profile bash snowsql-linux_x86_64.bash
Copy

새로운 주 또는 부 버전을 설치하면 SnowSQL이 자체적으로 즉시 업그레이드되지 않습니다. 대신, SnowSQL을 사용하여 Snowflake 계정에 로그인하고 충분한 시간 동안 연결 상태를 유지하여 자동 업그레이드 기능이 클라이언트를 최신 릴리스로 업그레이드할 수 있도록 합니다. 클라이언트를 실행할 때 현재 시작되는 SnowSQL 버전을 확인하려면 값을 제외하고 -v 옵션을 사용합니다.

$ snowsql -v

  Version: 1.2.3
Copy

SnowSQL가 특정 버전을 강제로 설치하고 사용하도록 하려면 -v 옵션을 사용하여 설치할 버전을 지정합니다. 예를 들어, 버전 1.2.5에 대해 다음 명령을 실행합니다.

$ snowsql -v 1.2.5
Copy

RPM 패키지를 사용하여 Linux에 SnowSQL 설치하기

일부 조직의 소프트웨어 설치 정책에서는 자동 업그레이드가 금지됩니다. 조직에 이 정책이 있거나 소프트웨어를 수동으로 업그레이드하려는 경우 (설치 관리자 대신) RPM 패키지를 사용하여 SnowSQL을 설치할 수 있습니다. RPM 패키지는 자동 업그레이드를 지원하지 않습니다.

자동 업그레이드 기능에 대한 자세한 내용은 이 항목의 자동 업그레이드란 무엇입니까? 섹션을 참조하십시오.

SnowSQL RPM 패키지 다운로드하기

SnowSQL 다운로드 페이지로 이동하고 설치하려는 SnowSQL의 버전을 찾아 파일 이름 확장명이 .rpm 인 파일을 다운로드합니다.

SnowSQL RPM 패키지 설치하기

다운로드한 RPM 파일은 다른 RPM 패키지를 설치하는 방식으로 설치할 수 있습니다.

rpm -i <package_name>
Copy

설치 관리자를 사용하여 macOS에 SnowSQL 설치하기

이 섹션에서는 macOS에 SnowSQL을 설치하기 위해 설치 관리자 패키지를 다운로드 및 실행하는 방법에 대해 설명합니다.

다운로드 디렉터리 및 구성 파일 위치 설정하기

기본적으로 SnowSQL 설치 관리자는 다음 디렉터리에 바이너리를 다운로드합니다.

~/.snowsql

결과적으로, 구성 파일 은 다운로드 디렉터리에 위치합니다.

~/.snowsql/config

WORKSPACE 환경 변수를 사용자가 쓸 수 있는 디렉터리로 설정하여 구성 파일의 다운로드 디렉터리 및 위치를 모두 변경할 수 있습니다. 이러한 기능은 각 프로세스에 격리된 SnowSQL 환경이 있는 경우에 특히 유용합니다.

또한, 여러 SnowSQL 프로세스가 바이너리를 공유할 수 있도록 SNOWSQL_DOWNLOAD_DIR 환경 변수를 설정하여 구성 파일과 다운로드 디렉터리를 분리할 수 있습니다. 예:

$ SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h
Copy

SNOWSQL_DOWNLOAD_DIR 은 SnowSQL 1.1.70 부트스트랩 버전부터 지원됨에 유의하십시오. 현재 사용 중인 버전을 확인하려면 터미널 창 프롬프트에서 다음 명령을 실행합니다.

$ snowsql --bootstrap-version
Copy

SnowSQL 설치 관리자 다운로드하기

SnowSQL 설치 관리자를 다운로드하려면 SnowSQL 다운로드 페이지로 이동하십시오. SnowSQL 설치 관리자의 이 버전에서는 패치가 자동으로 업그레이드됩니다.

Curl을 사용하여 SnowSQL 설치 관리자 다운로드하기

스크립트나 터미널 윈도우에서(예: 웹 브라우저 대신 curl 을 사용하여) 설치 관리자를 다운로드하려면 Snowflake Client Repository 에서 직접 설치 관리자를 다운로드할 수 있습니다. 유연성을 향상하기 위해 Snowflake는 리포지토리를 위한 Amazon Web Services(AWS) 및 Azure 엔드포인트를 모두 제공합니다. 지원 클라우드 플랫폼에서 호스팅되는 계정의 경우 둘 중 한 엔드포인트에서 설치 관리자를 다운로드할 수 있습니다.

curl (또는 이와 동등한 명령줄 도구)을 실행하여 설치 관리자를 다운로드합니다. curl 구문은 다음과 같습니다.

AWS 엔드포인트
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/darwin_x86_64/snowsql-<version>-darwin_x86_64.pkg
Copy
Microsoft Azure 엔드포인트
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/darwin_x86_64/snowsql-<version>-darwin_x86_64.pkg
Copy

여기서

  • <버전> 은 SnowSQL 주, 부 및 패치 버전의 조합합니다. 예를 들어, 버전 1.2.3의 경우 주 버전은 1, 부 버전은 2, 패치 버전은 3입니다. 그러므로 버전은 1.2.3입니다.

  • <부트스트랩_버전> 은 SnowSQL 주 및 부 버전의 조합입니다. 예를 들어, 버전 1.2.3의 경우 주 버전은 1, 부 버전은 2이므로 부트스트랩 버전은 1.2입니다.

예를 들어, <부트스트랩_버전> 이 1.2이고 <버전> 이 1.2.31 인 SnowSQL 설치 관리자를 다운로드하려면:

AWS 엔드포인트
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/darwin_x86_64/snowsql-1.2.31-darwin_x86_64.pkg
Microsoft Azure 엔드포인트
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/darwin_x86_64/snowsql-1.2.31-darwin_x86_64.pkg

SnowSQL 버전에 대한 자세한 내용은 이 항목의 SnowSQL 버전 관리 이해하기 섹션을 참조하십시오.

macOS 운영 체제는 설치 관리자 서명을 자동으로 확인할 수 있으므로 GPG 서명을 확인할 필요가 없습니다.

설치 관리자를 사용하여 SnowSQL 설치하기

  1. 다운로드 위치에서 snowsql-darwin_x86_64.pkg 를 두 번 클릭하여 설치 관리자 PKG 파일을 실행합니다.

  2. 설치 관리자에서 제공되는 지침을 따릅니다.

참고

명령줄에서 설치 관리자를 실행하여 설치를 자동화할 수 있습니다. 대상 디렉터리는 CurrentUserHomeDirectory (~/Applications 디렉터리) 또는 LocalSystem (/Applications 디렉터리)에 설정할 수 있습니다.

$ installer -pkg snowsql-darwin_x86_64.pkg -target CurrentUserHomeDirectory
Copy

새로운 주 또는 부 버전을 설치하면 SnowSQL이 자체적으로 즉시 업그레이드되지 않습니다. 대신, SnowSQL을 사용하여 Snowflake 계정에 로그인하고 충분한 시간 동안 연결 상태를 유지하여 자동 업그레이드 기능이 클라이언트를 최신 릴리스로 업그레이드할 수 있도록 합니다. 클라이언트를 실행할 때 현재 시작되는 SnowSQL 버전을 확인하려면 값을 제외하고 -v 옵션을 사용합니다.

$ snowsql -v

  Version: 1.2.3
Copy

SnowSQL가 특정 버전을 강제로 설치하고 사용하도록 하려면 -v 옵션을 사용하여 설치할 버전을 지정합니다. 예를 들어, 버전 1.2.5에 대해 다음 명령을 실행합니다.

$ snowsql -v 1.2.5
Copy

Z 셸 별칭 구성하기(macOS만 해당)

Z 셸(zsh라고도 함)은 기본 터미널 셸이며, SnowSQL 실행 파일에 대한 별칭을 설정하여 터미널의 명령줄에서 SnowSQL을 실행할 수 있도록 해줍니다. SnowSQL 설치 관리자는 실행 파일을 /Applications/SnowSQL.app/Contents/MacOS/snowsql 에 설치하고 이 경로를 PATH 또는 ~/.profile 의 별칭 항목에 추가합니다. 일반적으로 zsh는 이 파일을 읽지 않으므로 별칭을 ~/.zshrc 의 이 경로에 추가해도 zsh가 읽지 않습니다.

별칭을 SnowSQL 실행 파일에 추가하려면:

  1. ~/.zshrc 파일을 엽니다(없는 경우 생성).

  2. 다음 라인을 추가합니다.

    alias snowsql=/Applications/SnowSQL.app/Contents/MacOS/snowsql
    
    Copy
  3. 파일을 저장합니다.

Homebrew Cask를 사용하여 macOS에 SnowSQL 설치하기

Homebrew Cask 는 패키지 배포, 설치 및 유지 관리에 사용되는 Homebrew 의 인기 있는 확장입니다. SnowSQL 설치 관리자를 별도로 다운로드할 필요가 없습니다. macOS 플랫폼에 Homebrew Cask가 설치된 경우 Snowflake를 직접 설치할 수 있습니다.

brew install 명령을 실행하여 snowflake-snowsql 을 설치할 작업으로 지정합니다.

$ brew install --cask snowflake-snowsql
Copy

Z 셸 별칭 구성하기(macOS만 해당)

Z 셸(zsh라고도 함)은 기본 터미널 셸이며, SnowSQL 실행 파일에 대한 별칭을 설정하여 터미널의 명령줄에서 SnowSQL을 실행할 수 있도록 해줍니다. SnowSQL 설치 관리자는 실행 파일을 /Applications/SnowSQL.app/Contents/MacOS/snowsql 에 설치하고 이 경로를 PATH 또는 ~/.profile 의 별칭 항목에 추가합니다. 일반적으로 zsh는 이 파일을 읽지 않으므로 별칭을 ~/.zshrc 의 이 경로에 추가해도 zsh가 읽지 않습니다.

별칭을 SnowSQL 실행 파일에 추가하려면:

  1. ~/.zshrc 파일을 엽니다(없는 경우 생성).

  2. 다음 라인을 추가합니다.

    alias snowsql=/Applications/SnowSQL.app/Contents/MacOS/snowsql
    
    Copy
  3. 파일을 저장합니다.

설치 관리자를 사용하여 Microsoft Windows에 SnowSQL 설치하기

이 섹션에서는 Microsoft Windows에 SnowSQL을 설치하기 위해 설치 관리자 패키지를 다운로드 및 실행하는 방법에 대해 설명합니다.

다운로드 디렉터리 및 구성 파일 위치 설정하기

기본적으로 SnowSQL 설치 관리자는 다음 디렉터리에 바이너리를 다운로드합니다.

%USERPROFILE%\.snowsql

결과적으로, 구성 파일 은 다운로드 디렉터리에 위치합니다.

%USERPROFILE%\.snowsql\config

WORKSPACE 환경 변수를 사용자가 쓸 수 있는 디렉터리로 설정하여 구성 파일의 다운로드 디렉터리 및 위치를 모두 변경할 수 있습니다. 이러한 기능은 각 프로세스에 격리된 SnowSQL 환경이 있는 경우에 특히 유용합니다.

또한, 여러 SnowSQL 프로세스가 바이너리를 공유할 수 있도록 SNOWSQL_DOWNLOAD_DIR 환경 변수를 설정하여 구성 파일과 다운로드 디렉터리를 분리할 수 있습니다. 예:

$ SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h
Copy

SNOWSQL_DOWNLOAD_DIR 은 SnowSQL 1.1.70 부트스트랩 버전부터 지원됨에 유의하십시오. 현재 사용 중인 버전을 확인하려면 터미널 창 프롬프트에서 다음 명령을 실행합니다.

$ snowsql --bootstrap-version
Copy

SnowSQL 설치 관리자 다운로드하기

SnowSQL 설치 관리자를 다운로드하려면 SnowSQL 다운로드 페이지로 이동하십시오. SnowSQL 설치 관리자의 이 버전에서는 패치가 자동으로 업그레이드됩니다.

Curl을 사용하여 SnowSQL 설치 관리자 다운로드하기

스크립트나 터미널 윈도우에서(예: 웹 브라우저 대신 curl 을 사용하여) 설치 관리자를 다운로드하려면 Snowflake Client Repository 에서 직접 설치 관리자를 다운로드할 수 있습니다. 유연성을 향상하기 위해 Snowflake는 리포지토리를 위한 Amazon Web Services(AWS) 및 Azure 엔드포인트를 모두 제공합니다. 지원 클라우드 플랫폼에서 호스팅되는 계정의 경우 둘 중 한 엔드포인트에서 설치 관리자를 다운로드할 수 있습니다.

curl (또는 이와 동등한 명령줄 도구)을 실행하여 설치 관리자를 다운로드합니다. curl 구문은 다음과 같습니다.

AWS 엔드포인트
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/windows_x86_64/snowsql-<version>-windows_x86_64.msi
Copy
Microsoft Azure 엔드포인트
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/windows_x86_64/snowsql-<version>-windows_x86_64.msi
Copy

여기서

  • <버전> 은 SnowSQL 주, 부 및 패치 버전의 조합합니다. 예를 들어, 버전 1.2.3의 경우 주 버전은 1, 부 버전은 2, 패치 버전은 3입니다. 그러므로 버전은 1.2.3입니다.

  • <부트스트랩_버전> 은 SnowSQL 주 및 부 버전의 조합입니다. 예를 들어, 버전 1.2.3의 경우 주 버전은 1, 부 버전은 2이므로 부트스트랩 버전은 1.2입니다.

예를 들어, <부트스트랩_버전> 이 1.2이고 <버전> 이 1.2.31 인 SnowSQL 설치 관리자를 다운로드하려면:

AWS 엔드포인트
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/windows_x86_64/snowsql-1.2.31-windows_x86_64.msi
Microsoft Azure 엔드포인트
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/windows_x86_64/snowsql-1.2.31-windows_x86_64.msi

SnowSQL 버전에 대한 자세한 내용은 이 항목의 SnowSQL 버전 관리 이해하기 섹션을 참조하십시오.

Windows 운영 체제는 설치 관리자 서명을 자동으로 확인할 수 있으므로 GPG 서명을 확인할 필요가 없습니다.

설치 관리자를 사용하여 SnowSQL 설치하기

  1. 다운로드 위치에서 snowsql-windows_x86_64.msi 를 두 번 클릭하여 설치 관리자 MSI 파일을 실행합니다.

  2. 설치 관리자에서 제공되는 지침을 따릅니다.

참고

명령줄에서 MSI 설치 관리자 msiexec 를 실행하여 설치를 자동화할 수 있습니다. %ProgramFiles%\Snowflake SnowSQL 에서 대상 디렉터리를 변경할 수 없습니다. 예:

C:\Users\<username> msiexec /i snowsql-windows_x86_64.msi /q
Copy

새로운 주 또는 부 버전을 설치하면 SnowSQL이 자체적으로 즉시 업그레이드되지 않습니다. 대신, SnowSQL을 사용하여 Snowflake 계정에 로그인하고 충분한 시간 동안 연결 상태를 유지하여 자동 업그레이드 기능이 클라이언트를 최신 릴리스로 업그레이드할 수 있도록 합니다. 클라이언트를 실행할 때 현재 시작되는 SnowSQL 버전을 확인하려면 값을 제외하고 -v 옵션을 사용합니다.

$ snowsql -v

  Version: 1.2.3
Copy

SnowSQL가 특정 버전을 강제로 설치하고 사용하도록 하려면 -v 옵션을 사용하여 설치할 버전을 지정합니다. 예를 들어, 버전 1.2.5에 대해 다음 명령을 실행합니다.

$ snowsql -v 1.2.5
Copy

SnowSQL 버전 관리 이해하기

SnowSQL 버전 번호는 <주 버전>.<부 버전>.<패치 버전> 의 숫자 3개로 구성됩니다.

예를 들어, 버전 1.2.3은 주 버전이 1, 부 버전이 2, 패치 버전이 3임을 나타냅니다.

클라이언트를 실행할 때 현재 시작되는 SnowSQL 버전을 확인하려면 값을 제외하고 -v 옵션을 사용합니다.

$ snowsql -v

  Version: 1.2.3
Copy

일반적으로 다양한 버전 타입에 적용되는 지침은 다음과 같습니다.

주 버전

주 버전의 변경은 기본 Snowflake 서비스의 대규모 개선을 나타냅니다. 새로운 주 버전은 이전 버전과 호환되지 않습니다. 웹 인터페이스에서 최신 SnowSQL 버전을 다운로드하여 설치해야 합니다.

부 버전

부 버전의 변경은 SnowSQL 또는 기본 Snowflake 서비스에서 다음 버전과의 호환성을 지원하도록 개선되었음을 나타냅니다. 새로운 부 버전에서는 이전 버전과의 호환성이 유지되지만, 웹 인터페이스에서 최신 SnowSQL 버전을 다운로드하여 설치하는 것이 좋습니다.

패치 버전

패치 버전의 변경은 소규모 개선 사항이나 버그 수정이 적용되었음을 나타냅니다. 자동 업그레이드 기능은 모든 패치 버전을 자동으로 설치합니다. 자동 업그레이드 기능에 대한 자세한 내용은 이 항목의 자동 업그레이드란 무엇입니까? 섹션을 참조하십시오.

참고

부 버전이 출시되면 현재 버전의 기능이 계속 작동해야 하지만, 새로 출시된 버그 수정 사항 및 기능은 자동 업그레이드 기능을 통해 사용할 수 없습니다. 그러므로 부 버전의 번호가 증가할 경우 최신 SnowSQL 버전을 다운로드하여 설치하는 것이 매우 좋습니다.

자동 업그레이드란 무엇입니까?

기본적으로, SnowSQL은 최신 패치 버전으로 자동 업그레이드됩니다. 새로운 주 버전 또는 부 버전은 수동 다운로드 및 설치해야 합니다.

최신 패치 버전을 사용할 수 있는 경우, SnowSQL 백그라운드 프로세스에서 새로운 바이너리를 다운로드하고 현재 버전을 실행합니다. 다음에 SnowSQL을 실행할 때 새 버전이 시작됩니다.

프로세스를 설명하려면:

  1. 새로 설치하려면 Snowflake 웹 인터페이스를 사용하여 SnowSQL 설치 관리자(예: 버전 1.2.0)을 다운로드하고 클라이언트를 설치합니다.

  2. SnowSQL을 실행할 때마다 클라이언트는 SnowSQL 업그레이드 리포지토리에 최신 버전이 있는지 확인합니다.

  3. 최신 버전(예: 버전 1.2.1)을 사용할 수 있는 경우 SnowSQL은 현재 설치된 버전을 실행하는 동안 백그라운드 프로세스로 다운로드합니다.

  4. 다음에 SnowSQL을 실행할 때 클라이언트는 버전 1.2.1을 실행하면서 최신 버전이 있는지 확인합니다.

자동 업그레이드 비활성화하기

--noup 옵션을 사용하면 새 버전의 SnowSQL을 다운로드 및 설치할 수 없습니다(사용할 수 있는 경우). Snowflake에 로그인하는 동안 이 옵션을 지정하여 특정 세션 동안 자동 업그레이드되지 않도록 할 수 있습니다.

예:

$ snowsql --noup
Copy

또는, noup = true 옵션을 구성 파일 에 추가하여 옵션이 제거되거나 false 로 설정될 때까지 SnowSQL이 자동으로 업그레이드되지 않도록 합니다.

이전 SnowSQL 버전 실행하기

최신 SnowSQL 버전(예: 버전 1.2.2)에서 문제가 발생하는 경우에는 임시로 이전 버전을 실행할 수 있습니다.

클라이언트를 실행할 때 현재 시작되는 SnowSQL 버전을 확인하려면 값을 제외하고 -v 옵션을 사용합니다.

$ snowsql -v

  Version: 1.2.2
Copy

사용할 수 있는 SnowSQL 버전의 목록을 표시하려면 --versions 옵션을 사용합니다.

$ snowsql --versions

  1.2.3
  1.2.2
  1.2.1
  1.2.0
Copy

목록에서 이전 SnowSQL 버전을 설치하려면 -v 옵션을 사용하여 설치할 버전을 지정합니다. 예를 들어, 버전 1.2.3을 설치하려면:

$ snowsql -v 1.2.3

  Installing version: 1.2.3  [####################################]  100%
Copy

동일한 옵션을 사용하여 SnowSQL을 시작할 때 실행할 버전을 지정합니다.

$ snowsql -v 1.2.3
Copy

SnowSQL 자동 업그레이드 기능에서 사용되는 Snowflake Client Repository 엔드포인트 변경하기

기본적으로 SnowSQL 자동 업그레이드 기능에서는 Snowflake Client Repository의 AWS 엔드포인트를 사용합니다. SnowSQL 구성 파일에서 엔드포인트를 변경하려면 이 섹션의 단계를 완료하십시오.

새 사용자

Snowflake Client Repository의 Microsoft Azure 엔드포인트를 새 SnowSQL 사용자로 지정하려면 다음 명령을 실행합니다.

snowsql -o repository_base_url=https://sfc-repo.azure.snowflakecomputing.com/snowsql
Copy

구성 파일(즉, ~/.snowsql/config 또는 %USERPROFILE%\.snowsql\config)에 다음 라인이 포함되었는지 확인합니다.

repository_base_url=https://sfc-repo.azure.snowflakecomputing.com/snowsql
Copy

기존 사용자

Snowflake Client Repository의 Microsoft Azure 엔드포인트를 기존 SnowSQL 사용자로 지정하려면 구성 파일(즉, ~/.snowsql/config 또는 %USERPROFILE%\.snowsql\config)에 다음 라인을 추가합니다.

repository_base_url=https://sfc-repo.azure.snowflakecomputing.com/snowsql
Copy