작업 소개¶

제한 사항¶

• 서버리스 작업의 최대 컴퓨팅 크기는 X2LARGE 가상 웨어하우스 와 동일합니다.

서버리스 컴퓨팅 모델을 사용하여 작업 만들기¶

CREATE TASK 또는 ALTER TASK 를 사용하는 경우 WAREHOUSE 매개 변수를 생략하십시오.

작업을 실행하는 역할에는 글로벌 EXECUTE MANAGED TASK 권한이 있어야 합니다. 작업의 액세스 제어 요구 사항에 대한 자세한 내용은 작업 보안 섹션을 참조하십시오.

다음 매개 변수를 설정하여 서버리스 작업의 비용과 성능을 어느 정도 제어할 수 있습니다.

• SERVERLESS_TASK_MAX_STATEMENT_SIZE: 예상치 못한 비용을 방지하기 위한 웨어하우스의 최대 크기입니다.

• SERVERLESS_TASK_MIN_STATEMENT_SIZE: 예측 가능한 성능을 위한 웨어하우스의 최소 크기입니다.

• TARGET_COMPLETION_INTERVAL: 원하는 작업 완료 시간입니다.

이러한 설정이 지정되면 우선순위는 다음과 같습니다.

• SERVERLESS_TASK_MAX_STATEMENT_SIZE

• SERVERLESS_TASK_MIN_STATEMENT_SIZE

• TARGET_COMPLETION_INTERVAL

Snowflake가 서버리스 컴퓨팅 리소스를 추정하는 방법¶

Snowflake는 대상 시간 프레임과 이전 작업 실행의 성능을 기반으로 작업을 완료하는 데 필요한 컴퓨팅 리소스를 자동으로 추정합니다.

대상 시간 프레임은 TARGET_COMPLETION_INTERVAL 을 사용하여 설정할 수 있습니다. 이 값을 설정하지 않으면 Snowflake는 다음 예약된 실행 시간 전에 완료되도록 서버리스 컴퓨팅 리소스의 크기를 조정합니다.

작업이 완료된 후 Snowflake는 다음과 같이 필요한 컴퓨팅 리소스를 추정합니다.

• 작업이 너무 빨리 완료되는 경우(대상 시간 프레임보다 적은 시간 프레임 내), Snowflake는 후속 실행에서 리소스를 웨어하우스 크기만큼 축소 합니다.

• 작업이 너무 느리게 완료되는 경우(대상 시간 프레임보다 많은 시간 프레임 내), Snowflake는 후속 실행에서 리소스를 하나씩 웨어하우스 크기 를 축소합니다.

예¶

예 1: 대상 완료 간격을 120분으로 하여 매시간 실행되는 서버리스 작업을 만듭니다.

CREATE TASK SCHEDULED_T1 SCHEDULE='USING CRON 0 * * * * America/Los_Angeles'
TARGET_COMPLETION_INTERVAL='120 MINUTE' AS SELECT 1;

TARGET_COMPLETION_INTERVAL 을 상대적으로 긴 기간으로 설정하면 작업 실행이 더 오래 실행되는 것이 허용됨을 나타냅니다. Snowflake는 지정된 TARGET_COMPLETION_INTERVAL 내에서 작업 실행이 완료되도록 서버리스 컴퓨팅의 크기를 자동으로 조정합니다.

예 2: 대상 완료 시간을 10분으로 설정하여 매시간 실행되는 서버리스 작업을 만듭니다.

CREATE TASK SCHEDULED_T2 SCHEDULE='USING CRON 0 * * * * UTC'
TARGET_COMPLETION_INTERVAL='10 MINUTE'
SERVERLESS_TASK_MAX_STATEMENT_SIZE='LARGE'
AS SELECT 1;

TARGET_COMPLETION_INTERVAL 을 비교적 짧은 기간으로 설정하면 작업을 빠르게 완료하는 것을 선호한다는 뜻입니다. Snowflake는 SERVERLESS_TASK_MAX_STATEMENT_SIZE 에 도달할 때까지 지정된 TARGET_COMPLETION_INTERVAL 내에서 작업 실행이 완료되도록 서버리스 컴퓨팅의 크기를 자동으로 조정합니다.

