try_ip_host

Se aplica a:check marcado yes Databricks Runtime 18.2 y versiones posteriores

Important

Esta característica se encuentra en su versión beta. Los administradores del área de trabajo pueden controlar el acceso a esta característica desde la página Vistas previas . Consulte Administrar versiones preliminares de Azure Databricks.

Devuelve la representación canónica de una dirección IPv4 o IPv6. Devuelve None en lugar de generar un error si la entrada no es válida.

Para obtener la función SQL correspondiente, consulte try_ip_host función .

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.try_ip_host(col=<col>)

Parameters

Parámetro Tipo Description
col pyspark.sql.Column o str Valor STRING o BINARY que representa una dirección IPv4 o IPv6 válida.

Ejemplos

Ejemplo 1: Validar una dirección IPv4.

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

Ejemplo 2: Canónico de una dirección IPv6.

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

Ejemplo 3: La entrada no válida devuelve 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)]

Ejemplo 4: None la entrada devuelve 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)]