ip_host

Aplica-se a: Databricks Runtime 18.2 e superior

Importante

Esse recurso está em Beta. Os administradores do workspace podem controlar o acesso a esse recurso na página Visualizações . Consulte Gerenciar visualizações do Azure Databricks.

Retorna a representação canônica de um endereço IPv4 ou IPv6.

Para a função SQL correspondente, consulte ip_host a função.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.ip_host(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.

Exemplos

Exemplo 1: validar um endereço IPv4.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('192.168.1.5',)], ['ipv4'])
df.select(dbf.ip_host('ipv4').alias('result')).collect()

[Row(result='192.168.1.5')]

Exemplo 2: canonizar um endereço IPv6.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('2001:0DB8:0000:0000:0000:0000:0000:0001',)], ['ipv6'])
df.select(dbf.ip_host('ipv6').alias('result')).collect()

[Row(result='2001:db8::1')]

Exemplo 3: validar um endereço IPv6 mapeado por IPv4.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('::ffff:192.0.2.128',)], ['ip'])
df.select(dbf.ip_host('ip').alias('result')).collect()

[Row(result='::ffff:192.0.2.128')]

Exemplo 4: validar um endereço IPv4 no formato binário. A entrada é a representação binária do endereço 192.168.1.5IPv4.

from pyspark.databricks.sql import functions as dbf
from pyspark.sql.functions import hex
df = spark.createDataFrame([(bytearray([0xC0, 0xA8, 0x01, 0x05]),)], ['ip'])
df.select(hex(dbf.ip_host('ip')).alias('result')).collect()

[Row(result='C0A80105')]

Exemplo 5: None retorno de Noneentrada.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([(None,)], 'ip: string')
df.select(dbf.ip_host('ip').alias('result')).collect()

[Row(result=None)]