try_ip_host

Область применения: Databricks Runtime 18.2 и выше

Important

Эта функция доступна в бета-версии. Администраторы рабочей области могут управлять доступом к этой функции на странице "Предварительные версии ". См. статью "Управление предварительными версиями Azure Databricks".

Возвращает каноническое представление IPv4 или IPv6-адреса. Возвращается None вместо того, чтобы вызывать ошибку, если входные данные недопустимы.

Соответствующая функция SQL см. в разделеtry_ip_host "Функция".

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.try_ip_host(col=<col>)

Parameters

Parameter	Тип	Description
col	pyspark.sql.Column или str	Строковое или двоичное значение, представляющее допустимый IPv4 или IPv6-адрес.

Примеры

Пример 1. Проверка 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')]

Пример 2. Канонизация 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')]

Пример 3. Возвращает 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)]

Пример 4. None Возвращает Noneвходные данные.

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