| title | sp_external_policy_refresh (Transact-SQL) | ||
|---|---|---|---|
| description | Reference documentation to explain sp_external_policy_refresh (Transact-SQL) system stored procedure. | ||
| author | srdan-bozovic-msft | ||
| ms.author | srbozovi | ||
| ms.reviewer | randolphwest | ||
| ms.date | 06/23/2025 | ||
| ms.service | sql | ||
| ms.subservice | system-objects | ||
| ms.topic | reference | ||
| f1_keywords |
|
||
| helpviewer_keywords |
|
||
| dev_langs |
|
[!INCLUDE sqlserver2022]
Forces immediate download of latest published policies for the whole instance (for every database).
Note
If there are any ongoing pull requests by the background task or by another user, the request waits until the former task is finished and starts a new pull. – This ensures that the result of calling this proc explicitly always results in a refreshed cache.
sp_external_policy_refresh [ @type = ] 'type'
[ ; ]
[!INCLUDE extended-stored-procedures]
Type can be reload (complete policy download) or update (incremental policy download). Default type is update.
0 (success) or a nonzero number (failure).
Requires ALTER SERVER STATE (covered by CONTROL SERVER) permission.
The following example downloads complete set of policies.
EXECUTE sp_external_policy_refresh @type = 'reload';The following example downloads policies incrementally by using the default type 'update'.
EXECUTE sp_external_policy_refresh;