SnowSQL을 통해 연결하기¶

연결할 때 비밀번호 지정하기¶

비밀번호는 연결 매개 변수를 통해 전달할 수 없습니다. 비밀번호는 다음 방법 중 1개로 지정해야 합니다.

• SnowSQL에서 대화형 프롬프트 를 통해 입력됩니다(비밀번호에만 적용됨).

• password 옵션을 사용하여 SnowSQL 구성 파일에 정의됩니다. 자세한 내용은 이 항목의 기본 연결 설정 구성하기 섹션을 참조하십시오.

• SNOWSQL_PWD 환경 변수를 사용하여 지정됩니다. 자세한 내용은 이 항목의 환경 변수 사용하기 섹션을 참조하십시오.

환경 변수 사용하기¶

현재 환경 변수는 비밀번호, 호스트 및 데이터베이스와 같은 일부 명령줄 매개 변수 값만 미리 지정하기 위한 용도로 사용할 수 있습니다. 환경 변수는 -D 또는 --variable 연결 매개 변수를 사용하여 SnowSQL을 시작할 때 명령줄에 명시적으로 지정하는 경우를 제외하고 SnowSQL 변수를 대체하기 위해 사용할 수 없습니다. 예:

Linux/macOS

$ snowsql ... -D tablename=CENUSTRACKONE --variable db_key=$DB_KEY

Copy

Windows

$ snowsql ... -D tablename=CENUSTRACKONE --variable db_key=%DB_KEY%

Copy

위의 예에서 --variable 은 이름이 db_key 인 Snowflake 변수를 DB_KEY 환경 변수로 설정합니다.

구성 파일에 명명된 연결 정의하기¶

1. 텍스트 편집기에서 config 구성 파일을 엽니다. 이 파일의 기본 위치는 다음과 같습니다.

   Linux/macOS

   ~/.snowsql/

   Windows

   %USERPROFILE%\.snowsql\

2. 명명된 각 연결에 대해 이름이 고유한 별도의 [connections] 섹션을 추가합니다.

   예를 들어, 다음은 계정 식별자 myorganization-myaccount 가 포함된 Snowflake 계정에 대한 my_example_connection 연결을 보여줍니다.

   [connections.my_example_connection]
   accountname = myorganization-myaccount
   username = jsmith
   password = xxxxxxxxxxxxxxxxxxxx
   dbname = mydb
   schemaname = public
   warehousename = mywh
   

   Copy

명명된 연결을 사용하여 Snowflake에 연결하기¶

-c <문자열> (또는 --connection <문자열>) 연결 매개 변수를 사용하여 명명된 연결을 지정합니다. 여기서 <문자열> 은 구성 파일 에 정의된 연결의 이름입니다.

예를 들어, 이 항목의 구성 파일에 명명된 연결 정의하기 에서 생성한 my_example_connection 연결을 사용하여 연결합니다.

$ snowsql -c my_example_connection

Copy

-a , --accountname¶

설명

필수

계정 식별자 를 지정합니다.

이 연결 매개 변수는 구성 파일 에도 설정할 수 있습니다.

값

문자열

또한, 이 값은 환경 변수일 수도 있습니다.

Linux/macOS

$SNOWSQL_ACCOUNT

Windows

%SNOWSQL_ACCOUNT%

예를 들어, Linux 또는 macOS에서:

$ export SNOWSQL_ACCOUNT=myorganization-myaccount

$ snowsql -a $SNOWSQL_ACCOUNT

Copy

기본값

없음

-u , --username¶

설명

지정된 계정으로 연결할 사용자의 로그인 이름을 지정합니다.

이 연결 매개 변수는 구성 파일 에도 설정할 수 있습니다.

값

문자열

이 값은 환경 변수일 수 있습니다.

Linux/macOS

$SNOWSQL_USER

Windows

%SNOWSQL_USER%

예를 들어, Linux 또는 macOS에서:

$ export SNOWSQL_USER=jdoe

$ snowsql -u $SNOWSQL_USER

Copy

기본값

없음

-d , --dbname¶

설명

클라이언트 세션에서 기본적으로 사용할 데이터베이스를 지정합니다(로그인 후 변경 가능).

값

문자열

이 값은 환경 변수일 수 있습니다.

Linux/macOS

$SNOWSQL_DATABASE

