sfsql 사용하기 — 사용되지 않음¶
이 항목에서는 클라이언트에서 지원되지 않는 기본 Henplus 명령 목록 등 sfsql
의 사용 방법을 설명합니다.
참고
일부 Snowflake SQL 명령은 sfsql
에서 사용되는 JDBC 드라이버를 통해 구현됩니다. 예를 들어, PUT / GET 은 내부 스테이지에서 파일 업로드 및 파일 다운로드를 수행합니다. 결과적으로, 이러한 작업은 sfsql
에서는 수행할 수 있지만, Snowflake 웹 인터페이스에서는 수행할 수 없습니다.
이 항목의 내용:
매개 변수 설정하기¶
HenPlus는 세션 동작을 제어하는 속성을 제공하지만, sfsql
에서 이러한 속성을 설정하지 않아야 합니다. 대신, Snowflake에서 제공하는 세션 매개 변수 를 사용하십시오.
또한, HenPlus는 모든 세션에서 설정할 수 있는 다음과 같은 전역 속성을 제공합니다(속성 설정은 세션에서 사용자가 로그아웃할 때 저장됨). 다음 전역 속성을 사용하여 SQL 문 결과의 형식과 모양을 제어할 수 있습니다.
전역 매개 변수의 목록과 현재 값을 확인하려면 명령줄에
set-property
를 입력합니다.속성
초기 값
설명
column-delimiter
|
디스플레이에서 열을 구분하거나 형식을 지정하기 사용되는 문자를 지정합니다.
comments-remove
꺼짐(또는 false)
현재 사용되지 않습니다.
echo-commands
꺼짐(또는 false)
명령을 실행하기 전에 문의 표시 여부를 지정합니다.
sql-result-limit
1000000000
문 결과에서 반환되는 최대 행 수를 지정합니다.
sql-result-showfooter
켜짐(또는 true)
결과에 푸터 행의 포함 여부를 지정합니다.
sql-result-showheader
켜짐(또는 true)
결과에 열 헤더를 포함한 헤더 행의 포함 여부를 지정합니다.
전역 매개 변수를 설정하려면
set-property
다음에 매개 변수의 이름과 값을 입력합니다.예를 들어, 결과에서 헤더 및 푸터를 비활성화하려면:
user1@xy12345.snowflakecomputing.com> set-property sql-result-showfooter false user1@xy12345.snowflakecomputing.com> set-property sql-result-showheader false
전역 속성을 설정하기 위해 종료 문자(예: 세미콜론(
;
))를 입력할 필요가 없습니다.
SQL 문 및 스크립트 파일 실행하기¶
SQL 쿼리 또는 문을 실행하려면:
문의 끝 바로 뒤에 세미콜론(
;
)을 입력합니다.문의 뒤에 줄 바꿈을 입력하면, 세미콜론(
;;
) 2개를 입력하여 문을 실행해야 합니다.새 줄에 문을 종료하는 명령인 슬래시(
/
)를 입력할 수도 있습니다.
예를 들어, 구문을 사용하여 다음 쿼리를 실행할 수 있습니다.
user1@xy12345.snowflakecomputing.com> select * from test1; user1@xy12345.snowflakecomputing.com> select * from test1 ;; user1@xy12345.snowflakecomputing.com> select * from test1 /
SQL 스크립트 파일을 실행하려면 @
또는 @@
다음에 파일의 디렉터리 경로와 전체 이름(파일 확장자 포함, 있는 경우)을 사용합니다.
예를 들어, /Users/user1/scripts
디렉터리에 위치한 이름이 query.sql
인 파일을 실행하려면:
user1@xy12345.snowflakecomputing.com> @/Users/user1/scripts/query.sql
참고
또한, HenPlus에서는 start
명령을 사용하여 파일을 실행할 수도 있지만, START 키워드는 Snowflake에서 트랜잭션 시작용으로 예약되어 있으므로 파일을 실행하기 위해 sfsql
에서 이 명령을 사용할 수 없습니다. 자세한 내용은 트랜잭션 섹션을 참조하십시오.
진행 중인 쿼리 취소하기¶
아직 완료되지 않은 쿼리를 취소하려면, [CTRL]-c 키보드 콤보를 사용합니다.
결과 스풀링하기¶
SQL 쿼리 또는 명령의 결과를 스풀링하려면, spool
다음에 결과를 스풀링할 파일의 디렉터리 경로와 이름을 입력합니다.
결과 스풀링을 중지하려면 spool off
를 입력합니다.
Snowflake 명령줄 도움말에 액세스하기¶
Snowflake는 명령줄 도움말 항목을 제공합니다. 도움말에 액세스하려면 다음 구문을 사용합니다.
info [ <topic> | <subtopic> ]
값을 지정하지 않으면 도움말의 모든 최상위 항목이 표시됩니다.
항목이 지정되면 해당 항목의 모든 하위 주제가 표시됩니다.
하위 항목이 지정되면 해당 하위 항목의 내용이 표시됩니다.
예:
info; info warehouses; info alter_warehouse;
지원되지 않는 HenPlus 명령¶
HenPlus는 오브젝트 설명 및 시스템에서 데이터 가져오기/내보내기 등의 작업을 수행하기 위한 기본 명령을 제공합니다. sfsql
에서는 이러한 명령을 사용하지 않아야 합니다. 대신, Snowflake에서 제공하는 SQL 명령을 사용합니다.
지원되지 않는 HenPlus 명령: |
동등한 Snowflake SQL 명령: |
---|---|
|
|
|
|
|
|
|