Skip to main content

server_advisors

Creates, updates, deletes, gets or lists a server_advisors resource.

Overview

Nameserver_advisors
TypeResource
Idazure.sql.server_advisors

Fields

The following fields are returned by SELECT queries:

Successfully retrieved details of specified server advisor.

NameDatatypeDescription
kindstringResource kind.
locationstringResource location.
propertiesobjectResource properties.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectresourceGroupName, serverName, advisorName, subscriptionIdGets a server advisor.
updateupdateresourceGroupName, serverName, advisorName, subscriptionIdUpdates a server advisor.
list_by_serverexecresourceGroupName, serverName, subscriptionId$expandGets a list of server advisors.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
advisorNamestringThe name of the Server Advisor.
resourceGroupNamestringThe name of the resource group that contains the resource. You can obtain this value from the Azure Resource Manager API or the portal.
serverNamestringThe name of the server.
subscriptionIdstringThe subscription ID that identifies an Azure subscription.
$expandstringThe child resources to include in the response.

SELECT examples

Gets a server advisor.

SELECT
kind,
location,
properties
FROM azure.sql.server_advisors
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND serverName = '{{ serverName }}' -- required
AND advisorName = '{{ advisorName }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
;

UPDATE examples

Updates a server advisor.

UPDATE azure.sql.server_advisors
SET
data__properties = '{{ properties }}'
WHERE
resourceGroupName = '{{ resourceGroupName }}' --required
AND serverName = '{{ serverName }}' --required
AND advisorName = '{{ advisorName }}' --required
AND subscriptionId = '{{ subscriptionId }}' --required
RETURNING
kind,
location,
properties;

Lifecycle Methods

Gets a list of server advisors.

EXEC azure.sql.server_advisors.list_by_server 
@resourceGroupName='{{ resourceGroupName }}' --required,
@serverName='{{ serverName }}' --required,
@subscriptionId='{{ subscriptionId }}' --required,
@$expand='{{ $expand }}'
;