try_ip_as_string 函数

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

Important

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

返回 IP 地址或 CIDR 块的规范字符串表示形式。 如果输入无效,则 NULL 返回而不是引发错误。

Syntax

try_ip_as_string ( ip_or_cidr )

参数

  • ip_or_cidr:表示 STRINGBINARY IPv4 或 IPv6 地址或 CIDR 块的值。

Returns

表示 STRING IP 地址或 CIDR 块的规范字符串形式。 对于 BINARY 输入,二进制表示形式将转换为其等效的字符串形式。

如果输入无效NULL,该函数将NULL返回。

Examples

> SELECT try_ip_as_string('192.168.1.1');
  192.168.1.1

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

> SELECT try_ip_as_string('192.168.1.5/24');
  192.168.1.0/24

> SELECT try_ip_as_string(X'C0A80101');
  192.168.1.1

> SELECT try_ip_as_string(X'20010DB8000000000000000000000001');
  2001:db8::1

> SELECT try_ip_as_string('invalid');
  NULL

> SELECT try_ip_as_string(X'');
  NULL

> SELECT try_ip_as_string(NULL);
  NULL