스키마:: ACCOUNT_USAGE

AGGREGATE_ACCESS_HISTORY 뷰¶

이 Account Usage 뷰는 Snowflake의 모든 워크로드에 대해 집계된 액세스 기록 을 제공합니다. 워크로드에 자주 반복되는 트랜잭션 쿼리가 포함된 경우 해당 쿼리의 액세스 패턴도 자주 반복됩니다. 이러한 액세스 기록 정보를 집계하여 확인하는 것이 더 효율적입니다.

AGGREGATE_ACCESS_HISTORY 뷰에는 1분 간격으로 반복되는 쿼리에 대해 시간 경과에 따라 집계된 ACCESS_HISTORY 뷰 와 유사한 데이터가 포함됩니다.

이 뷰는 분석 및 트랜잭션 쿼리 모두와 관련된 액세스 기록 정보도 제공합니다. 반면, ACCESS_HISTORY 뷰 에는 QUERY_HISTORY 뷰 에 나타나는 쿼리와 관련된 액세스 기록 정보만 포함되며 특정 단기 실행 트랜잭션 쿼리는 포함되지 않습니다.

열¶

열 이름	데이터 타입	설명
INTERVAL_START_TIME	TIMESTAMP_LTZ	측정 기간의 시작 시간입니다.
INTERVAL_END_TIME	TIMESTAMP_LTZ	측정 기간의 종료 시간입니다.
QUERY_PARAMETERIZED_HASH	TEXT	동일한 매개 변수화된 쿼리를 식별하는 고유한 ID입니다. QUERY_PARAMETERIZED_HASH 열 섹션을 참조하십시오.
USER_NAME	TEXT	쿼리를 실행한 사용자입니다.
CALLS	NUMBER	INTERVAL_START_TIME 및 INTERVAL_END_TIME으로 지정된 기간 동안 발생하고 특정 매개 변수화된 쿼리 및 사용자가 트리거한 액세스 동작의 횟수입니다.
DIRECT_OBJECTS_ACCESSED	ARRAY	쿼리에서 명시적으로, 또는 별표(즉, `*`) 사용 등의 바로 가기를 통해 직접 명명된 사용자 정의 함수(즉, UDF 및 UDTF), 저장 프로시저, 테이블, 뷰, 열과 같은 데이터 오브젝트의 JSON 배열입니다. 이 필드에서 가상 열을 반환할 수 있습니다. UDF에 대한 추가 참고 사항은 UDF 참고 사항 을 참조하십시오.
BASE_OBJECTS_ACCESSED	ARRAY	열, 외부 함수, UDF, 저장 프로시저를 포함하여 쿼리를 실행할 모든 기본 데이터 오브젝트로 구성된 JSON 배열입니다. ACCESS_HISTORY 뷰 의 예에서 첫 번째 배열의 필드는 UDF를 지정합니다. 해당되는 경우, 첫 번째 배열에서 이러한 동일한 필드는 저장 프로시저도 지정합니다. 다음 사항을 참고하십시오. 이 필드는 데이터 공유 컨슈머 계정에서 공유 뷰에 액세스하는 경우, 가상 열을 포함하여 뷰 이름 또는 뷰 열을 지정합니다. UDF에 대한 추가 참고 사항은 UDF 참고 사항 을 참조하십시오.
OBJECTS_MODIFIED	ARRAY	쿼리의 쓰기 작업과 연결된 오브젝트를 지정하는 JSON 배열입니다. UDF 및 저장 프로시저 배열은 액세스가 이루어진 방식에 따라 ACCESS_HISTORY 뷰 의 예제에서 `baseSources` 및 `directSources` 의 배열에 나타난 것과 동일한 배열입니다. 간결성을 위해 예제에서는 UDF 및 저장 프로시저 배열을 생략합니다. UDF에 대한 추가 참고 사항은 UDF 참고 사항 을 참조하십시오.
OBJECT_MODIFIED_BY_DDL	OBJECT	데이터베이스, 스키마, 테이블, 뷰, 열에 대한 DDL 작업을 지정합니다. 또한 이러한 작업에는 테이블 또는 뷰에 대한 행 액세스 정책, 열에 대한 마스킹 정책 그리고 오브젝트나 열에 대한 태그 업데이트(예: 태그 설정, 태그 값 변경)를 지정하는 문도 포함됩니다.
POLICIES_REFERENCED	ARRAY	중간 오브젝트 또는 중간 열에 설정된 정책을 포함하여, 열에 설정된 강제 마스킹 정책과 테이블에 설정된 행 액세스 정책에 대한 정보를 지정합니다.

DIRECT_OBJECTS_ACCESSED, BASE_OBJECTS_ACCESSED, OBJECTS_MODIFIED, POLICIES_REFERENCED 열에 대한 JSON 배열의 필드는 아래에 설명되어 있습니다.

