ip_as_binary

S’applique à : Databricks Runtime 18.2 et versions ultérieures

Important

Cette fonctionnalité est en version bêta. Les administrateurs d’espace de travail peuvent contrôler l’accès à cette fonctionnalité à partir de la page Aperçus . Consultez Gérer les préversions d’Azure Databricks.

Retourne la représentation binaire canonique d’une adresse IP ou d’un bloc CIDR.

Pour la fonction SQL correspondante, consultez ip_as_binary la fonction.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.ip_as_binary(col=<col>)

Parameters

Paramètre	Catégorie	Description
col	pyspark.sql.Column ou str	Valeur STRING ou BINARY représentant une adresse IPv4 ou IPv6 valide ou un bloc CIDR.

Exemples

Exemple 1 : Convertir une adresse IPv4 en adresse binaire.

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

[Row(result='C0A80101')]

Exemple 2 : Convertir une adresse IPv6 en adresse binaire.

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

[Row(result='20010DB8000000000000000000000001')]

Exemple 3 : Convertir un bloc CIDR en bloc binaire.

from pyspark.databricks.sql import functions as dbf
from pyspark.sql.functions import hex
df = spark.createDataFrame([('192.168.1.5/24',)], ['cidr'])
df.select(hex(dbf.ip_as_binary('cidr')).alias('result')).collect()

[Row(result='C0A8010018')]

Exemple 4 : None retour d’entrée None.

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

[Row(result=None)]