mchades commented on code in PR #11129: URL: https://github.com/apache/gravitino/pull/11129#discussion_r3265200450
########## docs/manage-view-metadata-using-gravitino.md: ########## @@ -0,0 +1,288 @@ +--- +title: "Manage view metadata using Apache Gravitino" +slug: /manage-view-metadata-using-gravitino +date: 2026-5-17 +keyword: Gravitino view metadata manage +license: This software is licensed under the Apache License version 2. +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +This page introduces how to manage view metadata by Apache Gravitino. A view stores a logical +query definition rather than physical data. Through Gravitino, you can create, load, alter, +drop, and list views in supported catalogs via unified REST APIs or the Java client. + +When a catalog implements view management, Gravitino operates on the provider's native view +metadata rather than a separate Gravitino-only view type. View capabilities are implemented by +each catalog provider and may differ in operation coverage and SQL dialect behavior. For detailed +support, see: + +- [Hive view capabilities](./apache-hive-catalog.md#view-capabilities) +- [Iceberg view capabilities](./lakehouse-iceberg-catalog.md#view-capabilities) +- [Paimon view capabilities](./lakehouse-paimon-catalog.md#view-capabilities) + +Unlike tables, views define query output and one or more representations, but do not manage +partitions, sort orders, indexes, or physical storage locations. The representation model is +extensible, but currently only SQL representations are supported. + +To use view management, please make sure that: + + - Gravitino server has started, and the host and port is [http://localhost:8090](http://localhost:8090). Review Comment: Fixed. Changed 'the host and port is' to 'the host and port are'. ########## docs/lakehouse-paimon-catalog.md: ########## @@ -232,6 +232,20 @@ Bucket settings are defined via Gravitino table distribution (HASH strategy). Th Please refer to [Manage Relational Metadata Using Gravitino](./manage-relational-metadata-using-gravitino.md#table-operations) for more details. +## View + +### View capabilities + +- Supports list, create, load, alter, and drop for views stored in the Paimon catalog. +- Each view must include exactly one SQL representation with dialect `query`, which serves as the canonical view definition. +- Additional dialect-specific SQL representations (for example, `spark` or `trino`) can be provided alongside the required `query` representation. Review Comment: Checked the Paimon view implementation code (PaimonView.java). The current wording is accurate: Paimon requires exactly one representation with dialect `query` as the canonical definition, and additional dialect-specific representations (e.g., `spark`, `trino`) are stored separately. The two bullets describe different constraints and are not contradictory. Keeping as-is. ########## docs/manage-relational-metadata-using-gravitino.md: ########## @@ -10,9 +10,11 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; This page introduces how to manage relational metadata by Apache Gravitino, relational metadata refers -to relational catalog, schema, table and partitions. Through Gravitino, you can create, edit, and +to relational catalog, schema, table, partitions and views. Through Gravitino, you can create, edit, and Review Comment: Fixed. Added Oxford comma: 'table, partitions and views' → 'table, partitions, and views'. -- 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: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
