SYSTEM$OPT_OUT_MALICIOUS_IP_PROTECTION_BY_CATEGORY
SYSTEM$OPT_OUT_MALICIOUS_IP_PROTECTION_BY_CATEGORY
현재 계정에서 하나 이상의 큐레이션된 IP 카테고리(curated IP category)에 대한 악성 IP 보호(Malicious IP Protection)를 비활성화하는 시스템 함수예요. 카테고리를 기준으로 차단되었을 트래픽을 허용하려면 이 함수를 사용해요. 예를 들어 저위험(low-risk)으로 분류된 IP 주소 차단을 해제하거나, 특정 사용자의 주소 차단을 해제할 수 있어요.
본문
Syntax
SYSTEM$OPT_OUT_MALICIOUS_IP_PROTECTION_BY_CATEGORY( '<category>,<category>' [ , '<user_name>' ] )
Arguments
필수:
'category':
옵트아웃(opt out)하려는 큐레이션된 IP 카테고리를 식별하는 대소문자를 구분하지 않는 문자열이에요.
허용 값: ANONYMOUS_VPN ANONYMOUS_PROXIES MALICIOUS_BEHAVIOR TOR_EXITS ''
이 카테고리들의 정의는 Malicious IP Protection을 참고하세요.
선택:
'user_name':
지정한 카테고리에 대해 악성 IP 보호를 옵트아웃할 사용자 이름을 지정하는 문자열이에요. 사용자를 제공하지 않으면 옵트아웃이 계정의 모든 사용자에게 적용돼요.
Returns
지정한 카테고리와, 제공된 경우 사용자에 대해 악성 IP 보호가 계정에서 비활성화되었음을 나타내는 VARCHAR 상태 메시지를 반환해요.
Access control requirements
계정 관리자, 즉 ACCOUNTADMIN 역할을 가진 사용자만 이 함수를 실행할 수 있어요.
Usage notes
- 변경 사항이 Snowflake 컨트롤 플레인(control plane) 전체에 전파되는 데 시간이 걸릴 수 있어요.
- 옵트아웃하면 선택한 트래픽 카테고리에 대한 보호가 줄어들어요. 신중하게 사용하고 정기적으로 검토하세요.
- 이 함수를 호출할 때마다 이전 호출의 결과를 덮어써요.
- 모든 카테고리에 대한 차단을 다시 활성화하려면 카테고리 인자로
''를 전달해요. - 차단된 연결 시도를 검토하려면 LOGIN_HISTORY 뷰를 조회하세요.
IS_SUCCESS = 'NO',ERROR_CODE = 390422,ERROR_MESSAGE = 'INCOMING_REQUEST_BLOCKED'인 행을 찾아 해당 행의 LOGIN_DETAILS 열 출력을 검토하세요.
Examples
ANONYMOUS_VPN과 MALICIOUS_BEHAVIOR 카테고리의 모든 IP에 대한 보호 비활성화하기:
USE ROLE ACCOUNTADMIN;
SELECT SYSTEM$OPT_OUT_MALICIOUS_IP_PROTECTION_BY_CATEGORY('ANONYMOUS_VPN,MALICIOUS_BEHAVIOR');
+-------------------------------------------------------------------------------------------------+
| Successfully set malicious IP protection opt-out categories to ANONYMOUS_VPN,MALICIOUS_BEHAVIOR |
+-------------------------------------------------------------------------------------------------+
ANONYMOUS_VPN 카테고리의 특정 사용자에 대한 보호 비활성화하기:
USE ROLE ACCOUNTADMIN;
SELECT SYSTEM$OPT_OUT_MALICIOUS_IP_PROTECTION_BY_CATEGORY('ANONYMOUS_VPN', 'JSMITH');
+----------------------------------------------------------------------------------------------+
| Successfully set malicious IP protection opt-out categories to ANONYMOUS_VPN for user JSMITH |
+----------------------------------------------------------------------------------------------+
특정 사용자에 대한 보호 다시 활성화하기:
USE ROLE ACCOUNTADMIN;
SELECT SYSTEM$OPT_OUT_MALICIOUS_IP_PROTECTION_BY_CATEGORY('', 'JSMITH');
+---------------------------------------------------------------------------------+
| Successfully cleared malicious IP protection opt-out categories for user JSMITH |
+---------------------------------------------------------------------------------+