SQL 문 실행하기¶

SQL 템플릿에 변수 사용하기¶

특정 상황에서는 상황에 따라 SQL 쿼리를 변경하고 싶을 수도 있습니다. snow sql 명령은 쿼리를 제출하기 전에 로컬에서 확인되는 변수를 명령에서 사용할 수 있게 해주는 클라이언트 측 변수 대체를 지원합니다. SQL 문자열의 변수는 <% variable_name %> 형식이며, -D (또는 --variable) 옵션은 변수 값을 지정합니다.

참고

현재 템플릿에 SnowSQL &variable_name 및 <% variable_name %> 구문을 사용할 수 있습니다. 그러나 Snowflake는 <% variable_name %> 구문을 사용할 것을 권장합니다.

예를 들어, 클라이언트 측 변수를 사용하여 데이터베이스를 지정하려면 다음과 유사한 명령을 입력할 수 있습니다.

snow sql -q "select * from <% database %>.logs" -D "database=dev"

명령이 실행되면 <% database %> 변수의 값 dev 를 대체하여 dev.logs 파일명을 생성한 다음 select * from dev.logs SQL 쿼리를 처리하기 위해 Snowflake로 보냅니다.

다음과 같이 여러 개의 변수 입력을 지정할 수도 있습니다.

snow sql \
-q "grant usage on database <% database %> to <% role %>" \
-D "database=dev" \
-D "role=eng_rl"

이 예제는 다음과 같은 SQL 쿼리를 생성합니다.

grant usage on database dev to eng_rl

snowflake.yml 프로젝트 정의 파일에 변수 저장하기¶

변수를 snow sql 명령줄 옵션으로 지정하는 것은 항상 실용적이지 않을 수 있으며, 명령줄에 중요한 값을 지정하고 싶지 않을 수도 있습니다. 이러한 경우 snowflake.yml 프로젝트 정의 파일에서 변수와 값을 정의할 수 있습니다. 그런 다음 -D "<variable> = <value>" 옵션을 사용하는 대신, 변수 이름을 <% ctx.env.<variable_name> %> 형식으로 지정할 수 있습니다.

이전 섹션의 예제를 사용하여 데이터베이스 및 역할 변수를 snowflake.yml 파일에 저장하고 쿼리를 다음으로 변경할 수 있습니다.

snow sql -q "grant usage on database <% ctx.env.database %> to <% ctx.env.role %>"

이 예제에서 snow sql 명령은 프로젝트 정의 파일에서 변수 정의를 찾아서 명령줄에 표시하지 않고 값을 추출합니다. snowflake.yml 파일은 현재 작업 디렉터리 또는 -p 옵션으로 지정한 위치에 있어야 합니다.

프로젝트 정의 파일에 이러한 값을 저장하는 방법에 대한 자세한 내용은 SQL에서 변수 사용하기 섹션을 참조하십시오.

비동기적으로 SQL 쿼리 실행하기¶

Snowflake CLI 를 사용하면 하나 이상의 SQL 쿼리를 비동기적으로 실행할 수 있습니다. 결과를 기다리는 대신, snow sql 명령은 Snowflake에서 쿼리를 예약하고 쿼리 ID 를 반환합니다. 쿼리가 완료되면 !result 쿼리 명령 또는 SQL RESULT_SCAN 명령을 사용하여 결과를 확인할 수 있습니다.

SQL 쿼리를 비동기적으로 실행하려면 아래에 표시된 것처럼 ; 대신 ;> 로 쿼리를 끝내십시오.

snow sql -q 'select "My async query" ;>'

다음은 단일 쿼리를 비동기적으로 실행하는 예입니다.

snow sql -q "select 'This is async query';>"

select 'This is async query'
+--------------------------------------+
| scheduled query ID                   |
|--------------------------------------|
| 01bc3011-080f-f2d7-0001-c1be14bae7c2 |
+--------------------------------------+

그런 다음 !result 쿼리 명령에 반환된 쿼리ID 를 사용하여 쿼리 결과를 표시할 수 있습니다.

snow sql -q '!result 01bc3011-080f-f2d7-0001-c1be14bae7c2'

path-to-private-key-file
+-----------------------+
| 'THIS IS ASYNC QUERY' |
|-----------------------|
| This is async query   |
+-----------------------+

아래 표시된 것처럼, 쿼리 문자열에서 비동기 및 동기식으로 여러 쿼리를 실행할 수도 있습니다.

snow sql -q "select 'This is async query';> select 'Not an async query'; select 'Another async query';>"

select 'This is async query'
+--------------------------------------+
| scheduled query ID                   |
|--------------------------------------|
| 01bc3b8c-0109-2e81-0000-0f2d0e5a4a32 |
+--------------------------------------+

select 'Not an async query';
+----------------------+
| 'NOT AN ASYNC QUERY' |
|----------------------|
| Not an async query   |
+----------------------+

select 'Another async query'
+--------------------------------------+
| scheduled query ID                   |
|--------------------------------------|
| 01bc3b8c-0109-2e81-0000-0f2d0e5a4a36 |
+--------------------------------------+

SQL 쿼리 명령으로 작업하기¶

Snowflake CLI 는 SQL 쿼리 내에서 사용할 수 있는 다음 명령을 제공합니다.

• 로컬 파일 또는 URL에서 SQL 을 실행하는 !source.

• 모든 SQL 쿼리를 나열하는 !queries.

