ip_cidr

Aplica-se a:sim, Databricks Runtime 18.2 e superiores

Importante

Este recurso está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a esse recurso na página Visualizações . Ver Gerir as pré-visualizações de Azure Databricks.

Devolve a representação canónica de um bloco CIDR IPv4 ou IPv6.

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

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.ip_cidr(col=<col>)

Parameters

Parâmetro Tipo Description
col pyspark.sql.Column ou str Um valor STRING ou BINARY que representa um bloco CIDR IPv4 ou IPv6 válido.

Examples

Exemplo 1: Canonizar um bloco CIDR IPv4.

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()
[Row(result='192.168.1.0/24')]

Exemplo 2: Canonize um bloco CIDR IPv6.

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()
[Row(result='2001:db8::/64')]

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

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()
[Row(result='C0A8010018')]

Exemplo 4: None entrada devolve None.

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