Pular para o conteúdo principal

tente_ip_host

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

info

Beta

Esse recurso está em Beta.

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