Skip to content

Commit

Permalink
[SPARK-33719][DOC] Add make_date/make_timestamp/make_interval into th…
Browse files Browse the repository at this point in the history
…e doc of ANSI Compliance

### What changes were proposed in this pull request?

Add make_date/make_timestamp/make_interval into the doc of ANSI Compliance

### Why are the changes needed?

Users can know that these functions throw runtime exceptions under ANSI mode if the result is not valid.
### Does this PR introduce _any_ user-facing change?

No

### How was this patch tested?

Build doc and check it in browser:
![image](https://user-images.githubusercontent.com/1097932/101608930-34a79e80-39bb-11eb-9294-9d9b8c3f6faa.png)

Closes #30683 from gengliangwang/improveDoc.

Authored-by: Gengliang Wang <gengliang.wang@databricks.com>
Signed-off-by: HyukjinKwon <gurwls223@apache.org>
  • Loading branch information
gengliangwang authored and HyukjinKwon committed Dec 9, 2020
1 parent a713a7e commit 9959d49
Showing 1 changed file with 10 additions and 6 deletions.
16 changes: 10 additions & 6 deletions docs/sql-ref-ansi-compliance.md
Original file line number Diff line number Diff line change
Expand Up @@ -144,14 +144,18 @@ SELECT * FROM t;

The behavior of some SQL functions can be different under ANSI mode (`spark.sql.ansi.enabled=true`).
- `size`: This function returns null for null input.
- `element_at`: This function throws `ArrayIndexOutOfBoundsException` if using invalid indices.
- `element_at`: This function throws `NoSuchElementException` if key does not exist in map.
- `element_at`:
- This function throws `ArrayIndexOutOfBoundsException` if using invalid indices.
- This function throws `NoSuchElementException` if key does not exist in map.
- `elt`: This function throws `ArrayIndexOutOfBoundsException` if using invalid indices.
- `parse_url`: This function throws `IllegalArgumentException` if an input string is not a valid url.
- `to_date` This function should fail with an exception if the input string can't be parsed, or the pattern string is invalid.
- `to_timestamp` This function should fail with an exception if the input string can't be parsed, or the pattern string is invalid.
- `unix_timestamp` This function should fail with an exception if the input string can't be parsed, or the pattern string is invalid.
- `to_unix_timestamp` This function should fail with an exception if the input string can't be parsed, or the pattern string is invalid.
- `to_date`: This function should fail with an exception if the input string can't be parsed, or the pattern string is invalid.
- `to_timestamp`: This function should fail with an exception if the input string can't be parsed, or the pattern string is invalid.
- `unix_timestamp`: This function should fail with an exception if the input string can't be parsed, or the pattern string is invalid.
- `to_unix_timestamp`: This function should fail with an exception if the input string can't be parsed, or the pattern string is invalid.
- `make_date`: This function should fail with an exception if the result date is invalid.
- `make_timestamp`: This function should fail with an exception if the result timestamp is invalid.
- `make_interval`: This function should fail with an exception if the result interval is invalid.

### SQL Operators

Expand Down

0 comments on commit 9959d49

Please sign in to comment.