Snowsight 의 작업 기록 보기

작업을 사용해 SQL 코드의 실행을 예약할 수 있습니다. 작업의 방향성 비순환 그래프(DAG)를 생성하여 루트 작업과 종속 작업 세트에 지정된 SQL 코드를 실행하는 방법을 지정할 수 있습니다. 작업은 특정 데이터베이스 및 스키마와 연결됩니다. 작업에 대한 자세한 내용은 작업 소개 섹션을 참조하십시오.

Snowsight 를 사용하여 다음과 같이 여러 가지 다양한 방법으로 작업 실행 기록을 검토할 수 있습니다.

  • 계정에서 실행되는 모든 작업의 실행 기록을 확인하여 예컨대 실행에 실패한 중요한 작업, 장시간 실행 중인 작업 또는 비용을 증가시키는 작업을 식별할 수 있습니다.

  • 특정 작업의 실행 기록을 확인하여 작업에 대한 자세한 정보를 수집할 수 있습니다.

  • 가시성 및 모니터링 목적으로 작업 그래프의 실행 기록을 확인하여 특정 작업 그래프의 문제를 식별할 수 있습니다.

테이블 함수 TASK_HISTORY 또는 뷰 TASK_HISTORY 뷰 를 사용하여 SQL에서 작업 기록을 검토할 수도 있습니다.

이 항목의 내용:

작업 기록을 보는 데 필요한 권한

Snowsight 에서 작업 기록을 보려면 TASK_HISTORYCOMPLETE_TASK_GRAPHS 테이블 함수를 실행하는 데 필요한 동일한 권한이 필요합니다.

다음 역할 중 하나를 사용해야 합니다.

  • ACCOUNTADMIN 역할.

  • 작업에 대한 OWNERSHIP 권한이 있는 역할.

  • 작업을 저장하는 데이터베이스와 스키마에 대한 전역 MONITOR EXECUTION 권한과 USAGE 권한이 있는 역할.

사용하는 역할은 Account Usage TASK_HISTORY 뷰를 쿼리할 수 있어야 합니다. 공유된 SNOWFLAKE 데이터베이스의 USAGE_VIEWER 데이터베이스 역할을 이 역할에 부여할 수 있습니다.

예를 들어 특정 작업 mytask 의 기록을 보려면 사용자 지정 역할 myrole 에 다음이 필요합니다.

  • 작업에 대한 OWNERSHIP 권한.

  • 공유 SNOWFLAKE 데이터베이스의 USAGE_VIEWER 데이터베이스 역할.

그러한 권한을 부여하려면 다음 SQL 명령을 실행하십시오.

GRANT OWNERSHIP ON TASK mytask TO ROLE myrole;
GRANT DATABASE ROLE USAGE_VIEWER TO ROLE myrole;
Copy

자세한 내용은 다음을 참조하십시오.

개별 작업 보기 및 관리하기

Snowsight 에서 작업을 보고 관리하려면 다음을 수행하십시오.

  1. Snowsight 에 로그인합니다.

  2. Data » Databases 를 선택합니다.

  3. 특정 데이터베이스와 스키마의 경우 Tasks 를 선택하고 관리하려는 작업을 선택합니다.

Snowsight 에서 작업을 볼 때 다음을 수행할 수 있습니다.

  • Details 섹션에서 작업 ID, 작업에서 사용하는 웨어하우스, 일정, 상태, 모든 이전 작업을 검토합니다.

  • Task Definition 섹션에서 작업을 생성하는 데 사용된 SQL 문을 검토합니다.

  • 작업에 대한 권한을 관리합니다. Snowsight로 오브젝트 권한 관리하기 섹션을 참조하십시오.

  • 작업 이름 또는 설명을 편집하거나, 작업을 복제하거나, 작업을 삭제하거나, 작업 소유권을 다른 역할로 이전하려면 작업 버튼을 선택하십시오.

개별 작업 그래프 보기

작업 그래프를 검토하여 DAG 형식으로 루트 작업과 그 종속 작업을 확인합니다. 작업 그래프를 검토할 때 다음을 수행할 수 있습니다.

  • 루트 작업과 선택한 종속 작업별 상태를 포함한 작업 정보를 확인할 수 있습니다.

  • 그래프의 루트 및 종속 작업을 포함하여 작업 그래프를 검사할 수 있습니다. 작업의 DAG 섹션을 참조하십시오.

  • 그래프에서 작업을 선택하여 선행 작업, 작업 실행에 사용된 웨어하우스, 작업을 소유한 역할과 같은 추가 세부 정보를 볼 수 있습니다.

Example task graph shown in Snowsight, with annotations showing the navigation to view the task graph as described in the following task.

