适用于:
Databricks Runtime 18.2 及更高版本
Important
此功能在 Beta 版中。 工作区管理员可以从 预览 页控制对此功能的访问。 请参阅 Manage Azure Databricks 预览版。
如果 TRUE IP 地址或 CIDR 块包含在另一个 CIDR 块中, FALSE 则返回否则。
Syntax
ip_cidr_contains ( cidr, needle )
参数
-
cidr:表示STRINGBINARY有效 CIDR 块的值。 -
needle:表示STRINGBINARY有效 IP 地址或 CIDR 块的值。
允许混合输入类型(STRING 和 BINARY)。
退货
BOOLEAN。
如果TRUE包含在内needle,cidr则返回FALSE;否则返回。
如果任一参数为 NULL.,则函数返回 NULL 。
错误条件
- 如果
cidr不是有效的 CIDR 块,该函数将返回 INVALID_CIDR_BLOCK。 - 如果
needle不是有效的 IP 地址或 CIDR 块,该函数将返回 INVALID_IP_ADDRESS_OR_CIDR_BLOCK。
示例
> SELECT ip_cidr_contains('192.168.1.0/24', '192.168.2.1');
false
> SELECT ip_cidr_contains('2001:db8::/32', '2001:db8::1');
true
> SELECT ip_cidr_contains('::ffff:192.168.1.0/120', '192.168.1.100');
true
> SELECT ip_cidr_contains(X'C0A8010018', X'C0A80164');
true
> SELECT ip_cidr_contains('192.168.1.0/24', X'C0A80164');
true
> SELECT ip_cidr_contains(NULL, '192.168.1.1');
NULL
> SELECT ip_cidr_contains('192.168.1.0/24', NULL);
NULL
> SELECT ip_cidr_contains(NULL, NULL);
NULL
> SELECT ip_cidr_contains('invalid', '192.168.1.1');
Error: INVALID_CIDR_BLOCK