네트워크 규칙

네트워크 규칙은 네트워크 식별자를 논리 단위로 그룹화하는 스키마 수준 오브젝트입니다.

네트워크 트래픽을 제한하는 Snowflake 기능은 기능에서 직접 네트워크 식별자를 정의하는 대신 네트워크 규칙을 참조할 수 있습니다. 예를 들어 네트워크 정책은 IP 주소를 포함하는 네트워크 규칙을 참조하여 이러한 주소를 기반으로 Snowflake 서비스와 내부 스테이지에 대한 액세스를 제어할 수 있습니다. UDF 또는 프로시저에서 외부 네트워크 위치에 액세스할 때 네트워크 규칙을 사용할 수도 있습니다.

네트워크 규칙은 해당 식별자를 허용하거나 차단할지 여부를 정의하지 않습니다. 네트워크 규칙을 사용하는 Snowflake 기능은 규칙의 식별자가 허용되거나 금지되는지 여부를 지정합니다.

지원되는 네트워크 식별자

관리자는 요청의 원본 또는 대상과 관련된 네트워크 식별자를 기반으로 액세스를 제한할 수 있어야 합니다. 관리자는 네트워크 규칙을 통해 다음 네트워크 식별자를 허용하거나 차단할 수 있습니다.

수신 요청
발신 요청

선택적 포트 범위를 포함한 도메인

각 네트워크 규칙에는 동일한 유형의 네트워크 식별자 하나 이상으로 구성된 목록이 포함됩니다. 네트워크 규칙의 TYPE 속성은 규칙에 포함된 식별자 유형을 나타냅니다. 예를 들어 TYPE 속성이 IPV4 인 경우에는 네트워크 규칙의 값 목록에 CIDR 표기법으로 표시된 유효한 IPv4 주소 또는 주소 범위가 포함되어야 합니다.

수신 요청 또는 발신 요청

네트워크 규칙의 모드는 해당 규칙을 사용하는 Snowflake 기능이 수신 요청이나 발신 요청을 제한하는지 여부를 나타냅니다.

수신 요청

네트워크 정책 은 Snowflake 서비스와 내부 스테이지를 수신 트래픽으로부터 보호합니다. 네트워크 규칙이 네트워크 정책과 함께 사용되는 경우 관리자는 모드를 다음 중 하나로 설정할 수 있습니다.

INGRESS

INGRESS 모드의 동작은 네트워크 규칙의 TYPE 속성값에 따라 달라집니다.

  • TYPE=IPV4 인 경우 기본적으로 네트워크 규칙은 Snowflake 서비스에 대한 액세스만 제어합니다.

    계정 관리자가 ENFORCE_NETWORK_RULES_FOR_INTERNAL_STAGES 매개 변수를 활성화하면 MODE=INGRESSTYPE=IPV4 는 AWS 내부 스테이지도 보호합니다.

  • TYPE=AWSVPCEID 인 경우 네트워크 규칙은 Snowflake 서비스에 대한 액세스만 제어합니다.

    인터페이스 엔드포인트의 VPCE ID를 기반으로 AWS 내부 스테이지에 대한 액세스를 제한하려면 INTERNAL_STAGE 모드를 사용하여 별도의 네트워크 규칙을 만들어야 합니다.

INTERNAL_STAGE

Snowflake 서비스에 대한 액세스를 제한하지 않고 AWS 내부 스테이지에 대한 액세스를 제어합니다. 이 모드를 사용하려면 다음이 필요합니다.

Microsoft Azure 계정의 경우 네트워크 규칙을 사용하여 내부 스테이지에 대한 액세스를 제한할 수 없습니다. 하지만 내부 스테이지에 액세스하지 못하도록 모든 공용 네트워크 트래픽을 차단 할 수 있습니다.

발신 요청

관리자는 요청을 전송할 수 있는 위치를 제어하는 기능과 함께 네트워크 규칙을 사용할 수 있습니다. 이러한 경우 관리자는 다음 모드로 네트워크 규칙을 정의합니다.

EGRESS

Snowflake를 발신 위치로 해서 전송되는 트래픽에 네트워크 규칙이 사용됨을 나타냅니다.

현재, UDF 또는 프로시저가 외부 네트워크 위치에 요청을 보낼 수 있도록 하는 외부 네트워크 액세스 와 함께 사용됩니다.