예 3: 대상 완료 간격과 최소 및 최대 웨어하우스 크기 범위 내에서 특정 시점에 하루에 한 번 예약된 서버리스 작업을 생성합니다.

CREATE TASK SCHEDULED_T3 SCHEDULE='USING CRON 0 0 * * * UTC'
TARGET_COMPLETION_INTERVAL='180 M'
SCHEDULING_MODE = 'FLEXIBLE'
SERVERLESS_TASK_MIN_STATEMENT_SIZE='MEDIUM' SERVERLESS_TASK_MAX_STATEMENT_SIZE='LARGE' AS SELECT 1;

이 구성을 사용하면 서버리스 작업은 하루에 한 번 자정에 최소 3시간(TARGET_COMPLETION_INTERVAL)의 Medium 웨어하우스에서 실행됩니다. Snowflake는 SERVERLESS_TASK_MAX_STATEMENT_SIZE 에 도달할 때까지 지정된 TARGET_COMPLETION_INTERVAL 내에서 작업 실행이 완료되도록 서버리스 컴퓨팅의 크기를 자동으로 조정합니다. SCHEDULING_MODE 를 유연하게 설정하면 하루 중 언제든지 작업을 시작할 수 있습니다.

예 4: 대상 완료 간격 없이 하루에 한 번 예약된 서버리스 작업을 만듭니다.

CREATE TASK SCHEDULED_T4 SCHEDULE='USING CRON 0 0 * * * UTC'
SERVERLESS_TASK_MAX_STATEMENT_SIZE='LARGE' AS SELECT 1;

이 구성을 사용하면 서버리스 작업이 하루에 한 번 자정에 실행됩니다. 일련의 작업 실행 시간이 다음 예약된 시간까지 완료되지 않으면, Snowflake는 SERVERLESS_TASK_MAX_STATEMENT_SIZE 에 도달할 때까지 지정된 SCHEDULE 내에서 작업 실행이 완료되도록 서버리스 컴퓨팅의 크기를 자동으로 조정합니다.

매개 변수 및 구문에 대한 자세한 내용은 CREATE TASK 및 ALTER TASK 섹션을 참조하십시오.

웨어하우스 크기 선택하기¶

기존 웨어하우스를 사용하여 개별 작업에 컴퓨팅 리소스를 제공하기로 선택한 경우 웨어하우스 고려 사항 에 설명된 모범 사례를 따르십시오. 작업의 컴퓨팅 요구 사항을 파악하려면 웨어하우스 크기와 클러스터링을 기반으로 다양한 웨어하우스를 사용하여 단일 작업의 평균 실행 시간 또는 작업 그래프 를 분석합니다. 또한 웨어하우스가 여러 프로세스에 의해 공유되는지 여부도 고려해야 합니다.

작업의 평균 실행 시간을 분석하려면 TASK_HISTORY Account Usage 뷰 를 쿼리합니다. 작업의 예정 시간과 완료 시간 간의 평균 차이는 작업의 예상 평균 실행 시간입니다. 이 차이에는 다른 프로세스가 웨어하우스에서 컴퓨팅 리소스를 사용하는 동안 작업이 큐에서 대기된 시간이 포함됩니다.

작업 그래프의 경우, 이전 작업의 실행이 끝나고 하위 작업이 시작되면 잠시 지연이 발생합니다. 동시에 실행되는 여러 하위 작업을 수용할 수 있을 만큼 충분히 큰 웨어하우스 크기를 선택합니다.

다음 다이어그램은 단일 작업이 20초 동안 대기한 다음 40초 동안 실행된 1분의 윈도우를 보여줍니다. 이는 작업이 예약된 후 처음 20초 동안 다른 프로세스가 웨어하우스 리소스를 사용했음을 의미합니다.

