davidradl commented on code in PR #26167:
URL: https://github.com/apache/flink/pull/26167#discussion_r1963438709


##########
flink-python/docs/reference/pyflink.table/catalog.rst:
##########
@@ -250,3 +250,31 @@ A CatalogDescriptor is a template for creating a catalog 
instance. It closely re
     :toctree: api/
 
     CatalogDescriptor.of
+
+
+ObjectIdentifier
+----------------
+
+Identifies an object in a catalog. It allows to identify objects such as 
tables, views,
+function, or types in a catalog. An identifier must be fully qualified. It is 
the
+responsibility of the catalog manager to resolve an identifier to an object.
+
+While Path :class:`ObjectPath` is used within the same catalog, instances of 
this class can be
+used across catalogs.
+
+Two objects are considered equal if they share the same object identifier in a 
stable session

Review Comment:
   could we link to / explain  what `stable session context` is



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

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

Reply via email to