SnowSQL 설치하기¶
이 항목에서는 SnowSQL을 다운로드하여 지원되는 모든 플랫폼에 설치하는 방법에 대해 설명합니다.
SnowSQL 설치 관리자를 다운로드하려면 SnowSQL 다운로드 페이지로 이동하십시오.
참고
SnowSQL 1.3.0 릴리스에서는 자동 업그레이드가 비활성화되었으므로 새 버전이 나올 때마다 수동으로 다운로드하여 다시 설치해야 합니다.
이 항목의 내용:
설치 관리자를 사용하여 Linux에 SnowSQL 설치하기¶
이 섹션에서는 Linux에 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
SNOWSQL_DOWNLOAD_DIR
은 SnowSQL 1.1.70 부트스트랩 버전부터 지원됨에 유의하십시오. 현재 사용 중인 버전을 확인하려면 터미널 창 프롬프트에서 다음 명령을 실행합니다.
$ snowsql --bootstrap-version
SnowSQL 설치 관리자 다운로드하기¶
SnowSQL 다운로드 페이지로 이동하고 설치하려는 SnowSQL의 버전을 찾아 다음 파일 이름 확장명을 가진 파일을 다운로드합니다.
.bash
(설치 관리자 스크립트).bash.sig
(다운로드한 패키지를 확인 하는 데 사용할 수 있는 서명)
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
- Microsoft Azure 엔드포인트:
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/linux_x86_64/snowsql-<version>-linux_x86_64.bash
여기서
<버전>
은 SnowSQL 주, 부 및 패치 버전의 조합합니다. 예를 들어, 버전 1.3.1의 경우 주 버전은 1, 부 버전은 3, 패치 버전은 1입니다. 그러므로 버전은 1.3.1입니다.<부트스트랩_버전>
은 SnowSQL 주 및 부 버전의 조합입니다. 예를 들어, 버전 1.3.1의 경우 주 버전은 1, 부 버전은 23이므로 부트스트랩 버전은 1.3입니다.
예를 들어, <bootstrap_version>
이 1.3이고 <버전>
이 1.3.2 인 SnowSQL 설치 관리자를 다운로드하려면:
- AWS 엔드포인트:
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.3/linux_x86_64/snowsql-1.3.2-linux_x86_64.bash
- Microsoft Azure 엔드포인트:
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.3/linux_x86_64/snowsql-1.3.2-linux_x86_64.bash
SnowSQL 버전에 대한 자세한 내용은 이 항목의 SnowSQL 버전 관리 이해하기 섹션을 참조하십시오.
패키지 서명 확인하기¶
다운로드한 패키지의 서명을 확인하는 방법은 다음과 같습니다.
Classic Console 또는 공개 키 서버에서 최신 Snowflake GPG 공개 키를 다운로드하고 가져옵니다.
- 웹 인터페이스에서 다운로드:
- 키 서버에서 다운로드:
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
그리고 키 서버에 포트 80을 사용하도록 지정합니다.
gpg --keyserver hkp://keyserver.ubuntu.com:80 ...
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.3/linux_x86_64/snowsql-\ |snowsql-version|\ -linux_x86_64.bash.sig # Verify the package signature. gpg --verify snowsql-\ |snowsql-version|\ -linux_x86_64.bash.sig snowsql-\ |snowsql-version|\ -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.3/linux_x86_64/snowsql-\ |snowsql-version|\ -linux_x86_64.bash.sig # Verify the package signature. gpg --verify snowsql-\ |snowsql-version|\ -linux_x86_64.bash.sig snowsql-\ |snowsql-version|\ -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.
경고를 방지하려면, Snowflake GPG 공개 키에 암시적 신뢰를 부여할 수 있습니다.
로컬 환경에는 여러 개의 GPG 키가 포함될 수 있지만, 보안상의 이유로 Snowflake는 공개 GPG 키를 주기적으로 순환합니다. 가장 좋은 방법은 서명된 최신 패키지에서 최신 키가 작동하는지 확인한 후 기존 공개 키를 삭제하는 것입니다. 예:
gpg --delete-key "Snowflake Computing"
설치 관리자를 사용하여 SnowSQL 설치하기¶
터미널 창을 엽니다.
다운로드한 위치에서 Bash 스크립트 설치 관리자를 실행합니다.
bash snowsql-linux_x86_64.bash
설치 관리자에서 제공되는 지침을 따릅니다.
참고
다음 환경 변수를 설정하여 설치를 자동화할 수 있습니다.
SNOWSQL_DEST
:snowsql
실행 파일의 대상 디렉터리입니다.SNOWSQL_LOGIN_SHELL
:PATH
환경 업데이트가 포함된 로그인 셸 초기화 파일입니다.
SNOWSQL_DEST=~/bin SNOWSQL_LOGIN_SHELL=~/.profile bash snowsql-linux_x86_64.bash
새로운 주 또는 부 버전을 설치하면 SnowSQL이 자체적으로 즉시 업그레이드되지 않습니다. 대신, SnowSQL을 사용하여 Snowflake 계정에 로그인하고 충분한 시간 동안 연결 상태를 유지하여 자동 업그레이드 기능이 클라이언트를 최신 릴리스로 업그레이드할 수 있도록 합니다. 클라이언트를 실행할 때 현재 시작되는 SnowSQL 버전을 확인하려면 값을 제외하고 -v
옵션을 사용합니다.
snowsql -v
Version: 1.3.1
SnowSQL가 특정 버전을 강제로 설치하고 사용하도록 하려면 -v
옵션을 사용하여 설치할 버전을 지정합니다. 예를 들어, 버전 1.3.0에 대해 다음 명령을 실행합니다.
snowsql -v 1.3.0
RPM 패키지를 사용하여 Linux에 SnowSQL 설치하기¶
소프트웨어를 수동으로 업그레이드하려면 설치 관리자 대신 RPM 패키지를 사용하여 SnowSQL을 설치할 수 있습니다. RPM 패키지는 자동 업그레이드를 지원하지 않습니다.
SnowSQL RPM 패키지 다운로드하기¶
SnowSQL 다운로드 페이지로 이동하고 설치하려는 SnowSQL의 버전을 찾아 파일 이름 확장명이 .rpm
인 파일을 다운로드합니다.
SnowSQL RPM 패키지 설치하기¶
다운로드한 RPM 파일은 다른 RPM 패키지를 설치하는 방식으로 설치할 수 있습니다.
rpm -i <package_name>
설치 관리자를 사용하여 macOS에 SnowSQL 설치하기¶
이 섹션에서는 macOS에 SnowSQL을 설치하기 위해 설치 관리자 패키지를 다운로드 및 실행하는 방법에 대해 설명합니다.
다운로드 디렉터리 및 구성 파일 위치 설정하기¶
기본적으로 SnowSQL 설치 관리자는 다음 디렉터리에 바이너리를 다운로드합니다.
~/.snowsql
결과적으로, 구성 파일 은 다운로드 디렉터리에 위치합니다.
~/.snowsql/config
WORKSPACE
환경 변수를 사용자가 쓸 수 있는 디렉터리로 설정하여 구성 파일의 다운로드 디렉터리 및 위치를 모두 변경할 수 있습니다. 이러한 기능은 각 프로세스에 격리된 SnowSQL 환경이 있는 경우에 특히 유용합니다.
또한, 여러 SnowSQL 프로세스가 바이너리를 공유할 수 있도록 SNOWSQL_DOWNLOAD_DIR
환경 변수를 설정하여 구성 파일과 다운로드 디렉터리를 분리할 수 있습니다. 예:
SNOWSQL_DOWNLOAD_DIR=/var/shared snowsql -h
SNOWSQL_DOWNLOAD_DIR
은 SnowSQL 1.1.70 부트스트랩 버전부터 지원됨에 유의하십시오. 현재 사용 중인 버전을 확인하려면 터미널 창 프롬프트에서 다음 명령을 실행합니다.
snowsql --bootstrap-version
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
- Microsoft Azure 엔드포인트:
curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/darwin_x86_64/snowsql-<version>-darwin_x86_64.pkg
여기서,
<버전>
은 SnowSQL 주, 부 및 패치 버전의 조합합니다. 예를 들어, 버전 1.3.1의 경우 주 버전은 1, 부 버전은 3, 패치 버전은 1입니다. 그러므로 버전은 1.3.1입니다.<부트스트랩_버전>
은 SnowSQL 주 및 부 버전의 조합입니다. 예를 들어, 버전 1.3.1의 경우 주 버전은 1, 부 버전은 3이므로 부트스트랩 버전은 1.3입니다.
예를 들어, <bootstrap_version>
이 1.3이고 <버전>
이 1.3.2 인 SnowSQL 설치 관리자를 다운로드하려면:
- AWS 엔드포인트:
curl -O \https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.3/darwin_x86_64/snowsql-\ |snowsql-version|\ -darwin_x86_64.pkg
- Microsoft Azure 엔드포인트:
curl -O \https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.3/darwin_x86_64/snowsql-\ |snowsql-version|\ -darwin_x86_64.pkg
SnowSQL 버전에 대한 자세한 내용은 이 항목의 SnowSQL 버전 관리 이해하기 섹션을 참조하십시오.
macOS 운영 체제는 설치 관리자 서명을 자동으로 확인할 수 있으므로 GPG 서명을 확인할 필요가 없습니다.
설치 관리자를 사용하여 SnowSQL 설치하기¶
다운로드 위치에서
snowsql-darwin_x86_64.pkg
를 열어 설치 관리자 PKG 파일을 실행합니다.설치 관리자에서 제공되는 지침을 따릅니다.
참고
명령줄에서 설치 관리자를 실행하여 설치를 자동화할 수 있습니다. 대상 디렉터리는 CurrentUserHomeDirectory
(~/Applications
디렉터리) 또는 LocalSystem
(/Applications
디렉터리)에 설정할 수 있습니다.
installer -pkg snowsql-darwin_x86_64.pkg -target CurrentUserHomeDirectory
새로운 주 또는 부 버전을 설치하면 SnowSQL이 자체적으로 즉시 업그레이드되지 않습니다. 대신, SnowSQL을 사용하여 Snowflake 계정에 로그인하고 충분한 시간 동안 연결 상태를 유지하여 자동 업그레이드 기능이 클라이언트를 최신 릴리스로 업그레이드할 수 있도록 합니다. 클라이언트를 실행할 때 현재 시작되는 SnowSQL 버전을 확인하려면 값을 제외하고 -v
옵션을 사용합니다.
snowsql -v
Version: 1.3.0
SnowSQL가 특정 버전을 강제로 설치하고 사용하도록 하려면 -v
옵션을 사용하여 설치할 버전을 지정합니다. 예를 들어, 버전 1.3.1에 대해 다음 명령을 실행합니다.
snowsql -v 1.3.1
Z 셸 별칭 구성하기(macOS만 해당)¶
Z 셸(zsh라고도 함)은 기본 터미널 셸이며, SnowSQL 실행 파일에 대한 별칭을 설정하여 터미널의 명령줄에서 SnowSQL을 실행할 수 있도록 해줍니다. SnowSQL 설치 관리자는 실행 파일을 /Applications/SnowSQL.app/Contents/MacOS/snowsql
에 설치하고 이 경로를 PATH 또는 ~/.profile
의 별칭 항목에 추가합니다. 일반적으로 zsh는 이 파일을 읽지 않으므로 별칭을 ~/.zshrc
의 이 경로에 추가해도 zsh가 읽지 않습니다.
별칭을 SnowSQL 실행 파일에 추가하려면:
~/.zshrc
파일을 엽니다(없는 경우 생성).다음 라인을 추가합니다.
alias snowsql=/Applications/SnowSQL.app/Contents/MacOS/snowsql
파일을 저장합니다.
Homebrew Cask를 사용하여 macOS에 SnowSQL 설치하기¶
Homebrew Cask 는 패키지 배포, 설치 및 유지 관리에 사용되는 Homebrew 의 인기 있는 확장입니다. SnowSQL 설치 관리자를 별도로 다운로드할 필요가 없습니다. macOS 플랫폼에 Homebrew Cask가 설치된 경우 Snowflake를 직접 설치할 수 있습니다.
brew install
명령을 실행하여 snowflake-snowsql
을 설치할 작업으로 지정합니다.
$ brew install --cask snowflake-snowsql
Z 셸 별칭 구성하기(macOS만 해당)¶
Z 셸(zsh라고도 함)은 기본 터미널 셸이며, SnowSQL 실행 파일에 대한 별칭을 설정하여 터미널의 명령줄에서 SnowSQL을 실행할 수 있도록 해줍니다. SnowSQL 설치 관리자는 실행 파일을 /Applications/SnowSQL.app/Contents/MacOS/snowsql
에 설치하고 이 경로를 PATH 또는 ~/.profile
의 별칭 항목에 추가합니다. 일반적으로 zsh는 이 파일을 읽지 않으므로 별칭을 ~/.zshrc
의 이 경로에 추가해도 zsh가 읽지 않습니다.
별칭을 SnowSQL 실행 파일에 추가하려면:
~/.zshrc
파일을 엽니다(없는 경우 생성).다음 라인을 추가합니다.
alias snowsql=/Applications/SnowSQL.app/Contents/MacOS/snowsql
파일을 저장합니다.
설치 관리자를 사용하여 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
SNOWSQL_DOWNLOAD_DIR
은 SnowSQL 1.1.70 부트스트랩 버전부터 지원됨에 유의하십시오. 현재 사용 중인 버전을 확인하려면 터미널 창 프롬프트에서 다음 명령을 실행합니다.
snowsql --bootstrap-version
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
- Microsoft Azure 엔드포인트:
curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/windows_x86_64/snowsql-<version>-windows_x86_64.msi
여기서
<버전>
은 SnowSQL 주, 부 및 패치 버전의 조합합니다. 예를 들어, 버전 1.3.1의 경우 주 버전은 1, 부 버전은 3, 패치 버전은 1입니다. 그러므로 버전은 1.3.1입니다.<부트스트랩_버전>
은 SnowSQL 주 및 부 버전의 조합입니다. 예를 들어, 버전 1.3.1의 경우 주 버전은 1, 부 버전은 3이므로 부트스트랩 버전은 1.3입니다.
예를 들어, <bootstrap_version>
이 1.3이고 <버전>
이 1.3.2 인 SnowSQL 설치 관리자를 다운로드하려면:
- AWS 엔드포인트:
curl -O \https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.3/windows_x86_64/snowsql-\ |snowsql-version|\ -windows_x86_64.msi
- Microsoft Azure 엔드포인트:
curl -O \https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.3/windows_x86_64/snowsql-\ |snowsql-version|\ -windows_x86_64.msi
SnowSQL 버전에 대한 자세한 내용은 이 항목의 SnowSQL 버전 관리 이해하기 섹션을 참조하십시오.
Windows 운영 체제는 설치 관리자 서명을 자동으로 확인할 수 있으므로 GPG 서명을 확인할 필요가 없습니다.
설치 관리자를 사용하여 SnowSQL 설치하기¶
다운로드 위치에서
snowsql-windows_x86_64.msi
를 열어 설치 관리자 MSI 파일을 실행합니다.설치 관리자에서 제공되는 지침을 따릅니다.
참고
명령줄에서 MSI 설치 관리자 msiexec
를 실행하여 설치를 자동화할 수 있습니다. %ProgramFiles%Snowflake SnowSQL
에서 대상 디렉터리를 변경할 수 없습니다. 예:
C:\Users\<username> msiexec /i snowsql-windows_x86_64.msi /q
새로운 주 또는 부 버전을 설치하면 SnowSQL이 자체적으로 즉시 업그레이드되지 않습니다. 대신, SnowSQL을 사용하여 Snowflake 계정에 로그인하고 충분한 시간 동안 연결 상태를 유지하여 자동 업그레이드 기능이 클라이언트를 최신 릴리스로 업그레이드할 수 있도록 합니다. 클라이언트를 실행할 때 현재 시작되는 SnowSQL 버전을 확인하려면 값을 제외하고 -v
옵션을 사용합니다.
snowsql -v
Version: 1.3.1
SnowSQL가 특정 버전을 강제로 설치하고 사용하도록 하려면 -v
옵션을 사용하여 설치할 버전을 지정합니다. 예를 들어, 버전 1.3.0에 대해 다음 명령을 실행합니다.
snowsql -v 1.3.0
SnowSQL 버전 관리 이해하기¶
SnowSQL 버전 번호는 <주 버전>.<부 버전>.<패치 버전>
의 숫자 3개로 구성됩니다.
예를 들어, 버전 1.3.1은 주 버전이 1, 부 버전이 3, 패치 버전이 1임을 나타냅니다.
클라이언트를 실행할 때 현재 시작되는 SnowSQL 버전을 확인하려면 값을 제외하고 -v
옵션을 사용합니다.
snowsql -v
Version: 1.3.1
일반적으로 다양한 버전 타입에 적용되는 지침은 다음과 같습니다.
- 주 버전:
주 버전의 변경은 기본 Snowflake 서비스의 대규모 개선을 나타냅니다. 새로운 주 버전은 이전 버전과 호환되지 않습니다. 웹 인터페이스에서 최신 SnowSQL 버전을 다운로드하여 설치해야 합니다.
- 부 버전:
부 버전의 변경은 SnowSQL 또는 기본 Snowflake 서비스에서 다음 버전과의 호환성을 지원하도록 개선되었음을 나타냅니다. 새로운 부 버전에서는 이전 버전과의 호환성이 유지되지만, Snowflake는 웹 인터페이스에서 최신 SnowSQL 버전을 다운로드하여 설치할 것을 권장합니다.
- 패치 버전:
패치 버전의 변경은 소규모 개선 사항이나 버그 수정이 적용되었음을 나타냅니다.
자동 업그레이드 기능은 모든 패치 버전을 자동으로 설치합니다. 자동 업그레이드 기능에 대한 자세한 내용은 이 항목의 자동 업그레이드란 무엇입니까? 섹션을 참조하십시오.
참고
Snowflake에서 새로운 부 버전 또는 패치 버전을 릴리스하면 현재 버전의 기능은 계속 작동하지만, 새로 릴리스된 버그 수정 및 기능은 자동 업그레이드 기능을 통해 사용할 수 없습니다. 따라서 새 버전이 출시되면 최신 SnowSQL 버전을 다운로드하여 설치하는 것을 적극 권장합니다.
자동 업그레이드란 무엇입니까?¶
중요
버전 1.3.0부터 SnowSQL은 자동 업그레이드 발생 시 프로덕션 환경에 영향을 미칠 수 있는 잠재적인 문제를 방지하기 위해 기본적으로 자동 업그레이드를 비활성화합니다. 업그레이드하려면 비운영 환경에서 수동으로 새 버전을 다운로드하여 설치해야 합니다. Snowflake는 이 설정을 비활성화할 것을 강력히 권장하지만, 새 버전이 릴리스될 때 자동으로 설치하려면 SnowSQL --noup
옵션 을 비활성화할 수 있습니다.
SnowSQL에 대한 자동 업그레이드를 활성화하도록 선택하면 SnowSQL은 백그라운드 프로세스에서 새 바이너리를 자동으로 다운로드하고 현재 버전을 실행합니다. 다음에 SnowSQL을 실행할 때 새 버전이 시작됩니다.
프로세스를 설명하려면:
새로 설치하려면 Snowflake 웹 인터페이스를 사용하여 SnowSQL 설치 관리자(예: 버전 1.3.0)을 다운로드하고 클라이언트를 설치합니다.
SnowSQL을 실행할 때마다 클라이언트는 SnowSQL 업그레이드 리포지토리에 최신 버전이 있는지 확인합니다.
최신 버전(예: 버전 1.3.1)을 사용할 수 있는 경우 SnowSQL은 현재 설치된 버전을 실행하는 동안 백그라운드 프로세스로 다운로드합니다.
다음에 SnowSQL을 실행할 때 클라이언트는 버전 1.3.1을 실행하면서 최신 버전이 있는지 확인합니다.
자동 업그레이드 활성화하기¶
-o noup=<값 >
옵션을 사용하면 새 버전에 대해 수동 설치를 요구하는 SnowSQL 기본 동작을 재정의할 수 있습니다.
True
는 업그레이드 안 함 동작을 활성화합니다(버전 1.3.0 이상의 기본값). SnowSQL은 자동으로 업그레이드 여부를 확인하지 않고 자동으로 업그레이드합니다.False
는 업그레이드 안 함 동작을 비활성화합니다(버전 1.2.32 이하의 기본값). SnowSQL은 자동으로 업그레이드를 확인하고 동일한major.minor
버전 내에서 새로운 업그레이드가 있을 경우 자동으로 업그레이드합니다.
특정 세션 동안 자동 업그레이드를 활성화하려면 Snowflake에 로그인하는 동안 이 옵션을 지정할 수 있습니다.
예:
snowsql - o noup=False
또는 구성 파일 에 noup = False
옵션을 추가하여 SnowSQL에 대한 자동 업그레이드를 활성화할 수 있습니다.
이전 SnowSQL 버전 실행하기¶
참고
SnowSQL 1.3.0 버전 이상을 실행 중인 경우 이 프로세스를 사용하여 1.2.x 버전을 실행할 수 없습니다. 1.2.x 버전을 실행하려면 이전 버전을 수동으로 다운로드하여 설치해야 합니다.
1.3.1 버전과 같은 최신 SnowSQL 버전에서 문제가 발생하는 경우 다른 1.3.x 버전을 일시적으로 실행할 수 있습니다.
클라이언트를 실행할 때 현재 시작되는 SnowSQL 버전을 확인하려면 값을 제외하고 -v
옵션을 사용합니다.
$ snowsql -v Version: 1.3.1
사용할 수 있는 SnowSQL 버전의 목록을 표시하려면 --versions
옵션을 사용합니다.
$ snowsql --versions 1.3.1 1.3.0
목록에서 이전 SnowSQL 버전을 설치하려면 -v
옵션을 사용하여 설치할 버전을 지정합니다. 예를 들어, 1.3.1과 같은 최신 버전을 실행 중인 경우 1.3.0 버전을 설치하려면 다음과 같이 합니다.
$ snowsql -v 1.3.0 Installing version: 1.3.0 [####################################] 100%
동일한 옵션을 사용하여 SnowSQL을 시작할 때 실행할 버전을 지정합니다.
$ snowsql -v 1.3.0
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
구성 파일(즉, ~/.snowsql/config
또는 %USERPROFILE%\.snowsql\config
)에 다음 라인이 포함되었는지 확인합니다.
repository_base_url=https://sfc-repo.azure.snowflakecomputing.com/snowsql
기존 사용자¶
Snowflake Client Repository의 Microsoft Azure 엔드포인트를 기존 SnowSQL 사용자로 지정하려면 구성 파일(즉, ~/.snowsql/config
또는 %USERPROFILE%\.snowsql\config
)에 다음 라인을 추가합니다.
repository_base_url=https://sfc-repo.azure.snowflakecomputing.com/snowsql