Windows

%SNOWSQL_DATABASE%

이 연결 매개 변수는 구성 파일 에도 설정할 수 있습니다.

기본값

없음

-s , --schemaname¶

설명

클라이언트 세션에서 기본적으로 사용할 스키마를 지정합니다(로그인 후 변경 가능).

값

문자열

이 값은 환경 변수일 수 있습니다.

Linux/macOS

$SNOWSQL_SCHEMA

Windows

%SNOWSQL_SCHEMA%

이 연결 매개 변수는 구성 파일 에도 설정할 수 있습니다.

기본값

없음

-r , --rolename¶

설명

클라이언트 세션에서 Snowflake 오브젝트에 액세스하기 위해 기본적으로 사용할 역할을 지정합니다(로그인 후 변경 가능).

이 연결 매개 변수는 구성 파일 에도 설정할 수 있습니다.

값

문자열

이 값은 환경 변수일 수 있습니다.

Linux/macOS

$SNOWSQL_ROLE

Windows

%SNOWSQL_ROLE%

기본값

없음

-w , --warehouse¶

설명

클라이언트 세션에서 쿼리, 로딩 등을 위해 기본적으로 사용할 가상 웨어하우스를 지정합니다(로그인 후 변경 가능).

이 연결 매개 변수는 구성 파일 에도 설정할 수 있습니다.

값

문자열

이 값은 환경 변수일 수 있습니다.

Linux/macOS

$SNOWSQL_WAREHOUSE

Windows

%SNOWSQL_WAREHOUSE%

기본값

없음

-h , --host — 사용되지 않음¶

설명

하위 버전 호환성/내부 용도를 위해 제공됨

Snowflake에서 연결할 호스트의 주소를 지정합니다.

사용자가 지정한 계정 식별자(-a 또는 --account 사용)와 Snowflake 도메인(snowflakecomputing.com)을 연결하여 호스트 주소가 자동으로 결정되기 때문에 이 매개 변수는 더 이상 사용되지 않습니다.

값

문자열

기본값

없음

-p , --port — 사용되지 않음¶

설명

하위 버전 호환성/내부 용도를 위해 제공됨

연결에서 사용할 포트 번호를 지정합니다.

Snowflake의 포트 번호는 항상 443 이므로 이 매개 변수는 더 이상 사용되지 않습니다.

값

문자열

기본값

없음

--region — 사용되지 않음¶

설명

하위 버전 호환성/내부 용도를 위해 제공됨

사용자 계정이 위치한 리전 의 ID를 지정합니다.

이 매개 변수는 더 이상 사용되지 않습니다. 자세한 내용은 이 항목의 -a , --accountname 섹션을 참조하십시오.

값

N/A

기본값

N/A

-m , --mfa-passcode¶

설명

명령줄에서 암호를 전달하는 경우 MFA(다단계 인증)에 대한 두 번째 토큰을 지정합니다.

값

문자열

기본값

없음

--mfa-passcode-in-password¶

설명

비밀번호의 마지막에 MFA 암호를 추가합니다.

사용자는 비밀번호 프롬프트를 강제로 실행하고 비밀번호 다음에 MFA 암호를 입력할 수 있습니다. 예를 들어, MFA 토큰이 123456 이고 비밀번호가 PASSWORD 인 경우:

$ snowsql ... -P ...

Password: PASSWORD123456

Copy

값

해당 사항 없음(매개 변수가 값을 갖지 않음)

기본값

N/A

--abort-detached-query¶

설명

클라이언트와 서버 간의 연결이 끊어지면 쿼리를 중단합니다.

값

부울

기본값

False(즉, 연결이 끊겨도 활성 쿼리가 중단되지 않음)

--probe-connection¶

설명

Snowflake에 연결 테스트를 수행하고 결과를 보고합니다. 이 옵션은 주로 TLS 인증서 체인을 인쇄하기 위해 사용되는 실험적인 옵션입니다.

값

해당 사항 없음(매개 변수가 값을 갖지 않음)

기본값

N/A

--authenticator¶

설명

사용자 로그인 자격 증명을 확인하기 위해 사용할 인증자를 지정합니다.

값

문자열(상수):

• snowflake 에서는 내부 Snowflake 인증자를 사용합니다.

