Creating custom roles in Snowflake - Step-by-Step CLI Walkthrough

Introduction

Sometimes, the default roles in Snowflake do not fit your exact needs. Creating custom roles lets you control who can do what in your data system, making it safer and easier to manage.

When you want to give a team access to only specific databases or tables.

When you need to separate duties so no one has too much control.

When you want to create a role for a new project with unique permissions.

When you want to limit access to sensitive data for certain users.

When you want to organize permissions clearly for easier management.

Commands

This command creates a new role named 'data_analyst' which you can later assign permissions to.

Terminal

CREATE ROLE data_analyst;

Expected Output

SQL executed successfully.

This grants the 'data_analyst' role permission to read data from all tables in the 'public' schema of the 'sales_db' database.

Terminal

GRANT SELECT ON ALL TABLES IN SCHEMA sales_db.public TO ROLE data_analyst;

Expected Output

SQL executed successfully.

This assigns the 'data_analyst' role to the user named 'alice', giving her the permissions of that role.

Terminal

GRANT ROLE data_analyst TO USER alice;

Expected Output

SQL executed successfully.

This shows all the permissions that have been given to the 'data_analyst' role, so you can verify them.

Terminal

SHOW GRANTS TO ROLE data_analyst;

Expected Output

created_on           | privilege | granted_on | name      | granted_to | grantee_name

---------------------|-----------|------------|-----------|------------|-------------

2024-06-01 12:00:00  | SELECT    | TABLE      | SALES_DB.PUBLIC.*  | ROLE       | DATA_ANALYST

Key Concept

If you remember nothing else from this pattern, remember: custom roles let you control exactly who can access what in your Snowflake account.

Common Mistakes

Trying to grant permissions to a user directly without creating or using a role.

Snowflake manages permissions through roles, so users must have roles assigned to get permissions.

Always create a role, grant permissions to that role, then assign the role to users.

Not verifying the granted permissions after creating a role.

You might think permissions are set correctly but they may be missing or incorrect.

Use SHOW GRANTS TO ROLE to check the permissions assigned to your custom role.

Summary

Create a custom role with CREATE ROLE to group permissions.

Grant specific permissions to the role using GRANT statements.

Assign the role to users to give them those permissions.

Verify permissions with SHOW GRANTS TO ROLE.

Practice

1. What is the main purpose of creating a custom role in Snowflake?

easy

A. To create a new user account

B. To store data in a new database

C. To run SQL queries faster

D. To control and manage user access permissions

Solution

1. Step 1: Understand role purpose

   Custom roles in Snowflake are designed to manage what users can do by controlling permissions.

2. Step 2: Identify correct function

   Creating a role is not about storing data, creating users, or speeding queries, but about access control.

3. Final Answer:

   To control and manage user access permissions -> Option D

4. Quick Check:

   Role purpose = Access control [OK]

Hint: Roles control permissions, not data or users [OK]

Common Mistakes:

• Confusing roles with users
• Thinking roles store data
• Assuming roles speed up queries

2. Which of the following is the correct syntax to create a new role named data_analyst in Snowflake?

easy

A. CREATE ROLE data_analyst;

B. NEW ROLE data_analyst;

C. MAKE ROLE data_analyst;

D. ADD ROLE data_analyst;

Solution

1. Step 1: Recall Snowflake role creation syntax

   The correct command to create a role is CREATE ROLE role_name;.

2. Step 2: Match syntax with options

   Only CREATE ROLE data_analyst; uses the correct CREATE ROLE syntax.

3. Final Answer:

   CREATE ROLE data_analyst; -> Option A

4. Quick Check:

   CREATE ROLE = correct syntax [OK]

Hint: Use CREATE ROLE to make new roles [OK]

Common Mistakes:

• Using NEW ROLE instead of CREATE ROLE
• Using MAKE or ADD which are invalid
• Missing semicolon at the end

3. Given the commands:

CREATE ROLE analyst;
GRANT USAGE ON DATABASE sales_db TO ROLE analyst;
GRANT ROLE analyst TO USER alice;

What permission does user alice have on sales_db?

medium

A. No permissions on sales_db

B. Only USAGE permission on sales_db

C. ALL permissions on sales_db

D. SELECT permission on sales_db

