Budgets로 크레딧 사용 모니터링¶

계정 예산 및 사용자 지정 예산¶

Snowflake에서 예산을 사용하기 시작하려면 계정 예산을 활성화하십시오. 계정 예산은 계정의 모든 지원 오브젝트 에 대한 지출을 모니터링합니다. 예산에 대한 알림을 받으려면 지출 한도를 설정하고 알림을 받을 이메일 주소를 지정하십시오.

또한 사용자 지정 예산을 생성하여 지원되는 특정 오브젝트 그룹의 지출 한도를 모니터링할 수도 있습니다. 모든 데이터베이스와 스키마에서 사용자 지정 예산을 생성할 수 있습니다. 계정 예산과 마찬가지로, 지출 한도와 알림 이메일 주소를 설정해야 알림 이메일을 받을 수 있습니다.

지출 한도 및 시간 간격¶

지출 한도는 Snowflake 크레딧으로 표현되며 경고 및 알림 목적으로만 사용됩니다. 지출 한도는 달력상 한 달의 시간 간격으로 설정됩니다.

시간 간격은 매월 1일 12:00AM UTC에 시작하여 매월 말일 11:59PM UTC에 끝납니다. 해당 월의 1일 이후에 예산이 생성된 경우 첫 번째 모니터링 간격은 해당 월 말일까지의 기간이며, 다음 달 1일에 재설정됩니다.

매월 1일 이후에 계정 예산 을 활성화하면 해당 월초부터 시작되는 데이터가 백필되어 해당 월의 지출 한도를 초과하려고 하는지 결정하는 데 사용됩니다.

매월 1일 이후에 사용자 지정 예산 을 생성하면 해당 월의 기록 데이터가 백필되지 않습니다. 향후 지출 예측은 예산이 활성화된 이후에만 해당 일수의 크레딧 사용을 기반으로 합니다.

지원되는 오브젝트¶

지원되는 오브젝트 목록은 모두 계정 예산의 지출 한도에 영향을 줍니다. 사용자 지정 예산의 경우 모니터링할 특정 오브젝트를 선택할 수 있습니다.

예산에 따른 모니터링에는 다음 오브젝트가 지원됩니다.

• 테이블

• 구체화된 뷰

• 스키마

• 데이터베이스

• 웨어하우스

• 파이프

• 작업

알림¶

현재 지출이 시계열 예측을 기반으로 지출 한도를 초과할 것으로 보이면 예산에서 일일 경고 알림을 보냅니다. 자동 경고 알림을 받으려면 다음을 수행해야 합니다.

• 예산에 대한 지출 한도 설정.

• 예산에 대한 이메일 알림 설정.

다음은 알림 이메일의 예입니다.

예산 생성에 필요한 역할 및 권한¶

사용자 지정 역할을 사용하여 계정에서 사용자 지정 예산을 생성할 수 있습니다. 다음과 같은 사용자 지정 역할을 부여해야 합니다.

• SNOWFLAKE 데이터베이스 역할 SNOWFLAKE.BUDGET_CREATOR

• 예산을 생성할 스키마에 대한 CREATE SNOWFLAKE.CORE.BUDGET 권한

예를 들어 budget_admin 역할을 생성하고 스키마 budgets_db.budgets_schema 에서 사용자 지정 예산을 생성하는 데 필요한 역할과 권한을 부여합니다.

CREATE ROLE budget_admin;

GRANT DATABASE ROLE SNOWFLAKE.BUDGET_CREATOR TO ROLE budget_admin;

GRANT USAGE ON SCHEMA budgets_db.budgets_schema TO ROLE budget_admin;

GRANT CREATE SNOWFLAKE.CORE.BUDGET ON SCHEMA budgets_db.budgets_schema
  TO ROLE budget_admin;

계정 예산을 관리하는 애플리케이션 역할¶

계정 예산을 수정하거나 모니터링하기 위해 계정의 사용자 지정 역할에 다음 애플리케이션 역할을 부여할 수 있습니다.

GRANT APPLICATION ROLE SNOWFLAKE.BUDGET_ADMIN TO ROLE budget_admin;

