CREATE CLASSIFICATION_PROFILE¶

정규화된 이름: SNOWFLAKE.DATA_PRIVACY.CLASSIFICATION_PROFILE

CLASSIFICATION_PROFILE 클래스의 새 인스턴스를 만들거나 현재 또는 지정된 스키마에서 CLASSIFICATION_PROFILE 클래스의 기존 인스턴스를 바꿉니다.

중요

CREATE OR REPLACE 명령을 실행하면 모든 데이터베이스와 스키마에서 분류 프로필이 제거되어 자동 분류가 꺼집니다.

구문¶

CREATE [ OR REPLACE ] SNOWFLAKE.DATA_PRIVACY.CLASSIFICATION_PROFILE
  [ IF NOT EXISTS ] <classification_profile_name> (  <config_object> )

Copy

매개 변수¶

classification_profile_name

CLASSIFICATION_PROFILE 클래스의 인스턴스에 대한 식별자(이름)를 지정합니다. 오브젝트가 생성되는 스키마에 대해 고유해야 합니다.

또한, 식별자는 알파벳 문자로 시작해야 하며 전체 식별자 문자열을 큰따옴표(예: "My object")로 묶지 않는 한 공백이나 특수 문자를 포함할 수 없습니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

생성자 인자¶

config_object

민감한 데이터 자동 분류를 구성하는 데 사용되는 키-값 페어를 포함하는 OBJECT.

키	타입	기본값	설명
`minimum_object_age_for_` `classification_days`	INTEGER		필수: 오브젝트가 분류되기 위해 존재해야 하는 최소 일수를 지정합니다. 오브젝트를 즉시 분류하려면 `0` 을 지정합니다.
`maximum_classification_` `validity_days`	INTEGER		선택 사항입니다. 자동 분류를 사용하여 테이블이 다시 분류되는 마지막 분류 이벤트 이후 일수를 지정합니다. 테이블이 재분류되도록 하려면 이 값을 지정합니다. 이 키를 생략하면 오브젝트가 다시 분류되지 않습니다. 값은 `1` 보다 크거나 같아야 합니다.
`auto_tag`	BOOLEAN	TRUE	선택 사항: `TRUE` 인 경우, 분류 프로세스가 완료되면 지정된 오브젝트의 열에 권장 분류 시스템 태그를 설정합니다. `FALSE`, 자동 태그 지정이 발생하지 않습니다.
`tag_map`	OBJECT		선택 사항입니다. 하나 이상의 사용자 정의 태그를 SEMANTIC_CATEGORY 시스템 태그에 매핑합니다. 태그 매핑 섹션을 참조하십시오.
`custom_classifiers`	OBJECT		선택 사항: 데이터를 자동으로 분류할 때 사용되는 사용자 지정 분류기 를 지정합니다. 오브젝트의 각 키는 CUSTOM_CLASSIFIER 클래스 의 인스턴스 이름을 지정합니다. 각 키의 값은 사용자 정의 분류기 인스턴스의 custom_classifier !LIST 메서드를 지정합니다.
`enable_tag_based_sensitive_data_exclusion`	BOOLEAN	FALSE	선택 사항: :code:`TRUE`인 경우 SNOWFLAKE.CORE.SKIP_SENSITIVE_DATA_CLASSIFICATION 시스템 태그로 태그가 지정된 오브젝트는 자동 분류에서 제외됩니다. :code:`FALSE`인 경우 태그 기반의 민감한 데이터 제외가 비활성화되고 모든 오브젝트가 시스템 태그와 관계없이 분류됩니다. 자세한 내용은 민감한 데이터 자동 분류에서 데이터 제외 섹션을 참조하십시오.
`classify_views`	BOOLEAN	FALSE	선택 사항: :code:`FALSE`인 경우 뷰는 민감한 데이터 분류에서 제외됩니다. :code:`TRUE`인 경우 뷰는 테이블과 함께 자동으로 분류됩니다.

태그 매핑¶

하나 이상의 사용자 정의 태그를 SEMANTIC_CATEGORY 시스템 태그에 매핑하는 OBJECT.

'column_tag_map': [ ... ]

다음과 같은 키-값 페어를 가진 오브젝트의 배열입니다.

'tag_name': 'string'

태그의 정규화된 이름입니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

'tag_value':'string'

태그의 문자열 값입니다.

