[HUMAN REVIEW: Feature Not Ready for Documentation]
Issue: This PR adds parsing support for CREATE CHANGEFEED FOR DATABASE syntax, but the feature is explicitly not implemented:
- Release note: "(none)" - indicating this isn't user-facing yet
- Go code: Returns
errors.UnimplementedError(errors.IssueLink{}, "database-level changefeed is not implemented") - PR description: "This PR only allows the aforementioned statement to be parsed; no changefeed is created"
Recommendation: This appears to be preparatory work for a future feature. Documentation should wait until the feature is actually implemented and has a proper release note.
Partial Reference Documentation (If Needed for Future Use)
If you need to prepare documentation structure for when this feature becomes available, here's what I can derive from the syntax changes:
CREATE CHANGEFEED (Database-Level) - [NOT IMPLEMENTED]
Synopsis:
CREATE CHANGEFEED FOR DATABASE database_name
[INTO sink]
[WITH option = value [, ...]]
Description: [NEEDS REVIEW] Creates a changefeed that captures changes for all tables within a specified database. This appears to be an extension of the existing table-level changefeed functionality to operate at the database scope.
Parameters:
| Parameter | Description | Required |
|---|---|---|
database_name |
name of the database to monitor for changes | Yes |
sink |
destination for changefeed output | No |
option |
changefeed configuration options | No |
Current Status:
Examples: [NEEDS REVIEW - Examples cannot be tested as feature is not implemented]
CREATE CHANGEFEED FOR DATABASE mydb;
See also:
- CREATE CHANGEFEED (table-level)
- ALTER CHANGEFEED
Recommendation: Hold this documentation until the feature is implemented and ready for user consumption.
