CREATE SNOWFLAKE.CORE.BUDGET¶

Creates a new budget instance or replaces and existing budget instance in the current or specified schema.

See also:: SYSTEM$SHOW_BUDGETS_IN_ACCOUNT, DROP SNOWFLAKE.CORE.BUDGET

Syntax¶

CREATE [ OR REPLACE ] SNOWFLAKE.CORE.BUDGET [ IF NOT EXISTS ] <name> ()
  [ [ WITH ] COMMENT = '<string_literal>' ]

Copy

Parameters¶

name:

Specifies the identifier for the budget. The identifier must start with an alphabetic character and cannot contain spaces or special characters unless the identifier string is enclosed in double quotes (e.g. "My object"). Identifiers enclosed in double quotes are also case-sensitive.

For more details, refer to Identifier requirements.

Optional Parameters¶

COMMENT = 'string_literal':: Specifies a comment for the budget.

Access Control Requirements¶

A role used to execute this SQL command must have the following privileges at a minimum:

Privilege / Role	Object	Notes
CREATE SNOWFLAKE.CORE.BUDGET privilege	Schema	The role used to create a budget must be granted this privilege on the schema in which the budget is created.
SNOWFLAKE.BUDGET_CREATOR database role	Role	The role used to create a budget must be granted this database role.

Note that operating on any object in a schema also requires the USAGE privilege on the parent database and schema.

For instructions on creating a custom role with a specified set of privileges, see Creating Custom Roles.

For general information about roles and privilege grants for performing SQL actions on securable objects, see Overview of Access Control.

Usage Notes¶

Replication of class instances is currently not supported.
An account can contain a maximum of 100 custom budgets.

Examples¶

Create budget my_budget in the current schema:

CREATE SNOWFLAKE.CORE.BUDGET my_budget();

Copy