카테고리:

차등 개인정보 보호 함수 , 테이블 함수

ESTIMATE_REMAINING_DP_AGGREGATES

개인정보 보호 예산 한도에 도달하기 전에 실행할 수 있을 것으로 추정되는 집계 함수의 수를 반환합니다. 나머지 집계의 수는 추정치 입니다. 개인정보 보호 예산 한도에 도달하기 전에 허용되는 집계 함수의 실제 개수는 다양한 요인에 따라 달라질 수 있습니다.

이 함수는 차등 개인정보 보호 구현과 개인정보가 보호되는 테이블 쿼리에 모두 유용합니다.

  • 분석가는 이 함수를 사용하여 예산 기간에 남은 개인정보 보호 예산이 대략 얼마인지 추정할 수 있습니다.

  • 개인정보 보호정책 소유자는 개인정보 보호 예산 한도가 모든 사용자에게 적절하도록 이 함수를 사용하여 개인정보 보호 예산 설정을 미세 조정 할 수 있습니다.

개인정보 보호 예산은 쿼리당 계산되는 것이 아니라 집계 함수당 으로 계산됩니다. 따라서 쿼리 SELECT SUM(age), COUNT(age) FROM T GROUP BY STATE; 는 쿼리 SELECT SUM(age) FROM T; 보다 두 배나 많은 개인정보 보호 손실을 초래합니다(즉, 쿼리 ‘비용’이 두 배 많이 소요됨). 일반적으로, 모든 집계 함수의 비용은 개인정보 보호정책 본문의 MAX_BUDGET_PER_AGGREGATE 매개 변수 값과 동일합니다. GROUP BY 절은 집계 함수로 간주되지 않으며 개인정보 보호 손실이 발생하지 않습니다.

이 함수는 지출된 예산(즉, 현재 누적된 개인정보 보호 손실)도 반환하지만, Snowflake에서는 이 함수를 사용하여 지출된 예산이 아니라 추정된 잔여 예산에 초점을 맞출 것을 권장합니다. 지출된 예산은 선형 함수(집계 수 집계당 비용)가 아니라 아선형* 함수입니다. 즉, 예산 기간 동안 사용하면 추가 집계의 총비용이 감소합니다. 그래서 남은 집계의 추정 개수가 공식 (남은 개인정보 보호 손실 예산) / (함수당 개인정보 보호 손실)에서 계산된 개수보다 큽니다.

구문

SNOWFLAKE.DATA_PRIVACY.ESTIMATE_REMAINING_DP_AGGREGATES('<table_name>')
Copy

인자

table_name

차등 개인정보 보호정책으로 보호되는 테이블의 이름입니다. 이 함수는 마지막 예산 새로 고침 이후로 이 테이블에 대해 실행한 쿼리를 기반으로 개인정보 보호 예산 데이터를 반환합니다.

출력

이 함수는 다음 열이 포함된 테이블을 반환합니다.

데이터 타입

설명

NUMBER_OF_REMAINING_DP_AGGREGATES

INT

개인정보 보호 예산 한도를 초과하기 전에 분석가가 호출할 수 있는 남은 집계 함수의 추정 개수입니다.

BUDGET_LIMIT

DECIMAL

개인정보 보호정책에 정의된 대로, 지정된 테이블을 보호하는 개인정보 보호 예산의 현재 한도입니다.

개인정보 보호 예산 한도를 조정하려면 개인정보 보호 예산에 대한 개인정보 보호 설정 섹션을 참조하십시오.

BUDGET_WINDOW

STRING

개인정보 보호 예산의 갱신 주기, 즉 누적 개인정보 보호 손실이 0으로 재설정되는 빈도입니다. 테이블을 보호하는 개인정보 보호정책에 정의되어 있습니다.

예산 기간을 조정하려면 새로 고침 기간 수정 섹션을 참조하십시오.

BUDGET_SPENT

DECIMAL

현재 예산 기간 동안 현재 역할을 사용하는 현재 사용자에게 발생한 누적 개인정보 보호 손실입니다.

액세스 제어 권한

이 함수를 실행하려면 다음 권한이 필요합니다.

  • 지정된 테이블에 대한 SELECT 권한.

  • 지정된 테이블의 데이터베이스와 스키마에 대한 USAGE 권한.

사용법 노트

  • 추정치는 함수를 실행하는 사용자가 실행한 쿼리를 기반으로 합니다. 쿼리는 여러 조건에 따라 개인정보 보호 예산과 연결되므로, 이 함수를 실행하는 데 사용하는 환경이 쿼리 실행에 사용하는 환경과 정확히 동일하도록 해야 합니다(예: 사용자, 역할, 계정).

  • 여러 테이블을 사용하는 쿼리를 실행하는 경우 테이블당 NUMBER_OF_REMAINING_DP_AGGREGATES 를 한 번 실행한 다음 가장 낮은 ESTIMATE_REMAINING_DP_AGGREGATES 값을 예상 사용량 제한으로 사용해야 합니다.

  • 출력이 비어 있는 경우 테이블이 차등 개인정보 보호로 보호되지 않음(즉, 테이블에 개인정보 보호정책이 할당되지 않음)을 나타냅니다.

SELECT * FROM TABLE(SNOWFLAKE.DATA_PRIVACY.ESTIMATE_REMAINING_DP_AGGREGATES('my_table'));
Copy
+-----------------------------------+--------------+---------------+--------------+
| NUMBER_OF_REMAINING_DP_AGGREGATES | BUDGET_LIMIT | BUDGET_WINDOW | BUDGET_SPENT |
|-----------------------------------+--------------+---------------+--------------|
|                 994               |     233      |     WEEKLY    |     1.8      |
+-----------------------------------+--------------+---------------+--------------+

ESTIMATE_REMAINING_DP_AGGREGATES 함수를 사용하여 쿼리의 효과를 확인하는 방법을 보여주는 확장된 예는 개인정보 보호 예산 지출 추적하기 섹션을 참조하십시오.