try_ip_host

Dotyczy:sprawdzanie oznaczone jako tak Databricks Runtime 18.2 lub nowsze

Ważna

Ta funkcja jest dostępna w wersji beta.

Zwraca kanoniczną reprezentację adresu 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_host funkcja.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.try_ip_host(col=<col>)

Parameters

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

Examples

Przykład 1: Weryfikowanie adresu IPv4.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('192.168.1.5',)], ['ip'])
df.select(dbf.try_ip_host('ip').alias('result')).collect()
[Row(result='192.168.1.5')]

Przykład 2: Canonicalize adresu IPv6.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('2001:0db8::1',)], ['ip'])
df.select(dbf.try_ip_host('ip').alias('result')).collect()
[Row(result='2001:db8::1')]

Przykład 3. Nieprawidłowe dane wejściowe zwracają wartość None.

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