bowenli86 commented on a change in pull request #9164: [FLINK-12894]add Chinese documentation of how to configure and use catalogs in SQL CLI URL: https://github.com/apache/flink/pull/9164#discussion_r305533836
########## File path: docs/dev/table/sqlClient.zh.md ########## @@ -24,71 +24,73 @@ under the License. --> -Flink’s Table & SQL API makes it possible to work with queries written in the SQL language, but these queries need to be embedded within a table program that is written in either Java or Scala. Moreover, these programs need to be packaged with a build tool before being submitted to a cluster. This more or less limits the usage of Flink to Java/Scala programmers. +Flink的Table & SQL API可以处理SQL语言编写的查询,但这些查询需要嵌入用Java或Scala编写的程序中。 而且,这些程序需要在提交到集群之前使用构建工具打包。 这或多或少地限制了Flink只能为Java/Scala程序员而使用。 -The *SQL Client* aims to provide an easy way of writing, debugging, and submitting table programs to a Flink cluster without a single line of Java or Scala code. The *SQL Client CLI* allows for retrieving and visualizing real-time results from the running distributed application on the command line. +*SQL Client*旨在提供一种简单的方法来编写,调试和提交表程序到Flink集群,而无需单独编写Java或Scala代码。 *SQL Client CLI*允许在命令行上提交分布式应用程序来获得可视化的实时结果。 -<a href="{{ site.baseurl }}/fig/sql_client_demo.gif"><img class="offset" src="{{ site.baseurl }}/fig/sql_client_demo.gif" alt="Animated demo of the Flink SQL Client CLI running table programs on a cluster" width="80%" /></a> +<a href="{{ site.baseurl }}/fig/sql_client_demo.gif"><img class="offset" src="{{ site.baseurl }}/fig/sql_client_demo.gif" alt="在集群上运行表程序的Flink SQL Client CLI的动画演示" width="80%" /></a> + +<span class="label label-danger">注意</span> SQL客户端处于早期开发阶段。 即使应用程序还没有生产就绪,它也可以是一个非常有用的工具,用于原型设计和使用Flink SQL。 在未来,社区计划通过提供基于REST的功能来扩展其功能 [SQL Client Gateway](sqlClient.html#limitations--future). -<span class="label label-danger">Attention</span> The SQL Client is in an early development phase. Even though the application is not production-ready yet, it can be a quite useful tool for prototyping and playing around with Flink SQL. In the future, the community plans to extend its functionality by providing a REST-based [SQL Client Gateway](sqlClient.html#limitations--future). * This will be replaced by the TOC {:toc} -Getting Started +入门 --------------- -This section describes how to setup and run your first Flink SQL program from the command-line. +本节介绍如何从命令行设置和运行第一个Flink SQL程序。 -The SQL Client is bundled in the regular Flink distribution and thus runnable out-of-the-box. It requires only a running Flink cluster where table programs can be executed. For more information about setting up a Flink cluster see the [Cluster & Deployment]({{ site.baseurl }}/ops/deployment/cluster_setup.html) part. If you simply want to try out the SQL Client, you can also start a local cluster with one worker using the following command: +SQL客户端捆绑在常规Flink分发中,因此可以开箱即用。 它只需要一个可以执行表程序的正在运行的Flink集群,其中。 有关设置Flink群集的详细信息,请参阅 + [集群与发布]({{ site.baseurl }}/ops/deployment/cluster_setup.html) 部分。 如果您只想尝试SQL客户端,还可以使用以下命令启动具有一个工作线程的本地集群: {% highlight bash %} ./bin/start-cluster.sh {% endhighlight %} -### Starting the SQL Client CLI +### 启动SQL客户端CLI -The SQL Client scripts are also located in the binary directory of Flink. [In the future](sqlClient.html#limitations--future), a user will have two possibilities of starting the SQL Client CLI either by starting an embedded standalone process or by connecting to a remote SQL Client Gateway. At the moment only the `embedded` mode is supported. You can start the CLI by calling: +SQL客户端脚本也位于Flink的二进制目录中。 [将来](sqlClient.html#limitations--future),用户可以通过启动嵌入式独立进程或连接到远程SQL客户端网关来启动SQL Client CLI。 目前只支持`embedded`模式。 您可以通过调用以下命令启动CLI: Review comment: probably should be: ```suggestion SQL客户端脚本也位于Flink的二进制目录中。 [将来](sqlClient_zh.html#局限与未来),用户可以通过启动嵌入式独立进程或连接到远程SQL客户端网关来启动SQL Client CLI。 目前只支持`embedded`模式。 您可以通过调用以下命令启动CLI: ``` ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org With regards, Apache Git Services