작업 소개¶

제한 사항¶

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

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

:doc:`/sql-reference/sql/create-task`를 사용하여 작업을 정의합니다. WAREHOUSE 매개 변수는 포함하지 마세요.

작업을 실행하는 역할에는 전역 EXECUTE MANAGED TASK 권한이 있어야 합니다. 자세한 내용은 작업 보안 섹션을 참조하세요.

다음 예제에서는 매시간 실행되는 작업을 생성합니다.

CREATE TASK SCHEDULED_T1
  SCHEDULE='60 MINUTES'
  AS SELECT 1;

from datetime import timedelta
from snowflake.core.task import Cron, Task

tasks = root.databases["TEST_DB"].schemas["TEST_SCHEMA"].tasks

task = tasks.create(
    Task(
        name="SCHEDULED_T1",
        definition="SELECT 1",
        schedule=timedelta(minutes=60),
        ),
    )

비용 및 성능: 웨어하우스 크기¶

서버리스 작업을 효율적으로 실행하기 위해 다음 매개 변수를 설정하여 최소 및 최대 :ref:`웨어하우스 크기<label-warehouse_size>`를 설정할 수 있습니다.

• SERVERLESS_TASK_MIN_STATEMENT_SIZE: 예측 가능한 성능을 위한 최소 웨어하우스 크기(기본값: XSMALL).

• SERVERLESS_TASK_MAX_STATEMENT_SIZE: 예기치 않은 비용을 방지하기 위한 최대 웨어하우스 크기(기본값: XXLARGE).

작업이 완료되면 Snowflake는 성능을 검토하고 이러한 제한 내에서 향후 실행을 위해 컴퓨팅 리소스를 조정합니다.

다음 예제에서는 최소 웨어하우스 크기가 SMALL이고 최대 웨어하우스 크기가 LARGE인 상태에서 30초마다 실행되는 작업을 보여줍니다.

CREATE TASK SCHEDULED_T2
  SCHEDULE='30 SECONDS'
  SERVERLESS_TASK_MIN_STATEMENT_SIZE='SMALL'
  SERVERLESS_TASK_MAX_STATEMENT_SIZE='LARGE'
  AS SELECT 1;

from datetime import timedelta
from snowflake.core.task import Cron, Task

tasks = root.databases["TEST_DB"].schemas["TEST_SCHEMA"].tasks

task = tasks.create(
    Task(
        name="SCHEDULED_T2",
        definition="SELECT 1",
        schedule=timedelta(seconds=30),
        serverless_task_min_statement_size="SMALL",
        serverless_task_max_statement_size="LARGE",
        ),
    )

목표 완료 간격¶

완료할 서버리스 작업의 이전 대상을 설정할 수 있습니다. :ref:`서버리스 트리거 작업<label-tasks-triggered-migrate-serverless>`에는 목표 완료 간격이 필요합니다.

목표 완료 간격을 설정하는 경우 Snowflake는 목표 완료 간격 내에서 완료할 리소스를 예측하고 확장합니다. 작업이 이미 최대 웨어하우스 크기에 있고 너무 오래 실행 중인 경우 목표 완료 간격이 무시됩니다.

다음 예제에서 작업은 매일 자정에 실행되며, 완료 목표는 오전 2시입니다. 시작 시간과 타임존은 :ref:`USING CRON<label-create_task_schedule>`으로 정의됩니다. 작업이 최대 웨어하우스 크기에 도달하면 마지막으로 시간 제한이 트리거되기 전까지 최대 3시간 동안 실행될 수 있습니다.

CREATE TASK SCHEDULED_T3
  SCHEDULE='USING CRON 0 * * * * America/Los_Angeles'
  TARGET_COMPLETION_INTERVAL='120 MINUTE'
  SERVERLESS_TASK_MAX_STATEMENT_SIZE='LARGE'
  USER_TASK_TIMEOUT_MS = 10800000         -- (3 hours)
  SUSPEND_TASK_AFTER_NUM_FAILURES = 3
  AS SELECT 1;

