EXECUTE IMMEDIATE FROM¶

템플릿 지시문¶

두 가지 템플릿 지시문 중 하나를 사용할 수 있습니다.

권장 지시문은 유효한 SQL 구문을 사용합니다.

--!jinja

선택적으로, 대체 지침을 사용할 수 있습니다.

#!jinja

템플릿에서 스테이징된 파일의 내용 사용하기¶

템플릿은 SnowflakeFile API 를 통해 직접 또는 Jinja2의 include, import 및 inheritance 기능을 통해 다른 스테이징된 파일을 로딩할 수 있습니다.

파일은 절대 경로로 참조할 수 있습니다.

{% include "@my_stage/path/to/my_template" %}
{% import "@my_stage/path/to/my_template" as my_template %}
{% extends "@my_stage/path/to/my_template" %}
{{ SnowflakeFile.open("@my_stage/path/to/my_template", 'r', require_scoped_url = False).read() }}

포함, 가져오기 및 확장은 상대 경로도 지원하며 SnowflakeFile API 는 범위가 지정된 Snowflake 파일 URLs 을 지원합니다.

{% include "my_template" %}
{% import "../my_template" as my_template %}
{% extends "/path/to/my_template" %}

참고 항목:

EXECUTE IMMEDIATE

절대 파일 경로(absoluteFilePath)¶

namespace

database_name.schema_name 또는 schema_name 형식의 내부 또는 외부 스테이지가 있는 데이터베이스 및/또는 스키마입니다. 데이터베이스와 스키마가 사용자 세션에 대해 현재 사용 중인 경우, 네임스페이스는 선택 사항 입니다. 그렇지 않은 경우, 필수입니다.

stage_name

내부 또는 외부 스테이지의 이름입니다.

path

스테이지에 있는 파일의 경로이며 대/소문자를 구분합니다.

filename

실행할 파일의 이름입니다. 구문상 정확하고 유효한 SQL 문을 포함해야 합니다. 각 문은 세미콜론으로 구분해야 합니다.

상대 파일 경로(relativeFilePath)¶

path

스테이지에 있는 파일의 상대 경로이며 대/소문자를 구분합니다. 상대 경로는 스테이지 파일 시스템의 루트를 나타내는 선행 /, 현재 디렉터리(상위 파일이 있는 디렉터리)를 가리키는 ./, 상위 디렉터리를 가리키는 ../ 와 같이 확립된 규칙을 지원합니다. 자세한 내용은 사용법 노트 섹션을 참조하십시오.

filename

실행할 파일의 이름입니다. 구문상 정확하고 유효한 SQL 문을 포함해야 합니다. 각 문은 세미콜론으로 구분해야 합니다.

파일 오류¶

001501 (02000): File '<directory_name>' not found in stage '<stage_name>'.

001503 (42601): Relative file references like '<filename.sql>' cannot be used in top-level EXECUTE IMMEDIATE calls.

001003 (42000): SQL compilation error: syntax error line <n> at position <m> unexpected '<string>'.

스테이지 오류¶

002003 (02000): SQL compilation error: Stage '<stage_name>' does not exist or not authorized.

액세스 제어 오류¶

003001 (42501): Uncaught exception of type 'STATEMENT_ERROR' in file <file_name> on line <n> at position <m>:
SQL access control error: Insufficient privileges to operate on schema '<schema_name>'

참고 항목: 스테이지 오류.

템플릿 오류¶

001003 (42000): SQL compilation error:
syntax error line [n] at position [m] unexpected '{'.

000005 (XX000): Python Interpreter Error:
jinja2.exceptions.UndefinedError: '<key>' is undefined
in template processing

001510 (42601): Unable to use value of template variable '<key>'

001518 (42601): Size of expanded template exceeds limit of 100,000 bytes.

기본 예제¶

이 예에서는 my_stage 스테이지에 있는 create-inventory.sql 파일을 실행합니다.

1. 다음 문으로 create-inventory.sql 이라는 파일을 만듭니다.

   CREATE OR REPLACE TABLE my_inventory(
     sku VARCHAR,
     price NUMBER
   );
   
   EXECUTE IMMEDIATE FROM './insert-inventory.sql';
   
   SELECT sku, price
     FROM my_inventory
     ORDER BY price DESC;
   

   Copy

2. 다음 문으로 insert-inventory.sql 이라는 파일을 만듭니다.

   INSERT INTO my_inventory
     VALUES ('XYZ12345', 10.00),
            ('XYZ81974', 50.00),
            ('XYZ34985', 30.00),
            ('XYZ15324', 15.00);
   

   Copy

3. 내부 스테이지 my_stage 를 만듭니다.

   CREATE STAGE my_stage;
   

   Copy

4. PUT 명령을 사용하여 두 로컬 파일을 모두 스테이지에 업로드합니다.

   PUT file://~/sql/scripts/create-inventory.sql @my_stage/scripts/
     AUTO_COMPRESS=FALSE;
   
   PUT file://~/sql/scripts/insert-inventory.sql @my_stage/scripts/
     AUTO_COMPRESS=FALSE;
   

   Copy

