Aller au contenu principal

version_ip

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

info

Bêta

Cette fonctionnalité est en Bêta. Les administrateurs du Workspace peuvent contrôler l'accès à cette fonctionnalité à partir de la page Previews . Consultez Gérer les aperçus Databricks.

Renvoie la version IP (4 ou 6) d'une adresse IPv4 ou IPv6 ou d'un bloc CIDR.

Pour la fonction SQL correspondante, consultez la fonctionip_version.

Syntaxe

Python
from pyspark.databricks.sql import functions as dbf

dbf.ip_version(col=<col>)

parameter

parameter

Type

Description

col

pyspark.sql.Column OU str

Une valeur STRING ou BINARY représentant une adresse IPv4 ou IPv6 ou un bloc CIDR valide.

parameter

Type

Description

col

pyspark.sql.Column OU str

Une valeur STRING ou BINARY représentant une adresse IPv4 ou IPv6 ou un bloc CIDR valide.

Exemples

Exemple 1 : Obtenir la version à partir d'une adresse IPv4.

Python
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('192.168.1.5',)], ['ip'])
df.select(dbf.ip_version('ip').alias('result')).collect()
Output
[Row(result=4)]

**Exemple 2** : Obtenir la version à partir d'une adresse IPv6.

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

Exemple 3 : Obtenir la version d’un bloc CIDR.

Python
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('192.168.1.0/24',)], ['cidr'])
df.select(dbf.ip_version('cidr').alias('result')).collect()
Output
[Row(result=4)]

Exemple 4 : l'entrée None renvoie None.

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