ip_host

Gäller för: Databricks Runtime 18.2 och senare

Viktigt!

Den här funktionen finns i Beta. Arbetsyteadministratörer kan styra åtkomsten till den här funktionen från sidan Förhandsversioner . Se Hantera förhandsversioner av Azure Databricks.

Returnerar den kanoniska representationen av en IPv4- eller IPv6-adress.

För motsvarande SQL-funktion, se ip_host funktion.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.ip_host(col=<col>)

Parameters

Parameter	Type	Description
col	pyspark.sql.Column eller str	Ett STRING- eller BINARY-värde som representerar en giltig IPv4- eller IPv6-adress.

Exempel

Exempel 1: Verifiera en IPv4-adress.

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()

[Row(result='192.168.1.5')]

Exempel 2: Kanonisera en IPv6-adress.

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()

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

Exempel 3: Verifiera en IPv4-mappad IPv6-adress.

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()

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

Exempel 4: Verifiera en IPv4-adress i binärt format. Indata är den binära representationen av IPv4-adressen 192.168.1.5.

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()

[Row(result='C0A80105')]

Exempel 5: None indata returnerar None.

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

[Row(result=None)]