Reference
Version · 6.0
Change Automation Reference

bulkGrantPrivilegeToShare

Last updated: August 12, 2026

Grants a privilege on all objects of a specific type within a schema to a Snowflake share. This is a bulk operation that applies the privilege to all existing objects matching the criteria.

Note: This change type does not support automatic rollback or database inspection features (snapshot, diff, diff-changelog, and generate-changelog commands).

Available attributes

Attribute	Type	Description	Required
`shareName`	String	Name of the share to grant the privilege to	Yes
`objectType`	String	Type of objects to grant privilege on*	Yes
`catalogName`	String	Name of the catalog (database) containing the schema	No
`schemaName`	String	Name of the schema containing the objects	Yes
`privilege`	String	Privilege to grant: `SELECT` or `EVOLVE SCHEMA`	Yes

* Supported types: TABLE, EXTERNAL_TABLE, ICEBERG_TABLE, DYNAMIC_TABLE

Prerequisites

Before granting bulk privileges on database objects to a share, you must first grant USAGE privilege on the database:

GRANT USAGE ON DATABASE database_name TO SHARE share_name;

<?xml version="1.0" encoding="UTF-8"?>
<databaseChangeLog
        xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
        xmlns:pro-snowflake="http://www.liquibase.org/xml/ns/pro-snowflake"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
        http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd
        http://www.liquibase.org/xml/ns/pro-snowflake
        http://www.liquibase.org/xml/ns/pro-snowflake/liquibase-pro-snowflake-latest.xsd">

    <!-- Grant SELECT on all tables -->
    <changeSet id="bulk-grant-tables" author="examples">
        <pro-snowflake:bulkGrantPrivilegeToShare
                shareName="MY_SHARE"
                objectType="TABLE"
                catalogName="MY_DATABASE"
                schemaName="PUBLIC"
                privilege="SELECT"/>
    </changeSet>

    <!-- Grant SELECT on all external tables -->
    <changeSet id="bulk-grant-external-tables" author="examples">
        <pro-snowflake:bulkGrantPrivilegeToShare
                shareName="MY_SHARE"
                objectType="EXTERNAL_TABLE"
                catalogName="MY_DATABASE"
                schemaName="STAGING"
                privilege="SELECT"/>
    </changeSet>

    <!-- Grant SELECT on all dynamic tables -->
    <changeSet id="bulk-grant-dynamic-tables" author="examples">
        <pro-snowflake:bulkGrantPrivilegeToShare
                shareName="MY_SHARE"
                objectType="DYNAMIC_TABLE"
                catalogName="MY_DATABASE"
                schemaName="ANALYTICS"
                privilege="SELECT"/>
    </changeSet>

    <!-- Grant EVOLVE SCHEMA on all tables -->
    <changeSet id="bulk-grant-evolve-schema" author="examples">
        <pro-snowflake:bulkGrantPrivilegeToShare
                shareName="MY_SHARE"
                objectType="TABLE"
                catalogName="MY_DATABASE"
                schemaName="PUBLIC"
                privilege="EVOLVE SCHEMA"/>
    </changeSet>

</databaseChangeLog>

{
  "databaseChangeLog": [
    {
      "changeSet": {
        "id": "bulk-grant-tables",
        "author": "examples",
        "changes": [
          {
            "bulkGrantPrivilegeToShare": {
              "shareName": "MY_SHARE",
              "objectType": "TABLE",
              "catalogName": "MY_DATABASE",
              "schemaName": "PUBLIC",
              "privilege": "SELECT"
            }
          }
        ]
      }
    },
    {
      "changeSet": {
        "id": "bulk-grant-external-tables",
        "author": "examples",
        "changes": [
          {
            "bulkGrantPrivilegeToShare": {
              "shareName": "MY_SHARE",
              "objectType": "EXTERNAL_TABLE",
              "catalogName": "MY_DATABASE",
              "schemaName": "STAGING",
              "privilege": "SELECT"
            }
          }
        ]
      }
    },
    {
      "changeSet": {
        "id": "bulk-grant-evolve-schema",
        "author": "examples",
        "changes": [
          {
            "bulkGrantPrivilegeToShare": {
              "shareName": "MY_SHARE",
              "objectType": "TABLE",
              "catalogName": "MY_DATABASE",
              "schemaName": "PUBLIC",
              "privilege": "EVOLVE SCHEMA"
            }
          }
        ]
      }
    }
  ]
}

