try_ip_host

Gilt für:check marked yes Databricks Runtime 18.2 und höher

Important

Dieses Feature befindet sich in der Betaversion.

Gibt die kanonische Darstellung einer IPv4- oder IPv6-Adresse zurück. Gibt einen None Fehler zurück, anstatt einen Fehler zu auslösen, wenn die Eingabe ungültig ist.

Informationen zur entsprechenden SQL-Funktion finden Sie unter try_ip_host Funktion.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.try_ip_host(col=<col>)

Parameters

Parameter Typ Description
col pyspark.sql.Column oder str Ein STRING- oder BINARY-Wert, der eine gültige IPv4- oder IPv6-Adresse darstellt.

Beispiele

Beispiel 1: Überprüfen einer IPv4-Adresse.

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')]

Beispiel 2: Kanonisieren einer IPv6-Adresse.

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')]

Beispiel 3: Ungültige Eingabe gibt zurück 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)]

Beispiel 4: None Eingabe gibt zurück 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)]