Skip to main content

Arctic Privileges

The following sections describe the supported privileges for Arctic catalogs and each type of securable object in an Arctic catalog.

Catalog Privileges

Organization owners and users with the MANAGE GRANTS privilege can grant the following privileges on Arctic catalogs:

PrivilegeDescription
ALTER REFLECTIONCreate, edit, and view reflections on tables and views in the Arctic catalog. Includes all interfaces including reflection pages, admin reflection pages, REST API endpoints (both individual reflections and list all reflections), and job history for reflections.
COMMITPerform write operations on an Arctic catalog, including insert, update, delete, merge, and truncate on tables in the catalog, merge branches, and assign branches and tags to other references.
CREATE BRANCHCreate branches in the Arctic catalog.
CREATE FOLDERCreate folders in the Arctic catalog.
CREATE FUNCTIONCreate user-defined functions (UDFs) in the Arctic catalog.
CREATE TABLECreate tables in the Arctic catalog.
CREATE TAGCreate tags in the Arctic catalog.
CREATE VIEWCreate views in the Arctic catalog.
MANAGE GRANTSGrant and revoke privileges on an Arctic catalog.
MODIFYEdit the Arctic catalog's settings, including its compute settings.
OWNERSHIPTake any action on the Arctic catalog and the objects it contains, including transferring catalog ownership to another user or role, modifying catalog settings, granting and revoking user and role access, and deleting the catalog and its objects.
SELECTView child folders, tables, and views in the Arctic catalog and run SELECT queries on the tables and views and read their schema definitions, lineages, wikis, and labels.
USAGEMinimum privilege required to perform any operation on an Arctic catalog. By itself, USAGE grants access to view a catalog but not the catalog's child folders and datasets. Additional privileges are required for operations on child folders and datasets; for example, users need the CREATE TABLE privilege to create tables in the catalog and the SELECT privilege to view the catalog's child folders and datasets and run SELECT queries on the tables and views. Revoking the USAGE privilege effectively prevents any operation on the Arctic catalog or the objects it contains, including operations made possible by other privileges.
VIEW REFLECTIONView reflections on the tables or views in the Arctic catalog. Includes all interfaces including the reflection pages, admin reflection pages, REST API endpoints (both individual reflections and list all reflections), and job history for reflections.
WRITERun INSERT, UPDATE, DELETE, TRUNCATE, ALTER, ALTER REFLECTION, REFRESH METADATA, and FORGET METADATA queries on the tables and views in the catalog as well as edit their wikis and labels.

Required Privileges for Optimization Actions

The following table lists the privileges required to perform optimization actions for an Arctic catalog:

ActionRequired Arctic Catalog-Level Privileges
Create and edit optimization compute settingsUSAGE and MODIFY
Retrieve optimization compute settingsUSAGE
Trigger data optimization jobsUSAGE and COMMIT
Cancel data optimization jobsUSAGE plus one of the following:
  • Organization owner
  • Catalog owner
  • Optimization job owner
Retrieve details about data optimization jobs with the Arctic Jobs APIUSAGE plus one of the following:
  • Organization owner
  • Catalog owner
  • Optimization job owner
List data optimization jobsUSAGE plus one of the following:
  • Organization owner
  • Catalog owner
Users who are not the optimization job owner can search only the jobs they triggered.
Create and edit data optimization schedulesUSAGE and COMMIT
Delete data optimization schedulesUSAGE plus one of the following:
  • Organization owner
  • Catalog owner
  • Schedule owner
List data optimization schedulesUSAGE plus one of the following:
  • Organization owner
  • Catalog owner
Users who are not the schedule owner can search only the schedules they created.

Folder Privileges

Organization owners and users with the MANAGE GRANTS privilege can grant the following privileges on folders in Arctic catalogs:

