ip_cidr_contains

適用於:已勾選為 Databricks 執行環境 18.2 及以上版本

Important

這項功能位於 測試版 (Beta) 中。

如果某 IP 位址或 CIDR 區塊被包含在另一個 CIDR 區塊中,則會回傳;True否則則回傳False。

關於對應的 SQL 函式,請參見 ip_cidr_contains 函式。

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.ip_cidr_contains(col1=<col1>, col2=<col2>)

Parameters

參數 類型 Description
col1 pyspark.sql.Column 或 str 一個代表有效 IPv4 或 IPv6 CIDR 區塊的 STRING 或 BINARY 值。
col2 pyspark.sql.Column 或 str 一個代表有效 IPv4 或 IPv6 位址或 CIDR 區塊的 STRING 或 BINARY 值。

Examples

範例 1:檢查 IP 位址是否包含在 CIDR 區塊中。

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('192.168.1.0/24', '192.168.1.100')], ['cidr', 'ip'])
df.select(dbf.ip_cidr_contains('cidr', 'ip').alias('result')).collect()
[Row(result=True)]

範例二:檢查較小的 CIDR 區塊是否包含在較大的 CIDR 區塊中。

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('192.168.0.0/16', '192.168.1.0/24')], ['cidr', 'needle'])
df.select(dbf.ip_cidr_contains('cidr', 'needle').alias('result')).collect()
[Row(result=True)]

範例 3: None 輸入回傳 None。

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([(None, '192.168.1.1')], 'cidr: string, ip: string')
df.select(dbf.ip_cidr_contains('cidr', 'ip').alias('result')).collect()
[Row(result=None)]