132cbf0c8c
### What changes were proposed in this pull request? This PR extends `ADD FILE/JAR/ARCHIVE` commands to be able to take multiple path arguments like Hive. ### Why are the changes needed? To make those commands more useful. ### Does this PR introduce _any_ user-facing change? Yes. In the current implementation, those commands can take a path which contains whitespaces without enclose it by neither `'` nor `"` but after this change, users need to enclose such paths. I've note this incompatibility in the migration guide. ### How was this patch tested? New tests. Closes #32205 from sarutak/add-multiple-files. Authored-by: Kousuke Saruta <sarutak@oss.nttdata.com> Signed-off-by: Kousuke Saruta <sarutak@oss.nttdata.com>
56 lines
1.8 KiB
Markdown
56 lines
1.8 KiB
Markdown
---
|
|
layout: global
|
|
title: ADD FILE
|
|
displayTitle: ADD FILE
|
|
license: |
|
|
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.
|
|
---
|
|
|
|
### Description
|
|
|
|
`ADD FILE` can be used to add a single file as well as a directory to the list of resources. The added resource can be listed using [LIST FILE](sql-ref-syntax-aux-resource-mgmt-list-file.html).
|
|
|
|
### Syntax
|
|
|
|
```sql
|
|
ADD { FILE | FILES } resource_name [ ... ]
|
|
```
|
|
|
|
### Parameters
|
|
|
|
* **resource_name**
|
|
|
|
The name of the file or directory to be added.
|
|
|
|
### Examples
|
|
|
|
```sql
|
|
ADD FILE /tmp/test;
|
|
ADD FILE "/path/to/file/abc.txt";
|
|
ADD FILE '/another/test.txt';
|
|
ADD FILE "/path with space/abc.txt";
|
|
ADD FILE "/path/to/some/directory";
|
|
ADD FILES "/path with space/cde.txt" '/path with space/fgh.txt';
|
|
```
|
|
|
|
### Related Statements
|
|
|
|
* [LIST FILE](sql-ref-syntax-aux-resource-mgmt-list-file.html)
|
|
* [LIST JAR](sql-ref-syntax-aux-resource-mgmt-list-jar.html)
|
|
* [LIST ARCHIVE](sql-ref-syntax-aux-resource-mgmt-list-archive.html)
|
|
* [ADD JAR](sql-ref-syntax-aux-resource-mgmt-add-jar.html)
|
|
* [ADD ARCHIVE](sql-ref-syntax-aux-resource-mgmt-add-archive.html)
|