PrivilegeDescription
ALTER REFLECTIONCreate, edit, and view reflections on tables and views in the folder and any subfolders. Includes all interfaces including reflection pages, admin reflection pages, REST API endpoints (both individual reflections and list all reflections), and job history for reflections.
CREATE FOLDERCreate subfolders in the folder.
CREATE FUNCTIONCreate user-defined functions (UDFs) in the folder.
CREATE TABLECreate tables in the folder and any subfolders.
CREATE VIEWCreate views in the folder and any subfolders.
MANAGE GRANTSGrant and revoke privileges on the folder.
OWNERSHIPTake any action on the folder and the objects it contains, including transferring folder ownership to another user or role, modifying folder settings, granting and revoking user and role access, and deleting the folder and its objects.
SELECTView and navigate to the folder and all of the subfolders, tables, and views it contains in the Dremio console, as well as run SELECT queries on the tables and views in the folder and read their schema definitions, lineages, wikis, and labels.
SHOWView and navigate to the folder in the Dremio console. SHOW is only available on folders and is NOT inherited for any subfolders, tables, or views in a folder on which SHOW is granted.
VIEW REFLECTIONView reflections on the tables or views in the folder and any subfolders. Includes all interfaces including the reflection pages, admin reflection pages, REST API endpoints (both individual reflections and list all reflections), and job history for reflections.
WRITERun INSERT, UPDATE, DELETE, TRUNCATE, ALTER, ALTER REFLECTION, REFRESH METADATA, and FORGET METADATA queries on the tables and views in the folder and any subfolders as well as edit their wikis.

Table Privileges

Organization owners and users with the MANAGE GRANTS privilege can grant the following privileges on tables in Arctic catalogs:

PrivilegeDescription
ALTER REFLECTIONCreate, edit, and view reflections on the table. Includes all interfaces including the table reflection pages, the admin reflection pages, the REST API endpoints (both individual reflections and list all reflections), and job history for reflections.
MANAGE GRANTSGrant and revoke privileges on the table.
OWNERSHIPTake any action on the table, including transferring ownership to another user or role, modifying settings, granting and revoking user and role access, and deleting the table.
SELECTRun SELECT queries on the table and read the table's schema definition, lineage, wiki, and labels.
VIEW REFLECTIONView reflections on the table. Includes all interfaces including the table reflection pages, the admin reflection pages, the REST API endpoints (both individual reflections and list all reflections), and job history for reflections.
WRITERun INSERT, UPDATE, DELETE, TRUNCATE, ALTER, ALTER REFLECTION, REFRESH METADATA, and FORGET METADATA queries on the table as well as edit the table's wiki.

UDF (User-Defined Function) Privileges

PrivilegeDescription
OWNERSHIPGrant ownership of an UDF to a user/role. The ownership can be transferred to a different user/role using the GRANT OWNERSHIP command by the owner.
  • Only a single entity (user/role) can hold this privilege on a specific object at a time.
  • UDF owners cannot access the UDF unless they have the USAGE privilege on the catalog that contains the UDF. Once they are granted the USAGE privilege on the catalog, UDF owners have all other implicit privileges on the UDF. Actions include modifying UDF settings and deleting the UDF.
SELECTRun SELECT queries on the UDF and read the UDF's schema definition, lineage, wiki, and labels.
WRITERun REPLACE FUNCTION if the UDF already exists. Edit the UDF's definition and wiki.

View Privileges

Organization owners and users with the MANAGE GRANTS privilege can grant the following privileges on views in Arctic catalogs:

PrivilegeDescription
ALTER REFLECTIONCreate, edit, and view reflections on the view. Includes all interfaces including the view reflection pages, the admin reflection pages, the REST API endpoints (both individual reflections and list all reflections), and job history for reflections.
MANAGE GRANTSGrant and revoke privileges on the view.
OWNERSHIPTake any action on the view, including transferring ownership to another user or role, modifying settings, granting and revoking user and role access, and deleting the view.
SELECTRun SELECT queries on the view and read the view's schema definition, lineage, wiki, and labels.
VIEW REFLECTIONView reflections on the view. Includes all interfaces including the view reflection pages, the admin reflection pages, the REST API endpoints (both individual reflections and list all reflections), and job history for reflections.
WRITEEdit the view's definition and wiki.