ektravel commented on code in PR #14734:
URL: https://github.com/apache/druid/pull/14734#discussion_r1286273406


##########
docs/querying/math-expr.md:
##########
@@ -307,9 +307,7 @@ Supported features:
 * other: `parse_long` is supported for numeric and string types
 
 ## Logical operator modes
-Prior to the 0.23 release of Apache Druid, boolean function expressions have 
inconsistent handling of true and false values, and the logical 'and' and 'or' 
operators behave in a manner that is incompatible with SQL, even if SQL 
compatible null handling mode (`druid.generic.useDefaultValueForNull=false`) is 
enabled. Logical operators also pass through their input values similar to many 
scripting languages, and treat `null` as false, which can result in some rather 
strange behavior. Other boolean operations, such as comparisons and equality, 
retain their input types (e.g. `DOUBLE` comparison would produce `1.0` for true 
and `0.0` for false), while many other boolean functions strictly produce 
`LONG` typed values of `1` for true and `0` for false. 
-
-After 0.23, while the inconsistent legacy behavior is still the default, it 
can be optionally be changed by setting 
`druid.expressions.useStrictBooleans=true`, so that these operations will allow 
correctly treating `null` values as "unknown" for SQL compatible behavior, and 
_all boolean output functions_ will output 'homogeneous' `LONG` typed boolean 
values of `1` for `true` and `0` for `false`. Additionally, 
+In Druid 28.0 and later, `druid.expressions.useStrictBooleans=true` is set by 
default, so logical operations will allow correctly treating `null` values as 
"unknown" for SQL compatible behavior, and _all boolean output functions_ will 
output 'homogeneous' `LONG` typed boolean values of `1` for `true` and `0` for 
`false`. 

Review Comment:
   ```suggestion
   In Druid 28.0 and later, `druid.expressions.useStrictBooleans=true` is set 
by default. Logical operations treat `null` values as "unknown" for SQL 
compatible behavior. _all boolean output functions_ output homogeneous `LONG` 
typed boolean values of `1` for `true` and `0` for `false`. 
   ```



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to