Broker priorities
A broker priority defines a priority level and the set of criteria for determining which Service Broker conversations to assign the priority level.
In Database Explorer, you can perform operations on broker priorities by using the shortcut menu. Right-click a broker priority in Database Explorer to access commands for specific tasks, such as editing, deleting broker priorities, or generating scripts for them.
Create a broker priority
You can create a broker priority in SQL Editor in one of these ways:
- Code completion to write a script.
- SQL snippets to insert predefined or custom code.
Edit a broker priority
1. In Database Explorer, right-click the broker priority you want to update and select Modify via SQL.
2. In a SQL document, update the ALTER BROKER PRIORITY statement.
3. On the SQL toolbar, click Execute or press F5.
Delete a broker priority
1. In Database Explorer, right-click the broker priority you want to delete and select Delete, or press Delete.
2. Click Yes to confirm the deletion.
Note
You cannot undo the drop operation, as this action permanently deletes the broker priority. To avoid data loss, back up the database before deleting the broker priority.
Generate a script for a broker priority
1. In Database Explorer, right-click a required broker priority and select Generate Script As, then select the statement type.
2. Select one of the following output options:
- To New SQL Window – Opens the script in a new SQL document.
- To File – Generates the script to a .sql file.
- To Clipboard – Copies the script to the clipboard.
For more information, see Generate the DDL and DML statements for database objects.
View broker priority properties
To view broker priority properties, in Database Explorer, right-click the broker priority or Broker Priorities node and select Show Details.
Object Viewer opens, displaying detailed information about the broker priority.
Refresh the broker priority
To update the broker priority to reflect the latest changes, in Database Explorer, right-click the broker priority or Broker Priorities node and select Refresh, or press F5.
Open the Properties window
To open the Properties window, in Database Explorer, right-click the broker priority and select Properties, or press F4.
Filter broker priorities
1. In Database Explorer, right-click the Broker Priorities node and select Filter.
2. In the Filter Settings (Broker Priorities) dialog, configure the filter parameters.
3. Click OK to apply the filter.
Note
When you open the Broker Priorities node, the number of objects it contains appears in parentheses next to the node name. This number changes based on your filter settings.
Shortcut menu options for a specific broker priority
The following table describes the shortcut menu options, which appear when you right-click a specific broker priority in Database Explorer.
| Name | Description |
|---|---|
| Modify via SQL | Opens the existing broker priority in a new SQL document containing an ALTER BROKER PRIORITY statement to update it. |
| Source Control > Source Control Manager | Opens Source Control Manager, where you can track and manage changes to database schema and static data. When Source Control Manager is already open, this option refreshes it. |
| Source Control > Commit | Opens Source Control Manager with all local changes (if any) selected and ready to commit. When Source Control Manager is already open, this option refreshes it and selects all local database changes. |
| Source Control > Get Latest | Opens Source Control Manager with all remote changes (if any) selected, ready to pull using Get Latest. When Source Control Manager is already open, this option refreshes it and selects all remote database changes. |
| Generate Script As | Generates a script of the selected object using the CREATE, DROP, DROP and CREATE, and ALTER statements. The script can be saved to a new SQL document or to a file, or copied to the clipboard. |
| Show Details | Opens Object Viewer that displays object details. |
| Delete | Drops the selected object from the database. Shortcut: Delete |
| Refresh | Updates the object to reflect the latest changes. Shortcut: F5 |
| Properties | Opens the Properties pane to view the object information. Shortcut: F4 |
Shortcut menu options for the Broker Priorities node
The following table describes the shortcut menu options, which appear when you right-click the Broker Priorities node in Database Explorer.
| Name | Description |
|---|---|
| Source Control > Source Control Manager | Opens Source Control Manager, where you can track and manage changes to database schema and static data. When Source Control Manager is already open, this option refreshes it. |
| Source Control > Commit | Opens Source Control Manager with all local changes (if any) selected and ready to commit. When Source Control Manager is already open, this option refreshes it and selects all local database changes. |
| Source Control > Get Latest | Opens Source Control Manager with all remote changes (if any) selected, ready to pull using Get Latest. When Source Control Manager is already open, this option refreshes it and selects all remote database changes. |
| Filter | Opens the Filter Settings dialog to control which broker priorities should appear in Database Explorer. |
| Show Details | Opens Object Viewer that displays object details. |
| Refresh | Updates the object to reflect the latest changes. Shortcut: F5 |
Note
The Source Control shortcut menu is available only after you link the corresponding database to a source-control system.
Bulk operations
In Database Explorer, hold down Ctrl and select multiple broker priorities. Then right-click the selection and select the required option.
The following table describes the shortcut menu options available for multiple broker priorities.
| Name | Description |
|---|---|
| Source Control > Source Control Manager | Opens Source Control Manager, where you can track and manage changes to database schema and static data. When Source Control Manager is already open, this option refreshes it. |
| Source Control > Commit | Opens Source Control Manager with all local changes (if any) selected and ready to commit. When Source Control Manager is already open, this option refreshes it and selects all local database changes. |
| Source Control > Get Latest | Opens Source Control Manager with all remote changes (if any) selected, ready to pull using Get Latest. When Source Control Manager is already open, this option refreshes it and selects all remote database changes. |
| Source Control > Link/Unlink Static Data | Opens the Source Control Link Static Data dialog that displays the tables whose data you want to link. |
| Generate Script As | Generates scripts of the selected objects using the CREATE, DROP, DROP and CREATE, and ALTER statements. The scripts can be generated to a new SQL document or to a file, or copied to the clipboard. |
| Delete | Drops the selected broker priorities from the database. Shortcut: Delete |
