try_ip_host
S’applique à : 
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 représentation canonique d'une adresse IPv4 ou IPv6. Retourne None au lieu de lever une erreur si l'entrée est invalide.
Pour la fonction SQL correspondante, consultez la fonctiontry_ip_host.
Syntaxe
Python
from pyspark.databricks.sql import functions as dbf
dbf.try_ip_host(col=<col>)
parameter
parameter | Type | Description |
|---|---|---|
|
| Une valeur STRING ou BINARY représentant une adresse IPv4 ou IPv6 valide. |
Exemples
**Exemple 1** : Validez une adresse IPv4.
Python
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()
Output
[Row(result='192.168.1.5')]
Exemple 2 : canonicaliser une adresse IPv6.
Python
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()
Output
[Row(result='2001:db8::1')]
Exemple 3 : L'entrée non valide renvoie None.
Python
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('invalid.ip',)], ['ip'])
df.select(dbf.try_ip_host('ip').alias('result')).collect()
Output
[Row(result=None)]
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.try_ip_host('ip').alias('result')).collect()
Output
[Row(result=None)]