try_ip_cidr

適用対象:はい Databricks Runtime 18.2 以降とマークされているチェック

Important

この機能は ベータ版です。 ワークスペース管理者は、[ プレビュー] ページからこの機能へのアクセスを制御できます。 Manage Azure Databricks プレビューを参照してください。

IPv4 または IPv6 CIDR ブロックの正規表現を返します。 入力が無効な場合にエラーを発生させる代わりに、 None を返します。

対応する SQL 関数については、 try_ip_cidr 関数を参照してください。

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.try_ip_cidr(col=<col>)

Parameters

パラメーター タイプ 説明
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.try_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.try_ip_cidr('cidr').alias('result')).collect()
[Row(result='2001:db8::/64')]

例 3: 無効な入力は Noneを返します。

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

例 4: None 入力は Noneを返します。

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