类别:

系统函数 (系统信息)

SYSTEM$GET_SNOWFLAKE_EGRESS_IP_RANGES

对此功能的支持仅适用于 AWS 外部访问。

返回出口 IP 地址范围列表(如无类域间路由 (CIDR) IP 地址),可用于在服务器的 IP 允许列表中表示 Snowflake。

使用此函数获取出口 IP 地址范围列表,以允许外部服务器上的 Snowflake 流量通过。您可以将列表中的 IP 地址添加到外部服务器上的允许列表中,Snowflake 会从外部服务器发起请求。

例如,您可以允许部署在 Snowflake 上的用户定义的函数 (UDFs) 发出的请求能够访问外部服务器上的资源。为此,您需要将 Snowflake 出口 IP 地址添加到服务器的网络防火墙。

返回的列表中的地址会过期。您可以按照 使用出口 IP 地址保护 Snowflake 请求的入口 中所述自动刷新列表。

语法

SYSTEM$GET_SNOWFLAKE_EGRESS_IP_RANGES()
Copy

返回

Returns JSON containing a list of CIDR IP addresses, effective date, and an expiration date for each address. The following example shows what the return value looks like:

SELECT SYSTEM$GET_SNOWFLAKE_EGRESS_IP_RANGES();
Copy
{
  "ipv4_prefix": "153.45.151.0/24",
  "effective": "2025-06-30T23:59:59Z",
  "expires": "2026-08-30T23:59:59Z"
}
Copy

使用说明

关于返回的 CIDR IP 地址范围列表,请记住以下几点:

  • 每个 IP 地址会过期。返回的列表包括 IP 地址及其到期日期和时间。要允许从 Snowflake 继续访问,请使用尚未过期的地址自动刷新允许列表。

    有关更多信息,请参阅 使用出口 IP 地址保护 Snowflake 请求的入口

  • 地址范围限定为 Snowflake 部署的区域。一个区域的地址与另一个区域的地址不同。

  • 地址在该区域的 Snowflake 账户之间共享。换句话说,地址并不是 Snowflake 账户所独有的。