[FLINK-31165][table-planner] Improve the error message for order by clause

[LadyForest]

What is the purpose of the change

This PR is cherry-picked from commit eeb446c

Brief change log

Improve the error message in FlinkLogicalOverAggreate

Verifying this change

This change added tests and can be verified as follows:

• RankTest to cover both streaming and batch scenarios.

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 serializer: 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

[flinkbot]

CI report:

• 3ef17fe Azure: SUCCESS

Bot commands

The @flinkbot bot supports the following commands:

• @flinkbot run azure re-run the last Azure build