Read Schema

The RelationDefinition message provides detailed information about a specific relation.

The PermissionDefinition message provides detailed information about a specific permission.

The AttributeDefinition message provides detailed information about a specific attribute.

The Reference enum specifies whether a name pertains to a relation, permission, or attribute.

• REFERENCE_UNSPECIFIED: Default, unspecified reference.
• REFERENCE_RELATION: Indicates that the name refers to a relation.
• REFERENCE_PERMISSION: Indicates that the name refers to a permission.
• REFERENCE_ATTRIBUTE: Indicates that the name refers to an attribute.

Enumerates the types of attribute.

• ATTRIBUTE_TYPE_UNSPECIFIED: Not specified attribute type. This is the default value.
• ATTRIBUTE_TYPE_BOOLEAN: A boolean attribute type.
• ATTRIBUTE_TYPE_BOOLEAN_ARRAY: A boolean array attribute type.
• ATTRIBUTE_TYPE_STRING: A string attribute type.
• ATTRIBUTE_TYPE_STRING_ARRAY: A string array attribute type.
• ATTRIBUTE_TYPE_INTEGER: An integer attribute type.
• ATTRIBUTE_TYPE_INTEGER_ARRAY: An integer array attribute type.
• ATTRIBUTE_TYPE_DOUBLE: A double attribute type.
• ATTRIBUTE_TYPE_DOUBLE_ARRAY: A double array attribute type.

A map from expression ids to resolved references.

The following entries are in this table:

• An Ident or Select expression is represented here if it resolves to a declaration. For instance, if a.b.c is represented by select(select(id(a), b), c), and a.b resolves to a declaration, while c is a field selection, then the reference is attached to the nested select expression (but not to the id or or the outer select). In turn, if a resolves to a declaration and b.c are field selections, the reference is attached to the ident expression.
• Every Call expression has an entry here, identifying the function being called.
• Every CreateStruct expression for a message has an entry, identifying the message.

A map from expression ids to types.

Every expression node which has a type different than DYN has a mapping here. If an expression has type DYN, it is omitted from this map to save space.

Source information collected at parse time.

The expr version indicates the major / minor version number of the expr representation.

The most common reason for a version change will be to indicate to the CEL runtimes that transformations have been performed on the expr during static analysis. In some cases, this will save the runtime the work of applying the same or similar transformations prior to evaluation.

An abstract representation of a common expression.

Expressions are abstractly represented as a collection of identifiers, select statements, function calls, literals, and comprehensions. All operators with the exception of the '.' operator are modelled as function calls. This makes it easy to represent new operators into the existing AST.

All references within expressions must resolve to a [Decl][google.api.expr.v1alpha1.Decl] provided at type-check for an expression to be valid. A reference may either be a bare identifier name or a qualified identifier google.api.name. References may either refer to a value or a function declaration.

For example, the expression google.api.name.startsWith('expr') references the declaration google.api.name within a [Expr.Select][google.api.expr.v1alpha1.Expr.Select] expression, and the function declaration startsWith.