ip_cidr

S’applique à :check marqué oui Databricks Runtime 18.2 et versions ultérieures

Important

Cette fonctionnalité est en version bêta.

Retourne la représentation canonique d’un bloc CIDR IPv4 ou IPv6.

Pour la fonction SQL correspondante, consultez ip_cidr la fonction.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.ip_cidr(col=<col>)

Parameters

Paramètre Catégorie Description
col pyspark.sql.Column ou str Valeur STRING ou BINARY représentant un bloc CIDR IPv4 ou IPv6 valide.

Exemples

Exemple 1 : Canonicaliser un bloc 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')]

Exemple 2 : Canonicaliser un bloc 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')]

Exemple 3 : Canonicaliser un bloc CIDR au format binaire. L’entrée est la représentation binaire 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')]

Exemple 4 : None retour d’entrée 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)]