다음 다이어그램은 각 실행을 완료하는 데 평균 5분이 필요한 작업 그래프를 보여줍니다. 다이어그램은 완료할 작업 그래프의 2회 실행에 대한 창을 보여줍니다. 이 윈도우는 루트 작업이 시작되도록 예약된 시간부터 마지막 하위 작업의 실행이 완료될 때까지 계산됩니다.

이 예제에서, 작업 그래프가 실행되는 웨어하우스는 다른 동시 작업과 공유됩니다. 이러한 동시 작업은 작업 그래프의 각 작업 실행이 완료되고 다음 작업 실행이 시작되기 전에 사용 가능한 모든 리소스를 소비합니다. 결과적으로, 각 작업의 윈도우에는 다른 작업이 완료되고 컴퓨팅 리소스를 확보할 때까지 기다리는 동안 약간의 큐가 포함됩니다.

작업 예약 및 일광 절약 시간제¶

작업 정의의 cron 식은 타임존 지정을 지원합니다. 표준 시간에서 일광 절약 시간제(또는 그 반대로)로 전환되는 날의 특정 시간에 예약된 작업에서는 예기치 않은 동작이 수행될 수 있습니다.

예:

• 서머타임에서 표준시로 변경하는 동안 미국/로스앤젤레스 타임존(0 1 * * * America/Los_Angeles)에서 AM 1시에 시작하도록 예약된 작업은 두 번 실행됩니다. 1 AM 이후에 현지 시간으로 1:59:59 AM이 1:00:00 AM으로 바뀌면 다시 1 AM이 됩니다.

• 표준 시간에서 일광 절약 시간제로 변경 기간 동안에는 현지 시간이 AM 1:59:59에서 AM 3:00:00로 변경되므로 미국/로스_앤젤레스 타임존(0 2 * * * America/Los_Angeles) AM 2시에 시작하도록 예약된 작업은 실행되지 않습니다.

일광 절약 시간제로 인한 예기치 않은 작업이 실행되지 않도록 하려면 다음을 고려하십시오.

• 1 AM에서 3 AM 사이에서 실행되도록 작업을 예약하지 마십시오.

• 시간 변경을 보정하기 위해 매년 두 번씩 1 AM에서 3 AM 사이에 예약된 작업의 cron 식을 수동으로 조정하십시오.

• UTC와 같이 일광 절약 시간제를 적용하지 않는 시간 형식을 사용하십시오.

트리거된 작업 만들기¶

CREATE TASK 를 사용하고 WHEN 절을 사용하여 대상 스트림을 정의합니다. (SCHEDULE 매개 변수는 포함하지 마십시오.)

다음 중 하나를 선택하여 작업에 컴퓨팅 리소스를 할당합니다.

• 리소스(사용자 관리 웨어하우스 작업)를 수동으로 관리하려면 WAREHOUSE 매개 변수를 추가합니다.

• Snowflake가 리소스(서버리스 작업)를 관리하도록 허용하려면 TARGET_COMPLETION_INTERVAL 매개 변수를 추가하십시오. Snowflake는 필요한 리소스를 추정하고 이 시간 내에 작업을 완료하도록 조정합니다.

예약된 작업에서 트리거된 작업으로 기존 작업 마이그레이션하기¶

작업을 일시 중단하고 SCHEDULE 매개 변수를 설정 해제하고 작업을 다시 시작합니다. 기존 작업에는 WHEN 절에 정의된 대상 스트림이 있어야 합니다.

ALTER TASK task SUSPEND;
ALTER TASK task UNSET SCHEDULE;
ALTER TASK task RESUME;

기존 사용자 관리 트리거 작업을 서버리스 트리거 작업으로 마이그레이션하기¶

작업을 일시 중단합니다. WAREHOUSE 매개 변수를 제거하고 TARGET_COMPLETION_INTERVAL 매개 변수를 추가합니다. 작업을 다시 시작합니다.

트리거된 작업 고려 사항¶

• SHOW TASKS 및 DESC TASK 출력에서 SCHEDULE 속성은 트리거된 작업에 대해 NULL 을 표시합니다.

