try_ip_host 函数

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

Important

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

返回 IPv4 或 IPv6 地址的规范表示形式。 如果输入无效，则 NULL 返回而不是引发错误。

Syntax

try_ip_host ( ip )

参数

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

Returns

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

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

Examples

> SELECT try_ip_host('192.168.1.5');
  192.168.1.5

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

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

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

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

> SELECT try_ip_host('invalid');
  NULL

> SELECT try_ip_host(X'');
  NULL

> SELECT try_ip_host(NULL);
  NULL
  • Last updated on