[SPARK-34525] Update Spark Create Table DDL Docs

• Type: Improvement
• Status: In Progress
• Priority: Major
• Resolution: Unresolved
• Affects Version/s: 3.0.3
• Component/s: Documentation
• Labels: starter
• Assignee: Unassigned
• Reporter: Miklos Christine
• Created: 24/Feb/21 17:18
• Updated: 15/Nov/21 18:26

Description

Within the `CREATE TABLE` docs, the `OPTIONS` and `TBLPROPERTIES`specify `key=value` parameters with a `=` as the delimiter between the key value pairs.
The `=` is optional and can be space delimited. We should document that both methods are supported when defining these parameters.

 

One location within the current docs page that should be updated: 

https://spark.apache.org/docs/latest/sql-ref-syntax-ddl-create-table-datasource.html

 

Code reference showing equal as an optional parameter:

https://github.com/apache/spark/blob/master/sql/catalyst/src/main/antlr4/org/apache/spark/sql/catalyst/parser/SqlBase.g4#L401

Issue Links

• links to: [Github] Pull Request #31899 (nikriek)
• links to: [Github] Pull Request #31899 (nikriek)