array_size

Retorna o número total de elementos na matriz. A função retorna nulo para entrada nula.

Sintaxe

from pyspark.sql import functions as sf

sf.array_size(col)

Parâmetros

Parâmetro	Tipo	Description
col	pyspark.sql.Column ou str	O nome da coluna ou uma expressão que representa a matriz.

Devoluções

pyspark.sql.Column: uma nova coluna que contém o tamanho de cada matriz.

Exemplos

Exemplo 1: uso básico com matriz de inteiros

from pyspark.sql import functions as sf
df = spark.createDataFrame([([2, 1, 3],), (None,)], ['data'])
df.select(sf.array_size(df.data)).show()

+----------------+
|array_size(data)|
+----------------+
|               3|
|            NULL|
+----------------+

Exemplo 2: Uso com matriz de cadeia de caracteres

from pyspark.sql import functions as sf
df = spark.createDataFrame([(['apple', 'banana', 'cherry'],)], ['data'])
df.select(sf.array_size(df.data)).show()

+----------------+
|array_size(data)|
+----------------+
|               3|
+----------------+

Exemplo 3: Uso com matriz de tipo misto

from pyspark.sql import functions as sf
df = spark.createDataFrame([(['apple', 1, 'cherry'],)], ['data'])
df.select(sf.array_size(df.data)).show()

+----------------+
|array_size(data)|
+----------------+
|               3|
+----------------+

Exemplo 4: Uso com matriz de matrizes

from pyspark.sql import functions as sf
df = spark.createDataFrame([([[2, 1], [3, 4]],)], ['data'])
df.select(sf.array_size(df.data)).show()

+----------------+
|array_size(data)|
+----------------+
|               2|
+----------------+

Exemplo 5: Uso com matriz vazia

from pyspark.sql import functions as sf
from pyspark.sql.types import ArrayType, IntegerType, StructType, StructField
schema = StructType([
  StructField("data", ArrayType(IntegerType()), True)
])
df = spark.createDataFrame([([],)], schema=schema)
df.select(sf.array_size(df.data)).show()

+----------------+
|array_size(data)|
+----------------+
|               0|
+----------------+