Pular para o conteúdo principal

ip_cidr

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 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.

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