GRANT APPLICATION ROLE SNOWFLAKE.BUDGET_VIEWER TO ROLE budget_monitor;

사용자 지정 예산을 관리하는 인스턴스 역할¶

각 사용자 지정 예산에는 예산을 보거나 수정하도록 다른 역할에 부여할 수 있는 인스턴스 역할이 있습니다.

GRANT SNOWFLAKE.CORE.BUDGET ROLE budgets_db.budgets_schema.my_budget!ADMIN
  TO ROLE budget_admin;

비용 탐색하기¶

Snowsight 또는 Account Usage SERVERLESS_TASK_HISTORY 뷰 를 사용하여 서버리스 작업 비용을 볼 수 있습니다. 서비스 유형을 기반으로 한 비용 확인에 대한 자세한 내용은 컴퓨팅 비용 살펴보기 섹션을 참조하십시오.

Snowsight 를 사용하거나 Account Usage 뷰와 Organization Usage 뷰를 쿼리하여 저장소 비용을 볼 수 있습니다. 저장소 비용 보기에 대한 자세한 내용은 저장소 비용 살펴보기 섹션을 참조하십시오.

계정 예산 활성화하기¶

계정 예산을 활성화하고, 계정의 지출 한도를 설정하고, 크레딧 사용이 지출 한도를 초과할 때 알림을 받을 이메일 주소를 입력합니다.

Snowsight 또는 SQL을 사용하여 계정 예산을 활성화할 수 있습니다.

Snowsight를 사용하여 사용자 지정 예산 만들기¶

1. Snowsight 에 로그인합니다.

2. Select Admin » Cost Management

3. Budgets 를 선택합니다.

4. 대시보드의 오른쪽 위 모서리에서 (Add Budget)을 선택합니다.

   참고

   Add Budget 아이콘이 보이지 않으면 먼저 계정 예산을 활성화 해야 합니다.

5. Budget name 을 입력합니다.

6. 예산을 생성할 데이터베이스와 스키마를 선택합니다.

7. Spending limit 을 입력합니다.

8. 알림을 받을 이메일 주소를 입력합니다.

   참고

   예산 알림을 위해 추가한 각 이메일 주소는 확인 과정을 거쳐야 합니다. 목록에 있는 이메일 주소가 확인되지 않은 경우 알림 이메일 설정이 실패합니다.

9. Resources to monitor 를 선택합니다.

   • 데이터베이스를 추가하려면 Databases 를 확장하여 데이터베이스를 선택하십시오.

   • 스키마에서 오브젝트를 추가하려면 스키마를 확장하여 사용 가능한 오브젝트를 나열하십시오. 오브젝트 카테고리(예: Tables 또는 Tasks)를 확장하여 오브젝트를 선택합니다.

   • 웨어하우스를 추가하려면 Warehouses 를 확장하고 웨어하우스를 선택하십시오.

   참고

   데이터베이스 또는 스키마를 선택하면 데이터베이스 또는 스키마 내에 포함된 모든 지원 오브젝트 (예: 테이블)도 예산에 추가됩니다.

Snowsight 를 사용하여 알림용 이메일 주소를 추가하면 Snowflake는 백그라운드 프로세스에서 deault_budget_notification_integration 이라는 이메일 알림 통합을 생성하거나 업데이트합니다. 알림 통합이 존재하는 경우 Snowflake는 사용자가 입력한 새 이메일 주소를 목록의 기존 이메일 주소에 추가합니다.

알림 통합이 없으면 Snowflake가 알림 통합을 생성하고 USAGE 권한을 부여합니다. 자세한 내용은 계정 예산 섹션에 설명된 단계 를 참조하십시오.

SQL을 사용하여 사용자 지정 예산 만들기¶

사용자 지정 예산을 만든 다음 지출 한도와 알림 이메일 주소를 설정합니다.

1. 계정의 기존 예산을 검토합니다.

   SELECT SYSTEM$SHOW_BUDGETS_IN_ACCOUNT();
   

   Copy

2. CREATE SNOWFLAKE.CORE.BUDGET 명령을 사용하여 budgets_db.budgets_schema 에 예산 my_budget 을 생성합니다.

   USE SCHEMA budgets_db.budgets_schema;
   
   CREATE SNOWFLAKE.CORE.BUDGET my_budget();
   

   Copy