네트워크 규칙 만들기

관리자는 네트워크 식별자와 식별자 유형의 목록을 지정하여 CREATE NETWORK RULE 명령을 실행함으로써 새 네트워크 규칙을 만듭니다.

관리자는 MODE 매개 변수를 사용하여 수신 요청이나 발신 요청을 제한하는 데 네트워크 규칙을 사용할지 여부를 나타냅니다. 관리자가 MODE 매개 변수를 포함하지 않을 경우 기본값은 INGRESS 이며, 이는 네트워크 정책에서 네트워크 규칙을 사용해 Snowflake 서비스로 수신되는 네트워크 트래픽을 제한한다는 의미입니다.

네트워크 규칙을 만든다고 해서 네트워크 식별자를 허용하거나 차단할지 여부가 정의되는 것은 아닙니다. 관리자는 네트워크 규칙을 사용하는 Snowflake 기능을 구성할 때 이러한 제한 사항을 지정합니다.

예: 네트워크 정책에 대한 네트워크 규칙

다음 예제의 코드는 사용자 지정 역할을 사용하여 IP 주소 범위에서 Snowflake 서비스로의 트래픽을 허용하거나 차단하는 데 사용할 수 있는 네트워크 규칙을 만듭니다.

CREATE ROLE network_admin;
GRANT USAGE ON DATABASE securitydb TO ROLE network_admin;
GRANT USAGE ON SCHEMA securitydb.myrules TO ROLE network_admin;
GRANT CREATE NETWORK RULE ON SCHEMA securitydb.myrules TO ROLE network_admin;
USE ROLE network_admin;

CREATE NETWORK RULE cloud_network
  MODE = INGRESS
  TYPE = IPV4
  VALUE_LIST = ('47.88.25.32/27');
Copy

IPv4 주소

네트워크 규칙에 대해 IP 주소를 지정할 때 Snowflake는 CIDR(Classless Inter-Domain Routing) 표기법 을 사용하여 IP 주소 범위를 지원합니다.

예를 들어, 192.168.1.0/24192.168.1.0 ~ 192.168.1.255 범위의 모든 IPv4 주소를 나타냅니다.

네트워크 규칙 수정하기

네트워크 규칙의 소유자는 ALTER NETWORK RULE 명령을 실행하여 규칙의 네트워크 식별자와 설명을 바꿀 수 있습니다. 네트워크 규칙에 개별 네트워크 식별자를 추가하거나 제거할 수 없습니다. 새 값을 추가하면 기존 식별자가 손실됩니다.

네트워크 규칙의 TYPEMODE 는 수정할 수 없습니다.

예를 들어, 네트워크 규칙의 소유자는 규칙을 수정하여 새로운 IPv4 주소 범위에서 수신되는 트래픽을 허용하거나 차단하는 데 사용할 수 있습니다.

ALTER NETWORK RULE cloud_network SET VALUE_LIST = ('47.88.25.32/27');
Copy

네트워크 규칙의 소유자는 규칙에서 모든 네트워크 식별자를 제거할 수도 있습니다.

ALTER NETWORK RULE cloud_network UNSET VALUE_LIST;
Copy

네트워크 규칙 복제

네트워크 규칙은 스키마 수준 오브젝트이며 해당 오브젝트가 포함된 데이터베이스와 함께 복제됩니다.

네트워크 규칙을 사용하는 네트워크 정책의 복제에 대한 자세한 내용은 네트워크 정책 복제하기 섹션을 참조하십시오.

권한과 명령

명령

권한

설명

CREATE NETWORK RULE

SCHEMA에 대한 CREATE NETWORK RULE

새 네트워크 규칙을 만듭니다.

ALTER NETWORK RULE

NETWORK RULE에 대한 OWNERSHIP

기존 네트워크 규칙을 수정합니다.

DROP NETWORK RULE

NETWORK RULE에 대한 OWNERSHIP

시스템에서 기존 네트워크 규칙을 제거합니다.

DESCRIBE NETWORK RULE

NETWORK RULE에 대한 OWNERSHIP

기존 네트워크 규칙의 속성을 설명합니다.

SHOW NETWORK RULES

NETWORK RULE에 대한 OWNERSHIP 또는 SCHEMA에 대한 USAGE

시스템의 모든 네트워크 규칙을 나열합니다.