srowen commented on a change in pull request #25895: [SPARK-28816][DOC][SQL]
Document ADD JAR statement in SQL Reference
URL: https://github.com/apache/spark/pull/25895#discussion_r332023526
##########
File path: docs/sql-ref-syntax-aux-resource-mgmt-add-jar.md
##########
@@ -19,4 +19,31 @@ license: |
limitations under the License.
---
-**This page is under construction**
+### Description
+`ADD JAR` adds a file, JAR or archive to the list of resources. The added file
can be listed using [LIST JAR](sql-ref-syntax-aux-resource-mgmt-list-jar.html).
+
+### Syntax
+{% highlight sql %}
+ADD JAR file_name
+{% endhighlight %}
+
+### Parameters
+<dl>
+ <dt><code><em>file_name</em></code></dt>
+ <dd>The name of the file, JAR or archive to be added. It could be either on a
local file system or a distributed file system.</dd>
+</dl>
+
+### Examples
+{% highlight sql %}
+ add JAR /tmp/test1.jar;
+
+ add JAR /tmp/test2.zip;
+
+ ADD JAR /tmp/test3.txt;
Review comment:
Would adding a .txt file as a JAR really work? I guess it just puts it on
the classpath like a JAR. If so, that's fine. It would be an unusual usage, so
I am not sure if we should include it, but if it works it's not a big deal.
Here adding a .zip file also looks a little funny, though a JAR file is just
a .zip file itself. Same comment, I wonder if we should show this?
----------------------------------------------------------------
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:
[email protected]
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