5. my_stage 에 있는 create-inventory.sql 스크립트를 실행합니다.

   EXECUTE IMMEDIATE FROM @my_stage/scripts/create-inventory.sql;
   

   Copy

   반환 결과:

   +----------+-------+
   | SKU      | PRICE |
   |----------+-------|
   | XYZ81974 |    50 |
   | XYZ34985 |    30 |
   | XYZ15324 |    15 |
   | XYZ12345 |    10 |
   +----------+-------+
   

간단한 템플릿 예제¶

1. 두 개의 변수와 템플릿 지시문을 사용하여 템플릿 파일 setup.sql 을 생성합니다.

   --!jinja
   
   CREATE SCHEMA {{env}};
   
   CREATE TABLE RAW (COL OBJECT)
       DATA_RETENTION_TIME_IN_DAYS = {{retention_time}};
   

   Copy

2. 스테이지 만들기 — 이미 파일을 업로드할 수 있는 스테이지가 있는 경우 선택 사항 입니다.

   예를 들어, Snowflake에서 내부 스테이지를 생성합니다.

   CREATE STAGE my_stage;
   

   Copy

3. 파일을 스테이지에 복사합니다.

   예를 들어, 로컬 환경에서 PUT 명령을 사용하여 setup.sql 파일을 my_stage 스테이지로 업로드합니다.

   PUT file://path/to/setup.sql @my_stage/scripts/
     AUTO_COMPRESS=FALSE;
   

   Copy

4. setup.sql 파일을 실행합니다.

   EXECUTE IMMEDIATE FROM @my_stage/scripts/setup.sql
       USING (env=>'dev', retention_time=>0);
   

   Copy

매크로, 조건부, 루프 및 가져오기가 포함된 템플릿 예제¶

1. 매크로 정의가 포함된 템플릿 파일을 만듭니다.

   예를 들어 로컬 환경에서 macros.jinja 파일을 만듭니다.

   {%- macro get_environments(deployment_type) -%}
     {%- if deployment_type == 'prod' -%}
       {{ "prod1,prod2" }}
     {%- else -%}
       {{ "dev,qa,staging" }}
     {%- endif -%}
   {%- endmacro -%}
   

   Copy

2. 템플릿 파일을 생성하고 파일 상단에 템플릿 지시문(--!jinja2)을 추가합니다.

   템플릿 지시어 뒤에 import 문을 추가하여 이전 단계에서 생성한 파일에 정의된 매크로를 가져옵니다. 예를 들어 로컬 환경에서 setup-env.sql 파일을 만듭니다.

   --!jinja2
   {% from "macros.jinja" import get_environments %}
   
   {%- set environments = get_environments(DEPLOYMENT_TYPE).split(",") -%}
   
   {%- for environment in environments -%}
     CREATE DATABASE {{ environment }}_db;
     USE DATABASE {{ environment }}_db;
     CREATE TABLE {{ environment }}_orders (
       id NUMBER,
       item VARCHAR,
       quantity NUMBER);
     CREATE TABLE {{ environment }}_customers (
       id NUMBER,
       name VARCHAR);
   {% endfor %}
   

   Copy

3. 스테이지 만들기 — 이미 파일을 업로드할 수 있는 스테이지가 있는 경우 선택 사항 입니다.

   예를 들어, Snowflake에서 내부 스테이지를 생성합니다.

   CREATE STAGE my_stage;
   

   Copy

4. 파일을 스테이지에 복사합니다.

   예를 들어, 로컬 환경에서 PUT 명령을 사용하여 setup-env.sql 및 macros.jinja 파일을 my_stage 스테이지에 업로드합니다.

   PUT file://path/to/setup-env.sql @my_stage/scripts/
     AUTO_COMPRESS=FALSE;
   PUT file://path/to/macros.jinja @my_stage/scripts/
     AUTO_COMPRESS=FALSE;
   

   Copy

5. 템플릿에서 렌더링된 SQL 문을 미리 보고 Jinja2 코드에 문제가 있는지 확인하십시오.

   EXECUTE IMMEDIATE FROM @my_stage/scripts/setup-env.sql
     USING (DEPLOYMENT_TYPE => 'prod') DRY_RUN = TRUE;
   

   Copy

   반환 결과:

   +----------------------------------+
   | rendered file contents           |
   |----------------------------------|
   | --!jinja2                        |
   | CREATE DATABASE prod1_db;        |
   |   USE DATABASE prod1_db;         |
   |   CREATE TABLE prod1_orders (    |
   |     id NUMBER,                   |
   |     item VARCHAR,                |
   |     quantity NUMBER);            |
   |   CREATE TABLE prod1_customers ( |
   |     id NUMBER,                   |
   |     name VARCHAR);               |
   | CREATE DATABASE prod2_db;        |
   |   USE DATABASE prod2_db;         |
   |   CREATE TABLE prod2_orders (    |
   |     id NUMBER,                   |
   |     item VARCHAR,                |
   |     quantity NUMBER);            |
   |   CREATE TABLE prod2_customers ( |
   |     id NUMBER,                   |
   |     name VARCHAR);               |
   |                                  |
   +----------------------------------+
   

6. setup-env.sql 파일을 실행합니다.

   EXECUTE IMMEDIATE FROM @my_stage/scripts/setup-env.sql
     USING (DEPLOYMENT_TYPE => 'prod');
   

   Copy