from datetime import timedelta
from snowflake.core.task import Cron, Task

tasks = root.databases["TEST_DB"].schemas["TEST_SCHEMA"].tasks

task = tasks.create(
    Task(
        name="SCHEDULED_T3",
        definition="SELECT 1",
        schedule=Cron("0 * * * *", "America/Los_Angeles"),
        target_completion_interval=timedelta(minutes=120),
        serverless_task_max_statement_size="LARGE",
        user_task_timeout_ms=10800000,  # (3 hours)
        suspend_task_after_num_failures=3,
    ),
)

웨어하우스 선택¶

웨어하우스를 선택할 때 다음 사항을 고려하세요.

• :doc:`/user-guide/warehouses-considerations`의 모범 사례를 검토합니다.

• 웨어하우스 크기 및 클러스터링을 기반으로 다양한 웨어하우스를 사용하여 평균 작업 실행 시간을 분석합니다. 자세한 내용은 작업 기간 섹션을 참조하십시오.

• 여러 프로세스에서 웨어하우스를 공유하는 경우 작업이 다른 워크로드에 미치는 영향을 고려하세요.

사용자 관리 컴퓨팅 모델을 사용하여 작업 만들기¶

:doc:`/sql-reference/sql/create-task`를 사용하고 WAREHOUSE 매개 변수를 포함합니다.

작업을 실행하는 역할에는 전역 EXECUTE MANAGED TASK 권한이 있어야 합니다. 자세한 내용은 작업 보안 섹션을 참조하세요.

다음 예제에서는 매시간 실행되는 작업을 생성합니다.

CREATE TASK SCHEDULED_T1
  WAREHOUSE='COMPUTE_WH'
  SCHEDULE='60 MINUTES'
  AS SELECT 1;

작업 만들기¶

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

작업 실행하기¶

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

또한 역할에는 작업에서 실행되는 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'))

사용자 지정 역할 및 역할 계층 구조를 만드는 방법에 대한 자세한 내용은 액세스 제어 구성하기 섹션을 참조하세요.

작업 소유자 역할 삭제¶

작업의 소유자 역할을 삭제하면 작업은 소유자 역할을 삭제한 역할에 소유권을 이전합니다. 작업이 소유권을 이전하면 자동으로 일시 중지되고 새 소유자가 작업을 재개할 때까지 새 작업 실행이 예약되지 않습니다.

작업이 실행되는 중에 역할을 삭제하면 작업 실행은 삭제된 역할에서 처리를 완료합니다.

액세스 제어¶

작업의 소유자 역할에는 EXECUTE AS USER로 지정한 사용자에 대한 IMPERSONATE 권한이 부여되어야 하며, 지정된 사용자에게 작업의 소유자 역할이 부여되어야 합니다.

작업이 실행되면 작업 세션의 기본 역할이 작업의 소유자 역할이 되고 사용자의 기본 보조 역할이 활성화됩니다. 사용자는 USE ROLE 명령을 사용하여 기본 역할을 전환하고 USE SECONDARY ROLES 명령으로 작업 세션에서 보조 역할을 조정합니다.

서비스 사용자 및 역할을 사용하여 작업 공유하기¶

프로덕션 환경의 경우 팀 또는 비즈니스 프로세스를 나타내는 별도의 서비스 사용자를 만드는 것이 좋습니다. 기존 서비스 또는 개인 사용자로 실행하는 경우와는 반대로, 이 모범 사례는 워크플로의 보안을 강화하는 데 도움이 됩니다.

• 작업이 전용 서비스 사용자로 실행되면 의도된 권한에만 액세스할 수 있습니다. 사용자가 다른 사용자를 가장하면 작업을 생성하고 재개한 후 부여된 사용자 권한을 포함하여 의도하지 않은 권한이 포함될 수 있는 다른 사용자와 연결된 모든 권한에 액세스할 수 있습니다.