특정 데이터베이스 스키마에 대한 작업 그래프를 보려면 다음을 수행하십시오.

  1. Snowsight 에 로그인합니다.

  2. 탐색 메뉴에서 Data » Databases 를 선택합니다.

  3. 오브젝트 탐색기를 사용하여 보려는 작업이 포함된 데이터베이스와 스키마를 찾습니다.

  4. 선택한 스키마에 대해 Tasks 를 선택합니다.

  5. 특정 작업을 선택합니다.

    작업 세부 정보가 추가 GraphRun History 탭과 함께 나타납니다.

  6. 작업 그래프를 보려면 Graph 탭을 선택합니다.

    작업의 계층 구조를 표시하는 작업 그래프가 나타납니다.

  7. 그래프의 컨텍스트에서 세부 정보를 보려면 작업을 선택합니다.

참고

작업 기록 데이터는 작업이 지난 7일 사이에 실행된 경우에만 사용할 수 있습니다.

작업의 실행 기록 검토하기

작업 실행 기록은 주어진 작업의 각 실행에 대한 세부 정보를 포함합니다. 예약된 시간, 실제 시작 시간, 작업 지속 시간, 기타 정보를 볼 수 있습니다.

Snowsight task history page with annotations for each section.

각 인스턴스에 대해 다음을 볼 수 있습니다.

  • 예약된 시작 시간: 다음에 작업을 실행하기로 예약된 시간.

  • 상태: 가장 최근 실행의 상태.

  • 지속 시간: 가장 최근 실행의 시간(초).

  • 쿼리: 워크시트에서 작업 쿼리 프로필 또는 작업 문을 봅니다.

실행 기록을 보는 방법:

  1. Snowsight 에 로그인합니다.

  2. Data » Databases 를 선택합니다.

  3. 오른쪽 창에서 오브젝트 탐색기를 사용하여 데이터베이스와 스키마로 이동합니다.

  4. 선택한 스키마에 대해 Tasks 를 선택하고 확장합니다.

  5. 작업을 선택합니다. Task Details, Graph, Run History 하위 탭을 포함한 작업 정보가 표시됩니다.

  6. Run History 탭을 선택합니다.

참고

작업 기록 데이터는 작업이 지난 7일 사이에 실행된 경우에만 사용할 수 있습니다.

계정 수준 작업 기록 검토하기

작업 실행의 계정 수준 기록을 검토하여 하나의 특정한 작업이 아닌 전체 계정에 대해 실패한 작업, 장시간 실행 중인 작업, 기타 모니터링 및 디버깅 사례를 식별합니다.

작업의 계정 수준 기록을 보려면 다음을 수행하십시오.

  1. Snowsight 에 로그인합니다.

  2. 탐색 메뉴에서 Activity » Task History 를 선택합니다.

  3. 개별 작업 실행을 보려면 필터에서 View » Task Runs 를 선택하십시오.

작업 실행 기록을 선택한 후 페이지를 필터링하여 관련 정보를 표시할 수 있습니다.

  • 마지막 날부터 지난 12개월까지 또는 사용자 지정 범위의 작업 기록을 표시하려면 Date Range 필터를 선택하십시오.

  • Succeeded, Failed, Cancelled 또는 Skipped 와 같은 하나 이상의 상태에 대한 작업 기록을 표시하려면 Task status 필터를 선택하십시오.

  • 특정 작업에 대해 시간 경과에 따른 상태 또는 지속 기간의 패턴을 보려면 작업 이름을 기준으로 필터링하십시오.

  • 작업이 포함된 데이터베이스 또는 스키마의 이름을 기준으로 필터링하십시오.

예를 들어 장시간 실행 중인 작업을 식별하려면 Status 필터를 선택하여 성공한 작업만 표시하고 Duration 필드를 내림차순으로 정렬하십시오. 고급 디버깅을 위해 Open in worksheets 버튼을 사용하여 워크시트에서 필터링되고 정렬된 테이블을 열 수 있습니다. 그런 다음 LIMIT / FETCHGROUP BY 인자로 SQL 문을 수정하여 가장 오랫동안 실행 중인 상위 25개 작업으로 데이터베이스와 스키마를 식별할 수 있습니다.

드릴다운할 특정 작업을 선택하여 더 자세히 알아볼 수도 있습니다.

계정 수준 작업 그래프 기록 검토하기

작업 그래프의 계정 수준 기록을 검토하여 전체 계정에 대해 그래프가 완성되지 못하게 하는 중대한 실패가 발생한 작업, 장시간 실행 중인 작업, 비효율적이거나 자주 실패하는 작업 그래프, 기타 모니터링 및 디버깅 사례를 식별합니다.

작업 그래프의 계정 수준 기록을 보려면 다음을 수행하십시오.

참고

