ip_host

対象: Databricks Runtime 18.2以降

備考

ベータ版

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

IPv4アドレスまたはIPv6アドレスの正規表現を返します。

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

構文

Python

from pyspark.databricks.sql import functions as dbf

dbf.ip_host(col=<col>)

パラメーター

パラメーター	Type	説明
col	pyspark.sql.Column または str	有効なIPv4またはIPv6アドレスを表す文字列またはバイナリ値。

例

例1 ：IPv4アドレスを検証する。

Python

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('192.168.1.5',)], ['ipv4'])
df.select(dbf.ip_host('ipv4').alias('result')).collect()

Output

[Row(result='192.168.1.5')]

例2 ：IPv6アドレスを正規化する。

Python

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('2001:0DB8:0000:0000:0000:0000:0000:0001',)], ['ipv6'])
df.select(dbf.ip_host('ipv6').alias('result')).collect()

Output

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

例3 ：IPv4マップドIPv6アドレスを検証する。

Python

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('::ffff:192.0.2.128',)], ['ip'])
df.select(dbf.ip_host('ip').alias('result')).collect()

Output

[Row(result='::ffff:192.0.2.128')]

例4 ：IPv4アドレスをバイナリ形式で検証する。入力は、IPv4アドレス192.168.1.5のバイナリ表現です。

Python

from pyspark.databricks.sql import functions as dbf
from pyspark.sql.functions import hex
df = spark.createDataFrame([(bytearray([0xC0, 0xA8, 0x01, 0x05]),)], ['ip'])
df.select(hex(dbf.ip_host('ip')).alias('result')).collect()

Output

[Row(result='C0A80105')]

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

Python

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

Output

[Row(result=None)]