try_ip_host

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

Important

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. Returnerar None i stället för att generera ett fel om indata är ogiltiga.

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

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.try_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',)], ['ip'])
df.select(dbf.try_ip_host('ip').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::1',)], ['ip'])
df.select(dbf.try_ip_host('ip').alias('result')).collect()

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

Exempel 3: Ogiltiga indata returnerar 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)]

Exempel 4: None indata returnerar 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)]