Pular para o conteúdo principal

tente_ip_cidr

Aplica-se a: Sim, marcado como certo 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. 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_cidr.

Sintaxe

Python
from pyspark.databricks.sql import functions as dbf

dbf.try_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.try_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.try_ip_cidr('cidr').alias('result')).collect()
Output
[Row(result='2001:db8::/64')]

Exemplo 3 : Entrada inválida retorna None.

Python
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('invalid.ip/24',)], ['cidr'])
df.select(dbf.try_ip_cidr('cidr').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,)], 'cidr: string')
df.select(dbf.try_ip_cidr('cidr').alias('result')).collect()
Output
[Row(result=None)]