try_ip_host

Van toepassing op:controleren gemarkeerd als Ja Databricks Runtime 18.2 en hoger

Important

Deze functie bevindt zich in de bètaversie. Werkruimtebeheerders kunnen de toegang tot deze functie beheren vanaf de pagina Previews . Zie Azure Databricks previews beheren.

Retourneert de canonieke weergave van een IPv4- of IPv6-adres. Retourneert None in plaats van een fout op te geven als de invoer ongeldig is.

Zie de functie voor de bijbehorende SQL-functietry_ip_host.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.try_ip_host(col=<col>)

Parameters

Parameter Typ Description
col pyspark.sql.Column of str Een TEKENREEKS- of BINAIRE waarde die een geldig IPv4- of IPv6-adres vertegenwoordigt.

Examples

Voorbeeld 1: Een IPv4-adres valideren.

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

Voorbeeld 2: Een IPv6-adres canoniseren.

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

Voorbeeld 3: Ongeldige invoer retourneert 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)]

Voorbeeld 4: None invoer retourneert 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)]