適用於:
執行環境 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)]