try_ip_as_binary 函数

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

Important

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

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

Syntax

try_ip_as_binary ( ip_or_cidr )

参数

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

Returns

表示 BINARY IP 地址或 CIDR 块的规范二进制形式。 IPv4 地址表示为 4 个字节,IPv6 地址表示为 16 个字节,CIDR 块包含前缀长度的其他字节。

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

Examples

> SELECT hex(try_ip_as_binary('192.168.1.1'));
  C0A80101

> SELECT hex(try_ip_as_binary('192.168.1.5/24'));
  C0A8010018

> SELECT hex(try_ip_as_binary('2001:db8::1'));
  20010DB8000000000000000000000001

> SELECT hex(try_ip_as_binary('::ffff:192.168.1.1'));
  00000000000000000000FFFFC0A80101

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

> SELECT try_ip_as_binary('invalid');
  NULL

> SELECT try_ip_as_binary(X'');
  NULL

> SELECT try_ip_as_binary(NULL);
  NULL