Repository: spark Updated Branches: refs/heads/master e92ffe6f1 -> 66a792cd8
[SPARK-21123][DOCS][STRUCTURED STREAMING] Options for file stream source are in a wrong table ## What changes were proposed in this pull request? The description for several options of File Source for structured streaming appeared in the File Sink description instead. This pull request has two commits: The first includes changes to the version as it appeared in spark 2.1 and the second handled an additional option added for spark 2.2 ## How was this patch tested? Built the documentation by SKIP_API=1 jekyll build and visually inspected the structured streaming programming guide. The original documentation was written by tdas and lw-lin Author: assafmendelson <[email protected]> Closes #18342 from assafmendelson/spark-21123. Project: http://git-wip-us.apache.org/repos/asf/spark/repo Commit: http://git-wip-us.apache.org/repos/asf/spark/commit/66a792cd Tree: http://git-wip-us.apache.org/repos/asf/spark/tree/66a792cd Diff: http://git-wip-us.apache.org/repos/asf/spark/diff/66a792cd Branch: refs/heads/master Commit: 66a792cd88c63cc0a1d20cbe14ac5699afbb3662 Parents: e92ffe6 Author: assafmendelson <[email protected]> Authored: Mon Jun 19 10:58:58 2017 -0700 Committer: Shixiong Zhu <[email protected]> Committed: Mon Jun 19 10:58:58 2017 -0700 ---------------------------------------------------------------------- docs/structured-streaming-programming-guide.md | 28 +++++++++++---------- 1 file changed, 15 insertions(+), 13 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/spark/blob/66a792cd/docs/structured-streaming-programming-guide.md ---------------------------------------------------------------------- diff --git a/docs/structured-streaming-programming-guide.md b/docs/structured-streaming-programming-guide.md index 9b9177d..d478042 100644 --- a/docs/structured-streaming-programming-guide.md +++ b/docs/structured-streaming-programming-guide.md @@ -510,7 +510,20 @@ Here are the details of all the sources in Spark. <td><b>File source</b></td> <td> <code>path</code>: path to the input directory, and common to all file formats. - <br/><br/> + <br/> + <code>maxFilesPerTrigger</code>: maximum number of new files to be considered in every trigger (default: no max) + <br/> + <code>latestFirst</code>: whether to processs the latest new files first, useful when there is a large backlog of files (default: false) + <br/> + <code>fileNameOnly</code>: whether to check new files based on only the filename instead of on the full path (default: false). With this set to `true`, the following files would be considered as the same file, because their filenames, "dataset.txt", are the same: + <br/> + · "file:///dataset.txt"<br/> + · "s3://a/dataset.txt"<br/> + · "s3n://a/b/dataset.txt"<br/> + · "s3a://a/b/c/dataset.txt"<br/> + <br/> + + <br/> For file-format-specific options, see the related methods in <code>DataStreamReader</code> (<a href="api/scala/index.html#org.apache.spark.sql.streaming.DataStreamReader">Scala</a>/<a href="api/java/org/apache/spark/sql/streaming/DataStreamReader.html">Java</a>/<a href="api/python/pyspark.sql.html#pyspark.sql.streaming.DataStreamReader">Python</a>/<a href="api/R/read.stream.html">R</a>). @@ -1234,18 +1247,7 @@ Here are the details of all the sinks in Spark. <td>Append</td> <td> <code>path</code>: path to the output directory, must be specified. - <br/> - <code>maxFilesPerTrigger</code>: maximum number of new files to be considered in every trigger (default: no max) - <br/> - <code>latestFirst</code>: whether to processs the latest new files first, useful when there is a large backlog of files (default: false) - <br/> - <code>fileNameOnly</code>: whether to check new files based on only the filename instead of on the full path (default: false). With this set to `true`, the following files would be considered as the same file, because their filenames, "dataset.txt", are the same: - <br/> - · "file:///dataset.txt"<br/> - · "s3://a/dataset.txt"<br/> - · "s3n://a/b/dataset.txt"<br/> - · "s3a://a/b/c/dataset.txt"<br/> - <br/> + <br/><br/> For file-format-specific options, see the related methods in DataFrameWriter (<a href="api/scala/index.html#org.apache.spark.sql.DataFrameWriter">Scala</a>/<a href="api/java/org/apache/spark/sql/DataFrameWriter.html">Java</a>/<a href="api/python/pyspark.sql.html#pyspark.sql.DataFrameWriter">Python</a>/<a href="api/R/write.stream.html">R</a>). --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
