EXECUTE SERVICE

중요

Snowpark Container Services 작업 기능은 현재 비공개 미리 보기로 제공되며 https://snowflake.com/legal 의 미리 보기 조건이 적용됩니다. 자세한 내용은 Snowflake 담당자에게 문의하십시오.

Snowpark Container Services 작업 을 시작합니다. 작업은 동기식으로 실행되며, 모든 컨테이너가 종료된 후에 완료됩니다.

참고 항목:

SYSTEM$GET_JOB_STATUS , SYSTEM$GET_JOB_LOGS

구문

EXECUTE SERVICE
  IN COMPUTE POOL <compute_pool_name>
  {
    FROM @<stage>
    SPECIFICATION_FILE = '<yaml_file_stage_path>'
    |
    FROM SPECIFICATION <specification_text>
  }
  [ EXTERNAL_ACCESS_INTEGRATIONS = ( <EAI_name> [ , ... ] ) ]
Copy

필수 매개 변수

IN COMPUTE POOL compute_pool_name

서비스를 실행할 계정의 컴퓨팅 풀 이름을 지정합니다.

FROM stage

사양 파일이 저장되는 Snowflake 내부 스테이지(예: @tutorial_stage)를 지정합니다.

SPECIFICATION_FILE = 'yaml_file_stage_path'

스테이지의 서비스 사양 파일 경로(예: 'some-dir/echo_spec.yaml')를 지정합니다.

FROM SPECIFICATION specification_text

서비스 사양 을 지정합니다. 달러 기호 쌍 ($$)을 사용하여 사양 문자열의 시작과 끝을 구분할 수 있습니다.

선택적 매개 변수

EXTERNAL_ACCESS_INTEGRATIONS = ( EAI_name [ , ... ] )

작업이 외부 사이트에 액세스할 수 있도록 허용하는 외부 액세스 통합 의 이름을 지정합니다. 이 목록의 이름은 대/소문자를 구분합니다. 기본적으로 애플리케이션 컨테이너에는 인터넷에 액세스할 권한이 없습니다. 작업이 외부 사이트에 액세스하도록 허용하려면 External Access Integration(EAI)을 만들고 해당 통합을 사용하도록 작업을 구성하십시오. 자세한 내용은 네트워크 송신 섹션을 참조하십시오.

액세스 제어 요구 사항

이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한

오브젝트

참고

USAGE

컴퓨팅 풀

READ

스테이지

사양이 저장되는 스테이지입니다.

READ

이미지 리포지토리

사양에서 참조하는 이미지 리포지토리입니다.

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

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

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

사용법 노트

  • EXECUTE SERVICE 명령이 반환하는 쿼리 ID는 Snowpark Container Services 작업의 고유 식별자입니다.

    작업이 진행되는 동안 이 ID를 사용하여 작업 상태(SYSTEM$GET_JOB_STATUS) 또는 작업 컨테이너(SYSTEM$GET_JOB_LOGS)에서 로그를 검색할 수 있습니다.

    EXECUTE SERVICE 명령을 실행한 직후 LAST_QUERY_ID 함수를 호출하여 나중에 참조할 수 있도록 쿼리 작업의 ID를 캡처할 수 있습니다. 또한 Snowsight 웹 인터페이스를 사용하여 작업의 쿼리 ID를 찾을 수도 있습니다.

  • 메타데이터 관련:

    주의

    고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.

Snowpark Container Services 작업을 만듭니다.

EXECUTE SERVICE
  IN COMPUTE POOL tutorial_compute_pool
  FROM @tutorial_stage
  SPECIFICATION_FILE='my_job_spec.yaml';
Copy