markhoerth commented on code in PR #12326: URL: https://github.com/apache/gravitino/pull/12326#discussion_r3700230364
########## docs/manage-policies-in-gravitino.md: ########## @@ -11,74 +10,33 @@ import TabItem from '@theme/TabItem'; ## Introduction -Starting from 1.0.0, Gravitino introduces a new policy system that allows you to manage policies for -metadata objects. Policies are a set of rules that can be associated with a metadata -object for data governance and similar purposes. - -This document provides a brief introduction to using policies in Gravitino, covering both the Gravitino Java client and -REST APIs. If you want to know more about the policy system in Gravitino, refer to the -Javadoc and REST API documentation. - -:::info -1. Metadata objects are objects that are managed in Gravitino, such as `CATALOG`, `SCHEMA`, `TABLE`, - `FILESET`, `TOPIC`, and `MODEL`. A metadata object is combined by a `type` and a dot-separated - `name`. For example, a `CATALOG` object has a name "catalog1" with type "CATALOG", a `SCHEMA` - object has a name "catalog1.schema1" with type "SCHEMA", a `TABLE` object has a name - "catalog1.schema1.table1" with type "TABLE". -2`CATALOG`, `SCHEMA`, `TABLE`, `FILESET`, `TOPIC`, and `MODEL` objects can be - associated with policies. -3. Policies in Gravitino are inheritable, so listing policies of a metadata object will also list the - policies of its parent metadata objects. For example, listing policies of a `Table` will also list - the policies of its parent `Schema` and `Catalog`. For catalogs that support multi-level - (hierarchical) schemas, such as a schema named `a:b:c` (using the configured schema separator), - the intermediate parent schemas `a:b` and `a` are also part of the hierarchy, so their policies - are inherited as well. -4. The same policy can be associated with both parent and child metadata objects. But when you list the - associated policies of a child metadata object, this policy will be included only once in the result - list with `inherited` value `false`. -::: +This page covers the policy API. For what a policy is, which object types can carry one, what goes in Review Comment: ```suggestion This page covers the Gravitino API for policies. For what a policy is, which object types can carry one, what goes in ``` -- 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]
