mchades commented on code in PR #13804:
URL: https://github.com/apache/gravitino/pull/13804#discussion_r4255490239
##########
docs/gravitino-mcp-server.md:
##########
@@ -138,7 +138,56 @@ Gravitino MCP server supports the following tools, and you
could export tool by
| `get_partition` | Retrieve a partition's metadata. Only
for catalogs with a partition API. | `partition` |
| `list_of_views` | Retrieve a list of views for a schema.
Only for catalogs supporting views. | `view` |
| `load_view` | Retrieve a view's metadata. Only for
catalogs supporting views. | `view` |
+| `list_of_semantic_models` | List the Semantic Models the caller
can access in a schema. | `semantic_model` |
+| `load_semantic_model` | Load a Semantic Model's metadata and
definition. | `semantic_model` |
+| `create_semantic_model` | Create a Semantic Model from a native
REST definition. | `semantic_model` |
+| `alter_semantic_model` | Apply Semantic Model updates
atomically. | `semantic_model` |
+| `drop_semantic_model` | Drop a Semantic Model's metadata.
| `semantic_model` |
+### Semantic Models
+
+Semantic Model tools manage schema-scoped semantic metadata through the
Gravitino REST API.
+Use the `semantic_model` tag with `--include-tool-tags` to expose these five
tools.
+They use the same per-call `metalake` selection and authentication as other
tools;
+Gravitino filters listings and enforces authorization, including access to
referenced source tables.
+Names used in REST paths must be non-empty and cannot be `.` or `..`, which
HTTP clients
+normalize as path navigation. Dots within names, such as `sales.v2`, are
supported.
Review Comment:
`ossie` is not reserved for Semantic Model names. The import route is
POST-only, while GET, PUT and DELETE still match `/{semanticModel}`, so no
additional name restriction needs to be documented.
--
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]
