diff --git a/Makefile b/Makefile index 48d5bb671..f723cdc76 100644 --- a/Makefile +++ b/Makefile @@ -30,7 +30,7 @@ PYTHON_TYPED := scripts tests/unit/scripts python/src $(PYTHON_API_TESTS) PYTHON_TESTS := tests/unit/scripts $(PYTHON_API_TESTS) endif -.PHONY: distribution-notices format rust-lint python-check fensu syntax-coverage website-figures website-figures-update depth-probe depth-probe-debug instruction-counts instruction-baseline gate-build engine-free bundled-extensions dialect-builds generate-cases generated-cases generate-syntax-cases syntax-obligations syntax-cases dialect-cases corpus-rerecord corpus-verdicts corpus-verdicts-baseline generate-referee-cases referee-cases referee-pending translation-files translation-results help pending check-syntax record-syntax check-convert record-convert sql-sizes sql-size-baseline sql-benchmark check-ci check-merge test test-rust test-python python-build python-module python-api python-wheel verify-recorded verify-changed replay-scope test-crate check-pr-metadata evidence-clone evidence-refresh evidence-pin evidence-pin-check clutter-guard census-duckshop fuzz-smoke gate gate-parallel census duckshop-compiled duckshop-measure +.PHONY: distribution-notices format rust-lint python-check fensu syntax-coverage website-figures website-figures-update depth-probe depth-probe-debug instruction-counts instruction-baseline gate-build engine-free bundled-extensions dialect-builds generate-cases generated-cases generate-syntax-cases syntax-obligations syntax-cases dialect-cases dialect-validate corpus-rerecord corpus-verdicts corpus-verdicts-baseline generate-referee-cases referee-cases referee-pending translation-files translation-results help pending check-syntax record-syntax check-convert record-convert sql-sizes sql-size-baseline sql-benchmark check-ci check-merge test test-rust test-python python-build python-module python-api python-wheel verify-recorded verify-changed replay-scope test-crate check-pr-metadata evidence-clone evidence-refresh evidence-pin evidence-pin-check clutter-guard census-duckshop fuzz-smoke gate gate-parallel census duckshop-compiled duckshop-measure format: cargo fmt --all @@ -225,6 +225,11 @@ DIALECT_CASE_DIALECTS ?= databricks dialect-cases: @set -e; $(foreach d,$(DIALECT_CASE_DIALECTS),uv run python -m scripts.build_syntax_obligations_$(d) --check --evidence $(call syntax_evidence_dir,$(d));) +# Fails on a broken reference in a dialect root, or when the tree screen finds a one-token variant of +# an approved form's case that parses to the same tree and screen.toml does not allow. +dialect-validate: gate-build + @set -e; $(foreach d,$(DIALECT_CASE_DIALECTS),$(GATE_DIR)/syntax-coverage validate --root $(call suite_dir,syntax,$(d)) --evidence $(call syntax_evidence_dir,$(d));) + # Where the generated referee cases live: the evidence once it is pinned, referee/ until then. The # environments stay in referee/environments/. REFEREE_CASE_ARGS = $(if $(EVIDENCE_PINNED),--cases $(EVIDENCE_ROOT)/referee/snowflake/cases) @@ -244,7 +249,7 @@ referee-pending: uv run python -m scripts.write_referee_pending $(REFEREE_ARGS) # The static gate, the first step of `gate`, and the Python API's tests. -check-ci: rust-lint python-check fensu syntax-coverage website-figures depth-probe instruction-counts corpus-verdicts evidence-pin-check clutter-guard engine-free bundled-extensions dialect-builds generated-cases syntax-obligations syntax-cases dialect-cases referee-cases translation-files python-api distribution-notices replay-scope ## The static gate CI runs. +check-ci: rust-lint python-check fensu syntax-coverage website-figures depth-probe instruction-counts corpus-verdicts evidence-pin-check clutter-guard engine-free bundled-extensions dialect-builds generated-cases syntax-obligations syntax-cases dialect-cases dialect-validate referee-cases translation-files python-api distribution-notices replay-scope ## The static gate CI runs. # Each distribution ships the licence and third-party notices; its copies must match the root files. distribution-notices: diff --git a/coverage/syntax-databricks/README.md b/coverage/syntax-databricks/README.md index 20bd60db5..641811058 100644 --- a/coverage/syntax-databricks/README.md +++ b/coverage/syntax-databricks/README.md @@ -1,6 +1,6 @@ # Databricks SQL syntax catalogue -The documented SQL syntax of Databricks SQL 2026.44 as stable form IDs `db..`, +The documented SQL syntax of Databricks SQL 2026.45 as stable form IDs `db..`, with the same layout and checker as the Snowflake root in `coverage/syntax`, the PostgreSQL root in `coverage/syntax-postgres` and the DuckDB root in `coverage/syntax-duckdb`. `dialect.toml` names the dialect for `syntax-coverage`. @@ -8,7 +8,7 @@ root in `coverage/syntax-postgres` and the DuckDB root in `coverage/syntax-duckd ## Sources - Documentation: the Databricks SQL language reference - (`https://docs.databricks.com/aws/en/sql/language-manual/`), retrieved 2026-11-06. The page + (`https://docs.databricks.com/aws/en/sql/language-manual/`), retrieved 2026-11-16. The page set is every page of the docs sitemap under the language manual, plus three function pages that the function indexes link but the sitemap leaves out (`index_linked` in `scripts/syntax_catalogue_databricks`): 1,191 pages. `sources.toml` lists each page with the @@ -21,7 +21,7 @@ root in `coverage/syntax-postgres` and the DuckDB root in `coverage/syntax-duckd Databricks SQL's parser is not published; the Spark grammar it extends is the independent check the omission audit reads. - Engine: a Databricks SQL serverless warehouse whose `current_version()` reports - `dbsql_version` 2026.44. Every receipt records that value. + `dbsql_version` 2026.45. Every receipt records that value. ## Regenerating @@ -113,7 +113,7 @@ listed, and when the lexer has a token that is neither compared nor listed, so a or new token is caught. `tests/unit/scripts/syntax_catalogue_databricks/test_review.py` checks this guard. -At the pin: 279 rules (3 unwalked), 10,135 keyword sequences, 3,259 gaps under 146 reviewed +At the pin: 279 rules (3 unwalked), 10,135 keyword sequences, 3,258 gaps under 145 reviewed `[[gap]]` rows, 21 reviewed `[[unseen]]` tokens, 427 keywords (47 not catalogued) and 51 helper option words (6 not catalogued), 0 problems. @@ -222,12 +222,18 @@ class rules. The reasons for each choice follow. in an expression is refused (`UNSUPPORTED_GENERATOR.NESTED_IN_EXPRESSIONS`). - The vector-search page's Syntax is a whole query, so it has no context. - A clause page's form runs in a statement that the page names as its host. + - A column alias list labels the columns of a table-valued generator in the select list + (sql-ref-names, Column alias), so it follows one. - LIKE in a partition spec is allowed only in ALTER SHARE ADD TABLE (sql-ref-partition). - A securable object and a principal are the operands of GRANT (sql-ref-privileges, sql-ref-principal). - A control statement runs in a compound statement (control-flow pages): a cursor statement after the cursor's declaration, FETCH and CLOSE after OPEN, LEAVE and ITERATE inside the loop they name, and GET DIAGNOSTICS and RESIGNAL inside a condition handler. +- Form qualifiers (`FORM_QUALIFY`): a nested field is a path below its column (the manage-column + page: "The fully qualified name of the field"; the update page: "A reference to field within a + column of type STRUCT"), so `field_name` is written behind `c1.`, and a quoted field is quoted + after the column. - Family contexts (`FAMILY_CONTEXTS`): a function or expression is written as a call in parentheses, so that a word left at the end of a negative is not read as a column alias. - Class rules (`DB_CLASS_RULES`): a clause, a column list or ALTER VIEW's rename is an operand @@ -539,9 +545,62 @@ obligations 11666/14572. The 11 forms without obligations are not counted. deadline, both answered after about 610 s with an internal engine error (`Cannot invoke "java.lang.CharSequence.length()" because "sequence" is null`, SQLSTATE 42000, with no parser excerpt). That error proves no phase, so no reviewed row maps it, and the form stays - unverified. + unverified. The referee leaves a case that answers exactly this message undecided as "no phase + proven", like a deadline cancel, so the rest of its run keeps its receipts; any other unmapped + error still refuses the run. Another is `db.scripting.iterate-stmt` (o001, o003): its case `k1d3a5a4a6874`, a LOOP ITERATE with no LEAVE, runs to the 300 s deadline, so no phase can be observed, and it is left out of its run. A form counts once even when several reasons apply, so the reasons overlap. + +### Trees of written forms + +Where a page's Syntax block offers different spellings of one construct, each spelling parses to +its own tree, so a review of the tree can see which one the SQL wrote. The parser keeps, among +others: + +- `DESC` against `DESCRIBE`, `DATABASE`, `SCHEMA` and `NAMESPACE` as written (in `DESCRIBE`, + `CREATE`, `ALTER`, `DROP` and `USE`), `FROM` against `IN`, and whether `LIKE` was written before + a pattern; +- `SET CATALOG` against `USE CATALOG`, which both choose the catalog (the use node's `keyword`); +- `MINUS` against `EXCEPT`, `TEMP` against `TEMPORARY`, and the type synonyms `BYTE`, `SHORT`, + `LONG`, `DEC`, `NUMERIC` and `TIMESTAMP_LTZ`; +- `ADD COLUMN` against `ADD COLUMNS` and `DROP COLUMN` against `DROP COLUMNS`, because the ALTER + TABLE page writes `{ COLUMN | COLUMNS }` as alternatives of one clause; +- the sign written before an interval value, including `+`; +- the operator written for a construct another documented form shares: `==` against `=`, `!=` + against `<>`, `IS [NOT] DISTINCT FROM` against `<=>`, `REGEXP` and `RLIKE` against the `rlike` call, and `>>>` + against the `shiftrightunsigned` call, in a `written_as` field that analysis ignores; +- the parentheses of a `VALUES` row and of a `STREAM` source, which the Syntax blocks write as + alternatives (`expression | ( expression [, ...] )` and `STREAM ( name ) | STREAM name`). +- a trailing `WITH ROLLUP` or `WITH CUBE` against `ROLLUP ( ... )` and `CUBE ( ... )`, and the + Hive `GROUP BY c1 GROUPING SETS ( ... )` against a comma before the sets, in the `GROUP BY` + clause's `with_modifier`; +- `FROM` against a comma after the first argument of `SUBSTR` and `SUBSTRING`, in the call's + `from_separator`, as `TRIM` keeps its SQL-standard spelling; +- a `CACHE TABLE` option's value written without `=`, which the page marks optional, in the cache + node's `options_without_equals`; +- `INSERT INTO TABLE` against `INSERT INTO` (the insert's `table_keyword`), and a `REPLACE ON` + query in parentheses against one without, as the page writes `( query ) [ alias ] | query`; +- an `INSERT OVERWRITE DIRECTORY` option's value written without `=`, in the directory's + `options_without_equals`, and a path written after `DIRECTORY` against one given only as the + `'path'` option; +- `DROP CONSTRAINT` with neither, `RESTRICT` or `CASCADE`; `DROP PARTITION` with or without + `PURGE`; `UNSET TBLPROPERTIES` with or without `IF EXISTS`; a view's relationship constraint + named or not, by cardinality, with `ON` or `USING` and with or without an alias; and `CACHE + SELECT`'s `FROM` as a clause, as an alias and as a column; +- a join's `NEAREST BY`: `APPROX` against `EXACT`, `DISTANCE` against `SIMILARITY`, and the number + of results written or not; a `WATERMARK` expression bare, with an alias, with `AS` and with + `AS ( aliases )`; +- each pipe operator with the pipe written before it (`|>` or `|`), in the `pipe_operators` of + the select it amounts to, so `FROM t1 |> AGGREGATE sum ( c1 )` keeps `|> AGGREGATE` apart from + `SELECT sum ( c1 ) FROM t1` and from `FROM t1 | AGGREGATE sum ( c1 )`; a trailing `|>` with + no operation after it is kept as the token alone. + +`MATCH_RECOGNIZE`'s `PATTERN` parses into the shared row-pattern tree (symbols, sequences, +alternations, groups, `PERMUTE` and quantifiers) beside the pattern's text, because the page's +Syntax block defines the pattern as a grammar of its own rather than as a string. + +Spellings the language treats as one token stay one tree: the letter case of keywords and of a +raw-string prefix, the quote character around a string or binary literal, and comments. diff --git a/coverage/syntax-databricks/aliases.toml b/coverage/syntax-databricks/aliases.toml new file mode 100644 index 000000000..9d3cb831b --- /dev/null +++ b/coverage/syntax-databricks/aliases.toml @@ -0,0 +1,68 @@ +# Retired form ids of the Databricks catalogue. Each old id stays in the catalogue with status +# absent_from_source, is never reused, and counts in no total; `to` lists the forms that now carry +# its grammar, and `reason` cites the pinned page revision that shows it. + +[[alias]] +from = "db.functions.ilike.any-some-all" +to = ["db.functions.ilike.ilike-any-some-all"] +reason = "the pinned functions/ilike page (page_sha256 a17d734d8e8b3864..., retrieved 2026-11-16) still shows str [ NOT ] ilike { ANY | SOME | ALL } ( [ pattern [, ...] ] ); this id read the lower-case ilike as a placeholder, and the line is now read with ILIKE as the operator, its pattern list required as hand.toml records (EMPTY_QUANTIFIED_PATTERN)" + +[[alias]] +from = "db.functions.ilike.subscript" +to = ["db.functions.ilike.ilike"] +reason = "the pinned functions/ilike page (page_sha256 a17d734d8e8b3864..., retrieved 2026-11-16) still shows str [ NOT ] ilike ( pattern [ ESCAPE escape ] ); this id read the lower-case ilike as a placeholder, and the line is now read with ILIKE as the operator" + +[[alias]] +from = "db.functions.like.any-some-all" +to = ["db.functions.like.like-any-some-all"] +reason = "the pinned functions/like page (page_sha256 cc5cbda129a27a23..., retrieved 2026-11-16) still shows str [ NOT ] like { ANY | SOME | ALL } ( [ pattern [, ...] ] ); this id read the lower-case like as a placeholder, and the line is now read with LIKE as the operator, its pattern list required as hand.toml records (EMPTY_QUANTIFIED_PATTERN)" + +[[alias]] +from = "db.functions.like.subscript" +to = ["db.functions.like.like"] +reason = "the pinned functions/like page (page_sha256 cc5cbda129a27a23..., retrieved 2026-11-16) still shows str [ NOT ] like ( pattern [ ESCAPE escape ] ); this id read the lower-case like as a placeholder, and the line is now read with LIKE as the operator" + +[[alias]] +from = "db.functions.in.subscript-dot" +to = ["db.functions.in.in.syntax"] +reason = "the pinned functions/in page (page_sha256 265a150b2ef73d13..., retrieved 2026-11-16) still shows elem in ( expr1 [, ...] ); this id read the lower-case in as a placeholder, and the line is now read with IN as the predicate" + +[[alias]] +from = "db.functions.in.syntax" +to = ["db.functions.in.in-2"] +reason = "the pinned functions/in page (page_sha256 265a150b2ef73d13..., retrieved 2026-11-16) still shows elem in ( query ); this id read the lower-case in as a placeholder, and the line is now read with IN as the predicate" + +[[alias]] +from = "db.functions.trim.trim-from-both-from" +to = ["db.functions.trim.trim-from", "db.functions.trim.trim-both-from.syntax"] +reason = "the pinned functions/trim page (page_sha256 164f61a9896e0850..., retrieved 2026-11-16) still shows trim(trimStr FROM str) and trim(BOTH trimStr FROM str) as separate lines; this id joined the two into one form and read the second trim as a placeholder, and each line is now its own form" + +[[alias]] +from = "db.functions.vector-search.from" +to = ["db.functions.vector-search.query-text-query-vector"] +reason = "the pinned functions/vector_search page (page_sha256 8bd15371d35fac48..., retrieved 2026-11-16) still shows SELECT * FROM vector_search( index, { query_text | query_vector }, [ num_results ]); this id read the lower-case vector_search as a placeholder and its arguments as positional, while the page's Arguments say all arguments must be passed by name, so the line is now read with named arguments (hand.toml)" + +[[alias]] +from = "db.functions.vector-search.from.syntax" +to = ["db.functions.vector-search.query-num-results"] +reason = "the pinned functions/vector_search page (page_sha256 8bd15371d35fac48..., retrieved 2026-11-16) still shows SELECT * FROM vector_search( index, query, num_results ) for Databricks Runtime 15.2 and below; this id read the lower-case vector_search as a placeholder and its arguments as positional, while the page's Arguments say all arguments must be passed by name, so the line is now read with named arguments (hand.toml)" + +[[alias]] +from = "db.functions.vector-search.vector-search" +to = ["db.functions.vector-search.query-text-query-vector"] +reason = "the pinned functions/vector_search page (page_sha256 8bd15371d35fac48..., retrieved 2026-11-16) still shows SELECT * FROM vector_search( index, { query_text | query_vector }, [ num_results ]); this id read its arguments as positional, while the page's Arguments say all arguments must be passed by name, so the line is now read with named arguments (hand.toml)" + +[[alias]] +from = "db.functions.vector-search.vector-search-2" +to = ["db.functions.vector-search.query-num-results"] +reason = "the pinned functions/vector_search page (page_sha256 8bd15371d35fac48..., retrieved 2026-11-16) still shows SELECT * FROM vector_search( index, query, num_results ); this id read its arguments as positional, while the page's Arguments say all arguments must be passed by name, so the line is now read with named arguments (hand.toml)" + +[[alias]] +from = "db.functions.vector-search.vector-search.syntax" +to = ["db.functions.vector-search.query-num-results"] +reason = "the pinned functions/vector_search page (page_sha256 8bd15371d35fac48..., retrieved 2026-11-16) still shows SELECT * FROM vector_search( index, query, num_results ); this id read its arguments as positional and query as a query, while the page's Arguments say all arguments must be passed by name and query is a STRING, so the line is now read with named arguments (hand.toml)" + +[[alias]] +from = "db.utility.call" +to = ["db.utility.call.call", "db.utility.call.call.syntax"] +reason = "the pinned sql-ref-syntax-aux-call page (page_sha256 7c95f94809b7ff0d..., retrieved 2026-11-16) still shows CALL procedure_name( [ argument [, ...] ] [ namedParameter => argument ] [, ...] ); this id read namedParameter as a keyword and left out the comma between positional and named arguments. hand.toml reads the line as two forms: call.call (positional arguments only, none included) and call.call.syntax (optional positional arguments, a comma, then one or more named ones). Between them they carry every argument list this id read" diff --git a/coverage/syntax-databricks/articles.toml b/coverage/syntax-databricks/articles.toml index c6e97b07d..add87004c 100644 --- a/coverage/syntax-databricks/articles.toml +++ b/coverage/syntax-databricks/articles.toml @@ -269,11 +269,11 @@ article_sha256 = "2b817a2210883e1d3f9c803041f802e6a4e1b11f51ae1ae9728797ef5f1eb7 [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/ai_analyze_sentiment" -article_sha256 = "59e2434f3652c75ca87dc6285918bed0571171b7582cf8a9928895961e95e069" +article_sha256 = "fc2e5b58610b06c7f5c11e78911ee64c0040a37aca14acfea2587f01003be6cb" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/ai_classify" -article_sha256 = "f832e5ca1401c6957c512f469bc9d2b69ac8c03d9f3874e35dd3b279d9fd448a" +article_sha256 = "4a21fa0957d5d2d14e7b9879d45c733d3f38012ea086c9a9eae41711fe319066" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/ai_decide" @@ -285,15 +285,15 @@ article_sha256 = "0b01fb03d6867c707ebca2c84d3bf084de77a6ac6aa7921b6f11ce898a819c [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/ai_enrich" -article_sha256 = "7da30d8006779595fe84b664a3b214f00b4e9992488030cf292239c3d5609c0e" +article_sha256 = "5ee3534d843bc35f8b4cfd04b7f06cd8f733f57a244d376993894acc6ca066cc" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/ai_extract" -article_sha256 = "9fcdf879e0ed52f27c52f36d67e4cec4d768b85074805c18193b783ae516daf2" +article_sha256 = "d58d85a3def5e58d3205db976e3a1b871e2d5a525d5d49d038d4d681fcd289f0" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/ai_fix_grammar" -article_sha256 = "50cc9afbb1d99d60018b07bc0b0caf9a9d88a70827ff7d8afc6044d074e2bd17" +article_sha256 = "5e6cf48895094f019d4b32b26f5314556caa052b013605825fa4d5c8346030a1" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/ai_forecast" @@ -301,7 +301,7 @@ article_sha256 = "71987d85f56aa54225e357c3704934f5a4798deabb5d8045d9220be5201ce3 [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/ai_gen" -article_sha256 = "c0f95e3b5dc8626f61546083a20b5d528c886a6e8be4ce9ac3df8c2347a52691" +article_sha256 = "58fd007927fc8fb5253e549e350a61289d0e9dfcd7da0e26c000242f00d78e70" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/ai_generate_text" @@ -309,11 +309,11 @@ article_sha256 = "4256aa446ed5c614f4791534216d7bea6c60fa3fd36f7a312edcc1b56d7860 [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/ai_mask" -article_sha256 = "1f6e1653db2bb620c01c74c6e3f05dd4ea610016894a79b03aae943ab4a6cefc" +article_sha256 = "1fe5bcc709ad673d5fbf5011c3ef51fd69ceb7930dea8d489be7cdbd605ab69f" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/ai_parse_document" -article_sha256 = "b3c5843165a3c62003142eb602cbec91a566870e68a36739fffe72930a62604c" +article_sha256 = "f9bb73b498d7b336dbd271d51b9c3f3be8566a7b2ba699b6360d940d3cab6683" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/ai_predict_class" @@ -337,11 +337,11 @@ article_sha256 = "9c00f6448dfe256a40aeb8d3fa3f9dce6452f2805067951370485f063d7bd2 [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/ai_similarity" -article_sha256 = "aa2a2352da314730adba233f584d2f0aad7cf8a210fbd059b10aa6147ccb2012" +article_sha256 = "727a26ef75634a332ca975e3bcf97cc532a582e8526e49fdc905da4608c88f27" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/ai_summarize" -article_sha256 = "508ceccd2984359263982ece509c90dd73dd8ecf7981ec2ec447253e05195ba3" +article_sha256 = "d15f1e38df622867ba3da7635144625604f7e7b32f27306981e90ada1a0b51ea" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/ai_top_drivers" @@ -353,7 +353,7 @@ article_sha256 = "011179d6acd8f3a2a7aefbd88beb589ffb5cdd23d2038f56aeeee77d1c2bb3 [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/ai_translate" -article_sha256 = "b51a58cd69904702ec350835fa99c15a9771c70af1c91fdf895500f37f6fe3c2" +article_sha256 = "48c27125d462a41bee27c2eecf156f41382c5d643e9b30fd25604bf74d25cd75" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/ampersandsign" @@ -857,7 +857,7 @@ article_sha256 = "17df74976ca3e245d03c4425eb83d71a497c4b6d41675db484396bfceb23bc [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/date" -article_sha256 = "6804cdda6d3507a0fb40a43c999ed9644ca92ad8654e7daa05d98f06935dcd9b" +article_sha256 = "c32acc22da837fc0a678cf637355219219740dc310e3ec6fcf70f64131ead63c" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/date_add" @@ -1825,7 +1825,7 @@ article_sha256 = "294a2af598ff15e23efd1ef96601350e2c45f22a6a097ffa9e7fd9ff1e37a1 [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/max_by" -article_sha256 = "961ff9aaed6a0b621bdf162ad9f265c86f5041118a53c803b2a4ebc68131f9d2" +article_sha256 = "7e67b957e958ba4cc7743e83d9f329bf5ba44aaa985d9e8f7df95d880e014552" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/md5" @@ -1849,7 +1849,7 @@ article_sha256 = "30f0242e857e4268f3586ce3881cab6eccf74217f575c3bb3123502b975fcc [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/min_by" -article_sha256 = "f1d9812369ae5faef8bcdf22f311781585359ad65795b9c47c18aff64127461d" +article_sha256 = "520d7b587d941bec73700b1daa192f4cd1b16553ff524389d4227e0b57479956" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/minussign" @@ -2077,7 +2077,7 @@ article_sha256 = "9b5d4dad2fdbb851e760de528c6a42135ff9b45a2adec82eaa2313d5885f23 [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/read_files" -article_sha256 = "03dd58a8b47efadb51a304615936b4f08d00b2bb23e48a854e7cec276cf9ae80" +article_sha256 = "7e71a9f1686ed82464efde6ea1f00d55579937a1718f1647e8f08313457d0c0f" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/read_kafka" @@ -2085,11 +2085,11 @@ article_sha256 = "359c4b95c9392ae6a14a4ae3eaafe6017badfe244d9139baf492d6285f41a9 [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/read_kinesis" -article_sha256 = "b52265da2dacc9b8e4295cdcb53d63dab186798820cdd8b94d4c549f9da2216e" +article_sha256 = "dacff0b6b08f3ec24f10b6a4a1eec0740c44feee5ddd716379bcf312884c99fe" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/read_pubsub" -article_sha256 = "82c6519e6e383eba03eee0b425dd0ef1dcc2b64830362fbe78fa5b964a3cf1b4" +article_sha256 = "d57710a87804328751ab5254c5391eb985657146c3845ff004f2cdeca02f59bd" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/read_pulsar" @@ -2265,7 +2265,7 @@ article_sha256 = "ac1c24e40f93fa8ad8800625828a9f48eb96cd0e9aba72f9c103e312c98c8d [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/secret" -article_sha256 = "36ebbdc92806c2248be1b3cbd647f323674ad6ded20c4a553838413bab0e0bdb" +article_sha256 = "f05db6d3cdf469f3a5632dfe4c699f7277fab1d81f0a5076dc49504dfbe93fb8" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/sentences" @@ -3429,7 +3429,7 @@ article_sha256 = "b0b05072bc57614c41bc7461f5a6638173cf2ceacf08a7173fda2948838820 [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/window" -article_sha256 = "4ff4e213b6bbf2097b84e37d1bfa741f6431751e6d97a8b21ba20da7ce4a902e" +article_sha256 = "d19f6aa31042512101a5b66d6b4fb666f7d78d9523ce1bbde4ee9007dbcd7d58" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/functions/window_time" @@ -4245,7 +4245,7 @@ article_sha256 = "8d29fff32213a31b6ec91449b4f5566cb97ea9d6d7fbcc1fce7f0ee4f42826 [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/sql-ref-syntax-aux-show-volumes-dropped" -article_sha256 = "9ec4f7ea9e8873b8496d595b2100578ae6e12304f4ab0615e95c7bd69b858d7f" +article_sha256 = "a4306f1fa6e4f5452b946a6d9d9611ca6db46eb887f88dc82b0ec0928dcffba8" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/sql-ref-syntax-aux-sync" @@ -4413,15 +4413,15 @@ article_sha256 = "1c514640fe87c19ac6344c15e9fa99496f50bada34a3a37545ec14c1a585b4 [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/sql-ref-syntax-ddl-create-sql-function" -article_sha256 = "f8c98b8a0af433d81785bb7ca35dfe8f7816cc5b8df1752ef1333a4ebf8ab0fe" +article_sha256 = "979444d82fc697c6cffb42a85a4544fe2497d57a184c8bdedfd4598fcfd88c17" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/sql-ref-syntax-ddl-create-streaming-table" -article_sha256 = "c54c85679d317925e97c72939c5315883173f724cfddcc181d1669e392345fbd" +article_sha256 = "429b0d427b3c9e66fd41f8b5bf65e0e6b1beb143a0aa6298e9b2bfb276413d9c" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/sql-ref-syntax-ddl-create-streaming-table-auto-cdc" -article_sha256 = "56336639a20c68194ed0771b5a5368ee5943814ce2999d94380805d230eedb20" +article_sha256 = "fbd75eb9f445838a860926792b493ba6c41a2a7d40df3b7c4eb17afb3063c123" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/sql-ref-syntax-ddl-create-table" @@ -4441,7 +4441,7 @@ article_sha256 = "39ef6c010b7abdd8896b17aedb6bbabbd7d3dcb498d7b148fe01828221b4c3 [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/sql-ref-syntax-ddl-create-table-using" -article_sha256 = "5274dace556673f906dddc68afb930d0f105451144975b4c99ba01740d2bb206" +article_sha256 = "0f15f08135ad8060cc3d59eb6ff7d4b524cf9f585577089670c3396df2f57161" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/sql-ref-syntax-ddl-create-view" @@ -4553,11 +4553,11 @@ article_sha256 = "4c4a5d6bd87e673bc13f14c5b37fa6c3b6248edabf75304742cf23dcde8353 [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/sql-ref-syntax-ddl-undrop-table" -article_sha256 = "d8157a9accb600fa97978ea21e47c91f2393bb1a16b31a95a9fbcfc90263d30a" +article_sha256 = "8dd02354c848cef99785401b00b938dee67805f6bcf60f22ae3ba3debdcea3c3" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/sql-ref-syntax-ddl-undrop-volume" -article_sha256 = "9d2a02f4db923bd30860863e607234ee46705ea32f253e53c56d97a7f7d26234" +article_sha256 = "0db45d44af8a984d11a3eb2b5d18efe086119a421713667b718fbbab4a7b3453" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/sql-ref-syntax-ddl-unset-tag" @@ -4717,7 +4717,7 @@ article_sha256 = "4cda2589b5e4baa428af1c183b870e4d09a4d44692c542fd9f9561cd709a3e [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/sql-ref-syntax-qry-select-unpivot" -article_sha256 = "fbbea26372466b0e8b785b8f35b0c1bb47bd26c2c6695af8f6bb5df8c0bf21cb" +article_sha256 = "7455935864ce2b67d8907f894099f70236594c5873ac0c6f2ddc8383891f73b9" [[article]] url = "https://docs.databricks.com/aws/en/sql/language-manual/sql-ref-syntax-qry-select-values" diff --git a/coverage/syntax-databricks/audit.toml b/coverage/syntax-databricks/audit.toml index b66cb8b5f..afb38825e 100644 --- a/coverage/syntax-databricks/audit.toml +++ b/coverage/syntax-databricks/audit.toml @@ -2659,14 +2659,6 @@ sequences = [ ] reason = "undocumented: !< as a spelling of >=; the comparison operator pages write >= only" -[[gap]] -rule = "primaryExpression" -alternative = 17 -sequences = [ - "… : .", -] -reason = "prose: sql-ref-json-path-expression names the : operator in its text; its syntax block writes the path after it, which the audit reads as no keyword" - [[gap]] rule = "unitInMultiUnits" alternative = 1 diff --git a/coverage/syntax-databricks/catalogue/expressions.toml b/coverage/syntax-databricks/catalogue/expressions.toml index 4f97564d4..f60fe500b 100644 --- a/coverage/syntax-databricks/catalogue/expressions.toml +++ b/coverage/syntax-databricks/catalogue/expressions.toml @@ -773,9 +773,9 @@ source = "doc.data-types.null-type" anchor = "Syntax" kind = "special" grammar = [ - "{ NULL | VOID }", + "VOID", ] -grammar_sha256 = "050ca33f86bbbc40749712bd7d3d91cf8e878b3841fb9ac7c08763166d56f51a" +grammar_sha256 = "90251d5ff4018bf08f45ca85f613ed0b18d830f5f84b424197ea13620e87fa11" uses = [] status = "catalogued" diff --git a/coverage/syntax-databricks/catalogue/functions.toml b/coverage/syntax-databricks/catalogue/functions.toml index 382a413ae..74c7c48cd 100644 --- a/coverage/syntax-databricks/catalogue/functions.toml +++ b/coverage/syntax-databricks/catalogue/functions.toml @@ -1883,11 +1883,11 @@ id = "db.functions.current-date" family = "functions" source = "doc.functions.current_date" anchor = "Syntax" -kind = "call" +kind = "special" grammar = [ - "CURRENT_DATE ( )", + "CURRENT_DATE [ ( ) ]", ] -grammar_sha256 = "3c1ef798e6bd171883d46b6d301a20e3dca631ae1d6de20c0c478c56ea2d4b59" +grammar_sha256 = "64872e3078e7042cb1bed88691b77f7c8179db378d4c1e363f6c8f7bc78b9bdd" uses = [] status = "catalogued" @@ -1922,11 +1922,11 @@ id = "db.functions.current-path" family = "functions" source = "doc.functions.current_path" anchor = "Syntax" -kind = "call" +kind = "special" grammar = [ - "CURRENT_PATH ( )", + "CURRENT_PATH [ ( ) ]", ] -grammar_sha256 = "04eefb33b99b40c064ff01a0a450b2f75c956a68d5978f56f4e6074ccdc23c07" +grammar_sha256 = "fc6dacf11cd6b41b34f8fa4e9fe55949e11153d742e1893b299f9ebd49bc29ce" uses = [] status = "catalogued" @@ -1974,11 +1974,11 @@ id = "db.functions.current-time" family = "functions" source = "doc.functions.current_time" anchor = "Syntax" -kind = "call" +kind = "special" grammar = [ - "CURRENT_TIME ( [ ] )", + "CURRENT_TIME [ ( [ ] ) ]", ] -grammar_sha256 = "f40202d9d205dbbb6123cd290450c18bab565cec2c0cbce9536e9d4653b7b1ec" +grammar_sha256 = "01d47a23c12384631f817d88cb2b9c6d4f90b193dc9e10e6d0233fdbcb4d3688" uses = [] status = "catalogued" @@ -1987,11 +1987,11 @@ id = "db.functions.current-timestamp" family = "functions" source = "doc.functions.current_timestamp" anchor = "Syntax" -kind = "call" +kind = "special" grammar = [ - "CURRENT_TIMESTAMP ( [ ] )", + "CURRENT_TIMESTAMP [ ( [ ] ) ]", ] -grammar_sha256 = "7c9019ac0e0b3751722cfb6aac59441d5c611174fd4e197647b150ef25507198" +grammar_sha256 = "dd1f9dcbca60f0a966e7a278bfd8ccf814b8c9903f0acd01032be949af2f4b20" uses = [] status = "catalogued" @@ -2013,11 +2013,11 @@ id = "db.functions.current-user" family = "functions" source = "doc.functions.current_user" anchor = "Syntax" -kind = "call" +kind = "special" grammar = [ - "CURRENT_USER ( )", + "CURRENT_USER [ ( ) ]", ] -grammar_sha256 = "34c1034281dfc167d7772482d38c6f794fbac8df085560d6265bb0f0bd69096c" +grammar_sha256 = "4e585576207b002aeb0ca4cbb88b563733676b08c6e4e0497155c12b85d5f813" uses = [] status = "catalogued" @@ -4811,11 +4811,11 @@ id = "db.functions.localtime" family = "functions" source = "doc.functions.localtime" anchor = "Syntax" -kind = "call" +kind = "special" grammar = [ - "LOCALTIME ( [ ] )", + "LOCALTIME [ ( [ ] ) ]", ] -grammar_sha256 = "7488d6698966928342dd8e8dbc868a859604e1aebaaf8fce69142ed66e7429c2" +grammar_sha256 = "f26aad28e47f48ef8bba2c36e4d62497566ee3d33e1c87cac0c759f7aa636ad6" uses = [] status = "catalogued" @@ -6895,11 +6895,11 @@ id = "db.functions.session-user" family = "functions" source = "doc.functions.session_user" anchor = "Syntax" -kind = "call" +kind = "special" grammar = [ - "SESSION_USER ( )", + "SESSION_USER [ ( ) ]", ] -grammar_sha256 = "47dd3548a757a22233369c36f2ae5d89a5ad360c42aa2a7236c4a338bf6bac85" +grammar_sha256 = "4c0aa5a9adfd6541b5b609b3850b5d2c05c5e80bc98ff799a7dab6b7b662dc2e" uses = [] status = "catalogued" @@ -10520,11 +10520,11 @@ id = "db.functions.user" family = "functions" source = "doc.functions.user" anchor = "Syntax" -kind = "call" +kind = "special" grammar = [ - "USER ( )", + "USER [ ( ) ]", ] -grammar_sha256 = "e7df433c0dd7eb84f305cbcd2a209a0c9d2a6c7455678931c817a7ba292d82ca" +grammar_sha256 = "ea80c1db825c408e9977e56a9c6821956114f52227aec6aa64319a4ee32ef0e3" uses = [] status = "catalogued" @@ -10736,6 +10736,32 @@ grammar_sha256 = "d4f1d6d59131d2946c37cbb92513633531e4f08a8b0a00a1287dbefb14c7a6 uses = [] status = "absent_from_source" +[[form]] +id = "db.functions.vector-search.query-num-results" +family = "functions" +source = "doc.functions.vector_search" +anchor = "Syntax" +kind = "special" +grammar = [ + "SELECT * FROM VECTOR_SEARCH ( index => , query => , num_results => )", +] +grammar_sha256 = "d078a76374307963108eaf3f54c2e9737eba2ca0436346b6e1bf18fe7c7184cf" +uses = [] +status = "catalogued" + +[[form]] +id = "db.functions.vector-search.query-text-query-vector" +family = "functions" +source = "doc.functions.vector_search" +anchor = "Syntax" +kind = "special" +grammar = [ + "SELECT * FROM VECTOR_SEARCH ( index => , { query_text => | query_vector => } [ , num_results => ] )", +] +grammar_sha256 = "100608088b093479839aa1d52cb76782f4cb28419d59cf5957aeae4516d3afc0" +uses = [] +status = "catalogued" + [[form]] id = "db.functions.vector-search.vector-search" family = "functions" @@ -10747,7 +10773,7 @@ grammar = [ ] grammar_sha256 = "7ffd8a2cc8224e3a91c687b9bbb3327daed719f8e04c4f3edd874eea3e0750d8" uses = [] -status = "catalogued" +status = "absent_from_source" [[form]] id = "db.functions.vector-search.vector-search-2" @@ -10760,7 +10786,7 @@ grammar = [ ] grammar_sha256 = "558c0f1e203fee83e3228e440842d64278eed43cd366babb554057212ee80cfe" uses = [] -status = "catalogued" +status = "absent_from_source" [[form]] id = "db.functions.vector-search.vector-search.syntax" diff --git a/coverage/syntax-databricks/catalogue/security_admin.toml b/coverage/syntax-databricks/catalogue/security_admin.toml index 4738e5ed6..5709f86b0 100644 --- a/coverage/syntax-databricks/catalogue/security_admin.toml +++ b/coverage/syntax-databricks/catalogue/security_admin.toml @@ -184,9 +184,9 @@ source = "doc.security-show-grant-on-share" anchor = "Syntax" kind = "statement" grammar = [ - "SHOW GRANTS ON SHARE", + "SHOW GRANTS ON SHARE ", ] -grammar_sha256 = "144e568d66c91368dcf0a8a030eeabc83d4d4f28f5037b9be0b1425409d26970" +grammar_sha256 = "667035191f701c4a43ff52e8b1d7d1aaa8d6e1795f6da5c0c8053ac91a433d30" uses = [] status = "catalogued" diff --git a/coverage/syntax-databricks/catalogue/transaction_session.toml b/coverage/syntax-databricks/catalogue/transaction_session.toml index 80ebf78bf..01ca22116 100644 --- a/coverage/syntax-databricks/catalogue/transaction_session.toml +++ b/coverage/syntax-databricks/catalogue/transaction_session.toml @@ -46,9 +46,9 @@ source = "doc.parameters.collation" anchor = "Setting" kind = "statement" grammar = [ - "SET COLLATION = ", + "SET COLLATION ", ] -grammar_sha256 = "7ce6093358e7db619f3239cc555e7afda04d879c1a34dea76fec24eefab22b3b" +grammar_sha256 = "67e8796199f93a9318fc75edae28aaa48158edd91f2a2738d1c70668eb22ae7d" uses = [] status = "catalogued" @@ -334,9 +334,9 @@ source = "doc.sql-ref-syntax-ddl-use-catalog" anchor = "Syntax" kind = "statement" grammar = [ - "{ USE | SET } CATALOG [ | ' catalog_name ' ]", + "{ USE | SET } CATALOG { | ' catalog_name ' }", ] -grammar_sha256 = "4ea3441f47f0f032b43a5a462581831340e30e82f93a2d756cafe467d4fee2cf" +grammar_sha256 = "edcc74ba9ace1b4ec1ed9714c06de2b7e8991420095e22bfc0b689b3fa1612cf" uses = [] status = "catalogued" diff --git a/coverage/syntax-databricks/dialect.toml b/coverage/syntax-databricks/dialect.toml index 297508d4a..24d4cc246 100644 --- a/coverage/syntax-databricks/dialect.toml +++ b/coverage/syntax-databricks/dialect.toml @@ -6,3 +6,4 @@ receipt_format = "sqlquack-syntax-receipt/2" parser_path = "crates/sqlquack-syntax-databricks" local_parser = "databricks" syntax_codes = ["42601", "42617", "0A000", "22023", "23505", "42000", "42604", "42KD2", "PARSE"] +engine_pin = "2026.45" diff --git a/coverage/syntax-databricks/hand.toml b/coverage/syntax-databricks/hand.toml index 1dece99f3..c01ae71df 100644 --- a/coverage/syntax-databricks/hand.toml +++ b/coverage/syntax-databricks/hand.toml @@ -102,7 +102,7 @@ anchor = "Setting" kind = "statement" label = "collation" grammar = [ - "SET COLLATION = ", + "SET COLLATION ", ] basis = "prose" article_sha256 = "27c64af1e54826eec1fd2a7a45e4dd4cdbd4eb5e3094faed93e79f14bde6851b" @@ -1001,6 +1001,14 @@ read = [ ] reason = "braces for brackets: the block makes TEMP or TEMPORARY required after REPLACE, while the page's parameters describe CREATE OR REPLACE TABLE for tables that are not temporary (IF NOT EXISTS cannot coexist with REPLACE); read with TEMP optional" +[[reading]] +page = "data-types/null-type" +written = "{ NULL | VOID }" +read = [ + "VOID", +] +reason = "the page names the type NULL or VOID, but only VOID is a type spelling: in type position the warehouse accepts CAST ( NULL AS VOID ) and refuses CAST ( NULL AS NULL ) while parsing (both recorded), and a bare NULL or VOID in an expression is the null literal or a column; read as the VOID type, checked in type position, with the NULL spelling kept as an observed limit" + [[reading]] page = "data-types/interval-type" written = " - INTERVAL [ + | - ] " @@ -1064,17 +1072,17 @@ reason = "the page's Syntax names st_asbinary, another function, and the build r page = "functions/vector_search" written = "SELECT * FROM ( , { | } , [ ] )" read = [ - "SELECT * FROM VECTOR_SEARCH ( , { | } , [ ] )", + "SELECT * FROM VECTOR_SEARCH ( index => , { query_text => | query_vector => } [ , num_results => ] )", ] -reason = "the lower-case function name vector_search was read as a placeholder; read as the function the page defines" +reason = "the lower-case function name vector_search was read as a placeholder; read as the function the page defines. The page's Arguments say all arguments must be passed by name (vector_search(index => indexName, query_text => queryText)), so each is written named, and the comma printed before the optional num_results is part of it" [[reading]] page = "functions/vector_search" written = "SELECT * FROM ( , , )" read = [ - "SELECT * FROM VECTOR_SEARCH ( , , )", + "SELECT * FROM VECTOR_SEARCH ( index => , query => , num_results => )", ] -reason = "the lower-case function name vector_search was read as a placeholder; read as the function the page defines. The argument named query is a STRING expression (the page's Arguments), not a query, though the build classes a placeholder named query as one; read with a name it classes as an expression" +reason = "the lower-case function name vector_search was read as a placeholder; read as the function the page defines. The page's Arguments say all arguments must be passed by name, so each is written named. The argument named query is a STRING expression (the page's Arguments), not a query, though the build classes a placeholder named query as one; read with a name it classes as an expression" [[reading]] page = "functions/ai_parse_document" @@ -1331,7 +1339,7 @@ grammar = [ "FLOW AUTO CDC [ ONCE ] FROM SNAPSHOT ( ) [ WITH VERSION ( ) ] KEYS ( [ , ... ] ) [ STORED AS { SCD TYPE 1 | SCD TYPE 2 } ] [ TRACK HISTORY ON { | * EXCEPT ( ) } ]", ] basis = "section" -article_sha256 = "56336639a20c68194ed0771b5a5368ee5943814ce2999d94380805d230eedb20" +article_sha256 = "fbd75eb9f445838a860926792b493ba6c41a2a7d40df3b7c4eb17afb3063c123" [[reading]] page = "sql-ref-syntax-aux-describe-provider" @@ -1429,3 +1437,83 @@ read = [ " [ NOT ] LIKE { ANY | SOME | ALL } ( [ , ... ] )", ] reason = "the page's line wraps the pattern list in an optional bracket, so ( ) with no pattern would be a form, but the warehouse refuses it while parsing (EMPTY_QUANTIFIED_PATTERN, the == SQL == excerpt); read with the list required, so the empty list is a negative case" + +[[reading]] +page = "functions/current_date" +written = "CURRENT_DATE ( )" +read = [ + "CURRENT_DATE [ ( ) ]", +] +reason = "the page says the braces are optional; read with the parentheses optional" + +[[reading]] +page = "functions/current_path" +written = "CURRENT_PATH ( )" +read = [ + "CURRENT_PATH [ ( ) ]", +] +reason = "the page says the parentheses are optional; read with them optional" + +[[reading]] +page = "functions/current_user" +written = "CURRENT_USER ( )" +read = [ + "CURRENT_USER [ ( ) ]", +] +reason = "the page says the braces are optional; read with the parentheses optional" + +[[reading]] +page = "functions/session_user" +written = "SESSION_USER ( )" +read = [ + "SESSION_USER [ ( ) ]", +] +reason = "the page says the braces are optional; read with the parentheses optional" + +[[reading]] +page = "functions/user" +written = "USER ( )" +read = [ + "USER [ ( ) ]", +] +reason = "the page says the braces are optional; read with the parentheses optional" + +[[reading]] +page = "functions/current_time" +written = "CURRENT_TIME ( [ ] )" +read = [ + "CURRENT_TIME [ ( [ ] ) ]", +] +reason = "the page says the parentheses are optional when no precision is given; read with them optional" + +[[reading]] +page = "functions/current_timestamp" +written = "CURRENT_TIMESTAMP ( [ ] )" +read = [ + "CURRENT_TIMESTAMP [ ( [ ] ) ]", +] +reason = "the page says the parentheses are optional when no precision is given; read with them optional" + +[[reading]] +page = "functions/localtime" +written = "LOCALTIME ( [ ] )" +read = [ + "LOCALTIME [ ( [ ] ) ]", +] +reason = "the page says the parentheses are optional when precision is omitted; read with them optional" + +[[reading]] +page = "security-show-grant-on-share" +written = "SHOW GRANTS ON SHARE" +read = [ + "SHOW GRANTS ON SHARE ", +] +reason = "the page's Syntax line omits the share name that its Parameters list (share_name) and its example (SHOW GRANTS ON SHARE shared_date) write; the warehouse reads SHOW GRANTS ON SHARE alone as grants on a table named share (TABLE_DOES_NOT_EXIST, recorded); read with the name" + +[[reading]] +page = "sql-ref-syntax-ddl-use-catalog" +written = "{ USE | SET } CATALOG [ | ' catalog_name ' ]" +read = [ + "{ USE | SET } CATALOG { | ' catalog_name ' }", +] +reason = "the brackets choose between the name and its string; the page's Parameters give catalog_name as the catalog to use and every example writes one, and the warehouse reads USE CATALOG alone as USE of a schema named catalog (SCHEMA_NOT_FOUND workspace.catalog) and SET CATALOG alone as a configuration key (CONFIG_NOT_AVAILABLE CATALOG), both recorded; read with the name required" diff --git a/coverage/syntax-databricks/indexes.toml b/coverage/syntax-databricks/indexes.toml index 84741c812..af62ecbf7 100644 --- a/coverage/syntax-databricks/indexes.toml +++ b/coverage/syntax-databricks/indexes.toml @@ -5,12 +5,12 @@ # of the XML as fetched, a record of the fetch rather than a pin. [[index]] -name = "https://docs.databricks.com/aws/en/sitemap.xml (retrieved 2026-11-06T17:53:22Z)" -sha256 = "2709cf3fe294a163a44b4e45b8b358ee085712816d3a501151a225271bdb910c" +name = "https://docs.databricks.com/aws/en/sitemap.xml (retrieved 2026-11-16T07:55:39Z)" +sha256 = "11d0a1dc601c15a346d5b4573f9b5c043ac35eaa8687375e07c0211668b43d97" [[index]] -name = "language-manual page set: 1191 pages as `
` lines (Databricks SQL 2026.44)" -sha256 = "4e0530887a5bc142869a1a452947bea7d06248ffa6b89f8a9f3e78a57660abd0" +name = "language-manual page set: 1191 pages as `
` lines (Databricks SQL 2026.45)" +sha256 = "250b3f3052922e09e895a4dc6feef1357ab35c0805e87a844474f1071b7aea9f" [[index]] name = "apache/spark v4.2.0 (32f7299601108917fb01920a54e084595b7b3bf8) sql/api/src/main/antlr4/org/apache/spark/sql/catalyst/parser/SqlBaseLexer.g4" diff --git a/coverage/syntax-databricks/limits.toml b/coverage/syntax-databricks/limits.toml index 5c1490add..e803a7173 100644 --- a/coverage/syntax-databricks/limits.toml +++ b/coverage/syntax-databricks/limits.toml @@ -99,26 +99,32 @@ reason = "the warehouse refuses DROP without COLUMN or COLUMNS (SqlBaseParser #d [[reading]] form = "db.ddl.alter-table-manage-column.alter-change-set-mask" grammar_sha256 = "02e014fa5b99e0ba0edda62bf5de1ff76fdf9cf965698269de7e9eff74b686bf" -grammar = ["{ { ALTER | CHANGE } [ COLUMN ] { | } { SET { MASK } | DROP MASK } | ALTER COLUMN { | } { SET TAGS | UNSET TAGS } }"] -reason = "the warehouse takes SET TAGS and UNSET TAGS on a column only after ALTER COLUMN (it refuses them after ALTER without COLUMN and after CHANGE), while MASK takes every spelling; the other documented spellings of the tag clauses are kept as observed [[limit]] rows" +grammar = ["{ { ALTER | CHANGE } [ COLUMN ] { SET { MASK } | { | } DROP MASK } | ALTER COLUMN { SET TAGS | UNSET TAGS } }"] +reason = "the warehouse takes SET TAGS and UNSET TAGS on a column only after ALTER COLUMN (it refuses them after ALTER without COLUMN and after CHANGE), while MASK takes every spelling; the other documented spellings of the tag clauses are kept as observed [[limit]] rows. It refuses a nested before SET MASK, SET TAGS and UNSET TAGS while parsing and takes it before DROP MASK, so is read into DROP MASK alone and the field forms of the other clauses are observed [[limit]] rows" [[reading]] form = "db.ddl.create-table-using" grammar_sha256 = "b555b7b70d4132aa75c81052664d03c7f2a7987d9912e0396dbf7c90301e26db" -grammar = ["{ [ CREATE OR ] REPLACE TABLE | CREATE [ EXTERNAL ] TABLE [ IF NOT EXISTS ] } { [ ] [ USING ] [ ] | [ USING ] [ ] AS }", "{ [ CREATE OR ] REPLACE { TEMP | TEMPORARY } TABLE | CREATE { TEMP | TEMPORARY } TABLE } { [ ] [ COMMENT | TBLPROPERTIES | DEFAULT COLLATION ] [ ... ] | [ COMMENT | TBLPROPERTIES | DEFAULT COLLATION ] [ ... ] AS }"] -reason = "a temporary table is its own line: 'When creating or replacing a temporary table, don't specify a data source in the USING clause or a LOCATION clause. The following clauses are not supported: PARTITIONED BY, CLUSTER BY, and row-level filters', and the USING, CLUSTERED BY and LOCATION parameters each repeat that they are not supported for temporary tables, so the temporary line takes no USING and only the table clauses the page leaves it (OPTIONS sets data-source options, which a temporary table has no data source for); the permanent line keeps every clause. The page: 'If you do not define columns the table schema you must specify either AS query or LOCATION', and the parser refuses both ('Schema may not be specified in a Create Table As Select (CTAS) statement'), so table_specification and AS query are alternatives; the documented combination is kept as an observed [[limit]] row" +grammar = ["{ [ CREATE OR ] REPLACE TABLE | CREATE [ EXTERNAL ] TABLE [ IF NOT EXISTS ] } { [ ] [ USING ] [ ] | [ USING ] [ ] AS }", "{ [ CREATE OR ] REPLACE { TEMP | TEMPORARY } TABLE | CREATE { TEMP | TEMPORARY } TABLE } { [ ] [ OPTIONS | COMMENT | TBLPROPERTIES | DEFAULT COLLATION ] [ ... ] | [ OPTIONS | COMMENT | TBLPROPERTIES | DEFAULT COLLATION ] [ ... ] AS }"] +reason = "a temporary table is its own line: 'When creating or replacing a temporary table, don't specify a data source in the USING clause or a LOCATION clause. The following clauses are not supported: PARTITIONED BY, CLUSTER BY, and row-level filters', and the USING, CLUSTERED BY and LOCATION parameters each repeat that they are not supported for temporary tables, so the temporary line takes no USING and only the table clauses the page leaves it, OPTIONS among them (the warehouse accepts CREATE TEMP TABLE t3 ( c1 INT ) OPTIONS ( 'k' = 'v' ), recorded as an observed [[limit]] row); the permanent line keeps every clause. The page: 'If you do not define columns the table schema you must specify either AS query or LOCATION', and the parser refuses both ('Schema may not be specified in a Create Table As Select (CTAS) statement'), so table_specification and AS query are alternatives; the documented combination is kept as an observed [[limit]] row" [[reading]] form = "db.ddl.create-view.temporary-view-using" grammar_sha256 = "3f0891d2b8f44f8307c7918b5a8218970cf40540a077c618934ae8623101b578" grammar = ["CREATE [ OR REPLACE ] TEMPORARY VIEW [ ] USING [ OPTIONS ( [ = ] [ , ... ] ) ]"] -reason = "the warehouse refuses IF NOT EXISTS in a data-source temporary view (PARSE_SYNTAX_ERROR at USING; SqlBaseParser #createTempViewUsing has no IF NOT EXISTS), so the documented IF NOT EXISTS is kept as an observed [[limit]] row. GLOBAL TEMPORARY carries the banner 'Applies to: Databricks Runtime' (the page's GLOBAL TEMPORARY parameter), and the pinned engine is a Databricks SQL warehouse, so GLOBAL leaves the derivation and the documented global temporary views are observed [[limit]] rows" +reason = "the warehouse refuses IF NOT EXISTS in a data-source temporary view (PARSE_SYNTAX_ERROR at USING; SqlBaseParser #createTempViewUsing has no IF NOT EXISTS), so the documented IF NOT EXISTS is kept as an observed [[limit]] row. GLOBAL TEMPORARY carries the banner 'Applies to: Databricks Runtime' (the page's GLOBAL TEMPORARY parameter), and the pinned engine is a Databricks SQL warehouse, so GLOBAL leaves the derivation and the documented global temporary views are observed [[limit]] rows. is a list of typed columns, ( c1 INT ), as SqlBaseParser #createTempViewUsing reads it (tableIdentifier (LEFT_PAREN colTypeList RIGHT_PAREN)? tableProvider), unlike a query view's list of names" + +[[reading]] +form = "db.functions.remote-query" +grammar_sha256 = "797d1f3dc9d31bb2b2711d33a086691b6fa9978569c31ff11ff463115bd42c1b" +grammar = ["REMOTE_QUERY ( [ , => ] [ ... ] )"] +reason = "connectorOptionKey is an argument, not a keyword (the page's Arguments: 'connectorOptionKey A connector option key which is a case-sensitive identifier'): read as the placeholder , filled with the page's own name for it" [[reading]] form = "db.ddl.create-table-hiveformat" grammar_sha256 = "d1379144d49ba5cb74288772d4b20346d3c1752da635bcb06e116dcc491b55dd" -grammar = ["CREATE [ EXTERNAL ] TABLE [ IF NOT EXISTS ] [ ( [ COMMENT ] , ... ) ] [ COMMENT ] [ PARTITIONED BY { ( [ COMMENT ] , ... ) | ( , , ... ) } ] [ ROW FORMAT ] [ STORED AS { | INPUTFORMAT OUTPUTFORMAT } ] [ LOCATION ] [ TBLPROPERTIES ( = , = , ... ) ]", "CREATE [ EXTERNAL ] TABLE [ IF NOT EXISTS ] [ COMMENT ] [ PARTITIONED BY ( , , ... ) ] [ ROW FORMAT ] [ STORED AS { | INPUTFORMAT OUTPUTFORMAT } ] [ LOCATION ] [ TBLPROPERTIES ( = , = , ... ) ] AS "] -reason = "PARTITIONED BY takes either new typed partition columns or a list of the table's own columns (the page's Parameters: 'Partitions are created on the table, based on the columns specified'; SqlBaseParser createTableClauses: PARTITIONED BY partitionFieldList, whose field is a column or a typed column); the page's line omits the braces that bind the alternative to PARTITIONED BY. The warehouse refuses the documented [ : ] between a column's name and type (PARSE_SYNTAX_ERROR at ':'), so the colon is kept as observed [[limit]] rows. The parser refuses a column list with AS select_statement ('Schema may not be specified in a Create Table As Select (CTAS) statement'), so a table with AS is its own line without the column list, and it refuses typed partition columns there ('Partition column types may not be specified in Create Table As Select (CTAS)'), so that line partitions by the query's columns; both combinations are kept as observed [[limit]] rows. STORED AS takes a file format or, as the page's STORED AS parameter says, 'your own input and output formats through INPUTFORMAT and OUTPUTFORMAT' (SqlBaseParser fileFormat: INPUTFORMAT inFmt=stringLit OUTPUTFORMAT outFmt=stringLit | simpleIdentifier). The page says 'The clauses between the column definition clause and the AS SELECT clause can appear in any order'; the line fixes the page's order, so each pair of those clauses in the other order is a hand-written interaction [[limit]] row" +grammar = ["CREATE [ EXTERNAL ] TABLE [ IF NOT EXISTS ] [ ( [ COMMENT ] , ... ) ] [ COMMENT ] [ PARTITIONED BY { ( [ COMMENT ] , ... ) | ( , , ... ) } ] { ROW FORMAT [ STORED AS { | INPUTFORMAT OUTPUTFORMAT } ] | STORED AS { | INPUTFORMAT OUTPUTFORMAT } } [ LOCATION ] [ TBLPROPERTIES ( = , = , ... ) ]", "CREATE [ EXTERNAL ] TABLE [ IF NOT EXISTS ] [ COMMENT ] [ PARTITIONED BY ( , , ... ) ] { ROW FORMAT [ STORED AS { | INPUTFORMAT OUTPUTFORMAT } ] | STORED AS { | INPUTFORMAT OUTPUTFORMAT } } [ LOCATION ] [ TBLPROPERTIES ( = , = , ... ) ] AS "] +reason = "PARTITIONED BY takes either new typed partition columns or a list of the table's own columns (the page's Parameters: 'Partitions are created on the table, based on the columns specified'; SqlBaseParser createTableClauses: PARTITIONED BY partitionFieldList, whose field is a column or a typed column); the page's line omits the braces that bind the alternative to PARTITIONED BY. The warehouse refuses the documented [ : ] between a column's name and type (PARSE_SYNTAX_ERROR at ':'), so the colon is kept as observed [[limit]] rows. The parser refuses a column list with AS select_statement ('Schema may not be specified in a Create Table As Select (CTAS) statement'), so a table with AS is its own line without the column list, and it refuses typed partition columns there ('Partition column types may not be specified in Create Table As Select (CTAS)'), so that line partitions by the query's columns; both combinations are kept as observed [[limit]] rows. STORED AS takes a file format or, as the page's STORED AS parameter says, 'your own input and output formats through INPUTFORMAT and OUTPUTFORMAT' (SqlBaseParser fileFormat: INPUTFORMAT inFmt=stringLit OUTPUTFORMAT outFmt=stringLit | simpleIdentifier). The page says 'The clauses between the column definition clause and the AS SELECT clause can appear in any order'; the line fixes the page's order, so each pair of those clauses in the other order is a hand-written interaction [[limit]] row. The page's note: 'You must specify either the STORED AS or ROW FORMAT clause. Otherwise, the SQL parser uses the CREATE TABLE [USING] syntax to parse it', so the Hive form requires one of the two and a statement with neither belongs to CREATE TABLE [USING]" [[reading]] form = "db.ddl.create-view.view-as" @@ -135,8 +141,134 @@ reason = "the page's Parameters say of { INNER | LEFT [ OUTER ] }: 'Optional. Th [[reading]] form = "db.ddl.clone.clone-source-temporal" grammar_sha256 = "3c61815adf322d93115205650c91bacdfc29bda80e5c3865ef2bb2426f8b1811" -grammar = ["{ CREATE TABLE [ IF NOT EXISTS ] | [ CREATE OR ] REPLACE TABLE } [ SHALLOW | DEEP ] CLONE { [ FOR ] TIMESTAMP AS OF | [ FOR ] VERSION AS OF } [ WITH ( { [ = ] } [ , ... ] ) ]", "{ CREATE TABLE [ IF NOT EXISTS ] | [ CREATE OR ] REPLACE TABLE } [ SHALLOW | DEEP ] CLONE WITH ( { [ = ] } [ , ... ] )"] -reason = "the names page spells the temporal specification [ FOR ] { SYSTEM_TIMESTAMP | TIMESTAMP } AS OF and [ FOR ] { SYSTEM_VERSION | VERSION } AS OF, while SqlBaseParser temporalClause spells FOR? (SYSTEM_VERSION | VERSION) AS OF and FOR? (SYSTEM_TIME | TIMESTAMP) AS OF: the two sources agree on TIMESTAMP and VERSION only, so those are derived, and SYSTEM_TIMESTAMP, SYSTEM_VERSION and Spark's SYSTEM_TIME are observed [[limit]] rows that a receipt settles. A clone source with neither a temporal nor an options specification is the clone page's own lines (db.ddl.clone.create-table-clone and replace-table-clone), so each line here spells at least one of them" +grammar = ["{ CREATE TABLE [ IF NOT EXISTS ] | [ CREATE OR ] REPLACE TABLE } [ SHALLOW | DEEP ] CLONE { [ FOR ] TIMESTAMP AS OF | [ FOR ] VERSION AS OF }"] +reason = "the names page spells the temporal specification [ FOR ] { SYSTEM_TIMESTAMP | TIMESTAMP } AS OF and [ FOR ] { SYSTEM_VERSION | VERSION } AS OF, while SqlBaseParser temporalClause spells FOR? (SYSTEM_VERSION | VERSION) AS OF and FOR? (SYSTEM_TIME | TIMESTAMP) AS OF: the two sources agree on TIMESTAMP and VERSION only, so those are derived, and SYSTEM_TIMESTAMP, SYSTEM_VERSION and Spark's SYSTEM_TIME are observed [[limit]] rows that a receipt settles. The names page's options specification WITH ( option_key [ = ] option_val [, ...] ) is refused after a clone source in every spelling (PARSE_SYNTAX_ERROR at the opening parenthesis, with and without a temporal specification), so it leaves the derivation and its documented spellings are observed [[limit]] rows. A clone source with neither specification is the clone page's own lines (db.ddl.clone.create-table-clone and replace-table-clone), so the line spells the temporal specification" + +[[reading]] +form = "db.functions.ai-top-drivers" +grammar_sha256 = "51e6c494e59a7180456796625d84f018139275925835462e238f0932b8b98e24" +grammar = ["AI_TOP_DRIVERS ( input => , metric => , is_test => [ , { dimensions => | aggregation => | min_support => } ] [ ... ] )"] +reason = "the page defines optional_param as { dimensions => | aggregation => | min_support => }, so each named optional argument is read in place of the placeholder" + +[[reading]] +form = "db.functions.date-add3" +grammar_sha256 = "ea53e600cee4c8a031086e709a441123740bd03649e53b267bad80356e8dacf4" +grammar = ["DATE_ADD ( { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } , , )"] +reason = "the page defines unit as the closed choice { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR }, so each documented unit is read in place of the placeholder" + +[[reading]] +form = "db.functions.date-diff" +grammar_sha256 = "5c5eb27f7ae3edba3e21ae33a678116b3a1a6c9b918dd143ff6fe945075b4ce7" +grammar = ["DATE_DIFF ( , )", "DATE_DIFF ( { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } , , )"] +reason = "the page defines unit as the closed choice { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR }, so each documented unit is read in place of the placeholder" + +[[reading]] +form = "db.functions.dateadd" +grammar_sha256 = "b86c444ab5072fd0c47e2d119dd66955d0d16244170da2a178f164a22a1b84bc" +grammar = ["DATEADD ( { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } , , )"] +reason = "the page defines unit as the closed choice { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR }, so each documented unit is read in place of the placeholder" + +[[reading]] +form = "db.functions.datediff3" +grammar_sha256 = "6d788d2f120986fd8f0e19bd78c64c5519c81230c00f2e7e66c0fc012556c37e" +grammar = ["DATEDIFF ( { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } , , )"] +reason = "the page defines unit as the closed choice { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR }, so each documented unit is read in place of the placeholder" + +[[reading]] +form = "db.functions.listagg" +grammar_sha256 = "addcd1cc43ac64b652e7bd2878887b8b1f3f414fa0878c53e19f79de26bf2014" +grammar = ["LISTAGG ( [ ALL | DISTINCT ] [ , ] ) [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ] [ FILTER ( WHERE ) ]"] +reason = "the page defines sort_direction as [ ASC | DESC ], so ASC and DESC are read in place of the placeholder; the page defines nulls_sort_order as [ NULLS FIRST | NULLS LAST ], so NULLS FIRST and NULLS LAST are read in place of the placeholder" + +[[reading]] +form = "db.functions.string-agg" +grammar_sha256 = "4f3b24e3bbd61c3e09d57c8226f55c2a9afc5522ccd772499bfd40c3e5061b3f" +grammar = ["STRING_AGG ( [ ALL | DISTINCT ] [ , ] ) [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ] [ FILTER ( WHERE ) ]"] +reason = "the page defines sort_direction as [ ASC | DESC ], so ASC and DESC are read in place of the placeholder; the page defines nulls_sort_order as [ NULLS FIRST | NULLS LAST ], so NULLS FIRST and NULLS LAST are read in place of the placeholder" + +[[reading]] +form = "db.functions.time-diff" +grammar_sha256 = "deec894fdf5ce8ea9366b7cdf30c10cae341fbf01056b6188b90369eba7c14b0" +grammar = ["TIME_DIFF ( { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR } , , )"] +reason = "the page defines unit as the closed choice { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR }, so each documented unit is read in place of the placeholder" + +[[reading]] +form = "db.functions.timediff" +grammar_sha256 = "034a56911aa442023333a36d4bbb4622d2311a38fede00e0135f847fcddbbdaa" +grammar = ["TIMEDIFF ( { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } , , )"] +reason = "the page defines unit as the closed choice { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR }, so each documented unit is read in place of the placeholder" + +[[reading]] +form = "db.functions.timestampadd" +grammar_sha256 = "a3f7d0bc05c913540fe26d53979f3b1046b150d9aefd28ea146b546c8568dd50" +grammar = ["TIMESTAMPADD ( { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } , , )"] +reason = "the page defines unit as the closed choice { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR }, so each documented unit is read in place of the placeholder" + +[[reading]] +form = "db.functions.timestampdiff" +grammar_sha256 = "0a85294d51e8f042cb8d6d8c353bc53152c2596224e96f86a620b477e387d68b" +grammar = ["TIMESTAMPDIFF ( { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } , , )"] +reason = "the page defines unit as the closed choice { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR }, so each documented unit is read in place of the placeholder" + +[[reading]] +form = "db.query.select-orderby" +grammar_sha256 = "6e9b187961cbe4e6bcea2f0944af0dff39e89a0e33591320827f3fdf1b89935d" +grammar = ["ORDER BY { { ALL [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } | { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] }"] +reason = "the page defines sort_direction as [ ASC | DESC ], so ASC and DESC are read in place of the placeholder; the page defines nulls_sort_order as [ NULLS FIRST | NULLS LAST ], so NULLS FIRST and NULLS LAST are read in place of the placeholder" + +[[reading]] +form = "db.query.select-sortby" +grammar_sha256 = "f1b1f497b438cae703b0b1df8e6f56db64a06d2d52f46b03377268ecb8b89d3b" +grammar = ["SORT BY { [ [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] ] } [ , ... ]"] +reason = "the page defines sort_direction as [ ASC | DESC ], so ASC and DESC are read in place of the placeholder; the page defines nulls_sort_order as [ NULLS FIRST | NULLS LAST ], so NULLS FIRST and NULLS LAST are read in place of the placeholder" + +[[reading]] +form = "db.security_admin.deny" +grammar_sha256 = "e0d60f662a1b8c7ddc5bef13d03d894be5446d468d774ed67c4f11de06893ae9" +grammar = ["DENY { ALL PRIVILEGES | [ , ... ] } ON TO "] +reason = "the page defines privilege_types as { ALL PRIVLEGES | [ , ... ] }, so ALL PRIVILEGES and a privilege list are read in place of the placeholder; the page's Syntax prints ALL PRIVLEGES, and its Parameters heading spells it ALL PRIVILEGES, which is read" + +[[reading]] +form = "db.security_admin.grant" +grammar_sha256 = "d99416a55ca9e0564a6d11aedf298eae4f7198a204e873216908db0660d197cb" +grammar = ["GRANT { ALL PRIVILEGES | [ , ... ] } ON TO "] +reason = "the page defines privilege_types as { ALL PRIVILEGES | [ , ... ] }, so ALL PRIVILEGES and a privilege list are read in place of the placeholder" + +[[reading]] +form = "db.security_admin.revoke" +grammar_sha256 = "83a2f5398ff2af24748f9681a8199dc7d26277c895165de30479db6f0844606c" +grammar = ["REVOKE { ALL PRIVILEGES | [ , ... ] } ON FROM "] +reason = "the page defines privilege_types as { ALL PRIVILEGES | [ , ... ] }, so ALL PRIVILEGES and a privilege list are read in place of the placeholder" + +[[reading]] +form = "db.functions.decode" +grammar_sha256 = "ba7b01c37071fb99cd5e62f883718005c461dd44ad6343c69b7e97dd3c0b1fe4" +grammar = ["DECODE ( , , [ , , ... ] [ , ] )"] +reason = "the [ , ... ] continues the list with another key and value pair (keyN and valueN in the page's Arguments; its examples: decode(5, 6, 'Spark', 5, 'SQL', 4, 'rocks') and, with defValue, decode(7, 6, 'Spark', 5, 'SQL', 'rocks')); the renderer otherwise repeats only the value, which reads as defValue, so a case with defValue could not be told from one with a second pair" + +[[reading]] +form = "db.functions.ai-detect-anomalies" +grammar_sha256 = "1bcfde9916aed10c940071e3c4abc3863e6fa372375219c44cb90d1c465c7c6e" +grammar = ["AI_DETECT_ANOMALIES ( , , [ , group_col => ] [ , anomaly_threshold => ] [ , covariate_col => ] [ , holiday_region => ] [ , only_last_n => ] [ , smoothing => ] )"] +reason = "an optional argument after one left out can be passed only by name, and the page's examples pass every optional argument by name (covariate_col => 'temperature', holiday_region => 'US', only_last_n => 100), so each optional argument is read as a named argument, which may be written without the ones before it" + +[[reading]] +form = "db.functions.ai-forecast" +grammar_sha256 = "12827d2e459678a8707aa9f712a67ebce09aba5b70b1e7f3ce0101247447cd1e" +grammar = ["AI_FORECAST ( , , , [ , group_col => ] [ , covariate_col => ] [ , prediction_interval_width => ] [ , frequency => ] [ , holiday_region => ] [ , positive_only => ] [ , version => ] )", "AI_FORECAST ( , , , [ , group_col => ] [ , prediction_interval_width => ] [ , frequency => ] [ , seed => ] [ , parameters => ] [ , version => ] )"] +reason = "an optional argument after one left out can be passed only by name, and the page's examples pass every optional argument by name (covariate_col => 'promotion', holiday_region => 'US', version => '2'), so each optional argument is read as a named argument, which may be written without the ones before it" + +[[reading]] +form = "db.functions.pipesign.syntax" +grammar_sha256 = "00c0b9ceea4953097684c7f68bdde5215001af221d2569857b14a76eaf59b40d" +grammar = [" \\| "] +reason = "the page's Syntax is expr1 | expr2, the bitwise OR (its Arguments: expr1 and expr2 of an integral numeric type; its example: SELECT 3 | 5), so | is the operator, not a choice the catalogue split into this form" + +[[reading]] +form = "db.functions.pipesign.syntax.syntax" +grammar_sha256 = "47eea7d016147120943beff1d11900bfc95ed5431ee0febe06c8be8b7777f01e" +grammar = [" \\| "] +reason = "the page's Syntax is expr1 | expr2, the bitwise OR (its Arguments: expr1 and expr2 of an integral numeric type; its example: SELECT 3 | 5), so | is the operator, not a choice the catalogue split into this form" [[limit]] form = "db.query.select-hints" @@ -228,6 +360,36 @@ sql = "ALTER TABLE t1 DROP ( c2 )" context = "raw" expect = "observe" +[[limit]] +form = "db.ddl.alter-table-manage-column.alter-change-set-mask" +kind = "alternative" +target = " SET MASK" +note = "a nested field before SET MASK, which the warehouse refuses" +anchor = "doc.sql-ref-syntax-ddl-alter-table-manage-column / Syntax" +sql = "ALTER TABLE t1 ALTER c1.c1 SET MASK f1" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.ddl.alter-table-manage-column.alter-change-set-mask" +kind = "alternative" +target = " SET TAGS" +note = "a nested field before SET TAGS, which the warehouse refuses" +anchor = "doc.sql-ref-syntax-ddl-alter-table-manage-column / Syntax" +sql = "ALTER TABLE t1 ALTER COLUMN c1.c1 SET TAGS ( 'k' = 'v' )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.ddl.alter-table-manage-column.alter-change-set-mask" +kind = "alternative" +target = " UNSET TAGS" +note = "a nested field before UNSET TAGS, which the warehouse refuses" +anchor = "doc.sql-ref-syntax-ddl-alter-table-manage-column / Syntax" +sql = "ALTER TABLE t1 ALTER COLUMN c1.c1 UNSET TAGS ( 'k' )" +context = "raw" +expect = "observe" + [[limit]] form = "db.ddl.alter-table-manage-column.alter-change-set-mask" kind = "alternative" @@ -402,7 +564,7 @@ documented = true [[limit]] form = "db.ddl.create-table-hiveformat" kind = "interaction" -pair = ["[ COMMENT ]", "[ ROW FORMAT ]"] +pair = ["[ COMMENT ]", "{ ROW FORMAT [ STORED AS { |… → ROW FORMAT [ STORED AS { | INPUTFORMAT OUTPUTFORMAT } ]"] note = "ROW FORMAT before COMMENT, the reverse of the line's order: 'The clauses between the column definition clause and the AS SELECT clause can appear in any order'; observed, since the page applies to Databricks Runtime only" anchor = "doc.sql-ref-syntax-ddl-create-table-hiveformat / Syntax" sql = "CREATE TABLE t3 ( c1 INT , c2 INT ) ROW FORMAT DELIMITED COMMENT 'x' STORED AS TEXTFILE" @@ -413,7 +575,7 @@ documented = true [[limit]] form = "db.ddl.create-table-hiveformat" kind = "interaction" -pair = ["[ COMMENT ]", "[ STORED AS { | INPUTFORMAT OUTPUTFORMAT } ]"] +pair = ["[ COMMENT ]", "{ ROW FORMAT [ STORED AS { |… → STORED AS { | INPUTFORMAT OUTPUTFORMAT }"] note = "STORED AS before COMMENT, the reverse of the line's order: 'The clauses between the column definition clause and the AS SELECT clause can appear in any order'; observed, since the page applies to Databricks Runtime only" anchor = "doc.sql-ref-syntax-ddl-create-table-hiveformat / Syntax" sql = "CREATE TABLE t3 ( c1 INT , c2 INT ) STORED AS TEXTFILE COMMENT 'x'" @@ -446,7 +608,7 @@ documented = true [[limit]] form = "db.ddl.create-table-hiveformat" kind = "interaction" -pair = ["[ PARTITIONED BY { ( [ COMMENT ] , ... ) | ( , , ... ) }…", "[ ROW FORMAT ]"] +pair = ["[ PARTITIONED BY { ( [ COMMENT ] , ... ) | ( , , ... ) }…", "{ ROW FORMAT [ STORED AS { |… → ROW FORMAT [ STORED AS { | INPUTFORMAT OUTPUTFORMAT } ]"] note = "ROW FORMAT before PARTITIONED BY, the reverse of the line's order: 'The clauses between the column definition clause and the AS SELECT clause can appear in any order'; observed, since the page applies to Databricks Runtime only" anchor = "doc.sql-ref-syntax-ddl-create-table-hiveformat / Syntax" sql = "CREATE TABLE t3 ( c1 INT , c2 INT ) ROW FORMAT DELIMITED PARTITIONED BY ( c3 INT ) STORED AS TEXTFILE" @@ -457,7 +619,7 @@ documented = true [[limit]] form = "db.ddl.create-table-hiveformat" kind = "interaction" -pair = ["[ PARTITIONED BY { ( [ COMMENT ] , ... ) | ( , , ... ) }…", "[ STORED AS { | INPUTFORMAT OUTPUTFORMAT } ]"] +pair = ["[ PARTITIONED BY { ( [ COMMENT ] , ... ) | ( , , ... ) }…", "{ ROW FORMAT [ STORED AS { |… → STORED AS { | INPUTFORMAT OUTPUTFORMAT }"] note = "STORED AS before PARTITIONED BY, the reverse of the line's order: 'The clauses between the column definition clause and the AS SELECT clause can appear in any order'; observed, since the page applies to Databricks Runtime only" anchor = "doc.sql-ref-syntax-ddl-create-table-hiveformat / Syntax" sql = "CREATE TABLE t3 ( c1 INT , c2 INT ) STORED AS TEXTFILE PARTITIONED BY ( c3 INT )" @@ -490,7 +652,7 @@ documented = true [[limit]] form = "db.ddl.create-table-hiveformat" kind = "interaction" -pair = ["[ ROW FORMAT ]", "[ STORED AS { | INPUTFORMAT OUTPUTFORMAT } ]"] +pair = ["{ ROW FORMAT [ STORED AS { |… → ROW FORMAT [ STORED AS { | INPUTFORMAT OUTPUTFORMAT } ]", "[ STORED AS { | INPUTFORMAT OUTPUTFORMAT } ]"] note = "STORED AS before ROW FORMAT, the reverse of the line's order: 'The clauses between the column definition clause and the AS SELECT clause can appear in any order'; observed, since the page applies to Databricks Runtime only" anchor = "doc.sql-ref-syntax-ddl-create-table-hiveformat / Syntax" sql = "CREATE TABLE t3 ( c1 INT , c2 INT ) STORED AS TEXTFILE ROW FORMAT DELIMITED" @@ -501,7 +663,7 @@ documented = true [[limit]] form = "db.ddl.create-table-hiveformat" kind = "interaction" -pair = ["[ ROW FORMAT ]", "[ LOCATION ]"] +pair = ["{ ROW FORMAT [ STORED AS { |… → ROW FORMAT [ STORED AS { | INPUTFORMAT OUTPUTFORMAT } ]", "[ LOCATION ]"] note = "LOCATION before ROW FORMAT, the reverse of the line's order: 'The clauses between the column definition clause and the AS SELECT clause can appear in any order'; observed, since the page applies to Databricks Runtime only" anchor = "doc.sql-ref-syntax-ddl-create-table-hiveformat / Syntax" sql = "CREATE TABLE t3 ( c1 INT , c2 INT ) STORED AS TEXTFILE LOCATION '/tmp/x' ROW FORMAT DELIMITED" @@ -512,7 +674,7 @@ documented = true [[limit]] form = "db.ddl.create-table-hiveformat" kind = "interaction" -pair = ["[ ROW FORMAT ]", "[ TBLPROPERTIES ( = , = , ... ) ]"] +pair = ["{ ROW FORMAT [ STORED AS { |… → ROW FORMAT [ STORED AS { | INPUTFORMAT OUTPUTFORMAT } ]", "[ TBLPROPERTIES ( = , = , ... ) ]"] note = "TBLPROPERTIES before ROW FORMAT, the reverse of the line's order: 'The clauses between the column definition clause and the AS SELECT clause can appear in any order'; observed, since the page applies to Databricks Runtime only" anchor = "doc.sql-ref-syntax-ddl-create-table-hiveformat / Syntax" sql = "CREATE TABLE t3 ( c1 INT , c2 INT ) STORED AS TEXTFILE TBLPROPERTIES ( 'k' = 'v' ) ROW FORMAT DELIMITED" @@ -523,7 +685,7 @@ documented = true [[limit]] form = "db.ddl.create-table-hiveformat" kind = "interaction" -pair = ["[ STORED AS { | INPUTFORMAT OUTPUTFORMAT } ]", "[ LOCATION ]"] +pair = ["{ ROW FORMAT [ STORED AS { |… → STORED AS { | INPUTFORMAT OUTPUTFORMAT }", "[ LOCATION ]"] note = "LOCATION before STORED AS, the reverse of the line's order: 'The clauses between the column definition clause and the AS SELECT clause can appear in any order'; observed, since the page applies to Databricks Runtime only" anchor = "doc.sql-ref-syntax-ddl-create-table-hiveformat / Syntax" sql = "CREATE TABLE t3 ( c1 INT , c2 INT ) LOCATION '/tmp/x' STORED AS TEXTFILE" @@ -534,7 +696,7 @@ documented = true [[limit]] form = "db.ddl.create-table-hiveformat" kind = "interaction" -pair = ["[ STORED AS { | INPUTFORMAT OUTPUTFORMAT } ]", "[ TBLPROPERTIES ( = , = , ... ) ]"] +pair = ["{ ROW FORMAT [ STORED AS { |… → STORED AS { | INPUTFORMAT OUTPUTFORMAT }", "[ TBLPROPERTIES ( = , = , ... ) ]"] note = "TBLPROPERTIES before STORED AS, the reverse of the line's order: 'The clauses between the column definition clause and the AS SELECT clause can appear in any order'; observed, since the page applies to Databricks Runtime only" anchor = "doc.sql-ref-syntax-ddl-create-table-hiveformat / Syntax" sql = "CREATE TABLE t3 ( c1 INT , c2 INT ) TBLPROPERTIES ( 'k' = 'v' ) STORED AS TEXTFILE" @@ -1409,20 +1571,6 @@ target = "" note = "a string literal in place of " reason = "the class name is a string literal (SqlBaseParser #createFunction: AS className=stringLit; the page's examples quote it), so a string literal in its place is the documented operand, no negative" -[[suppress]] -form = "db.ddl.create-materialized-view-refresh-policy" -kind = "required_operand_missing" -target = "" -note = "omit " -reason = "REFRESH followed by any text parses as Spark's REFRESH resource or REFRESH TABLE (SqlBaseParser #refreshTable: REFRESH TABLE? identifierReference, #refreshResource: REFRESH .*?), so the text without the rest of the form parses; the resource is looked up when it runs" - -[[suppress]] -form = "db.ddl.create-materialized-view-refresh-policy" -kind = "negative_neighbour" -target = "" -note = "the form without its required POLICY" -reason = "REFRESH followed by any text parses as Spark's REFRESH resource or REFRESH TABLE (SqlBaseParser #refreshTable: REFRESH TABLE? identifierReference, #refreshResource: REFRESH .*?), so the text without the rest of the form parses; the resource is looked up when it runs" - [[suppress]] form = "db.ddl.create-materialized-view" kind = "negative_neighbour" @@ -1480,38 +1628,38 @@ note = "the form without its required { MATERIALIZED VIEW | [ STREAMING ] TABLE reason = "REFRESH followed by any text parses as Spark's REFRESH resource or REFRESH TABLE (SqlBaseParser #refreshTable: REFRESH TABLE? identifierReference, #refreshResource: REFRESH .*?), so the text without the rest of the form parses; the resource is looked up when it runs" [[suppress]] -form = "db.expressions.binary-type.x" -kind = "negative_neighbour" -target = "" -note = "the form without its required { 'num [ ... ] ' | \"num [ ... ] \" }" +form = "db.expressions.date-type.date" +kind = "required_operand_missing" +target = "" +note = "omit " reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" [[suppress]] -form = "db.expressions.decfloat-type" +form = "db.expressions.timestamp-ntz-type.timestamp-ntz.literals" kind = "required_operand_missing" -target = "

in [ (

) ]" -note = "omit

" -reason = "a name followed by a parenthesised argument list parses as a function call (SqlBaseParser functionCall), so the type name with empty parentheses parses in an expression; the routine is resolved in analysis" +target = "" +note = "omit " +reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" [[suppress]] -form = "db.expressions.decimal-type.bd" +form = "db.expressions.timestamp-type.timestamp-ltz.literals" kind = "required_operand_missing" -target = "" -note = "omit " +target = "" +note = "omit " reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" [[suppress]] -form = "db.expressions.decimal-type" +form = "db.expressions.timestamp-type.timestamp.literals" kind = "required_operand_missing" -target = "

in [ (

[ , ] ) ]" -note = "omit

" -reason = "a name followed by a parenthesised argument list parses as a function call (SqlBaseParser functionCall), so the type name with empty parentheses parses in an expression; the routine is resolved in analysis" +target = "" +note = "omit " +reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" [[suppress]] -form = "db.expressions.double-type.d" -kind = "required_operand_missing" -target = "" -note = "omit " +form = "db.expressions.binary-type.x" +kind = "negative_neighbour" +target = "" +note = "the form without its required { '1F' | \"1F\" }" reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" [[suppress]] @@ -1535,82 +1683,33 @@ target = "" note = "a string literal in place of " reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" -[[suppress]] -form = "db.expressions.expression" -kind = "required_operand_missing" -target = "" -note = "omit " -reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" - -[[suppress]] -form = "db.expressions.expression" -kind = "required_operand_missing" -target = " #2" -note = "omit " -reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" - -[[suppress]] -form = "db.expressions.expression" -kind = "required_operand_missing" -target = " #3" -note = "omit " -reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" - [[suppress]] form = "db.expressions.file-type" kind = "negative_neighbour" target = "" note = "the form without its required FILE after " -reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" +reason = "without FILE the word MANAGED or EXTERNAL stands where the column's type is read, and the grammar reads any identifier there as a type name (SqlBaseParser primitiveType: unsupportedType=identifier), so the text is no certain syntax negative; the type is checked after the identifier is read" [[suppress]] form = "db.expressions.file-type" kind = "negative_neighbour" target = "" note = "the form without its required MANAGED" -reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" +reason = "without MANAGED or EXTERNAL the column's type is FILE alone, which the grammar reads as a type name (SqlBaseParser primitiveType: unsupportedType=identifier) and the page refuses only as a column type ('You can't declare a table column as FILE without specifying either MANAGED or EXTERNAL'), so the text is no certain syntax negative" [[suppress]] form = "db.expressions.file-type" kind = "negative_neighbour" target = "" note = "the form without its required FILE after #2" -reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" +reason = "without FILE the word MANAGED or EXTERNAL stands where the column's type is read, and the grammar reads any identifier there as a type name (SqlBaseParser primitiveType: unsupportedType=identifier), so the text is no certain syntax negative; the type is checked after the identifier is read" [[suppress]] form = "db.expressions.file-type" kind = "negative_neighbour" target = "" note = "the form without its required EXTERNAL" -reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" - -[[suppress]] -form = "db.expressions.float-type.f.literals" -kind = "required_operand_missing" -target = "" -note = "omit " -reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" - -[[suppress]] -form = "db.expressions.float-type.f" -kind = "required_operand_missing" -target = "" -note = "omit " -reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" - -[[suppress]] -form = "db.expressions.geography-type" -kind = "negative_neighbour" -target = "" -note = "the form without its required { | ANY }" -reason = "a name followed by a parenthesised argument list parses as a function call (SqlBaseParser functionCall), so the type name with empty parentheses parses in an expression; the routine is resolved in analysis" - -[[suppress]] -form = "db.expressions.geometry-type" -kind = "negative_neighbour" -target = "" -note = "the form without its required { | ANY }" -reason = "a name followed by a parenthesised argument list parses as a function call (SqlBaseParser functionCall), so the type name with empty parentheses parses in an expression; the routine is resolved in analysis" +reason = "without MANAGED or EXTERNAL the column's type is FILE alone, which the grammar reads as a type name (SqlBaseParser primitiveType: unsupportedType=identifier) and the page refuses only as a column type ('You can't declare a table column as FILE without specifying either MANAGED or EXTERNAL'), so the text is no certain syntax negative" [[suppress]] form = "db.expressions.identifiers.subscript-dot.syntax" @@ -1624,28 +1723,7 @@ form = "db.expressions.interval-type" kind = "negative_neighbour" target = "" note = "the form without its required { | }" -reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" - -[[suppress]] -form = "db.expressions.json-path-expression" -kind = "negative_neighbour" -target = "" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - -[[suppress]] -form = "db.expressions.names.identifier-2" -kind = "negative_neighbour" -target = " in [ . ]" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - -[[suppress]] -form = "db.expressions.names.identifier-2" -kind = "negative_neighbour" -target = "" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" +reason = "without a qualifier INTERVAL is a type the grammar admits (SqlBaseParser nonTrivialPrimitiveType: INTERVAL (fromYearMonth=(YEAR | MONTH) (TO to=MONTH)? | fromDayTime=(DAY | HOUR | MINUTE | SECOND) (TO to=(HOUR | MINUTE | SECOND))?)?), so the text is no certain syntax negative; the type is checked afterwards" [[suppress]] form = "db.expressions.names.identifier-2" @@ -1703,20 +1781,6 @@ target = "" note = "omit " reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" -[[suppress]] -form = "db.expressions.names.identifier-6" -kind = "negative_neighbour" -target = " in [ . ]" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - -[[suppress]] -form = "db.expressions.names.identifier-6" -kind = "negative_neighbour" -target = "" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - [[suppress]] form = "db.expressions.names.identifier-6" kind = "required_operand_missing" @@ -1724,20 +1788,6 @@ target = "" note = "omit " reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" -[[suppress]] -form = "db.expressions.names.identifier-7" -kind = "negative_neighbour" -target = " in [ . ]" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - -[[suppress]] -form = "db.expressions.names.identifier-7" -kind = "negative_neighbour" -target = "" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - [[suppress]] form = "db.expressions.names.identifier-7" kind = "required_operand_missing" @@ -1745,13 +1795,6 @@ target = "" note = "omit " reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" -[[suppress]] -form = "db.expressions.names.identifier-8" -kind = "negative_neighbour" -target = "" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - [[suppress]] form = "db.expressions.names.identifier-8" kind = "required_operand_missing" @@ -1759,20 +1802,6 @@ target = "" note = "omit " reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" -[[suppress]] -form = "db.expressions.names.identifier" -kind = "negative_neighbour" -target = " in [ . ]" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - -[[suppress]] -form = "db.expressions.names.identifier" -kind = "negative_neighbour" -target = "" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - [[suppress]] form = "db.expressions.names.identifier" kind = "required_operand_missing" @@ -1780,82 +1809,19 @@ target = "" note = "omit " reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" -[[suppress]] -form = "db.expressions.names.identifier.syntax" -kind = "negative_neighbour" -target = " in [ . ]" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - -[[suppress]] -form = "db.expressions.names.identifier.syntax" -kind = "negative_neighbour" -target = "" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - [[suppress]] form = "db.expressions.names.identifier.syntax" kind = "required_operand_missing" target = "" note = "omit " -reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" - -[[suppress]] -form = "db.expressions.names.identifier.syntax" -kind = "required_operand_missing" -target = " #2" -note = "omit " -reason = "a backquoted blank is a valid quoted identifier (SqlBaseLexer BACKQUOTED_IDENTIFIER: '`' ( ~'`' | '``' )* '`'), so the text with a blank in place of the operand parses; the name is resolved in analysis" - -[[suppress]] -form = "db.expressions.names.identifier.syntax" -kind = "required_operand_missing" -target = "" -note = "omit " -reason = "a backquoted blank is a valid quoted identifier (SqlBaseLexer BACKQUOTED_IDENTIFIER: '`' ( ~'`' | '``' )* '`'), so the text with a blank in place of the operand parses; the name is resolved in analysis" - -[[suppress]] -form = "db.expressions.names.subscript-dot-2" -kind = "negative_neighbour" -target = "" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - -[[suppress]] -form = "db.expressions.names.subscript-dot-2" -kind = "required_operand_missing" -target = " in [ ( [ , ... ] ) ]" -note = "omit " -reason = "a name followed by a parenthesised argument list parses as a function call (SqlBaseParser functionCall), so the type name with empty parentheses parses in an expression; the routine is resolved in analysis" - -[[suppress]] -form = "db.expressions.names.subscript-dot-2" -kind = "negative_neighbour" -target = " in [ ( [ , ... ] ) ]" -note = "a string literal in place of " -reason = "a name followed by a parenthesised argument list parses as a function call (SqlBaseParser functionCall), so the type name with empty parentheses parses in an expression; the routine is resolved in analysis" +reason = "without its clause the word IDENTIFIER is read as a table name: Databricks formally disallows no literal as an identifier (reserved-words page), so the text parses; the table is looked up in analysis" [[suppress]] form = "db.expressions.names.subscript-dot-3" kind = "negative_neighbour" -target = "" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - -[[suppress]] -form = "db.expressions.names.subscript-dot-4" -kind = "negative_neighbour" -target = " in [ . ]" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - -[[suppress]] -form = "db.expressions.names.subscript-dot-4" -kind = "negative_neighbour" -target = "" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" +target = "" +note = "the form without its required (" +reason = "without its ( and ) a single column_identifier is the page's other column alias form, [AS] column_identifier, so the text parses" [[suppress]] form = "db.expressions.names.subscript-dot" @@ -1872,81 +1838,11 @@ note = "a string literal in place of " reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" [[suppress]] -form = "db.expressions.names.subscript-dot.syntax" +form = "db.functions.ai-parse-document" kind = "negative_neighbour" -target = "" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - -[[suppress]] -form = "db.expressions.names.subscript" -kind = "negative_neighbour" -target = "" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - -[[suppress]] -form = "db.expressions.names.syntax" -kind = "negative_neighbour" -target = "" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - -[[suppress]] -form = "db.expressions.names.syntax" -kind = "negative_neighbour" -target = "" -note = "a string literal in place of " -reason = "in the expression context every case is written in, a string literal is itself a valid expression, and a dot after it is a field dereference (SqlBaseParser primaryExpression #dereference), so the text parses; the field or type is checked in analysis" - -[[suppress]] -form = "db.expressions.smallint-type.s" -kind = "required_operand_missing" -target = "" -note = "omit " -reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" - -[[suppress]] -form = "db.expressions.time-type.time.syntax" -kind = "required_operand_missing" -target = "

" -note = "omit

" -reason = "a name followed by a parenthesised argument list parses as a function call (SqlBaseParser functionCall), so the type name with empty parentheses parses in an expression; the routine is resolved in analysis" - -[[suppress]] -form = "db.expressions.timestamp-ntz-type.timestamp-ntz" -kind = "required_operand_missing" -target = "

in [ (

) ]" -note = "omit

" -reason = "a name followed by a parenthesised argument list parses as a function call (SqlBaseParser functionCall), so the type name with empty parentheses parses in an expression; the routine is resolved in analysis" - -[[suppress]] -form = "db.expressions.timestamp-type.timestamp-ltz" -kind = "required_operand_missing" -target = "

in [ (

) ]" -note = "omit

" -reason = "a name followed by a parenthesised argument list parses as a function call (SqlBaseParser functionCall), so the type name with empty parentheses parses in an expression; the routine is resolved in analysis" - -[[suppress]] -form = "db.expressions.timestamp-type.timestamp" -kind = "required_operand_missing" -target = "

in [ (

) ]" -note = "omit

" -reason = "a name followed by a parenthesised argument list parses as a function call (SqlBaseParser functionCall), so the type name with empty parentheses parses in an expression; the routine is resolved in analysis" - -[[suppress]] -form = "db.expressions.tinyint-type.y" -kind = "required_operand_missing" -target = "" -note = "omit " -reason = "in an expression a lone word is a column reference: Databricks formally disallows no literal as an identifier (reserved-words page), so the keyword left without its operand reads as a column name and the text parses; the name is resolved in analysis" - -[[suppress]] -form = "db.functions.ai-parse-document" -kind = "negative_neighbour" -target = "" -note = "the form without its required MAP" -reason = "without MAP the argument is a parenthesised list of two values, itself a valid expression (SqlBaseParser #rowConstructor: LEFT_PAREN namedExpression (COMMA namedExpression)+ RIGHT_PAREN), so the text parses; the argument's type is checked in analysis" +target = "" +note = "the form without its required MAP" +reason = "without MAP the argument is a parenthesised list of two values, itself a valid expression (SqlBaseParser #rowConstructor: LEFT_PAREN namedExpression (COMMA namedExpression)+ RIGHT_PAREN), so the text parses; the argument's type is checked in analysis" [[suppress]] form = "db.functions.ai-predict-class" @@ -2165,6 +2061,13 @@ target = "" note = "omit " reason = "Spark's generic configuration SET takes any text after SET (SqlBaseParser #setConfiguration: SET configKey (EQ .*?)?, and SET .*?), so the text without the operand parses as a configuration SET" +[[suppress]] +form = "db.transaction_session.collation" +kind = "negative_neighbour" +target = "" +note = "the form without its required COLLATION" +reason = "Spark's generic configuration SET takes any text after SET (SqlBaseParser #setConfiguration: SET configKey (EQ .*?)?, and SET .*?), so the text without the keyword parses as a configuration SET" + [[suppress]] form = "db.transaction_session.conf-mgmt-set-collation" kind = "required_operand_missing" @@ -2476,7 +2379,7 @@ reason = "SHOW FUNCTIONS takes an optional function name or a string pattern (Sq [[suppress]] form = "db.utility.show-functions" kind = "negative_neighbour" -target = " in [ [ LIKE ] { | } ]" +target = " in [ [ LIKE ] { | } ]" note = "a string literal in place of " reason = "SHOW FUNCTIONS takes an optional function name or a string pattern (SqlBaseParser #showFunctions: SHOW identifier? FUNCTIONS ((FROM | IN) ns)? (LIKE? (legacy=multipartIdentifier | pattern=stringLit))?), so a string literal is the documented pattern and a lone FROM reads as a function name; the text parses" @@ -2709,3 +2612,4926 @@ sql = "SELECT 1 `ANTI`" context = "raw" expect = "accept" +[[reading]] +form = "db.ddl.alter-catalog" +grammar_sha256 = "8b746a22f99180f16aab69edb0ab3e02114a41bc826e44165648adce7295fc39" +grammar = ["ALTER CATALOG [ ] { [ SET ] OWNER TO | SET TAGS ( { = } [ , ... ] ) | UNSET TAGS ( [ , ... ] ) | { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION }", "ALTER CATALOG { DEFAULT COLLATION | OPTIONS (

) ]" +note = "TIMESTAMP ( 6 ) WITHOUT TIME ZONE in CAST; p is 'An optional precision from 6 through 9'" +anchor = "doc.data-types.timestamp-ntz-type / Syntax" +sql = "SELECT CAST ( NULL AS TIMESTAMP ( 6 ) WITHOUT TIME ZONE )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.scripting.compound-stmt" +kind = "option_present" +target = "[

" +note = "a string where the page documents an integer" +anchor = "doc.data-types.decimal-type / Syntax" +sql = "SELECT CAST ( NULL AS DECIMAL ( 'x' ) )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.expressions.decimal-type" +kind = "operand_type_class" +target = "" +note = "a string where the page documents an integer" +anchor = "doc.data-types.decimal-type / Syntax" +sql = "SELECT CAST ( NULL AS DECIMAL ( 10 , 'x' ) )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.expressions.decfloat-type" +kind = "operand_type_class" +target = "

" +note = "a string where the page documents an integer" +anchor = "doc.data-types.decfloat-type / Syntax" +sql = "SELECT CAST ( NULL AS DECFLOAT ( 'x' ) )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.expressions.time-type.time.syntax" +kind = "operand_type_class" +target = "

" +note = "a string where the page documents an integer" +anchor = "doc.data-types.time-type / Syntax" +sql = "SELECT CAST ( NULL AS TIME ( 'x' ) )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.expressions.timestamp-ntz-type.timestamp-ntz" +kind = "operand_type_class" +target = "

" +note = "a string where the page documents an integer" +anchor = "doc.data-types.timestamp-ntz-type / Syntax" +sql = "SELECT CAST ( NULL AS TIMESTAMP_NTZ ( 'x' ) )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.functions.timediff" +kind = "operand_type_class" +target = "" +note = "the unit written as a quoted string rather than its keyword, recorded to show how the warehouse reads it" +anchor = "doc.functions.timediff / Syntax" +sql = "SELECT ( TIMEDIFF ( 'MICROSECOND' , 1 , 1 ) )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.functions.timestampadd" +kind = "operand_type_class" +target = "" +note = "the unit written as a quoted string rather than its keyword, recorded to show how the warehouse reads it" +anchor = "doc.functions.timestampadd / Syntax" +sql = "SELECT ( TIMESTAMPADD ( 'MICROSECOND' , 1 , 1 ) )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.functions.timestampdiff" +kind = "operand_type_class" +target = "" +note = "the unit written as a quoted string rather than its keyword, recorded to show how the warehouse reads it" +anchor = "doc.functions.timestampdiff / Syntax" +sql = "SELECT ( TIMESTAMPDIFF ( 'MICROSECOND' , 1 , 1 ) )" +context = "raw" +expect = "observe" + +[[reading]] +form = "db.functions.named-struct" +grammar_sha256 = "90e85323181b08c217b3a61a5d7510912d25af5085cc552d3930290b632ac0d9" +grammar = ["NAMED_STRUCT ( , [ , , ... ] )"] +reason = "the [ , ... ] continues the list with another name and value pair (nameN and valN in the page's Arguments, nameN a STRING literal); the renderer otherwise repeats only the value, an odd argument count the page's pairs rule out, as the MAP and DECODE readings record" + +[[limit]] +form = "db.query.select-lateral-view" +kind = "option_absent" +target = "AS" +note = "the column alias written without AS" +anchor = "doc.sql-ref-syntax-qry-select-lateral-view / Syntax" +sql = "SELECT * FROM t1 LATERAL VIEW explode ( array ( 1 ) ) a3 x1" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.query.select-match-recognize" +kind = "alternative" +target = "" +note = "ALL ROWS PER MATCH" +anchor = "doc.sql-ref-syntax-qry-select-match-recognize / Syntax" +sql = "SELECT * FROM t1 MATCH_RECOGNIZE ( ORDER BY c1 ALL ROWS PER MATCH PATTERN ( A ) DEFINE A AS TRUE )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.query.select-match-recognize" +kind = "alternative" +target = "" +note = "ALL ROWS PER MATCH SHOW EMPTY MATCHES" +anchor = "doc.sql-ref-syntax-qry-select-match-recognize / Syntax" +sql = "SELECT * FROM t1 MATCH_RECOGNIZE ( ORDER BY c1 ALL ROWS PER MATCH SHOW EMPTY MATCHES PATTERN ( A ) DEFINE A AS TRUE )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.query.select-match-recognize-pattern" +kind = "alternative" +target = "" +note = "quantified pattern variables" +anchor = "doc.sql-ref-syntax-qry-select-match-recognize-pattern / Syntax" +sql = "SELECT * FROM t1 MATCH_RECOGNIZE ( ORDER BY c1 PATTERN ( A+ B* ) DEFINE A AS TRUE , B AS TRUE )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.query.select-match-recognize-pattern" +kind = "alternative" +target = "" +note = "an alternation of pattern variables" +anchor = "doc.sql-ref-syntax-qry-select-match-recognize-pattern / Syntax" +sql = "SELECT * FROM t1 MATCH_RECOGNIZE ( ORDER BY c1 PATTERN ( A | B ) DEFINE A AS TRUE , B AS TRUE )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.query.select-match-recognize-pattern" +kind = "alternative" +target = "" +note = "PERMUTE of pattern variables" +anchor = "doc.sql-ref-syntax-qry-select-match-recognize-pattern / Syntax" +sql = "SELECT * FROM t1 MATCH_RECOGNIZE ( ORDER BY c1 PATTERN ( PERMUTE ( A , B ) ) DEFINE A AS TRUE , B AS TRUE )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.query.select-match-recognize-pattern" +kind = "alternative" +target = "" +note = "anchors and a bounded quantifier" +anchor = "doc.sql-ref-syntax-qry-select-match-recognize-pattern / Syntax" +sql = "SELECT * FROM t1 MATCH_RECOGNIZE ( ORDER BY c1 PATTERN ( ^ A {2,} $ ) DEFINE A AS TRUE )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.functions.sum" +kind = "required_operand_missing" +target = "" +note = "the call with its only argument left out" +anchor = "doc.functions.sum / Syntax" +sql = "SELECT ( SUM ( ) )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.functions.split" +kind = "required_operand_missing" +target = "" +note = "the call without its required regex" +anchor = "doc.functions.split / Syntax" +sql = "SELECT ( SPLIT ( v1 , ) )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.functions.regexp-extract" +kind = "required_operand_missing" +target = "" +note = "the call with its required regexp left out entirely" +anchor = "doc.functions.regexp_extract / Syntax" +sql = "SELECT ( REGEXP_EXTRACT ( v1 ) )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.functions.time-diff" +kind = "operand_type_class" +target = "" +note = "the unit written as a quoted string rather than its keyword, recorded to show how the warehouse reads it" +anchor = "doc.functions.time_diff / Syntax" +sql = "SELECT ( TIME_DIFF ( 'v1' , 1 , 1 ) )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.functions.time-diff" +kind = "operand_type_class" +target = "" +note = "a unit keyword the page does not list for this function" +anchor = "doc.functions.time_diff / Syntax" +sql = "SELECT ( TIME_DIFF ( DAY , 1 , 1 ) )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.functions.remote-query" +kind = "operand_type_class" +target = "" +note = "a string literal written where the option key goes" +anchor = "doc.functions.remote_query / Syntax" +sql = "SELECT * FROM REMOTE_QUERY ( 'c1' , 'v1' => 1 )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.functions.remote-query" +kind = "identifier_class" +target = "" +note = "the option key as a backtick-quoted identifier" +anchor = "doc.functions.remote_query / Syntax" +sql = "SELECT * FROM REMOTE_QUERY ( 'c1' , `k 1` => 1 )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.functions.read-kafka" +kind = "option_absent" +target = "[ , ... ]" +note = "one option pair with the list not continued" +anchor = "doc.functions.read_kafka / Syntax" +sql = "SELECT * FROM READ_KAFKA ( k1 => 'v' )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.functions.read-kafka" +kind = "identifier_class" +target = "" +note = "an option key containing dots as a backtick-quoted identifier, as the page requires" +anchor = "doc.functions.read_kafka / Syntax" +sql = "SELECT * FROM READ_KAFKA ( `kafka.sasl.mechanism` => 'v' )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.functions.read-kafka" +kind = "operand_type_class" +target = "" +note = "a string literal written where the option key goes" +anchor = "doc.functions.read_kafka / Syntax" +sql = "SELECT * FROM READ_KAFKA ( 'k1' => 'v' )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.functions.localtimestamp" +kind = "option_absent" +target = "the parentheses" +note = "LOCALTIMESTAMP without parentheses, which the page says is allowed when precision is omitted: the warehouse parses it but resolves it as a column (UNRESOLVED_COLUMN), not as the function, so the form keeps its written parentheses and the bare word is observed" +anchor = "doc.functions.localtimestamp / Syntax" +sql = "SELECT ( LOCALTIMESTAMP )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.expressions.null-type" +kind = "positive" +target = "the NULL literal" +note = "NULL written as an expression, the literal the page's Literals section names, not the type" +anchor = "doc.data-types.null-type / Literals" +sql = "SELECT ( NULL )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.expressions.null-type" +kind = "negative_neighbour" +target = "VOID as an expression" +note = "VOID written as an expression, which the warehouse parses as a column name, not a value of the type" +anchor = "doc.data-types.null-type / Syntax" +sql = "SELECT ( VOID )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.expressions.null-type" +kind = "alternative" +target = "NULL" +note = "the NULL spelling in type position" +anchor = "doc.data-types.null-type / Syntax" +sql = "SELECT CAST ( NULL AS NULL )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.query.query" +kind = "option_present" +target = "DISTRIBUTE BY" +note = "the DISTRIBUTE BY and SORT BY branch taken" +anchor = "doc.sql-ref-syntax-qry-query / Syntax" +sql = "SELECT c1 FROM t1 DISTRIBUTE BY c1 SORT BY c1" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.ddl.create-table-using" +kind = "option_present" +target = "OPTIONS" +note = "OPTIONS on a temporary table with a column list, recorded to settle whether the temporary line takes it" +anchor = "doc.sql-ref-syntax-ddl-create-table-using / Syntax" +sql = "CREATE TEMP TABLE t3 ( c1 INT ) OPTIONS ( 'k' = 'v' )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.ddl.create-table-using" +kind = "option_present" +target = "OPTIONS" +note = "OPTIONS on a replaced temporary table" +anchor = "doc.sql-ref-syntax-ddl-create-table-using / Syntax" +sql = "CREATE OR REPLACE TEMP TABLE t3 ( c1 INT , c2 INT ) OPTIONS ( 'k' = 'v' )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.ddl.create-table-using" +kind = "option_present" +target = "OPTIONS" +note = "OPTIONS on a temporary table created from a query" +anchor = "doc.sql-ref-syntax-ddl-create-table-using / Syntax" +sql = "CREATE TEMP TABLE t3 OPTIONS ( 'k' = 'v' ) AS SELECT 1" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.ddl.create-table-constraint.references" +kind = "option_present" +target = "FOREIGN KEY" +note = "the optional FOREIGN KEY written alone, beside the case without it" +anchor = "doc.sql-ref-syntax-ddl-create-table-constraint / Syntax" +sql = "CREATE TABLE t3 ( c1 INT NOT NULL CONSTRAINT n1 FOREIGN KEY REFERENCES t2 )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.dml.insert-into.values-default" +kind = "identifier_class" +target = "DEFAULT" +note = "DEFAULT backtick-quoted in the query, a column name rather than the keyword" +anchor = "doc.sql-ref-syntax-dml-insert-into / Syntax" +sql = "INSERT INTO t1 SELECT `DEFAULT` , 1" +context = "raw" +expect = "observe" + +[[reading]] +form = "db.ddl.create-function" +grammar_sha256 = "5ba5c6dc302b94dcb2fa3e48e56b0a0fa553018d9b5b6fae4ecf11f2dfdab547" +grammar = ["CREATE { OR REPLACE [ TEMPORARY ] FUNCTION | TEMPORARY FUNCTION | FUNCTION [ IF NOT EXISTS ] } AS [ ]"] +reason = "OR REPLACE and IF NOT EXISTS cannot be written together, and a temporary function takes no IF NOT EXISTS: Spark's parse-tree builder refuses both combinations (the warehouse returns syntax_error for TEMPORARY with IF NOT EXISTS on the SQL function form), so the three openings are alternatives" + +[[limit]] +form = "db.expressions.identifiers.subscript-dot" +kind = "alternative" +target = "'_'" +note = "an identifier containing an underscore, the character the page lists" +anchor = "doc.sql-ref-identifiers / Syntax" +sql = "SELECT ( v_1 )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.ddl.create-materialized-view-refresh-policy" +kind = "negative_neighbour" +target = "POLICY" +note = "REFRESH followed by a policy word without POLICY" +anchor = "doc.sql-ref-syntax-ddl-create-materialized-view-refresh-policy / Syntax" +sql = "CREATE MATERIALIZED VIEW mv1 REFRESH AUTO AS SELECT 1" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.ddl.clone.clone-source-temporal" +kind = "alternative" +target = "@" +note = "the source table at a version written with @V, as the names page allows" +anchor = "doc.delta-clone / Syntax" +sql = "CREATE TABLE t3 CLONE t1@v1" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.ddl.clone.clone-source-temporal" +kind = "alternative" +target = "@" +note = "the source table at a timestamp written with @, as the names page allows" +anchor = "doc.delta-clone / Syntax" +sql = "CREATE TABLE t3 CLONE t1@20261101000000000" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.security_admin.alter-group" +kind = "negative_neighbour" +target = "GROUP" +note = "the form without GROUP or USER written after DROP, beside the case written after ADD" +anchor = "doc.security-alter-group / Syntax" +sql = "ALTER GROUP v1 DROP v1" +context = "raw" +expect = "reject" + +[[limit]] +form = "db.security_admin.alter-group" +kind = "option_present" +target = "[ ... ]" +note = "the ADD or DROP group repeated as a whole" +anchor = "doc.security-alter-group / Syntax" +sql = "ALTER GROUP v1 ADD USER v1 DROP GROUP v1" +context = "raw" +expect = "observe" + +[[reading]] +form = "db.transaction_session.set-variable.set-default" +grammar_sha256 = "81a98c043ed8a250c4bf58fd6a5883b4099b81d0bc8c50b8d9710e586685885f" +grammar = ["SET { VAR | VARIABLE } { = { | DEFAULT } } [ , ... ]"] +reason = "the page's note: 'Outside of a compound statement the keywords VAR or VARIABLE are mandatory to disambiguate from a SET config statement.' The cases run outside a compound statement, where SET v1 = 1 is a configuration SET (the page's example: SET var = 5 fails with UNSUPPORTED_FEATURE.SET_VARIABLE_USING_SET), so VAR or VARIABLE is read as required, as the sibling form's reading records" + +[[limit]] +form = "db.transaction_session.timezone" +kind = "alternative" +target = "" +note = "a zone offset, as the page's examples write it" +anchor = "doc.parameters.timezone / Syntax" +sql = "SET TIMEZONE = +08:00" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.transaction_session.timezone" +kind = "alternative" +target = "" +note = "the UTC zone" +anchor = "doc.parameters.timezone / Syntax" +sql = "SET TIMEZONE = UTC" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.transaction_session.conf-mgmt-set-path" +kind = "alternative" +target = "" +note = "the DEFAULT_PATH element" +anchor = "doc.sql-ref-syntax-aux-conf-mgmt-set-path / Syntax" +sql = "SET PATH = DEFAULT_PATH" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.transaction_session.conf-mgmt-set-query-tags.query-tags" +kind = "alternative" +target = "" +note = "UNSET as the tag value, which the Parameters section names" +anchor = "doc.sql-ref-syntax-aux-conf-mgmt-set-query-tags / Syntax" +sql = "SET QUERY_TAGS [ 'k' ] = UNSET" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.transaction_session.declare-variable" +kind = "option_present" +target = "VARIABLE" +note = "the optional VARIABLE alone, beside the form without it" +anchor = "doc.sql-ref-syntax-ddl-declare-variable / Syntax" +sql = "DECLARE VARIABLE v1 INT" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.utility.cache-refresh-table" +kind = "identifier_class" +target = "" +note = "a backtick-quoted name after the TABLE spelling" +anchor = "doc.sql-ref-syntax-aux-cache-refresh-table / Syntax" +sql = "REFRESH TABLE `t1 Q`" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.transaction_session.set-variable.set-default" +kind = "required_operand_missing" +target = "" +note = "omit " +reason = "SET VAR = 1 is a configuration SET of the key VAR: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T190107.177192Z) answers CONFIG_NOT_AVAILABLE, an analysis failure, not a syntax error" + +[[suppress]] +form = "db.transaction_session.set-variable.set-default" +kind = "negative_neighbour" +target = "" +note = "the form without its required { = { | DEFAULT } }" +reason = "SET VAR is a configuration SET that reads the key VAR: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T190107.177192Z) answers CONFIG_NOT_AVAILABLE, an analysis failure, not a syntax error" + +[[suppress]] +form = "db.expressions.names.subscript-dot-4" +kind = "required_operand_missing" +target = "" +note = "omit " +reason = "without a name DESCRIBE VOLUME reads VOLUME as a table name (DESCRIBE [TABLE] table_name): the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T185801.409372Z) answers TABLE_OR_VIEW_NOT_FOUND for `VOLUME`" + +[[suppress]] +form = "db.expressions.names.subscript-dot-4" +kind = "required_operand_missing" +target = " in [ . ]" +note = "omit " +reason = "DESCRIBE VOLUME . v1 reads VOLUME . v1 as a qualified table name: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T185801.409372Z) answers TABLE_OR_VIEW_NOT_FOUND for `VOLUME`.`v1`" + +[[suppress]] +form = "db.utility.optimize" +kind = "negative_neighbour" +target = "" +note = "the form without its required ( in [ ZORDER BY ( [ , ... ] ) ]" +reason = "ZORDER BY takes a single column without parentheses: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T170554.366271Z) accepts OPTIMIZE t1 ZORDER BY c1" + +[[limit]] +form = "db.utility.describe-table" +kind = "alternative" +target = "[ PARTITION ]" +note = "the PARTITION clause alone" +anchor = "doc.sql-ref-syntax-aux-describe-table / Syntax" +sql = "DESC t1 PARTITION ( c1 = 1 )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.utility.describe-table" +kind = "alternative" +target = "FORMATTED" +note = "FORMATTED, which the page names a synonym of EXTENDED" +anchor = "doc.sql-ref-syntax-aux-describe-table / Syntax" +sql = "DESC FORMATTED t1" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.utility.show-functions" +kind = "option_present" +target = "LIKE" +note = "LIKE before an unquoted function name" +anchor = "doc.sql-ref-syntax-aux-show-functions / Syntax" +sql = "SHOW FUNCTIONS LIKE abs" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.utility.show-functions" +kind = "option_present" +target = "LIKE" +note = "LIKE before a quoted pattern" +anchor = "doc.sql-ref-syntax-aux-show-functions / Syntax" +sql = "SHOW FUNCTIONS LIKE 'a*'" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.ddl.create-table-hiveformat" +kind = "negative_neighbour" +target = "" +note = "the form without its required AS after " +reason = "AS before a CTAS query is optional (SqlBaseParser createTable: (AS? query)?): the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T193029.100477Z) parses CREATE TABLE t3 ROW FORMAT DELIMITED SELECT 1 AS c1 , 2 AS c2 , 3 AS c3 and answers UNSUPPORTED_DATA_SOURCE_WRITE, not a syntax error" + +[[reading]] +form = "db.functions.vector-search.query-num-results" +grammar_sha256 = "d078a76374307963108eaf3f54c2e9737eba2ca0436346b6e1bf18fe7c7184cf" +grammar = ["SELECT * FROM VECTOR_SEARCH ( index => , query => , num_results => )"] +reason = "the page's Syntax writes vector_search( index, query, num_results) and its Arguments say all arguments must be passed by name and that query is a STRING, so each argument is written with its name and =>, and the query placeholder is query_str, a string" + +[[reading]] +form = "db.functions.vector-search.query-text-query-vector" +grammar_sha256 = "100608088b093479839aa1d52cb76782f4cb28419d59cf5957aeae4516d3afc0" +grammar = ["SELECT * FROM VECTOR_SEARCH ( index => , { query_text => | query_vector => } [ , num_results => ] )"] +reason = "the page's Syntax writes vector_search( index, { query_text | query_vector }, [ num_results ]) and its Arguments say all arguments must be passed by name, so each argument is written with its name and =>, and the comma before the optional num_results moves inside its brackets" + +[[suppress]] +form = "db.security_admin.deny" +kind = "negative_neighbour" +target = "" +note = "the form without its required ALL after DENY" +reason = "a privilege type is an identifier, so PRIVILEGES alone reads as one: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T170535.934117Z) parses DENY PRIVILEGES ON TABLE t1 TO v1 and answers UC_COMMAND_NOT_SUPPORTED, as it does for DENY SELECT, not a syntax error" + +[[suppress]] +form = "db.security_admin.deny" +kind = "negative_neighbour" +target = "" +note = "the form without its required PRIVILEGES" +reason = "a privilege type is an identifier, so ALL alone reads as one: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T170535.934117Z) parses DENY ALL ON TABLE t1 TO v1 and answers UC_COMMAND_NOT_SUPPORTED, as it does for DENY SELECT, not a syntax error" + +[[reading]] +form = "db.utility.show-functions" +grammar_sha256 = "25df368e34d49b5a85ce6357886273d03818255b7739116f16e46e0e4c49131d" +grammar = ["SHOW [ ] FUNCTIONS [ { FROM | IN } ] [ [ LIKE ] { | } ]"] +reason = "the warehouse refuses an unquoted function name after FROM or IN (DBSQL 2026.45, run databricks-2026.45-20261116T090736.200251Z: SHOW USER FUNCTIONS FROM s1 LIKE abs answers INVALID_SQL_SYNTAX.SHOW_FUNCTIONS_INVALID_PATTERN), so the pattern is read as the first alternative and the form with every option takes a pattern" + +[[suppress]] +form = "db.utility.show-functions" +kind = "operand_type_class" +target = " in [ [ LIKE ] { | } ]" +note = "a valid identifier" +reason = "the derived case puts the function name after FROM s1, which the warehouse refuses (DBSQL 2026.45, run databricks-2026.45-20261116T090736.200251Z: INVALID_SQL_SYNTAX.SHOW_FUNCTIONS_INVALID_PATTERN); a valid function name is the alternative case SHOW FUNCTIONS abs and the [[limit]] SHOW FUNCTIONS LIKE abs" + +[[suppress]] +form = "db.ddl.create-procedure" +kind = "negative_neighbour" +target = "" +note = "the form without its required AS" +reason = "AS before a compound body is optional in the warehouse's parser: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T095943.990438Z) accepts CREATE OR REPLACE PROCEDURE v1 ( ) LANGUAGE SQL SQL SECURITY INVOKER BEGIN SELECT 1 ; END" + +[[suppress]] +form = "db.ddl.create-location" +kind = "negative_neighbour" +target = "" +note = "the form without its required STORAGE" +reason = "STORAGE before CREDENTIAL is optional in the warehouse's parser: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T112320.575489Z) parses CREATE EXTERNAL LOCATION v1 URL 's3://b1/p1' WITH ( CREDENTIAL v1 ) and answers NO_SUCH_STORAGE_CREDENTIAL_EXCEPTION, not a syntax error" + +[[suppress]] +form = "db.ddl.create-policy" +kind = "negative_neighbour" +target = "" +note = "the form without its required TABLE after ON" +reason = "a policy target may be a bare name: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T112320.575489Z) parses CREATE POLICY v1 ON t1 ROW FILTER f1 TO `u1` FOR TABLES and answers PRINCIPAL_DOES_NOT_EXIST, not a syntax error" + +[[suppress]] +form = "db.ddl.create-policy" +kind = "negative_neighbour" +target = "" +note = "the form without its required CATALOG after ON" +reason = "a policy target may be a bare name: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T112320.575489Z) parses CREATE POLICY v1 ON v1 ROW FILTER f1 TO `u1` FOR TABLES and answers PRINCIPAL_DOES_NOT_EXIST, not a syntax error" + +[[suppress]] +form = "db.ddl.create-policy" +kind = "required_operand_missing" +target = "" +note = "omit " +reason = "TABLE alone reads as the name of the policy target: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T112320.575489Z) parses CREATE POLICY v1 ON TABLE ROW FILTER f1 TO `u1` FOR TABLES and answers PRINCIPAL_DOES_NOT_EXIST, not a syntax error" + +[[suppress]] +form = "db.ddl.create-policy" +kind = "required_operand_missing" +target = "" +note = "omit " +reason = "SCHEMA alone reads as the name of the policy target: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T112320.575489Z) parses CREATE POLICY v1 ON SCHEMA ROW FILTER f1 TO `u1` FOR TABLES and answers PRINCIPAL_DOES_NOT_EXIST, not a syntax error" + +[[suppress]] +form = "db.functions.event-log" +kind = "negative_neighbour" +target = "" +note = "the form without its required (" +reason = "without ( the name reads as a table with the alias TABLE and a column list: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T165300.561941Z) parses SELECT * FROM EVENT_LOG TABLE ( t1 ) and answers TABLE_OR_VIEW_NOT_FOUND, not a syntax error" + +[[suppress]] +form = "db.functions.cloud-files-state" +kind = "negative_neighbour" +target = "" +note = "the form without its required (" +reason = "without ( the name reads as a table with the alias TABLE and a column list: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T165300.561941Z) parses SELECT * FROM CLOUD_FILES_STATE TABLE ( t1 ) and answers TABLE_OR_VIEW_NOT_FOUND, not a syntax error" + +[[suppress]] +form = "db.functions.data-skipping-summary" +kind = "negative_neighbour" +target = "" +note = "the form without its required (" +reason = "without ( the name reads as a table with the alias TABLE and a column list: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T165300.561941Z) parses SELECT * FROM DATA_SKIPPING_SUMMARY TABLE ( t1 ) and answers TABLE_OR_VIEW_NOT_FOUND, not a syntax error" + +[[suppress]] +form = "db.ddl.refresh-full" +kind = "required_operand_missing" +target = " #2" +note = "omit " +reason = "REFRESH followed by one word reads as a resource refresh: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T095943.990438Z) parses REFRESH TABLE and answers UC_COMMAND_NOT_SUPPORTED for resource operations, not a syntax error" + +[[suppress]] +form = "db.ddl.alter-streaming-table.streaming-table-add-alter" +kind = "negative_neighbour" +target = "" +note = "the form without its required STREAMING" +reason = "ALTER TABLE takes a schedule clause in the warehouse's parser: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T095943.990438Z) parses ALTER TABLE t1 ADD SCHEDULE EVERY 1 HOUR and answers ALTER_SCHEDULE_INVALID_ENTITY, not a syntax error" + +[[suppress]] +form = "db.ddl.create-policy" +kind = "required_operand_missing" +target = "" +note = "omit " +reason = "the warehouse parses ON CATALOG without the catalog name: it (DBSQL 2026.45, run databricks-2026.45-20261116T112320.575489Z) parses CREATE POLICY v1 ON CATALOG ROW FILTER f1 TO `u1` FOR TABLES and answers UC_CATALOG_NAME_NOT_PROVIDED, not a syntax error" + +[[suppress]] +form = "db.ddl.create-policy" +kind = "negative_neighbour" +target = "" +note = "the form without its required SCHEMA after ON" +reason = "a policy target may be a bare name: the warehouse (DBSQL 2026.45, run databricks-2026.45-20261116T112320.575489Z) parses CREATE POLICY v1 ON s1 ROW FILTER f1 TO `u1` FOR TABLES and answers PRINCIPAL_DOES_NOT_EXIST, not a syntax error" + +[[reading]] +form = "db.expressions.decfloat-type" +grammar_sha256 = "7897c1dde5bbdf7bb0e9585803e96e12eff47ede0aaaeb5ba473e4813279aad6" +grammar = [] +reason = "documented but rejected at DBSQL 2026.45: the page applies to Databricks SQL but marks DECFLOAT Beta ('A workspace admin must enable DECFLOAT data type in Previews'), and the warehouse (run databricks-2026.45-20261116T170422.040934Z) refuses both documented spellings with UNSUPPORTED_DATATYPE, so the form is not derived and its spellings are observed [[limit]] rows that do not count as verified; the receipts come from a warehouse without the preview, so they stay observed until a warehouse with the preview enabled answers them" + +[[limit]] +form = "db.expressions.decfloat-type" +kind = "positive" +target = "" +note = "documented but rejected at DBSQL 2026.45 (Beta, not enabled): DECFLOAT without a precision" +anchor = "doc.data-types.decfloat-type / Syntax" +sql = "SELECT CAST ( NULL AS DECFLOAT )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.expressions.decfloat-type" +kind = "option_present" +target = "[ (

) ]" +note = "documented but rejected at DBSQL 2026.45 (Beta, not enabled): DECFLOAT with the page's default precision 34" +anchor = "doc.data-types.decfloat-type / Syntax" +sql = "SELECT CAST ( NULL AS DECFLOAT ( 34 ) )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.expressions.decfloat-type" +kind = "required_operand_missing" +target = "

in [ (

) ]" +note = "omit

" +anchor = "doc.data-types.decfloat-type / Syntax" +sql = "SELECT CAST ( NULL AS DECFLOAT ( ) )" +context = "raw" +expect = "reject" + +[[limit]] +form = "db.expressions.decfloat-type" +kind = "negative_neighbour" +target = "" +note = "the form without its required ) in [ (

) ]" +anchor = "doc.data-types.decfloat-type / Syntax" +sql = "SELECT CAST ( NULL AS DECFLOAT ( 34 )" +context = "raw" +expect = "reject" + +[[suppress]] +form = "db.ddl.alter-materialized-view.materialized-view-add-alter" +kind = "negative_neighbour" +target = "" +note = "the form without its required COLUMN" +reason = "COLUMN after ALTER is optional in the column action (Spark's ALTER ... ALTER COLUMN? column), so the text parses; the warehouse answers INVALID_TARGET_FOR_ALTER_COMMAND (42809) after parsing; it is kept as the observed [[limit]] \"ALTER MATERIALIZED VIEW v1 ALTER c1 COMMENT 'x'\", whose 2026.45 receipt settles it" + +[[limit]] +form = "db.ddl.alter-materialized-view.materialized-view-add-alter" +kind = "negative_neighbour" +target = "the form without its required COLUMN" +note = "the form without its required COLUMN; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-ddl-alter-materialized-view / Syntax" +sql = "ALTER MATERIALIZED VIEW v1 ALTER c1 COMMENT 'x'" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.ddl.alter-recipient" +kind = "negative_neighbour" +target = "" +note = "an unquoted identifier in place of " +reason = "a property key is a dotted identifier or a string (Spark's propertyKey: identifier ( . identifier )* | stringLit), so an unquoted name parses; the warehouse answers RECIPIENT_DOES_NOT_EXIST (42704) after parsing; it is kept as the observed [[limit]] \"ALTER RECIPIENT v1 SET PROPERTIES ( m1 'v' )\", whose 2026.45 receipt settles it" + +[[limit]] +form = "db.ddl.alter-recipient" +kind = "negative_neighbour" +target = "" +note = "an unquoted identifier in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-ddl-alter-recipient / Syntax" +sql = "ALTER RECIPIENT v1 SET PROPERTIES ( m1 'v' )" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.ddl.alter-recipient" +kind = "negative_neighbour" +target = " #2" +note = "an unquoted identifier in place of " +reason = "a property key is a dotted identifier or a string (Spark's propertyKey: identifier ( . identifier )* | stringLit), so an unquoted name parses; the warehouse answers RECIPIENT_DOES_NOT_EXIST (42704) after parsing; it is kept as the observed [[limit]] 'ALTER RECIPIENT v1 UNSET PROPERTIES ( m1 )', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.ddl.alter-recipient" +kind = "negative_neighbour" +target = " #2" +note = "an unquoted identifier in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-ddl-alter-recipient / Syntax" +sql = "ALTER RECIPIENT v1 UNSET PROPERTIES ( m1 )" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.ddl.alter-streaming-table.streaming-table-add-alter" +kind = "negative_neighbour" +target = "" +note = "the form without its required COLUMN" +reason = "COLUMN after ALTER is optional in the column action (Spark's ALTER ... ALTER COLUMN? column), so the text parses; the warehouse answers INVALID_TARGET_FOR_ALTER_COMMAND (42809) after parsing; it is kept as the observed [[limit]] \"ALTER STREAMING TABLE t1 ALTER c1 COMMENT 'x'\", whose 2026.45 receipt settles it" + +[[limit]] +form = "db.ddl.alter-streaming-table.streaming-table-add-alter" +kind = "negative_neighbour" +target = "the form without its required COLUMN" +note = "the form without its required COLUMN; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-ddl-alter-streaming-table / Syntax" +sql = "ALTER STREAMING TABLE t1 ALTER c1 COMMENT 'x'" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.ddl.column-mask" +kind = "negative_neighbour" +target = " in [ USING COLUMNS ( { | } [ , ... ] ) ]" +note = "a string literal in place of " +reason = "the same list's other alternative is , and a string literal is a constant literal, so the text is valid by the documented grammar; the warehouse answers ROUTINE_NOT_FOUND (42883) after parsing; it is kept as the observed [[limit]] \"CREATE TABLE t3 ( c1 INT MASK v1 USING COLUMNS ( 'v1' ) )\", whose 2026.45 receipt settles it" + +[[limit]] +form = "db.ddl.column-mask" +kind = "negative_neighbour" +target = " in [ USING COLUMNS ( { | } [ , ... ] ) ]" +note = "a string literal in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-ddl-column-mask / Syntax" +sql = "CREATE TABLE t3 ( c1 INT MASK v1 USING COLUMNS ( 'v1' ) )" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.ddl.create-recipient" +kind = "negative_neighbour" +target = " in [ PROPERTIES ( { [ . ... ] | } [ = ]…" +note = "an unquoted identifier in place of " +reason = "a property key is a dotted identifier or a string (Spark's propertyKey: identifier ( . identifier )* | stringLit), so an unquoted name parses; the warehouse answers PERMISSION_DENIED (42501) after parsing; it is kept as the observed [[limit]] \"CREATE RECIPIENT v1 PROPERTIES ( m1 'v' )\", whose 2026.45 receipt settles it" + +[[limit]] +form = "db.ddl.create-recipient" +kind = "negative_neighbour" +target = " in [ PROPERTIES ( { [ . ... ] | } [ = ]…" +note = "an unquoted identifier in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-ddl-create-recipient / Syntax" +sql = "CREATE RECIPIENT v1 PROPERTIES ( m1 'v' )" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.ddl.create-sql-function" +kind = "negative_neighbour" +target = " #2" +note = "a bare literal in place of " +reason = "RETURN takes an expression or a query while parsing, and that a table function's body must be a query is checked afterwards: the warehouse answers USER_DEFINED_FUNCTIONS.SQL_TABLE_UDF_BODY_MUST_BE_A_QUERY; it is kept as the observed [[limit]] 'CREATE OR REPLACE FUNCTION abs ( ) RETURNS TABLE RETURN 1', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.ddl.create-sql-function" +kind = "negative_neighbour" +target = " #2" +note = "a bare literal in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-ddl-create-sql-function / Syntax" +sql = "CREATE OR REPLACE FUNCTION abs ( ) RETURNS TABLE RETURN 1" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.ddl.create-streaming-table-auto-cdc" +kind = "negative_neighbour" +target = " #2" +note = "a string literal in place of " +reason = "SEQUENCE BY takes an expression while parsing, and a string literal is an expression; that it names a column is checked afterwards: the warehouse answers UNRESOLVED_COLUMN (42703); it is kept as the observed [[limit]] \"CREATE OR REFRESH STREAMING TABLE st1 FLOW AUTO CDC FROM v1 KEYS ( v1 ) SEQUENCE BY 'v1' COLUMNS TO UPDATE c1\", whose 2026.45 receipt settles it" + +[[limit]] +form = "db.ddl.create-streaming-table-auto-cdc" +kind = "negative_neighbour" +target = " #2" +note = "a string literal in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-ddl-create-streaming-table-auto-cdc / Syntax" +sql = "CREATE OR REFRESH STREAMING TABLE st1 FLOW AUTO CDC FROM v1 KEYS ( v1 ) SEQUENCE BY 'v1' COLUMNS TO UPDATE c1" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.ddl.create-streaming-table-auto-cdc" +kind = "negative_neighbour" +target = " #3" +note = "a string literal in place of " +reason = "SEQUENCE BY takes an expression while parsing, and a string literal is an expression; that it names a column is checked afterwards: the warehouse answers UNRESOLVED_COLUMN (42703); it is kept as the observed [[limit]] \"CREATE OR REFRESH STREAMING TABLE st1 FLOW AUTO CDC FROM v1 KEYS ( v1 ) SEQUENCE BY 'v1' SYSTEM SEQUENCE BY v1 STORED AS BITEMPORAL\", whose 2026.45 receipt settles it" + +[[limit]] +form = "db.ddl.create-streaming-table-auto-cdc" +kind = "negative_neighbour" +target = " #3" +note = "a string literal in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-ddl-create-streaming-table-auto-cdc / Syntax" +sql = "CREATE OR REFRESH STREAMING TABLE st1 FLOW AUTO CDC FROM v1 KEYS ( v1 ) SEQUENCE BY 'v1' SYSTEM SEQUENCE BY v1 STORED AS BITEMPORAL" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.ddl.create-streaming-table-auto-cdc" +kind = "negative_neighbour" +target = "" +note = "a string literal in place of " +reason = "SYSTEM SEQUENCE BY takes an expression while parsing, and a string literal is an expression; that it names a column is checked afterwards: the warehouse answers UNRESOLVED_COLUMN (42703); it is kept as the observed [[limit]] \"CREATE OR REFRESH STREAMING TABLE st1 FLOW AUTO CDC FROM v1 KEYS ( v1 ) SEQUENCE BY v1 SYSTEM SEQUENCE BY 'v1' STORED AS BITEMPORAL\", whose 2026.45 receipt settles it" + +[[limit]] +form = "db.ddl.create-streaming-table-auto-cdc" +kind = "negative_neighbour" +target = "" +note = "a string literal in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-ddl-create-streaming-table-auto-cdc / Syntax" +sql = "CREATE OR REFRESH STREAMING TABLE st1 FLOW AUTO CDC FROM v1 KEYS ( v1 ) SEQUENCE BY v1 SYSTEM SEQUENCE BY 'v1' STORED AS BITEMPORAL" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.expressions.names.identifier-2" +kind = "required_operand_missing" +target = "" +note = "omit " +reason = "FROM is not reserved, so a trailing FROM parses as the alias of the select list: the warehouse answers INVALID_USAGE_OF_STAR_OR_REGEX for '*' in expression `alias`; it is kept as the observed [[limit]] 'SELECT * FROM', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.expressions.names.identifier-2" +kind = "required_operand_missing" +target = "" +note = "omit ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-names / Syntax" +sql = "SELECT * FROM" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.expressions.names.identifier.syntax" +kind = "required_operand_missing" +target = "" +note = "omit " +reason = "FROM is not reserved, so a trailing FROM parses as the alias of the select list: the warehouse answers INVALID_USAGE_OF_STAR_OR_REGEX for '*' in expression `alias`; it is kept as the observed [[limit]] 'SELECT * FROM', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.expressions.names.identifier.syntax" +kind = "required_operand_missing" +target = "" +note = "omit ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-names / Syntax" +sql = "SELECT * FROM" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.query.select-hints.join-hint-alias" +kind = "negative_neighbour" +target = "" +note = "the form without its required (" +reason = "a hint is written inside a /*+ */ comment, and the warehouse drops a hint it cannot read rather than refusing the statement: it accepts the text; it is kept as the observed [[limit]] 'SELECT /*+ BROADCASTJOIN t1 */ c1 FROM t1', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.query.select-hints.join-hint-alias" +kind = "negative_neighbour" +target = "the form without its required (" +note = "the form without its required (; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-qry-select-hints / Syntax" +sql = "SELECT /*+ BROADCASTJOIN t1 */ c1 FROM t1" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.scripting.execute-immediate" +kind = "negative_neighbour" +target = "" +note = "an unquoted identifier in place of " +reason = "the statement text may be a string or a variable that holds it, so an unquoted name parses and is resolved afterwards: the warehouse answers UNRESOLVED_COLUMN (42703); it is kept as the observed [[limit]] 'EXECUTE IMMEDIATE m1', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.scripting.execute-immediate" +kind = "negative_neighbour" +target = "" +note = "an unquoted identifier in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-aux-execute-immediate / Syntax" +sql = "EXECUTE IMMEDIATE m1" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.scripting.signal-stmt" +kind = "negative_neighbour" +target = " in [ SET { MESSAGE_ARGUMENTS = | MESSAGE_TEXT = } ]" +note = "an unquoted identifier in place of " +reason = "the message may be a string or a variable that holds it, so an unquoted name parses and is resolved afterwards: the warehouse answers CONDITION_NOT_FOUND (42K0Q) for the condition first; it is kept as the observed [[limit]] 'BEGIN SIGNAL v1 SET MESSAGE_TEXT = m1 ; END', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.scripting.signal-stmt" +kind = "negative_neighbour" +target = " in [ SET { MESSAGE_ARGUMENTS = | MESSAGE_TEXT = } ]" +note = "an unquoted identifier in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.control-flow.signal-stmt / Syntax" +sql = "BEGIN SIGNAL v1 SET MESSAGE_TEXT = m1 ; END" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.scripting.signal-stmt" +kind = "negative_neighbour" +target = " in [ SET MESSAGE_TEXT = ]" +note = "an unquoted identifier in place of " +reason = "the message may be a string or a variable that holds it, so an unquoted name parses and is resolved afterwards: the warehouse answers UNRESOLVED_COLUMN (42703); it is kept as the observed [[limit]] \"BEGIN SIGNAL SQLSTATE '45000' SET MESSAGE_TEXT = m1 ; END\", whose 2026.45 receipt settles it" + +[[limit]] +form = "db.scripting.signal-stmt" +kind = "negative_neighbour" +target = " in [ SET MESSAGE_TEXT = ]" +note = "an unquoted identifier in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.control-flow.signal-stmt / Syntax" +sql = "BEGIN SIGNAL SQLSTATE '45000' SET MESSAGE_TEXT = m1 ; END" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.security_admin.grant" +kind = "negative_neighbour" +target = "" +note = "the form without its required ALL after GRANT" +reason = "privileges are parsed as names, so PRIVILEGES alone parses as a privilege; the warehouse answers PRINCIPAL_DOES_NOT_EXIST (42704) after parsing; it is kept as the observed [[limit]] 'GRANT PRIVILEGES ON TABLE t1 TO v1', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.security_admin.grant" +kind = "negative_neighbour" +target = "the form without its required ALL after GRANT" +note = "the form without its required ALL after GRANT; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.security-grant / Syntax" +sql = "GRANT PRIVILEGES ON TABLE t1 TO v1" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.security_admin.grant" +kind = "negative_neighbour" +target = "" +note = "the form without its required PRIVILEGES" +reason = "ALL without PRIVILEGES parses as the same privilege set; the warehouse answers PRINCIPAL_DOES_NOT_EXIST (42704) after parsing; it is kept as the observed [[limit]] 'GRANT ALL ON TABLE t1 TO v1', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.security_admin.grant" +kind = "negative_neighbour" +target = "the form without its required PRIVILEGES" +note = "the form without its required PRIVILEGES; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.security-grant / Syntax" +sql = "GRANT ALL ON TABLE t1 TO v1" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.security_admin.revoke" +kind = "negative_neighbour" +target = "" +note = "the form without its required ALL after REVOKE" +reason = "privileges are parsed as names, so PRIVILEGES alone parses as a privilege; the warehouse answers PRINCIPAL_DOES_NOT_EXIST (42704) after parsing; it is kept as the observed [[limit]] 'REVOKE PRIVILEGES ON TABLE t1 FROM v1', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.security_admin.revoke" +kind = "negative_neighbour" +target = "the form without its required ALL after REVOKE" +note = "the form without its required ALL after REVOKE; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.security-revoke / Syntax" +sql = "REVOKE PRIVILEGES ON TABLE t1 FROM v1" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.security_admin.revoke" +kind = "negative_neighbour" +target = "" +note = "the form without its required PRIVILEGES" +reason = "ALL without PRIVILEGES parses as the same privilege set; the warehouse answers PRINCIPAL_DOES_NOT_EXIST (42704) after parsing; it is kept as the observed [[limit]] 'REVOKE ALL ON TABLE t1 FROM v1', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.security_admin.revoke" +kind = "negative_neighbour" +target = "the form without its required PRIVILEGES" +note = "the form without its required PRIVILEGES; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.security-revoke / Syntax" +sql = "REVOKE ALL ON TABLE t1 FROM v1" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.utility.cache-refresh" +kind = "negative_neighbour" +target = "" +note = "an unquoted identifier in place of " +reason = "REFRESH followed by any text parses as the resource refresh (Spark's #refreshResource: REFRESH ( stringLit | .*? )); the warehouse answers UC_COMMAND_NOT_SUPPORTED (0AKUC) after parsing; it is kept as the observed [[limit]] 'REFRESH m1', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.utility.cache-refresh" +kind = "negative_neighbour" +target = "" +note = "an unquoted identifier in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-aux-cache-refresh / Syntax" +sql = "REFRESH m1" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.utility.resource-mgmt-add-archive" +kind = "required_operand_missing" +target = "" +note = "omit " +reason = "ADD and LIST of a resource take any text after the resource word, none included (Spark's #manageResource: ( ADD | LIST ) identifier .*?); the warehouse answers NOT_SUPPORTED_WITH_DB_SQL (0A000) after parsing; it is kept as the observed [[limit]] 'ADD ARCHIVE', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.utility.resource-mgmt-add-archive" +kind = "required_operand_missing" +target = "" +note = "omit ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-aux-resource-mgmt-add-archive / Syntax" +sql = "ADD ARCHIVE" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.utility.resource-mgmt-add-archive" +kind = "negative_neighbour" +target = "" +note = "an unquoted identifier in place of " +reason = "ADD and LIST of a resource take any text after the resource word (Spark's #manageResource: ( ADD | LIST ) identifier .*?); the warehouse answers NOT_SUPPORTED_WITH_DB_SQL (0A000) after parsing; it is kept as the observed [[limit]] 'ADD ARCHIVE m1', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.utility.resource-mgmt-add-archive" +kind = "negative_neighbour" +target = "" +note = "an unquoted identifier in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-aux-resource-mgmt-add-archive / Syntax" +sql = "ADD ARCHIVE m1" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.utility.resource-mgmt-add-file" +kind = "required_operand_missing" +target = "" +note = "omit " +reason = "ADD and LIST of a resource take any text after the resource word, none included (Spark's #manageResource: ( ADD | LIST ) identifier .*?); the warehouse answers NOT_SUPPORTED_WITH_DB_SQL (0A000) after parsing; it is kept as the observed [[limit]] 'ADD FILE', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.utility.resource-mgmt-add-file" +kind = "required_operand_missing" +target = "" +note = "omit ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-aux-resource-mgmt-add-file / Syntax" +sql = "ADD FILE" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.utility.resource-mgmt-add-jar" +kind = "required_operand_missing" +target = "" +note = "omit " +reason = "ADD and LIST of a resource take any text after the resource word, none included (Spark's #manageResource: ( ADD | LIST ) identifier .*?); the warehouse answers NOT_SUPPORTED_WITH_DB_SQL (0A000) after parsing; it is kept as the observed [[limit]] 'ADD JAR', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.utility.resource-mgmt-add-jar" +kind = "required_operand_missing" +target = "" +note = "omit ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-aux-resource-mgmt-add-jar / Syntax" +sql = "ADD JAR" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.utility.resource-mgmt-add-jar" +kind = "negative_neighbour" +target = "" +note = "an unquoted identifier in place of " +reason = "ADD and LIST of a resource take any text after the resource word (Spark's #manageResource: ( ADD | LIST ) identifier .*?); the warehouse answers NOT_SUPPORTED_WITH_DB_SQL (0A000) after parsing; it is kept as the observed [[limit]] 'ADD JAR m1', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.utility.resource-mgmt-add-jar" +kind = "negative_neighbour" +target = "" +note = "an unquoted identifier in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-aux-resource-mgmt-add-jar / Syntax" +sql = "ADD JAR m1" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.utility.resource-mgmt-list-archive" +kind = "negative_neighbour" +target = " in [ [ ... ] ]" +note = "an unquoted identifier in place of " +reason = "ADD and LIST of a resource take any text after the resource word (Spark's #manageResource: ( ADD | LIST ) identifier .*?); the warehouse answers UC_COMMAND_NOT_SUPPORTED (0AKUC) after parsing; it is kept as the observed [[limit]] 'LIST ARCHIVE m1', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.utility.resource-mgmt-list-archive" +kind = "negative_neighbour" +target = " in [ [ ... ] ]" +note = "an unquoted identifier in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-aux-resource-mgmt-list-archive / Syntax" +sql = "LIST ARCHIVE m1" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.utility.resource-mgmt-list-jar" +kind = "negative_neighbour" +target = " in [ [ ... ] ]" +note = "an unquoted identifier in place of " +reason = "ADD and LIST of a resource take any text after the resource word (Spark's #manageResource: ( ADD | LIST ) identifier .*?); the warehouse answers NOT_SUPPORTED_WITH_DB_SQL (0A000) after parsing; it is kept as the observed [[limit]] 'LIST JAR m1', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.utility.resource-mgmt-list-jar" +kind = "negative_neighbour" +target = " in [ [ ... ] ]" +note = "an unquoted identifier in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-aux-resource-mgmt-list-jar / Syntax" +sql = "LIST JAR m1" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.utility.show-functions" +kind = "negative_neighbour" +target = " in [ [ LIKE ] { | } ]" +note = "an unquoted identifier in place of " +reason = "SHOW FUNCTIONS takes a function name as well as a pattern (Spark's SHOW FUNCTIONS ... LIKE? ( multipartIdentifier | stringLit )), so an unquoted name parses; the warehouse accepts the text; it is kept as the observed [[limit]] 'SHOW FUNCTIONS m1', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.utility.show-functions" +kind = "negative_neighbour" +target = " in [ [ LIKE ] { | } ]" +note = "an unquoted identifier in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-aux-show-functions / Syntax" +sql = "SHOW FUNCTIONS m1" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.utility.show-tblproperties" +kind = "negative_neighbour" +target = " in [ ( { | } ) ]" +note = "an unquoted identifier in place of " +reason = "the key is a property key, a dotted identifier or a string (Spark's propertyKey: identifier ( . identifier )* | stringLit), so an unquoted name parses; the warehouse accepts the text; it is kept as the observed [[limit]] 'SHOW TBLPROPERTIES t1 ( m1 )', whose 2026.45 receipt settles it" + +[[limit]] +form = "db.utility.show-tblproperties" +kind = "negative_neighbour" +target = " in [ ( { | } ) ]" +note = "an unquoted identifier in place of ; the warehouse parses the text, so its answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-aux-show-tblproperties / Syntax" +sql = "SHOW TBLPROPERTIES t1 ( m1 )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.utility.analyze-compute-storage-metrics" +kind = "negative_neighbour" +target = "CONF in [ USING INVENTORY LOCATION CONF ]" +note = "an inventory location of one string with no CONF: the derived negative drops only CONF, and the warehouse joins its two adjacent strings into one path, so this text shows CONF is required without relying on that join" +anchor = "doc.sql-ref-syntax-aux-analyze-compute-storage-metrics / Syntax" +sql = "ANALYZE TABLE t1 COMPUTE STORAGE METRICS USING INVENTORY LOCATION 'm'" +context = "raw" +expect = "reject" + +[[limit]] +form = "db.ddl.alter-catalog" +kind = "negative_neighbour" +target = " in [ ] with SET TAGS" +note = "a string literal in place of before SET TAGS: the derived negative ALTER CATALOG 'v1' OWNER TO v1 is refused at OWNER, so it does not show which part the warehouse refuses; this one is refused in the tag clause (PARSE_SYNTAX_ERROR at TAGS), which takes no string literal as the catalog name" +anchor = "doc.sql-ref-syntax-ddl-alter-catalog / Syntax" +sql = "ALTER CATALOG 'v1' SET TAGS ( 'k' = 'v' )" +context = "raw" +expect = "reject" + +[[limit]] +form = "db.ddl.alter-catalog" +kind = "negative_neighbour" +target = " in [ ] with UNSET TAGS" +note = "a string literal in place of before UNSET TAGS: the warehouse refuses it (PARSE_SYNTAX_ERROR at UNSET, pos 19), as it does before SET TAGS" +anchor = "doc.sql-ref-syntax-ddl-alter-catalog / Syntax" +sql = "ALTER CATALOG 'v1' UNSET TAGS ( 'k' )" +context = "raw" +expect = "reject" + +[[limit]] +form = "db.ddl.alter-catalog" +kind = "negative_neighbour" +target = " in [ ] with ENABLE PREDICTIVE OPTIMIZATION" +note = "a string literal in place of before a predictive optimization clause: the warehouse refuses it (PARSE_SYNTAX_ERROR at ENABLE, pos 19)" +anchor = "doc.sql-ref-syntax-ddl-alter-catalog / Syntax" +sql = "ALTER CATALOG 'v1' ENABLE PREDICTIVE OPTIMIZATION" +context = "raw" +expect = "reject" + +[[limit]] +form = "db.security_admin.alter-group" +kind = "negative_neighbour" +target = "{ ADD | DROP } repeated" +note = "an ADD followed by a DROP in one statement: the page's trailing [ ... ] reads as a repeat, but the warehouse refuses the second clause (PARSE_SYNTAX_ERROR at DROP)" +anchor = "doc.security-alter-group / Syntax" +sql = "ALTER GROUP v1 ADD USER v1 DROP GROUP v1" +context = "raw" +expect = "reject" + +[[limit]] +form = "db.functions.ai-predict-class" +kind = "negative_neighbour" +target = "TABLE ( ) with its ) restored after the named arguments" +note = "the o016 negative (the form without its required )) with the ) put back at the end instead: the warehouse reads TABLE ( v1 , target_col => v1 , feature_cols => v1 ) as a call of a function named TABLE (semantic_error UNRESOLVED_ROUTINE TABLE), so it parses; this shows the o016 refusal is the missing ), at end of input. Observed, so its receipt settles it" +anchor = "doc.functions.ai_predict_class / Syntax" +sql = "SELECT * FROM AI_PREDICT_CLASS ( input => TABLE ( v1 , target_col => v1 , feature_cols => v1 ) )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.functions.ai-predict-value" +kind = "negative_neighbour" +target = "TABLE ( ) with its ) restored after the named arguments" +note = "the o016 negative (the form without its required )) with the ) put back at the end instead: the warehouse reads TABLE ( v1 , target_col => v1 , feature_cols => v1 ) as a call of a function named TABLE (semantic_error UNRESOLVED_ROUTINE TABLE), so it parses; this shows the o016 refusal is the missing ), at end of input. Observed, so its receipt settles it" +anchor = "doc.functions.ai_predict_value / Syntax" +sql = "SELECT * FROM AI_PREDICT_VALUE ( input => TABLE ( v1 , target_col => v1 , feature_cols => v1 ) )" +context = "raw" +expect = "observe" + +[[limit]] +form = "db.transaction_session.use-catalog" +kind = "alternative" +target = "{ USE | SET } → SET with " +note = "SET CATALOG with a catalog name: the derived SET case writes the string spelling, and the warehouse reads SET CATALOG alone as a configuration key (CONFIG_NOT_AVAILABLE CATALOG, recorded), so SET with a name is observed on its own" +anchor = "doc.sql-ref-syntax-ddl-use-catalog / Syntax" +sql = "SET CATALOG v1" +context = "raw" +expect = "accept" + +[[suppress]] +form = "db.transaction_session.use-catalog" +kind = "negative_neighbour" +target = "" +note = "the form without its required CATALOG" +reason = "without CATALOG the text is USE of a schema (the use-schema page's USE [ SCHEMA ] schema_name), so 'USE v1' parses: the warehouse answers SCHEMA_NOT_FOUND for workspace.v1 (recorded); it is kept as an observed [[limit]] whose receipt settles it" + +[[limit]] +form = "db.transaction_session.use-catalog" +kind = "negative_neighbour" +target = "USE without CATALOG" +note = "the form without CATALOG, which reads as USE of a schema; the warehouse answers SCHEMA_NOT_FOUND, so the answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-ddl-use-catalog / Syntax" +sql = "USE v1" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.transaction_session.use-catalog" +kind = "negative_neighbour" +target = "" +note = "the form without its required { | ' catalog_name ' }" +reason = "without the name, CATALOG is itself read as a schema name: 'USE CATALOG' is USE of a schema named catalog (SCHEMA_NOT_FOUND workspace.catalog, recorded); it is kept as an observed [[limit]] whose receipt settles it" + +[[limit]] +form = "db.transaction_session.use-catalog" +kind = "negative_neighbour" +target = "USE CATALOG without a name" +note = "the form without its catalog name, which reads as USE of a schema named catalog; the warehouse answers SCHEMA_NOT_FOUND, so the answer is recorded rather than expected" +anchor = "doc.sql-ref-syntax-ddl-use-catalog / Syntax" +sql = "USE CATALOG" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.security_admin.show-grant-on-share" +kind = "negative_neighbour" +target = "" +note = "the form without its required SHARE" +reason = "without SHARE the name is a table or view (the show-grant page's SHOW GRANTS ON securable_object), so 'SHOW GRANTS ON v1' runs on the view v1 (accepted, recorded); it is kept as an observed [[limit]] whose receipt settles it" + +[[limit]] +form = "db.security_admin.show-grant-on-share" +kind = "negative_neighbour" +target = "SHOW GRANTS ON without SHARE" +note = "the form without SHARE, which reads as SHOW GRANTS on a table or view; the warehouse accepts it, so the answer is recorded rather than expected" +anchor = "doc.security-show-grant-on-share / Syntax" +sql = "SHOW GRANTS ON v1" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.security_admin.show-grant-on-share" +kind = "required_operand_missing" +target = "" +note = "omit " +reason = "without the share name, SHARE is itself read as a table name: 'SHOW GRANTS ON SHARE' answers TABLE_DOES_NOT_EXIST for a table named share (recorded); it is kept as an observed [[limit]] whose receipt settles it" + +[[limit]] +form = "db.security_admin.show-grant-on-share" +kind = "required_operand_missing" +target = "SHOW GRANTS ON SHARE without a name" +note = "the form without its share name, which reads as SHOW GRANTS on a table named share; the warehouse answers TABLE_DOES_NOT_EXIST, so the answer is recorded rather than expected" +anchor = "doc.security-show-grant-on-share / Syntax" +sql = "SHOW GRANTS ON SHARE" +context = "raw" +expect = "observe" + +[[suppress]] +form = "db.scripting.iterate-stmt" +kind = "positive" +target = "" +reason = "ITERATE inside the shared LOOP context with no LEAVE never ends: the warehouse runs it to the 300 s deadline, so no phase can be observed. The positive and the valid-label case are written instead as a loop that counts to 2 and leaves, which the warehouse runs and accepts (recorded on 17 Nov 2026); the label's negatives keep the shared context, since each is refused or resolved before the loop runs" + +[[suppress]] +form = "db.scripting.iterate-stmt" +kind = "operand_type_class" +target = "

" +anchor = "doc.data-types.decfloat-type / Syntax" +note = "a string where the page documents an integer" [[obligation]] -id = "db.expressions.decfloat-type.o002" -kind = "option_present" +id = "db.expressions.decfloat-type.o009" +kind = "positive" required = true -target = "[ (

) ]" +anchor = "doc.data-types.decfloat-type / Syntax" +note = "documented but rejected at DBSQL 2026.45 (Beta, not enabled): DECFLOAT without a precision" [[obligation]] -id = "db.expressions.decfloat-type.o003" -kind = "option_absent" +id = "db.expressions.decfloat-type.o010" +kind = "option_present" required = true target = "[ (

) ]" +anchor = "doc.data-types.decfloat-type / Syntax" +note = "documented but rejected at DBSQL 2026.45 (Beta, not enabled): DECFLOAT with the page's default precision 34" [[obligation]] -id = "db.expressions.decfloat-type.o005" -kind = "operand_type_class" +id = "db.expressions.decfloat-type.o007" +kind = "required_operand_missing" required = true target = "

in [ (

) ]" -note = "a valid operand" +anchor = "doc.data-types.decfloat-type / Syntax" +note = "omit

" [[obligation]] id = "db.expressions.decfloat-type.o006" kind = "negative_neighbour" required = true +anchor = "doc.data-types.decfloat-type / Syntax" note = "the form without its required ) in [ (

) ]" [[obligation]] @@ -511,6 +413,13 @@ kind = "option_absent" required = true target = "[ (

[ , ] ) ]" +[[obligation]] +id = "db.expressions.decimal-type.o014" +kind = "required_operand_missing" +required = true +target = "

in [ (

[ , ] ) ]" +note = "omit

" + [[obligation]] id = "db.expressions.decimal-type.o008" kind = "operand_type_class" @@ -551,92 +460,82 @@ required = true note = "the form without its required ) in [ (

[ , ] ) ]" [[obligation]] -id = "db.expressions.decimal-type.bd.o001" -kind = "positive" +id = "db.expressions.decimal-type.o015" +kind = "operand_type_class" required = true -note = "the documented form with every required part and no optional part" +target = "

" +anchor = "doc.data-types.decimal-type / Syntax" +note = "a string where the page documents an integer" [[obligation]] -id = "db.expressions.decimal-type.bd.o003" +id = "db.expressions.decimal-type.o016" kind = "operand_type_class" required = true -target = "" -note = "a valid operand" +target = "" +anchor = "doc.data-types.decimal-type / Syntax" +note = "a string where the page documents an integer" [[obligation]] -id = "db.expressions.decimal-type.bd.o004" -kind = "option_present" +id = "db.expressions.decimal-type.bd.o007" +kind = "positive" required = true -target = "[ ]" +anchor = "doc.data-types.decimal-type / Literals" +note = "digits with the BD postfix" [[obligation]] -id = "db.expressions.decimal-type.bd.o005" -kind = "option_absent" +id = "db.expressions.decimal-type.bd.o008" +kind = "option_present" required = true target = "[ ]" +anchor = "doc.data-types.decimal-type / Literals" +note = "digits with an exponent and the BD postfix" [[obligation]] -id = "db.expressions.decimal-type.bd.o006" -kind = "operand_type_class" +id = "db.expressions.decimal-type.bd.o009" +kind = "option_present" required = true -target = " in [ ]" -note = "a valid operand" +target = "[ + | - ] in " +anchor = "doc.data-types.decimal-type / Literals" +note = "an exponent with a sign" [[obligation]] -id = "db.expressions.decimal-type.subscript.o001" +id = "db.expressions.decimal-type.subscript.o010" kind = "positive" required = true -note = "the documented form with every required part and no optional part" +anchor = "doc.data-types.decimal-type / Literals" +note = "decimal_digits alone" [[obligation]] -id = "db.expressions.decimal-type.subscript.o002" -kind = "operand_type_class" -required = true -target = "" -note = "a valid operand" - -[[obligation]] -id = "db.expressions.decimal-type.subscript.o003" +id = "db.expressions.decimal-type.subscript.o011" kind = "alternative" required = true target = "{ [ BD ] | [ BD ] } → [ BD ]" +anchor = "doc.data-types.decimal-type / Literals" +note = "decimal_digits with the BD postfix" [[obligation]] -id = "db.expressions.decimal-type.subscript.o004" +id = "db.expressions.decimal-type.subscript.o012" kind = "alternative" required = true target = "{ [ BD ] | [ BD ] } → [ BD ]" +anchor = "doc.data-types.decimal-type / Literals" +note = "decimal_digits with an exponent and the BD postfix" [[obligation]] -id = "db.expressions.decimal-type.subscript.o005" -kind = "option_present" -required = true -target = "[ BD ]" - -[[obligation]] -id = "db.expressions.decimal-type.subscript.o006" -kind = "option_absent" +id = "db.expressions.decimal-type.subscript.o013" +kind = "alternative" required = true -target = "[ BD ]" +target = " → . digit [ ... ]" +anchor = "doc.data-types.decimal-type / Literals" +note = "decimal_digits with no digit before the point" [[obligation]] -id = "db.expressions.decimal-type.subscript.o007" +id = "db.expressions.decimal-type.subscript.o014" kind = "option_present" required = true -target = "[ BD ]" - -[[obligation]] -id = "db.expressions.decimal-type.subscript.o008" -kind = "option_absent" -required = true -target = "[ BD ]" - -[[obligation]] -id = "db.expressions.decimal-type.subscript.o009" -kind = "operand_type_class" -required = true -target = " in [ BD ]" -note = "a valid operand" +target = "[ + | - ] in " +anchor = "doc.data-types.decimal-type / Literals" +note = "decimal_digits with a sign" [[obligation]] id = "db.expressions.double-type.o001" @@ -645,111 +544,74 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.expressions.double-type.d.o001" +id = "db.expressions.double-type.d.o009" kind = "positive" required = true -note = "the documented form with every required part and no optional part" - -[[obligation]] -id = "db.expressions.double-type.d.o003" -kind = "operand_type_class" -required = true -target = "" -note = "a valid operand" - -[[obligation]] -id = "db.expressions.double-type.d.o004" -kind = "alternative" -required = true -target = "{ D | [ D ] } → D" +anchor = "doc.data-types.double-type / Literals" +note = "decimal_digits with the D postfix" [[obligation]] -id = "db.expressions.double-type.d.o005" +id = "db.expressions.double-type.d.o010" kind = "alternative" required = true -target = "{ D | [ D ] } → [ D ]" - -[[obligation]] -id = "db.expressions.double-type.d.o006" -kind = "operand_type_class" -required = true -target = "" -note = "a valid operand" +target = "{ D | [ D ] } → " +anchor = "doc.data-types.double-type / Literals" +note = "decimal_digits with an exponent and no postfix" [[obligation]] -id = "db.expressions.double-type.d.o007" +id = "db.expressions.double-type.d.o011" kind = "option_present" required = true -target = "[ D ]" - -[[obligation]] -id = "db.expressions.double-type.d.o008" -kind = "option_absent" -required = true -target = "[ D ]" - -[[obligation]] -id = "db.expressions.double-type.d.literals.o001" -kind = "positive" -required = true -note = "the documented form with every required part and no optional part" +target = "[ D ] after " +anchor = "doc.data-types.double-type / Literals" +note = "decimal_digits with an exponent and the D postfix" [[obligation]] -id = "db.expressions.double-type.d.literals.o002" -kind = "operand_type_class" -required = true -target = "" -note = "a valid operand" - -[[obligation]] -id = "db.expressions.double-type.d.literals.o003" -kind = "alternative" +id = "db.expressions.double-type.d.o012" +kind = "option_present" required = true -target = "{ [ D ] | [ ] D } → [ D ]" +target = "[ + | - ] in " +anchor = "doc.data-types.double-type / Literals" +note = "an exponent with a sign" [[obligation]] -id = "db.expressions.double-type.d.literals.o004" +id = "db.expressions.double-type.d.o013" kind = "alternative" required = true -target = "{ [ D ] | [ ] D } → [ ] D" +target = " → . digit [ ... ]" +anchor = "doc.data-types.double-type / Literals" +note = "decimal_digits with no digit before the point" [[obligation]] -id = "db.expressions.double-type.d.literals.o005" -kind = "operand_type_class" -required = true -target = "" -note = "a valid operand" - -[[obligation]] -id = "db.expressions.double-type.d.literals.o006" +id = "db.expressions.double-type.d.o014" kind = "option_present" required = true -target = "[ D ]" +target = "[ + | - ] in " +anchor = "doc.data-types.double-type / Literals" +note = "decimal_digits with a sign" [[obligation]] -id = "db.expressions.double-type.d.literals.o007" -kind = "option_absent" +id = "db.expressions.double-type.d.literals.o011" +kind = "positive" required = true -target = "[ D ]" +anchor = "doc.data-types.double-type / Literals" +note = "digits with an exponent and no postfix" [[obligation]] -id = "db.expressions.double-type.d.literals.o008" +id = "db.expressions.double-type.d.literals.o012" kind = "option_present" required = true -target = "[ ]" - -[[obligation]] -id = "db.expressions.double-type.d.literals.o009" -kind = "option_absent" -required = true -target = "[ ]" +target = "[ D ] after " +anchor = "doc.data-types.double-type / Literals" +note = "digits with an exponent and the D postfix" [[obligation]] -id = "db.expressions.double-type.d.literals.o010" -kind = "operand_type_class" +id = "db.expressions.double-type.d.literals.o013" +kind = "alternative" required = true -target = " in [ ]" -note = "a valid operand" +target = "{ [ D ] | [ ] D } → [ ] D" +anchor = "doc.data-types.double-type / Literals" +note = "digits with the D postfix and no exponent" [[obligation]] id = "db.expressions.expression.o001" @@ -794,22 +656,22 @@ required = true target = "{ | | | |… → " [[obligation]] -id = "db.expressions.expression.o008" +id = "db.expressions.expression.o063" kind = "alternative" required = true -target = "{ | | | |… → CAST " +target = "{ | | | |… → " [[obligation]] -id = "db.expressions.expression.o009" +id = "db.expressions.expression.o064" kind = "alternative" required = true -target = "{ | | | |… → CASE " +target = "{ | | | |… → " [[obligation]] -id = "db.expressions.expression.o010" +id = "db.expressions.expression.o065" kind = "alternative" required = true -target = "{ | | | |… → COLLATE " +target = "{ | | | |… → " [[obligation]] id = "db.expressions.expression.o011" @@ -861,18 +723,18 @@ target = "" note = "a valid operand" [[obligation]] -id = "db.expressions.expression.o019" +id = "db.expressions.expression.o074" kind = "operand_type_class" required = true target = "" -note = "a valid identifier" +note = "a valid operand" [[obligation]] -id = "db.expressions.expression.o021" +id = "db.expressions.expression.o075" kind = "operand_type_class" required = true target = "" -note = "a valid identifier" +note = "a valid operand" [[obligation]] id = "db.expressions.expression.o023" @@ -896,24 +758,24 @@ target = "" note = "a valid operand" [[obligation]] -id = "db.expressions.expression.o028" +id = "db.expressions.expression.o066" kind = "operand_type_class" required = true -target = "" +target = "" note = "a valid expression" [[obligation]] -id = "db.expressions.expression.o030" +id = "db.expressions.expression.o067" kind = "operand_type_class" required = true -target = " #2" +target = "" note = "a valid expression" [[obligation]] -id = "db.expressions.expression.o032" +id = "db.expressions.expression.o068" kind = "operand_type_class" required = true -target = " #3" +target = "" note = "a valid expression" [[obligation]] @@ -923,6 +785,13 @@ required = true target = "" note = "a valid expression" +[[obligation]] +id = "db.expressions.expression.o069" +kind = "required_operand_missing" +required = true +target = "" +note = "omit " + [[obligation]] id = "db.expressions.expression.o034" kind = "operand_type_class" @@ -951,6 +820,13 @@ required = true target = " #2" note = "a valid operand" +[[obligation]] +id = "db.expressions.expression.o070" +kind = "required_operand_missing" +required = true +target = " #3" +note = "omit " + [[obligation]] id = "db.expressions.expression.o038" kind = "operand_type_class" @@ -959,29 +835,31 @@ target = " #3" note = "a valid expression" [[obligation]] -id = "db.expressions.expression.o039" -kind = "operand_type_class" +id = "db.expressions.expression.o071" +kind = "required_operand_missing" required = true target = " #4" -note = "a valid expression" +note = "omit " [[obligation]] -id = "db.expressions.expression.o040" -kind = "option_present" +id = "db.expressions.expression.o039" +kind = "operand_type_class" required = true -target = "[ ]" +target = " #4" +note = "a valid expression" [[obligation]] -id = "db.expressions.expression.o041" -kind = "option_absent" +id = "db.expressions.expression.o044" +kind = "required_operand_missing" required = true -target = "[ ]" +target = " #5" +note = "omit " [[obligation]] -id = "db.expressions.expression.o042" +id = "db.expressions.expression.o045" kind = "operand_type_class" required = true -target = " in [ ]" +target = " #5" note = "a valid expression" [[obligation]] @@ -992,38 +870,38 @@ target = "" note = "a valid operand" [[obligation]] -id = "db.expressions.expression.o044" +id = "db.expressions.expression.o046" kind = "required_operand_missing" required = true -target = " #5" +target = " #6" note = "omit " [[obligation]] -id = "db.expressions.expression.o045" +id = "db.expressions.expression.o047" kind = "operand_type_class" required = true -target = " #5" +target = " #6" note = "a valid expression" [[obligation]] -id = "db.expressions.expression.o046" +id = "db.expressions.expression.o072" kind = "required_operand_missing" required = true -target = " #6" +target = " #7" note = "omit " [[obligation]] -id = "db.expressions.expression.o047" +id = "db.expressions.expression.o048" kind = "operand_type_class" required = true -target = " #6" +target = " #7" note = "a valid expression" [[obligation]] -id = "db.expressions.expression.o048" +id = "db.expressions.expression.o073" kind = "operand_type_class" required = true -target = " #7" +target = " #8" note = "a valid expression" [[obligation]] @@ -1052,38 +930,6 @@ kind = "negative_neighbour" required = true note = "the form without its required )" -[[obligation]] -id = "db.expressions.expression.o053" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "quoted: a double-quoted identifier with blanks and mixed case" - -[[obligation]] -id = "db.expressions.expression.o060" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" - -[[obligation]] -id = "db.expressions.expression.o055" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "quoted: a double-quoted identifier with blanks and mixed case" - -[[obligation]] -id = "db.expressions.expression.o061" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" - [[obligation]] id = "db.expressions.expression.o057" kind = "identifier_class" @@ -1147,221 +993,262 @@ required = true target = "{ FLOAT | REAL } → REAL" [[obligation]] -id = "db.expressions.float-type.f.o001" +id = "db.expressions.float-type.f.o007" kind = "positive" required = true -note = "the documented form with every required part and no optional part" +anchor = "doc.data-types.float-type / Literals" +note = "decimal_digits with the F postfix" [[obligation]] -id = "db.expressions.float-type.f.o003" -kind = "operand_type_class" +id = "db.expressions.float-type.f.o008" +kind = "option_present" required = true -target = "" -note = "a valid operand" +target = "[ ]" +anchor = "doc.data-types.float-type / Literals" +note = "decimal_digits with an exponent and the F postfix" + +[[obligation]] +id = "db.expressions.float-type.f.o009" +kind = "alternative" +required = true +target = " → . digit [ ... ]" +anchor = "doc.data-types.float-type / Literals" +note = "decimal_digits with no digit before the point" + +[[obligation]] +id = "db.expressions.float-type.f.o010" +kind = "option_present" +required = true +target = "[ + | - ] in " +anchor = "doc.data-types.float-type / Literals" +note = "decimal_digits with a sign" + +[[obligation]] +id = "db.expressions.float-type.f.literals.o012" +kind = "positive" +required = true +anchor = "doc.data-types.float-type / Literals" +note = "digits with the F postfix" [[obligation]] -id = "db.expressions.float-type.f.o004" +id = "db.expressions.float-type.f.literals.o013" kind = "option_present" required = true target = "[ ]" +anchor = "doc.data-types.float-type / Literals" +note = "digits with an exponent and the F postfix" [[obligation]] -id = "db.expressions.float-type.f.o005" -kind = "option_absent" +id = "db.expressions.float-type.f.literals.o014" +kind = "alternative" +required = true +target = "[ + | - ] → +" +anchor = "doc.data-types.float-type / Literals" +note = "a plus sign before the literal" + +[[obligation]] +id = "db.expressions.float-type.f.literals.o015" +kind = "alternative" +required = true +target = "[ + | - ] → -" +anchor = "doc.data-types.float-type / Literals" +note = "a minus sign before the literal" + +[[obligation]] +id = "db.expressions.function-invocation.o001" +kind = "positive" +required = true +note = "the documented form with every required part and no optional part" + +[[obligation]] +id = "db.expressions.function-invocation.o002" +kind = "required_operand_missing" required = true -target = "[ ]" +target = "" +note = "omit " [[obligation]] -id = "db.expressions.float-type.f.o006" +id = "db.expressions.function-invocation.o003" kind = "operand_type_class" required = true -target = " in [ ]" -note = "a valid operand" +target = "" +note = "a valid identifier" [[obligation]] -id = "db.expressions.float-type.f.literals.o001" -kind = "positive" +id = "db.expressions.function-invocation.o004" +kind = "negative_neighbour" required = true -note = "the documented form with every required part and no optional part" +target = "" +note = "a string literal in place of " [[obligation]] -id = "db.expressions.float-type.f.literals.o002" +id = "db.expressions.function-invocation.o036" kind = "option_present" required = true -target = "[ + | - ]" +target = "[ { | | } [ , ... ] ]" [[obligation]] -id = "db.expressions.float-type.f.literals.o003" +id = "db.expressions.function-invocation.o037" kind = "option_absent" required = true -target = "[ + | - ]" +target = "[ { | | } [ , ... ] ]" [[obligation]] -id = "db.expressions.float-type.f.literals.o004" +id = "db.expressions.function-invocation.o038" kind = "alternative" required = true -target = "[ + | - ] → +" +target = "{ | | } → " [[obligation]] -id = "db.expressions.float-type.f.literals.o005" +id = "db.expressions.function-invocation.o039" kind = "alternative" required = true -target = "[ + | - ] → -" +target = "{ | | } → " [[obligation]] -id = "db.expressions.float-type.f.literals.o007" -kind = "operand_type_class" +id = "db.expressions.function-invocation.o040" +kind = "alternative" required = true -target = "" -note = "a valid operand" +target = "{ | | } → " [[obligation]] -id = "db.expressions.float-type.f.literals.o008" -kind = "option_present" +id = "db.expressions.function-invocation.o041" +kind = "operand_type_class" required = true -target = "[ ]" +target = " in [ { | | } [ , ... ] ]" +note = "a valid expression" [[obligation]] -id = "db.expressions.float-type.f.literals.o009" -kind = "option_absent" +id = "db.expressions.function-invocation.o042" +kind = "operand_type_class" required = true -target = "[ ]" +target = " in [ { | | } [ , ... ] ]" +note = "a valid operand" [[obligation]] -id = "db.expressions.float-type.f.literals.o010" +id = "db.expressions.function-invocation.o043" kind = "operand_type_class" required = true -target = " in [ ]" +target = " in [ { | | } [ , ... ] ]" note = "a valid operand" [[obligation]] -id = "db.expressions.float-type.f.literals.o011" -kind = "interaction_all_options" +id = "db.expressions.function-invocation.o013" +kind = "option_present" required = true -note = "every independent option of one production together" +target = "[ , ... ]" +note = "the list continued at least once" [[obligation]] -id = "db.expressions.function-invocation.o001" -kind = "positive" +id = "db.expressions.function-invocation.o014" +kind = "option_absent" required = true -note = "the documented form with every required part and no optional part" +target = "[ , ... ]" [[obligation]] -id = "db.expressions.function-invocation.o002" +id = "db.expressions.function-invocation.o044" kind = "required_operand_missing" required = true -target = "" +target = " #2" note = "omit " [[obligation]] -id = "db.expressions.function-invocation.o003" +id = "db.expressions.function-invocation.o045" kind = "operand_type_class" required = true -target = "" +target = " #2" note = "a valid identifier" [[obligation]] -id = "db.expressions.function-invocation.o004" +id = "db.expressions.function-invocation.o046" kind = "negative_neighbour" required = true -target = "" +target = " #2" note = "a string literal in place of " [[obligation]] -id = "db.expressions.function-invocation.o005" +id = "db.expressions.function-invocation.o047" kind = "option_present" required = true -target = "[ | | ]" +target = "[ { | | } [ , ... ] , ]" [[obligation]] -id = "db.expressions.function-invocation.o006" +id = "db.expressions.function-invocation.o048" kind = "option_absent" required = true -target = "[ | | ]" +target = "[ { | | } [ , ... ] , ]" [[obligation]] -id = "db.expressions.function-invocation.o007" +id = "db.expressions.function-invocation.o049" kind = "alternative" required = true -target = "[ | | ] → " +target = "{ | | } → #2" [[obligation]] -id = "db.expressions.function-invocation.o008" +id = "db.expressions.function-invocation.o050" kind = "alternative" required = true -target = "[ | | ] → " +target = "{ | | } → #2" [[obligation]] -id = "db.expressions.function-invocation.o009" +id = "db.expressions.function-invocation.o051" kind = "alternative" required = true -target = "[ | | ] → " +target = "{ | | } → #2" [[obligation]] -id = "db.expressions.function-invocation.o010" +id = "db.expressions.function-invocation.o052" kind = "operand_type_class" required = true -target = " in [ | | ]" +target = " in [ { | | } [ , ... ] , ]" note = "a valid expression" [[obligation]] -id = "db.expressions.function-invocation.o011" +id = "db.expressions.function-invocation.o053" kind = "operand_type_class" required = true -target = " in [ | | ]" +target = " in [ { | | } [ , ... ] , ]" note = "a valid operand" [[obligation]] -id = "db.expressions.function-invocation.o012" +id = "db.expressions.function-invocation.o054" kind = "operand_type_class" required = true -target = " in [ | | ]" +target = " in [ { | | } [ , ... ] , ]" note = "a valid operand" [[obligation]] -id = "db.expressions.function-invocation.o013" +id = "db.expressions.function-invocation.o024" kind = "option_present" required = true -target = "[ , ... ]" +target = "[ , ... ] #2" note = "the list continued at least once" [[obligation]] -id = "db.expressions.function-invocation.o014" -kind = "option_absent" -required = true -target = "[ , ... ]" - -[[obligation]] -id = "db.expressions.function-invocation.o015" -kind = "option_present" -required = true -target = "[ => { | } [ , ... ] ]" - -[[obligation]] -id = "db.expressions.function-invocation.o016" +id = "db.expressions.function-invocation.o025" kind = "option_absent" required = true -target = "[ => { | } [ , ... ] ]" +target = "[ , ... ] #2" [[obligation]] -id = "db.expressions.function-invocation.o017" +id = "db.expressions.function-invocation.o055" kind = "required_operand_missing" required = true -target = " in [ => { | } [ , ... ] ]" +target = "" note = "omit " [[obligation]] -id = "db.expressions.function-invocation.o018" +id = "db.expressions.function-invocation.o056" kind = "operand_type_class" required = true -target = " in [ => { | } [ , ... ] ]" +target = "" note = "a valid identifier" [[obligation]] -id = "db.expressions.function-invocation.o019" +id = "db.expressions.function-invocation.o057" kind = "negative_neighbour" required = true -target = " in [ => { | } [ , ... ] ]" +target = "" note = "a string literal in place of " [[obligation]] @@ -1377,49 +1264,43 @@ required = true target = "{ | } → " [[obligation]] -id = "db.expressions.function-invocation.o022" +id = "db.expressions.function-invocation.o058" kind = "operand_type_class" required = true -target = " in [ => { | } [ , ... ] ]" +target = "" note = "a valid expression" [[obligation]] -id = "db.expressions.function-invocation.o023" +id = "db.expressions.function-invocation.o059" kind = "operand_type_class" required = true -target = " in [ => { | } [ , ... ] ]" +target = "" note = "a valid operand" [[obligation]] -id = "db.expressions.function-invocation.o024" +id = "db.expressions.function-invocation.o060" kind = "option_present" required = true -target = "[ , ... ] #2" +target = "[ , ... ] #3" note = "the list continued at least once" [[obligation]] -id = "db.expressions.function-invocation.o025" +id = "db.expressions.function-invocation.o061" kind = "option_absent" required = true -target = "[ , ... ] #2" - -[[obligation]] -id = "db.expressions.function-invocation.o026" -kind = "negative_neighbour" -required = true -note = "the form without its required (" +target = "[ , ... ] #3" [[obligation]] -id = "db.expressions.function-invocation.o027" +id = "db.expressions.function-invocation.o028" kind = "negative_neighbour" required = true -note = "the form without its required { | } in [ => { | } [ , ... ] ]" +note = "the form without its required )" [[obligation]] -id = "db.expressions.function-invocation.o028" +id = "db.expressions.function-invocation.o062" kind = "negative_neighbour" required = true -note = "the form without its required )" +note = "the form without its required { | }" [[obligation]] id = "db.expressions.function-invocation.o029" @@ -1490,12 +1371,34 @@ kind = "negative_neighbour" required = true note = "the form without its required (" +[[obligation]] +id = "db.expressions.geography-type.o008" +kind = "negative_neighbour" +required = true +note = "the form without its required { | ANY }" + [[obligation]] id = "db.expressions.geography-type.o007" kind = "negative_neighbour" required = true note = "the form without its required )" +[[obligation]] +id = "db.expressions.geography-type.o009" +kind = "required_operand_missing" +required = true +target = "" +anchor = "doc.data-types.geography-type / Syntax" +note = "the type without its srid, recorded to compare with the ( ANY ) spelling" + +[[obligation]] +id = "db.expressions.geography-type.o010" +kind = "operand_type_class" +required = true +target = "" +anchor = "doc.data-types.geography-type / Syntax" +note = "a string where the page documents an integer srid" + [[obligation]] id = "db.expressions.geometry-type.o001" kind = "positive" @@ -1527,12 +1430,34 @@ kind = "negative_neighbour" required = true note = "the form without its required (" +[[obligation]] +id = "db.expressions.geometry-type.o008" +kind = "negative_neighbour" +required = true +note = "the form without its required { | ANY }" + [[obligation]] id = "db.expressions.geometry-type.o007" kind = "negative_neighbour" required = true note = "the form without its required )" +[[obligation]] +id = "db.expressions.geometry-type.o009" +kind = "required_operand_missing" +required = true +target = "" +anchor = "doc.data-types.geometry-type / Syntax" +note = "the type without its srid, recorded to compare with the ( ANY ) spelling" + +[[obligation]] +id = "db.expressions.geometry-type.o010" +kind = "operand_type_class" +required = true +target = "" +anchor = "doc.data-types.geometry-type / Syntax" +note = "a string where the page documents an integer srid" + [[obligation]] id = "db.expressions.identifiers.subscript-dot.o001" kind = "positive" @@ -1571,6 +1496,14 @@ required = true target = "" note = "a valid operand" +[[obligation]] +id = "db.expressions.identifiers.subscript-dot.o007" +kind = "alternative" +required = true +target = "'_'" +anchor = "doc.sql-ref-identifiers / Syntax" +note = "an identifier containing an underscore, the character the page lists" + [[obligation]] id = "db.expressions.identifiers.subscript-dot.syntax.o001" kind = "positive" @@ -1603,41 +1536,27 @@ required = true target = "{ INT | INTEGER } → INTEGER" [[obligation]] -id = "db.expressions.int-type.subscript-dot.o001" +id = "db.expressions.int-type.subscript-dot.o007" kind = "positive" required = true -note = "the documented form with every required part and no optional part" - -[[obligation]] -id = "db.expressions.int-type.subscript-dot.o002" -kind = "option_present" -required = true -target = "[ + | - ]" - -[[obligation]] -id = "db.expressions.int-type.subscript-dot.o003" -kind = "option_absent" -required = true -target = "[ + | - ]" +anchor = "doc.data-types.int-type / Literals" +note = "digits" [[obligation]] -id = "db.expressions.int-type.subscript-dot.o004" +id = "db.expressions.int-type.subscript-dot.o008" kind = "alternative" required = true target = "[ + | - ] → +" +anchor = "doc.data-types.int-type / Literals" +note = "a plus sign before the literal" [[obligation]] -id = "db.expressions.int-type.subscript-dot.o005" +id = "db.expressions.int-type.subscript-dot.o009" kind = "alternative" required = true target = "[ + | - ] → -" - -[[obligation]] -id = "db.expressions.int-type.subscript-dot.o006" -kind = "operand_type_class" -required = true -target = "" -note = "a valid operand" +anchor = "doc.data-types.int-type / Literals" +note = "a minus sign before the literal" [[obligation]] id = "db.expressions.interval-type.o001" @@ -1701,6 +1620,13 @@ kind = "alternative" required = true target = "[ + | - ] → -" +[[obligation]] +id = "db.expressions.interval-type.interval.o010" +kind = "required_operand_missing" +required = true +target = "" +note = "omit " + [[obligation]] id = "db.expressions.interval-type.interval.o006" kind = "operand_type_class" @@ -1759,6 +1685,13 @@ kind = "alternative" required = true target = "[ + | - ] → -" +[[obligation]] +id = "db.expressions.interval-type.interval.literals.o010" +kind = "required_operand_missing" +required = true +target = "" +note = "omit " + [[obligation]] id = "db.expressions.interval-type.interval.literals.o006" kind = "operand_type_class" @@ -1793,12 +1726,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.expressions.json-path-expression.o002" -kind = "alternative" -required = true -target = "{ { | [ ] | [ * ] | [ ] } [ .… → { | [ ] | [ * ] | [ ] } [ . | [ ] | [ * ] | [ ] ] [ ... ]" - [[obligation]] id = "db.expressions.json-path-expression.o003" kind = "alternative" @@ -1831,160 +1758,123 @@ target = "" note = "a valid identifier" [[obligation]] -id = "db.expressions.json-path-expression.o009" -kind = "option_present" +id = "db.expressions.json-path-expression.o037" +kind = "negative_neighbour" required = true -target = "[ ]" +target = "" +note = "a string literal in place of " [[obligation]] -id = "db.expressions.json-path-expression.o010" -kind = "option_absent" +id = "db.expressions.json-path-expression.o038" +kind = "required_operand_missing" required = true -target = "[ ]" +target = "" +note = "omit " [[obligation]] -id = "db.expressions.json-path-expression.o011" +id = "db.expressions.json-path-expression.o039" kind = "operand_type_class" required = true -target = " in [ ]" +target = "" note = "a valid operand" [[obligation]] -id = "db.expressions.json-path-expression.o012" -kind = "option_present" -required = true -target = "[ * ]" - -[[obligation]] -id = "db.expressions.json-path-expression.o013" -kind = "option_absent" -required = true -target = "[ * ]" - -[[obligation]] -id = "db.expressions.json-path-expression.o014" -kind = "option_present" -required = true -target = "[ ]" - -[[obligation]] -id = "db.expressions.json-path-expression.o015" -kind = "option_absent" +id = "db.expressions.json-path-expression.o040" +kind = "required_operand_missing" required = true -target = "[ ]" +target = "" +note = "omit " [[obligation]] -id = "db.expressions.json-path-expression.o016" +id = "db.expressions.json-path-expression.o041" kind = "operand_type_class" required = true -target = " in [ ]" +target = "" note = "a valid operand" [[obligation]] -id = "db.expressions.json-path-expression.o017" +id = "db.expressions.json-path-expression.o042" kind = "option_present" required = true -target = "[ . | [ ] | [ * ] | [ ] ]" +target = "[ { . | [ ] | [ * ] | [ ] } [ ... ] ]" [[obligation]] -id = "db.expressions.json-path-expression.o018" +id = "db.expressions.json-path-expression.o043" kind = "option_absent" required = true -target = "[ . | [ ] | [ * ] | [ ] ]" +target = "[ { . | [ ] | [ * ] | [ ] } [ ... ] ]" [[obligation]] -id = "db.expressions.json-path-expression.o019" +id = "db.expressions.json-path-expression.o044" kind = "alternative" required = true -target = "[ . | [ ] | [ * ] | [ ] ] → . " +target = "{ . | [ ] | [ * ] | [ ] } → . " [[obligation]] -id = "db.expressions.json-path-expression.o020" +id = "db.expressions.json-path-expression.o045" kind = "alternative" required = true -target = "[ . | [ ] | [ * ] | [ ] ] → [ ]" +target = "{ . | [ ] | [ * ] | [ ] } → [ ]" [[obligation]] -id = "db.expressions.json-path-expression.o021" +id = "db.expressions.json-path-expression.o046" kind = "alternative" required = true -target = "[ . | [ ] | [ * ] | [ ] ] → [ * ]" +target = "{ . | [ ] | [ * ] | [ ] } → [ * ]" [[obligation]] -id = "db.expressions.json-path-expression.o022" +id = "db.expressions.json-path-expression.o047" kind = "alternative" required = true -target = "[ . | [ ] | [ * ] | [ ] ] → [ ]" +target = "{ . | [ ] | [ * ] | [ ] } → [ ]" [[obligation]] -id = "db.expressions.json-path-expression.o023" +id = "db.expressions.json-path-expression.o048" kind = "required_operand_missing" required = true -target = " in [ . | [ ] | [ * ] | [ ] ]" +target = " in [ { . | [ ] | [ * ] | [ ] } [ ... ] ]" note = "omit " [[obligation]] -id = "db.expressions.json-path-expression.o024" +id = "db.expressions.json-path-expression.o049" kind = "operand_type_class" required = true -target = " in [ . | [ ] | [ * ] | [ ] ]" +target = " in [ { . | [ ] | [ * ] | [ ] } [ ... ] ]" note = "a valid identifier" [[obligation]] -id = "db.expressions.json-path-expression.o025" +id = "db.expressions.json-path-expression.o050" kind = "negative_neighbour" required = true -target = " in [ . | [ ] | [ * ] | [ ] ]" +target = " in [ { . | [ ] | [ * ] | [ ] } [ ... ] ]" note = "a string literal in place of " [[obligation]] -id = "db.expressions.json-path-expression.o026" -kind = "option_present" -required = true -target = "[ ] #2" - -[[obligation]] -id = "db.expressions.json-path-expression.o027" -kind = "option_absent" +id = "db.expressions.json-path-expression.o051" +kind = "required_operand_missing" required = true -target = "[ ] #2" +target = " in [ { . | [ ] | [ * ] | [ ] } [ ... ] ]" +note = "omit " [[obligation]] -id = "db.expressions.json-path-expression.o028" +id = "db.expressions.json-path-expression.o052" kind = "operand_type_class" required = true -target = " in [ ] #2" +target = " in [ { . | [ ] | [ * ] | [ ] } [ ... ] ]" note = "a valid operand" [[obligation]] -id = "db.expressions.json-path-expression.o029" -kind = "option_present" -required = true -target = "[ * ] #2" - -[[obligation]] -id = "db.expressions.json-path-expression.o030" -kind = "option_absent" -required = true -target = "[ * ] #2" - -[[obligation]] -id = "db.expressions.json-path-expression.o031" -kind = "option_present" -required = true -target = "[ ] #2" - -[[obligation]] -id = "db.expressions.json-path-expression.o032" -kind = "option_absent" +id = "db.expressions.json-path-expression.o053" +kind = "required_operand_missing" required = true -target = "[ ] #2" +target = " in [ { . | [ ] | [ * ] | [ ] } [ ... ] ]" +note = "omit " [[obligation]] -id = "db.expressions.json-path-expression.o033" +id = "db.expressions.json-path-expression.o054" kind = "operand_type_class" required = true -target = " in [ ] #2" +target = " in [ { . | [ ] | [ * ] | [ ] } [ ... ] ]" note = "a valid operand" [[obligation]] @@ -2010,16 +1900,16 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.expressions.lambda-functions.o002" +id = "db.expressions.lambda-functions.o016" kind = "alternative" required = true -target = "{ -> | ( [ , ... ] ) -> } → -> " +target = "{ -> | ( , [ , ... ] ) -> } → -> " [[obligation]] -id = "db.expressions.lambda-functions.o003" +id = "db.expressions.lambda-functions.o017" kind = "alternative" required = true -target = "{ -> | ( [ , ... ] ) -> } → ( [ , ... ] ) -> " +target = "{ -> | ( , [ , ... ] ) -> } → ( , [ , ... ] ) -> " [[obligation]] id = "db.expressions.lambda-functions.o004" @@ -2063,6 +1953,13 @@ required = true target = "" note = "a valid operand" +[[obligation]] +id = "db.expressions.lambda-functions.o018" +kind = "operand_type_class" +required = true +target = "" +note = "a valid operand" + [[obligation]] id = "db.expressions.lambda-functions.o010" kind = "option_present" @@ -2090,6 +1987,12 @@ required = true target = " #2" note = "a valid expression" +[[obligation]] +id = "db.expressions.lambda-functions.o019" +kind = "negative_neighbour" +required = true +note = "the form without its required ->" + [[obligation]] id = "db.expressions.lambda-functions.o014" kind = "negative_neighbour" @@ -2102,6 +2005,14 @@ kind = "negative_neighbour" required = true note = "the form without its required -> after )" +[[obligation]] +id = "db.expressions.lambda-functions.o020" +kind = "alternative" +required = true +target = "( ) -> " +anchor = "doc.sql-ref-lambda-functions / Syntax" +note = "one parameter in parentheses, as the page's line allows, which the warehouse refuses" + [[obligation]] id = "db.expressions.map-type.o001" kind = "positive" @@ -2258,6 +2169,20 @@ required = true target = " in [ . ]" note = "a valid identifier" +[[obligation]] +id = "db.expressions.names.identifier.o025" +kind = "negative_neighbour" +required = true +target = " in [ . ]" +note = "a string literal in place of " + +[[obligation]] +id = "db.expressions.names.identifier.o023" +kind = "required_operand_missing" +required = true +target = "" +note = "omit " + [[obligation]] id = "db.expressions.names.identifier.o009" kind = "operand_type_class" @@ -2266,18 +2191,24 @@ target = "" note = "a valid identifier" [[obligation]] -id = "db.expressions.names.identifier.o012" +id = "db.expressions.names.identifier.o026" +kind = "negative_neighbour" +required = true +target = "" +note = "a string literal in place of " + +[[obligation]] +id = "db.expressions.names.identifier.o024" kind = "operand_type_class" required = true target = "" -note = "a valid identifier" +note = "a valid operand" [[obligation]] -id = "db.expressions.names.identifier.o013" +id = "db.expressions.names.identifier.o027" kind = "negative_neighbour" required = true -target = "" -note = "a string literal in place of " +note = "the form without its required IDENTIFIER after " [[obligation]] id = "db.expressions.names.identifier.o014" @@ -2311,22 +2242,6 @@ target = "" anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" -[[obligation]] -id = "db.expressions.names.identifier.o018" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "quoted: a double-quoted identifier with blanks and mixed case" - -[[obligation]] -id = "db.expressions.names.identifier.o022" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" - [[obligation]] id = "db.expressions.names.identifier-2.o001" kind = "positive" @@ -2371,6 +2286,13 @@ required = true target = " in [ . ]" note = "a valid identifier" +[[obligation]] +id = "db.expressions.names.identifier-2.o025" +kind = "negative_neighbour" +required = true +target = " in [ . ]" +note = "a string literal in place of " + [[obligation]] id = "db.expressions.names.identifier-2.o009" kind = "operand_type_class" @@ -2379,18 +2301,24 @@ target = "" note = "a valid identifier" [[obligation]] -id = "db.expressions.names.identifier-2.o012" +id = "db.expressions.names.identifier-2.o026" +kind = "negative_neighbour" +required = true +target = "" +note = "a string literal in place of " + +[[obligation]] +id = "db.expressions.names.identifier-2.o024" kind = "operand_type_class" required = true target = "" -note = "a valid identifier" +note = "a valid operand" [[obligation]] -id = "db.expressions.names.identifier-2.o013" +id = "db.expressions.names.identifier-2.o027" kind = "negative_neighbour" required = true -target = "" -note = "a string literal in place of " +note = "the form without its required IDENTIFIER after " [[obligation]] id = "db.expressions.names.identifier-2.o014" @@ -2412,34 +2340,26 @@ note = "keyword: the SQL keyword SELECT, which the reserved-words page does not id = "db.expressions.names.identifier-2.o016" kind = "identifier_class" required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "quoted: a double-quoted identifier with blanks and mixed case" - -[[obligation]] -id = "db.expressions.names.identifier-2.o021" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" - -[[obligation]] -id = "db.expressions.names.identifier-2.o018" -kind = "identifier_class" -required = true -target = "" +target = "" anchor = "doc.identifiers-syntax" note = "quoted: a double-quoted identifier with blanks and mixed case" [[obligation]] -id = "db.expressions.names.identifier-2.o022" +id = "db.expressions.names.identifier-2.o021" kind = "identifier_class" required = true -target = "" +target = "" anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" +[[obligation]] +id = "db.expressions.names.identifier-2.o028" +kind = "required_operand_missing" +required = true +target = "" +anchor = "doc.sql-ref-names / Syntax" +note = "omit ; the warehouse parses the text, so its answer is recorded rather than expected" + [[obligation]] id = "db.expressions.names.identifier-3.o001" kind = "positive" @@ -2485,25 +2405,25 @@ target = " in [ . ]" note = "a valid identifier" [[obligation]] -id = "db.expressions.names.identifier-3.o009" -kind = "operand_type_class" +id = "db.expressions.names.identifier-3.o023" +kind = "required_operand_missing" required = true target = "" -note = "a valid identifier" +note = "omit " [[obligation]] -id = "db.expressions.names.identifier-3.o012" +id = "db.expressions.names.identifier-3.o009" kind = "operand_type_class" required = true -target = "" +target = "" note = "a valid identifier" [[obligation]] -id = "db.expressions.names.identifier-3.o013" -kind = "negative_neighbour" +id = "db.expressions.names.identifier-3.o024" +kind = "operand_type_class" required = true target = "" -note = "a string literal in place of " +note = "a valid operand" [[obligation]] id = "db.expressions.names.identifier-3.o014" @@ -2537,22 +2457,6 @@ target = "" anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" -[[obligation]] -id = "db.expressions.names.identifier-3.o018" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "quoted: a double-quoted identifier with blanks and mixed case" - -[[obligation]] -id = "db.expressions.names.identifier-3.o022" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" - [[obligation]] id = "db.expressions.names.identifier-4.o001" kind = "positive" @@ -2560,16 +2464,16 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.expressions.names.identifier-4.o002" +id = "db.expressions.names.identifier-4.o021" kind = "alternative" required = true -target = "{ { . [ . ... ] } | IDENTIFIER… → { . [ . ... ] }" +target = "{ . [ . ... ] |… → . [ . ... ]" [[obligation]] -id = "db.expressions.names.identifier-4.o003" +id = "db.expressions.names.identifier-4.o022" kind = "alternative" required = true -target = "{ { . [ . ... ] } | IDENTIFIER } → IDENTIFIER " +target = "{ . [ . ... ] | IDENTIFIER… → IDENTIFIER " [[obligation]] id = "db.expressions.names.identifier-4.o004" @@ -2585,12 +2489,6 @@ required = true target = "" note = "a valid expression" -[[obligation]] -id = "db.expressions.names.identifier-4.o006" -kind = "alternative" -required = true -target = "{ . [ . ... ] } → . [ . ... ]" - [[obligation]] id = "db.expressions.names.identifier-4.o007" kind = "required_operand_missing" @@ -2613,31 +2511,24 @@ target = "" note = "a string literal in place of " [[obligation]] -id = "db.expressions.names.identifier-4.o010" +id = "db.expressions.names.identifier-4.o023" kind = "option_present" required = true -target = "[ . ... ]" +target = "[ . ... ]" note = "the list continued at least once" [[obligation]] -id = "db.expressions.names.identifier-4.o011" +id = "db.expressions.names.identifier-4.o024" kind = "option_absent" required = true -target = "[ . ... ]" +target = "[ . ... ]" [[obligation]] -id = "db.expressions.names.identifier-4.o013" +id = "db.expressions.names.identifier-4.o025" kind = "operand_type_class" required = true target = "" -note = "a valid identifier" - -[[obligation]] -id = "db.expressions.names.identifier-4.o014" -kind = "negative_neighbour" -required = true -target = "" -note = "a string literal in place of " +note = "a valid operand" [[obligation]] id = "db.expressions.names.identifier-4.o015" @@ -2655,22 +2546,6 @@ target = "" anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" -[[obligation]] -id = "db.expressions.names.identifier-4.o017" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "quoted: a double-quoted identifier with blanks and mixed case" - -[[obligation]] -id = "db.expressions.names.identifier-4.o020" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" - [[obligation]] id = "db.expressions.names.identifier-5.o001" kind = "positive" @@ -2716,25 +2591,25 @@ target = " in [ . ]" note = "a valid identifier" [[obligation]] -id = "db.expressions.names.identifier-5.o009" -kind = "operand_type_class" +id = "db.expressions.names.identifier-5.o023" +kind = "required_operand_missing" required = true target = "" -note = "a valid identifier" +note = "omit " [[obligation]] -id = "db.expressions.names.identifier-5.o012" +id = "db.expressions.names.identifier-5.o009" kind = "operand_type_class" required = true -target = "" +target = "" note = "a valid identifier" [[obligation]] -id = "db.expressions.names.identifier-5.o013" -kind = "negative_neighbour" +id = "db.expressions.names.identifier-5.o024" +kind = "operand_type_class" required = true target = "" -note = "a string literal in place of " +note = "a valid operand" [[obligation]] id = "db.expressions.names.identifier-5.o014" @@ -2768,22 +2643,6 @@ target = "" anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" -[[obligation]] -id = "db.expressions.names.identifier-5.o018" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "quoted: a double-quoted identifier with blanks and mixed case" - -[[obligation]] -id = "db.expressions.names.identifier-5.o022" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" - [[obligation]] id = "db.expressions.names.identifier-6.o001" kind = "positive" @@ -2828,6 +2687,20 @@ required = true target = " in [ . ]" note = "a valid identifier" +[[obligation]] +id = "db.expressions.names.identifier-6.o025" +kind = "negative_neighbour" +required = true +target = " in [ . ]" +note = "a string literal in place of " + +[[obligation]] +id = "db.expressions.names.identifier-6.o023" +kind = "required_operand_missing" +required = true +target = "" +note = "omit " + [[obligation]] id = "db.expressions.names.identifier-6.o009" kind = "operand_type_class" @@ -2836,18 +2709,24 @@ target = "" note = "a valid identifier" [[obligation]] -id = "db.expressions.names.identifier-6.o012" +id = "db.expressions.names.identifier-6.o026" +kind = "negative_neighbour" +required = true +target = "" +note = "a string literal in place of " + +[[obligation]] +id = "db.expressions.names.identifier-6.o024" kind = "operand_type_class" required = true target = "" -note = "a valid identifier" +note = "a valid operand" [[obligation]] -id = "db.expressions.names.identifier-6.o013" +id = "db.expressions.names.identifier-6.o027" kind = "negative_neighbour" required = true -target = "" -note = "a string literal in place of " +note = "the form without its required IDENTIFIER after " [[obligation]] id = "db.expressions.names.identifier-6.o014" @@ -2881,22 +2760,6 @@ target = "" anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" -[[obligation]] -id = "db.expressions.names.identifier-6.o018" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "quoted: a double-quoted identifier with blanks and mixed case" - -[[obligation]] -id = "db.expressions.names.identifier-6.o022" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" - [[obligation]] id = "db.expressions.names.identifier-7.o001" kind = "positive" @@ -2941,6 +2804,20 @@ required = true target = " in [ . ]" note = "a valid identifier" +[[obligation]] +id = "db.expressions.names.identifier-7.o025" +kind = "negative_neighbour" +required = true +target = " in [ . ]" +note = "a string literal in place of " + +[[obligation]] +id = "db.expressions.names.identifier-7.o023" +kind = "required_operand_missing" +required = true +target = "" +note = "omit " + [[obligation]] id = "db.expressions.names.identifier-7.o009" kind = "operand_type_class" @@ -2949,18 +2826,24 @@ target = "" note = "a valid identifier" [[obligation]] -id = "db.expressions.names.identifier-7.o012" +id = "db.expressions.names.identifier-7.o026" +kind = "negative_neighbour" +required = true +target = "" +note = "a string literal in place of " + +[[obligation]] +id = "db.expressions.names.identifier-7.o024" kind = "operand_type_class" required = true target = "" -note = "a valid identifier" +note = "a valid operand" [[obligation]] -id = "db.expressions.names.identifier-7.o013" +id = "db.expressions.names.identifier-7.o027" kind = "negative_neighbour" required = true -target = "" -note = "a string literal in place of " +note = "the form without its required IDENTIFIER after " [[obligation]] id = "db.expressions.names.identifier-7.o014" @@ -2994,22 +2877,6 @@ target = "" anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" -[[obligation]] -id = "db.expressions.names.identifier-7.o018" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "quoted: a double-quoted identifier with blanks and mixed case" - -[[obligation]] -id = "db.expressions.names.identifier-7.o022" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" - [[obligation]] id = "db.expressions.names.identifier-8.o001" kind = "positive" @@ -3036,18 +2903,24 @@ target = "" note = "a valid identifier" [[obligation]] -id = "db.expressions.names.identifier-8.o007" +id = "db.expressions.names.identifier-8.o016" +kind = "negative_neighbour" +required = true +target = "" +note = "a string literal in place of " + +[[obligation]] +id = "db.expressions.names.identifier-8.o015" kind = "operand_type_class" required = true target = "" -note = "a valid identifier" +note = "a valid operand" [[obligation]] -id = "db.expressions.names.identifier-8.o008" +id = "db.expressions.names.identifier-8.o017" kind = "negative_neighbour" required = true -target = "" -note = "a string literal in place of " +note = "the form without its required IDENTIFIER after " [[obligation]] id = "db.expressions.names.identifier-8.o009" @@ -3065,22 +2938,6 @@ target = "" anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" -[[obligation]] -id = "db.expressions.names.identifier-8.o011" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "quoted: a double-quoted identifier with blanks and mixed case" - -[[obligation]] -id = "db.expressions.names.identifier-8.o014" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" - [[obligation]] id = "db.expressions.names.identifier.syntax.o001" kind = "positive" @@ -3088,22 +2945,22 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.expressions.names.identifier.syntax.o002" +id = "db.expressions.names.identifier.syntax.o038" kind = "alternative" required = true -target = "{ [ . ] | IDENTIFIER | {… → [ . ] " +target = "{ [ . ] | IDENTIFIER |… → [ . ] " [[obligation]] -id = "db.expressions.names.identifier.syntax.o003" +id = "db.expressions.names.identifier.syntax.o039" kind = "alternative" required = true -target = "{ [ . ] | IDENTIFIER | {… → IDENTIFIER " +target = "{ [ . ] | IDENTIFIER |… → IDENTIFIER " [[obligation]] -id = "db.expressions.names.identifier.syntax.o004" +id = "db.expressions.names.identifier.syntax.o040" kind = "alternative" required = true -target = "{ [ . ] | IDENTIFIER… → { | ` ` } . ` `" +target = "{ [ . ] | IDENTIFIER |… → . " [[obligation]] id = "db.expressions.names.identifier.syntax.o005" @@ -3132,37 +2989,39 @@ target = " in [ . ]" note = "a valid identifier" [[obligation]] -id = "db.expressions.names.identifier.syntax.o010" -kind = "operand_type_class" +id = "db.expressions.names.identifier.syntax.o041" +kind = "negative_neighbour" required = true -target = "" -note = "a valid identifier" +target = " in [ . ]" +note = "a string literal in place of " [[obligation]] -id = "db.expressions.names.identifier.syntax.o013" +id = "db.expressions.names.identifier.syntax.o010" kind = "operand_type_class" required = true -target = "" +target = "" note = "a valid identifier" [[obligation]] -id = "db.expressions.names.identifier.syntax.o014" +id = "db.expressions.names.identifier.syntax.o043" kind = "negative_neighbour" required = true -target = "" -note = "a string literal in place of " +target = "" +note = "a string literal in place of " [[obligation]] -id = "db.expressions.names.identifier.syntax.o015" -kind = "alternative" +id = "db.expressions.names.identifier.syntax.o044" +kind = "operand_type_class" required = true -target = "{ | ` ` } → " +target = "" +note = "a valid operand" [[obligation]] -id = "db.expressions.names.identifier.syntax.o016" -kind = "alternative" +id = "db.expressions.names.identifier.syntax.o045" +kind = "required_operand_missing" required = true -target = "{ | ` ` } → ` `" +target = "" +note = "omit " [[obligation]] id = "db.expressions.names.identifier.syntax.o017" @@ -3172,11 +3031,11 @@ target = "" note = "a valid operand" [[obligation]] -id = "db.expressions.names.identifier.syntax.o019" -kind = "operand_type_class" +id = "db.expressions.names.identifier.syntax.o046" +kind = "required_operand_missing" required = true -target = " #2" -note = "a valid operand" +target = "" +note = "omit " [[obligation]] id = "db.expressions.names.identifier.syntax.o021" @@ -3223,6 +3082,12 @@ required = true target = " in [ ]" note = "a valid operand" +[[obligation]] +id = "db.expressions.names.identifier.syntax.o047" +kind = "negative_neighbour" +required = true +note = "the form without its required IDENTIFIER after " + [[obligation]] id = "db.expressions.names.identifier.syntax.o028" kind = "interaction_all_options" @@ -3262,20 +3127,20 @@ anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" [[obligation]] -id = "db.expressions.names.identifier.syntax.o033" -kind = "identifier_class" +id = "db.expressions.names.identifier.syntax.o048" +kind = "alternative" required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "quoted: a double-quoted identifier with blanks and mixed case" +target = "` ` . ` `" +anchor = "doc.sql-ref-names / Table name" +note = "a back-quoted file format before a back-quoted path, as the page's example `csv`.`spreadsheets/data.csv` writes it" [[obligation]] -id = "db.expressions.names.identifier.syntax.o037" -kind = "identifier_class" +id = "db.expressions.names.identifier.syntax.o049" +kind = "required_operand_missing" required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" +target = "" +anchor = "doc.sql-ref-names / Syntax" +note = "omit ; the warehouse parses the text, so its answer is recorded rather than expected" [[obligation]] id = "db.expressions.names.subscript.o001" @@ -3302,6 +3167,13 @@ required = true target = "" note = "a valid identifier" +[[obligation]] +id = "db.expressions.names.subscript.o009" +kind = "negative_neighbour" +required = true +target = "" +note = "a string literal in place of " + [[obligation]] id = "db.expressions.names.subscript.o006" kind = "identifier_class" @@ -3350,6 +3222,13 @@ required = true target = " in [ . ]" note = "a valid identifier" +[[obligation]] +id = "db.expressions.names.subscript-dot.o015" +kind = "required_operand_missing" +required = true +target = "" +note = "omit " + [[obligation]] id = "db.expressions.names.subscript-dot.o007" kind = "operand_type_class" @@ -3414,6 +3293,13 @@ required = true target = "" note = "a valid identifier" +[[obligation]] +id = "db.expressions.names.subscript-dot-2.o021" +kind = "negative_neighbour" +required = true +target = "" +note = "a string literal in place of " + [[obligation]] id = "db.expressions.names.subscript-dot-2.o006" kind = "option_present" @@ -3426,6 +3312,13 @@ kind = "option_absent" required = true target = "[ ( [ , ... ] ) ]" +[[obligation]] +id = "db.expressions.names.subscript-dot-2.o022" +kind = "required_operand_missing" +required = true +target = " in [ ( [ , ... ] ) ]" +note = "omit " + [[obligation]] id = "db.expressions.names.subscript-dot-2.o009" kind = "operand_type_class" @@ -3433,6 +3326,13 @@ required = true target = " in [ ( [ , ... ] ) ]" note = "a valid identifier" +[[obligation]] +id = "db.expressions.names.subscript-dot-2.o023" +kind = "negative_neighbour" +required = true +target = " in [ ( [ , ... ] ) ]" +note = "a string literal in place of " + [[obligation]] id = "db.expressions.names.subscript-dot-2.o011" kind = "option_present" @@ -3522,6 +3422,13 @@ required = true target = "" note = "a valid identifier" +[[obligation]] +id = "db.expressions.names.subscript-dot-3.o015" +kind = "negative_neighbour" +required = true +target = "" +note = "a string literal in place of " + [[obligation]] id = "db.expressions.names.subscript-dot-3.o007" kind = "option_present" @@ -3535,12 +3442,6 @@ kind = "option_absent" required = true target = "[ , ... ]" -[[obligation]] -id = "db.expressions.names.subscript-dot-3.o009" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.expressions.names.subscript-dot-3.o010" kind = "negative_neighbour" @@ -3588,25 +3489,32 @@ required = true target = "[ . ]" [[obligation]] -id = "db.expressions.names.subscript-dot-4.o004" -kind = "required_operand_missing" +id = "db.expressions.names.subscript-dot-4.o005" +kind = "operand_type_class" required = true target = " in [ . ]" -note = "omit " +note = "a valid identifier" [[obligation]] -id = "db.expressions.names.subscript-dot-4.o005" -kind = "operand_type_class" +id = "db.expressions.names.subscript-dot-4.o016" +kind = "negative_neighbour" required = true target = " in [ . ]" -note = "a valid identifier" +note = "a string literal in place of " [[obligation]] id = "db.expressions.names.subscript-dot-4.o007" kind = "operand_type_class" required = true target = "" -note = "a valid identifier" +note = "a valid identifier" + +[[obligation]] +id = "db.expressions.names.subscript-dot-4.o017" +kind = "negative_neighbour" +required = true +target = "" +note = "a string literal in place of " [[obligation]] id = "db.expressions.names.subscript-dot-4.o009" @@ -3646,6 +3554,13 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" +[[obligation]] +id = "db.expressions.names.subscript-dot.syntax.o012" +kind = "required_operand_missing" +required = true +target = "" +note = "omit " + [[obligation]] id = "db.expressions.names.subscript-dot.syntax.o002" kind = "operand_type_class" @@ -3653,6 +3568,13 @@ required = true target = "" note = "a valid identifier" +[[obligation]] +id = "db.expressions.names.subscript-dot.syntax.o013" +kind = "negative_neighbour" +required = true +target = "" +note = "a string literal in place of " + [[obligation]] id = "db.expressions.names.subscript-dot.syntax.o004" kind = "option_present" @@ -3727,6 +3649,13 @@ required = true target = "" note = "a valid identifier" +[[obligation]] +id = "db.expressions.names.syntax.o014" +kind = "negative_neighbour" +required = true +target = "" +note = "a string literal in place of " + [[obligation]] id = "db.expressions.names.syntax.o006" kind = "operand_type_class" @@ -3734,6 +3663,13 @@ required = true target = "" note = "a valid identifier" +[[obligation]] +id = "db.expressions.names.syntax.o015" +kind = "negative_neighbour" +required = true +target = "" +note = "a string literal in place of " + [[obligation]] id = "db.expressions.names.syntax.o008" kind = "identifier_class" @@ -3773,123 +3709,51 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.expressions.null-type.o002" -kind = "alternative" -required = true -target = "{ NULL | VOID } → NULL" - -[[obligation]] -id = "db.expressions.null-type.o003" -kind = "alternative" -required = true -target = "{ NULL | VOID } → VOID" - -[[obligation]] -id = "db.expressions.object-type.o001" +id = "db.expressions.null-type.o006" kind = "positive" required = true -note = "the documented form with every required part and no optional part" - -[[obligation]] -id = "db.expressions.object-type.o002" -kind = "option_present" -required = true -target = "[ [ : ] [ , ... ] ]" - -[[obligation]] -id = "db.expressions.object-type.o003" -kind = "option_absent" -required = true -target = "[ [ : ] [ , ... ] ]" - -[[obligation]] -id = "db.expressions.object-type.o004" -kind = "required_operand_missing" -required = true -target = " in [ [ : ] [ , ... ] ]" -note = "omit " +target = "the NULL literal" +anchor = "doc.data-types.null-type / Literals" +note = "NULL written as an expression, the literal the page's Literals section names, not the type" [[obligation]] -id = "db.expressions.object-type.o005" -kind = "operand_type_class" -required = true -target = " in [ [ : ] [ , ... ] ]" -note = "a valid identifier" - -[[obligation]] -id = "db.expressions.object-type.o006" +id = "db.expressions.null-type.o007" kind = "negative_neighbour" required = true -target = " in [ [ : ] [ , ... ] ]" -note = "a string literal in place of " - -[[obligation]] -id = "db.expressions.object-type.o007" -kind = "option_present" -required = true -target = "[ : ]" - -[[obligation]] -id = "db.expressions.object-type.o008" -kind = "option_absent" -required = true -target = "[ : ]" - -[[obligation]] -id = "db.expressions.object-type.o009" -kind = "required_operand_missing" -required = true -target = " in [ [ : ] [ , ... ] ]" -note = "omit " +target = "VOID as an expression" +anchor = "doc.data-types.null-type / Syntax" +note = "VOID written as an expression, which the warehouse parses as a column name, not a value of the type" [[obligation]] -id = "db.expressions.object-type.o010" -kind = "operand_type_class" +id = "db.expressions.null-type.o005" +kind = "alternative" required = true -target = " in [ [ : ] [ , ... ] ]" -note = "a valid data_type" +target = "NULL" +anchor = "doc.data-types.null-type / Syntax" +note = "the NULL spelling in type position" [[obligation]] -id = "db.expressions.object-type.o011" -kind = "negative_neighbour" +id = "db.expressions.object-type.o018" +kind = "positive" required = true -target = " in [ [ : ] [ , ... ] ]" -note = "a string literal in place of " +anchor = "doc.data-types.object-type / Syntax" +note = "an OBJECT with no field, in CAST" [[obligation]] -id = "db.expressions.object-type.o012" +id = "db.expressions.object-type.o019" kind = "option_present" required = true -target = "[ , ... ]" -note = "the list continued at least once" +target = "[ [ : ] [ , ... ] ]" +anchor = "doc.data-types.object-type / Syntax" +note = "an OBJECT with two fields, each name and type separated by a colon, in CAST" [[obligation]] -id = "db.expressions.object-type.o013" +id = "db.expressions.object-type.o020" kind = "option_absent" required = true -target = "[ , ... ]" - -[[obligation]] -id = "db.expressions.object-type.o014" -kind = "interaction_all_options" -required = true -note = "every independent option of one production together" - -[[obligation]] -id = "db.expressions.object-type.o015" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "quoted: a double-quoted identifier with blanks and mixed case" - -[[obligation]] -id = "db.expressions.object-type.o017" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" +target = "[ : ]" +anchor = "doc.data-types.object-type / Syntax" +note = "an OBJECT field without the colon, in CAST" [[obligation]] id = "db.expressions.parameter-marker.colon.o001" @@ -3959,41 +3823,27 @@ required = true target = "{ SMALLINT | SHORT } → SHORT" [[obligation]] -id = "db.expressions.smallint-type.s.o001" +id = "db.expressions.smallint-type.s.o008" kind = "positive" required = true -note = "the documented form with every required part and no optional part" - -[[obligation]] -id = "db.expressions.smallint-type.s.o002" -kind = "option_present" -required = true -target = "[ + | - ]" - -[[obligation]] -id = "db.expressions.smallint-type.s.o003" -kind = "option_absent" -required = true -target = "[ + | - ]" +anchor = "doc.data-types.smallint-type / Literals" +note = "digits with the S postfix" [[obligation]] -id = "db.expressions.smallint-type.s.o004" +id = "db.expressions.smallint-type.s.o009" kind = "alternative" required = true target = "[ + | - ] → +" +anchor = "doc.data-types.smallint-type / Literals" +note = "a plus sign before the literal" [[obligation]] -id = "db.expressions.smallint-type.s.o005" +id = "db.expressions.smallint-type.s.o010" kind = "alternative" required = true target = "[ + | - ] → -" - -[[obligation]] -id = "db.expressions.smallint-type.s.o007" -kind = "operand_type_class" -required = true -target = "" -note = "a valid operand" +anchor = "doc.data-types.smallint-type / Literals" +note = "a minus sign before the literal" [[obligation]] id = "db.expressions.string-type.o001" @@ -4002,41 +3852,35 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.expressions.string-type.subscript-dot.o001" +id = "db.expressions.string-type.subscript-dot.o007" kind = "positive" required = true -note = "the documented form with every required part and no optional part" - -[[obligation]] -id = "db.expressions.string-type.subscript-dot.o002" -kind = "option_present" -required = true -target = "[ | R ]" - -[[obligation]] -id = "db.expressions.string-type.subscript-dot.o003" -kind = "option_absent" -required = true -target = "[ | R ]" +anchor = "doc.data-types.string-type / Literals" +note = "a string literal of the page's characters" [[obligation]] -id = "db.expressions.string-type.subscript-dot.o004" +id = "db.expressions.string-type.subscript-dot.o008" kind = "alternative" required = true -target = "[ | R ] → " +target = "[ r | R ] → r" +anchor = "doc.data-types.string-type / Literals" +note = "a raw literal with the lower-case prefix" [[obligation]] -id = "db.expressions.string-type.subscript-dot.o005" +id = "db.expressions.string-type.subscript-dot.o009" kind = "alternative" required = true -target = "[ | R ] → R" +target = "[ r | R ] → R" +anchor = "doc.data-types.string-type / Literals" +note = "a raw literal with the upper-case prefix" [[obligation]] -id = "db.expressions.string-type.subscript-dot.o006" -kind = "operand_type_class" +id = "db.expressions.string-type.subscript-dot.o010" +kind = "option_present" required = true -target = " in [ | R ]" -note = "a valid operand" +target = "[ ... ] after the literal" +anchor = "doc.data-types.string-type / Chaining literals" +note = "two chained literals; the page's Chaining literals section carries the banner 'Applies to: Databricks Runtime 18.0 and later', which leaves out Databricks SQL, so the text is observed" [[obligation]] id = "db.expressions.struct-type.o001" @@ -4045,36 +3889,36 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.expressions.struct-type.o002" +id = "db.expressions.struct-type.o033" kind = "option_present" required = true -target = "[ [ : ] [ NOT NULL ] [ COLLATE ] [ COMMENT ] [ , ... ] ]" +target = "[ [ : ] [ COLLATE ] [ NOT NULL ] [ COMMENT ] [ , [ : ]…" [[obligation]] -id = "db.expressions.struct-type.o003" +id = "db.expressions.struct-type.o034" kind = "option_absent" required = true -target = "[ [ : ] [ NOT NULL ] [ COLLATE ] [ COMMENT ] [ , ... ] ]" +target = "[ [ : ] [ COLLATE ] [ NOT NULL ] [ COMMENT ] [ , [ : ]…" [[obligation]] -id = "db.expressions.struct-type.o004" +id = "db.expressions.struct-type.o035" kind = "required_operand_missing" required = true -target = " in [ [ : ] [ NOT NULL ] [ COLLATE ] [ COMMENT ] [ , ... ]…" +target = " in [ [ : ] [ COLLATE ] [ NOT NULL ] [ COMMENT ] [ ,…" note = "omit " [[obligation]] -id = "db.expressions.struct-type.o005" +id = "db.expressions.struct-type.o036" kind = "operand_type_class" required = true -target = " in [ [ : ] [ NOT NULL ] [ COLLATE ] [ COMMENT ] [ , ... ]…" +target = " in [ [ : ] [ COLLATE ] [ NOT NULL ] [ COMMENT ] [ ,…" note = "a valid identifier" [[obligation]] -id = "db.expressions.struct-type.o006" +id = "db.expressions.struct-type.o037" kind = "negative_neighbour" required = true -target = " in [ [ : ] [ NOT NULL ] [ COLLATE ] [ COMMENT ] [ , ... ]…" +target = " in [ [ : ] [ COLLATE ] [ NOT NULL ] [ COMMENT ] [ ,…" note = "a string literal in place of " [[obligation]] @@ -4090,38 +3934,26 @@ required = true target = "[ : ]" [[obligation]] -id = "db.expressions.struct-type.o009" +id = "db.expressions.struct-type.o038" kind = "required_operand_missing" required = true -target = " in [ [ : ] [ NOT NULL ] [ COLLATE ] [ COMMENT ] [ , ... ]…" +target = " in [ [ : ] [ COLLATE ] [ NOT NULL ] [ COMMENT ] [ ,…" note = "omit " [[obligation]] -id = "db.expressions.struct-type.o010" +id = "db.expressions.struct-type.o039" kind = "operand_type_class" required = true -target = " in [ [ : ] [ NOT NULL ] [ COLLATE ] [ COMMENT ] [ , ... ]…" +target = " in [ [ : ] [ COLLATE ] [ NOT NULL ] [ COMMENT ] [ ,…" note = "a valid data_type" [[obligation]] -id = "db.expressions.struct-type.o011" +id = "db.expressions.struct-type.o040" kind = "negative_neighbour" required = true -target = " in [ [ : ] [ NOT NULL ] [ COLLATE ] [ COMMENT ] [ , ... ]…" +target = " in [ [ : ] [ COLLATE ] [ NOT NULL ] [ COMMENT ] [ ,…" note = "a string literal in place of " -[[obligation]] -id = "db.expressions.struct-type.o012" -kind = "option_present" -required = true -target = "[ NOT NULL ]" - -[[obligation]] -id = "db.expressions.struct-type.o013" -kind = "option_absent" -required = true -target = "[ NOT NULL ]" - [[obligation]] id = "db.expressions.struct-type.o014" kind = "option_present" @@ -4155,6 +3987,18 @@ required = true target = " in [ COLLATE ]" note = "a string literal in place of " +[[obligation]] +id = "db.expressions.struct-type.o012" +kind = "option_present" +required = true +target = "[ NOT NULL ]" + +[[obligation]] +id = "db.expressions.struct-type.o013" +kind = "option_absent" +required = true +target = "[ NOT NULL ]" + [[obligation]] id = "db.expressions.struct-type.o019" kind = "option_present" @@ -4182,17 +4026,17 @@ target = " in [ COMMENT ]" note = "a valid operand" [[obligation]] -id = "db.expressions.struct-type.o023" +id = "db.expressions.struct-type.o041" kind = "option_present" required = true -target = "[ , ... ]" +target = "[ , [ : ] ... ]" note = "the list continued at least once" [[obligation]] -id = "db.expressions.struct-type.o024" +id = "db.expressions.struct-type.o042" kind = "option_absent" required = true -target = "[ , ... ]" +target = "[ , [ : ] ... ]" [[obligation]] id = "db.expressions.struct-type.o025" @@ -4238,6 +4082,14 @@ target = "" anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" +[[obligation]] +id = "db.expressions.struct-type.o043" +kind = "option_present" +required = true +target = "[ COLLATE ] after [ NOT NULL ]" +anchor = "doc.data-types.struct-type / Syntax" +note = "COLLATE after NOT NULL, as the page's Syntax line orders them, which Spark's grammar does not parse" + [[obligation]] id = "db.expressions.time-type.time.o001" kind = "positive" @@ -4270,6 +4122,13 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" +[[obligation]] +id = "db.expressions.time-type.time.syntax.o006" +kind = "required_operand_missing" +required = true +target = "

" +note = "omit

" + [[obligation]] id = "db.expressions.time-type.time.syntax.o003" kind = "operand_type_class" @@ -4289,6 +4148,14 @@ kind = "negative_neighbour" required = true note = "the form without its required )" +[[obligation]] +id = "db.expressions.time-type.time.syntax.o007" +kind = "operand_type_class" +required = true +target = "

" +anchor = "doc.data-types.time-type / Syntax" +note = "a string where the page documents an integer" + [[obligation]] id = "db.expressions.timestamp-ntz-type.timestamp-ntz.o001" kind = "positive" @@ -4307,6 +4174,13 @@ kind = "option_absent" required = true target = "[ (

) ]" +[[obligation]] +id = "db.expressions.timestamp-ntz-type.timestamp-ntz.o007" +kind = "required_operand_missing" +required = true +target = "

in [ (

) ]" +note = "omit

" + [[obligation]] id = "db.expressions.timestamp-ntz-type.timestamp-ntz.o005" kind = "operand_type_class" @@ -4320,6 +4194,14 @@ kind = "negative_neighbour" required = true note = "the form without its required ) in [ (

) ]" +[[obligation]] +id = "db.expressions.timestamp-ntz-type.timestamp-ntz.o008" +kind = "operand_type_class" +required = true +target = "

" +anchor = "doc.data-types.timestamp-ntz-type / Syntax" +note = "a string where the page documents an integer" + [[obligation]] id = "db.expressions.timestamp-ntz-type.timestamp-ntz.literals.o001" kind = "positive" @@ -4341,60 +4223,19 @@ target = "" note = "an unquoted identifier in place of " [[obligation]] -id = "db.expressions.timestamp-ntz-type.timestamp-without-time-zone.o001" +id = "db.expressions.timestamp-ntz-type.timestamp-without-time-zone.o010" kind = "positive" required = true -note = "the documented form with every required part and no optional part" +anchor = "doc.data-types.timestamp-ntz-type / Syntax" +note = "TIMESTAMP WITHOUT TIME ZONE in CAST" [[obligation]] -id = "db.expressions.timestamp-ntz-type.timestamp-without-time-zone.o002" +id = "db.expressions.timestamp-ntz-type.timestamp-without-time-zone.o011" kind = "option_present" required = true target = "[ (

) ]" - -[[obligation]] -id = "db.expressions.timestamp-ntz-type.timestamp-without-time-zone.o003" -kind = "option_absent" -required = true -target = "[ (

) ]" - -[[obligation]] -id = "db.expressions.timestamp-ntz-type.timestamp-without-time-zone.o004" -kind = "required_operand_missing" -required = true -target = "

in [ (

) ]" -note = "omit

" - -[[obligation]] -id = "db.expressions.timestamp-ntz-type.timestamp-without-time-zone.o005" -kind = "operand_type_class" -required = true -target = "

in [ (

) ]" -note = "a valid operand" - -[[obligation]] -id = "db.expressions.timestamp-ntz-type.timestamp-without-time-zone.o006" -kind = "negative_neighbour" -required = true -note = "the form without its required ) in [ (

) ]" - -[[obligation]] -id = "db.expressions.timestamp-ntz-type.timestamp-without-time-zone.o007" -kind = "negative_neighbour" -required = true -note = "the form without its required WITHOUT" - -[[obligation]] -id = "db.expressions.timestamp-ntz-type.timestamp-without-time-zone.o008" -kind = "negative_neighbour" -required = true -note = "the form without its required TIME" - -[[obligation]] -id = "db.expressions.timestamp-ntz-type.timestamp-without-time-zone.o009" -kind = "negative_neighbour" -required = true -note = "the form without its required ZONE" +anchor = "doc.data-types.timestamp-ntz-type / Syntax" +note = "TIMESTAMP ( 6 ) WITHOUT TIME ZONE in CAST; p is 'An optional precision from 6 through 9'" [[obligation]] id = "db.expressions.timestamp-type.timestamp.o001" @@ -4414,6 +4255,13 @@ kind = "option_absent" required = true target = "[ (

) ]" +[[obligation]] +id = "db.expressions.timestamp-type.timestamp.o007" +kind = "required_operand_missing" +required = true +target = "

in [ (

) ]" +note = "omit

" + [[obligation]] id = "db.expressions.timestamp-type.timestamp.o005" kind = "operand_type_class" @@ -4445,6 +4293,13 @@ kind = "option_absent" required = true target = "[ (

) ]" +[[obligation]] +id = "db.expressions.timestamp-type.timestamp-ltz.o007" +kind = "required_operand_missing" +required = true +target = "

in [ (

) ]" +note = "omit

" + [[obligation]] id = "db.expressions.timestamp-type.timestamp-ltz.o005" kind = "operand_type_class" @@ -4517,41 +4372,27 @@ required = true target = "{ TINYINT | BYTE } → BYTE" [[obligation]] -id = "db.expressions.tinyint-type.y.o001" +id = "db.expressions.tinyint-type.y.o008" kind = "positive" required = true -note = "the documented form with every required part and no optional part" - -[[obligation]] -id = "db.expressions.tinyint-type.y.o002" -kind = "option_present" -required = true -target = "[ + | - ]" - -[[obligation]] -id = "db.expressions.tinyint-type.y.o003" -kind = "option_absent" -required = true -target = "[ + | - ]" +anchor = "doc.data-types.tinyint-type / Literals" +note = "digits with the Y postfix" [[obligation]] -id = "db.expressions.tinyint-type.y.o004" +id = "db.expressions.tinyint-type.y.o009" kind = "alternative" required = true target = "[ + | - ] → +" +anchor = "doc.data-types.tinyint-type / Literals" +note = "a plus sign before the literal" [[obligation]] -id = "db.expressions.tinyint-type.y.o005" +id = "db.expressions.tinyint-type.y.o010" kind = "alternative" required = true target = "[ + | - ] → -" - -[[obligation]] -id = "db.expressions.tinyint-type.y.o007" -kind = "operand_type_class" -required = true -target = "" -note = "a valid operand" +anchor = "doc.data-types.tinyint-type / Literals" +note = "a minus sign before the literal" [[obligation]] id = "db.expressions.variant-type.o001" @@ -4684,6 +4525,13 @@ kind = "alternative" required = true target = "{ | BETWEEN … → BETWEEN AND " +[[obligation]] +id = "db.expressions.window-functions-frame.o014" +kind = "required_operand_missing" +required = true +target = "" +note = "omit " + [[obligation]] id = "db.expressions.window-functions-frame.o004" kind = "operand_type_class" @@ -4691,6 +4539,13 @@ required = true target = "" note = "a valid operand" +[[obligation]] +id = "db.expressions.window-functions-frame.o015" +kind = "required_operand_missing" +required = true +target = "" +note = "omit " + [[obligation]] id = "db.expressions.window-functions-frame.o005" kind = "operand_type_class" diff --git a/coverage/syntax-databricks/obligations/functions.toml b/coverage/syntax-databricks/obligations/functions.toml index 8d11a2fe9..f916e3ff4 100644 --- a/coverage/syntax-databricks/obligations/functions.toml +++ b/coverage/syntax-databricks/obligations/functions.toml @@ -759,124 +759,159 @@ target = "" note = "a valid expression" [[obligation]] -id = "db.functions.ai-detect-anomalies.o007" +id = "db.functions.ai-detect-anomalies.o038" kind = "option_present" required = true -target = "[ , ]" +target = "[ , group_col => ]" [[obligation]] -id = "db.functions.ai-detect-anomalies.o008" +id = "db.functions.ai-detect-anomalies.o039" kind = "option_absent" required = true -target = "[ , ]" +target = "[ , group_col => ]" [[obligation]] -id = "db.functions.ai-detect-anomalies.o009" +id = "db.functions.ai-detect-anomalies.o040" +kind = "required_operand_missing" +required = true +target = " in [ , group_col => ]" +note = "omit " + +[[obligation]] +id = "db.functions.ai-detect-anomalies.o041" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , group_col => ]" note = "a valid identifier" [[obligation]] -id = "db.functions.ai-detect-anomalies.o010" +id = "db.functions.ai-detect-anomalies.o042" kind = "option_present" required = true -target = "[ , ]" +target = "[ , anomaly_threshold => ]" [[obligation]] -id = "db.functions.ai-detect-anomalies.o011" +id = "db.functions.ai-detect-anomalies.o043" kind = "option_absent" required = true -target = "[ , ]" +target = "[ , anomaly_threshold => ]" + +[[obligation]] +id = "db.functions.ai-detect-anomalies.o044" +kind = "required_operand_missing" +required = true +target = " in [ , anomaly_threshold => ]" +note = "omit " [[obligation]] -id = "db.functions.ai-detect-anomalies.o012" +id = "db.functions.ai-detect-anomalies.o045" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , anomaly_threshold => ]" note = "a valid operand" [[obligation]] -id = "db.functions.ai-detect-anomalies.o013" +id = "db.functions.ai-detect-anomalies.o046" kind = "option_present" required = true -target = "[ , ]" +target = "[ , covariate_col => ]" [[obligation]] -id = "db.functions.ai-detect-anomalies.o014" +id = "db.functions.ai-detect-anomalies.o047" kind = "option_absent" required = true -target = "[ , ]" +target = "[ , covariate_col => ]" [[obligation]] -id = "db.functions.ai-detect-anomalies.o015" +id = "db.functions.ai-detect-anomalies.o048" +kind = "required_operand_missing" +required = true +target = " in [ , covariate_col => ]" +note = "omit " + +[[obligation]] +id = "db.functions.ai-detect-anomalies.o049" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , covariate_col => ]" note = "a valid identifier" [[obligation]] -id = "db.functions.ai-detect-anomalies.o016" +id = "db.functions.ai-detect-anomalies.o050" kind = "option_present" required = true -target = "[ , ]" +target = "[ , holiday_region => ]" [[obligation]] -id = "db.functions.ai-detect-anomalies.o017" +id = "db.functions.ai-detect-anomalies.o051" kind = "option_absent" required = true -target = "[ , ]" +target = "[ , holiday_region => ]" + +[[obligation]] +id = "db.functions.ai-detect-anomalies.o052" +kind = "required_operand_missing" +required = true +target = " in [ , holiday_region => ]" +note = "omit " [[obligation]] -id = "db.functions.ai-detect-anomalies.o018" +id = "db.functions.ai-detect-anomalies.o053" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , holiday_region => ]" note = "a valid operand" [[obligation]] -id = "db.functions.ai-detect-anomalies.o019" +id = "db.functions.ai-detect-anomalies.o054" kind = "option_present" required = true -target = "[ , ]" +target = "[ , only_last_n => ]" [[obligation]] -id = "db.functions.ai-detect-anomalies.o020" +id = "db.functions.ai-detect-anomalies.o055" kind = "option_absent" required = true -target = "[ , ]" +target = "[ , only_last_n => ]" [[obligation]] -id = "db.functions.ai-detect-anomalies.o021" +id = "db.functions.ai-detect-anomalies.o056" +kind = "required_operand_missing" +required = true +target = " in [ , only_last_n => ]" +note = "omit " + +[[obligation]] +id = "db.functions.ai-detect-anomalies.o057" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , only_last_n => ]" note = "a valid operand" [[obligation]] -id = "db.functions.ai-detect-anomalies.o022" +id = "db.functions.ai-detect-anomalies.o058" kind = "option_present" required = true -target = "[ , ]" +target = "[ , smoothing => ]" [[obligation]] -id = "db.functions.ai-detect-anomalies.o023" +id = "db.functions.ai-detect-anomalies.o059" kind = "option_absent" required = true -target = "[ , ]" +target = "[ , smoothing => ]" [[obligation]] -id = "db.functions.ai-detect-anomalies.o024" +id = "db.functions.ai-detect-anomalies.o060" kind = "required_operand_missing" required = true -target = " in [ , ]" +target = " in [ , smoothing => ]" note = "omit " [[obligation]] -id = "db.functions.ai-detect-anomalies.o025" +id = "db.functions.ai-detect-anomalies.o061" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , smoothing => ]" note = "a valid operand" [[obligation]] @@ -885,6 +920,42 @@ kind = "negative_neighbour" required = true note = "the form without its required (" +[[obligation]] +id = "db.functions.ai-detect-anomalies.o062" +kind = "negative_neighbour" +required = true +note = "the form without its required group_col in [ , group_col => ]" + +[[obligation]] +id = "db.functions.ai-detect-anomalies.o063" +kind = "negative_neighbour" +required = true +note = "the form without its required anomaly_threshold in [ , anomaly_threshold => ]" + +[[obligation]] +id = "db.functions.ai-detect-anomalies.o064" +kind = "negative_neighbour" +required = true +note = "the form without its required covariate_col in [ , covariate_col => ]" + +[[obligation]] +id = "db.functions.ai-detect-anomalies.o065" +kind = "negative_neighbour" +required = true +note = "the form without its required holiday_region in [ , holiday_region => ]" + +[[obligation]] +id = "db.functions.ai-detect-anomalies.o066" +kind = "negative_neighbour" +required = true +note = "the form without its required only_last_n in [ , only_last_n => ]" + +[[obligation]] +id = "db.functions.ai-detect-anomalies.o067" +kind = "negative_neighbour" +required = true +note = "the form without its required smoothing in [ , smoothing => ]" + [[obligation]] id = "db.functions.ai-detect-anomalies.o027" kind = "negative_neighbour" @@ -1244,143 +1315,185 @@ target = "" note = "a valid expression" [[obligation]] -id = "db.functions.ai-forecast.o009" +id = "db.functions.ai-forecast.o069" kind = "option_present" required = true -target = "[ , ]" +target = "[ , group_col => ]" [[obligation]] -id = "db.functions.ai-forecast.o010" +id = "db.functions.ai-forecast.o070" kind = "option_absent" required = true -target = "[ , ]" +target = "[ , group_col => ]" [[obligation]] -id = "db.functions.ai-forecast.o011" +id = "db.functions.ai-forecast.o071" +kind = "required_operand_missing" +required = true +target = " in [ , group_col => ]" +note = "omit " + +[[obligation]] +id = "db.functions.ai-forecast.o072" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , group_col => ]" note = "a valid identifier" [[obligation]] -id = "db.functions.ai-forecast.o012" +id = "db.functions.ai-forecast.o073" kind = "option_present" required = true -target = "[ , ]" +target = "[ , covariate_col => ]" [[obligation]] -id = "db.functions.ai-forecast.o013" +id = "db.functions.ai-forecast.o074" kind = "option_absent" required = true -target = "[ , ]" +target = "[ , covariate_col => ]" + +[[obligation]] +id = "db.functions.ai-forecast.o075" +kind = "required_operand_missing" +required = true +target = " in [ , covariate_col => ]" +note = "omit " [[obligation]] -id = "db.functions.ai-forecast.o014" +id = "db.functions.ai-forecast.o076" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , covariate_col => ]" note = "a valid identifier" [[obligation]] -id = "db.functions.ai-forecast.o015" +id = "db.functions.ai-forecast.o077" kind = "option_present" required = true -target = "[ , ]" +target = "[ , prediction_interval_width => ]" [[obligation]] -id = "db.functions.ai-forecast.o016" +id = "db.functions.ai-forecast.o078" kind = "option_absent" required = true -target = "[ , ]" +target = "[ , prediction_interval_width => ]" [[obligation]] -id = "db.functions.ai-forecast.o017" +id = "db.functions.ai-forecast.o079" +kind = "required_operand_missing" +required = true +target = " in [ , prediction_interval_width => ]" +note = "omit " + +[[obligation]] +id = "db.functions.ai-forecast.o080" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , prediction_interval_width => ]" note = "a valid operand" [[obligation]] -id = "db.functions.ai-forecast.o018" +id = "db.functions.ai-forecast.o081" kind = "option_present" required = true -target = "[ , ]" +target = "[ , frequency => ]" [[obligation]] -id = "db.functions.ai-forecast.o019" +id = "db.functions.ai-forecast.o082" kind = "option_absent" required = true -target = "[ , ]" +target = "[ , frequency => ]" [[obligation]] -id = "db.functions.ai-forecast.o020" +id = "db.functions.ai-forecast.o083" +kind = "required_operand_missing" +required = true +target = " in [ , frequency => ]" +note = "omit " + +[[obligation]] +id = "db.functions.ai-forecast.o084" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , frequency => ]" note = "a valid operand" [[obligation]] -id = "db.functions.ai-forecast.o021" +id = "db.functions.ai-forecast.o085" kind = "option_present" required = true -target = "[ , ]" +target = "[ , holiday_region => ]" [[obligation]] -id = "db.functions.ai-forecast.o022" +id = "db.functions.ai-forecast.o086" kind = "option_absent" required = true -target = "[ , ]" +target = "[ , holiday_region => ]" + +[[obligation]] +id = "db.functions.ai-forecast.o087" +kind = "required_operand_missing" +required = true +target = " in [ , holiday_region => ]" +note = "omit " [[obligation]] -id = "db.functions.ai-forecast.o023" +id = "db.functions.ai-forecast.o088" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , holiday_region => ]" note = "a valid operand" [[obligation]] -id = "db.functions.ai-forecast.o024" +id = "db.functions.ai-forecast.o089" kind = "option_present" required = true -target = "[ , ]" +target = "[ , positive_only => ]" [[obligation]] -id = "db.functions.ai-forecast.o025" +id = "db.functions.ai-forecast.o090" kind = "option_absent" required = true -target = "[ , ]" +target = "[ , positive_only => ]" + +[[obligation]] +id = "db.functions.ai-forecast.o091" +kind = "required_operand_missing" +required = true +target = " in [ , positive_only => ]" +note = "omit " [[obligation]] -id = "db.functions.ai-forecast.o026" +id = "db.functions.ai-forecast.o092" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , positive_only => ]" note = "a valid operand" [[obligation]] -id = "db.functions.ai-forecast.o027" +id = "db.functions.ai-forecast.o093" kind = "option_present" required = true -target = "[ , ]" +target = "[ , version => ]" [[obligation]] -id = "db.functions.ai-forecast.o028" +id = "db.functions.ai-forecast.o094" kind = "option_absent" required = true -target = "[ , ]" +target = "[ , version => ]" [[obligation]] -id = "db.functions.ai-forecast.o029" +id = "db.functions.ai-forecast.o095" kind = "required_operand_missing" required = true -target = " in [ , ]" +target = " in [ , version => ]" note = "omit " [[obligation]] -id = "db.functions.ai-forecast.o030" +id = "db.functions.ai-forecast.o096" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , version => ]" note = "a valid operand" [[obligation]] @@ -1433,124 +1546,159 @@ target = " #2" note = "a valid expression" [[obligation]] -id = "db.functions.ai-forecast.o038" +id = "db.functions.ai-forecast.o097" kind = "option_present" required = true -target = "[ , ] #2" +target = "[ , group_col => ] #2" [[obligation]] -id = "db.functions.ai-forecast.o039" +id = "db.functions.ai-forecast.o098" kind = "option_absent" required = true -target = "[ , ] #2" +target = "[ , group_col => ] #2" + +[[obligation]] +id = "db.functions.ai-forecast.o099" +kind = "required_operand_missing" +required = true +target = " in [ , group_col => ] #2" +note = "omit " [[obligation]] -id = "db.functions.ai-forecast.o040" +id = "db.functions.ai-forecast.o100" kind = "operand_type_class" required = true -target = " in [ , ] #2" +target = " in [ , group_col => ] #2" note = "a valid identifier" [[obligation]] -id = "db.functions.ai-forecast.o041" +id = "db.functions.ai-forecast.o101" kind = "option_present" required = true -target = "[ , ] #2" +target = "[ , prediction_interval_width => ] #2" [[obligation]] -id = "db.functions.ai-forecast.o042" +id = "db.functions.ai-forecast.o102" kind = "option_absent" required = true -target = "[ , ] #2" +target = "[ , prediction_interval_width => ] #2" [[obligation]] -id = "db.functions.ai-forecast.o043" +id = "db.functions.ai-forecast.o103" +kind = "required_operand_missing" +required = true +target = " in [ , prediction_interval_width => ] #2" +note = "omit " + +[[obligation]] +id = "db.functions.ai-forecast.o104" kind = "operand_type_class" required = true -target = " in [ , ] #2" +target = " in [ , prediction_interval_width => ] #2" note = "a valid operand" [[obligation]] -id = "db.functions.ai-forecast.o044" +id = "db.functions.ai-forecast.o105" kind = "option_present" required = true -target = "[ , ] #2" +target = "[ , frequency => ] #2" [[obligation]] -id = "db.functions.ai-forecast.o045" +id = "db.functions.ai-forecast.o106" kind = "option_absent" required = true -target = "[ , ] #2" +target = "[ , frequency => ] #2" + +[[obligation]] +id = "db.functions.ai-forecast.o107" +kind = "required_operand_missing" +required = true +target = " in [ , frequency => ] #2" +note = "omit " [[obligation]] -id = "db.functions.ai-forecast.o046" +id = "db.functions.ai-forecast.o108" kind = "operand_type_class" required = true -target = " in [ , ] #2" +target = " in [ , frequency => ] #2" note = "a valid operand" [[obligation]] -id = "db.functions.ai-forecast.o047" +id = "db.functions.ai-forecast.o109" kind = "option_present" required = true -target = "[ , ]" +target = "[ , seed => ]" [[obligation]] -id = "db.functions.ai-forecast.o048" +id = "db.functions.ai-forecast.o110" kind = "option_absent" required = true -target = "[ , ]" +target = "[ , seed => ]" [[obligation]] -id = "db.functions.ai-forecast.o049" +id = "db.functions.ai-forecast.o111" +kind = "required_operand_missing" +required = true +target = " in [ , seed => ]" +note = "omit " + +[[obligation]] +id = "db.functions.ai-forecast.o112" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , seed => ]" note = "a valid operand" [[obligation]] -id = "db.functions.ai-forecast.o050" +id = "db.functions.ai-forecast.o113" kind = "option_present" required = true -target = "[ , ]" +target = "[ , parameters => ]" [[obligation]] -id = "db.functions.ai-forecast.o051" +id = "db.functions.ai-forecast.o114" kind = "option_absent" required = true -target = "[ , ]" +target = "[ , parameters => ]" + +[[obligation]] +id = "db.functions.ai-forecast.o115" +kind = "required_operand_missing" +required = true +target = " in [ , parameters => ]" +note = "omit " [[obligation]] -id = "db.functions.ai-forecast.o052" +id = "db.functions.ai-forecast.o116" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , parameters => ]" note = "a valid operand" [[obligation]] -id = "db.functions.ai-forecast.o053" +id = "db.functions.ai-forecast.o117" kind = "option_present" required = true -target = "[ , ] #2" +target = "[ , version => ] #2" [[obligation]] -id = "db.functions.ai-forecast.o054" +id = "db.functions.ai-forecast.o118" kind = "option_absent" required = true -target = "[ , ] #2" +target = "[ , version => ] #2" [[obligation]] -id = "db.functions.ai-forecast.o055" +id = "db.functions.ai-forecast.o119" kind = "required_operand_missing" required = true -target = " in [ , ] #2" +target = " in [ , version => ] #2" note = "omit " [[obligation]] -id = "db.functions.ai-forecast.o056" +id = "db.functions.ai-forecast.o120" kind = "operand_type_class" required = true -target = " in [ , ] #2" +target = " in [ , version => ] #2" note = "a valid operand" [[obligation]] @@ -1559,12 +1707,90 @@ kind = "negative_neighbour" required = true note = "the form without its required (" +[[obligation]] +id = "db.functions.ai-forecast.o121" +kind = "negative_neighbour" +required = true +note = "the form without its required group_col in [ , group_col => ]" + +[[obligation]] +id = "db.functions.ai-forecast.o122" +kind = "negative_neighbour" +required = true +note = "the form without its required covariate_col in [ , covariate_col => ]" + +[[obligation]] +id = "db.functions.ai-forecast.o123" +kind = "negative_neighbour" +required = true +note = "the form without its required prediction_interval_width in [ , prediction_interval_width => ]" + +[[obligation]] +id = "db.functions.ai-forecast.o124" +kind = "negative_neighbour" +required = true +note = "the form without its required frequency in [ , frequency => ]" + +[[obligation]] +id = "db.functions.ai-forecast.o125" +kind = "negative_neighbour" +required = true +note = "the form without its required holiday_region in [ , holiday_region => ]" + +[[obligation]] +id = "db.functions.ai-forecast.o126" +kind = "negative_neighbour" +required = true +note = "the form without its required positive_only in [ , positive_only => ]" + +[[obligation]] +id = "db.functions.ai-forecast.o127" +kind = "negative_neighbour" +required = true +note = "the form without its required version in [ , version => ]" + [[obligation]] id = "db.functions.ai-forecast.o058" kind = "negative_neighbour" required = true note = "the form without its required )" +[[obligation]] +id = "db.functions.ai-forecast.o128" +kind = "negative_neighbour" +required = true +note = "the form without its required group_col in [ , group_col => ] #2" + +[[obligation]] +id = "db.functions.ai-forecast.o129" +kind = "negative_neighbour" +required = true +note = "the form without its required prediction_interval_width in [ , prediction_interval_width => ] #2" + +[[obligation]] +id = "db.functions.ai-forecast.o130" +kind = "negative_neighbour" +required = true +note = "the form without its required frequency in [ , frequency => ] #2" + +[[obligation]] +id = "db.functions.ai-forecast.o131" +kind = "negative_neighbour" +required = true +note = "the form without its required seed in [ , seed => ]" + +[[obligation]] +id = "db.functions.ai-forecast.o132" +kind = "negative_neighbour" +required = true +note = "the form without its required parameters in [ , parameters => ]" + +[[obligation]] +id = "db.functions.ai-forecast.o133" +kind = "negative_neighbour" +required = true +note = "the form without its required version in [ , version => ] #2" + [[obligation]] id = "db.functions.ai-forecast.o059" kind = "interaction_all_options" @@ -1992,6 +2218,14 @@ target = "" anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" +[[obligation]] +id = "db.functions.ai-predict-class.o027" +kind = "negative_neighbour" +required = true +target = "TABLE ( ) with its ) restored after the named arguments" +anchor = "doc.functions.ai_predict_class / Syntax" +note = "the o016 negative (the form without its required )) with the ) put back at the end instead: the warehouse reads TABLE ( v1 , target_col => v1 , feature_cols => v1 ) as a call of a function named TABLE (semantic_error UNRESOLVED_ROUTINE TABLE), so it parses; this shows the o016 refusal is the missing ), at end of input. Observed, so its receipt settles it" + [[obligation]] id = "db.functions.ai-predict-value.o001" kind = "positive" @@ -2139,6 +2373,14 @@ target = "" anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" +[[obligation]] +id = "db.functions.ai-predict-value.o027" +kind = "negative_neighbour" +required = true +target = "TABLE ( ) with its ) restored after the named arguments" +anchor = "doc.functions.ai_predict_value / Syntax" +note = "the o016 negative (the form without its required )) with the ) put back at the end instead: the warehouse reads TABLE ( v1 , target_col => v1 , feature_cols => v1 ) as a call of a function named TABLE (semantic_error UNRESOLVED_ROUTINE TABLE), so it parses; this shows the o016 refusal is the missing ), at end of input. Observed, so its receipt settles it" + [[obligation]] id = "db.functions.ai-prep-search.o001" kind = "positive" @@ -2528,22 +2770,75 @@ target = "" note = "a valid operand" [[obligation]] -id = "db.functions.ai-top-drivers.o008" +id = "db.functions.ai-top-drivers.o016" kind = "option_present" required = true -target = "[ , ]" +target = "[ , { dimensions => | aggregation => | min_support => } ]" [[obligation]] -id = "db.functions.ai-top-drivers.o009" +id = "db.functions.ai-top-drivers.o017" kind = "option_absent" required = true -target = "[ , ]" +target = "[ , { dimensions => | aggregation => | min_support => } ]" + +[[obligation]] +id = "db.functions.ai-top-drivers.o018" +kind = "alternative" +required = true +target = "{ dimensions => | aggregation => | min_support => … → dimensions => " + +[[obligation]] +id = "db.functions.ai-top-drivers.o019" +kind = "alternative" +required = true +target = "{ dimensions => | aggregation => | min_support =>… → aggregation => " + +[[obligation]] +id = "db.functions.ai-top-drivers.o020" +kind = "alternative" +required = true +target = "{ dimensions => | aggregation => | min_support =>… → min_support => " + +[[obligation]] +id = "db.functions.ai-top-drivers.o021" +kind = "required_operand_missing" +required = true +target = " in [ , { dimensions => | aggregation => | min_support => } ]" +note = "omit " + +[[obligation]] +id = "db.functions.ai-top-drivers.o022" +kind = "operand_type_class" +required = true +target = " in [ , { dimensions => | aggregation => | min_support => } ]" +note = "a valid operand" + +[[obligation]] +id = "db.functions.ai-top-drivers.o023" +kind = "required_operand_missing" +required = true +target = " in [ , { dimensions => | aggregation => | min_support => } ]" +note = "omit " + +[[obligation]] +id = "db.functions.ai-top-drivers.o024" +kind = "operand_type_class" +required = true +target = " in [ , { dimensions => | aggregation => | min_support => } ]" +note = "a valid operand" + +[[obligation]] +id = "db.functions.ai-top-drivers.o025" +kind = "required_operand_missing" +required = true +target = " in [ , { dimensions => | aggregation => | min_support => } ]" +note = "omit " [[obligation]] -id = "db.functions.ai-top-drivers.o010" +id = "db.functions.ai-top-drivers.o026" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , { dimensions => | aggregation => | min_support => } ]" note = "a valid operand" [[obligation]] @@ -2570,6 +2865,24 @@ kind = "negative_neighbour" required = true note = "the form without its required is_test" +[[obligation]] +id = "db.functions.ai-top-drivers.o027" +kind = "negative_neighbour" +required = true +note = "the form without its required dimensions after , in [ , { dimensions => | aggregation => | min_support => } ]" + +[[obligation]] +id = "db.functions.ai-top-drivers.o028" +kind = "negative_neighbour" +required = true +note = "the form without its required aggregation after , in [ , { dimensions => | aggregation => | min_support => } ]" + +[[obligation]] +id = "db.functions.ai-top-drivers.o029" +kind = "negative_neighbour" +required = true +note = "the form without its required min_support after , in [ , { dimensions => | aggregation => | min_support => } ]" + [[obligation]] id = "db.functions.ai-top-drivers.o015" kind = "negative_neighbour" @@ -6494,12 +6807,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.classifier.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.classifier.o003" kind = "negative_neighbour" @@ -6538,12 +6845,6 @@ required = true target = "" note = "a valid operand" -[[obligation]] -id = "db.functions.cloud-files-state.o007" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.cloud-files-state.o009" kind = "negative_neighbour" @@ -6698,12 +6999,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.collations.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.collations.o003" kind = "negative_neighbour" @@ -6940,18 +7235,11 @@ target = "" note = "omit " [[obligation]] -id = "db.functions.colonsign.o005" +id = "db.functions.colonsign.o007" kind = "operand_type_class" required = true target = "" -note = "a valid string_literal" - -[[obligation]] -id = "db.functions.colonsign.o006" -kind = "negative_neighbour" -required = true -target = "" -note = "an unquoted identifier in place of " +note = "a valid operand" [[obligation]] id = "db.functions.concat.o001" @@ -8534,12 +8822,6 @@ required = true target = "" note = "a valid operand" -[[obligation]] -id = "db.functions.cume-dist.o004" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.cume-dist.o005" kind = "negative_neighbour" @@ -8552,12 +8834,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.curdate.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.curdate.o003" kind = "negative_neighbour" @@ -8570,12 +8846,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.current-catalog.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.current-catalog.o003" kind = "negative_neighbour" @@ -8588,12 +8858,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.current-database.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.current-database.o003" kind = "negative_neighbour" @@ -8607,16 +8871,22 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.functions.current-date.o002" -kind = "negative_neighbour" +id = "db.functions.current-date.o004" +kind = "option_present" required = true -note = "the form without its required (" +target = "[ ( ) ]" [[obligation]] -id = "db.functions.current-date.o003" +id = "db.functions.current-date.o005" +kind = "option_absent" +required = true +target = "[ ( ) ]" + +[[obligation]] +id = "db.functions.current-date.o006" kind = "negative_neighbour" required = true -note = "the form without its required )" +note = "the form without its required ) in [ ( ) ]" [[obligation]] id = "db.functions.current-metastore.o001" @@ -8624,12 +8894,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.current-metastore.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.current-metastore.o003" kind = "negative_neighbour" @@ -8642,12 +8906,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.current-oauth-custom-identity-claim.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.current-oauth-custom-identity-claim.o003" kind = "negative_neighbour" @@ -8661,16 +8919,22 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.functions.current-path.o002" -kind = "negative_neighbour" +id = "db.functions.current-path.o004" +kind = "option_present" required = true -note = "the form without its required (" +target = "[ ( ) ]" [[obligation]] -id = "db.functions.current-path.o003" +id = "db.functions.current-path.o005" +kind = "option_absent" +required = true +target = "[ ( ) ]" + +[[obligation]] +id = "db.functions.current-path.o006" kind = "negative_neighbour" required = true -note = "the form without its required )" +note = "the form without its required ) in [ ( ) ]" [[obligation]] id = "db.functions.current-recipient.o001" @@ -8703,12 +8967,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.current-schema.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.current-schema.o003" kind = "negative_neighbour" @@ -8721,12 +8979,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.current-snapshot-version.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.current-snapshot-version.o003" kind = "negative_neighbour" @@ -8739,6 +8991,18 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" +[[obligation]] +id = "db.functions.current-time.o007" +kind = "option_present" +required = true +target = "[ ( [ ] ) ]" + +[[obligation]] +id = "db.functions.current-time.o008" +kind = "option_absent" +required = true +target = "[ ( [ ] ) ]" + [[obligation]] id = "db.functions.current-time.o002" kind = "option_present" @@ -8759,16 +9023,10 @@ target = " in [ ]" note = "a valid operand" [[obligation]] -id = "db.functions.current-time.o005" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - -[[obligation]] -id = "db.functions.current-time.o006" +id = "db.functions.current-time.o009" kind = "negative_neighbour" required = true -note = "the form without its required )" +note = "the form without its required ) in [ ( [ ] ) ]" [[obligation]] id = "db.functions.current-timestamp.o001" @@ -8776,6 +9034,18 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" +[[obligation]] +id = "db.functions.current-timestamp.o007" +kind = "option_present" +required = true +target = "[ ( [ ] ) ]" + +[[obligation]] +id = "db.functions.current-timestamp.o008" +kind = "option_absent" +required = true +target = "[ ( [ ] ) ]" + [[obligation]] id = "db.functions.current-timestamp.o002" kind = "option_present" @@ -8796,16 +9066,18 @@ target = " in [ ]" note = "a valid operand" [[obligation]] -id = "db.functions.current-timestamp.o005" +id = "db.functions.current-timestamp.o009" kind = "negative_neighbour" required = true -note = "the form without its required (" +note = "the form without its required ) in [ ( [ ] ) ]" [[obligation]] -id = "db.functions.current-timestamp.o006" -kind = "negative_neighbour" +id = "db.functions.current-timestamp.o010" +kind = "operand_type_class" required = true -note = "the form without its required )" +target = "" +anchor = "doc.functions.current_timestamp / Syntax" +note = "a string where the page documents an INTEGER literal precision" [[obligation]] id = "db.functions.current-timezone.o001" @@ -8813,12 +9085,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.current-timezone.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.current-timezone.o003" kind = "negative_neighbour" @@ -8832,16 +9098,22 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.functions.current-user.o002" -kind = "negative_neighbour" +id = "db.functions.current-user.o004" +kind = "option_present" required = true -note = "the form without its required (" +target = "[ ( ) ]" [[obligation]] -id = "db.functions.current-user.o003" +id = "db.functions.current-user.o005" +kind = "option_absent" +required = true +target = "[ ( ) ]" + +[[obligation]] +id = "db.functions.current-user.o006" kind = "negative_neighbour" required = true -note = "the form without its required )" +note = "the form without its required ) in [ ( ) ]" [[obligation]] id = "db.functions.current-version.o001" @@ -8849,12 +9121,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.current-version.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.current-version.o003" kind = "negative_neighbour" @@ -8874,12 +9140,6 @@ required = true target = "" note = "a valid identifier" -[[obligation]] -id = "db.functions.data-skipping-summary.o004" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.data-skipping-summary.o006" kind = "negative_neighbour" @@ -8992,18 +9252,70 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.functions.date-add3.o002" -kind = "required_operand_missing" +id = "db.functions.date-add3.o010" +kind = "alternative" required = true -target = "" -note = "omit " +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → MICROSECOND" [[obligation]] -id = "db.functions.date-add3.o003" -kind = "operand_type_class" +id = "db.functions.date-add3.o011" +kind = "alternative" required = true -target = "" -note = "a valid operand" +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → MILLISECOND" + +[[obligation]] +id = "db.functions.date-add3.o012" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → SECOND" + +[[obligation]] +id = "db.functions.date-add3.o013" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → MINUTE" + +[[obligation]] +id = "db.functions.date-add3.o014" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → HOUR" + +[[obligation]] +id = "db.functions.date-add3.o015" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → DAY" + +[[obligation]] +id = "db.functions.date-add3.o016" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → DAYOFYEAR" + +[[obligation]] +id = "db.functions.date-add3.o017" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → WEEK" + +[[obligation]] +id = "db.functions.date-add3.o018" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → MONTH" + +[[obligation]] +id = "db.functions.date-add3.o019" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → QUARTER" + +[[obligation]] +id = "db.functions.date-add3.o020" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → YEAR" [[obligation]] id = "db.functions.date-add3.o004" @@ -9039,12 +9351,26 @@ kind = "negative_neighbour" required = true note = "the form without its required (" +[[obligation]] +id = "db.functions.date-add3.o021" +kind = "negative_neighbour" +required = true +note = "the form without its required { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR }" + [[obligation]] id = "db.functions.date-add3.o009" kind = "negative_neighbour" required = true note = "the form without its required )" +[[obligation]] +id = "db.functions.date-add3.o022" +kind = "operand_type_class" +required = true +target = "" +anchor = "doc.functions.date_add3 / Syntax" +note = "the unit written as a quoted string rather than its keyword, recorded to show how the warehouse reads it" + [[obligation]] id = "db.functions.date-diff.o001" kind = "positive" @@ -9080,18 +9406,64 @@ target = "" note = "a valid expression" [[obligation]] -id = "db.functions.date-diff.o006" -kind = "required_operand_missing" +id = "db.functions.date-diff.o014" +kind = "alternative" required = true -target = "" -note = "omit " +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → MICROSECOND" [[obligation]] -id = "db.functions.date-diff.o007" -kind = "operand_type_class" +id = "db.functions.date-diff.o015" +kind = "alternative" required = true -target = "" -note = "a valid operand" +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → MILLISECOND" + +[[obligation]] +id = "db.functions.date-diff.o016" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → SECOND" + +[[obligation]] +id = "db.functions.date-diff.o017" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → MINUTE" + +[[obligation]] +id = "db.functions.date-diff.o018" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → HOUR" + +[[obligation]] +id = "db.functions.date-diff.o019" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → DAY" + +[[obligation]] +id = "db.functions.date-diff.o020" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → WEEK" + +[[obligation]] +id = "db.functions.date-diff.o021" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → MONTH" + +[[obligation]] +id = "db.functions.date-diff.o022" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → QUARTER" + +[[obligation]] +id = "db.functions.date-diff.o023" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → YEAR" [[obligation]] id = "db.functions.date-diff.o008" @@ -9133,6 +9505,20 @@ kind = "negative_neighbour" required = true note = "the form without its required )" +[[obligation]] +id = "db.functions.date-diff.o024" +kind = "negative_neighbour" +required = true +note = "the form without its required { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR }" + +[[obligation]] +id = "db.functions.date-diff.o025" +kind = "operand_type_class" +required = true +target = "" +anchor = "doc.functions.date_diff / Syntax" +note = "the unit written as a quoted string rather than its keyword, recorded to show how the warehouse reads it" + [[obligation]] id = "db.functions.date-format.o001" kind = "positive" @@ -9349,18 +9735,70 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.functions.dateadd.o002" -kind = "required_operand_missing" +id = "db.functions.dateadd.o010" +kind = "alternative" required = true -target = "" -note = "omit " +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → MICROSECOND" [[obligation]] -id = "db.functions.dateadd.o003" -kind = "operand_type_class" +id = "db.functions.dateadd.o011" +kind = "alternative" required = true -target = "" -note = "a valid operand" +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → MILLISECOND" + +[[obligation]] +id = "db.functions.dateadd.o012" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → SECOND" + +[[obligation]] +id = "db.functions.dateadd.o013" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → MINUTE" + +[[obligation]] +id = "db.functions.dateadd.o014" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → HOUR" + +[[obligation]] +id = "db.functions.dateadd.o015" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → DAY" + +[[obligation]] +id = "db.functions.dateadd.o016" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → DAYOFYEAR" + +[[obligation]] +id = "db.functions.dateadd.o017" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → WEEK" + +[[obligation]] +id = "db.functions.dateadd.o018" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → MONTH" + +[[obligation]] +id = "db.functions.dateadd.o019" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → QUARTER" + +[[obligation]] +id = "db.functions.dateadd.o020" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → YEAR" [[obligation]] id = "db.functions.dateadd.o004" @@ -9396,12 +9834,26 @@ kind = "negative_neighbour" required = true note = "the form without its required (" +[[obligation]] +id = "db.functions.dateadd.o021" +kind = "negative_neighbour" +required = true +note = "the form without its required { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR }" + [[obligation]] id = "db.functions.dateadd.o009" kind = "negative_neighbour" required = true note = "the form without its required )" +[[obligation]] +id = "db.functions.dateadd.o022" +kind = "operand_type_class" +required = true +target = "" +anchor = "doc.functions.dateadd / Syntax" +note = "the unit written as a quoted string rather than its keyword, recorded to show how the warehouse reads it" + [[obligation]] id = "db.functions.dateadd2.o001" kind = "positive" @@ -9501,18 +9953,64 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.functions.datediff3.o002" -kind = "required_operand_missing" +id = "db.functions.datediff3.o010" +kind = "alternative" required = true -target = "" -note = "omit " +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → MICROSECOND" [[obligation]] -id = "db.functions.datediff3.o003" -kind = "operand_type_class" +id = "db.functions.datediff3.o011" +kind = "alternative" required = true -target = "" -note = "a valid operand" +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → MILLISECOND" + +[[obligation]] +id = "db.functions.datediff3.o012" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → SECOND" + +[[obligation]] +id = "db.functions.datediff3.o013" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → MINUTE" + +[[obligation]] +id = "db.functions.datediff3.o014" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → HOUR" + +[[obligation]] +id = "db.functions.datediff3.o015" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → DAY" + +[[obligation]] +id = "db.functions.datediff3.o016" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → WEEK" + +[[obligation]] +id = "db.functions.datediff3.o017" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → MONTH" + +[[obligation]] +id = "db.functions.datediff3.o018" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → QUARTER" + +[[obligation]] +id = "db.functions.datediff3.o019" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → YEAR" [[obligation]] id = "db.functions.datediff3.o004" @@ -9548,12 +10046,26 @@ kind = "negative_neighbour" required = true note = "the form without its required (" +[[obligation]] +id = "db.functions.datediff3.o020" +kind = "negative_neighbour" +required = true +note = "the form without its required { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR }" + [[obligation]] id = "db.functions.datediff3.o009" kind = "negative_neighbour" required = true note = "the form without its required )" +[[obligation]] +id = "db.functions.datediff3.o021" +kind = "operand_type_class" +required = true +target = "" +anchor = "doc.functions.datediff3 / Syntax" +note = "the unit written as a quoted string rather than its keyword, recorded to show how the warehouse reads it" + [[obligation]] id = "db.functions.day.o001" kind = "positive" @@ -9724,12 +10236,6 @@ required = true target = "" note = "a valid expression" -[[obligation]] -id = "db.functions.decode.o004" -kind = "alternative" -required = true -target = "{ , } → , " - [[obligation]] id = "db.functions.decode.o005" kind = "required_operand_missing" @@ -9752,17 +10258,17 @@ target = "" note = "a valid expression" [[obligation]] -id = "db.functions.decode.o008" +id = "db.functions.decode.o017" kind = "option_present" required = true -target = "[ , ... ]" +target = "[ , , ... ]" note = "the list continued at least once" [[obligation]] -id = "db.functions.decode.o009" +id = "db.functions.decode.o018" kind = "option_absent" required = true -target = "[ , ... ]" +target = "[ , , ... ]" [[obligation]] id = "db.functions.decode.o010" @@ -9885,12 +10391,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.dense-rank.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.dense-rank.o003" kind = "negative_neighbour" @@ -10082,12 +10582,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.e.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.e.o003" kind = "negative_neighbour" @@ -10458,12 +10952,6 @@ required = true target = "" note = "a valid operand" -[[obligation]] -id = "db.functions.event-log.o007" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.event-log.o009" kind = "negative_neighbour" @@ -10802,6 +11290,14 @@ kind = "negative_neighbour" required = true note = "the form without its required )" +[[obligation]] +id = "db.functions.extract.o009" +kind = "negative_neighbour" +required = true +target = "(" +anchor = "doc.functions.extract / Syntax" +note = "the call without its required ( keeping its documented keyword operand, beside the case that writes 1 there" + [[obligation]] id = "db.functions.factorial.o001" kind = "positive" @@ -12142,12 +12638,6 @@ required = true target = " in [ ]" note = "a valid operand" -[[obligation]] -id = "db.functions.getdate.o005" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.getdate.o006" kind = "negative_neighbour" @@ -12285,12 +12775,6 @@ kind = "option_absent" required = true target = "[ , ... ]" -[[obligation]] -id = "db.functions.grouping-id.o007" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.grouping-id.o008" kind = "negative_neighbour" @@ -14472,11 +14956,11 @@ target = "" note = "omit " [[obligation]] -id = "db.functions.http-request.o009" +id = "db.functions.http-request.o035" kind = "operand_type_class" required = true target = "" -note = "a valid identifier" +note = "a valid string_literal" [[obligation]] id = "db.functions.http-request.o010" @@ -14610,20 +15094,12 @@ required = true note = "the form without its required )" [[obligation]] -id = "db.functions.http-request.o030" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "quoted: a double-quoted identifier with blanks and mixed case" - -[[obligation]] -id = "db.functions.http-request.o032" -kind = "identifier_class" +id = "db.functions.http-request.o036" +kind = "option_present" required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" +target = "[ , ... ]" +anchor = "doc.functions.http_request / Syntax" +note = "two different named parameters; the page says a parameter given more than once is an error" [[obligation]] id = "db.functions.hypot.o001" @@ -14895,12 +15371,6 @@ required = true target = " in [ ESCAPE ]" note = "a valid operand" -[[obligation]] -id = "db.functions.ilike.ilike.o012" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.ilike.ilike.o013" kind = "negative_neighbour" @@ -14913,6 +15383,14 @@ kind = "interaction_all_options" required = true note = "every independent option of one production together" +[[obligation]] +id = "db.functions.ilike.ilike.o015" +kind = "option_present" +required = true +target = "[ ESCAPE ] inside the parentheses" +anchor = "doc.functions.ilike / Syntax" +note = "ESCAPE inside the parentheses, as the page's Syntax line writes it, which the warehouse refuses" + [[obligation]] id = "db.functions.ilike.ilike-any-some-all.o001" kind = "positive" @@ -15261,12 +15739,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.input-file-block-length.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.input-file-block-length.o003" kind = "negative_neighbour" @@ -15279,12 +15751,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.input-file-block-start.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.input-file-block-start.o003" kind = "negative_neighbour" @@ -15297,12 +15763,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.input-file-name.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.input-file-name.o003" kind = "negative_neighbour" @@ -17607,12 +18067,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.last-snapshot-version.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.last-snapshot-version.o003" kind = "negative_neighbour" @@ -18191,12 +18645,6 @@ required = true target = " in [ ESCAPE ]" note = "a valid operand" -[[obligation]] -id = "db.functions.like.like.o012" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.like.like.o013" kind = "negative_neighbour" @@ -18209,6 +18657,14 @@ kind = "interaction_all_options" required = true note = "every independent option of one production together" +[[obligation]] +id = "db.functions.like.like.o015" +kind = "option_present" +required = true +target = "[ ESCAPE ] inside the parentheses" +anchor = "doc.functions.like / Syntax" +note = "ESCAPE inside the parentheses, as the page's Syntax line writes it, which the warehouse refuses" + [[obligation]] id = "db.functions.like.like-any-some-all.o001" kind = "positive" @@ -18430,12 +18886,6 @@ required = true target = " in [ ]" note = "a valid operand" -[[obligation]] -id = "db.functions.list-secrets.o005" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.list-secrets.o006" kind = "negative_neighbour" @@ -18506,74 +18956,84 @@ target = " in [ , ]" note = "a valid operand" [[obligation]] -id = "db.functions.listagg.o011" +id = "db.functions.listagg.o040" kind = "option_present" required = true -target = "[ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +target = "[ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" [[obligation]] -id = "db.functions.listagg.o012" +id = "db.functions.listagg.o041" kind = "option_absent" required = true -target = "[ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +target = "[ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" [[obligation]] -id = "db.functions.listagg.o013" +id = "db.functions.listagg.o042" kind = "alternative" required = true -target = "{ [ ] [ ] } → [ ] [ ]" +target = "{ [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } → [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ]" [[obligation]] -id = "db.functions.listagg.o014" +id = "db.functions.listagg.o043" kind = "required_operand_missing" required = true -target = " in [ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +target = " in [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" note = "omit " [[obligation]] -id = "db.functions.listagg.o015" +id = "db.functions.listagg.o044" kind = "operand_type_class" required = true -target = " in [ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +target = " in [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" note = "a valid operand" [[obligation]] -id = "db.functions.listagg.o016" +id = "db.functions.listagg.o045" kind = "option_present" required = true -target = "[ ]" +target = "[ ASC | DESC ]" [[obligation]] -id = "db.functions.listagg.o017" +id = "db.functions.listagg.o046" kind = "option_absent" required = true -target = "[ ]" +target = "[ ASC | DESC ]" [[obligation]] -id = "db.functions.listagg.o018" -kind = "operand_type_class" +id = "db.functions.listagg.o047" +kind = "alternative" required = true -target = " in [ ]" -note = "a valid operand" +target = "[ ASC | DESC ] → ASC" [[obligation]] -id = "db.functions.listagg.o019" +id = "db.functions.listagg.o048" +kind = "alternative" +required = true +target = "[ ASC | DESC ] → DESC" + +[[obligation]] +id = "db.functions.listagg.o049" kind = "option_present" required = true -target = "[ ]" +target = "[ NULLS FIRST | NULLS LAST ]" [[obligation]] -id = "db.functions.listagg.o020" +id = "db.functions.listagg.o050" kind = "option_absent" required = true -target = "[ ]" +target = "[ NULLS FIRST | NULLS LAST ]" [[obligation]] -id = "db.functions.listagg.o021" -kind = "operand_type_class" +id = "db.functions.listagg.o051" +kind = "alternative" required = true -target = " in [ ]" -note = "a valid operand" +target = "[ NULLS FIRST | NULLS LAST ] → NULLS FIRST" + +[[obligation]] +id = "db.functions.listagg.o052" +kind = "alternative" +required = true +target = "[ NULLS FIRST | NULLS LAST ] → NULLS LAST" [[obligation]] id = "db.functions.listagg.o022" @@ -18627,40 +19087,52 @@ required = true note = "the form without its required )" [[obligation]] -id = "db.functions.listagg.o030" +id = "db.functions.listagg.o053" +kind = "negative_neighbour" +required = true +note = "the form without its required GROUP in [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" + +[[obligation]] +id = "db.functions.listagg.o054" +kind = "negative_neighbour" +required = true +note = "the form without its required ( in [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" + +[[obligation]] +id = "db.functions.listagg.o055" kind = "negative_neighbour" required = true -note = "the form without its required GROUP in [ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +note = "the form without its required ORDER in [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" [[obligation]] -id = "db.functions.listagg.o031" +id = "db.functions.listagg.o056" kind = "negative_neighbour" required = true -note = "the form without its required ( in [ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +note = "the form without its required BY in [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" [[obligation]] -id = "db.functions.listagg.o032" +id = "db.functions.listagg.o057" kind = "negative_neighbour" required = true -note = "the form without its required ORDER in [ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +note = "the form without its required FIRST in [ NULLS FIRST | NULLS LAST ]" [[obligation]] -id = "db.functions.listagg.o033" +id = "db.functions.listagg.o058" kind = "negative_neighbour" required = true -note = "the form without its required BY in [ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +note = "the form without its required LAST in [ NULLS FIRST | NULLS LAST ]" [[obligation]] -id = "db.functions.listagg.o034" +id = "db.functions.listagg.o059" kind = "negative_neighbour" required = true -note = "the form without its required { [ ] [ ] } in [ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +note = "the form without its required { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } in [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" [[obligation]] -id = "db.functions.listagg.o035" +id = "db.functions.listagg.o060" kind = "negative_neighbour" required = true -note = "the form without its required ) in [ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +note = "the form without its required ) in [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" [[obligation]] id = "db.functions.listagg.o036" @@ -18717,6 +19189,18 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" +[[obligation]] +id = "db.functions.localtime.o007" +kind = "option_present" +required = true +target = "[ ( [ ] ) ]" + +[[obligation]] +id = "db.functions.localtime.o008" +kind = "option_absent" +required = true +target = "[ ( [ ] ) ]" + [[obligation]] id = "db.functions.localtime.o002" kind = "option_present" @@ -18737,16 +19221,10 @@ target = " in [ ]" note = "a valid operand" [[obligation]] -id = "db.functions.localtime.o005" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - -[[obligation]] -id = "db.functions.localtime.o006" +id = "db.functions.localtime.o009" kind = "negative_neighbour" required = true -note = "the form without its required )" +note = "the form without its required ) in [ ( [ ] ) ]" [[obligation]] id = "db.functions.localtimestamp.o001" @@ -18774,16 +19252,18 @@ target = " in [ ]" note = "a valid operand" [[obligation]] -id = "db.functions.localtimestamp.o005" +id = "db.functions.localtimestamp.o010" kind = "negative_neighbour" required = true -note = "the form without its required (" +note = "the form without its required )" [[obligation]] -id = "db.functions.localtimestamp.o006" -kind = "negative_neighbour" +id = "db.functions.localtimestamp.o011" +kind = "option_absent" required = true -note = "the form without its required )" +target = "the parentheses" +anchor = "doc.functions.localtimestamp / Syntax" +note = "LOCALTIMESTAMP without parentheses, which the page says is allowed when precision is omitted: the warehouse parses it but resolves it as a column (UNRESOLVED_COLUMN), not as the function, so the form keeps its written parentheses and the bare word is observed" [[obligation]] id = "db.functions.locate.o001" @@ -19294,11 +19774,11 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.functions.luhn-check.o002" +id = "db.functions.luhn-check.o005" kind = "operand_type_class" required = true target = "" -note = "a valid integer_literal" +note = "a valid expression" [[obligation]] id = "db.functions.luhn-check.o003" @@ -19475,12 +19955,6 @@ required = true target = " in [ , ]" note = "a valid operand" -[[obligation]] -id = "db.functions.make-dt-interval.o017" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.make-dt-interval.o018" kind = "negative_neighbour" @@ -19668,12 +20142,6 @@ required = true target = " in [ , ]" note = "a valid operand" -[[obligation]] -id = "db.functions.make-interval.o029" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.make-interval.o030" kind = "negative_neighbour" @@ -20294,12 +20762,6 @@ required = true target = " in [ , ]" note = "a valid operand" -[[obligation]] -id = "db.functions.make-ym-interval.o009" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.make-ym-interval.o010" kind = "negative_neighbour" @@ -20313,56 +20775,57 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.functions.map.o002" +id = "db.functions.map.o012" kind = "option_present" required = true -target = "[ , ]" +target = "[ , [ , , ... ] ]" [[obligation]] -id = "db.functions.map.o003" +id = "db.functions.map.o013" kind = "option_absent" required = true -target = "[ , ]" +target = "[ , [ , , ... ] ]" [[obligation]] -id = "db.functions.map.o004" +id = "db.functions.map.o014" kind = "required_operand_missing" required = true -target = " in [ , ]" +target = " in [ , [ , , ... ] ]" note = "omit " [[obligation]] -id = "db.functions.map.o005" +id = "db.functions.map.o015" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , [ , , ... ] ]" note = "a valid operand" [[obligation]] -id = "db.functions.map.o006" +id = "db.functions.map.o016" +kind = "required_operand_missing" +required = true +target = " in [ , [ , , ... ] ]" +note = "omit " + +[[obligation]] +id = "db.functions.map.o017" kind = "operand_type_class" required = true -target = " in [ , ]" +target = " in [ , [ , , ... ] ]" note = "a valid expression" [[obligation]] -id = "db.functions.map.o007" +id = "db.functions.map.o018" kind = "option_present" required = true -target = "[ , ... ]" +target = "[ , , ... ]" note = "the list continued at least once" [[obligation]] -id = "db.functions.map.o008" +id = "db.functions.map.o019" kind = "option_absent" required = true -target = "[ , ... ]" - -[[obligation]] -id = "db.functions.map.o009" -kind = "negative_neighbour" -required = true -note = "the form without its required (" +target = "[ , , ... ]" [[obligation]] id = "db.functions.map.o010" @@ -20370,12 +20833,6 @@ kind = "negative_neighbour" required = true note = "the form without its required )" -[[obligation]] -id = "db.functions.map.o011" -kind = "interaction_all_options" -required = true -note = "every independent option of one production together" - [[obligation]] id = "db.functions.map-concat.o001" kind = "positive" @@ -20414,12 +20871,6 @@ kind = "option_absent" required = true target = "[ , ... ]" -[[obligation]] -id = "db.functions.map-concat.o007" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.map-concat.o008" kind = "negative_neighbour" @@ -20859,12 +21310,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.match-number.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.match-number.o003" kind = "negative_neighbour" @@ -20904,11 +21349,11 @@ target = "" note = "omit " [[obligation]] -id = "db.functions.match-recognize-first.o006" +id = "db.functions.match-recognize-first.o019" kind = "operand_type_class" required = true target = "" -note = "a valid string_literal" +note = "a valid identifier" [[obligation]] id = "db.functions.match-recognize-first.o007" @@ -20985,6 +21430,22 @@ target = "" anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" +[[obligation]] +id = "db.functions.match-recognize-first.o020" +kind = "identifier_class" +required = true +target = "" +anchor = "doc.identifiers-syntax" +note = "quoted: a double-quoted identifier with blanks and mixed case" + +[[obligation]] +id = "db.functions.match-recognize-first.o021" +kind = "identifier_class" +required = true +target = "" +anchor = "doc.identifiers-syntax" +note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" + [[obligation]] id = "db.functions.match-recognize-last.o001" kind = "positive" @@ -21018,11 +21479,11 @@ target = "" note = "omit " [[obligation]] -id = "db.functions.match-recognize-last.o006" +id = "db.functions.match-recognize-last.o019" kind = "operand_type_class" required = true target = "" -note = "a valid string_literal" +note = "a valid identifier" [[obligation]] id = "db.functions.match-recognize-last.o007" @@ -21099,6 +21560,22 @@ target = "" anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" +[[obligation]] +id = "db.functions.match-recognize-last.o020" +kind = "identifier_class" +required = true +target = "" +anchor = "doc.identifiers-syntax" +note = "quoted: a double-quoted identifier with blanks and mixed case" + +[[obligation]] +id = "db.functions.match-recognize-last.o021" +kind = "identifier_class" +required = true +target = "" +anchor = "doc.identifiers-syntax" +note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" + [[obligation]] id = "db.functions.match-recognize-next.o001" kind = "positive" @@ -21132,11 +21609,11 @@ target = "" note = "omit " [[obligation]] -id = "db.functions.match-recognize-next.o006" +id = "db.functions.match-recognize-next.o019" kind = "operand_type_class" required = true target = "" -note = "a valid string_literal" +note = "a valid identifier" [[obligation]] id = "db.functions.match-recognize-next.o007" @@ -21213,6 +21690,22 @@ target = "" anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" +[[obligation]] +id = "db.functions.match-recognize-next.o020" +kind = "identifier_class" +required = true +target = "" +anchor = "doc.identifiers-syntax" +note = "quoted: a double-quoted identifier with blanks and mixed case" + +[[obligation]] +id = "db.functions.match-recognize-next.o021" +kind = "identifier_class" +required = true +target = "" +anchor = "doc.identifiers-syntax" +note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" + [[obligation]] id = "db.functions.match-recognize-prev.o001" kind = "positive" @@ -21246,11 +21739,11 @@ target = "" note = "omit " [[obligation]] -id = "db.functions.match-recognize-prev.o006" +id = "db.functions.match-recognize-prev.o019" kind = "operand_type_class" required = true target = "" -note = "a valid string_literal" +note = "a valid identifier" [[obligation]] id = "db.functions.match-recognize-prev.o007" @@ -21327,6 +21820,22 @@ target = "" anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" +[[obligation]] +id = "db.functions.match-recognize-prev.o020" +kind = "identifier_class" +required = true +target = "" +anchor = "doc.identifiers-syntax" +note = "quoted: a double-quoted identifier with blanks and mixed case" + +[[obligation]] +id = "db.functions.match-recognize-prev.o021" +kind = "identifier_class" +required = true +target = "" +anchor = "doc.identifiers-syntax" +note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" + [[obligation]] id = "db.functions.max.o001" kind = "positive" @@ -22386,12 +22895,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.monotonically-increasing-id.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.monotonically-increasing-id.o003" kind = "negative_neighbour" @@ -22519,12 +23022,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.named-struct.o002" -kind = "alternative" -required = true -target = "{ , } → , " - [[obligation]] id = "db.functions.named-struct.o003" kind = "required_operand_missing" @@ -22533,11 +23030,11 @@ target = "" note = "omit " [[obligation]] -id = "db.functions.named-struct.o004" +id = "db.functions.named-struct.o013" kind = "operand_type_class" required = true target = "" -note = "a valid identifier" +note = "a valid string_literal" [[obligation]] id = "db.functions.named-struct.o005" @@ -22547,17 +23044,17 @@ target = "" note = "a valid operand" [[obligation]] -id = "db.functions.named-struct.o006" +id = "db.functions.named-struct.o014" kind = "option_present" required = true -target = "[ , ... ]" +target = "[ , , ... ]" note = "the list continued at least once" [[obligation]] -id = "db.functions.named-struct.o007" +id = "db.functions.named-struct.o015" kind = "option_absent" required = true -target = "[ , ... ]" +target = "[ , , ... ]" [[obligation]] id = "db.functions.named-struct.o008" @@ -22571,22 +23068,6 @@ kind = "negative_neighbour" required = true note = "the form without its required )" -[[obligation]] -id = "db.functions.named-struct.o010" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "quoted: a double-quoted identifier with blanks and mixed case" - -[[obligation]] -id = "db.functions.named-struct.o012" -kind = "identifier_class" -required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" - [[obligation]] id = "db.functions.nanvl.o001" kind = "positive" @@ -22742,12 +23223,6 @@ required = true target = " in [ ]" note = "a valid operand" -[[obligation]] -id = "db.functions.now.o005" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.now.o006" kind = "negative_neighbour" @@ -22881,12 +23356,6 @@ required = true target = " in [ ]" note = "a valid integer_literal" -[[obligation]] -id = "db.functions.ntile.o005" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.ntile.o006" kind = "negative_neighbour" @@ -23464,12 +23933,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.percent-rank.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.percent-rank.o003" kind = "negative_neighbour" @@ -23978,12 +24441,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.pi.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.pi.o003" kind = "negative_neighbour" @@ -24044,12 +24501,40 @@ required = true target = "" note = "a valid expression" +[[obligation]] +id = "db.functions.pipesign.syntax.o004" +kind = "required_operand_missing" +required = true +target = "" +note = "omit " + +[[obligation]] +id = "db.functions.pipesign.syntax.o005" +kind = "operand_type_class" +required = true +target = "" +note = "a valid expression" + [[obligation]] id = "db.functions.pipesign.syntax.syntax.o001" kind = "positive" required = true note = "the documented form with every required part and no optional part" +[[obligation]] +id = "db.functions.pipesign.syntax.syntax.o004" +kind = "required_operand_missing" +required = true +target = "" +note = "omit " + +[[obligation]] +id = "db.functions.pipesign.syntax.syntax.o005" +kind = "operand_type_class" +required = true +target = "" +note = "a valid expression" + [[obligation]] id = "db.functions.pipesign.syntax.syntax.o002" kind = "required_operand_missing" @@ -24645,12 +25130,6 @@ required = true target = " in [ ]" note = "a valid operand" -[[obligation]] -id = "db.functions.rand.o005" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.rand.o006" kind = "negative_neighbour" @@ -24682,12 +25161,6 @@ required = true target = " in [ ]" note = "a valid operand" -[[obligation]] -id = "db.functions.randn.o005" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.randn.o006" kind = "negative_neighbour" @@ -24719,12 +25192,6 @@ required = true target = " in [ ]" note = "a valid operand" -[[obligation]] -id = "db.functions.random.o005" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.random.o006" kind = "negative_neighbour" @@ -24886,12 +25353,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.rank.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.rank.o003" kind = "negative_neighbour" @@ -25022,12 +25483,6 @@ kind = "option_absent" required = true target = "[ , ... ]" -[[obligation]] -id = "db.functions.read-kafka.o008" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.read-kafka.o009" kind = "negative_neighbour" @@ -25040,6 +25495,30 @@ kind = "interaction_all_options" required = true note = "every independent option of one production together" +[[obligation]] +id = "db.functions.read-kafka.o017" +kind = "option_absent" +required = true +target = "[ , ... ]" +anchor = "doc.functions.read_kafka / Syntax" +note = "one option pair with the list not continued" + +[[obligation]] +id = "db.functions.read-kafka.o018" +kind = "identifier_class" +required = true +target = "" +anchor = "doc.functions.read_kafka / Syntax" +note = "an option key containing dots as a backtick-quoted identifier, as the page requires" + +[[obligation]] +id = "db.functions.read-kafka.o019" +kind = "operand_type_class" +required = true +target = "" +anchor = "doc.functions.read_kafka / Syntax" +note = "a string literal written where the option key goes" + [[obligation]] id = "db.functions.read-kinesis.o001" kind = "positive" @@ -25644,6 +26123,14 @@ kind = "negative_neighbour" required = true note = "the form without its required )" +[[obligation]] +id = "db.functions.regexp-extract.o011" +kind = "required_operand_missing" +required = true +target = "" +anchor = "doc.functions.regexp_extract / Syntax" +note = "the call with its required regexp left out entirely" + [[obligation]] id = "db.functions.regexp-extract-all.o001" kind = "positive" @@ -26950,36 +27437,50 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.functions.remote-query.o002" +id = "db.functions.remote-query.o013" kind = "operand_type_class" required = true target = "" -note = "a valid identifier" +note = "a valid string_literal" [[obligation]] -id = "db.functions.remote-query.o003" +id = "db.functions.remote-query.o016" kind = "option_present" required = true -target = "[ , connectorOptionKey => ]" +target = "[ , => ]" [[obligation]] -id = "db.functions.remote-query.o004" +id = "db.functions.remote-query.o017" kind = "option_absent" required = true -target = "[ , connectorOptionKey => ]" +target = "[ , => ]" [[obligation]] -id = "db.functions.remote-query.o005" +id = "db.functions.remote-query.o018" kind = "required_operand_missing" required = true -target = " in [ , connectorOptionKey => ]" +target = " in [ , => ]" +note = "omit " + +[[obligation]] +id = "db.functions.remote-query.o019" +kind = "operand_type_class" +required = true +target = " in [ , => ]" +note = "a valid operand" + +[[obligation]] +id = "db.functions.remote-query.o020" +kind = "required_operand_missing" +required = true +target = " in [ , => ]" note = "omit " [[obligation]] -id = "db.functions.remote-query.o006" +id = "db.functions.remote-query.o021" kind = "operand_type_class" required = true -target = " in [ , connectorOptionKey => ]" +target = " in [ , => ]" note = "a valid expression" [[obligation]] @@ -26988,12 +27489,6 @@ kind = "negative_neighbour" required = true note = "the form without its required (" -[[obligation]] -id = "db.functions.remote-query.o008" -kind = "negative_neighbour" -required = true -note = "the form without its required connectorOptionKey in [ , connectorOptionKey => ]" - [[obligation]] id = "db.functions.remote-query.o009" kind = "negative_neighbour" @@ -27001,20 +27496,20 @@ required = true note = "the form without its required )" [[obligation]] -id = "db.functions.remote-query.o010" -kind = "identifier_class" +id = "db.functions.remote-query.o022" +kind = "operand_type_class" required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "quoted: a double-quoted identifier with blanks and mixed case" +target = "" +anchor = "doc.functions.remote_query / Syntax" +note = "a string literal written where the option key goes" [[obligation]] -id = "db.functions.remote-query.o012" +id = "db.functions.remote-query.o023" kind = "identifier_class" required = true -target = "" -anchor = "doc.identifiers-syntax" -note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" +target = "" +anchor = "doc.functions.remote_query / Syntax" +note = "the option key as a backtick-quoted identifier" [[obligation]] id = "db.functions.repeat.o001" @@ -27332,12 +27827,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.row-number.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.row-number.o003" kind = "negative_neighbour" @@ -28175,16 +28664,22 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.functions.session-user.o002" -kind = "negative_neighbour" +id = "db.functions.session-user.o004" +kind = "option_present" required = true -note = "the form without its required (" +target = "[ ( ) ]" + +[[obligation]] +id = "db.functions.session-user.o005" +kind = "option_absent" +required = true +target = "[ ( ) ]" [[obligation]] -id = "db.functions.session-user.o003" +id = "db.functions.session-user.o006" kind = "negative_neighbour" required = true -note = "the form without its required )" +note = "the form without its required ) in [ ( ) ]" [[obligation]] id = "db.functions.session-window.o001" @@ -29010,12 +29505,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.spark-partition.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.spark-partition.o003" kind = "negative_neighbour" @@ -29087,6 +29576,14 @@ kind = "negative_neighbour" required = true note = "the form without its required )" +[[obligation]] +id = "db.functions.split.o011" +kind = "required_operand_missing" +required = true +target = "" +anchor = "doc.functions.split / Syntax" +note = "the call without its required regex" + [[obligation]] id = "db.functions.split-part.o001" kind = "positive" @@ -29153,12 +29650,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.sql-keywords.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.sql-keywords.o003" kind = "negative_neighbour" @@ -33432,74 +33923,84 @@ target = " in [ , ]" note = "a valid operand" [[obligation]] -id = "db.functions.string-agg.o011" +id = "db.functions.string-agg.o040" kind = "option_present" required = true -target = "[ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +target = "[ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" [[obligation]] -id = "db.functions.string-agg.o012" +id = "db.functions.string-agg.o041" kind = "option_absent" required = true -target = "[ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +target = "[ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" [[obligation]] -id = "db.functions.string-agg.o013" +id = "db.functions.string-agg.o042" kind = "alternative" required = true -target = "{ [ ] [ ] } → [ ] [ ]" +target = "{ [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } → [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ]" [[obligation]] -id = "db.functions.string-agg.o014" +id = "db.functions.string-agg.o043" kind = "required_operand_missing" required = true -target = " in [ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +target = " in [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" note = "omit " [[obligation]] -id = "db.functions.string-agg.o015" +id = "db.functions.string-agg.o044" kind = "operand_type_class" required = true -target = " in [ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +target = " in [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" note = "a valid operand" [[obligation]] -id = "db.functions.string-agg.o016" +id = "db.functions.string-agg.o045" kind = "option_present" required = true -target = "[ ]" +target = "[ ASC | DESC ]" [[obligation]] -id = "db.functions.string-agg.o017" +id = "db.functions.string-agg.o046" kind = "option_absent" required = true -target = "[ ]" +target = "[ ASC | DESC ]" [[obligation]] -id = "db.functions.string-agg.o018" -kind = "operand_type_class" +id = "db.functions.string-agg.o047" +kind = "alternative" required = true -target = " in [ ]" -note = "a valid operand" +target = "[ ASC | DESC ] → ASC" [[obligation]] -id = "db.functions.string-agg.o019" +id = "db.functions.string-agg.o048" +kind = "alternative" +required = true +target = "[ ASC | DESC ] → DESC" + +[[obligation]] +id = "db.functions.string-agg.o049" kind = "option_present" required = true -target = "[ ]" +target = "[ NULLS FIRST | NULLS LAST ]" [[obligation]] -id = "db.functions.string-agg.o020" +id = "db.functions.string-agg.o050" kind = "option_absent" required = true -target = "[ ]" +target = "[ NULLS FIRST | NULLS LAST ]" [[obligation]] -id = "db.functions.string-agg.o021" -kind = "operand_type_class" +id = "db.functions.string-agg.o051" +kind = "alternative" required = true -target = " in [ ]" -note = "a valid operand" +target = "[ NULLS FIRST | NULLS LAST ] → NULLS FIRST" + +[[obligation]] +id = "db.functions.string-agg.o052" +kind = "alternative" +required = true +target = "[ NULLS FIRST | NULLS LAST ] → NULLS LAST" [[obligation]] id = "db.functions.string-agg.o022" @@ -33553,40 +34054,52 @@ required = true note = "the form without its required )" [[obligation]] -id = "db.functions.string-agg.o030" +id = "db.functions.string-agg.o053" +kind = "negative_neighbour" +required = true +note = "the form without its required GROUP in [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" + +[[obligation]] +id = "db.functions.string-agg.o054" +kind = "negative_neighbour" +required = true +note = "the form without its required ( in [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" + +[[obligation]] +id = "db.functions.string-agg.o055" kind = "negative_neighbour" required = true -note = "the form without its required GROUP in [ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +note = "the form without its required ORDER in [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" [[obligation]] -id = "db.functions.string-agg.o031" +id = "db.functions.string-agg.o056" kind = "negative_neighbour" required = true -note = "the form without its required ( in [ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +note = "the form without its required BY in [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" [[obligation]] -id = "db.functions.string-agg.o032" +id = "db.functions.string-agg.o057" kind = "negative_neighbour" required = true -note = "the form without its required ORDER in [ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +note = "the form without its required FIRST in [ NULLS FIRST | NULLS LAST ]" [[obligation]] -id = "db.functions.string-agg.o033" +id = "db.functions.string-agg.o058" kind = "negative_neighbour" required = true -note = "the form without its required BY in [ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +note = "the form without its required LAST in [ NULLS FIRST | NULLS LAST ]" [[obligation]] -id = "db.functions.string-agg.o034" +id = "db.functions.string-agg.o059" kind = "negative_neighbour" required = true -note = "the form without its required { [ ] [ ] } in [ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +note = "the form without its required { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } in [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" [[obligation]] -id = "db.functions.string-agg.o035" +id = "db.functions.string-agg.o060" kind = "negative_neighbour" required = true -note = "the form without its required ) in [ WITHIN GROUP ( ORDER BY { [ ] [ ] } [ , ... ] ) ]" +note = "the form without its required ) in [ WITHIN GROUP ( ORDER BY { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] ) ]" [[obligation]] id = "db.functions.string-agg.o036" @@ -34155,6 +34668,14 @@ kind = "interaction_all_options" required = true note = "every independent option of one production together" +[[obligation]] +id = "db.functions.sum.o017" +kind = "required_operand_missing" +required = true +target = "" +anchor = "doc.functions.sum / Syntax" +note = "the call with its only argument left out" + [[obligation]] id = "db.functions.table-changes.o001" kind = "positive" @@ -34696,18 +35217,34 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.functions.time-diff.o002" -kind = "required_operand_missing" +id = "db.functions.time-diff.o010" +kind = "alternative" required = true -target = "" -note = "omit " +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR } → MICROSECOND" [[obligation]] -id = "db.functions.time-diff.o003" -kind = "operand_type_class" +id = "db.functions.time-diff.o011" +kind = "alternative" required = true -target = "" -note = "a valid operand" +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR } → MILLISECOND" + +[[obligation]] +id = "db.functions.time-diff.o012" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR } → SECOND" + +[[obligation]] +id = "db.functions.time-diff.o013" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR } → MINUTE" + +[[obligation]] +id = "db.functions.time-diff.o014" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR } → HOUR" [[obligation]] id = "db.functions.time-diff.o004" @@ -34743,12 +35280,34 @@ kind = "negative_neighbour" required = true note = "the form without its required (" +[[obligation]] +id = "db.functions.time-diff.o015" +kind = "negative_neighbour" +required = true +note = "the form without its required { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR }" + [[obligation]] id = "db.functions.time-diff.o009" kind = "negative_neighbour" required = true note = "the form without its required )" +[[obligation]] +id = "db.functions.time-diff.o016" +kind = "operand_type_class" +required = true +target = "" +anchor = "doc.functions.time_diff / Syntax" +note = "the unit written as a quoted string rather than its keyword, recorded to show how the warehouse reads it" + +[[obligation]] +id = "db.functions.time-diff.o017" +kind = "operand_type_class" +required = true +target = "" +anchor = "doc.functions.time_diff / Syntax" +note = "a unit keyword the page does not list for this function" + [[obligation]] id = "db.functions.time-from-micros.o001" kind = "positive" @@ -34952,18 +35511,64 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.functions.timediff.o002" -kind = "required_operand_missing" +id = "db.functions.timediff.o010" +kind = "alternative" required = true -target = "" -note = "omit " +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → MICROSECOND" [[obligation]] -id = "db.functions.timediff.o003" -kind = "operand_type_class" +id = "db.functions.timediff.o011" +kind = "alternative" required = true -target = "" -note = "a valid operand" +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → MILLISECOND" + +[[obligation]] +id = "db.functions.timediff.o012" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → SECOND" + +[[obligation]] +id = "db.functions.timediff.o013" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → MINUTE" + +[[obligation]] +id = "db.functions.timediff.o014" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → HOUR" + +[[obligation]] +id = "db.functions.timediff.o015" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → DAY" + +[[obligation]] +id = "db.functions.timediff.o016" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → WEEK" + +[[obligation]] +id = "db.functions.timediff.o017" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → MONTH" + +[[obligation]] +id = "db.functions.timediff.o018" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → QUARTER" + +[[obligation]] +id = "db.functions.timediff.o019" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → YEAR" [[obligation]] id = "db.functions.timediff.o004" @@ -34999,12 +35604,26 @@ kind = "negative_neighbour" required = true note = "the form without its required (" +[[obligation]] +id = "db.functions.timediff.o020" +kind = "negative_neighbour" +required = true +note = "the form without its required { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR }" + [[obligation]] id = "db.functions.timediff.o009" kind = "negative_neighbour" required = true note = "the form without its required )" +[[obligation]] +id = "db.functions.timediff.o021" +kind = "operand_type_class" +required = true +target = "" +anchor = "doc.functions.timediff / Syntax" +note = "the unit written as a quoted string rather than its keyword, recorded to show how the warehouse reads it" + [[obligation]] id = "db.functions.timestamp.o001" kind = "positive" @@ -35137,18 +35756,70 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.functions.timestampadd.o002" -kind = "required_operand_missing" +id = "db.functions.timestampadd.o010" +kind = "alternative" required = true -target = "" -note = "omit " +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → MICROSECOND" [[obligation]] -id = "db.functions.timestampadd.o003" -kind = "operand_type_class" +id = "db.functions.timestampadd.o011" +kind = "alternative" required = true -target = "" -note = "a valid operand" +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → MILLISECOND" + +[[obligation]] +id = "db.functions.timestampadd.o012" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → SECOND" + +[[obligation]] +id = "db.functions.timestampadd.o013" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → MINUTE" + +[[obligation]] +id = "db.functions.timestampadd.o014" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → HOUR" + +[[obligation]] +id = "db.functions.timestampadd.o015" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → DAY" + +[[obligation]] +id = "db.functions.timestampadd.o016" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → DAYOFYEAR" + +[[obligation]] +id = "db.functions.timestampadd.o017" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → WEEK" + +[[obligation]] +id = "db.functions.timestampadd.o018" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → MONTH" + +[[obligation]] +id = "db.functions.timestampadd.o019" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → QUARTER" + +[[obligation]] +id = "db.functions.timestampadd.o020" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR } → YEAR" [[obligation]] id = "db.functions.timestampadd.o004" @@ -35184,12 +35855,26 @@ kind = "negative_neighbour" required = true note = "the form without its required (" +[[obligation]] +id = "db.functions.timestampadd.o021" +kind = "negative_neighbour" +required = true +note = "the form without its required { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | DAYOFYEAR | WEEK | MONTH | QUARTER | YEAR }" + [[obligation]] id = "db.functions.timestampadd.o009" kind = "negative_neighbour" required = true note = "the form without its required )" +[[obligation]] +id = "db.functions.timestampadd.o022" +kind = "operand_type_class" +required = true +target = "" +anchor = "doc.functions.timestampadd / Syntax" +note = "the unit written as a quoted string rather than its keyword, recorded to show how the warehouse reads it" + [[obligation]] id = "db.functions.timestampdiff.o001" kind = "positive" @@ -35197,18 +35882,64 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.functions.timestampdiff.o002" -kind = "required_operand_missing" +id = "db.functions.timestampdiff.o010" +kind = "alternative" required = true -target = "" -note = "omit " +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → MICROSECOND" [[obligation]] -id = "db.functions.timestampdiff.o003" -kind = "operand_type_class" +id = "db.functions.timestampdiff.o011" +kind = "alternative" required = true -target = "" -note = "a valid operand" +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → MILLISECOND" + +[[obligation]] +id = "db.functions.timestampdiff.o012" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → SECOND" + +[[obligation]] +id = "db.functions.timestampdiff.o013" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → MINUTE" + +[[obligation]] +id = "db.functions.timestampdiff.o014" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → HOUR" + +[[obligation]] +id = "db.functions.timestampdiff.o015" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → DAY" + +[[obligation]] +id = "db.functions.timestampdiff.o016" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → WEEK" + +[[obligation]] +id = "db.functions.timestampdiff.o017" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → MONTH" + +[[obligation]] +id = "db.functions.timestampdiff.o018" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → QUARTER" + +[[obligation]] +id = "db.functions.timestampdiff.o019" +kind = "alternative" +required = true +target = "{ MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR } → YEAR" [[obligation]] id = "db.functions.timestampdiff.o004" @@ -35244,12 +35975,26 @@ kind = "negative_neighbour" required = true note = "the form without its required (" +[[obligation]] +id = "db.functions.timestampdiff.o020" +kind = "negative_neighbour" +required = true +note = "the form without its required { MICROSECOND | MILLISECOND | SECOND | MINUTE | HOUR | DAY | WEEK | MONTH | QUARTER | YEAR }" + [[obligation]] id = "db.functions.timestampdiff.o009" kind = "negative_neighbour" required = true note = "the form without its required )" +[[obligation]] +id = "db.functions.timestampdiff.o021" +kind = "operand_type_class" +required = true +target = "" +anchor = "doc.functions.timestampdiff / Syntax" +note = "the unit written as a quoted string rather than its keyword, recorded to show how the warehouse reads it" + [[obligation]] id = "db.functions.tinyint.o001" kind = "positive" @@ -35416,18 +36161,18 @@ required = true target = "{ | | } → " [[obligation]] -id = "db.functions.to-char.o007" +id = "db.functions.to-char.o013" kind = "operand_type_class" required = true target = "" -note = "a valid integer_literal" +note = "a valid string_literal" [[obligation]] -id = "db.functions.to-char.o008" +id = "db.functions.to-char.o014" kind = "operand_type_class" required = true target = "" -note = "a valid operand" +note = "a valid string_literal" [[obligation]] id = "db.functions.to-char.o009" @@ -36217,18 +36962,18 @@ required = true target = "{ | | } → " [[obligation]] -id = "db.functions.to-varchar.o007" +id = "db.functions.to-varchar.o013" kind = "operand_type_class" required = true target = "" -note = "a valid integer_literal" +note = "a valid string_literal" [[obligation]] -id = "db.functions.to-varchar.o008" +id = "db.functions.to-varchar.o014" kind = "operand_type_class" required = true target = "" -note = "a valid operand" +note = "a valid string_literal" [[obligation]] id = "db.functions.to-varchar.o009" @@ -39067,11 +39812,11 @@ target = "" note = "omit " [[obligation]] -id = "db.functions.try-variant-get.o007" +id = "db.functions.try-variant-get.o010" kind = "operand_type_class" required = true target = "" -note = "a valid data_type" +note = "a valid string_literal" [[obligation]] id = "db.functions.try-variant-get.o008" @@ -40899,12 +41644,6 @@ required = true target = " in [ , ]" note = "a valid operand" -[[obligation]] -id = "db.functions.unix-timestamp.o009" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.unix-timestamp.o010" kind = "negative_neighbour" @@ -40993,16 +41732,22 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.functions.user.o002" -kind = "negative_neighbour" +id = "db.functions.user.o004" +kind = "option_present" required = true -note = "the form without its required (" +target = "[ ( ) ]" [[obligation]] -id = "db.functions.user.o003" +id = "db.functions.user.o005" +kind = "option_absent" +required = true +target = "[ ( ) ]" + +[[obligation]] +id = "db.functions.user.o006" kind = "negative_neighbour" required = true -note = "the form without its required )" +note = "the form without its required ) in [ ( ) ]" [[obligation]] id = "db.functions.uuid.o001" @@ -41010,12 +41755,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.uuid.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.uuid.o003" kind = "negative_neighbour" @@ -41436,11 +42175,11 @@ target = "" note = "omit " [[obligation]] -id = "db.functions.variant-get.o007" +id = "db.functions.variant-get.o010" kind = "operand_type_class" required = true target = "" -note = "a valid data_type" +note = "a valid string_literal" [[obligation]] id = "db.functions.variant-get.o008" @@ -41764,168 +42503,225 @@ required = true note = "the form without its required )" [[obligation]] -id = "db.functions.vector-search.vector-search.o001" +id = "db.functions.vector-search.query-num-results.o001" kind = "positive" required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.functions.vector-search.vector-search.o002" +id = "db.functions.vector-search.query-num-results.o002" kind = "required_operand_missing" required = true target = "" note = "omit " [[obligation]] -id = "db.functions.vector-search.vector-search.o003" +id = "db.functions.vector-search.query-num-results.o003" kind = "operand_type_class" required = true target = "" -note = "a valid operand" - -[[obligation]] -id = "db.functions.vector-search.vector-search.o004" -kind = "alternative" -required = true -target = "{ | } → " +note = "a valid string_literal" [[obligation]] -id = "db.functions.vector-search.vector-search.o005" -kind = "alternative" +id = "db.functions.vector-search.query-num-results.o004" +kind = "required_operand_missing" required = true -target = "{ | } → " +target = "" +note = "omit " [[obligation]] -id = "db.functions.vector-search.vector-search.o006" +id = "db.functions.vector-search.query-num-results.o005" kind = "operand_type_class" required = true -target = "" +target = "" note = "a valid operand" [[obligation]] -id = "db.functions.vector-search.vector-search.o007" -kind = "operand_type_class" +id = "db.functions.vector-search.query-num-results.o006" +kind = "required_operand_missing" required = true -target = "" -note = "a valid operand" +target = "" +note = "omit " [[obligation]] -id = "db.functions.vector-search.vector-search.o008" -kind = "option_present" +id = "db.functions.vector-search.query-num-results.o007" +kind = "operand_type_class" required = true -target = "[ ]" +target = "" +note = "a valid integer_literal" [[obligation]] -id = "db.functions.vector-search.vector-search.o009" -kind = "option_absent" +id = "db.functions.vector-search.query-num-results.o008" +kind = "negative_neighbour" required = true -target = "[ ]" +note = "the form without its required FROM" [[obligation]] -id = "db.functions.vector-search.vector-search.o010" -kind = "operand_type_class" +id = "db.functions.vector-search.query-num-results.o009" +kind = "negative_neighbour" required = true -target = " in [ ]" -note = "a valid integer_literal" +note = "the form without its required VECTOR_SEARCH" [[obligation]] -id = "db.functions.vector-search.vector-search.o011" +id = "db.functions.vector-search.query-num-results.o010" kind = "negative_neighbour" required = true -note = "the form without its required FROM" +note = "the form without its required (" [[obligation]] -id = "db.functions.vector-search.vector-search.o012" +id = "db.functions.vector-search.query-num-results.o011" kind = "negative_neighbour" required = true -note = "the form without its required VECTOR_SEARCH" +note = "the form without its required index" [[obligation]] -id = "db.functions.vector-search.vector-search.o013" +id = "db.functions.vector-search.query-num-results.o012" kind = "negative_neighbour" required = true -note = "the form without its required (" +note = "the form without its required query" [[obligation]] -id = "db.functions.vector-search.vector-search.o014" +id = "db.functions.vector-search.query-num-results.o013" kind = "negative_neighbour" required = true -note = "the form without its required { | }" +note = "the form without its required num_results" [[obligation]] -id = "db.functions.vector-search.vector-search.o015" +id = "db.functions.vector-search.query-num-results.o014" kind = "negative_neighbour" required = true note = "the form without its required )" [[obligation]] -id = "db.functions.vector-search.vector-search-2.o001" +id = "db.functions.vector-search.query-text-query-vector.o001" kind = "positive" required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.functions.vector-search.vector-search-2.o002" +id = "db.functions.vector-search.query-text-query-vector.o002" kind = "required_operand_missing" required = true target = "" note = "omit " [[obligation]] -id = "db.functions.vector-search.vector-search-2.o003" +id = "db.functions.vector-search.query-text-query-vector.o003" kind = "operand_type_class" required = true target = "" +note = "a valid string_literal" + +[[obligation]] +id = "db.functions.vector-search.query-text-query-vector.o004" +kind = "alternative" +required = true +target = "{ query_text => | query_vector => } → query_text => " + +[[obligation]] +id = "db.functions.vector-search.query-text-query-vector.o005" +kind = "alternative" +required = true +target = "{ query_text => | query_vector => } → query_vector => " + +[[obligation]] +id = "db.functions.vector-search.query-text-query-vector.o006" +kind = "required_operand_missing" +required = true +target = "" +note = "omit " + +[[obligation]] +id = "db.functions.vector-search.query-text-query-vector.o007" +kind = "operand_type_class" +required = true +target = "" note = "a valid operand" [[obligation]] -id = "db.functions.vector-search.vector-search-2.o004" +id = "db.functions.vector-search.query-text-query-vector.o008" kind = "required_operand_missing" required = true -target = "" -note = "omit " +target = "" +note = "omit " [[obligation]] -id = "db.functions.vector-search.vector-search-2.o005" +id = "db.functions.vector-search.query-text-query-vector.o009" kind = "operand_type_class" required = true -target = "" +target = "" note = "a valid operand" [[obligation]] -id = "db.functions.vector-search.vector-search-2.o006" +id = "db.functions.vector-search.query-text-query-vector.o010" +kind = "option_present" +required = true +target = "[ , num_results => ]" + +[[obligation]] +id = "db.functions.vector-search.query-text-query-vector.o011" +kind = "option_absent" +required = true +target = "[ , num_results => ]" + +[[obligation]] +id = "db.functions.vector-search.query-text-query-vector.o012" kind = "required_operand_missing" required = true -target = "" +target = " in [ , num_results => ]" note = "omit " [[obligation]] -id = "db.functions.vector-search.vector-search-2.o007" +id = "db.functions.vector-search.query-text-query-vector.o013" kind = "operand_type_class" required = true -target = "" +target = " in [ , num_results => ]" note = "a valid integer_literal" [[obligation]] -id = "db.functions.vector-search.vector-search-2.o008" +id = "db.functions.vector-search.query-text-query-vector.o014" kind = "negative_neighbour" required = true note = "the form without its required FROM" [[obligation]] -id = "db.functions.vector-search.vector-search-2.o009" +id = "db.functions.vector-search.query-text-query-vector.o015" kind = "negative_neighbour" required = true note = "the form without its required VECTOR_SEARCH" [[obligation]] -id = "db.functions.vector-search.vector-search-2.o010" +id = "db.functions.vector-search.query-text-query-vector.o016" kind = "negative_neighbour" required = true note = "the form without its required (" [[obligation]] -id = "db.functions.vector-search.vector-search-2.o011" +id = "db.functions.vector-search.query-text-query-vector.o017" +kind = "negative_neighbour" +required = true +note = "the form without its required index" + +[[obligation]] +id = "db.functions.vector-search.query-text-query-vector.o018" +kind = "negative_neighbour" +required = true +note = "the form without its required query_text after ," + +[[obligation]] +id = "db.functions.vector-search.query-text-query-vector.o019" +kind = "negative_neighbour" +required = true +note = "the form without its required query_vector after ," + +[[obligation]] +id = "db.functions.vector-search.query-text-query-vector.o020" +kind = "negative_neighbour" +required = true +note = "the form without its required num_results in [ , num_results => ]" + +[[obligation]] +id = "db.functions.vector-search.query-text-query-vector.o021" kind = "negative_neighbour" required = true note = "the form without its required )" @@ -42005,12 +42801,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.functions.version.o002" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.functions.version.o003" kind = "negative_neighbour" diff --git a/coverage/syntax-databricks/obligations/query.toml b/coverage/syntax-databricks/obligations/query.toml index f0602ab9d..f37a8b614 100644 --- a/coverage/syntax-databricks/obligations/query.toml +++ b/coverage/syntax-databricks/obligations/query.toml @@ -479,6 +479,14 @@ target = "|> after ORDER BY" anchor = "doc.sql-ref-syntax-qry-query / Syntax" note = "a pipe operation after ORDER BY, in the page's order, which the warehouse refuses" +[[obligation]] +id = "db.query.query.o056" +kind = "option_present" +required = true +target = "DISTRIBUTE BY" +anchor = "doc.sql-ref-syntax-qry-query / Syntax" +note = "the DISTRIBUTE BY and SORT BY branch taken" + [[obligation]] id = "db.query.select.o001" kind = "positive" @@ -1522,12 +1530,6 @@ kind = "negative_neighbour" required = true note = "the form without its required { BROADCASTJOIN | MAPJOIN | SHUFFLE_MERGE | MERGEJOIN }" -[[obligation]] -id = "db.query.select-hints.join-hint-alias.o009" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.query.select-hints.join-hint-alias.o010" kind = "negative_neighbour" @@ -1550,6 +1552,14 @@ target = "" anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" +[[obligation]] +id = "db.query.select-hints.join-hint-alias.o013" +kind = "negative_neighbour" +required = true +target = "the form without its required (" +anchor = "doc.sql-ref-syntax-qry-select-hints / Syntax" +note = "the form without its required (; the warehouse parses the text, so its answer is recorded rather than expected" + [[obligation]] id = "db.query.select-join.o001" kind = "positive" @@ -1854,6 +1864,14 @@ target = "" anchor = "doc.identifiers-syntax" note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" +[[obligation]] +id = "db.query.select-lateral-view.o032" +kind = "option_absent" +required = true +target = "AS" +anchor = "doc.sql-ref-syntax-qry-select-lateral-view / Syntax" +note = "the column alias written without AS" + [[obligation]] id = "db.query.select-limit.o001" kind = "positive" @@ -1989,18 +2007,18 @@ required = true target = "[ ]" [[obligation]] -id = "db.query.select-match-recognize.o018" +id = "db.query.select-match-recognize.o041" kind = "operand_type_class" required = true target = " in [ ]" -note = "a valid string_literal" +note = "a valid word" [[obligation]] -id = "db.query.select-match-recognize.o019" +id = "db.query.select-match-recognize.o042" kind = "negative_neighbour" required = true target = " in [ ]" -note = "an unquoted identifier in place of " +note = "a string literal in place of " [[obligation]] id = "db.query.select-match-recognize.o020" @@ -2022,18 +2040,18 @@ target = " in [ AFTER MATCH ]" note = "omit " [[obligation]] -id = "db.query.select-match-recognize.o023" +id = "db.query.select-match-recognize.o043" kind = "operand_type_class" required = true target = " in [ AFTER MATCH ]" -note = "a valid string_literal" +note = "a valid word" [[obligation]] -id = "db.query.select-match-recognize.o024" +id = "db.query.select-match-recognize.o044" kind = "negative_neighbour" required = true target = " in [ AFTER MATCH ]" -note = "an unquoted identifier in place of " +note = "a string literal in place of " [[obligation]] id = "db.query.select-match-recognize.o025" @@ -2043,18 +2061,18 @@ target = "" note = "omit " [[obligation]] -id = "db.query.select-match-recognize.o026" +id = "db.query.select-match-recognize.o045" kind = "operand_type_class" required = true target = "" -note = "a valid string_literal" +note = "a valid word" [[obligation]] -id = "db.query.select-match-recognize.o027" +id = "db.query.select-match-recognize.o046" kind = "negative_neighbour" required = true target = "" -note = "an unquoted identifier in place of " +note = "a string literal in place of " [[obligation]] id = "db.query.select-match-recognize.o028" @@ -2137,6 +2155,22 @@ kind = "interaction_all_options" required = true note = "every independent option of one production together" +[[obligation]] +id = "db.query.select-match-recognize.o047" +kind = "alternative" +required = true +target = "" +anchor = "doc.sql-ref-syntax-qry-select-match-recognize / Syntax" +note = "ALL ROWS PER MATCH" + +[[obligation]] +id = "db.query.select-match-recognize.o048" +kind = "alternative" +required = true +target = "" +anchor = "doc.sql-ref-syntax-qry-select-match-recognize / Syntax" +note = "ALL ROWS PER MATCH SHOW EMPTY MATCHES" + [[obligation]] id = "db.query.select-match-recognize-define.o001" kind = "positive" @@ -2157,18 +2191,18 @@ target = "" note = "omit " [[obligation]] -id = "db.query.select-match-recognize-define.o004" +id = "db.query.select-match-recognize-define.o012" kind = "operand_type_class" required = true target = "" -note = "a valid string_literal" +note = "a valid identifier" [[obligation]] -id = "db.query.select-match-recognize-define.o005" +id = "db.query.select-match-recognize-define.o013" kind = "negative_neighbour" required = true target = "" -note = "an unquoted identifier in place of " +note = "a string literal in place of " [[obligation]] id = "db.query.select-match-recognize-define.o006" @@ -2209,6 +2243,22 @@ kind = "negative_neighbour" required = true note = "the form without its required { AS }" +[[obligation]] +id = "db.query.select-match-recognize-define.o014" +kind = "identifier_class" +required = true +target = "" +anchor = "doc.identifiers-syntax" +note = "quoted: a double-quoted identifier with blanks and mixed case" + +[[obligation]] +id = "db.query.select-match-recognize-define.o015" +kind = "identifier_class" +required = true +target = "" +anchor = "doc.identifiers-syntax" +note = "keyword: the SQL keyword SELECT, which the reserved-words page does not disallow as an identifier, unquoted and in backticks (both expected acceptance)" + [[obligation]] id = "db.query.select-match-recognize-measures.o001" kind = "positive" @@ -2288,18 +2338,18 @@ target = "" note = "omit " [[obligation]] -id = "db.query.select-match-recognize-pattern.o003" +id = "db.query.select-match-recognize-pattern.o007" kind = "operand_type_class" required = true target = "" -note = "a valid string_literal" +note = "a valid word" [[obligation]] -id = "db.query.select-match-recognize-pattern.o004" +id = "db.query.select-match-recognize-pattern.o008" kind = "negative_neighbour" required = true target = "" -note = "an unquoted identifier in place of " +note = "a string literal in place of " [[obligation]] id = "db.query.select-match-recognize-pattern.o005" @@ -2313,6 +2363,38 @@ kind = "negative_neighbour" required = true note = "the form without its required )" +[[obligation]] +id = "db.query.select-match-recognize-pattern.o009" +kind = "alternative" +required = true +target = "" +anchor = "doc.sql-ref-syntax-qry-select-match-recognize-pattern / Syntax" +note = "quantified pattern variables" + +[[obligation]] +id = "db.query.select-match-recognize-pattern.o010" +kind = "alternative" +required = true +target = "" +anchor = "doc.sql-ref-syntax-qry-select-match-recognize-pattern / Syntax" +note = "an alternation of pattern variables" + +[[obligation]] +id = "db.query.select-match-recognize-pattern.o011" +kind = "alternative" +required = true +target = "" +anchor = "doc.sql-ref-syntax-qry-select-match-recognize-pattern / Syntax" +note = "PERMUTE of pattern variables" + +[[obligation]] +id = "db.query.select-match-recognize-pattern.o012" +kind = "alternative" +required = true +target = "" +anchor = "doc.sql-ref-syntax-qry-select-match-recognize-pattern / Syntax" +note = "anchors and a bounded quantifier" + [[obligation]] id = "db.query.select-named-window.o001" kind = "positive" @@ -2571,66 +2653,76 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.query.select-orderby.o002" +id = "db.query.select-orderby.o026" kind = "alternative" required = true -target = "{ { ALL [ ] [ ] } | {… → { ALL [ ] [ ] }" +target = "{ { ALL [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } | {… → { ALL [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] }" [[obligation]] -id = "db.query.select-orderby.o003" +id = "db.query.select-orderby.o027" kind = "alternative" required = true -target = "{ { ALL [ ] [ ] } | {… → { [ ] [ ] } [ , ... ]" +target = "{ { ALL [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } | {… → { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ]" [[obligation]] -id = "db.query.select-orderby.o004" +id = "db.query.select-orderby.o028" kind = "alternative" required = true -target = "{ ALL [ ] [ ] } → ALL [ ] [ ]" +target = "{ ALL [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } → ALL [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ]" [[obligation]] -id = "db.query.select-orderby.o005" +id = "db.query.select-orderby.o029" kind = "option_present" required = true -target = "[ ]" +target = "[ ASC | DESC ]" [[obligation]] -id = "db.query.select-orderby.o006" +id = "db.query.select-orderby.o030" kind = "option_absent" required = true -target = "[ ]" +target = "[ ASC | DESC ]" [[obligation]] -id = "db.query.select-orderby.o007" -kind = "operand_type_class" +id = "db.query.select-orderby.o031" +kind = "alternative" required = true -target = " in [ ]" -note = "a valid operand" +target = "[ ASC | DESC ] → ASC" [[obligation]] -id = "db.query.select-orderby.o008" +id = "db.query.select-orderby.o032" +kind = "alternative" +required = true +target = "[ ASC | DESC ] → DESC" + +[[obligation]] +id = "db.query.select-orderby.o033" kind = "option_present" required = true -target = "[ ]" +target = "[ NULLS FIRST | NULLS LAST ]" [[obligation]] -id = "db.query.select-orderby.o009" +id = "db.query.select-orderby.o034" kind = "option_absent" required = true -target = "[ ]" +target = "[ NULLS FIRST | NULLS LAST ]" [[obligation]] -id = "db.query.select-orderby.o010" -kind = "operand_type_class" +id = "db.query.select-orderby.o035" +kind = "alternative" required = true -target = " in [ ]" -note = "a valid operand" +target = "[ NULLS FIRST | NULLS LAST ] → NULLS FIRST" + +[[obligation]] +id = "db.query.select-orderby.o036" +kind = "alternative" +required = true +target = "[ NULLS FIRST | NULLS LAST ] → NULLS LAST" [[obligation]] -id = "db.query.select-orderby.o011" +id = "db.query.select-orderby.o037" kind = "alternative" required = true -target = "{ [ ] [ ] } → [ ] [ ]" +target = "{ [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } → [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ]" [[obligation]] id = "db.query.select-orderby.o012" @@ -2647,42 +2739,52 @@ target = "" note = "a valid expression" [[obligation]] -id = "db.query.select-orderby.o014" +id = "db.query.select-orderby.o038" kind = "option_present" required = true -target = "[ ] #2" +target = "[ ASC | DESC ] #2" [[obligation]] -id = "db.query.select-orderby.o015" +id = "db.query.select-orderby.o039" kind = "option_absent" required = true -target = "[ ] #2" +target = "[ ASC | DESC ] #2" [[obligation]] -id = "db.query.select-orderby.o016" -kind = "operand_type_class" +id = "db.query.select-orderby.o040" +kind = "alternative" required = true -target = " in [ ] #2" -note = "a valid operand" +target = "[ ASC | DESC ] → ASC #2" + +[[obligation]] +id = "db.query.select-orderby.o041" +kind = "alternative" +required = true +target = "[ ASC | DESC ] → DESC #2" [[obligation]] -id = "db.query.select-orderby.o017" +id = "db.query.select-orderby.o042" kind = "option_present" required = true -target = "[ ] #2" +target = "[ NULLS FIRST | NULLS LAST ] #2" [[obligation]] -id = "db.query.select-orderby.o018" +id = "db.query.select-orderby.o043" kind = "option_absent" required = true -target = "[ ] #2" +target = "[ NULLS FIRST | NULLS LAST ] #2" [[obligation]] -id = "db.query.select-orderby.o019" -kind = "operand_type_class" +id = "db.query.select-orderby.o044" +kind = "alternative" required = true -target = " in [ ] #2" -note = "a valid operand" +target = "[ NULLS FIRST | NULLS LAST ] → NULLS FIRST #2" + +[[obligation]] +id = "db.query.select-orderby.o045" +kind = "alternative" +required = true +target = "[ NULLS FIRST | NULLS LAST ] → NULLS LAST #2" [[obligation]] id = "db.query.select-orderby.o020" @@ -2710,10 +2812,34 @@ required = true note = "the form without its required ALL after BY" [[obligation]] -id = "db.query.select-orderby.o024" +id = "db.query.select-orderby.o046" +kind = "negative_neighbour" +required = true +note = "the form without its required FIRST in [ NULLS FIRST | NULLS LAST ]" + +[[obligation]] +id = "db.query.select-orderby.o047" +kind = "negative_neighbour" +required = true +note = "the form without its required LAST in [ NULLS FIRST | NULLS LAST ]" + +[[obligation]] +id = "db.query.select-orderby.o048" +kind = "negative_neighbour" +required = true +note = "the form without its required FIRST in [ NULLS FIRST | NULLS LAST ] #2" + +[[obligation]] +id = "db.query.select-orderby.o049" +kind = "negative_neighbour" +required = true +note = "the form without its required LAST in [ NULLS FIRST | NULLS LAST ] #2" + +[[obligation]] +id = "db.query.select-orderby.o050" kind = "negative_neighbour" required = true -note = "the form without its required { { ALL [ ] [ ] } | { [ ] [ ] } [ , ... ] }" +note = "the form without its required { { ALL [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } | { [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] } [ , ... ] }" [[obligation]] id = "db.query.select-orderby.o025" @@ -3928,10 +4054,10 @@ required = true note = "the documented form with every required part and no optional part" [[obligation]] -id = "db.query.select-sortby.o002" +id = "db.query.select-sortby.o015" kind = "alternative" required = true -target = "{ [ ] } → [ ]" +target = "{ [ [ ASC | DESC ] [ NULLS FIRST | NULLS LAST… → [ [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] ]" [[obligation]] id = "db.query.select-sortby.o003" @@ -3948,30 +4074,64 @@ target = "" note = "a valid expression" [[obligation]] -id = "db.query.select-sortby.o005" +id = "db.query.select-sortby.o016" kind = "option_present" required = true -target = "[ ]" +target = "[ [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] ]" [[obligation]] -id = "db.query.select-sortby.o006" +id = "db.query.select-sortby.o017" kind = "option_absent" required = true -target = "[ ]" +target = "[ [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] ]" [[obligation]] -id = "db.query.select-sortby.o008" -kind = "operand_type_class" +id = "db.query.select-sortby.o018" +kind = "option_present" required = true -target = " in [ ]" -note = "a valid operand" +target = "[ ASC | DESC ]" [[obligation]] -id = "db.query.select-sortby.o010" -kind = "operand_type_class" +id = "db.query.select-sortby.o019" +kind = "option_absent" required = true -target = " in [ ]" -note = "a valid operand" +target = "[ ASC | DESC ]" + +[[obligation]] +id = "db.query.select-sortby.o020" +kind = "alternative" +required = true +target = "[ ASC | DESC ] → ASC" + +[[obligation]] +id = "db.query.select-sortby.o021" +kind = "alternative" +required = true +target = "[ ASC | DESC ] → DESC" + +[[obligation]] +id = "db.query.select-sortby.o022" +kind = "option_present" +required = true +target = "[ NULLS FIRST | NULLS LAST ]" + +[[obligation]] +id = "db.query.select-sortby.o023" +kind = "option_absent" +required = true +target = "[ NULLS FIRST | NULLS LAST ]" + +[[obligation]] +id = "db.query.select-sortby.o024" +kind = "alternative" +required = true +target = "[ NULLS FIRST | NULLS LAST ] → NULLS FIRST" + +[[obligation]] +id = "db.query.select-sortby.o025" +kind = "alternative" +required = true +target = "[ NULLS FIRST | NULLS LAST ] → NULLS LAST" [[obligation]] id = "db.query.select-sortby.o011" @@ -3993,10 +4153,28 @@ required = true note = "the form without its required BY" [[obligation]] -id = "db.query.select-sortby.o014" +id = "db.query.select-sortby.o026" +kind = "negative_neighbour" +required = true +note = "the form without its required FIRST in [ NULLS FIRST | NULLS LAST ]" + +[[obligation]] +id = "db.query.select-sortby.o027" +kind = "negative_neighbour" +required = true +note = "the form without its required LAST in [ NULLS FIRST | NULLS LAST ]" + +[[obligation]] +id = "db.query.select-sortby.o028" kind = "negative_neighbour" required = true -note = "the form without its required { [ ] }" +note = "the form without its required { [ [ ASC | DESC ] [ NULLS FIRST | NULLS LAST ] ] }" + +[[obligation]] +id = "db.query.select-sortby.o029" +kind = "interaction_all_options" +required = true +note = "every independent option of one production together" [[obligation]] id = "db.query.select-table-reference.o001" @@ -4554,12 +4732,6 @@ required = true target = " in [ ] #7" note = "a string literal in place of " -[[obligation]] -id = "db.query.select-table-reference.o099" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.query.select-table-reference.o100" kind = "negative_neighbour" @@ -4791,12 +4963,6 @@ required = true target = " in [ ]" note = "a string literal in place of " -[[obligation]] -id = "db.query.select-tvf.o014" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.query.select-tvf.o015" kind = "negative_neighbour" @@ -5191,12 +5357,6 @@ required = true target = " in [ ] #2" note = "a string literal in place of " -[[obligation]] -id = "db.query.select-values.values.o030" -kind = "negative_neighbour" -required = true -note = "the form without its required (" - [[obligation]] id = "db.query.select-values.values.o015" kind = "negative_neighbour" diff --git a/coverage/syntax-databricks/obligations/scripting.toml b/coverage/syntax-databricks/obligations/scripting.toml index db8bafb43..91e6bf2f6 100644 --- a/coverage/syntax-databricks/obligations/scripting.toml +++ b/coverage/syntax-databricks/obligations/scripting.toml @@ -297,51 +297,6 @@ kind = "positive" required = true note = "the documented form with every required part and no optional part" -[[obligation]] -id = "db.scripting.compound-stmt.o002" -kind = "option_present" -required = true -target = "[