This is an automated email from the ASF dual-hosted git repository. lzljs3620320 pushed a commit to branch release-1.11 in repository https://gitbox.apache.org/repos/asf/flink.git
commit 224d8d85175d305fa09efa5c7d54e5d61de81347 Author: JingsongLi <[email protected]> AuthorDate: Mon Jun 15 10:18:05 2020 +0800 [FLINK-17686][doc] Add document to blackhole connector --- docs/dev/table/connectors/blackhole.md | 92 +++++++++++++++++++++++++++++++ docs/dev/table/connectors/blackhole.zh.md | 92 +++++++++++++++++++++++++++++++ 2 files changed, 184 insertions(+) diff --git a/docs/dev/table/connectors/blackhole.md b/docs/dev/table/connectors/blackhole.md new file mode 100644 index 0000000..024dabb --- /dev/null +++ b/docs/dev/table/connectors/blackhole.md @@ -0,0 +1,92 @@ +--- +title: "Blackhole SQL Connector" +nav-title: Blackhole +nav-parent_id: sql-connectors +nav-pos: 6 +--- +<!-- +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, +software distributed under the License is distributed on an +"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +KIND, either express or implied. See the License for the +specific language governing permissions and limitations +under the License. +--> + +<span class="label label-primary">Sink: Bounded</span> +<span class="label label-primary">Sink: UnBounded</span> + +* This will be replaced by the TOC +{:toc} + +The Blackhole connector allows for swallowing all input records. It is designed for: + +- high performance testing. +- UDF to output, not substantive sink. + +Just like /dev/null device on Unix-like operating systems. + +The Blackhole connector is built-in. + +How to create a Blackhole table +---------------- + +<div class="codetabs" markdown="1"> +<div data-lang="SQL" markdown="1"> +{% highlight sql %} +CREATE TABLE blackhole_table ( + f0 INT, + f1 INT, + f2 STRING, + f3 DOUBLE +) WITH ( + 'connector' = 'blackhole' +) +{% endhighlight %} +</div> +</div> + +Alternatively, it may be based on an existing schema using the [LIKE Clause]({% link dev/table/sql/create.md %}#create-table). + +<div class="codetabs" markdown="1"> +<div data-lang="SQL" markdown="1"> +{% highlight sql %} +CREATE TABLE blackhole_table WITH ('connector' = 'blackhole') +LIKE source_table (EXCLUDING ALL) +{% endhighlight %} +</div> +</div> + +Connector Options +---------------- + +<table class="table table-bordered"> + <thead> + <tr> + <th class="text-left" style="width: 25%">Option</th> + <th class="text-center" style="width: 8%">Required</th> + <th class="text-center" style="width: 7%">Default</th> + <th class="text-center" style="width: 10%">Type</th> + <th class="text-center" style="width: 50%">Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><h5>connector</h5></td> + <td>required</td> + <td style="word-wrap: break-word;">(none)</td> + <td>String</td> + <td>Specify what connector to use, here should be 'blackhole'.</td> + </tr> + </tbody> +</table> diff --git a/docs/dev/table/connectors/blackhole.zh.md b/docs/dev/table/connectors/blackhole.zh.md new file mode 100644 index 0000000..cf82719 --- /dev/null +++ b/docs/dev/table/connectors/blackhole.zh.md @@ -0,0 +1,92 @@ +--- +title: "Blackhole SQL Connector" +nav-title: Blackhole +nav-parent_id: sql-connectors +nav-pos: 6 +--- +<!-- +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, +software distributed under the License is distributed on an +"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +KIND, either express or implied. See the License for the +specific language governing permissions and limitations +under the License. +--> + +<span class="label label-primary">Sink: Bounded</span> +<span class="label label-primary">Sink: UnBounded</span> + +* This will be replaced by the TOC +{:toc} + +The Blackhole connector allows for swallowing all input records. It is designed for: + +- high performance testing. +- UDF to output, not substantive sink. + +Just like /dev/null device on Unix-like operating systems. + +The Blackhole connector is built-in. + +How to create a Blackhole table +---------------- + +<div class="codetabs" markdown="1"> +<div data-lang="SQL" markdown="1"> +{% highlight sql %} +CREATE TABLE blackhole_table ( + f0 INT, + f1 INT, + f2 STRING, + f3 DOUBLE +) WITH ( + 'connector' = 'blackhole' +) +{% endhighlight %} +</div> +</div> + +Alternatively, it may be based on an existing schema using the [LIKE Clause]({% link dev/table/sql/create.zh.md %}#create-table). + +<div class="codetabs" markdown="1"> +<div data-lang="SQL" markdown="1"> +{% highlight sql %} +CREATE TABLE blackhole_table WITH ('connector' = 'blackhole') +LIKE source_table (EXCLUDING ALL) +{% endhighlight %} +</div> +</div> + +Connector Options +---------------- + +<table class="table table-bordered"> + <thead> + <tr> + <th class="text-left" style="width: 25%">Option</th> + <th class="text-center" style="width: 8%">Required</th> + <th class="text-center" style="width: 7%">Default</th> + <th class="text-center" style="width: 10%">Type</th> + <th class="text-center" style="width: 50%">Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><h5>connector</h5></td> + <td>required</td> + <td style="word-wrap: break-word;">(none)</td> + <td>String</td> + <td>Specify what connector to use, here should be 'blackhole'.</td> + </tr> + </tbody> +</table>
