適用於：
執行環境 18.2 及以上版本
Important
這項功能位於 測試版 (Beta) 中。 工作區管理員可以從 「預覽 」頁面控制對此功能的存取。 請參閱 管理 Azure Databricks 預覽。
回傳 IPv4 或 IPv6 CIDR 區塊的典範表示。
關於對應的 SQL 函式，請參見 ip_cidr 函式。
Syntax
from pyspark.databricks.sql import functions as dbf
dbf.ip_cidr(col=<col>)
Parameters
| 參數 | 類型 | Description |
|---|---|---|
col |
pyspark.sql.Column 或 str |
一個代表有效 IPv4 或 IPv6 CIDR 區塊的 STRING 或 BINARY 值。 |
Examples
範例 1：規範化 IPv4 CIDR 區塊。
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('192.168.1.5/24',)], ['cidr'])
df.select(dbf.ip_cidr('cidr').alias('result')).collect()
[Row(result='192.168.1.0/24')]
範例 2：規範化 IPv6 CIDR 區塊。
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('2001:db8::1/64',)], ['cidr'])
df.select(dbf.ip_cidr('cidr').alias('result')).collect()
[Row(result='2001:db8::/64')]
範例 3：以二進位格式規範化 CIDR 區塊。 輸入是 的 192.168.1.5/24二進位表示。
from pyspark.databricks.sql import functions as dbf
from pyspark.sql.functions import hex
df = spark.createDataFrame([(bytearray([0xC0, 0xA8, 0x01, 0x05, 0x18]),)], ['cidr'])
df.select(hex(dbf.ip_cidr('cidr')).alias('result')).collect()
[Row(result='C0A8010018')]
範例 4： None 輸入回傳 None。
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([(None,)], 'cidr: string')
df.select(dbf.ip_cidr('cidr').alias('result')).collect()
[Row(result=None)]