협업에서 분석 활동을 모니터링해요

기능 — 일반 제공

현재 이들 리전에서 사용할 수 있어요.

정부 및 VPS 배포에서는 사용할 수 없어요.

활동 기록은 모든 협업자에게 협업 내 분석 활동의 감사 추적을 제공해요. 각 협업자는 협업에서의 역할과 관련된 활동 및 세부 정보만 볼 수 있으며, 어떤 파트너의 민감한 정보도 다른 파트너에게 노출되지 않아요.

협업에서 템플릿 실행을 호출하면, 이 페이지에 설명된 활동 메타데이터를 내 실행이 사용한 리소스를 보유한 다른 협업자와 공유하는 데 동의하게 돼요.

참고

활동 기록은 이 기능의 릴리스 이후에 생성된 협업에서 사용할 수 있어요. 이 날짜 이전에 생성된 협업은 활동 기록에 접근할 수 없어요.

출처: 문서

본문

여러분에게 표시되는 활동

활동 기록에서 볼 수 있는 내용은 여러분의 활동과 협업에 기여한 리소스에 따라 달라져요.

여러분의 계정이 실행한 실행: 협업에서 여러분의 계정이 실행한 모든 분석 실행의 전체 세부 정보를 항상 볼 수 있어요. 여기에는 템플릿 ID, 참조된 데이터 오퍼링, 소스 테이블, 로컬 테이블, 템플릿 인자, 활성화 대상, 소요 시간, 상태, 실패 이유가 포함돼요.
여러분의 데이터 오퍼링에 대한 실행: 여러분의 계정이 협업에 데이터 오퍼링을 추가했다면, 해당 오퍼링을 참조한 모든 실행을 볼 수 있어요. 여기에는 분석 실행자, 소요 시간, 상태, 사용된 여러분의 데이터 오퍼링 ID가 포함돼요. 다른 계정의 소스 테이블, 로컬 테이블, 템플릿 인자는 이러한 실행에서 볼 수 없어요. 실행이 실패한 경우 전체 실패 세부 정보 대신 편집된 오류 메시지가 표시돼요.
여러분의 템플릿을 사용한 실행: 여러분의 계정이 협업에 템플릿을 추가했다면, 해당 템플릿을 참조한 모든 실행을 볼 수 있어요. 여기에는 분석 실행자, 소요 시간, 상태가 포함돼요. 데이터 오퍼링 ID, 소스 테이블, 로컬 테이블, 템플릿 인자는 이러한 실행에서 볼 수 없어요. 실행이 실패한 경우 전체 실패 세부 정보 대신 편집된 오류 메시지가 표시돼요.

여러분의 계정이 여러 리소스 유형을 기여했다면, 적용 가능한 모든 활동의 합집합을 볼 수 있어요.

활동 기록을 보는 방법

활동 기록은 Snowsight에서 보거나 Collaboration API를 호출하여 볼 수 있어요.

Snowsight에서 Snowflake Data Clean Rooms 페이지의 Activity 탭을 사용하면 협업의 활동을 탐색, 필터링, 정렬하고 각 실행의 세부 정보를 확인할 수 있어요. 자세한 내용은 Snowsight에서 협업 활동 보기를 참조하세요.

Collaboration API로 활동 기록을 보려면 협업 이름과 함께 VIEW_ACTIVITY_HISTORY를 호출하세요.

기본 쿼리

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.VIEW_ACTIVITY_HISTORY(
  $collaboration_name
);

추가 필터 적용

같은 세션에서 추가 필터를 적용하려면 프로시저 호출 결과를 RESULT_SCAN을 사용하여 SELECT로 연결하세요.

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.VIEW_ACTIVITY_HISTORY(
  $collaboration_name
);

SELECT ACTIVITY_ID, ANALYSIS_RUNNER_ALIAS, START_TS, TOTAL_DURATION, STATUS, FAILURE_REASON
  FROM TABLE(RESULT_SCAN(LAST_QUERY_ID()))
  WHERE START_TS >= DATEADD(day, -7, CURRENT_TIMESTAMP())
    AND STATUS = 'ERROR'
  ORDER BY START_TS DESC;

여러분의 계정 실행에 대한 쿼리 실행 세부 정보 가져오기

