Skip to content

bug: Fix NULL handling in array_slice, introduce NullHandling enum to Signature #14289

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 13 commits into from
Feb 3, 2025
Merged

bug: Fix NULL handling in array_slice, introduce NullHandling enum to Signature #14289

Show file tree
Hide file tree
Changes from 5 commits
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
4895da3
bug: Fix NULL handling in array_slice
jkosh44 Jan 25, 2025
10bea2b
Fix optimizer error
jkosh44 Jan 25, 2025
8da10c3
Fix clippy
jkosh44 Jan 25, 2025
622bc72
PoC for strict functions
jkosh44 Jan 26, 2025
eb450cc
Generate all null values
jkosh44 Jan 26, 2025
d7503cd
Add NullHandling enum
jkosh44 Jan 29, 2025
07a0769
Update array_slice signature
jkosh44 Jan 29, 2025
9080fba
Switch to trait method
jkosh44 Feb 1, 2025
9717658
fmt
jkosh44 Feb 1, 2025
3d21297
Fix typo
jkosh44 Feb 1, 2025
8321f13
Handle batch inputs
jkosh44 Feb 1, 2025
bb14245
Fix comment
jkosh44 Feb 1, 2025
cbc84d5
Update array_pop methods null handling
jkosh44 Feb 1, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions datafusion/expr-common/src/signature.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -465,6 +465,8 @@ pub struct Signature {
pub type_signature: TypeSignature,
/// The volatility of the function. See [Volatility] for more information.
pub volatility: Volatility,
/// When true, the function always returns null whenever any of its arguments are null.
pub strict: bool,
}

impl Signature {
Expand All @@ -473,20 +475,23 @@ impl Signature {
Signature {
type_signature,
volatility,
strict: false,
}
}
/// An arbitrary number of arguments with the same type, from those listed in `common_types`.
pub fn variadic(common_types: Vec<DataType>, volatility: Volatility) -> Self {
Self {
type_signature: TypeSignature::Variadic(common_types),
volatility,
strict: false,
}
}
/// User-defined coercion rules for the function.
pub fn user_defined(volatility: Volatility) -> Self {
Self {
type_signature: TypeSignature::UserDefined,
volatility,
strict: false,
}
}

Expand All @@ -495,6 +500,7 @@ impl Signature {
Self {
type_signature: TypeSignature::Numeric(arg_count),
volatility,
strict: false,
}
}

Expand All @@ -503,6 +509,7 @@ impl Signature {
Self {
type_signature: TypeSignature::String(arg_count),
volatility,
strict: false,
}
}

Expand All @@ -511,6 +518,7 @@ impl Signature {
Self {
type_signature: TypeSignature::VariadicAny,
volatility,
strict: false,
}
}
/// A fixed number of arguments of the same type, from those listed in `valid_types`.
Expand All @@ -522,13 +530,15 @@ impl Signature {
Self {
type_signature: TypeSignature::Uniform(arg_count, valid_types),
volatility,
strict: false,
}
}
/// Exactly matches the types in `exact_types`, in order.
pub fn exact(exact_types: Vec<DataType>, volatility: Volatility) -> Self {
Signature {
type_signature: TypeSignature::Exact(exact_types),
volatility,
strict: false,
}
}
/// Target coerce types in order
Expand All @@ -539,6 +549,7 @@ impl Signature {
Self {
type_signature: TypeSignature::Coercible(target_types),
volatility,
strict: false,
}
}

Expand All @@ -547,13 +558,15 @@ impl Signature {
Self {
type_signature: TypeSignature::Comparable(arg_count),
volatility,
strict: false,
}
}

pub fn nullary(volatility: Volatility) -> Self {
Signature {
type_signature: TypeSignature::Nullary,
volatility,
strict: false,
}
}

Expand All @@ -562,13 +575,15 @@ impl Signature {
Signature {
type_signature: TypeSignature::Any(arg_count),
volatility,
strict: false,
}
}
/// Any one of a list of [TypeSignature]s.
pub fn one_of(type_signatures: Vec<TypeSignature>, volatility: Volatility) -> Self {
Signature {
type_signature: TypeSignature::OneOf(type_signatures),
volatility,
strict: false,
}
}
/// Specialized Signature for ArrayAppend and similar functions
Expand All @@ -578,6 +593,7 @@ impl Signature {
ArrayFunctionSignature::ArrayAndElement,
),
volatility,
strict: false,
}
}
/// Specialized Signature for Array functions with an optional index
Expand All @@ -587,6 +603,7 @@ impl Signature {
ArrayFunctionSignature::ArrayAndElementAndOptionalIndex,
),
volatility,
strict: false,
}
}
/// Specialized Signature for ArrayPrepend and similar functions
Expand All @@ -596,6 +613,7 @@ impl Signature {
ArrayFunctionSignature::ElementAndArray,
),
volatility,
strict: false,
}
}
/// Specialized Signature for ArrayElement and similar functions
Expand All @@ -605,15 +623,23 @@ impl Signature {
ArrayFunctionSignature::ArrayAndIndex,
),
volatility,
strict: false,
}
}
/// Specialized Signature for ArrayEmpty and similar functions
pub fn array(volatility: Volatility) -> Self {
Signature {
type_signature: TypeSignature::ArraySignature(ArrayFunctionSignature::Array),
volatility,
strict: false,
}
}

