ip_host 函数

适用于：检查标记为是 Databricks Runtime 18.2 及更高版本

Important

此功能在 Beta 版中。 工作区管理员可以从 预览 页控制对此功能的访问。 请参阅 Manage Azure Databricks 预览版。

返回 IPv4 或 IPv6 地址的规范表示形式。

Syntax

ip_host ( ip )

Arguments

  • ip：表示STRINGBINARY有效 IPv4 或 IPv6 地址的值。 不允许使用 CIDR 表示法。

Returns

与输入（STRING 或 BINARY）相同的类型，表示地址的规范形式。

如果输入为 NULL.，则函数返回 NULL 。

错误条件

  • 如果输入不是有效的 IPv4 或 IPv6 地址，该函数将返回 INVALID_IP_ADDRESS。

Examples

> SELECT ip_host('192.168.1.5');
  192.168.1.5

> SELECT ip_host('2001:0db8:0000:0000:0000:0000:0000:0001');
  2001:db8::1

> SELECT ip_host('2001:DB8::1');
  2001:db8::1

> SELECT ip_host('::ffff:192.0.2.128');
  ::ffff:192.0.2.128

> SELECT hex(ip_host(X'C0A80101'));
  C0A80101

> SELECT ip_host(NULL);
  NULL

> SELECT ip_host('invalid.ip');
  Error: INVALID_IP_ADDRESS
  • Last updated on