类别:

系统函数 (系统信息)

SYSTEM$GET_SNOWFLAKE_EGRESS_IP_RANGES

使用 Snowflake 生成的出口 IP 地址,您可以允许从以下 Snowflake 功能进行入口访问:

  • 从 UDFs 和过程进行外部访问

  • Snowpark Container Services 外部访问和 Snowpark Container Services 上的 Snowflake Openflow

  • Snowflake Git 集成(与受 IP 限制的 Git 服务器配合使用)

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

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

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

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

语法

SYSTEM$GET_SNOWFLAKE_EGRESS_IP_RANGES()

返回

返回 JSON,其中包含 CIDR IP 地址列表和每个地址的生效日期和过期日期。以下示例显示了返回值的样式:

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

使用说明

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

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

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

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

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