선택 사항: 지정하지 않은 경우 semantic_categories 키도 생략해야 합니다. 생략할 경우 tag_name 태그는 SEMANTIC_CATEGORY 시스템 태그가 적용되는 모든 열에 적용되고, 사용자 정의 태그의 값은 SEMANTIC_CATEGORY 태그의 값과 일치합니다.

'semantic_categories': [ 'category' [ , 'category' ... ] ]

SEMANTIC_CATEGORY 시스템 태그에 대한 쉼표로 구분된 카테고리 목록입니다.

tag_name 사용자 정의 태그는 SEMANTIC_CATEGORY 태그의 값이 지정된 카테고리 중 하나인 인스턴스에 매핑됩니다.

선택 사항: 지정하지 않은 경우 tag_value 키도 생략해야 합니다. 생략할 경우 tag_name 태그는 시스템 SEMANTIC_CATEGORY 태그가 적용되는 모든 열에 적용되고, 사용자 정의 태그의 값은 SEMANTIC_CATEGORY 태그의 값과 일치합니다.

액세스 제어 요구 사항¶

이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한/역할	오브젝트
CLASSIFICATION_ADMIN 데이터베이스 역할	해당 없음
CREATE SNOWFLAKE.DATA_PRIVACY.CLASSIFICATION_PROFILE 권한	스키마

Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

메서드¶

생성한 CLASSIFICATION_PROFILE 클래스의 인스턴스에서 다음 메서드를 호출할 수 있습니다.

사용법 노트¶

CREATE OR REPLACE 명령을 실행하면 모든 데이터베이스와 스키마에서 분류 프로필을 제거하여 자동 분류를 끕니다.
이 클래스를 정규화되지 않은 이름으로 참조하려면 검색 경로 에 클래스의 데이터베이스 및 스키마를 포함시킵니다.
동일한 태그와 의미 체계 카테고리가 두 개의 다른 값에 매핑된 경우 column_tag_map 에 있는 오브젝트의 순서에 따라 열에 설정할 태그와 문자열 값이 결정됩니다. column_tag_map 배열을 선호도가 높은 순서부터 선호도가 낮은 순서로 정렬합니다.

예¶

인스턴스를 만들고 데이터베이스에서 테이블을 자동으로 분류하는 기본 기준을 지정합니다.

CREATE OR REPLACE SNOWFLAKE.DATA_PRIVACY.CLASSIFICATION_PROFILE
  my_classification_profile(
    {
      'minimum_object_age_for_classification_days': 0,
      'maximum_classification_validity_days': 30,
      'auto_tag': true,
      'classify_views': true
    });

Copy

인스턴스를 만들고 단일 태그에 대한 태그 매핑을 지정합니다.

CREATE SNOWFLAKE.DATA_PRIVACY.CLASSIFICATION_PROFILE my_classification_profile(
  {
    'minimum_object_age_for_classification_days':0,
    'auto_tag':true,
    'tag_map':{
      'column_tag_map':[
        {
          'tag_name':'tag_db.sch.pii'
        }
      ]
    }
  }
);

Copy

인스턴스를 생성하고 다른 태그 값에 대한 태그 매핑을 지정합니다.

CREATE OR REPLACE SNOWFLAKE.DATA_PRIVACY.CLASSIFICATION_PROFILE
  my_classification_profile(
    {
      'minimum_object_age_for_classification_days':0,
      'auto_tag':true,
      'tag_map': {
        'column_tag_map':[
          {
            'tag_name':'test_ac_db.test_ac_schema.pii',
            'tag_value':'important',
            'semantic_categories':['NAME']
          },
          {
            'tag_name':'test_ac_db.test_ac_schema.pii',
            'tag_value':'pii',
            'semantic_categories':['EMAIL','NATIONAL_IDENTIFIER']
          }
        ]
      }
    }
  );

Copy

인스턴스를 생성하고 자동 분류 프로세스를 위한 사용자 지정 분류자를 지정하십시오.

CREATE SNOWFLAKE.DATA_PRIVACY.CLASSIFICATION_PROFILE my_classification_profile(
  {
    'minimum_object_age_for_classification_days':0,
    'auto_tag':true,
    'custom_classifiers': {
      'medical_codes': medical_codes!list(),
      'finance_codes': finance_codes!list()
    }
  }
);

Copy