<budget_name>!REMOVE_TAG

カスタム予算からタグと値の組み合わせを削除します。タグは 参照 で削除する必要があります。

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

<budget_name>!ADD_TAG、 <budget_name>!GET_LINKED_TAGS

構文

<budget_name>!REMOVE_TAG(
    { '<tag_reference>' | <reference_statement> },
    'tag_value' )
Copy

引数

'tag_reference'

タグが解決先のシリアライズされた文字列表現。この文字列は SYSTEM$REFERENCE 関数の出力です。

reference_statement

予算から削除するタグへの参照を作成する SYSTEM$REFERENCE ステートメント。

'tag_value'

予算から削除するタグと値の組み合わせの値を指定します。

タグが別の値で予算に追加された場合、この特定のタグと値の組み合わせを削除した後も、タグは予算に関連付けられ続けます。

戻り値

タグが予算から正常に削除されたかどうかを示す VARCHAR 値を返します。

タグを予算から削除できなかった場合、関数はエラーメッセージを返します。

アクセス制御の要件

カスタム予算 でこのメソッドを呼び出すには、以下の最小権限とロールが必要です。

  • 予算インスタンスの ADMIN インスタンスロール。

  • 予算インスタンスを含んでいるデータベースとスキーマに対する USAGE 権限。

  • タグを含むデータベースとスキーマに対するUSAGE権限。

  • APPLYBUDGET 削除されたタグに対する権限。

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

使用上の注意

  • このメソッドは カスタム予算 インスタンスに対してのみ呼び出すことができます。

  • このメソッドを呼び出しても、オブジェクトは返されません。このため、メソッドの連結を使って、このメソッドの戻り値で別のメソッドを呼び出すことはできません。換わりに、各メソッドを別々の SQL ステートメントで呼び出します。

例

メソッドを呼び出す前に、タグ参照を取得して、タグ/値の組み合わせを削除します。

以下のステートメントでは、 cost_center テーブルの参照を作成して返します。

SELECT SYSTEM$REFERENCE(
  'TAG',
  'cost_mgmt_db.tags.cost_center',
  'SESSION',
  'APPLYBUDGET');
Copy

ステートメントは出力に参照を返します。

ENT_REF_TAG_10382726315710_8A8626AE765E29446C38A217CAD093FCC9A454C2

次のステートメントは、この参照に文字列リテラルを使用して、 cost_center = 'sales' タグ/値の組み合わせを budget_db.budget_schema.my_budget 予算に追加します。

CALL budget_db.budget_schema.my_budget!REMOVE_TAG(
  'ENT_REF_TAG_10382726315710_8A8626AE765E29446C38A217CAD093FCC9A454C2',
  'sales');
Copy
SYSTEM$REFERENCE 関数を引数に直接を含めます

次のステートメントを実行すると、予算はタグ/値の組み合わせでタグ付けされたオブジェクトを追跡しなくなります team_tag = 'finance'.

CALL budget_db.budget_schema.my_budget!REMOVE_TAG(
    (SELECT SYSTEM$REFERENCE('TAG', 'cost_mgmt_db.tags.team_tag', 'SESSION', 'APPLYBUDGET')),
    'finance');
Copy
言語: 日本語