Solution

1. Step 1: Analyze role creation and grants

   The role analyst is created and given USAGE permission on sales_db.

2. Step 2: Check role assignment to user

   User alice is granted the analyst role, so she inherits its permissions.

3. Final Answer:

   Only USAGE permission on sales_db -> Option B

4. Quick Check:

   Role grants USAGE, user inherits USAGE [OK]

Hint: User gets permissions of assigned roles [OK]

Common Mistakes:

• Assuming no permissions without direct grant
• Confusing USAGE with SELECT permission
• Ignoring role inheritance

4. You run this command:

CREATE ROLE analyst

but get an error. What is the likely cause?

medium

A. You must create a user before creating a role

B. Role name analyst is reserved and cannot be used

C. Missing semicolon at the end of the command

D. CREATE ROLE command is not supported in Snowflake

Solution

1. Step 1: Check command syntax

   Snowflake commands require a semicolon at the end to execute properly.

2. Step 2: Evaluate other options

   Role names like analyst are allowed, users are independent of roles, and CREATE ROLE is supported.

3. Final Answer:

   Missing semicolon at the end of the command -> Option C

4. Quick Check:

   Semicolon ends command [OK]

Hint: Always end SQL commands with a semicolon [OK]

Common Mistakes:

• Forgetting semicolon causes syntax error
• Thinking role names are restricted
• Believing users must exist first

5. You want to create a custom role report_viewer that can only read data from the reports schema in the analytics database. Which sequence of commands correctly achieves this?

hard

A. CREATE ROLE report_viewer;
GRANT USAGE ON DATABASE analytics TO ROLE report_viewer;
GRANT USAGE ON SCHEMA analytics.reports TO ROLE report_viewer;
GRANT SELECT ON ALL TABLES IN SCHEMA analytics.reports TO ROLE report_viewer;

B. CREATE ROLE report_viewer;
GRANT SELECT ON DATABASE analytics TO ROLE report_viewer;

C. CREATE ROLE report_viewer;
GRANT ALL ON SCHEMA analytics.reports TO ROLE report_viewer;

D. CREATE ROLE report_viewer;
GRANT USAGE ON DATABASE analytics TO ROLE report_viewer;
GRANT SELECT ON SCHEMA analytics.reports TO ROLE report_viewer;

Solution

1. Step 1: Create the role

   Use CREATE ROLE report_viewer; to make the role.

2. Step 2: Grant USAGE on database and schema

   Granting USAGE on the database and schema allows access to objects inside.

3. Step 3: Grant SELECT on all tables in the schema

   Grant SELECT on all tables to allow read access to data.

4. Step 4: Evaluate options

   CREATE ROLE report_viewer; GRANT USAGE ON DATABASE analytics TO ROLE report_viewer; GRANT USAGE ON SCHEMA analytics.reports TO ROLE report_viewer; GRANT SELECT ON ALL TABLES IN SCHEMA analytics.reports TO ROLE report_viewer; correctly grants USAGE and SELECT at proper levels. CREATE ROLE report_viewer; GRANT SELECT ON DATABASE analytics TO ROLE report_viewer; misses schema and USAGE grants. CREATE ROLE report_viewer; GRANT ALL ON SCHEMA analytics.reports TO ROLE report_viewer; grants ALL which is too broad. CREATE ROLE report_viewer; GRANT USAGE ON DATABASE analytics TO ROLE report_viewer; GRANT SELECT ON SCHEMA analytics.reports TO ROLE report_viewer; grants SELECT on schema which is invalid; SELECT must be on tables.

5. Final Answer:

   CREATE ROLE report_viewer; GRANT USAGE ON DATABASE analytics TO ROLE report_viewer; GRANT USAGE ON SCHEMA analytics.reports TO ROLE report_viewer; GRANT SELECT ON ALL TABLES IN SCHEMA analytics.reports TO ROLE report_viewer; -> Option A

6. Quick Check:

   Grant USAGE + SELECT on tables = read access [OK]

Hint: Grant USAGE on DB/schema, SELECT on tables for read-only role [OK]

Common Mistakes:

• Granting SELECT on schema instead of tables
• Missing USAGE grants on database or schema
• Granting ALL permissions instead of SELECT only