• externalbrowser 에서는 웹 브라우저 를 사용하여 사용자 계정에 Okta, AD FS 또는 기타 모든 SAML 2.0 규격 ID 공급자(IdP)를 인증합니다.

• https://<okta_계정_이름>.okta.com (즉, Okta용 URL 엔드포인트) 은 기본 Okta를 통해 인증합니다 (IdP가 Okta인 경우에만 지원됨).

• oauth 는 OAuth를 사용하여 인증합니다. OAuth가 인증자로 지정되면 --token 매개 변수도 설정하여 OAuth 토큰을 지정해야 합니다(아래 참조).

자세한 내용은 페더레이션 인증 관리하기/사용하기 및 클라이언트, 드라이버 및 커넥터 섹션을 참조하십시오.

기본값

snowflake

참고

externalbrowser 인증자는 웹 브라우저가 액세스할 수 있는 터미널 창에서만 지원됩니다. 예를 들어, SSH(Secure Shell) 세션을 통해 액세스하는 원격 시스템의 터미널 창에서 웹 브라우저를 열기 위해서는 추가적으로 설정해야 수 있습니다.

웹 브라우저에 액세스할 수 없지만 IdP가 Okta인 경우 기본 Okta를 사용할 수 있습니다(즉, 인증자를 https://<okta_계정_이름>.okta.com 으로 설정).

--token¶

설명

인증에서 사용할 OAuth 토큰을 지정합니다. 이 매개 변수는 --authenticator=oauth 를 지정하는 경우에만 필수입니다.

값

문자열

기본값

없음

-v , --version¶

설명

지정된 SnowSQL 버전을 사용하거나, 버전이 지정되지 않은 경우에는 설치된 최신 SnowSQL 버전을 표시합니다.

값

문자열

기본값

없음

--versions¶

설명

설치 및 실행할 수 있는 SnowSQL의 모든 사용 가능 버전을 나열합니다. 목록에서 이전 SnowSQL 버전을 설치하려면 -v 옵션을 사용하여 설치할 버전을 지정합니다.

값

해당 사항 없음(매개 변수가 값을 갖지 않음)

기본값

N/A

--noup¶

설명

이 실행에 대한 자동 업그레이드를 비활성화합니다. 이 옵션이 포함되지 않고 새 버전을 사용할 수 있는 경우 SnowSQL이 새 버전을 자동으로 다운로드하여 설치합니다. 다음에 SnowSQL을 실행할 때 새 버전이 사용됩니다.

값

해당 사항 없음(매개 변수가 값을 갖지 않음)

기본값

N/A

-D , --variable¶

설명

명령줄에서 SnowSQL 변수를 정의합니다. 이 옵션은 Snowflake에서 사용할 특정 변수를 설정하기 위해 사용할 수 있습니다.

값

문자열

예:

$ snowsql ... -D tablename=CENUSTRACKONE --variable db_key=$DB_KEY ...

Copy

기본값

없음

-o , --option¶

설명

명령줄에서 SnowSQL 구성 옵션을 정의합니다. 이 옵션은 SnowSQL 구성 파일에 설정된 옵션을 재정의합니다. 설정/재정의할 수 있는 옵션에 대한 설명은 SnowSQL 구성 옵션 참조 를 참조하십시오.

값

문자열

기본값

없음

-f , --filename¶

설명

일괄 처리 모드로 실행할 SQL 파일을 지정합니다.

값은 파일 이름(디렉터리 경로 포함, 필요한 경우) 또는 파일에 대한 URL일 수 있습니다.

값

문자열

기본값

없음

-q , --query¶

설명

실행할 SQL 쿼리를 지정합니다.

값은 단일 SQL 쿼리 또는 실행할 쿼리의 세미콜론으로 구분된 목록(예: 'select current_user(); select current_role()')일 수 있습니다.

쿼리를 ;> 로 구분하여 비동기적으로 실행할 여러 쿼리를 지정할 수도 있습니다. 다음 예제에서는 SnowSQL을 시작하고 네 개의 쿼리를 모두 비동기적으로 실행합니다.

snowsql -o log_level=DEBUG -q "select * from SNOWSQLTABLE;> insert into table table1 values(2);> select 5;>select count(*) from testtable;"

값

문자열

기본값

없음

--config¶

설명

SnowSQL 구성 파일의 위치(예: 디렉터리 경로)를 지정합니다. 기본 위치에서 구성 파일을 이동하거나 복사하려면 이 커넥터 매개 변수를 포함하십시오.

값

문자열

기본값

OS에 따라 고유함:

Linux/macOS

~/.snowsql/

Windows

%USERPROFILE%\.snowsql\

-P , --prompt¶

설명

대화형 비밀번호 프롬프트를 강제로 실행합니다.

기본적으로, SnowSQL은 $SNOWSQL_PWD 환경 변수에 저장된 비밀번호를 사용합니다. 이 옵션을 사용하면 $SNOWSQL_PWD에 정의된 비밀번호를 재정의할 수 있습니다.

값

해당 사항 없음(매개 변수가 값을 갖지 않음)

기본값

N/A

-M, --mfa-prompt¶

설명

MFA의 두 번째 토큰에 대한 프롬프트를 강제로 실행합니다. 또는, 명령줄 라인에서 전달하려면 --mfa-passcode <문자열> 을 사용하십시오.

값

해당 사항 없음(매개 변수가 값을 갖지 않음)

기본값

N/A

-c , --connection¶

설명

사용할 연결을 지정합니다. 여기서 지정된 문자열은 SnowSQL 구성 파일에 정의된 연결의 이름입니다. 자세한 내용은 이 항목의 명명된 연결 사용하기 섹션을 참조하십시오.

값

문자열

기본값

없음

--single-transaction¶

설명

이 옵션은 --filename, --query 또는 표준 입력 명령과 결합하여 모든 명령이 성공적으로 완료되거나 변경 사항이 적용되지 않도록 문 주위를 BEGIN/COMMIT로 감쌉니다.

값

해당 사항 없음(매개 변수가 값을 갖지 않음)

기본값

N/A

참고

입력 명령에서 BEGIN, COMMIT, ROLLBACK을 사용하는 경우에는 이 옵션이 올바르게 작동하지 않음에 유의하십시오. 또한, 트랜잭션 블록 내에서 명령을 실행할 수 없는 경우 이 옵션을 사용하면 명령이 실패하게 됩니다.

--private-key-path¶

설명

개인 키 파일의 경로입니다.

조심

암호화되지 않은 개인 키가 지원되지만, Snowflake에 연결할 때는 반드시 암호화된 개인 키를 사용하는 것이 좋습니다.

자세한 내용은 키 페어 인증 및 키 페어 순환 사용하기 를 참조하십시오.

이 연결 매개 변수는 구성 파일 에도 설정할 수 있습니다.

값

문자열

기본값

없음

--disable-request-pooling¶

설명

기본적으로, snowsql에서는 연결 풀링을 사용합니다. 연결 풀링을 사용하면 일반적으로 연결을 생성하기 위해 소요되는 시간이 감소합니다. 그러나 DNS 문제가 발생하면 클라이언트가 대체 DNS로 장애 조치를 수행하는 속도가 느려질 수 있습니다. 이 매개 변수를 사용하면 연결 풀링을 끌 수 있습니다.

이 매개 변수는 복제가 활성화된 고객에게만 적용됩니다.

값

해당 사항 없음(매개 변수가 값을 갖지 않음)

기본값

N/A

-U , --upgrade¶

설명

SnowSQL이 로컬 디렉터리에 다운로드되지 않은 경우 최신 버전으로 강제로 업그레이드합니다.

값

해당 사항 없음(매개 변수가 값을 갖지 않음)

기본값

N/A

참고

SnowSQL 1.1.63 또는 최신 버전의 부트스트랩 실행 파일이 필요합니다. UI에서 다운로드할 수 있습니다.

-K , --client-session-keep-alive¶

설명

사용자의 활동이 없는 경우에도 세션을 무기한 활성 상태로 유지합니다.

값

해당 사항 없음(매개 변수가 값을 갖지 않음)

기본값

N/A

--include_connector_version¶

설명

SnowSQL 바이너리에 패키지된 Python용 Snowflake 커넥터 소프트웨어 버전을 표시합니다.

값

해당 사항 없음(매개 변수가 값을 갖지 않음)

기본값

N/A

-? , --help¶

설명

명령줄 빠른 사용 가이드를 표시합니다.

값

해당 사항 없음(매개 변수가 값을 갖지 않음)

기본값

N/A