Server Advisors - Update

Reference

Služba:: SQL Database

Verze rozhraní API:: 2021-11-01

Aktualizace poradce serveru.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/advisors/{advisorName}?api-version=2021-11-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
advisorName	path	True	string	Název poradce serveru.
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo z portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name	Vyžadováno	Typ	Description
properties.autoExecuteStatus	True	AutoExecuteStatus	Získá stav automatického spuštění (zda nechat systém provádět doporučení) tohoto poradce. Možné hodnoty jsou Povoleno a Zakázáno.

Odpovědi

Name	Typ	Description
200 OK	Advisor	Zadaný poradce serveru se úspěšně aktualizoval.
Other Status Codes		Chybové odpovědi: *** 400 FeatureDisabledOnSelectedEdition – uživatel se pokusil použít funkci, která je v aktuální edici databáze zakázaná. 400 InvalidIdentifier – identifikátor obsahuje null nebo neplatný znak unicode. 400 DataWarehouseNotSupported – automatické ladění sql Data Warehouse nepodporuje. 400 InvalidAdvisorUpsertRequest – text žádosti poradce pro aktualizaci neexistuje nebo nemá žádný objekt vlastností. 400 InvalidAdvisorAutoExecuteStatus – zadaný stav automatického spuštění poradce není povolen. 404 DatabaseDoesNotExist – Požadovaná databáze nebyla nalezena. 404 SubscriptionDoesNotHaveServer – požadovaný server nebyl nalezen. 404 SubscriptionDoesNotHaveElasticPool – požadovaný elastický fond nebyl nalezen. 404 AdvisorNotFound – požadovaný poradce nebyl nalezen. 404 AutomaticTuningOptionNotFound – Požadovaná možnost automatického ladění nebyla nalezena. 405 NotSupported –Tato funkce není podporovaná. 409 Konflikt – Požadavek nelze zpracovat kvůli konfliktu v požadavku. 409 DefaultAdvisorStateNotAllowedInCustomServerMode – výchozí stav poradce není ve vlastním režimu povolený. 409 UpdateNotAllowedIfServerAutotuningUpdateOperationInProgress – nastavení automatického ladění z předchozího požadavku se nerozšířilo do všech uživatelských databází. 503 ServiceTemporarilyUnavailable – funkce dočasně nedostupná.

Name

Typ

Description

200 OK

Advisor

Zadaný poradce serveru se úspěšně aktualizoval.

Other Status Codes

Chybové odpovědi: ***

400 FeatureDisabledOnSelectedEdition – uživatel se pokusil použít funkci, která je v aktuální edici databáze zakázaná.
400 InvalidIdentifier – identifikátor obsahuje null nebo neplatný znak unicode.
400 DataWarehouseNotSupported – automatické ladění sql Data Warehouse nepodporuje.
400 InvalidAdvisorUpsertRequest – text žádosti poradce pro aktualizaci neexistuje nebo nemá žádný objekt vlastností.
400 InvalidAdvisorAutoExecuteStatus – zadaný stav automatického spuštění poradce není povolen.
404 DatabaseDoesNotExist – Požadovaná databáze nebyla nalezena.
404 SubscriptionDoesNotHaveServer – požadovaný server nebyl nalezen.
404 SubscriptionDoesNotHaveElasticPool – požadovaný elastický fond nebyl nalezen.
404 AdvisorNotFound – požadovaný poradce nebyl nalezen.
404 AutomaticTuningOptionNotFound – Požadovaná možnost automatického ladění nebyla nalezena.
405 NotSupported –Tato funkce není podporovaná.
409 Konflikt – Požadavek nelze zpracovat kvůli konfliktu v požadavku.
409 DefaultAdvisorStateNotAllowedInCustomServerMode – výchozí stav poradce není ve vlastním režimu povolený.
409 UpdateNotAllowedIfServerAutotuningUpdateOperationInProgress – nastavení automatického ladění z předchozího požadavku se nerozšířilo do všech uživatelských databází.
503 ServiceTemporarilyUnavailable – funkce dočasně nedostupná.

Příklady

Update server advisor

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/advisors/CreateIndex?api-version=2021-11-01

{
  "properties": {
    "autoExecuteStatus": "Disabled"
  }
}


import com.azure.resourcemanager.sql.fluent.models.AdvisorInner;
import com.azure.resourcemanager.sql.models.AutoExecuteStatus;

