조직 사용량

조직 사용량 (Organization Usage)

이 문서는 조직의 모든 계정에 대한 과거 사용 데이터를 제공하는 ORGANIZATION_USAGE 스키마에 대해 설명해요. 이 스키마가 제공하는 뷰 목록, 뷰 접근 방법(조직 계정과 ORGADMIN 활성 계정), 그리고 성능 좋게 쿼리하는 방법(시간 필터, 명시적 컬럼 선택)을 다루어요.

출처: Snowflake SQL Reference

본문

Snowflake는 SNOWFLAKE라는 공유 데이터베이스 안의 ORGANIZATION_USAGE 스키마를 통해 조직의 모든 계정에 대한 과거 사용 데이터를 제공해요.

ORGANIZATION_USAGE 뷰 (ORGANIZATION_USAGE views)

ORGANIZATION_USAGE 스키마는 다음 뷰를 포함해요:

[1] 모든 지연 시간은 근사치이며, 어떤 경우에는 실제 지연이 더 낮을 수 있어요.

[2] 조직 청구 뷰는 월말에 일부 조정이 이루어지기 때문에 실제 최종 금액을 표시하지 않아요. Snowflake 리셀러를 통해 계약한 고객은 이 뷰들의 데이터에 접근할 수 없어요.

ORGANIZATION_USAGE 스키마 접근하기 (Accessing the ORGANIZATION_USAGE schema)

ORGANIZATION_USAGE 스키마는 조직 계정과 ORGADMIN 역할이 활성화된 일반 계정에서 사용할 수 있어요. 스키마의 뷰에 접근하는 방법은 어떤 유형의 계정을 사용하는지에 따라 달라져요.

참고: ORGANIZATION_USAGE 스키마의 뷰는 현재 AWS GovCloud와 Microsoft Azure Government의 US SnowGov Region에서는 사용할 수 없어요.

조직 계정에서 스키마 접근하기

기본적으로 GLOBALORGADMIN 역할이 부여된 사용자만 조직 계정에서 ORGANIZATION_USAGE 뷰에 접근할 수 있어요.

다른 사용자에게 접근을 부여하려면 조직 관리자가 적절한 애플리케이션 역할을 계정 역할 또는 사용자에게 부여할 수 있어요.

SNOWFLAKE.ORG_USAGE_ADMIN 애플리케이션 역할이 부여된 사용자는 조직 계정의 ORGANIZATION_USAGE 스키마의 모든 뷰에 접근할 수 있어요. 다음 예시는 사용자 joe가 스키마의 모든 뷰에 접근하게 해줘요:

USE ROLE GLOBALORGADMIN;

GRANT APPLICATION ROLE SNOWFLAKE.ORG_USAGE_ADMIN TO ROLE custom_role;

GRANT ROLE custom_role TO USER joe;

조직 관리자는 더 세분화된 수준으로도 접근을 부여할 수 있어요. 예를 들어 ORGANIZATION_OBJECT_VIEWER 애플리케이션 역할은 DATABASES 뷰에 대한 접근을 부여하지만 TASK_HISTORY 뷰에 대한 접근은 부여하지 않아요.

어떤 애플리케이션 역할이 특정 뷰에 접근을 부여하는지 확인하려면 다음 목록을 사용하세요. 이 애플리케이션 역할들은 SNOWFLAKE 애플리케이션 안에 있어요. 다른 역할에 부여할 때는 애플리케이션 역할의 완전히 한정된 이름(예: SNOWFLAKE.ORGANIZATION_USAGE_VIEWER)을 사용하세요.

ORGADMIN 활성 계정에서 스키마 접근하기