• 사용자가 부서나 조직을 떠나면 사용자로 실행 중인 작업이 중단될 수 있습니다.

예제: 서비스 사용자 및 팀 역할 설정하기¶

1. 관리자 역할을 사용하여 작업에 사용할 서비스 사용자를 설정합니다.

   다음 예제에서는 이름이 :samp:`task_user`인 서비스 사용자를 생성합니다.

   USE ROLE ACCOUNTADMIN;
   CREATE USER task_user;
   

   Copy

2. 작업 역할을 만든 다음 서비스 사용자에게 부여합니다.

   CREATE ROLE task_role;
   GRANT ROLE task_role to USER task_user;
   

   Copy

3. 작업 역할이 팀 사용자 역할을 대신하여 쿼리를 실행하도록 허용합니다.

   GRANT IMPERSONATE ON USER task_user TO ROLE task_role;
   

   Copy

4. 작업 역할에 적절한 권한을 부여합니다.

   USE ROLE ACCOUNTADMIN;
   
   -- Grant the team role the privileges to create tasks in a specific schema
   GRANT CREATE TASK
     ON SCHEMA schema1
     TO ROLE task_role;
   
   -- Grant the team role the privileges to use a specific warehouse
   GRANT USAGE
     ON WAREHOUSE warehouse1
     TO ROLE task_role;
   
   -- Grant the team role the privileges to run tasks on a serverless compute model
   GRANT EXECUTE MANAGED TASK ON ACCOUNT TO ROLE task_role;
   

   Copy

서비스 사용자를 대신하여 작업 실행하기¶

팀 역할이 작업의 소유권을 갖게 되면 팀 구성원이 작업을 수정하고 서비스 사용자를 대신하여 실행할 수 있습니다.

예:

USE ROLE task_owner;

CREATE TASK team_task
  SCHEDULE='12 HOURS'
  EXECUTE AS USER task_user
  AS SELECT 1;

이전 예제에서, 결과 로그는 :samp:`task_user`가 작업을 수정했음을 보여줍니다.

(테스트 전용) 사용자가 다른 사용자를 직접 가장하도록 허용¶

변경 사항을 테스트하거나 프로토타입을 만들 때 관리자는 사용자가 다른 사용자를 직접 가장하도록 허용할 수 있습니다. 이 시나리오는 지원되지만 프로덕션 환경에서는 권장되지 않습니다.

1. 가장을 위한 역할을 설정합니다.

   USE ROLE ACCOUNTADMIN;
   CREATE ROLE janes_role;
   GRANT ROLE janes_role to USER jane;
   GRANT IMPERSONATE ON USER jane TO ROLE janes_role;
   

   Copy

2. 새 역할을 사용하여 작업을 만듭니다.

   USE ROLE janes_role;
   
   CREATE TASK janes_task
     SCHEDULE='60 M' AS SELECT 1;
   

   Copy

3. 다른 사용자에게 역할을 부여합니다.

   다음 예제에서는 사용자 Jane이 사용자 Billy에게 액세스 권한을 부여합니다.

   --Logged in as Jane or account admin
   GRANT ROLE janes_role to USER billy;
   

   Copy

4. 다른 사용자가 작업을 수정합니다.

   다음 예제에서는 사용자 Billy가 작업을 수정합니다.

   -- Logged in as billy
   USE ROLE janes_role;
   
   ALTER TASK janes_task
     SET EXECUTE AS USER jane;
   

   Copy

5. 로그를 검토합니다.

   SHOW GRANTS TO ROLE 명령은 Jane이 Billy에게 역할을 부여했음을 보여줍니다. 그러면 QUERY_HISTORY 뷰에 Billy가 작업을 수정했다고 표시됩니다. 향후 작업 실행은 여전히 Jane이 실행한 것으로 표시됩니다.

   USE ROLE ACCOUNTADMIN;
   
   SHOW GRANTS TO ROLE janes_role;
   
   QUERY_HISTORY()
     WHERE QUERY_TEXT ILIKE '%janes_task%';
   

   Copy