try_ip_host

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

Important

Dieses Feature befindet sich in der Betaversion. Arbeitsbereichsadministratoren können den Zugriff auf dieses Feature über die Vorschauseite steuern. Siehe Manage Azure Databricks Previews.

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