ORGADMIN 활성 계정은 ORGADMIN 역할이 활성화된 일반 계정이에요. ORGADMIN 활성 계정 안에서 공유된 SNOWFLAKE 데이터베이스에 접근할 수 있는 사람은 누구나 ORGANIZATION_USAGE 스키마에 접근할 수 있어요. 기본적으로 ACCOUNTADMIN 역할만 이 데이터베이스에 대한 권한을 가지므로, ORGADMIN 역할은 필요한 권한을 갖지 못해요. 이 권한을 ORGADMIN 역할에 부여하려면 "SNOWFLAKE 데이터베이스의 스키마를 사용하도록 다른 역할 활성화"를 참고하세요.

비관리자에게 접근을 부여하려면 조직 관리자가 계정 역할 또는 사용자에게 적절한 데이터베이스 역할을 부여할 수 있어요.

어떤 데이터베이스 역할이 특정 뷰에 접근을 부여하는지 확인하려면 다음 목록을 사용하세요.

ORGANIZATION_USAGE_VIEWER, ORGANIZATION_BILLING_VIEWER, ORGANIZATION_ACCOUNTS_VIEWER SNOWFLAKE 데이터베이스 역할은 공유된 SNOWFLAKE 데이터베이스의 Organization Usage 뷰에 SELECT 권한이 부여돼요.

| View | ORGANIZATION_BILLING_VIEWER Role | ORGANIZATION_USAGE_VIEWER Role | ORGANIZATION_ACCOUNTS_VIEWER Role | | ACCOUNTS view | | | ✔ | | ANOMALIES_IN_CURRENCY_DAILY view | ✔ | | | | CONTRACT_ITEMS view | ✔ | | | | LISTING_AUTO_FULFILLMENT_USAGE_HISTORY view | ✔ | | | | RATE_SHEET_DAILY view | ✔ | | | | REMAINING_BALANCE_DAILY view | ✔ | | | | USAGE_IN_CURRENCY_DAILY view | ✔ | | | | MARKETPLACE_DISBURSEMENT_REPORT View | ✔ | | | | DATA_TRANSFER_DAILY_HISTORY view | | ✔ | | | DATA_TRANSFER_HISTORY view | | ✔ | | | DATABASE_STORAGE_USAGE_HISTORY view | | ✔ | | | AUTOMATIC_CLUSTERING_HISTORY view | | ✔ | | | MARKETPLACE_PAID_USAGE_DAILY View | | ✔ | | | MATERIALIZED_VIEW_REFRESH_HISTORY view | | ✔ | | | METERING_DAILY_HISTORY view | | ✔ | | | MONETIZED_USAGE_DAILY View | | ✔ | | | PIPE_USAGE_HISTORY view | | ✔ | | | QUERY_ACCELERATION_HISTORY view | | ✔ | | | REPLICATION_GROUP_USAGE_HISTORY view | | ✔ | | | REPLICATION_USAGE_HISTORY view | | ✔ | | | SEARCH_OPTIMIZATION_HISTORY view | | ✔ | | | STAGE_STORAGE_USAGE_HISTORY view | | ✔ | | | STORAGE_DAILY_HISTORY view | | ✔ | | | WAREHOUSE_METERING_HISTORY view | | ✔ | |

자세한 내용은 GRANT DATABASE ROLE을 참고하세요.

일반 사용 시 주의사항 (General usage notes)

Snowflake 전용 뷰는 변경될 수 있어요. 이들 뷰의 모든 컬럼을 선택하지 말고, 원하는 컬럼만 선택하는 것이 좋아요. 예를 들어 name 컬럼이 필요하면 SELECT * 대신 SELECT name을 사용하세요.

모든 과거(historical) ORGANIZATION_USAGE 쿼리를 모든 계정에 걸친 웨어하우스 작업으로 취급하세요: 해당 이름의 뷰 참조 주제(예: QUERY_HISTORY 또는 COPY_HISTORY)를 열고, 기본 시간 컬럼을 제한하고, 필요한 컬럼을 나열하고, 뷰에 account_name 컬럼이 있고 전체 조직에 대해 보고하지 않는 경우 account_name IN (…)을 추가하세요. ORGANIZATION_USAGE 뷰의 지연 시간(Latency)은 쿼리 비용이 아니라 뷰별 최신 상태를 의미해요.