• information_schema 및 account_usage 스키마에서 task_history 뷰의 출력에서 SCHEDULED_FROM 열에 TRIGGER가 표시됩니다.

• 여러 데이터 스트림으로 작업하는 경우 WHEN … AND 및 WHEN … OR 조건부 매개 변수를 사용하여 작업 시작 시기를 관리할 수 있습니다.

트리거된 작업 제한 사항¶

• 기본적으로 트리거 작업은 최대 30초마다 실행됩니다. USER_TASK_MINIMUM_TRIGGER_INTERVAL_IN_SECONDS 매개 변수를 수정하여 최대 10초마다 실행되도록 더 자주 실행할 수 있습니다.

• 디렉터리 테이블, 외부 테이블 및 하이브리드 테이블의 스트림은 지원되지 않습니다.

트리거된 작업 예제¶

예 1: 두 스트림 중 하나에서 데이터가 변경될 때마다 실행되는 사용자 관리 작업을 만듭니다.

CREATE TASK my_task
  WHEN SYSTEM$STREAM_HAS_DATA('my_return_stream')
  OR   SYSTEM$STREAM_HAS_DATA('my_order_stream')
  WAREHOUSE = my_warehouse
  AS
    INSERT INTO customer_activity
    SELECT customer_id, return_total, return_date, ‘return’
    FROM my_return_stream
    UNION ALL
    SELECT customer_id, order_total, order_date, ‘order’
    FROM my_order_stream;

예 2: 서로 다른 두 데이터 스트림에서 데이터 변경이 감지될 때마다 실행할 작업을 만듭니다. 이 작업은 AND 조건문을 사용하므로 두 스트림 중 하나에만 새 데이터가 있는 경우 작업을 건너뜁니다.

TARGET_COMPLETION_INTERVAL 은 120분이므로 Snowflake는 이 시간 내에 작업을 완료하는 데 필요한 컴퓨팅 리소스를 추정하고 조정합니다.

CREATE TASK triggeredTask
  WHEN SYSTEM$STREAM_HAS_DATA('orders_stream')
  TARGET_COMPLETION_INTERVAL='120 MINUTES'
  AS
    INSERT INTO completed_promotions
    SELECT order_id, order_total, order_time, promotion_id
    FROM orders_stream
    WHERE promotion_id IS NOT NULL;

작업 만들기¶

작업을 만들려면 최소한으로 다음의 권한이 있는 역할이 필요합니다.

작업 실행하기¶

작업이 생성된 후 작업을 실행하려면 작업 소유자에게 다음 권한이 있어야 합니다.

또한 역할은 작업에서 실행되는 SQL 문을 실행하기 위해 필요한 권한이 있어야 합니다.

작업 기록 뷰¶

작업을 보려면 다음 권한 중 하나 이상이 있어야 합니다.

• ACCOUNTADMIN 역할

• 작업에 대한 OWNERSHIP 권한

• 전역 MONITOR EXECUTION 권한

작업 다시 시작 또는 일시 중단하기¶

작업 소유자 외에도 작업에 대한 OPERATE 권한이 있는 역할은 작업을 일시 중단하거나 재개할 수 있습니다. 이 역할은 작업을 포함하는 데이터베이스 및 스키마에 대한 USAGE 권한이 있어야 합니다. 다른 권한은 필요하지 않습니다.

작업이 재개되면 Snowflake는 작업 소유자 역할이 작업 실행하기 에 나열된 권한이 있는지 확인합니다.

작업을 생성하기 위한 사용자 지정 역할 만들기¶

Snowflake에서는 서버리스 작업과 사용자 관리 작업을 만들려면 서로 다른 권한이 필요합니다.

예를 들어, 사용자 지정 작업을 생성하려면 warehouse_task_creation 사용자 지정 역할을 만들고 해당 역할에 해당 역할이 작업을 생성할 수 있는 웨어하우스에 대한 CREATE TASK 및 USAGE 권한을 부여합니다.

USE SYSADMIN;

CREATE ROLE warehouse_task_creation
  COMMENT = 'This role can create user-managed tasks.';

from snowflake.core.role import Role