작업 기록을 보는 데 필요한 권한 이 있는 역할을 사용해야 합니다.

  1. Snowsight 에 로그인합니다.

  2. 탐색 메뉴에서 Activity » Task History 를 선택합니다.

    기본적으로, 이 페이지에는 마지막 날의 모든 작업 그래프 실행이 히스토그램과 테이블로 표시됩니다.

작업 그래프 실행 기록을 선택한 후 페이지를 필터링하여 관련 정보를 표시할 수 있습니다.

  • 최대 지난 12개월까지, 더 긴 시간 범위 동안 작업 기록을 표시하려면 Date Range 필터를 선택하십시오.

  • Succeeded, Failed, Cancelled 또는 Skipped 와 같은 하나 이상의 작업 그래프 상태에 대한 실행 기록을 표시하려면 Graph status 필터를 선택하십시오. 그래프에서 하나의 작업이 실패하면 전체 그래프가 Failed 로 표시됩니다.

  • 작업 그래프에 대한 루트 작업을 포함하는 데이터베이스 이름과 선택적으로 스키마를 기준으로 필터링합니다.

  • 데이터베이스와 선택적 스키마를 선택한 후, 특정 작업 그래프에 대해 시간 경과에 따른 상태 또는 지속 기간의 패턴을 보려면 루트 작업 이름을 기준으로 필터링하십시오. 활성 역할에 보기 권한이 없는 루트 작업이 표시될 수도 있습니다.

예를 들어 실패한 작업이 있는 작업 그래프를 식별하려면 Graph status 필터를 선택하여 실패한 작업만 표시하십시오. 실패한 작업을 마우스로 가리키면 실패에 대한 자세한 내용을 볼 수 있습니다. 고급 디버깅을 수행하려면 Open in worksheets 버튼을 사용하여 워크시트에서 필터링되고 정렬된 테이블을 여십시오. 그런 다음 LIMIT / FETCHGROUP BY 인자로 SQL 문을 수정하여, 예컨대 실패한 상위 25개 작업으로 데이터베이스와 스키마를 식별할 수 있습니다.

특정 작업 그래프 실행 디버그하기

계정 수준 작업 그래프 기록을 볼 때 특정 작업 그래프 실행을 선택하여 자세한 내용을 확인하십시오. 그래프에서 작업 기록을 볼 수 있는 액세스 권한이 있으면 작업 그래프 실행이 표시되고, 그렇지 않으면 오류가 표시됩니다.

Snowsight task graph showing one root task with 3 dependent tasks, and 4 dependent tasks of those predecessors. The Task titled ROOT_TASK succeeded while showing a slightly longer duration than other tasks, along with INSERT_1 task. Two dependent tasks of INSERT_2 ran but failed, and the third dependent task succeeded. The highlighted task failed.

예를 들어 실패한 특정 작업 그래프 실행을 선택하여 전체 그래프를 보고 실패하거나 일시 중단된 특정 작업의 결과로 실행되지 않은 작업을 식별하거나, 그래프에서 종속 작업 실행을 지연시키는 장시간 실행 중인 작업을 식별할 수 있습니다.

작업 그래프의 특정 작업에 대해 작업의 다양한 측면을 마우스로 가리키면 작업에 대한 추가 세부 정보를 수집할 수 있습니다.

  • 웨어하우스 메타데이터는 상태와 크기를 포함하여 작업 실행에 사용되는 웨어하우스를 식별하며, 이는 웨어하우스 크기로 인해 느리게 실행되는 작업이나 웨어하우스 사용에 영향을 미치는 작업을 식별하는 데 도움이 될 수 있습니다.

  • 스트림 조건 메타데이터는 테이블 스트림 세부 정보와 작업에 대한 조건이 true 또는 false로 설정되었는지 여부를 표시합니다.

  • 작업에 대한 추가 세부 정보를 보려면 Go to Task Page 를 선택하십시오.

각 작업은 대응하는 색상과 함께 Succeeded, Failed, Skipped, Suspended, Cancelled 또는 Did not run 과 같은 상태를 표시합니다. 실패한 작업, 건너뛴 작업, 취소한 작업의 상태를 마우스로 가리키면 자세한 내용을 확인할 수 있습니다.

작업 그래프 외에도, 실행된 작업, 각 작업의 시작 시간, 각 작업 실행의 지속 시간, 각 작업의 상태, 작업 실행 순서를 나타내는 타임라인을 설명하는 테이블을 검토할 수 있습니다. 타임라인을 통해 작업 그래프 실행이 느린 이유와 종속 작업의 시작을 지연시켰을 수 있는 장시간 실행 중인 작업을 재빨리 확인할 수 있습니다.

테이블에서 각 작업에 대해 추가 메뉴를 선택하여 워크시트의 작업에 대한 쿼리 ID를 열거나 쿼리 프로필을 열 수 있습니다.