適用於：
執行環境 18.2 及以上版本
Important
這項功能位於 測試版 (Beta) 中。 工作區管理員可以從 「預覽 」頁面控制對此功能的存取。 請參閱 管理 Azure Databricks 預覽。
回傳 IPv4 或 IPv6 位址的典範表示。 如果輸入無效，則會回傳 None 而非產生錯誤。
關於對應的 SQL 函式，請參見 try_ip_host 函式。
Syntax
from pyspark.databricks.sql import functions as dbf
dbf.try_ip_host(col=<col>)
Parameters
| 參數 | 類型 | Description |
|---|---|---|
col |
pyspark.sql.Column 或 str |
一個代表有效 IPv4 或 IPv6 位址的 STRING 或 BINARY 值。 |
Examples
範例 1：驗證一個 IPv4 位址。
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('192.168.1.5',)], ['ip'])
df.select(dbf.try_ip_host('ip').alias('result')).collect()
[Row(result='192.168.1.5')]
範例 2：將 IPv6 位址標準化。
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('2001:0db8::1',)], ['ip'])
df.select(dbf.try_ip_host('ip').alias('result')).collect()
[Row(result='2001:db8::1')]
範例 3：無效輸入回傳 None。
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('invalid.ip',)], ['ip'])
df.select(dbf.try_ip_host('ip').alias('result')).collect()
[Row(result=None)]
範例 4： None 輸入回傳 None。
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([(None,)], 'ip: string')
df.select(dbf.try_ip_host('ip').alias('result')).collect()
[Row(result=None)]