EXECUTE IMMEDIATE FROM¶

Diretriz de modelagem¶

Você pode usar qualquer uma das duas diretrizes de modelagem.

A diretriz recomendada usa a sintaxe SQL válida:

--!jinja

Opcionalmente, você pode usar a diretriz alternativa:

#!jinja

Como usar conteúdo de arquivos preparados em um modelo¶

Um modelo pode carregar outros arquivos preparados diretamente por meio da SnowflakeFile API ou por meio dos recursos include, import e inheritance do Jinja2.

Os arquivos podem ser referenciados por caminhos absolutos:

{% 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() }}

Include, import e extends também oferecem suporte a caminhos relativos, enquanto a API SnowflakeFile aceita URLs de arquivo Snowflake com escopo:

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

Consulte também:

EXECUTE IMMEDIATE

Caminho absoluto do arquivo (absoluteFilePath)¶

namespace

Banco de dados e/ou esquema no qual está o estágio interno ou externo, na forma de database_name.schema_name ou schema_name. O namespace é opcional se um banco de dados e esquema estiverem em uso atualmente para a sessão do usuário; caso contrário, ele é obrigatório.

stage_name

Nome do estágio interno ou externo.

path

Caminho que diferencia maiúsculas de minúsculas para o arquivo no estágio.

filename

Nome do arquivo a ser executado. Deve conter instruções SQL sintaticamente corretas e válidas. Cada instrução deve ser separada por ponto e vírgula.

Caminho relativo do arquivo (relativeFilePath)¶

path

Caminho relativo que diferencia maiúsculas de minúsculas para o arquivo no estágio. Caminhos relativos oferecem suporte a convenções estabelecidas, como um / inicial para indicar a raiz do sistema de arquivos de um estágio, ./ para se referir ao diretório atual (o diretório no qual o arquivo pai está localizado) e ../ para se referir ao diretório pai. Para obter mais informações, consulte Notas de uso.

filename

Nome do arquivo a ser executado. Deve conter instruções SQL sintaticamente corretas e válidas. Cada instrução deve ser separada por ponto e vírgula.

Erros de arquivo¶

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>'.

Erros de estágio¶

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

Erros de controle de acesso¶

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>'

Consulte também: Erros de estágio.

Erros de modelagem¶

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.

Exemplo básico¶

Este exemplo executa o arquivo create-inventory.sql localizado no estágio my_stage.

1. Crie um arquivo denominado create-inventory.sql com as seguintes instruções:

   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. Crie um arquivo denominado insert-inventory.sql com as seguintes instruções:

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

   Copy

3. Crie um estágio interno my_stage:

   CREATE STAGE my_stage;
   

   Copy

4. Carregue dois arquivos locais para o estágio usando o comando 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. Execute o script create-inventory.sql localizado em my_stage:

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

   Copy

   Retorna:

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

Um exemplo de modelo simples¶

1. Crie um arquivo de modelo setup.sql com duas variáveis e a diretriz de modelagem:

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

   Copy

2. Crie um estágio — opcional se você já tiver um estágio para o qual possa enviar arquivos.

   Por exemplo, crie um estágio interno no Snowflake:

   CREATE STAGE my_stage;
   

   Copy

3. Carregue o arquivo em seu estágio.

   Por exemplo, use o comando PUT do seu ambiente local para fazer upload do arquivo setup.sql para o estágio my_stage:

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

   Copy

4. Execute o arquivo setup.sql:

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

   Copy

Exemplo de modelo com macros, condicionais, loops e importações¶

1. Crie um arquivo de modelo que contenha uma definição de macro.

   Por exemplo, crie um arquivo macros.jinja no seu ambiente local:

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

   Copy

2. Crie um arquivo de modelo e adicione a diretiva de modelo (--!jinja2) na parte superior do arquivo.

   Após a diretiva de modelo, adicione uma instrução import para importar a macro definida no arquivo que você criou na etapa anterior. Por exemplo, crie um arquivo setup-env.sql no seu ambiente local:

   --!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. Crie um estágio — opcional se você já tiver um estágio para o qual possa enviar arquivos.

   Por exemplo, crie um estágio interno no Snowflake:

   CREATE STAGE my_stage;
   

   Copy

4. Carregue o arquivo em seu estágio.

   Por exemplo, use o comando PUT em seu ambiente local para fazer o upload dos arquivos setup-env.sql e macros.jinja para o estágio 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. Visualize as instruções SQL renderizadas pelo modelo para verificar se há algum problema com seu código Jinja2:

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

   Copy

   Retorna:

   +----------------------------------+
   | 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. Execute o arquivo setup-env.sql:

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

   Copy