3. 지출 한도를 매달 500크레딧으로 설정합니다.

   CALL my_budget!SET_SPENDING_LIMIT(500);
   

   Copy

4. 알림 통합 및 이메일 주소를 설정합니다.

   참고

   아직 이메일 NOTIFICATION INTEGRATION을 만들지 않았다면 계정 예산 섹션의 단계 를 참조하여 하나 만드십시오.

   CALL my_budget!SET_EMAIL_NOTIFICATIONS('budgets_notification_integration',
                                          'costadmin@example.com');
   

   Copy

5. 사용자 지정 예산에 오브젝트를 추가하려면 예산의 ADD_RESOURCE 메서드에 대한 참조를 전달해야 합니다. 예를 들어 my_budget 이라는 예산에 t1 이라는 테이블을 추가하려면 다음을 수행하십시오.

   CALL budgets_db.budgets_schema.my_budget!ADD_RESOURCE(
      SYSTEM$REFERENCE('TABLE', 't1', 'SESSION', 'applybudget'));
   

   Copy

   SYSTEM$REFERENCE 문은 테이블에 부여된 APPLYBUDGET 권한으로 TABLE 오브젝트 t1 에 대한 참조를 생성합니다. 함수의 세 번째 매개 변수는 참조 범위를 지정하는데, 이 경우 〈SESSION’은 세션 범위를 사용하여 참조를 생성합니다. 예산에 대한 ADD_RESOURCE 메서드에 전달된 참조는 일시적 참조 범위로 생성할 수 있습니다(즉, 세 번째 매개 변수가 〈SESSION〉 또는 〈CALL’일 수 있음).

6. 사용자 지정 budget_admin 역할에 ADMIN 인스턴스 역할을 부여합니다.

   GRANT SNOWFLAKE.CORE.BUDGET ROLE budgets_db.budgets_schema.my_budget!ADMIN
     TO ROLE budget_admin;
   

   Copy

계정 예산을 활성화할 수 없음¶

계정 예산을 활성화할 수 없는 이유는 여러 가지가 있습니다.

Unknown user-defined function SNOWFLAKE.LOCAL.ACTIVATE

FAILURE: Uncaught exception of type 'BUDGET_ALREADY_ACTIVATED' on line X at position X

CALL SNOWFLAKE.LOCAL.ACCOUNT_ROOT_BUDGET!GET_CONFIG();

-20000 (P0001): Uncaught exception of type 'NO_PERMISSION_TO_ACTIVATE_BUDGET' on line X at position X

사용자 지정 예산을 만들 수 없음¶

사용자 지정 예산을 만들 수 없는 이유는 여러 가지가 있습니다.

FAILURE: SQL access control error: Insufficient privileges to operate on class 'BUDGET'

FAILURE: Uncaught exception of type 'STATEMENT_ERROR' on line 0 at position -1 :
Uncaught exception of type 'UNSUPPORTED_BUDGET_TYPE' on line X at position X

사용자 지정 예산을 활성화할 수 없음¶

FAILURE: Uncaught exception of type 'STATEMENT_ERROR' on line 0 at position -1 :
Uncaught exception of type 'UNSUPPORTED_BUDGET_TYPE' on line X at position X

계정 예산에 대해 메서드를 호출할 수 없음¶

계정 예산에 대한 메서드 호출이 실패할 수 있는 이유는 여러 가지가 있습니다.

-20000 (P0001): Uncaught exception of type 'FUNCTION_NOT_SUPPORTED_FOR_ACCOUNT_ROOT_BUDGET' on line 11 at position 18

-20000 (P0001): Uncaught exception of type 'ACCOUNT_ROOT_BUDGET_NOT_ACTIVATED' on line X at position X

내 계정에서 예산 기능을 사용할 수 없음¶

FAILURE: SQL compilation error: Class 'SNOWFLAKE.CORE.BUDGET' does not exist or not authorized.

000002 (0A000): Uncaught exception of type 'STATEMENT_ERROR' on line 0 at position -1 : Unsupported feature 'TOK_RESOURCE_GROUP'.