Repository navigation
Conversation
- GREATEST / LEAST: a quoted argument counts as the type beside it and a BOOLEAN beside whole numbers as 1 / 0; only the rest is refused. - NULLIF: a boolean against a number is compared, no longer refused. - Comparing values of different types is a heading, so its links land on it. - Index patterns: a keyword beside a long or a date is a VARCHAR; a user who may not read the mapping is typed from _field_caps (operators, known limitations, the integer-key rule). - Windows: a partition column is read when the SELECT holds no plain column. - A one-element array is its element only in a column not declared a list; a set operation lists a multi-valued date only for a list column. - The SHOW / DESCRIBE examples list sub-fields in their declared order, and the function summary carries the result-type and quoted-argument notes the web site has. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Documentation only. The six documentation changes merged for engine
0.25.0(#455, #456, #457, #458, #459, #460) left a few older statements on other pages false, and one new link pointing to the wrong section. This PR fixes them, and adds to the DQL function summary the short notes that the web site's twin of that page now carries, so both stay the same.What changes
GREATEST / LEAST (
functions_conditional.md,dql_statements.md): "any other argument is refused" was false since feat(sql): quoted arguments and implicit comparisons read as DuckDB does (SCHEMA-5b) #460. A quoted argument counts as the type of the arguments beside it (GREATEST(n, '1.5')is anINT,GREATEST(d, '2024-01-15')aDATE), and aBOOLEANbeside whole numbers counts as1/0. The result-type sentences count a quoted argument as the number it is read as.NULLIF (
functions_conditional.md): a boolean against a number is compared as1/0since feat(sql): quoted arguments and implicit comparisons read as DuckDB does (SCHEMA-5b) #460, no longer refused. A boolean against a date still is.Comparing values of different types (
operators.md): it is now a heading. The four links to it (type_conversion.md,functions_conditional.mdtwice,dql_statements.md) used#operator-, which opens the+operator section.Index patterns and
_field_caps(operators.md,known_limitations.md): since feat(core): mapping types, field caps fallback and index patterns typed (SCHEMA-7) #459 akeywordbeside alongor adateis aVARCHAR, and a user who may not read the mapping is typed from_field_caps. "A mapping that cannot be read" no longer names a case with no type.Window partitions (
known_limitations.md): since feat(core): computed-only projections without _source, DuckDB numeric widths (SCHEMA-5) #455 a partition column theSELECTdoes not return is read when theSELECTholds no plain column at all, not only under*, asgateway.mdalready says.Several values (
gateway.md,dql_statements.md): since feat(sql): ARRAY<X> round trip, derived and WITH columns typed, struct order (SCHEMA-6) #456 a one-element array is its element only in a column not declared a list, and a set operation answers a multi-valued date as a list only for a column declaredARRAY<DATE>/ARRAY<TIMESTAMP>. AnARRAY<X>column is no longer read without a type.gateway.md:schemaisNoneonly when neither the mapping nor_field_capscan type the source. The mapping-types table says what Declared and Reported mean.date_nanos(functions_conditional.md): no longer described as a column of unknown type (feat(core): mapping types, field caps fallback and index patterns typed (SCHEMA-7) #459).Examples (
dql_statements.md): theSHOW TABLE,SHOW CREATE TABLEandDESCRIBE TABLEoutputs listprofile's sub-fields in their declared order (feat(sql): ARRAY<X> round trip, derived and WITH columns typed, struct order (SCHEMA-6) #456).DQL function summary (
dql_statements.md):ROUND,POW,SQRT,EXP,LOG,LOG10,DATEDIFFandDATE_TRUNC;NULLIFover a text and a number in a query;COALESCE/GREATEST/LEAST.Each note is a summary of the function pages, with a link to them.
Verification
main; its findings are fixed here.Recorded, not fixed
known_limitations.mdstill ends with "as of engine0.24.0". That line is updated by the release documentation sweep.🤖 Generated with Claude Code