ip_host

Van toepassing op: Databricks Runtime 18.2 en hoger

Important

Deze functie bevindt zich in de bètaversie. Werkruimtebeheerders kunnen de toegang tot deze functie beheren vanaf de pagina Previews . Zie Azure Databricks previews beheren.

Retourneert de canonieke weergave van een IPv4- of IPv6-adres.

Zie de functie voor de bijbehorende SQL-functieip_host.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.ip_host(col=<col>)

Parameters

Parameter	Typ	Description
col	pyspark.sql.Column of str	Een TEKENREEKS- of BINAIRE waarde die een geldig IPv4- of IPv6-adres vertegenwoordigt.

Examples

Voorbeeld 1: Een IPv4-adres valideren.

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

[Row(result='192.168.1.5')]

Voorbeeld 2: Een IPv6-adres canoniseren.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('2001:0DB8:0000:0000:0000:0000:0000:0001',)], ['ipv6'])
df.select(dbf.ip_host('ipv6').alias('result')).collect()

[Row(result='2001:db8::1')]

Voorbeeld 3: Een IPv4-toegewezen IPv6-adres valideren.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('::ffff:192.0.2.128',)], ['ip'])
df.select(dbf.ip_host('ip').alias('result')).collect()

[Row(result='::ffff:192.0.2.128')]

Voorbeeld 4: Een IPv4-adres valideren in binaire indeling. De invoer is de binaire weergave van het IPv4-adres 192.168.1.5.

from pyspark.databricks.sql import functions as dbf
from pyspark.sql.functions import hex
df = spark.createDataFrame([(bytearray([0xC0, 0xA8, 0x01, 0x05]),)], ['ip'])
df.select(hex(dbf.ip_host('ip')).alias('result')).collect()

[Row(result='C0A80105')]

Voorbeeld 5: None invoer retourneert None.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([(None,)], 'ip: string')
df.select(dbf.ip_host('ip').alias('result')).collect()

[Row(result=None)]