CREATE SNOWFLAKE.CORE.BUDGET¶
Creates a new budget instance or replaces and existing budget instance in the current or specified schema.
Syntax¶
CREATE [ OR REPLACE ] SNOWFLAKE.CORE.BUDGET [ IF NOT EXISTS ] <name> ()
[ [ WITH ] COMMENT = '<string_literal>' ]
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.