try_ip_cidr

Dotyczy:sprawdzanie oznaczone jako tak Databricks Runtime 18.2 lub nowsze

Ważna

Ta funkcja jest dostępna w wersji beta. Administratorzy obszaru roboczego mogą kontrolować dostęp do tej funkcji ze strony Podglądy . Zobacz Zarządzanie wersjami zapoznawczami usługi Azure Databricks.

Zwraca kanoniczną reprezentację bloku CIDR IPv4 lub IPv6. Zwraca None wartość zamiast zgłaszać błąd, jeśli dane wejściowe są nieprawidłowe.

Aby uzyskać odpowiednią funkcję SQL, zobacz try_ip_cidr funkcja.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.try_ip_cidr(col=<col>)

Parameters

Parameter Typ Description
col pyspark.sql.Column lub str Wartość STRING lub BINARY reprezentująca prawidłowy blok CIDR IPv4 lub IPv6.

Examples

Przykład 1: Canonicalize bloku 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')]

Przykład 2: Canonicalize bloku 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')]

Przykład 3. Nieprawidłowe dane wejściowe zwracają wartość 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)]

Przykład 4: None dane wejściowe zwracają Nonewartość .

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