sp_rename_qpgroup

Renames an abstract plan group.

Syntax

sp_rename_qpgroup old_name, new_name

Parameters

Examples

Usage

There are additional considerations when using sp_rename_qpgroup:
  • Use sp_rename_qpgroup to rename an abstract plan group. You cannot use the name of an existing plan group for the new name.

  • sp_rename_qpgroup does not affect the contents of the renamed group. IDs of existing abstract plans are not changed.

  • You cannot rename the default abstract plan groups, ap_stdin and ap_stdout.

  • sp_rename_qpgroup cannot be run in a transaction.

Permissions

The permission checks for sp_rename_qpgroup differ based on your granular permissions settings.

SettingDescription
Enabled

With granular permissions enabled, you must be a user with manage abstract plans privilege.

Disabled

With granular permissions disabled, you must be the database owner or a user with sa_role.

Auditing

Values in event and extrainfo columns from the sysaudits table are:

InformationValues
Event

38

Audit option

exec_procedure

Command or access audited

Execution of a procedure

Information in extrainfo
  • Roles – Current active roles

  • Keywords or options – NULL

  • Previous value – NULL

  • Current value – NULL

  • Other information – All input parameters

  • Proxy information – Original login name, if set proxy in effect

Related reference
sp_help_qpgroup