try_ip_host

Dotyczy: 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ę 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)]