[
https://issues.apache.org/jira/browse/FLINK-9947?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16562009#comment-16562009
]
ASF GitHub Bot commented on FLINK-9947:
---------------------------------------
twalthr commented on a change in pull request #6456: [FLINK-9947] [docs]
Document unified table sources/sinks/formats
URL: https://github.com/apache/flink/pull/6456#discussion_r206185390
##########
File path: docs/dev/table/sourceSinks.md
##########
@@ -22,751 +22,17 @@ specific language governing permissions and limitations
under the License.
-->
-A `TableSource` provides access to data which is stored in external systems
(database, key-value store, message queue) or files. After a [TableSource is
registered in a TableEnvironment](common.html#register-a-tablesource) it can
accessed by [Table API](tableApi.html) or [SQL](sql.html) queries.
+A `TableSource` provides access to data which is stored in external systems
(database, key-value store, message queue) or files. After a [TableSource is
registered in a TableEnvironment](common.html#register-a-tablesource) it can be
accessed by [Table API](tableApi.html) or [SQL](sql.html) queries.
-A TableSink [emits a Table](common.html#emit-a-table) to an external storage
system, such as a database, key-value store, message queue, or file system (in
different encodings, e.g., CSV, Parquet, or ORC).
+A `TableSink` [emits a Table](common.html#emit-a-table) to an external storage
system, such as a database, key-value store, message queue, or file system (in
different encodings, e.g., CSV, Parquet, or ORC).
-Have a look at the [common concepts and API](common.html) page for details how
to [register a TableSource](common.html#register-a-tablesource) and how to
[emit a Table through a TableSink](common.html#emit-a-table).
+A `TableFactory` allows for separating the declaration of a connection to an
external system from the actual implementation. A table factory creates
configured instances of table sources and sinks from normalized, string-based
properties. The properties can be generated programmatically using a
`Descriptor` or via YAML configuration files for the [SQL
Client](sqlClient.html).
+
+Have a look at the [common concepts and API](common.html) page for details how
to [register a TableSource](common.html#register-a-tablesource) and how to
[emit a Table through a TableSink](common.html#emit-a-table). See the [built-in
sources, sinks, and formats](connect.md) page for examples how to use factories.
Review comment:
Will correct this `.md` when addressing the comments.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
> Document unified table sources/sinks/formats
> --------------------------------------------
>
> Key: FLINK-9947
> URL: https://issues.apache.org/jira/browse/FLINK-9947
> Project: Flink
> Issue Type: Improvement
> Components: Documentation, Table API & SQL
> Reporter: Timo Walther
> Assignee: Timo Walther
> Priority: Major
> Labels: pull-request-available
>
> The recent unification of table sources/sinks/formats needs documentation. I
> propose a new page that explains the built-in sources, sinks, and formats as
> well as a page for customization of public interfaces.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
