ip_host

Si applica a:check contrassegnato come sì Databricks Runtime 18.2 e versioni successive

Importante

Questa funzionalità è in versione beta. Gli amministratori dell'area di lavoro possono controllare l'accesso a questa funzionalità dalla pagina Anteprime . Vedere Gestire le anteprime di Azure Databricks.

Restituisce la rappresentazione canonica di un indirizzo IPv4 o IPv6.

Per la funzione SQL corrispondente, vedere ip_host funzione.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.ip_host(col=<col>)

Parameters

Parametro Tipo Description
col pyspark.sql.Column oppure str Valore STRING o BINARY che rappresenta un indirizzo IPv4 o IPv6 valido.

Examples

Esempio 1: Convalidare un indirizzo IPv4.

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

Esempio 2: Canonizzare un indirizzo IPv6.

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

Esempio 3: Convalidare un indirizzo IPv4 mappato a IPv6.

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

Esempio 4: Convalidare un indirizzo IPv4 in formato binario. L'input è la rappresentazione binaria dell'indirizzo 192.168.1.5IPv4 .

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

Esempio 5: None l'input restituisce 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)]