ALTER BUDGET¶
完全修飾名: SNOWFLAKE.CORE.BUDGET
カスタム 予算のプロパティを変更します。
予算名を変更します。
タグを設定または解除します。
コメントを設定または解除します。
- こちらもご参照ください。
構文¶
ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> RENAME TO <new_name>
ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'
ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> UNSET COMMENT
ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]
ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> UNSET TAG <tag_name> [ , <tag_name> ... ]
パラメーター¶
name予算の識別子(つまり名前)を指定します。
識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。
詳細については、 識別子の要件 をご参照ください。
SET ...設定する1つ以上の予算プロパティを指定します。
COMMENT = 'string_literal'予算のコメントを設定します。これは、 COMMENT コマンドを使用しても実行できます。
TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]タグ の名前とタグ文字列の値を指定します。
タグ値は常に文字列であり、タグ値の最大文字数は256です。
ステートメントでのタグの指定に関する情報については、 Tag quotas をご参照ください。
UNSET ...予算の設定を解除する1つ(または複数)のプロパティおよび/またはパラメーターを指定します。これにより、デフォルトにリセットされます。
COMMENTTAG tag_name [ , tag_name ... ]
アクセス制御の要件¶
この操作の実行に使用される ロール には、少なくとも次の 権限 が必要です。
権限/ロール |
オブジェクト |
注意 |
|---|---|---|
ADMIN |
予算 |
カスタム予算のプロパティを変更するために使用するロールには、この インスタンスロール が付与されている必要があります。 |
Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.
詳細については、 Budgetのロールと権限 をご参照ください。
使用上の注意¶
カスタム 予算のプロパティのみを変更できます。
このクラスを非修飾名で参照するには、 検索パス にクラスのデータベースとスキーマを含めます。
例¶
現在のスキーマで予算 my_budget のタグ dept を設定します。
ALTER SNOWFLAKE.CORE.BUDGET my_budget SET TAG dept = 'finance';