カテゴリ：: ユーザーとセキュリティ DDL （ネットワークポリシー）

ALTER NETWORK POLICY¶

既存のネットワークポリシーのプロパティを変更します。現在、サポートされているアクションは、アカウントへのアクセスを許可または拒否する IP アドレスの変更と、ネットワークポリシーのコメントの追加/上書き/削除のみです。

注釈

ネットワークポリシーを変更できるのは、ネットワークポリシーの所有者（つまり、ネットワークポリシーの OWNERSHIP 権限を持つロール）以上のみです。

こちらもご参照ください。: CREATE NETWORK POLICY 、 DESCRIBE NETWORK POLICY 、 DROP NETWORK POLICY 、 SHOW NETWORK POLICIES

構文¶

ALTER NETWORK POLICY [ IF EXISTS ] <name> SET { [ ALLOWED_IP_LIST = ( [ '<ip_address>' ] [ , '<ip_address>' ... ] ) ]
                                                [ BLOCKED_IP_LIST = ( [ '<ip_address>' ] [ , '<ip_address>' ... ] ) ]
                                                [ COMMENT = '<string_literal>' ] }

ALTER NETWORK POLICY [ IF EXISTS ] <name> UNSET COMMENT

パラメーター¶

名前: 変更するネットワークポリシーの識別子を指定します。識別子にスペースまたは特殊文字が含まれる場合、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

SET ...

ALLOWED_IP_LIST = ( [ IPアドレス ] [ , IPアドレス , ... ] )
Snowflakeアカウントへのアクセスを許可する IPv4 アドレスのリストを指定します。これは 許可リスト と呼ばれます。Snowflakeは、許可リストに含まれていないすべての IP アドレスを自動的にブロックします。

パラメーターが空のリストで指定されている場合、ネットワークポリシーは、 IPv4 アドレスがSnowflakeにアクセスすることを許可しないことに注意してください。

BLOCKED_IP_LIST = ( [ IPアドレス ] [ , IPアドレス , ... ] )
Snowflakeアカウントへのアクセスを拒否される IPv4 アドレスのリストを指定します。これは ブロックリスト と呼ばれます。

このパラメーターは、 IP アドレスの範囲（ALLOWED_IP_LIST で指定される）へのアクセスを許可するが、その範囲内の1つ以上の IP アドレスへのアクセスを拒否する場合にのみ設定します。

このパラメーターの設定を解除するには、空のリストを指定します。

COMMENT = '文字列リテラル'
ネットワークポリシーのコメントを追加するか、既存のコメントを上書きします。

UNSET ...

ネットワークポリシーの設定を解除するプロパティを指定します。これにより、デフォルトにリセットされます。

現在、設定を解除できるプロパティは COMMENT のみです。これにより、ネットワークポリシーのコメントがあれば削除されます。

使用上の注意¶

許可/ブロックリストの SET アクションは、付加的ではありません（つまり、ネットワークポリシーの既存リストのすべての IP アドレスを削除し、指定されたリストに置き換えます）。

その結果、既存のリストに追加するには、新しい IP アドレスを指定し、さらに既存のリストを複製する必要があります。
各 ipアドレス は、クラスレスドメイン間ルーティング（CIDR）表記を使用してアドレス範囲をカバーできます。

ipアドレス[/任意のプレフィックスの長さ]

例：

192.168.1.0/24
ネットワークポリシーに ALLOWED_IP_LIST と BLOCKED_IP_LIST の両方の値が含まれている場合、Snowflakeは最初にブロックリストを適用します。
0.0.0.0/0 を BLOCKED_IP_LIST に追加しないでください。Snowflakeはブロックされたリストを最初に適用するため、ユーザー自身のアクセスがブロックされます。さらに、選択リストを除くすべての IP アドレスをブロックするには、IP アドレスを ALLOWED_IP_LIST に追加するだけですみます。Snowflakeは、許可リストに含まれていないすべての IP アドレスを自動的にブロックします。
メタデータについて。

注意

Snowflakeサービスを使用する場合、お客様は、個人データ（ユーザーオブジェクト向け以外）、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールドをご参照ください。

例¶

mypolicy1 という名前のネットワークポリシーを変更するには、次の操作を実行します。

CREATE NETWORK POLICY の例で定義されているように、ポリシーの既存の許可リスト（192.168.1.0/24 の範囲内のすべての IP アドレス）およびブロックリスト（192.168.1.99）を保持します。

IP アドレス 192.168.255.100 を許可リストに追加します。

他のすべての IP アドレスを拒否します。
DESC NETWORK POLICY mypolicy1;

+-----------------+----------------+
| name            | value          |
|-----------------+----------------|
| ALLOWED_IP_LIST | 192.168.1.0/24 |
| BLOCKED_IP_LIST | 192.168.1.99   |
+-----------------+----------------+

ALTER NETWORK POLICY mypolicy1 SET ALLOWED_IP_LIST=('192.168.1.0/24','192.168.255.100')
                                   BLOCKED_IP_LIST=('192.168.1.99');

DESC NETWORK POLICY mypolicy1;

+-----------------+--------------------------------+
| name            | value                          |
|-----------------+--------------------------------|
| ALLOWED_IP_LIST | 192.168.1.0/24,192.168.255.100 |
| BLOCKED_IP_LIST | 192.168.1.99                   |
+-----------------+--------------------------------+
注釈

既存の許可リストとブロックリストを保持するには、前のリストのすべての IP アドレスを含める必要があります。