try_ip_as_string

Aplica-se a:sim, Databricks Runtime 18.2 e superiores

Importante

Este recurso está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a esse recurso na página Visualizações . Ver Gerir as pré-visualizações de Azure Databricks.

Devolve a representação canónica da cadeia de um endereço IP ou bloco CIDR. Retorna None em vez de gerar um erro se a entrada for inválida.

Para a função SQL correspondente, veja try_ip_as_string função.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.try_ip_as_string(col=<col>)

Parameters

Parâmetro Tipo Description
col pyspark.sql.Column ou str Um valor STRING ou BINARY que representa um endereço IPv4 ou IPv6 válido ou um bloco CIDR.

Examples

Exemplo 1: Converter um endereço IPv4 em string.

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

Exemplo 2: Converter um endereço IPv6 em string.

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

Exemplo 3: Converter um bloco CIDR em string.

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

Exemplo 4: Entrada inválida devolve 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)]

Exemplo 5: None entrada devolve 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)]
  • Last updated on