[GitHub] [iceberg] jackye1995 commented on a change in pull request #3482: spark: supplement spark-queries.md doc

[GitBox <gi...@apache.org>]

jackye1995 commented on a change in pull request #3482:
URL: https://github.com/apache/iceberg/pull/3482#discussion_r744154496



##########
File path: site/docs/spark-queries.md
##########
@@ -219,9 +221,28 @@ SELECT * FROM prod.db.table.files
 +-------------------------------------------------------------------------+-------------+--------------+--------------------+--------------------+------------------+-------------------+------------------+-----------------+-----------------+--------------+---------------+
 ```
 
+### All Data Files
+
+To show a table's valid data files and each file's metadata, run:
+> tip: a valid data file is one that is readable from any snapshot currently tracked by the table.

Review comment:
       notes in the doc are in the form of `!!! Note`, example: https://github.com/apache/iceberg/blob/master/site/docs/spark-writes.md?plain=1#L298-L301
   
   Also we should add the warning that this table may return duplicate rows.




-- 
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: issues-unsubscribe@iceberg.apache.org

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



---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@iceberg.apache.org
For additional commands, e-mail: issues-help@iceberg.apache.org