ip_network_first

Gilt für:check marked yes Databricks Runtime 18.2 und höher

Important

Dieses Feature befindet sich in der Betaversion.

Gibt den Netzwerkteil eines IPv4- oder IPv6-CIDR-Blocks in kanonischer Form zurück.

Diese Funktion ist ein Alias für ip_network.

Informationen zur entsprechenden SQL-Funktion finden Sie unter ip_network_first Funktion.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.ip_network_first(col=<col>)

Parameters

Parameter Typ Description
col pyspark.sql.Column oder str Ein STRING- oder BINARY-Wert, der einen gültigen IPv4- oder IPv6 CIDR-Block darstellt.

Beispiele

Beispiel 1: Abrufen der ersten Adresse aus einem IPv4 CIDR-Block.

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

Beispiel 2: Abrufen der ersten Adresse aus einem IPv6 CIDR-Block.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('2001:db8::1/32',)], ['cidr'])
df.select(dbf.ip_network_first('cidr').alias('result')).collect()
[Row(result='2001:db8::')]

Beispiel 3: None Eingabe gibt zurück None.

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