UltipaDocs
Try Playground
  • Overview
  • User Management
  • Role Management
  • Grant & Revoke
  • Permission Levels
  • Best Practices
  1. Docs
  2. /
  3. Access Control

Grant & Revoke Permissions

Overview

Assign or remove permissions from users and roles. Use GRANT to add permissions and REVOKE to remove them.

Grant Statements

StatementDescription
GRANT ROLE TO USERAssign role to user
REVOKE ROLE FROM USERRemove role from user
GRANT ON DATABASEGrant database-wide permission
GRANT ON GRAPHGrant graph-level permission
SHOW GRANTSShow all grants

Assigning Roles to Users

Grant role to user:

GQL
GRANT ROLE 'data_reader' TO USER 'analyst'

Revoke role from user:

GQL
REVOKE ROLE 'data_reader' FROM USER 'analyst'

Granting Permissions to Roles

Read access to a graph:

GQL
GRANT READ ON GRAPH 'social_network' TO ROLE 'data_reader'

Write access to a graph:

GQL
GRANT INSERT, UPDATE, DELETE ON GRAPH 'social_network' TO ROLE 'data_writer'

Full access to all graphs:

GQL
GRANT ALL ON GRAPH * TO ROLE 'admin'

Database-wide read access:

GQL
GRANT READ ON DATABASE TO ROLE 'data_reader'

Fine-Grained Permissions

Access to specific node label:

GQL
GRANT READ ON NODE 'Person' IN GRAPH 'social_network' TO ROLE 'analytics'

Access to specific edge label:

GQL
GRANT READ ON EDGE 'KNOWS' IN GRAPH 'social_network' TO ROLE 'analytics'

Access to specific property:

GQL
GRANT READ ON PROPERTY 'salary' ON 'Person' IN GRAPH 'hr_data' TO ROLE 'hr_manager'

Revoking Permissions

GQL
REVOKE INSERT ON GRAPH 'social_network' FROM ROLE 'data_writer'

Showing Grants

Show all grants:

GQL
SHOW GRANTS

Show grants for specific user:

GQL
SHOW GRANTS FOR USER 'analyst'

Result:

operationscoperesourceeffect
READGRAPHsocial_networkALLOW
READGRAPHproductsALLOW

Show grants for specific role:

GQL
SHOW GRANTS FOR ROLE 'data_reader'