Using the {OWNER} Principal¶
Access Resource policies in the Privacera portal can grant permissions to the resource owner by using {OWNER} as the user principal. For Databricks Unity Catalog (UC), PolicySync expands {OWNER} to the current owner of the resource (typically the UC owner email) and applies the matching grants in Unity Catalog.
Overview¶
Use {OWNER} when privileges should always follow the resource owner—for example, ensuring the owner always has Select or Use Catalog—without editing the policy each time ownership changes.
Current scope
{OWNER} is supported for Access Resource policies on the Databricks Unity Catalog connector.
Databricks ownership behavior¶
Databricks Unity Catalog automatically grants native ownership privileges to the owner of each object. Ownership is hierarchical.
For example:
Catalog → Schema → Table
If the same user owns the catalog, schema, and table, that owner can typically work with the table using Databricks’ built-in ownership semantics—even without an Access Resource policy from the Privacera portal for those objects.
An Access Resource policy in the Privacera portal (including {OWNER}) is still useful when you need:
- Privileges that must follow ownership transfers (for example,
Use Catalogon the parent catalog when a new schema owner does not already have it) - Consistent grants across resources where owners differ at catalog, schema, or table level
Ownership transfer and parent privileges ({OWNER})¶
Native ownership on a child object does not always imply the privileges needed on parent objects.
Example¶
-
Owner1 creates a schema (and may own related objects).
-
Ownership of the schema is transferred to Owner2.
-
Owner2 does not have
Use Catalogon the parent catalog. -
Result: Owner2 cannot access the schema, even though they are the schema owner.
Fix with {OWNER}¶
Create a schema-level Access Resource policy that grants Use Catalog on the parent catalog to {OWNER}. That privilege is required so the schema owner can access the schema after ownership transfer.
After PolicySync applies the policy:
- The current schema owner (Owner2) receives
Use Catalogon the parent catalog. - If ownership later moves again,
{OWNER}grants follow the new owner.
Prerequisites¶
| Requirement | Details |
|---|---|
| Access Resource policy | Create an Access Resource policy; add {OWNER} as the user principal. |
| Email as service name | ranger.policysync.connector.0.user.use.email.as.service.name=true (UC default). |
| Managed Ranger user | The UC owner must be a managed Ranger user. |
| Matching email | Managed user email must match the UC owner email (per case settings). |
| Principal sync completed | Users must be synced into the connector principal store before PolicySync applies the policy. |
Typical UC defaults:
| Properties | |
|---|---|
Note
Align email case settings with how emails are stored in Ranger and UC. For details, see User Email Case Conversion.
Creating an Access Resource policy with {OWNER}¶
-
In the Privacera portal, create or edit an Access Resource policy for the Unity Catalog service.
-
Set the resource (catalog / schema / table / column as needed).
-
Under users, add
{OWNER}(not a fixed email, unless you want a static grant). -
Select permissions (for example,
Selecton a table, or a privilege such asUse Catalogthat the owner needs on parent objects). -
Select Save.
After you save, PolicySync processes the policy changelog and applies {OWNER} grants for the current resource owner. After an ownership change, resource sync reapplies those grants to the new owner. For timing and transfer behavior, see Ownership changes.
Example — table Select¶
- Table owner:
owner@example.com - Access Resource policy: user
{OWNER}, permissionSelect - Result:
owner@example.comreceivesSelectin UC
Example — schema owner needs parent catalog access¶
- Schema ownership transferred to Owner2 without
Use Catalog - Access Resource policy using
{OWNER}so the schema owner also getsUse Catalogon the parent catalog - Result: Owner2 can access the schema after sync
Ownership changes¶
When UC ownership changes:
- Before resource sync: The previous owner may still have access from the last applied grants. The new owner does not yet receive
{OWNER}privileges from PolicySync. - PolicySync detects the owner change on the next resource sync.
- After resource sync:
{OWNER}-based grants move to the new owner, and the previous owner’s{OWNER}grants are removed.
No policy edit is required for privileges to follow the new owner. Until sync completes, access can briefly reflect the old ownership state.
Warning
The new owner receives {OWNER} grants only if they are a managed Ranger user. If not, previous {OWNER} grants may be removed and the new owner still gets none.
Limitations¶
- Access Resource policies only (current):
{OWNER}support described here is for Access Resource policies on Databricks Unity Catalog. - Owner must be a managed Ranger user: The UC owner email must match a Ranger user that PolicySync manages. Databricks-only or unmanaged owners do not get
{OWNER}grants. - Email mismatch: UC owner email must match the managed Ranger user email (including case rules).
- Native ownership ≠ parent privileges: Owning a schema/table does not always grant
Use Catalogon the parent catalog; use{OWNER}(or explicit grants) when parent access is required after transfer.
Best practices¶
- Keep UC owners as managed users with correct emails.
- Use
{OWNER}for “always grant the current owner X,” especially after ownership transfers. - For schema/table owners who may lack parent catalog privileges, add Access Resource policies that grant the needed parent privileges to
{OWNER}. - Align email case settings with UC and Ranger.
- After ownership or managed user changes, confirm PolicySync completed successfully.
Troubleshooting¶
| Symptom | Likely cause | What to check |
|---|---|---|
| New owner cannot open schema after transfer | Missing Use Catalog (or similar) on parent | Access Resource policy with {OWNER} for parent privileges; PolicySync apply |
Owner has no UC privilege from {OWNER} policy | Unmanaged user or email mismatch | Managed user list/filters; Ranger email; principal sync |
| Same owner on catalog/schema/table works without a Privacera portal policy | Expected Databricks native ownership | Use {OWNER} in the Privacera portal only when you need explicit or transferable grants |
| Old owner still has access right after ownership transfer | Resource sync not finished yet | Expected until resource sync/ACL recompute completes |
- Prev topic: Advanced Configuration