-
Notifications
You must be signed in to change notification settings - Fork 13.3k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[FLINK-18416][table-common] Deprecate TableEnvironment#connect API #12753
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Makes sense to me. I added a comment about the wording.
@@ -442,8 +442,11 @@ | |||
* </pre> | |||
* | |||
* @param connectorDescriptor connector descriptor describing the external system | |||
* @deprecated this method might be refactored or dropped in the next versions, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It would be nice to answer the why?
question for users. E.g. The SQL {@code CREATE TABLE} DDL is richer than this part of the API. This method might be refactored in the next versions. Please use {@link #executeSql(String) executeSql(ddl)} to register a table instead.
Thanks a lot for your contribution to the Apache Flink project. I'm the @flinkbot. I help the community Automated ChecksLast check on commit 7260e8b (Tue Jun 23 10:42:33 UTC 2020) Warnings:
Mention the bot in a comment to re-run the automated checks. Review Progress
Please see the Pull Request Review Guide for a full explanation of the review process. The Bot is tracking the review progress through labels. Labels are applied according to the order of the review items. For consensus, approval by a Flink committer of PMC member is required Bot commandsThe @flinkbot bot supports the following commands:
|
Build is passed in my repo: https://dev.azure.com/imjark/Flink/_build/results?buildId=186&view=results Merging... |
What is the purpose of the change
In the past releases, the community focused on the new SQL DDL features and the
TableEnvironment#connect API
is not maintained for a long time. We have seen many (bug) issues around this APIs.The
TableEnvironment#connect()
API might receive some refactoring in the next release. So we should deprecate the connect API in 1.11 and recommend users to useexecuteSql(ddl)
instead. Thus, we can remove/refactor the existingconnect()
API in the next release even though it is API breaking.Brief change log
connect()
API and add deprecate Javadoc.Verifying this change
N/A.
Does this pull request potentially affect one of the following parts:
@Public(Evolving)
: (yes / no)Documentation