Pular para o conteúdo principal
Última atualização em

tente_ip_host

Aplica-se a: Sim, marcado como certo Databricks Runtime 18.2 e acima

info

Beta

Este recurso está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a este recurso na página de Pré-visualizações . Veja as prévias do Gerenciador Databricks.

Retorna a representação canônica de um endereço IPv4 ou IPv6. Retorna None em vez de gerar um erro se a entrada for inválida.

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

Sintaxe​

Python
from pyspark.databricks.sql import functions as dbf

dbf.try_ip_host(col=<col>)

Parâmetros​

Parâmetro

Tipo

Descrição

col

pyspark.sql.Column ou str

Uma sequência de caracteres ou um valor BINÁRIO representando um endereço IPv4 ou IPv6 válido.

Exemplos​

Exemplo 1 : Validar um endereço IPv4.

Python
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()
Output
[Row(result='192.168.1.5')]

Exemplo 2 : Canonicalizar um endereço IPv6.

Python
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()
Output
[Row(result='2001:db8::1')]

Exemplo 3 : Entrada inválida retorna None.

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

Exemplo 4 : a entrada None retorna None.

Python
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([(None,)], 'ip: string')
df.select(dbf.try_ip_host('ip').alias('result')).collect()
Output
[Row(result=None)]
Nesta página