szehon-ho commented on code in PR #11041:
URL: https://github.com/apache/iceberg/pull/11041#discussion_r1851160036


##########
format/view-spec.md:
##########
@@ -158,6 +175,57 @@ Each entry in `version-log` is a struct with the following 
fields:
 | _required_  | `timestamp-ms` | Timestamp when the view's 
`current-version-id` was updated (ms from epoch) |
 | _required_  | `version-id`   | ID that `current-version-id` was set to |
 
+#### Partial identifier
+
+The partial identifier holds a reference, containing a namespace and a name, 
of a table or view in the catalog.
+
+| Requirement | Field name     | Description |
+|-------------|----------------|-------------|
+| _required_  | `namespace`   | A list of namespace levels |
+| _required_  | `name`   | A string specifying the name of the table/view |
+
+### Materialized View Metadata stored as part of the Table Metadata
+
+To be able to determine the freshness of the precomputed data, additional 
metadata is stored as part of the storage table.

Review Comment:
   I would simplify this.  ( no need to state 'additional metadata' or 
'introduced' as its obvious from the context)?
   
   ```A snapshot property called 'refresh state' is set on the storage table to 
determine the freshness of the precomputed data in that table. ```
   
   Can we also link to snapshot property section of the table spec?



-- 
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-unsubscr...@iceberg.apache.org

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


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

Reply via email to