카테고리:

문자열 및 이진 함수 (AI 함수)

AI_REDACT

비정형 텍스트 데이터의 개인 식별 정보(PII)를 감지하고 수정합니다.

구문

AI_REDACT를 사용하여 PII를 감지하고 수정합니다.

AI_REDACT( <input> [, <categories> ] [, <return_error_details> ] [, <mode> ] )
Copy

인자

필수:

input

개인 식별 정보(PII)를 포함할 수 있는 텍스트 데이터가 포함된 VARCHAR 값입니다.

선택 사항:

categories

수정할 PII 유형을 지정하는 문자열 값의 ARRAY입니다. 지정하지 않으면 지원되는 모든 PII 카테고리가 수정됩니다. 지원되는 카테고리 목록은 PII 카테고리 감지 섹션을 참조하세요.

지원되지 않는 카테고리를 전달하면 오류가 발생합니다.

return_error_details

오류 발생 시 오류 세부 정보를 반환할지 여부를 나타내는 BOOLEAN 플래그입니다. TRUE로 설정하는 경우 함수는 해당 값 및 오류 메시지가 포함된 OBJECT를 반환하며, 그중 하나는 함수의 성공 여부에 따라 NULL이 됩니다.

세션 매개 변수 AI_SQL_ERROR_HANDLING_USE_FAIL_ON_ERROR를 FALSE로 설정해야 합니다.

mode

작동 모드를 지정하는 VARCHAR 값입니다. 허용되는 값:

  • ``redact``(기본값): 감지된 PII를 [NAME] 및 [ADDRESS]와 같은 카테고리 자리 표시자로 바꿉니다.

  • detect: 텍스트를 수정하지 않고 감지된 각 PII 인스턴스의 위치 및 카테고리를 식별하는 spans 배열이 포함된 OBJECT를 반환합니다.

참고

mode 인자는 대소문자를 구분하지 않습니다.

반환

AI_REDACT의 반환 값은 mode 인자에 따라 다릅니다.

수정 모드(기본값)

입력 텍스트에서 PII를 카테고리 자리 표시자로 대체한 VARCHAR를 반환합니다(예: 입력 텍스트가 “John Smith”였던 경우 [NAME]).

감지 모드

spans 배열이 포함된 OBJECT를 반환합니다. 배열의 각 요소는 다음 필드가 있는 OBJECT입니다.

  • category: PII 카테고리(예: NAME 또는 ADDRESS)를 식별하는 VARCHAR 값입니다.

  • start: 입력 텍스트에서 PII의 시작 인덱스를 식별하는 NUMBER 값입니다.

  • end: 입력 텍스트에서 PII의 종료 인덱스를 식별하는 NUMBER 값입니다.

  • text: 일치된 VARCHAR 텍스트가 포함된 PII 값입니다.

오류 동작

기본적으로 AI_REDACT가 입력을 처리할 수 없는 경우, 함수는 오류를 반환합니다. 쿼리가 여러 행을 처리하는 경우 전체 쿼리가 실패합니다.

AI_SQL_ERROR_HANDLING_USE_FAIL_ON_ERROR가 FALSE로 설정된 경우 오류 시 반환 값은 return_error_details 인자에 따라 다릅니다. 다음 테이블은 return_error_details 인자를 기반으로 한 반환 값을 보여줍니다.

return_error_details

반환 값

설명
FALSE

성공하지 않음

NULL

TRUE

value 및 error 필드를 포함한 OBJECT
value: 수정된 텍스트가 포함된 VARCHAR 값이거나 오류가 발생한 경우 NULL입니다.

error: 오류가 발생한 경우 오류 메시지가 포함된 VARCHAR 값이거나 함수가 성공한 경우 NULL입니다.

오류 처리에 대한 자세한 내용은 다중 행 쿼리에서 행 수준 오류 처리 섹션을 참조하세요.

사용법 노트

  • AI_REDACT로 수정할 수 있는 PII 카테고리의 경우 PII 카테고리 감지 섹션을 참조하세요.

  • 현재 AI_REDACT 버전의 제한 사항에 대해서는 제한 사항 섹션을 참조하세요.

예

수정 예제 섹션을 참조하십시오.