각 활동 레코드는 여러분의 계정 쿼리 기록에서 해당 ACTIVITY_ID로 태그가 지정돼요. 여러분의 계정이 제출한 실행의 전체 쿼리 실행 세부 정보를 보려면 SNOWFLAKE.ACCOUNT_USAGE.QUERY_HISTORY를 쿼리하고 쿼리 태그로 필터링하세요. 이 뷰는 레코드가 나타나기 전에 지연 시간이 있다는 점에 유의하세요. 자세한 내용은 QUERY_HISTORY 지연 시간 기대치를 참조하세요.

SELECT *
  FROM SNOWFLAKE.ACCOUNT_USAGE.QUERY_HISTORY
  WHERE QUERY_TAG = '{"activity_id": "<your_activity_id>"}'
  ORDER BY START_TIME DESC;

<your_activity_id>를 VIEW_ACTIVITY_HISTORY의 ACTIVITY_ID 값으로 바꾸세요.

결과 열

VIEW_ACTIVITY_HISTORY는 다음 열을 반환해요: ``

account-level query history````````

Column	Type	Description
ACTIVITY_ID	VARCHAR	활동 레코드의 고유 식별자예요. 또한 기본 쿼리에 Query Tag로 추가되어 항목을 .과(와) 연관시킬 수 있어요.
ANALYSIS_RUNNER_ALIAS	VARCHAR	분석을 실행한 협업자의 별칭이에요.
START_TS	TIMESTAMP_LTZ	실행이 시작된 시점의 타임스탬프예요.
TOTAL_DURATION	NUMBER	총 실행 소요 시간(밀리초)이에요.
STATUS	VARCHAR	SUCCESS 또는 ERROR예요. 활성화 템플릿 실행의 경우 SUCCESS는 템플릿 쿼리가 성공적으로 실행되었음을 의미할 뿐이며, 활성화 결과 내보내기 중 발생한 실패는 표시되지 않아요.
FAILURE_REASON	VARCHAR	STATUS가 ERROR일 때 값이 채워져요. 실행을 제출한 분석 실행자는 전체 오류 메시지를 볼 수 있고, 다른 계정은 편집된 메시지를 볼 수 있어요.
ACTIVITY_TYPE	VARCHAR	활동 유형이에요. 현재는 항상 RUN이에요.
ACTIVITY_INFO	VARIANT	실행에 대한 추가 세부 정보예요. 내용은 여러분의 계정이 협업에 기여한 내용에 따라 필터링돼요. 가능한 하위 키는 다음과 같아요: data_offering_ids — 실행에서 참조한 데이터 오퍼링의 ID예요. 여러분의 계정이 데이터 오퍼링을 제공한 경우 표시돼요. request_parameters.template_id — 사용된 템플릿의 ID예요. request_parameters.source_tables — RUN에 소스 테이블로 전달된 테이블이에요. 여러분의 계정이 관련 데이터 오퍼링을 제공한 경우 표시돼요. request_parameters.local_tables — RUN에 로컬 테이블로 전달된 테이블이에요. 분석 실행자에게만 표시돼요. request_parameters.arguments — RUN에 전달된 템플릿 인자예요. 분석 실행자에게만 표시돼요. request_parameters.activation_destination — 실행의 활성화 대상이에요(있는 경우).

접근 제어

다음 프로시저 중 하나를 호출하여 권한을 부여받은 역할을 사용해야 해요.

GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('VIEW ACTIVITY HISTORY', 'COLLABORATION', '{collaboration name}', '{role name}')
GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', '{role name}')
GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', '{role name}')

제한 사항

활성화 내보내기 실패는 표시되지 않아요: 활성화 템플릿 실행의 경우 SUCCESS 상태는 템플릿 쿼리가 성공적으로 실행되었음을 의미할 뿐이에요. 활성화 결과 내보내기 중 발생하는 실패는 활동 기록에 보고되지 않아요.

Free-form SQL 활동은 기록되지 않아요: 활동 기록에는 템플릿 실행만 기록돼요. free-form SQL queries로 실행된 분석은 활동 기록에 나타나지 않아요.

ML Jobs 로그

활동 기록에는 다른 템플릿 실행과 마찬가지로 ML Jobs 실행의 전반적인 상태와 기간이 기록돼요. 컨테이너 수준 로그 출력(작업 스크립트의 stdout/stderr)에 대해서는 Monitor the ML Job을 참조하세요.

협업에서 분석 활동을 모니터링해요