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
    
    Copy

    전역 속성을 설정하기 위해 종료 문자(예: 세미콜론(;))를 입력할 필요가 없습니다.

SQL 문 및 스크립트 파일 실행하기

SQL 쿼리 또는 문을 실행하려면:

  • 문의 끝 바로 뒤에 세미콜론(;)을 입력합니다.

  • 문의 뒤에 줄 바꿈을 입력하면, 세미콜론(;;) 2개를 입력하여 문을 실행해야 합니다.

  • 새 줄에 문을 종료하는 명령인 슬래시(/)를 입력할 수도 있습니다.

예를 들어, 구문을 사용하여 다음 쿼리를 실행할 수 있습니다.

user1@xy12345.snowflakecomputing.com> select * from test1;


user1@xy12345.snowflakecomputing.com> select * from test1
                                      ;;

user1@xy12345.snowflakecomputing.com> select * from test1
                                      /
Copy

SQL 스크립트 파일을 실행하려면 @ 또는 @@ 다음에 파일의 디렉터리 경로와 전체 이름(파일 확장자 포함, 있는 경우)을 사용합니다.

예를 들어, /Users/user1/scripts 디렉터리에 위치한 이름이 query.sql 인 파일을 실행하려면:

user1@xy12345.snowflakecomputing.com> @/Users/user1/scripts/query.sql
Copy

참고

또한, HenPlus에서는 start 명령을 사용하여 파일을 실행할 수도 있지만, START 키워드는 Snowflake에서 트랜잭션 시작용으로 예약되어 있으므로 파일을 실행하기 위해 sfsql 에서 이 명령을 사용할 수 없습니다. 자세한 내용은 트랜잭션 섹션을 참조하십시오.

진행 중인 쿼리 취소하기

아직 완료되지 않은 쿼리를 취소하려면, [CTRL]-c 키보드 콤보를 사용합니다.

결과 스풀링하기

SQL 쿼리 또는 명령의 결과를 스풀링하려면, spool 다음에 결과를 스풀링할 파일의 디렉터리 경로와 이름을 입력합니다.

결과 스풀링을 중지하려면 spool off 를 입력합니다.

Snowflake 명령줄 도움말에 액세스하기

Snowflake는 명령줄 도움말 항목을 제공합니다. 도움말에 액세스하려면 다음 구문을 사용합니다.

info [ <topic> | <subtopic> ]
Copy
  • 값을 지정하지 않으면 도움말의 모든 최상위 항목이 표시됩니다.

  • 항목이 지정되면 해당 항목의 모든 하위 주제가 표시됩니다.

  • 하위 항목이 지정되면 해당 하위 항목의 내용이 표시됩니다.

예:

info;

info warehouses;

info alter_warehouse;
Copy

지원되지 않는 HenPlus 명령

HenPlus는 오브젝트 설명 및 시스템에서 데이터 가져오기/내보내기 등의 작업을 수행하기 위한 기본 명령을 제공합니다. sfsql 에서는 이러한 명령을 사용하지 않아야 합니다. 대신, Snowflake에서 제공하는 SQL 명령을 사용합니다.

지원되지 않는 HenPlus 명령:

동등한 Snowflake SQL 명령:

tables , views 및 기타 관련 명령

SHOW <오브젝트>

describe , idescribe

DESCRIBE <오브젝트>

import , import-check 및 기타 관련 명령

COPY INTO <테이블>, COPY INTO <위치>

dump-out , dump-in 및 기타 관련 명령

PUT, GET