Pular para o conteúdo principal

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.

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