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.32 인 SnowSQL 설치 관리자를 다운로드하려면:

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

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

패키지 서명 확인하기

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

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

    웹 인터페이스에서 다운로드:
    1. Classic Console 에서 Help 도움말 탭 » 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.32-linux_x86_64.bash.sig
    
    # Verify the package signature.
    $ gpg --verify snowsql-1.2.32-linux_x86_64.bash.sig snowsql-1.2.32-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.32-linux_x86_64.bash.sig
    
    # Verify the package signature.
    $ gpg --verify snowsql-1.2.32-linux_x86_64.bash.sig snowsql-1.2.32-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.32 인 SnowSQL 설치 관리자를 다운로드하려면:

AWS 엔드포인트:
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/darwin_x86_64/snowsql-1.2.32-darwin_x86_64.pkg
Microsoft Azure 엔드포인트:
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/darwin_x86_64/snowsql-1.2.32-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.32 인 SnowSQL 설치 관리자를 다운로드하려면:

AWS 엔드포인트:
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/windows_x86_64/snowsql-1.2.32-windows_x86_64.msi
Microsoft Azure 엔드포인트:
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/windows_x86_64/snowsql-1.2.32-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