ip_cidr

Aplica-se a: 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 bloco CIDR IPv4 ou IPv6.

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

Sintaxe

Python

from pyspark.databricks.sql import functions as dbf

dbf.ip_cidr(col=<col>)

Parâmetros

Parâmetro	Tipo	Descrição
col	pyspark.sql.Column ou str	Uma string ou valor BINÁRIO representando um bloco CIDR IPv4 ou IPv6 válido.

Exemplos

Exemplo 1 : Canonicalizar um bloco CIDR IPv4.

Python

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

Output

[Row(result='192.168.1.0/24')]

Exemplo 2 : Canonicalizar um bloco CIDR IPv6.

Python

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('2001:db8::1/64',)], ['cidr'])
df.select(dbf.ip_cidr('cidr').alias('result')).collect()

Output

[Row(result='2001:db8::/64')]

Exemplo 3 : Canonicalizar um bloco CIDR em formato binário. A entrada é a representação binária de 192.168.1.5/24.

Python

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

Output

[Row(result='C0A8010018')]

Exemplo 4 : a entrada None retorna None.

Python

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

Output

[Row(result=None)]