EXECUTE IMMEDIATE FROM¶

구문¶

EXECUTE IMMEDIATE
  FROM { absoluteFilePath | relativeFilePath }

여기서

absoluteFilePath ::=
   @[ <namespace>. ]<stage_name>/<path>/<filename>

Copy

relativeFilePath ::=
  '[ { ./ | / | { ../ [ , ../, ... ] } } ]<path>/<filename>'

Copy

반환¶

EXECUTE IMMEDIATE FROM은 다음을 반환합니다.

• 모든 문이 성공적으로 실행된 경우 파일에 있는 마지막 문의 결과입니다.

• 파일의 문이 실패한 경우에 나타나는 오류 메시지입니다.

  파일의 문에 오류가 있으면 EXECUTE IMMEDIATE FROM 명령이 실패하고 실패한 문의 오류 메시지를 반환합니다.

  참고

  EXECUTE IMMEDIATE FROM 명령이 실패하고 오류 메시지를 반환하는 경우 파일에서 실패한 문 이전의 문은 모두 성공적으로 완료된 것입니다.

액세스 제어 요구 사항¶

• EXECUTE IMMEDIATE FROM 명령을 실행하는 데 사용되는 역할 에는 파일이 있는 스테이지에 대한 USAGE(외부 스테이지) 또는 READ(내부 스테이지) 권한이 있어야 합니다.

• 파일을 실행하는 데 사용되는 역할은 권한이 있는 파일에 있는 문만 실행할 수 있습니다. 예를 들어 파일에 CREATE TABLE 문이 있는 경우 역할에는 계정에서 테이블을 생성하는 데 필요한 권한 이 있어야 하며, 그렇지 않으면 문이 실패합니다.

스키마의 모든 오브젝트에 대해 작업하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한도 필요합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트¶

• 실행할 파일의 SQL 문에는 EXECUTE IMMEDIATE FROM 문이 포함될 수 있습니다.

  • 중첩된 EXECUTE IMMEDIATE FROM 문은 상대 파일 경로 를 사용할 수 있습니다.

    상대 경로는 상위 파일의 스테이지와 파일 경로를 기준으로 평가됩니다. 상대 파일 경로가 / 로 시작하는 경우 경로는 상위 파일이 포함된 스테이지의 루트 디렉터리에서 시작됩니다.

    예를 보려면 예 를 참조하십시오.

  • 상대 파일 경로는 작은따옴표(') 또는 $$ 로 묶어야 합니다.

  • 중첩된 파일의 최대 실행 깊이는 5입니다.

• 절대 파일 경로를 작은따옴표(') 또는 $$ 로 묶는 것은 선택 사항입니다.

• 실행할 파일의 크기가 10MB보다 크면 안 됩니다.

• 실행할 파일은 UTF-8 로 인코딩해야 합니다.

• 실행할 파일은 압축을 풀어야 합니다. PUT 명령을 사용하여 파일을 내부 스테이지에 업로드하는 경우 AUTO_COMPRESS 매개 변수 를 FALSE로 명시적으로 설정해야 합니다.

  예를 들어 my_file.sql 을 my_stage 에 업로드하십시오.

  PUT file://~/sql/scripts/my_file.sql @my_stage/scripts/
    AUTO_COMPRESS=FALSE;
  

  Copy

• 디렉터리의 모든 파일 실행은 지원되지 않습니다. 예를 들어, EXECUTE IMMEDIATE FROM @stage_name/scripts/ 는 오류를 발생시킵니다.

EXECUTE IMMEDIATE FROM 오류 문제 해결하기¶

이 섹션에는 EXECUTE IMMEDIATE FROM 문으로 인해 발생하는 몇 가지 일반적인 오류와 이를 해결하는 방법이 수록되어 있습니다.

• 파일 오류

• 스테이지 오류

• 액세스 제어 오류

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

예¶

이 예에서는 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 |
   +----------+-------+