alamb commented on issue #10451:
URL: https://github.com/apache/datafusion/issues/10451#issuecomment-2798883874

   Hi @marvelshan  -- I also took a look at the docs. It actually looks like 
the format options are largely documented, but the documentation could be 
improved
   
   I suggest:
   
   1. Rename 
[`write_options.md`](https://datafusion.apache.org/user-guide/sql/write_options.html)
 to `format_options.md` and make it clear they apply both to reading and 
writing . Also, link `write_options` clearly in the `CREATE EXTERNAL TABLE` 
section
   
   2. Then for each sub heading for each format (`JSON format specific 
options`, etc) add an example, such as 
   
   ```sql
   CREATE EXTERNAL TABLE t 
   STORED AS JSON
   LOCATION '/tmp/foo.dat'
   OPTIONS('COMPRESSION', 'bzip')
   ```
   
   I also suggest increasing the level of Json, csv, etc options so they appear 
in the table of contents
   
   
![Image](https://github.com/user-attachments/assets/2c3f3418-9c03-4079-a679-b516ef492b2d)
   
   


-- 
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.

To unsubscribe, e-mail: github-unsubscr...@datafusion.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: github-unsubscr...@datafusion.apache.org
For additional commands, e-mail: github-h...@datafusion.apache.org

Reply via email to