Organization Usage 성능: SNOWFLAKE.ORGANIZATION_USAGE 스키마에서 특정 뷰를 쿼리할 때는 조직 전체 지침인 "성능(Organization Usage)"을 따르세요: 모든 과거 뷰 스캔에 경계를 두고, 컬럼을 명시적으로 나열하고, 시간 필터 컬럼 표와 함께 작업된 SQL과 안티패턴을 사용하세요.

성능 (Performance)

ORGANIZATION_USAGE 뷰는 조직의 모든 계정에 걸쳐 대량의 데이터를 담을 수 있어요. 각 뷰를 쿼리할 때는 과거 뷰와 기타 큰 뷰에 대해 같은 두 가지 규칙을 따르세요:

항상 해당 뷰의 기본 시간 컬럼에 시간 범위를 경계로 지정하세요 (아래 표, 그리고 정확한 이름과 타입은 해당 뷰의 참조 주제 참조).
SELECT * 대신 명시적 컬럼을 선택하세요.

참고: 이 페이지는 ORGANIZATION_USAGE에 대한 권장 쿼리 패턴과 시간 필터를 안내해요. 웨어하우스 고려사항처럼 일반적인 지침일 뿐이며, 서비스 약속·요구사항·보장 결과가 아니에요. 권위 있는 컬럼 정의와 의미는 각 뷰의 참조 주제를 참고하세요.

참고: 필터에는 각 뷰 참조 주제의 문서화된 컬럼, 특히 아래 표의 기본 시간 필터 컬럼을 사용하세요. 내부 수집(internal ingestion), 텔레메트리, 또는 스토리지 식별자는 지원되는 고객 SQL 표면이 아니며 어떤 릴리스에서든 바뀔 수 있어요. 이전 미리보기에 나타나면 무시하세요.

과거 뷰와 시간 필터 (Historical views and time filters)

대부분의 큰 ORGANIZATION_USAGE 뷰는 기본 타임스탬프 또는 날짜 컬럼을 노출해요. 해당 뷰의 모든 쿼리에서 그 컬럼에 경계가 있는 범위를 두세요 (예: QUERY_HISTORY에서 WHERE start_time >= … AND start_time < … — start_time이 아래 표에서 QUERY_HISTORY의 기본 시간 필터 컬럼이기 때문). 개방형 시간 범위는 Snowflake가 행을 반환하기 전에 조직 전체의 전체 기록을 고려하도록 강제해요.

다음 표는 경계가 있는 시간 술어(bounded time predicate)가 가장 중요한 일반적인 과거 뷰(및 유사한 큰 스캔)를 나열해요. 이 표는 예시일 뿐 전체가 아니에요. 다른 과거 ORGANIZATION_USAGE 뷰에도 동일한 경계 시간 방식을 적용하고, 각 뷰의 참조 주제로 컬럼을 선택하세요. 아래 각 행에 대해 경계 술어에서 기본 시간 필터 컬럼으로 시작하세요 (예: WHERE col >= … AND col < …). 뷰 개정(예: v30, v21)은 시간이 지나면서 바뀌므로 권위 있는 컬럼 이름과 타입은 각 뷰의 참조 주제를 사용하세요.

여러 ORGANIZATION_USAGE 뷰를 조인하기 전에 참조하는 각 뷰에 경계가 있는 시간 술어를 적용하세요 (예: 조인에 둘 다 나타날 때 QUERY_HISTORY.start_time과 COPY_HISTORY.last_load_time을 각각 경계 지정). 같은 로직을 다시 실행하는 대시보드의 경우, 넓은 기록을 다시 스캔하는 대신 소유한 테이블에 결과를 구체화하고 일정에 따라 새로고침하세요.