databaseChangeLog:
  # Grant SELECT on all tables
  - changeSet:
      id: bulk-grant-tables
      author: examples
      changes:
        - bulkGrantPrivilegeToShare:
            shareName: MY_SHARE
            objectType: TABLE
            catalogName: MY_DATABASE
            schemaName: PUBLIC
            privilege: SELECT

  # Grant SELECT on all external tables
  - changeSet:
      id: bulk-grant-external-tables
      author: examples
      changes:
        - bulkGrantPrivilegeToShare:
            shareName: MY_SHARE
            objectType: EXTERNAL_TABLE
            catalogName: MY_DATABASE
            schemaName: STAGING
            privilege: SELECT

  # Grant EVOLVE SCHEMA on all tables
  - changeSet:
      id: bulk-grant-evolve-schema
      author: examples
      changes:
        - bulkGrantPrivilegeToShare:
            shareName: MY_SHARE
            objectType: TABLE
            catalogName: MY_DATABASE
            schemaName: PUBLIC
            privilege: EVOLVE SCHEMA

--liquibase formatted sql

--changeset examples:grant-select-on-all-tables
-- Grant SELECT on all tables
GRANT SELECT ON ALL TABLES IN SCHEMA MY_DATABASE.PUBLIC TO SHARE MY_SHARE;

--changeset examples:grant-select-on-all-external-tables
-- Grant SELECT on all external tables
GRANT SELECT ON ALL EXTERNAL TABLES IN SCHEMA MY_DATABASE.STAGING TO SHARE MY_SHARE;

--changeset examples:grant-select-on-all-dynamic-tables
-- Grant SELECT on all dynamic tables
GRANT SELECT ON ALL DYNAMIC TABLES IN SCHEMA MY_DATABASE.ANALYTICS TO SHARE MY_SHARE;

--changeset examples:grant-evolve-schema-on-all-tables
-- Grant EVOLVE SCHEMA on all tables
GRANT EVOLVE SCHEMA ON ALL TABLES IN SCHEMA MY_DATABASE.PUBLIC TO SHARE MY_SHARE;

<?xml version="1.0" encoding="UTF-8"?>
<databaseChangeLog
        xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
        xmlns:pro-snowflake="http://www.liquibase.org/xml/ns/pro-snowflake"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
        http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd
        http://www.liquibase.org/xml/ns/pro-snowflake
        http://www.liquibase.org/xml/ns/pro-snowflake/liquibase-pro-snowflake-latest.xsd">

    <!-- Grant SELECT on all tables -->
    <changeSet id="bulk-grant-tables" author="examples">
        <pro-snowflake:bulkGrantPrivilegeToShare
                shareName="MY_SHARE"
                objectType="TABLE"
                catalogName="MY_DATABASE"
                schemaName="PUBLIC"
                privilege="SELECT"/>
    </changeSet>

    <!-- Grant SELECT on all external tables -->
    <changeSet id="bulk-grant-external-tables" author="examples">
        <pro-snowflake:bulkGrantPrivilegeToShare
                shareName="MY_SHARE"
                objectType="EXTERNAL_TABLE"
                catalogName="MY_DATABASE"
                schemaName="STAGING"
                privilege="SELECT"/>
    </changeSet>

    <!-- Grant SELECT on all dynamic tables -->
    <changeSet id="bulk-grant-dynamic-tables" author="examples">
        <pro-snowflake:bulkGrantPrivilegeToShare
                shareName="MY_SHARE"
                objectType="DYNAMIC_TABLE"
                catalogName="MY_DATABASE"
                schemaName="ANALYTICS"
                privilege="SELECT"/>
    </changeSet>

    <!-- Grant EVOLVE SCHEMA on all tables -->
    <changeSet id="bulk-grant-evolve-schema" author="examples">
        <pro-snowflake:bulkGrantPrivilegeToShare
                shareName="MY_SHARE"
                objectType="TABLE"
                catalogName="MY_DATABASE"
                schemaName="PUBLIC"
                privilege="EVOLVE SCHEMA"/>
    </changeSet>

