try_ip_cidr

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

Important

Cette fonctionnalité est en version bêta. Les administrateurs d’espace de travail peuvent contrôler l’accès à cette fonctionnalité à partir de la page Aperçus . Consultez Gérer les préversions d’Azure Databricks.

Retourne la représentation canonique d’un bloc CIDR IPv4 ou IPv6. Retourne None au lieu de déclencher une erreur si l’entrée n’est pas valide.

Pour la fonction SQL correspondante, consultez try_ip_cidr la fonction.

Syntax

from pyspark.databricks.sql import functions as dbf

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

Examples

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

Exemple 3 : retour d’entrée Nonenon valide .

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

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.try_ip_cidr('cidr').alias('result')).collect()
[Row(result=None)]