DROP ROUTE (Transact-SQL)
Applies to: SQL Server Azure SQL Managed Instance
Drops a route, deleting the information for the route from the routing table of the current database.
Transact-SQL syntax conventions
Syntax
DROP ROUTE route_name
[ ; ]
Arguments
route_name
The name of the route to drop. Server, database, and schema names cannot be specified.
Remarks
The routing table that stores the routes is a metadata table that can be read through the catalog view sys.routes. The routing table can only be updated through the CREATE ROUTE, ALTER ROUTE, and DROP ROUTE statements.
You can drop a route regardless of whether any conversations use the route. However, if there is no other route to the remote service, messages for those conversations will remain in the transmission queue until a route to the remote service is created or the conversation times out.
Permissions
Permission for dropping a route defaults to the owner of the route, members of the db_ddladmin or db_owner fixed database roles, and members of the sysadmin fixed server role.
Examples
The following example deletes the ExpenseRoute
route.
DROP ROUTE ExpenseRoute ;
See Also
ALTER ROUTE (Transact-SQL)
CREATE ROUTE (Transact-SQL)
EVENTDATA (Transact-SQL)
sys.routes (Transact-SQL)