try_ip_as_string

対象: Databricks Runtime 18.2以降

備考

ベータ版

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

IPアドレスまたはCIDRブロックの正規化された文字列表現を返します。入力が無効な場合、エラーを発生させる代わりにNoneを返します。

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

構文

Python
from pyspark.databricks.sql import functions as dbf

dbf.try_ip_as_string(col=<col>)

パラメーター

パラメーター	Type	説明
`col`	`pyspark.sql.Column` または `str`	有効な IPv4 アドレスまたは IPv6 アドレス、あるいは CIDR ブロックを表す文字列またはバイナリ値。

例

例1 ：IPv4アドレスを文字列に変換する。

Python
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('192.168.1.1',)], ['ip'])
df.select(dbf.try_ip_as_string('ip').alias('result')).collect()

Output
[Row(result='192.168.1.1')]

例2 ：IPv6アドレスを文字列に変換する。

Python
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('2001:db8::1',)], ['ip'])
df.select(dbf.try_ip_as_string('ip').alias('result')).collect()

Output
[Row(result='2001:db8::1')]

例3 ：CIDRブロックを文字列に変換する。

Python
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('192.168.1.5/24',)], ['cidr'])
df.select(dbf.try_ip_as_string('cidr').alias('result')).collect()

Output
[Row(result='192.168.1.0/24')]

例4 ：無効な入力はNoneを返します。

Python
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('invalid.ip',)], ['ip'])
df.select(dbf.try_ip_as_string('ip').alias('result')).collect()

Output
[Row(result=None)]

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

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

Output
[Row(result=None)]

構文​

パラメーター​

例​

構文

パラメーター

例