ip_cidr_contains

Aplica-se a:check marked yes Databricks Runtime 18.2 e superior

Importante

Esse recurso está em Beta. Os administradores do workspace podem controlar o acesso a esse recurso na página Visualizações . Consulte Gerenciar visualizações do Azure Databricks.

Retorna True se um endereço IP ou bloco CIDR estiver contido em outro bloco CIDR, False caso contrário.

Para a função SQL correspondente, consulte ip_cidr_contains a função.

Syntax

from pyspark.databricks.sql import functions as dbf

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

Parameters

Parâmetro Tipo Description
col1 pyspark.sql.Column ou str Um valor STRING ou BINARY que representa um bloco CIDR IPv4 ou IPv6 válido.
col2 pyspark.sql.Column ou str Um valor STRING ou BINARY que representa um endereço IPv4 ou IPv6 válido ou um bloco CIDR.

Exemplos

Exemplo 1: verifique se um endereço IP está contido em um bloco 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)]

Exemplo 2: verifique se um bloco CIDR menor está contido em um bloco CIDR maior.

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

Exemplo 3: None a entrada retorna None.

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