sfsql 시작 및 중지하기 — 사용되지 않음¶

이 항목에서는 sfsql 을 사용하여 Snowflake에 연결하고, 세션을 시작하여 쿼리 및 DDL/DML 문을 시작하며, 완료되면 세션을 종료하는 방법에 대해 설명합니다.

Snowflake에 연결하고 세션 시작하기¶

Snowflake에 연결하여 세션을 시작하려면 sfsql 스크립트가 위치한 디렉터리로 이동하여 다음 구문을 사용하여 스크립트를 실행합니다.

sfsql [ -u <user> ] [ -c <password> ] [ -d <database> ] [ -s <schema> ] ... [ -h ]

참고

Linux 환경에서는 스크립트 이름 앞에 점-슬래시(./sfsql)를 사용해야 합니다. client 설치 디렉터리가 아닌 다른 디렉터리에서 클라이언트를 시작하는 경우에는 반드시 슬래시 뒤에 경로도 포함해야 합니다.

매개 변수¶


연결 매개 변수	`login.defaults` 에 해당	설명
`-g <호스트>`	`GSIP=<호스트>`	연결할 호스트/IP입니다. Snowflake에서 클라이언트를 다운로드할 때 `login.defaults` 에 기본적으로 설정됩니다.
		US 서부에 위치한 계정의 `<호스트>` 형식: `<계정_이름>.snowflakecomputing.com`
		기타 모든 리전에 위치한 계정의 `<호스트>` 형식: `<계정_이름>.<리전_id>.snowflakecomputing.com`
`-a <계정_이름>`	`ACCOUNT=<이름>`	연결할 Snowflake 계정입니다. Snowflake에서 클라이언트를 다운로드할 때 `login.defaults` 에 기본적으로 설정됩니다.
`-u <사용자>`	`USER=<로그인_이름>`	연결할 사용자의 로그인 이름입니다. 이 매개 변수를 지정한 경우에는 `-c` 매개 변수도 지정해야 합니다.
`-c <비밀번호>`	`PASSWORD=<비밀번호>`	사용자의 비밀번호입니다.
`-b <인증자>`	`AUTHENTICATOR=<인증자>`	Snowflake가 아닌 SAML 2.0 규격의 IdP를 사용하여 인증합니다.
`-r <역할>`	`ROLE=<이름>`	Snowflake에서 오브젝트에 액세스하기 위해 기본적으로 사용할 역할입니다(로그인 후 변경 가능).
`-d <데이터베이스>`	`DATABASE=<이름>`	기본적으로 사용할 데이터베이스입니다(로그인 후 변경 가능).
`-s <스키마>`	`SCHEMA=<이름>`	기본적으로 사용할 스키마입니다(로그인 후 변경 가능).
`-w <웨어하우스>`	`WAREHOUSE=<이름>`	쿼리, 로딩 등을 위해 기본적으로 사용할 가상 웨어하우스입니다(로그인 후 변경 가능).
`-f <sqlfile>`	N/A	지정된 SQL 파일을 실행합니다. 이 매개 변수를 지정하지 않으면 클라이언트는 대화형 모드로 연결합니다.
`-t`	`TRACING=<레벨>`	로깅 수준입니다.
`-y <프록시 호스트>`	`PROXY_HOST=<호스트>`	HTTP 프록시 호스트입니다.
`-z <프록시 포트>`	`PROXY_PORT=<포트>`	HTTP 프록시 호스트용 포트입니다.
`-m <mfa_암호>`	`PASSCODE=<mfa_암호>`	MFA 암호입니다.
`-n`	`PASSCODEINPASSWORD=true`	비밀번호에 포함된 MFA 암호입니다.
`-k`	`EXITONERROR=true`	오류가 발생하면 클라이언트를 종료합니다.
`-h`	N/A	로그인 매개 변수(즉, 이 목록)에 대한 도움말입니다.

참고

login.defaults 또는 명령줄에 로그인 이름이나 비밀번호를 지정하지 않으면 로그인하는 동안 클라이언트에서 입력을 요청하는 메시지가 표시됩니다.

잘못된 로그인 이름 또는 비밀번호를 입력하면 클라이언트가 Snowflake에 연결되지 않고 HenPlus 셸 명령줄로 종료됩니다. 셸을 종료(exit, quit 를 입력하거나 [CTRL]-d 키보드 조합 사용)한 후 다시 로그인을 시도해야 합니다. 아니면, HenPlus 셸에서 connect 다음에 유효한 JDBC 연결 문자열을 입력하여 로그인할 수 있습니다.

로그인하는 동안, 클라이언트에서 사용된 JDBC 드라이버 버전과 사용 가능한 최신 드라이버 버전(사용 중인 버전과 다른 경우)이 클라이언트에 표시됩니다. 이 정보는 클라이언트 문제를 해결할 때 유용할 수 있습니다.

로그인되면, 명령줄에 <로그인_이름>@snowflake:<계정_이름>.snowflakecomputing.com 의 형식으로 세션이 연결된 사용자와 호스트의 로그인 이름이 표시됩니다.

예¶

다음 예에서는 xy12345 계정에 대한 이름이 user1 이고 비밀번호가 1234567a 인 Snowflake 사용자로 /Users/user1 디렉터리의 Linux 또는 macOS 환경에 설치된 클라이언트를 시작합니다.

$ cd /Users/user1/client
$ ./sfsql -u user1 -c 1234567a

using GNU readline (Brian Fox, Chet Ramey), Java wrapper by Bernhard Bablok
henplus config at /Users/ybrenman/.henplus
----------------------------------------------------------------------------
 HenPlus II 0.9.8 "Yay Labor Day"
 Copyright(C) 1997..2009 Henner Zeller <H.Zeller@acm.org>
 HenPlus is provided AS IS and comes with ABSOLUTELY NO WARRANTY
 This is free software, and you are welcome to redistribute it under the
 conditions of the GNU Public License <http://www.gnu.org/licenses/gpl2.txt>
----------------------------------------------------------------------------
HenPlus II connecting
 url 'jdbc:snowflake://xy12345.snowflakecomputing.com:443/?account=xy12345&user=user1&ssl=on'
 driver version 2.3
 Snowflake - 1.0 (driver change version: 2.3.1, latest change version: 2.4.38)
no transactions.
 No Transaction *

user1@snowflake:xy12345.snowflakecomputing.com>

Closing a Session and Exiting the Client¶

현재 Snowflake 세션을 닫고 sfsql 을 종료하려면, 명령줄에 exit 또는 quit 을 입력합니다.

Snowflake 세션을 닫을 때:

처리 중인 모든 쿼리 및 DDL/DML 문이 취소됩니다.
세션 중에 생성된 모든 임시 테이블이 삭제됩니다.

참고

[CTRL]-d 를 입력하면 sfsql 이 종료되지만, HenPlus 셸은 종료되지 않습니다. HenPlus 셸을 종료하려면 exit 또는 quit (또는 [CTRL]-d 를 다시 입력)를 입력해야 합니다.