SYSTEM$CLASSIFY_SCHEMA

각 테이블에서 샘플로 추출할 행 수를 지정하고 지정된 스키마에 저장된 테이블의 각 열에 권장되는 민감한 데이터 분류 시스템 태그 를 할당하는 선택 사항을 사용하여 지정된 스키마의 테이블을 분류하도록 예약합니다.

저장 프로시저의 실행이 완료되면 민감한 데이터를 수동으로 분류 에 표시된 대로 SQL 또는 Snowsight 를 사용하여 테이블 분류를 완료해야 합니다.

구문

SYSTEM$CLASSIFY_SCHEMA( '<schema_name>' , <object> )
Copy

인자

schema_name

분류할 테이블이 포함된 스키마의 이름입니다. 데이터베이스와 스키마가 현재 세션에서 사용되지 않는 경우 이름은 정규화되어야 합니다.

이름은 데이터베이스에 저장된 대로 정확하게 지정해야 합니다. 이름에 특수 문자, 대문자 또는 공백이 포함된 경우 이름은 먼저 큰따옴표로 묶은 다음 작은따옴표로 묶어야 합니다.

object

분류 프로세스 작동 방식을 결정하는 JSON OBJECT 를 지정합니다. 다음 중 하나:

NULL

Snowflake는 지정된 오브젝트의 행 수에 따라 기본 구성을 사용합니다. 지정된 오브젝트의 어떤 열에도 시스템 태그가 설정되지 않았습니다.

{}

NULL 을 지정하는 것과 기능적으로 동일한 빈 오브젝트입니다.

{'sample_count': integer}

지정된 오브젝트에서 샘플링할 행 수를 지정합니다. 1 부터 10000 (포함)까지의 범위에 있는 임의의 숫자입니다.

{'auto_tag': true}

분류 프로세스가 완료되면 지정된 오브젝트의 열에 권장되는 분류 시스템 태그를 설정합니다.

이 인자를 사용하는 경우 스키마에 대한 OWNERSHIP 권한이 있는 역할로 저장 프로시저를 호출하십시오.

{'sample_count': integer, 'auto_tag': true}

샘플링할 행 수를 지정하면서 지정된 오브젝트를 분류하고, 분류 프로세스가 완료되면 지정된 오브젝트의 각 열에 권장 시스템 태그를 설정합니다.

이 인자를 사용하는 경우 스키마에 대한 OWNERSHIP 권한이 있는 역할로 저장 프로시저를 호출하십시오.

{'use_all_custom_classifiers': true}

Snowflake는 모든 사용자 지정 분류 인스턴스를 평가하고 분류 결과에 따라 사용자 지정 분류 인스턴스와 연관된 태그를 추천합니다.

이 옵션은 저장 프로시저(현재 역할, 호출자 권한)를 호출하는 사용 중인 역할에 액세스할 수 있는 사용자 지정 분류자를 사용합니다. 자세한 내용은 호출자 권한 및 소유자 권한 저장 프로시저 이해하기 섹션을 참조하십시오.

{'custom_classifiers': ['instance_name1' [ , 'instance_name2' ... ] ]}

열에 설정할 권장 태그의 원본으로 평가할 사용자 지정 분류 인스턴스를 지정합니다.

목록에 여러 인스턴스를 지정하고 각 인스턴스를 쉼표로 구분할 수 있습니다.

반환

저장 프로시저는 다음 형식으로 JSON 오브젝트를 반환합니다. 예:

{
  "failed": [
    {
      "message": "Insufficient privileges.",
      "table_name": "t4"
    }
  ],
  "succeeded": [
    {
      "table_name": "t1"
    },
    {
      "table_name": "t2"
    },
    {
      "table_name": "t3"
    }
  ]
}
Copy

여기서

failed

테이블의 분류를 예약하지 않은 이유를 제공하는 메시지를 지정합니다.

succeeded

Data Classification을 위해 예약된 각 테이블을 지정합니다.

사용법 노트

  • 지정된 스키마 이름에는 최대 1,000개의 테이블 오브젝트가 포함될 수 있습니다. 스키마에 1,000개 이상의 테이블 오브젝트가 포함된 경우 Snowflake는 오류 메시지를 반환합니다.

  • Snowflake가 제공하는 저장 프로시저는 호출자 권한을 활용합니다. 자세한 내용은 호출자 권한 및 소유자 권한 저장 프로시저 이해하기 섹션을 참조하십시오.

  • 대체 시스템 태그 값을 적용하려면 ALTER TABLE … MODIFY COLUMN … SET TAG 문을 사용하여 태그 값을 업데이트하십시오.

  • 열에서 분류 시스템 태그를 설정 해제하려면 ALTER TABLE … MODIFY COLUMN … UNSET TAG 문을 사용하십시오.

조심

이 저장 프로시저를 호출하면 스키마의 각 테이블에 대한 분류 프로세스가 병렬로 실행되고 웨어하우스 리소스를 사용합니다. 이 저장 프로시저를 단기간에 여러 번 호출하여 스키마에 있는 테이블을 동시에 분류하는 경우 해당 프로세스도 병렬로 실행됩니다. 많은 병렬 분류 프로세스가 웨어하우스 용량을 초과할 수 있으며, 이로 인해 일부 테이블에 대한 분류 프로세스가 실패할 수 있습니다. 따라서 스키마의 일부 테이블은 분류되고 다른 테이블은 분류되지 않을 수 있습니다.

SYSTEM$CLASSIFY_SCHEMA를 호출하기 전에 각 테이블의 열 수, 스키마의 테이블 수, 분류하려는 스키마 수, 세션에 사용 중인 웨어하우스 크기를 계산합니다. 웨어하우스 크기 권장 사항은 민감한 데이터를 수동으로 분류하는 데 드는 비용 섹션을 참조하십시오.

예

스키마의 테이블 분류를 스테이징합니다.

CALL SYSTEM$CLASSIFY_SCHEMA('hr.tables', null);
Copy

스키마에서 테이블 분류를 스테이징하고 샘플링할 행 수를 지정합니다.

CALL SYSTEM$CLASSIFY_SCHEMA('hr.tables', {'sample_count': 1000});
Copy

스키마에서 테이블 분류를 스테이징하고 열에 시스템 태그를 설정합니다.

CALL SYSTEM$CLASSIFY_SCHEMA('hr.tables', {'auto_tag': true});
Copy

스키마에서 테이블 분류를 스테이징하고, 샘플링할 행 수를 지정하고, 테이블의 각 열에 권장 시스템 태그를 설정합니다.

CALL SYSTEM$CLASSIFY_SCHEMA('hr.tables', {'sample_count': 1000, 'auto_tag': true});
Copy
언어: 한국어