try_ip_cidr

Gäller för:check markerat ja Databricks Runtime 18.2 och senare

Important

Den här funktionen finns i Beta. Arbetsyteadministratörer kan styra åtkomsten till den här funktionen från sidan Förhandsversioner . Se Hantera förhandsversioner av Azure Databricks.

Returnerar den kanoniska representationen av ett IPv4- eller IPv6 CIDR-block. Returnerar None i stället för att generera ett fel om indata är ogiltiga.

För motsvarande SQL-funktion, se try_ip_cidr funktion.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.try_ip_cidr(col=<col>)

Parameters

Parameter Type Description
col pyspark.sql.Column eller str Ett STRING- eller BINÄRt värde som representerar ett giltigt IPv4- eller IPv6 CIDR-block.

Examples

Exempel 1: Kanonisera ett IPv4 CIDR-block.

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

Exempel 2: Kanonisera ett IPv6 CIDR-block.

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

Exempel 3: Ogiltiga indata returnerar None.

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

Exempel 4: None indata returnerar 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)]