ip_cidr_contains

S’applique à :check marqué oui 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 True si une adresse IP ou un bloc CIDR est contenu dans un autre bloc CIDR, False sinon.

Pour la fonction SQL correspondante, consultez ip_cidr_contains la fonction.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.ip_cidr_contains(col1=<col1>, col2=<col2>)

Parameters

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

Exemples

Exemple 1 : Vérifiez si une adresse IP est contenue dans un bloc CIDR.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('192.168.1.0/24', '192.168.1.100')], ['cidr', 'ip'])
df.select(dbf.ip_cidr_contains('cidr', 'ip').alias('result')).collect()
[Row(result=True)]

Exemple 2 : Vérifiez si un bloc CIDR plus petit est contenu dans un bloc CIDR plus grand.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('192.168.0.0/16', '192.168.1.0/24')], ['cidr', 'needle'])
df.select(dbf.ip_cidr_contains('cidr', 'needle').alias('result')).collect()
[Row(result=True)]

Exemple 3 : None retour Noned’entrée .

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