/**
 * Samples for ServerAdvisors Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerAdvisorUpdate.json
     */
    /**
     * Sample code: Update server advisor.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateServerAdvisor(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerAdvisors().updateWithResponse("workloadinsight-demos",
            "misosisvr", "CreateIndex", new AdvisorInner().withAutoExecuteStatus(AutoExecuteStatus.DISABLED),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Ukázková odpověď

Stavový kód:: 200

{
  "kind": "",
  "properties": {
    "advisorStatus": "GA",
    "autoExecuteStatus": "Disabled",
    "autoExecuteStatusInheritedFrom": "Server"
  },
  "location": "East Asia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/advisors/CreateIndex",
  "name": "CreateIndex",
  "type": "Microsoft.Sql/servers/advisors"
}

Definice

Name	Description
Advisor	Poradce pro databáze, server nebo elastický fond.
AdvisorStatus	Získá stav dostupnosti tohoto poradce pro zákazníky. Možné hodnoty jsou GA, PublicPreview, LimitedPublicPreview a PrivatePreview.
AutoExecuteStatus	Získá stav automatického spuštění (zda nechat systém provádět doporučení) tohoto poradce. Možné hodnoty jsou Povoleno a Zakázáno.
AutoExecuteStatusInheritedFrom	Získá prostředek, ze kterého je zděděna aktuální hodnota stavu automatického spuštění. Stav automatického spuštění je možné nastavit na různých úrovních v hierarchii prostředků (a zdědit z toho). Možné hodnoty jsou Subscription, Server, ElasticPool, Database a Default (pokud stav není explicitně nastaven na žádné úrovni).
ImplementationMethod	Získá metodu, ve které lze tuto doporučenou akci ručně implementovat. např. TSql, AzurePowerShell.
IsRetryable	Získá, zda by chyba mohla být ignorována a doporučená akce by mohla být zopakována. Možné hodnoty jsou: Ano/Ne
RecommendedAction	Doporučená akce databáze, serveru nebo elastického fondu
RecommendedActionCurrentState	Aktuální stav, ve který je doporučená akce. Mezi běžně používané stavy patří: Aktivní –> doporučená akce je aktivní a zatím nebyla provedena žádná akce. Čeká na vyřízení –> doporučená akce je schválená pro a čeká na provedení. Provádění –> u uživatelské databáze se používá doporučená akce. Ověření –> byla použita doporučená akce, která ověřuje její užitečnost systémem. Úspěch –> byla použita doporučená akce a během ověřování bylo nalezeno zlepšení. Čeká se na vrácení –> ověření zjistilo jen malé nebo žádné zlepšení, takže doporučená akce je zařazena do fronty pro vrácení zpět nebo se uživatel vrátil ručně. Vrácení zpět –> změny provedené při použití doporučené akce se v uživatelské databázi vrací. Vráceno –> úspěšně se vrátily změny provedené doporučenou akcí v uživatelské databázi. Ignorováno –> uživatel doporučenou akci explicitně ignoroval nebo zahodil.
RecommendedActionErrorInfo	Obsahuje informace o chybách pro doporučenou akci Azure SQL databáze, serveru nebo elastického fondu.
RecommendedActionImpactRecord	Obsahuje informace o odhadovaném nebo zjištěném dopadu na různé metriky doporučené akce Azure SQL databáze, serveru nebo elastického fondu.
RecommendedActionImplementationInfo	Obsahuje informace pro ruční implementaci doporučené akce Azure SQL databáze, serveru nebo elastického fondu.
RecommendedActionInitiatedBy	Získá, kdo inicioval provedení této doporučené akce. Možné hodnoty jsou: Uživatel –> když uživatel explicitně oznámí systému, aby použil doporučenou akci. Systém –> když byl stav automatického spuštění tohoto poradce nastavený na Povoleno, v takovém případě ho systém použil.
RecommendedActionMetricInfo	Obsahuje časové řady různých ovlivněných metrik pro doporučenou akci Azure SQL databáze, serveru nebo elastického fondu.
RecommendedActionStateInfo	Obsahuje informace o aktuálním stavu doporučené akce Azure SQL databáze, serveru nebo elastického fondu.

Advisor

Poradce pro databáze, server nebo elastický fond.

Name	Typ	Description
id	string	ID prostředku.
kind	string	Druh prostředku.
location	string	Umístění prostředku.
name	string	Název prostředku.
properties.advisorStatus	AdvisorStatus	Získá stav dostupnosti tohoto poradce pro zákazníky. Možné hodnoty jsou GA, PublicPreview, LimitedPublicPreview a PrivatePreview.
properties.autoExecuteStatus	AutoExecuteStatus	Získá stav automatického spuštění (zda nechat systém provádět doporučení) tohoto poradce. Možné hodnoty jsou Povoleno a Zakázáno.
properties.autoExecuteStatusInheritedFrom	AutoExecuteStatusInheritedFrom	Získá prostředek, ze kterého je zděděna aktuální hodnota stavu automatického spuštění. Stav automatického spuštění je možné nastavit na různých úrovních v hierarchii prostředků (a zdědit z toho). Možné hodnoty jsou Subscription, Server, ElasticPool, Database a Default (pokud stav není explicitně nastaven na žádné úrovni).
properties.lastChecked	string	Získá čas, kdy byl aktuální prostředek analyzován pro doporučení tímto poradcem.
properties.recommendationsStatus	string	Získá tento stav doporučení pro tohoto poradce a důvod, proč nemáte žádná doporučení. Mezi možné hodnoty patří mimo jiné ok (dostupná doporučení), nízká aktivita (nedostatek úloh k analýze), DbSeemsTuned (databáze si vede dobře) atd.
properties.recommendedActions	RecommendedAction[]	Získá doporučené akce pro tohoto poradce.
type	string	Typ prostředku.

AdvisorStatus

Získá stav dostupnosti tohoto poradce pro zákazníky. Možné hodnoty jsou GA, PublicPreview, LimitedPublicPreview a PrivatePreview.

Name	Typ	Description
GA	string
LimitedPublicPreview	string
PrivatePreview	string
PublicPreview	string

AutoExecuteStatus

Získá stav automatického spuštění (zda nechat systém provádět doporučení) tohoto poradce. Možné hodnoty jsou Povoleno a Zakázáno.

Name	Typ	Description
Default	string
Disabled	string
Enabled	string

AutoExecuteStatusInheritedFrom

Získá prostředek, ze kterého je zděděna aktuální hodnota stavu automatického spuštění. Stav automatického spuštění je možné nastavit na různých úrovních v hierarchii prostředků (a zdědit z toho). Možné hodnoty jsou Subscription, Server, ElasticPool, Database a Default (pokud stav není explicitně nastaven na žádné úrovni).

Name	Typ	Description
Database	string
Default	string
ElasticPool	string
Server	string
Subscription	string

ImplementationMethod

Získá metodu, ve které lze tuto doporučenou akci ručně implementovat. např. TSql, AzurePowerShell.

Name	Typ	Description
AzurePowerShell	string
TSql	string

IsRetryable

Získá, zda by chyba mohla být ignorována a doporučená akce by mohla být zopakována. Možné hodnoty jsou: Ano/Ne

Name	Typ	Description
No	string
Yes	string

RecommendedAction

Doporučená akce databáze, serveru nebo elastického fondu

Name	Typ	Description
id	string	ID prostředku.
kind	string	Druh prostředku.
location	string	Umístění prostředku.
name	string	Název prostředku.
properties.details	object	Získá další podrobnosti specifické pro tuto doporučenou akci.
properties.errorDetails	RecommendedActionErrorInfo	Získá podrobnosti o chybě, pokud a proč je tato doporučená akce uvedena do chybového stavu.
properties.estimatedImpact	RecommendedActionImpactRecord[]	Získá informace o odhadovaném dopadu pro tuto doporučenou akci, například Odhadovaný zisk procesoru, Změna odhadovaného místa na disku.
properties.executeActionDuration	string	Získá čas potřebný k použití této doporučené akce u prostředku uživatele. např. doba potřebná k vytvoření indexu
properties.executeActionInitiatedBy	RecommendedActionInitiatedBy	Získá, pokud uživatel nebo systém udělil schválení pro použití této doporučené akce.
properties.executeActionInitiatedTime	string	Získá čas, kdy byla tato doporučená akce schválena pro provedení.
properties.executeActionStartTime	string	Získá čas, kdy systém začal používat tuto doporučenou akci u prostředku uživatele. Např. počáteční čas vytváření indexu
properties.implementationDetails	RecommendedActionImplementationInfo	Získá podrobnosti implementace této doporučené akce pro uživatele použít ji ručně.
properties.isArchivedAction	boolean	Získá, pokud byla tato doporučená akce navržena před nějakým časem, ale uživatel se rozhodl tuto akci ignorovat a systém znovu přidal novou doporučenou akci.
properties.isExecutableAction	boolean	Získá, pokud je tato doporučená akce použitelná uživatelem.
properties.isRevertableAction	boolean	Získá, pokud uživatel může změny použité touto doporučenou akcí vrátit zpět.
properties.lastRefresh	string	Získá čas, kdy byla tato doporučená akce naposledy aktualizována.
properties.linkedObjects	string[]	Získá propojené objekty, pokud existují.
properties.observedImpact	RecommendedActionImpactRecord[]	Získá informace o pozorovaných nebo skutečných dopadech pro tuto doporučenou akci, například skutečné získání procesoru, změna skutečného místa na disku.
properties.recommendationReason	string	Získá důvod pro doporučení této akce. Např. DuplicateIndex
properties.revertActionDuration	string	Získá čas potřebný k vrácení změn této doporučené akce u prostředku uživatele. například doba potřebná k odstranění vytvořeného indexu.
properties.revertActionInitiatedBy	RecommendedActionInitiatedBy	Získá, pokud uživatel nebo systém udělil schválení pro vrácení této doporučené akce.
properties.revertActionInitiatedTime	string	Získá čas, kdy byla tato doporučená akce schválena pro vrácení zpět.
properties.revertActionStartTime	string	Získá čas, kdy systém začal vracet změny této doporučené akce pro prostředek uživatele. Např. čas, kdy se spustí pokles indexu.
properties.score	integer	Získá dopad této doporučené akce. Možné hodnoty jsou 1 – Nízký dopad, 2 – Střední dopad a 3 – Vysoký dopad
properties.state	RecommendedActionStateInfo	Získá informace o aktuálním stavu, ve které se doporučená akce nachází.
properties.timeSeries	RecommendedActionMetricInfo[]	Získá informace o časových řadách metrik pro tuto doporučenou akci, například časová řada využití procesoru.
properties.validSince	string	Získá čas od doby, kdy je tato doporučená akce platná.
type	string	Typ prostředku.

RecommendedActionCurrentState

Aktuální stav, ve který je doporučená akce. Mezi běžně používané stavy patří: Aktivní –> doporučená akce je aktivní a zatím nebyla provedena žádná akce. Čeká na vyřízení –> doporučená akce je schválená pro a čeká na provedení. Provádění –> u uživatelské databáze se používá doporučená akce. Ověření –> byla použita doporučená akce, která ověřuje její užitečnost systémem. Úspěch –> byla použita doporučená akce a během ověřování bylo nalezeno zlepšení. Čeká se na vrácení –> ověření zjistilo jen malé nebo žádné zlepšení, takže doporučená akce je zařazena do fronty pro vrácení zpět nebo se uživatel vrátil ručně. Vrácení zpět –> změny provedené při použití doporučené akce se v uživatelské databázi vrací. Vráceno –> úspěšně se vrátily změny provedené doporučenou akcí v uživatelské databázi. Ignorováno –> uživatel doporučenou akci explicitně ignoroval nebo zahodil.

Name	Typ	Description
Active	string
Error	string
Executing	string
Expired	string
Ignored	string
Monitoring	string
Pending	string
PendingRevert	string
Resolved	string
RevertCancelled	string
Reverted	string
Reverting	string
Success	string
Verifying	string

RecommendedActionErrorInfo

Obsahuje informace o chybách pro doporučenou akci Azure SQL databáze, serveru nebo elastického fondu.

Name	Typ	Description
errorCode	string	Získá důvod, proč byla doporučená akce uvedena do chybového stavu. Např. DatabaseHasQdsOff, IndexAlreadyExists
isRetryable	IsRetryable	Získá, zda by chyba mohla být ignorována a doporučená akce by mohla být zopakována. Možné hodnoty jsou: Ano/Ne

RecommendedActionImpactRecord

Obsahuje informace o odhadovaném nebo zjištěném dopadu na různé metriky doporučené akce Azure SQL databáze, serveru nebo elastického fondu.

Name	Typ	Description
absoluteValue	number	Získá absolutní hodnotu této dimenze, pokud je k dispozici. Například počet ovlivněných dotazů
changeValueAbsolute	number	Získá absolutní změnu hodnoty této dimenze. Například absolutní změna místa na disku v megabajtech
changeValueRelative	number	Získá relativní změnu hodnoty této dimenze. Například relativní změna místa na disku v procentech
dimensionName	string	Získá název dimenze dopadu. Například CPUChange, DiskSpaceChange, NumberOfQueriesAffected.
unit	string	Získá název dimenze dopadu. Například CPUChange, DiskSpaceChange, NumberOfQueriesAffected.

RecommendedActionImplementationInfo

Obsahuje informace pro ruční implementaci doporučené akce Azure SQL databáze, serveru nebo elastického fondu.

Name	Typ	Description
method	ImplementationMethod	Získá metodu, ve které lze tuto doporučenou akci ručně implementovat. např. TSql, AzurePowerShell.
script	string	Získá ruční implementační skript. Například skript T-SQL, který by mohl být spuštěn v databázi.

RecommendedActionInitiatedBy

Získá, kdo inicioval provedení této doporučené akce. Možné hodnoty jsou: Uživatel –> když uživatel explicitně oznámí systému, aby použil doporučenou akci. Systém –> když byl stav automatického spuštění tohoto poradce nastavený na Povoleno, v takovém případě ho systém použil.

Name	Typ	Description
System	string
User	string

RecommendedActionMetricInfo

Obsahuje časové řady různých ovlivněných metrik pro doporučenou akci Azure SQL databáze, serveru nebo elastického fondu.

Name	Typ	Description
metricName	string	Získá název metriky. např. PROCESOR, počet dotazů.
startTime	string	Získá počáteční čas časového intervalu dané tímto MetricInfo.
timeGrain	string	Získá dobu trvání časového intervalu pro hodnotu danou tímto MetricInfo. např. PT1H (1 hodina)
unit	string	Získá jednotku, ve které se měří metrika. např. DTU, frekvence
value	number	Získá hodnotu metriky v časovém intervalu zadaném tímto MetricInfo.

RecommendedActionStateInfo

Obsahuje informace o aktuálním stavu doporučené akce Azure SQL databáze, serveru nebo elastického fondu.

Name	Typ	Description
actionInitiatedBy	RecommendedActionInitiatedBy	Získá, kdo inicioval provedení této doporučené akce. Možné hodnoty jsou: Uživatel –> když uživatel explicitně oznámí systému, aby použil doporučenou akci. Systém –> když byl stav automatického spuštění tohoto poradce nastavený na Povoleno, v takovém případě ho systém použil.
currentValue	RecommendedActionCurrentState	Aktuální stav, ve který je doporučená akce. Mezi běžně používané stavy patří: Aktivní –> doporučená akce je aktivní a zatím nebyla provedena žádná akce. Čeká na vyřízení –> doporučená akce je schválená pro a čeká na provedení. Provádění –> u uživatelské databáze se používá doporučená akce. Ověření –> byla použita doporučená akce, která ověřuje její užitečnost systémem. Úspěch –> byla použita doporučená akce a během ověřování bylo nalezeno zlepšení. Čeká se na vrácení –> ověření zjistilo jen malé nebo žádné zlepšení, takže doporučená akce je zařazena do fronty pro vrácení zpět nebo se uživatel vrátil ručně. Vrácení zpět –> změny provedené při použití doporučené akce se v uživatelské databázi vrací. Vráceno –> úspěšně se vrátily změny provedené doporučenou akcí v uživatelské databázi. Ignorováno –> uživatel doporučenou akci explicitně ignoroval nebo zahodil.
lastModified	string	Získá čas poslední změny stavu.

Sdílet prostřednictvím

Server Advisors - Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Příklady

Update server advisor

Ukázkový požadavek

Ukázková odpověď

Definice

Advisor

AdvisorStatus

AutoExecuteStatus

AutoExecuteStatusInheritedFrom

ImplementationMethod

IsRetryable

RecommendedAction

RecommendedActionCurrentState

RecommendedActionErrorInfo

RecommendedActionImpactRecord

RecommendedActionImplementationInfo

RecommendedActionInitiatedBy

RecommendedActionMetricInfo

RecommendedActionStateInfo

Další materiály