• SQL 쿼리의 결과를 표시하는 !result.

• 활성 SQL 쿼리를 중단하는 !abort.

snow sql -q '!source my_sql_code.sql'

select emp_id FROM employees;
!source code_file_2.sql

snow sql -q '!result 01bc3011-080f-f2d7-0001-c1be14bae7c2'

+-----------------------+
| 'THIS IS ASYNC QUERY' |
|-----------------------|
| This is async query   |
+-----------------------+

snow sql -q '!abort 01bc3011-080f-f2d7-0001-c1be14bae7c2'

+-------------------------------------------------------------+
| SYSTEM$CANCEL_QUERY('01BC3011-080F-F2D7-0001-C1BE14BAE7C2') |
|-------------------------------------------------------------|
| Identified SQL statement is not currently executing.        |
+-------------------------------------------------------------+

단일 트랜잭션에 여러 명령 입력하기¶

--single-transaction 옵션을 사용하면 여러 개의 SQL 명령을 입력하여 전부 또는 전무 명령 세트로 실행할 수 있습니다. 단일 트랜잭션에서 명령을 실행하면 변경 사항을 커밋하기 전에 모든 명령이 성공적으로 완료되었는지 확인할 수 있습니다. 명령 중 하나라도 실패하면 성공한 명령의 변경 사항이 유지되지 않습니다.

다음 예는 성공적인 트랜잭션과 실패한 트랜잭션을 보여줍니다.

• 성공적인 명령 실행

  snow sql -q "insert into my_tbl values (123); insert into my_tbl values (124);" --single-transaction
  

  Copy

  BEGIN;
  +----------------------------------+
  | status                           |
  |----------------------------------|
  | Statement executed successfully. |
  +----------------------------------+
  
  insert into my_tbl values (123);
  +-------------------------+
  | number of rows inserted |
  |-------------------------|
  | 1                       |
  +-------------------------+
  
  insert into my_tbl values (124);
  +-------------------------+
  | number of rows inserted |
  |-------------------------|
  | 1                       |
  +-------------------------+
  
  COMMIT
  +----------------------------------+
  | status                           |
  |----------------------------------|
  | Statement executed successfully. |
  +----------------------------------+
  

  그런 다음 명령이 데이터베이스에 커밋되었는지 확인할 수 있습니다.

  snow sql -q "select count(*) from my_tbl"
  

  Copy

  select count(*) from my_tbl
  +----------+
  | COUNT(*) |
  |----------|
  | 2        |
  +----------+
  

• 실패한 단일 트랜잭션

  snow sql -c patcli -q "insert into my_tbl values (123); insert into my_tbl values (124); select BAD;" --single-transaction
  

  Copy

  BEGIN;
  +----------------------------------+
  | status                           |
  |----------------------------------|
  | Statement executed successfully. |
  +----------------------------------+
  
  insert into my_tbl values (123);
  +-------------------------+
  | number of rows inserted |
  |-------------------------|
  | 1                       |
  +-------------------------+
  
  insert into my_tbl values (124);
  +-------------------------+
  | number of rows inserted |
  |-------------------------|
  | 1                       |
  +-------------------------+
  
  select BAD;
  ╭─ Error ───────────────────────────────────────────────────────────────────────────────╮
  │ 000904 (42000): 01bc3b84-0810-0247-0001-c1be14ee11ce: SQL compilation error: error    │
  │ line 1 at position 7                                                                  │
  │ invalid identifier 'BAD'                                                              │
  ╰───────────────────────────────────────────────────────────────────────────────────────╯
  

그런 다음 명령이 데이터베이스에 커밋되지 않았는지 확인할 수 있습니다.

snow sql -q "select count(*) from my_tbl"

Copy

select count(*) from my_tbl
+----------+
| COUNT(*) |
|----------|
| 0        |
+----------+

대화형 모드에서 SQL 명령 입력하기¶

snow sql 명령은 SQL 명령을 한 번에 하나씩 입력할 수 있는 대화형 모드를 지원합니다. 대화형 모드는 다음과 같은 기능을 제공합니다.

• 구문 강조 표시

  

• 입력 중 코드 완성

  

• 검색 가능한 기록

  CTRL-R: 을 누르면 명령 기록을 검색할 수 있습니다.

  

• 다중 라인 입력

  세미콜론으로 끝나지 않는 줄에서 ENTER (;)를 누르면 문이 세미콜론으로 끝날 때까지 커서가 다음 줄로 이동하여 더 많은 명령을 볼 수 있습니다.

  

대화형 모드를 사용하려면 아래에 표시된 것처럼 snow sql 명령을 입력한 다음에 ENTER 를 누릅니다.

snow sql

이 명령은 SQL 명령을 대화형으로 입력할 수 있는 > 프롬프트가 있는 하위 셸을 엽니다.

$ snow sql
  ╭───────────────────────────────────────────────────────────────────────────────────╮
  │ Welcome to Snowflake-CLI REPL                                                     │
  │ Type 'exit' or 'quit' to leave                                                    │
  ╰───────────────────────────────────────────────────────────────────────────────────╯
  >

그런 다음 아래와 같이 SQL 명령을 입력할 수 있습니다.

> create table my_table (c1 int);

+-------------------------------------+
| status                              |
|-------------------------------------|
| Table MY_TABLE successfully created.|
+-------------------------------------+

대화형 모드를 종료하려면 exit, quit 를 입력하거나 CTRL-D 를 누릅니다.