CREATE BUDGET¶
Fully qualified name: SNOWFLAKE.CORE.BUDGET
Creates a new budget instance or replaces and existing budget instance in the current or specified schema.
- See also:
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 |
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 |
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 more information, see Budgets roles and privileges.
Usage notes¶
To refer to this class by its unqualified name, include the database and schema of the class in your search path.
Replication isn’t supported for class instances except for instances of the CUSTOM_CLASSIFIER class.
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();