[SPARK-42553][SQL][3.3] Ensure at least one time unit after "interval"

[jiang13021]

What changes were proposed in this pull request?

This PR aims to ensure "at least one time unit should be given for interval literal" by modifying SqlBaseParser.

This is a backport of #40195

Why are the changes needed?

INTERVAL is a Non-Reserved keyword in spark. But when I run

scala> spark.sql("select interval from mytable")

I get

org.apache.spark.sql.catalyst.parser.ParseException:
at least one time unit should be given for interval literal(line 1, pos 7)== SQL ==
select interval from mytable
-------^^^  at org.apache.spark.sql.errors.QueryParsingErrors$.invalidIntervalLiteralError(QueryParsingErrors.scala:196)
......

It is a bug because "Non-Reserved keywords" have a special meaning in particular contexts and can be used as identifiers in other contexts. So by design, INTERVAL can be used as a column name.

Currently the interval's grammar is

interval
    : INTERVAL (errorCapturingMultiUnitsInterval | errorCapturingUnitToUnitInterval)?
    ;

There is no need to make the time unit nullable, we can ensure "at least one time unit should be given for interval literal" if the interval's grammar is

interval
    : INTERVAL (errorCapturingMultiUnitsInterval | errorCapturingUnitToUnitInterval)
    ;

Does this PR introduce any user-facing change?

No.

How was this patch tested?

Unit test: PlanParsserSuite."SPARK-42553: NonReserved keyword 'interval' can be column name"

Local test

scala> val myDF = spark.sparkContext.makeRDD(1 to 5).toDF("interval")
myDF: org.apache.spark.sql.DataFrame = [interval: int]

scala> myDF.createOrReplaceTempView("mytable")

scala> spark.sql("select interval from mytable;").show()
+--------+
|interval|
+--------+
|       1|
|       2|
|       3|
|       4|
|       5|
+--------+

[MaxGekk]

@jiang13021 Thank you for the backport. Could add the following, please:

1. The tag [3.3] to PR's title.
2. This is a backport of https://github.com/apache/spark/pull/40195 to PR's description.

[jiang13021]

@jiang13021 Thank you for the backport. Could add the following, please:

1. The tag [3.3] to PR's title.
2. This is a backport of https://github.com/apache/spark/pull/40195 to PR's description.

Done

[MaxGekk]

Waiting for CI.

[MaxGekk]

+1, LGTM. All GAs passed. Merging to 3.3.
Thank you, @jiang13021.