필드	데이터 타입	설명
columnId	NUMBER	계정 내에서 고유한 열 ID입니다. 이 값은 COLUMNS 뷰의 `column_id` 의 값과 동일합니다.
columnName	TEXT	액세스한 열의 이름입니다. 정책의 경우, 마스킹 정책이 설정된 열을 지정합니다.
objectId	NUMBER	오브젝트의 식별자이며, 이는 지정된 계정 및 도메인 내에서 고유합니다. 이 번호는 다음과 일치합니다. TABLE, VIEWS 및 MATERIALIZED_VIEW_REFRESH_HISTORY 뷰에서 `TABLE_ID` 열의 값입니다. 스테이지에 액세스한 경우 이 번호는 다음과 일치합니다. 사용자 의 `NAME` 식별자(사용자 스테이지). 테이블 의 `TABLE_ID` 번호(테이블 스테이지). 스테이지 의 `STAGE_ID` 번호(명명된 스테이지).
objectName	TEXT	액세스한 오브젝트의 정규화된 이름입니다. 열에 마스킹 정책이 설정되어 있거나 테이블 또는 뷰에 행 액세스 정책이 설정되어 있는 경우, 값은 행 액세스 정책이 설정된 테이블 또는 뷰나 해당 열 중 하나에 마스킹 정책이 설정된 테이블 또는 뷰의 정규화된 이름을 나타냅니다. 스테이지에 액세스한 경우 이 값은 다음과 같습니다. `username` (사용자 스테이지). `table_name` (테이블 스테이지). `stage_name` (명명된 스테이지).
objectDomain	TEXT	`EXTERNAL TABLE`, `FUNCTION`, `MATERIALIZED VIEW`, `PROCEDURE`, `STAGE`, `STREAM` 또는 `VIEW` 중 하나입니다. `FUNCTION` 은 UDF, UDTF, 외부 함수를 지정합니다. 정책의 경우, 행 액세스 정책이 설정된 오브젝트의 도메인을 지정합니다.
location	TEXT	외부 위치에서 데이터에 액세스하는 경우 외부 위치의 URL입니다(예: `s3://mybucket/a.csv`). 쿼리가 스테이지에 액세스하지 않는 경우 이 필드는 생략됩니다.
stageKind	TEXT	스테이지에 쓰기 작업을 할 때 `Table`, `User`, `Internal Named` 또는 `External Named` 중 하나입니다. 쿼리가 스테이지에 액세스하지 않는 경우 이 필드는 생략됩니다.
baseSources	TEXT	`directSources` 로 지정된 열의 원본 열로 사용되는 열입니다. 이러한 열은 열 계보를 촉진합니다.
directSources	TEXT	데이터에서 구체적으로 언급된 열은 SQL 문에서 데이터가 기록되는 대상 테이블에서 원본 열의 역할을 하는 부분을 씁니다. 이러한 열은 열 계보를 촉진합니다.
policyName	TEXT	정책의 정규화된 이름입니다.
policyId	NUMBER	정책의 식별자이며, 이는 지정된 계정 및 도메인 내에서 고유합니다. 이 값은 MASKING_POLICIES 뷰 에서 마스킹 정책의 식별자 또는 ROW_ACCESS_POLICIES 뷰 에서 행 액세스 정책의 식별자와 일치합니다.
policyKind	TEXT	MASKING_POLICY 또는 ROW_ACCESS_POLICY
argumentSignature	TEXT	UDF 또는 저장 프로시저의 각 인자에 대한 이름과 데이터 타입입니다.
dataType		UDF 또는 저장 프로시저에 대한 반환 값의 데이터 타입입니다. 이 값은 이름은 같지만 반환 유형이 다른 두 개 이상의 UDF를 구별하는 데 도움이 됩니다.

OBJECT_MODIFIED_BY_DDL 열에 대한 필드는 아래에 설명되어 있습니다.

필드	데이터 타입	설명
objectDomain	TEXT	태그를 지정할 수 있는 모든 오브젝트 와 `MASKING POLICY`, `ROW ACCESS POLICY`, `TAG` 를 포함한 DDL 작업으로 정의되거나 수정된 오브젝트의 도메인입니다.
objectId	NUMBER	오브젝트의 식별자로, DDL 작업으로 정의되거나 수정된 주어진 계정과 도메인 내에서 고유합니다.
objectName	TEXT	DDL 작업으로 정의되거나 수정된 오브젝트의 정규화된 이름입니다.
operationType	TEXT	테이블, 뷰 또는 열에 대한 `ALTER`, `CREATE`, `DROP`, `REPLACE` 또는 `UNDROP` 작업을 지정하는 SQL 키워드입니다.
properties	ARRAY	오브젝트 또는 열을 생성, 수정, 삭제 또는 삭제 취소할 때 오브젝트 또는 열 속성을 지정하는 JSON 배열입니다. 속성에는 원자성과 복합형의 두 가지 유형이 있습니다.

properties 필드의 경우:

원자성: 속성당 하나의 값(예: comment 에 단일 문자열 값이 있고 enabled 속성은 부울이며 값이 1개 있음).
복합형: 속성이 다중 값을 가집니다(예: 태그의 allowed_values, 마스킹 정책).

복합형 속성은 JSON 배열에 기록됩니다. 예를 들어 테이블에 EMAIL이라는 단일 열이 포함된 경우 이 열은 다음과 같이 기록됩니다.

columns: {
  "email": {
    objectId: {
      "value": 1
    },
    "subOperationType": "ADD"
  }
}

Copy

subOperationType 값은 다음 중 하나일 수 있습니다.

ADD 는 복합형 속성 추가를 지정합니다(예: 열 추가, 허용되는 값 설정).
DROP 은 복합형 속성 제거를 지정합니다.
ALTER 는 복합형 속성 수정을 지정합니다.

objectId 는 식별자가 없는 허용된 태그 값을 제외하고 열 또는 오브젝트의 식별자를 지정합니다.

사용법 노트¶

뷰의 지연 시간은 최대 180분(3시간)입니다.
이 Account Usage 뷰는 지난 365일(1년) 내 Snowflake 오브젝트(예: 테이블, 뷰, 열)의 집계된 액세스 기록을 쿼리하는 데 사용할 수 있습니다.