/// Returns an equivalent Signature, with strict set to true.
pub fn with_strict(mut self) -> Self {
self.strict = true;
self
}
}

#[cfg(test)]
Expand Down
5 changes: 2 additions & 3 deletions datafusion/functions-nested/src/extract.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -330,7 +330,8 @@ pub(super) struct ArraySlice {
impl ArraySlice {
pub fn new() -> Self {
Self {
signature: Signature::variadic_any(Volatility::Immutable),
// TODO: This signature should use the actual accepted types, not variadic_any.
Copy link
Contributor Author

@jkosh44 jkosh44 Jan 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I haven't been able to figure out a way using the current TypeSignature to create a type signature that accepts (any list type, i64, i64). My only idea is to extend ArrayFunctionSignature with a variant like ArrayAndElements(NonZeroUsize).

Copy link
Contributor Author

@jkosh44 jkosh44 Jan 27, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Another approach, which probably warrants it's own issue/PR, is to add something similar to PostgreSQL psuedo-types (https://www.postgresql.org/docs/current/datatype-pseudo.html). Then I can make a signature of something like

TypeSignature::OneOf(vec![
    TypeSignature::Exact(vec![AnyArray, Int64, Int64]),
    TypeSignature::Exact(vec![AnyArray, Int64, Int64, Int64]),
])

Copy link
Contributor

@jayzhan211 jayzhan211 Jan 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

My only idea is to extend ArrayFunctionSignature with a variant like ArrayAndElements(NonZeroUsize)

I think this is better

Copy link
Contributor Author

@jkosh44 jkosh44 Jan 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just pushed an update to do this.

signature: Signature::variadic_any(Volatility::Immutable).with_strict(),
aliases: vec![String::from("list_slice")],
}
}
Expand Down Expand Up @@ -430,8 +431,6 @@ fn array_slice_inner(args: &[ArrayRef]) -> Result<ArrayRef> {
}
LargeList(_) => {
let array = as_large_list_array(&args[0])?;
let from_array = as_int64_array(&args[1])?;
let to_array = as_int64_array(&args[2])?;
general_array_slice::<i64>(array, from_array, to_array, stride)
}
_ => exec_err!("array_slice does not support type: {:?}", array_data_type),
Expand Down
1 change: 1 addition & 0 deletions datafusion/functions-nested/src/flatten.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -80,6 +80,7 @@ impl Flatten {
ArrayFunctionSignature::RecursiveArray,
),
volatility: Volatility::Immutable,
strict: false,
},
aliases: vec![],
}
Expand Down
6 changes: 6 additions & 0 deletions datafusion/physical-expr/src/scalar_function.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -186,6 +186,12 @@ impl PhysicalExpr for ScalarFunctionExpr {
.map(|e| e.evaluate(batch))
.collect::<Result<Vec<_>>>()?;

if self.fun.signature().strict && args.iter().any(|arg| arg.data_type().is_null())
{
let null_value = ScalarValue::try_from(&self.return_type)?;
return Ok(ColumnarValue::Scalar(null_value));
}

let input_empty = args.is_empty();
let input_all_scalar = args
.iter()
Expand Down
41 changes: 30 additions & 11 deletions datafusion/sqllogictest/test_files/array.slt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1817,18 +1817,26 @@ select array_slice(arrow_cast(make_array(1, 2, 3, 4, 5), 'LargeList(Int64)'), 0,
[1, 2, 3, 4] [h, e, l]

# array_slice scalar function #8 (with NULL and positive number)
query error
query ??
select array_slice(make_array(1, 2, 3, 4, 5), NULL, 4), array_slice(make_array('h', 'e', 'l', 'l', 'o'), NULL, 3);
----
NULL NULL

query error
query ??
select array_slice(arrow_cast(make_array(1, 2, 3, 4, 5), 'LargeList(Int64)'), NULL, 4), array_slice(arrow_cast(make_array('h', 'e', 'l', 'l', 'o'), 'LargeList(Utf8)'), NULL, 3);
----
NULL NULL

# array_slice scalar function #9 (with positive number and NULL)
query error
query ??
select array_slice(make_array(1, 2, 3, 4, 5), 2, NULL), array_slice(make_array('h', 'e', 'l', 'l', 'o'), 3, NULL);
----
NULL NULL

query error
query ??
select array_slice(arrow_cast(make_array(1, 2, 3, 4, 5), 'LargeList(Int64)'), 2, NULL), array_slice(arrow_cast(make_array('h', 'e', 'l', 'l', 'o'), 'LargeList(Utf8)'), 3, NULL);
----
NULL NULL

# array_slice scalar function #10 (with zero-zero)
query ??
Expand All @@ -1842,12 +1850,15 @@ select array_slice(arrow_cast(make_array(1, 2, 3, 4, 5), 'LargeList(Int64)'), 0,
[] []

# array_slice scalar function #11 (with NULL-NULL)
query error
query ??
select array_slice(make_array(1, 2, 3, 4, 5), NULL), array_slice(make_array('h', 'e', 'l', 'l', 'o'), NULL);
----
NULL NULL

query error
query ??
select array_slice(arrow_cast(make_array(1, 2, 3, 4, 5), 'LargeList(Int64)'), NULL), array_slice(arrow_cast(make_array('h', 'e', 'l', 'l', 'o'), 'LargeList(Utf8)'), NULL);

----
NULL NULL

# array_slice scalar function #12 (with zero and negative number)
query ??
Expand All @@ -1861,18 +1872,26 @@ select array_slice(arrow_cast(make_array(1, 2, 3, 4, 5), 'LargeList(Int64)'), 0,
[1, 2] [h, e, l]

# array_slice scalar function #13 (with negative number and NULL)
query error
query ??
select array_slice(make_array(1, 2, 3, 4, 5), -2, NULL), array_slice(make_array('h', 'e', 'l', 'l', 'o'), -3, NULL);
----
NULL NULL

query error
query ??
select array_slice(arrow_cast(make_array(1, 2, 3, 4, 5), 'LargeList(Int64)'), -2, NULL), array_slice(arrow_cast(make_array('h', 'e', 'l', 'l', 'o'), 'LargeList(Utf8)'), -3, NULL);
----
NULL NULL

# array_slice scalar function #14 (with NULL and negative number)
query error
query ??
select array_slice(make_array(1, 2, 3, 4, 5), NULL, -4), array_slice(make_array('h', 'e', 'l', 'l', 'o'), NULL, -3);
----
NULL NULL

query error
query ??
select array_slice(arrow_cast(make_array(1, 2, 3, 4, 5), 'LargeList(Int64)'), NULL, -4), array_slice(arrow_cast(make_array('h', 'e', 'l', 'l', 'o'), 'LargeList(Utf8)'), NULL, -3);
----
NULL NULL

# array_slice scalar function #15 (with negative indexes)
query ??
Expand Down
Loading