revokePrivilegeFromShare

Last updated: January 27, 2026

Revokes a privilege on a database object from a Snowflake share. This removes the share's access to the specified object.

Note: Automatic rollback grants the privilege back.

Known limitation: This change type does not support database inspection features (snapshot, diff, diff-changelog, and generate-changelog commands).

Available attributes

Attribute

Type

Description

Required

shareName

String

Name of the share to revoke the privilege from

Yes

objectType

String

Type of object to revoke privilege on*

Yes

objectName

String

Name of the object to revoke privilege on

Yes

catalogName

String

Name of the catalog (database) containing the object**

No

schemaName

String

Name of the schema containing the object***

No

privilege

String

Privilege to revoke (see table below)

Yes

* Supported types: DATABASE, SCHEMA, TABLE, EXTERNAL_TABLE, ICEBERG_TABLE, DYNAMIC_TABLE, VIEW, FUNCTION, TAG, SEMANTIC_VIEW

** Cannot be specified for DATABASE type.

*** Cannot be specified for DATABASE or SCHEMA types.

Privileges by object type

Object type

Valid privileges

DATABASE

USAGE, REFERENCE_USAGE

SCHEMA

USAGE

TABLE

SELECT, EVOLVE SCHEMA

EXTERNAL_TABLE

SELECT

ICEBERG_TABLE

SELECT

DYNAMIC_TABLE

SELECT

VIEW

SELECT

FUNCTION

USAGE

TAG

READ

SEMANTIC_VIEW

REFERENCES

loading

loading

loading

loading