</databaseChangeLog>

{
  "databaseChangeLog": [
    {
      "changeSet": {
        "id": "bulk-grant-tables",
        "author": "examples",
        "changes": [
          {
            "bulkGrantPrivilegeToShare": {
              "shareName": "MY_SHARE",
              "objectType": "TABLE",
              "catalogName": "MY_DATABASE",
              "schemaName": "PUBLIC",
              "privilege": "SELECT"
            }
          }
        ]
      }
    },
    {
      "changeSet": {
        "id": "bulk-grant-external-tables",
        "author": "examples",
        "changes": [
          {
            "bulkGrantPrivilegeToShare": {
              "shareName": "MY_SHARE",
              "objectType": "EXTERNAL_TABLE",
              "catalogName": "MY_DATABASE",
              "schemaName": "STAGING",
              "privilege": "SELECT"
            }
          }
        ]
      }
    },
    {
      "changeSet": {
        "id": "bulk-grant-evolve-schema",
        "author": "examples",
        "changes": [
          {
            "bulkGrantPrivilegeToShare": {
              "shareName": "MY_SHARE",
              "objectType": "TABLE",
              "catalogName": "MY_DATABASE",
              "schemaName": "PUBLIC",
              "privilege": "EVOLVE SCHEMA"
            }
          }
        ]
      }
    }
  ]
}

databaseChangeLog:
  # Grant SELECT on all tables
  - changeSet:
      id: bulk-grant-tables
      author: examples
      changes:
        - bulkGrantPrivilegeToShare:
            shareName: MY_SHARE
            objectType: TABLE
            catalogName: MY_DATABASE
            schemaName: PUBLIC
            privilege: SELECT

  # Grant SELECT on all external tables
  - changeSet:
      id: bulk-grant-external-tables
      author: examples
      changes:
        - bulkGrantPrivilegeToShare:
            shareName: MY_SHARE
            objectType: EXTERNAL_TABLE
            catalogName: MY_DATABASE
            schemaName: STAGING
            privilege: SELECT

  # Grant EVOLVE SCHEMA on all tables
  - changeSet:
      id: bulk-grant-evolve-schema
      author: examples
      changes:
        - bulkGrantPrivilegeToShare:
            shareName: MY_SHARE
            objectType: TABLE
            catalogName: MY_DATABASE
            schemaName: PUBLIC
            privilege: EVOLVE SCHEMA

--liquibase formatted sql

--changeset examples:grant-select-on-all-tables
-- Grant SELECT on all tables
GRANT SELECT ON ALL TABLES IN SCHEMA MY_DATABASE.PUBLIC TO SHARE MY_SHARE;

--changeset examples:grant-select-on-all-external-tables
-- Grant SELECT on all external tables
GRANT SELECT ON ALL EXTERNAL TABLES IN SCHEMA MY_DATABASE.STAGING TO SHARE MY_SHARE;

--changeset examples:grant-select-on-all-dynamic-tables
-- Grant SELECT on all dynamic tables
GRANT SELECT ON ALL DYNAMIC TABLES IN SCHEMA MY_DATABASE.ANALYTICS TO SHARE MY_SHARE;

--changeset examples:grant-evolve-schema-on-all-tables
-- Grant EVOLVE SCHEMA on all tables
GRANT EVOLVE SCHEMA ON ALL TABLES IN SCHEMA MY_DATABASE.PUBLIC TO SHARE MY_SHARE;

PreviousAlterWarehouseTags NextBulkRevokePrivilegeFromShare

bulkGrantPrivilegeToShare

Available attributes

Prerequisites

XML

JSON

YAML

SQL

More like this