try_ip_as_string

Si applica a:check contrassegnato come sì Databricks Runtime 18.2 e versioni successive

Importante

Questa funzionalità è in versione beta. Gli amministratori dell'area di lavoro possono controllare l'accesso a questa funzionalità dalla pagina Anteprime . Vedere Gestire le anteprime di Azure Databricks.

Restituisce la rappresentazione di stringa canonica di un indirizzo IP o di un blocco CIDR. Restituisce None anziché generare un errore se l'input non è valido.

Per la funzione SQL corrispondente, vedere try_ip_as_string funzione.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.try_ip_as_string(col=<col>)

Parameters

Parametro Tipo Description
col pyspark.sql.Column oppure str Valore STRING o BINARY che rappresenta un indirizzo IPv4 o IPv6 valido o un blocco CIDR.

Examples

Esempio 1: Convertire un indirizzo IPv4 in stringa.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('192.168.1.1',)], ['ip'])
df.select(dbf.try_ip_as_string('ip').alias('result')).collect()
[Row(result='192.168.1.1')]

Esempio 2: Convertire un indirizzo IPv6 in stringa.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('2001:db8::1',)], ['ip'])
df.select(dbf.try_ip_as_string('ip').alias('result')).collect()
[Row(result='2001:db8::1')]

Esempio 3: Convertire un blocco CIDR in stringa.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('192.168.1.5/24',)], ['cidr'])
df.select(dbf.try_ip_as_string('cidr').alias('result')).collect()
[Row(result='192.168.1.0/24')]

Esempio 4: l'input non valido restituisce None.

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

Esempio 5: None l'input restituisce None.

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