raminqaf opened a new pull request, #29853:
URL: https://github.com/apache/flink/pull/29853
## What is the purpose of the change
This addresses @twalthr's review of #29834, which came in after the merge.
| Topic | Before (master)
| After
|
|------------------------|------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------|
| Kinds of Functions | On the Built-in Functions page
| On a new Function Basics page
|
| Named Arguments | A page of its own under Flink SQL
| A section of Function Basics
|
| Table functions | One "Table" kind for PTFs and window table
functions | "Table" takes scalar arguments, such as `UNNEST`. "Process Table"
takes one or more tables, such as `FROM_CHANGELOG` |
| `UNNEST`, `ML_PREDICT` | Not in All Functions
| Listed on Collection and Process Table, so All Functions has them
|
```
Flink SQL
├─ Reference
├─ Function Basics <- new: Kinds of Functions, Named Arguments
├─ Built-in Functions
├─ User-Defined Functions
└─ Catalogs ...
```
## Brief change log
- Add Function Basics before Built-in Functions, with the kinds of
functions and the named arguments. A link to `#named-arguments` on the old
built-in functions URL now leads to the new section.
- Split the Table kind, following the `TableFunction` and
`ProcessTableFunction` JavaDoc: a table function takes scalar arguments and
returns a table, and a PTF takes one or more tables.
- List `UNNEST` in a new Table Functions section of Collection, and
`ML_PREDICT` on the Process Table page. `ML_PREDICT` is `kind(PROCESS_TABLE)`
in `BuiltInFunctionDefinitions`.
`/docs/sql/named-arguments/` goes away without a redirect. It exists only on
master since #29834 merged today, so no release has it.
## Verifying this change
Built each commit with Hugo 0.124.1 and the connector docs, with no
warnings. A link check over the 930 built pages finds no broken link or anchor
that master doesn't already have.
Once this is merged, I'll add both commits to the release-2.4 backport
#29852.
## Does this pull request potentially affect one of the following parts:
- Dependencies (does it add or upgrade a dependency): no
- The public API, i.e., is any changed class annotated with
`@Public(Evolving)`: no
- The serializers: no
- The runtime per-record code paths (performance sensitive): no
- Anything that affects deployment or recovery: JobManager (and its
components), Checkpointing, Kubernetes/Yarn, ZooKeeper: no
- The S3 file system connector: no
## Documentation
- Does this pull request introduce a new feature? no
- If yes, how is the feature documented? not applicable
---
##### Was generative AI tooling used to co-author this PR?
- [X] Yes (please specify the tool below)
Generated-by: Claude Code 2.1.321 (Claude Opus 5.5)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