좋은 쿼리 패턴 (Good query patterns)

각 예시는 적용되는 ORGANIZATION_USAGE 뷰를 명명해요. 모든 예시는 위의 두 규칙을 따릅니다: 해당 뷰의 기본 시간 컬럼에 경계 시간(표에서), 그리고 SELECT 목록에 명시적 컬럼을 사용해요. 뷰에 account_name이 있을 때는 AND account_name IN (…)을 추가해서 관심 있는 계정으로만 스캔을 제한하세요.

QUERY_HISTORY: start_time을 경계로 지정해요.

SELECT query_id, start_time, user_name, warehouse_name
  FROM SNOWFLAKE.ORGANIZATION_USAGE.QUERY_HISTORY
  WHERE start_time > '2025-01-01 00:00:00'::timestamp_ltz;

COPY_HISTORY: last_load_time을 경계로 지정해요.

SELECT account_name, file_name, error_count, status, last_load_time
  FROM SNOWFLAKE.ORGANIZATION_USAGE.COPY_HISTORY
  WHERE last_load_time >= '2025-01-01 00:00:00'::timestamp_ltz
    AND last_load_time < '2025-02-01 00:00:00'::timestamp_ltz;

DATABASES: 객체 인벤토리 (이 패턴에는 시간 술어가 없지만 컬럼은 나열하세요).

SELECT database_name, account_name
  FROM SNOWFLAKE.ORGANIZATION_USAGE.DATABASES;

USERS: 모든 계정이 필요하지 않으면 account_name을 필터하세요.

SELECT account_name, name, login_name
  FROM SNOWFLAKE.ORGANIZATION_USAGE.USERS
  WHERE account_name IN ('ACC1', 'ACC2', 'ACC3');

DATABASES와 USERS 예시는 결과 집합이 더 작은 객체 스타일 뷰를 사용해요. Snowflake가 컬럼을 추가해도 다운스트림 스키마가 안정적으로 유지되도록 명시적 컬럼 목록을 유지하세요.

피해야 할 쿼리 패턴 (Query patterns to avoid)

다음 안티패턴을 특정 뷰에 대해 보여주지만, 같은 문제는 해당 뷰의 기본 시간 컬럼에 경계가 있는 시간 술어를 생략할 때 대규모 과거 뷰에도 적용돼요.

QUERY_HISTORY: 경계가 없는 집계.

SELECT COUNT(*) FROM SNOWFLAKE.ORGANIZATION_USAGE.QUERY_HISTORY;

LOAD_HISTORY: last_load_time에 시간 술어 없는 LIMIT.

SELECT * FROM SNOWFLAKE.ORGANIZATION_USAGE.LOAD_HISTORY LIMIT 1;

QUERY_ATTRIBUTION_HISTORY: start_time에 시간 술어 없는 SELECT *.

SELECT * FROM SNOWFLAKE.ORGANIZATION_USAGE.QUERY_ATTRIBUTION_HISTORY;

경계가 없는 패턴이 비싼 이유 (Why unbounded patterns are expensive)

ORGANIZATION_USAGE 뷰는 조직 전체의 기록을 표시해요. 쿼리에 선택적인 시간 술어(그리고 특정 계정만 필요할 때는 account_name 필터)가 없으면, Snowflake는 행을 반환하거나 집계를 완료하기 전에 매우 많은 양의 기록을 고려해야 할 수 있어요. QUERY_HISTORY 같은 넓은 뷰에서는 그 작업이 매우 큰 행 수로 확장되어 실행 시간과 웨어하우스 비용이 증가할 수 있어요.

ORGANIZATION_USAGE 뷰의 Latency 값은 각 뷰의 데이터가 얼마나 최신인지 설명하는 것으로, 대규모 스캔을 위해 같은 뷰에서 시간 범위(적용 가능하면 account_name)를 제한해야 할 필요를 없애주는 것은 아니에요.

조직 사용량