CREATE CLASSIFICATION_PROFILE¶

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

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

구문¶

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	FALSE	선택 사항: `TRUE` 인 경우, 분류 프로세스가 완료되면 지정된 오브젝트의 열에 권장 분류 시스템 태그를 설정합니다. `FALSE`, 자동 태그 지정이 발생하지 않습니다.
`tag_map`	OBJECT		선택 사항입니다. 하나 이상의 사용자 정의 태그를 SEMANTIC_CATEGORY 시스템 태그에 매핑합니다. 태그 매핑 섹션을 참조하십시오.
`custom_classifiers`	OBJECT		선택 사항: 데이터를 자동으로 분류할 때 사용되는 사용자 지정 분류기 를 지정합니다. 오브젝트의 각 키는 CUSTOM_CLASSIFIER 클래스 의 인스턴스 이름을 지정합니다. 각 키의 값은 사용자 정의 분류기 인스턴스의 custom_classifier !LIST 메서드를 지정합니다.

태그 매핑¶

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

'column_tag_map': [ ... ]

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

'tag_name': 'string'

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

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

'tag_value':'string'

태그의 문자열 값입니다.

선택 사항: 지정하지 않으면 태그 값이 SYSTEM$CLASSIFY 의 출력에 있는 권장 값에 매핑됩니다.

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

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

이 값을 사용하면 열에 설정할 태그 및 문자열 값을 지정할 수 있습니다.

선택 사항: 지정하지 않으면 태그가 SYSTEM$CLASSIFY 의 출력에서 권장 태그에 매핑됩니다.

액세스 제어 요구 사항¶

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

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

스키마의 모든 오브젝트에 대해 작업을 수행하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한.

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

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

메서드¶

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

사용법 노트¶

이 클래스를 정규화되지 않은 이름으로 참조하려면 검색 경로 에 클래스의 데이터베이스 및 스키마를 포함시킵니다.

동일한 태그와 의미 체계 카테고리가 두 개의 다른 값에 매핑된 경우 column_tag_map 에 있는 오브젝트의 순서에 따라 열에 설정할 태그와 문자열 값이 결정됩니다. column_tag_map 배열을 선호도가 높은 순서부터 선호도가 낮은 순서로 정렬합니다.

예¶

인스턴스를 만들고 스키마에서 테이블을 자동으로 분류하는 기본 기준을 지정하십시오.

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

Copy

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

CREATE OR REPLACE SNOWFLAKE.DATA_PRIVACY.CLASSIFICATION_PROFILE my_classification_profile(
  {
    'minimum_object_age_for_classification_days':1,
    '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':1,
      '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 OR REPLACE SNOWFLAKE.DATA_PRIVACY.CLASSIFICATION_PROFILE my_classification_profile(
  {
    'minimum_object_age_for_classification_days':1,
    'auto_tag':true,
    'custom_classifiers': {
      'medical_codes': medical_codes!list(),
      'finance_codes': finance_codes!list()
    }
  }
);

Copy