root.session.use_role("SYSADMIN")

my_role = Role(
    name="warehouse_task_creation",
    comment="This role can create user-managed tasks."
)
root.roles.create(my_role)

USE ACCOUNTADMIN;

GRANT CREATE TASK
  ON SCHEMA schema1
  TO ROLE warehouse_task_creation;

from snowflake.core.role import Securable

root.session.use_role("ACCOUNTADMIN")

root.roles['warehouse_task_creation'].grant_privileges(
    privileges=["CREATE TASK"], securable_type="schema", securable=Securable(name='schema1')
)

GRANT USAGE
  ON WAREHOUSE warehouse1
  TO ROLE warehouse_task_creation;

from snowflake.core.role import Securable

root.roles['warehouse_task_creation'].grant_privileges(
    privileges=["USAGE"], securable_type="warehouse", securable=Securable(name='warehouse1')
)

서버리스 작업을 만들 수 있는 역할의 예제로, 이름이 serverless_task_creation 인 사용자 지정 역할을 만들고 이 역할에 CREATE TASK 권한과 계정 수준 EXECUTE MANAGED TASK 권한을 부여합니다.

USE SYSADMIN;

CREATE ROLE serverless_task_creation
  COMMENT = 'This role can create serverless tasks.';

from snowflake.core.role import Role

root.session.use_role("SYSADMIN")

my_role = Role(
    name="serverless_task_creation",
    comment="This role can create serverless tasks."
)
root.roles.create(my_role)

USE ACCOUNTADMIN;

GRANT CREATE TASK
  ON SCHEMA schema1
  TO ROLE serverless_task_creation;

from snowflake.core.role import Securable

root.session.use_role("ACCOUNTADMIN")

root.roles['serverless_task_creation'].grant_privileges(
    privileges=["CREATE TASK"], securable_type="schema", securable=Securable(name='schema1')
)

GRANT EXECUTE MANAGED TASK ON ACCOUNT
  TO ROLE serverless_task_creation;

root.roles['serverless_task_creation'].grant_privileges(
    privileges=["EXECUTE MANAGED TASK"], securable_type="account"
)

작업을 관리하기 위한 사용자 지정 역할 만들기¶

사용자 지정 역할을 만들고 EXECUTE TASK 권한으로 이 사용자 지정 역할을 모든 작업 소유자 역할에 부여하여 자신의 작업을 변경할 수 있도록 합니다. 작업 소유자 역할이 작업을 실행할 수 있는 기능을 제거하려면 작업 소유자 역할에서 이 사용자 지정 역할을 취소합니다.

예를 들어, 사용자 지정 역할 이름 taskadmin 을 만들고 해당 역할에 EXECUTE TASK 권한을 부여합니다. taskadmin 역할을 myrole 이라는 작업 소유자 역할에 할당합니다.

USE ROLE securityadmin;

CREATE ROLE taskadmin;

from snowflake.core.role import Role

root.session.use_role("securityadmin")

root.roles.create(Role(name="taskadmin"))

새 역할에 계정 수준 권한을 부여하기 전에 활성 역할을 ACCOUNTADMIN으로 설정

USE ROLE accountadmin;

GRANT EXECUTE TASK, EXECUTE MANAGED TASK ON ACCOUNT TO ROLE taskadmin;

root.session.use_role("accountadmin")

root.roles['taskadmin'].grant_privileges(
    privileges=["EXECUTE TASK", "EXECUTE MANAGED TASK"], securable_type="account"
)

활성 역할을 SECURITYADMIN으로 설정하여 이 역할이 다른 역할에 역할을 부여할 수 있음을 표시

USE ROLE securityadmin;

GRANT ROLE taskadmin TO ROLE myrole;

from snowflake.core.role import Securable

root.session.use_role("securityadmin")

root.roles['myrole'].grant_role(role_type="ROLE", role=Securable(name='taskadmin'))

사용자 지정 역할 및 역할 계층 구조 생성과 관련한 자세한 내용은 액세스 제어 구성하기 를 참조하십시오.