ALTER BUDGET

完全修飾名: SNOWFLAKE.CORE.BUDGET

カスタム 予算のプロパティを変更します。

  • 予算名を変更します。

  • タグを設定または解除します。

  • コメントを設定または解除します。

こちらもご参照ください。

CREATE BUDGET、 SHOW BUDGET、 DROP 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> ... ]
Copy

パラメーター

name

予算の識別子（つまり名前）を指定します。

識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

詳細については、 識別子の要件 をご参照ください。

SET ...

設定する1つ以上の予算プロパティを指定します。

COMMENT = 'string_literal'

予算のコメントを設定します。これは、 COMMENT コマンドを使用しても実行できます。

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

タグ の名前とタグ文字列の値を指定します。

タグ値は常に文字列であり、タグ値の最大文字数は256です。

ステートメントでのタグの指定に関する情報については、 オブジェクトおよび列のタグクォータ をご参照ください。

UNSET ...

予算の設定を解除する1つ（または複数）のプロパティおよび/またはパラメーターを指定します。これにより、デフォルトにリセットされます。

  • COMMENT

  • TAG tag_name [ , tag_name ... ]

アクセス制御の要件

この SQL コマンドの実行に使用される ロール には、少なくとも次の 権限 が必要です。

権限/ロール

オブジェクト

メモ

ADMIN

予算

カスタム予算のプロパティを変更するために使用するロールには、この インスタンスロール が付与されている必要があります。

スキーマ内の任意のオブジェクトを操作するには、親データベースとスキーマに対する USAGE 権限も必要であることに注意してください。

詳細については、 Budgetのロールと権限 をご参照ください。

使用上の注意

  • カスタム 予算のプロパティのみを変更できます。

  • このクラスを非修飾名で参照するには、 検索パス にクラスのデータベースとスキーマを含めます。

例

現在のスキーマで予算 my_budget のタグ dept を設定します。

ALTER SNOWFLAKE.CORE.BUDGET my_budget SET TAG dept = 'finance';
Copy
言語: 日本語