Database Advisors - Get

Referens

Tjänst:: SQL Database

API-version:: 2021-11-01

Hämtar en databasrådgivare.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
advisorName	path	True	string	Namnet på Database Advisor.
databaseName	path	True	string	Namnet på databasen.
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
serverName	path	True	string	Namnet på servern.
subscriptionId	path	True	string	Det prenumerations-ID som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Svar

Name	Typ	Description
200 OK	Advisor	Information om angiven databasrådgivare har hämtats.
Other Status Codes		Felsvar: *** 400 FeatureDisabledOnSelectedEdition – Användaren försökte använda en funktion som är inaktiverad i den aktuella databasutgåvan. 400 InvalidIdentifier – Identifieraren innehåller NULL eller ett ogiltigt unicode-tecken. 400 DataWarehouseNotSupported – Automatisk justering stöds inte för SQL Data Warehouse. 404 DatabaseDoesNotExist – Den begärda databasen hittades inte 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte 404 SubscriptionDoesNotHaveElasticPool – Den begärda elastiska poolen hittades inte 404 AdvisorNotFound – Den begärda rådgivaren hittades inte. 405 Stöds inte – den här funktionen stöds inte. 409 Konflikt – Begäran kunde inte bearbetas på grund av en konflikt i begäran. 503 ServiceTemporarilyUnavailable – Funktionen är inte tillgänglig för tillfället.

Name

Typ

Description

200 OK

Advisor

Information om angiven databasrådgivare har hämtats.

Other Status Codes

Felsvar: ***

400 FeatureDisabledOnSelectedEdition – Användaren försökte använda en funktion som är inaktiverad i den aktuella databasutgåvan.
400 InvalidIdentifier – Identifieraren innehåller NULL eller ett ogiltigt unicode-tecken.
400 DataWarehouseNotSupported – Automatisk justering stöds inte för SQL Data Warehouse.
404 DatabaseDoesNotExist – Den begärda databasen hittades inte
404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte
404 SubscriptionDoesNotHaveElasticPool – Den begärda elastiska poolen hittades inte
404 AdvisorNotFound – Den begärda rådgivaren hittades inte.
405 Stöds inte – den här funktionen stöds inte.
409 Konflikt – Begäran kunde inte bearbetas på grund av en konflikt i begäran.
503 ServiceTemporarilyUnavailable – Funktionen är inte tillgänglig för tillfället.

Exempel

Get database advisor

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


/**
 * Samples for DatabaseAdvisors Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/DatabaseAdvisorGet.json
     */
    /**
     * Sample code: Get database advisor.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getDatabaseAdvisor(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseAdvisors().getWithResponse("workloadinsight-demos",
            "misosisvr", "IndexAdvisor_test_3", "CreateIndex", 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

Exempelsvar

Statuskod:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/databases/IndexAdvisor_test_3/advisors/CreateIndex",
  "name": "CreateIndex",
  "type": "Microsoft.Sql/servers/databases/advisors",
  "properties": {
    "advisorStatus": "GA",
    "autoExecuteStatus": "Disabled",
    "recommendationsStatus": "Ok",
    "lastChecked": "2017-06-20T00:24:39Z"
  }
}

Definitioner

Name	Description
Advisor	Database, Server eller Elastic Pool Advisor.
AdvisorStatus	Hämtar statusen för tillgängligheten för den här rådgivaren till kunder. Möjliga värden är GA, PublicPreview, LimitedPublicPreview och PrivatePreview.
AutoExecuteStatus	Hämtar statusen för automatisk körning (om systemet ska kunna köra rekommendationerna) för den här rådgivaren. Möjliga värden är "Aktiverad" och "Inaktiverad"
AutoExecuteStatusInheritedFrom	Hämtar resursen från vilken aktuellt värde för status för automatisk körning ärvs. Status för automatisk körning kan anges på (och ärvas från) olika nivåer i resurshierarkin. Möjliga värden är "Subscription", "Server", "ElasticPool", "Database" och "Default" (när status inte uttryckligen anges på någon nivå).
ImplementationMethod	Hämtar den metod där den här rekommenderade åtgärden kan implementeras manuellt. t.ex. TSql, AzurePowerShell.
IsRetryable	Hämtar om felet kan ignoreras och rekommenderad åtgärd kan göras om. Möjliga värden är: Ja/Nej
RecommendedAction	Rekommenderad åtgärd för databas, server eller elastisk pool.
RecommendedActionCurrentState	Aktuellt tillstånd som den rekommenderade åtgärden är i. Några vanliga tillstånd är: Aktiv –> rekommenderade åtgärden är aktiv och ingen åtgärd har vidtagits ännu. Väntar –> rekommenderade åtgärden godkänns för och väntar på körning. Kör –> rekommenderad åtgärd tillämpas på användardatabasen. Verifiera –> rekommenderade åtgärden har tillämpats och verifieras av systemets användbarhet. Lyckades –> rekommenderade åtgärden tillämpades och förbättringar hittades under verifieringen. Väntar på återställning –> verifieringen hittade liten eller ingen förbättring, så den rekommenderade åtgärden placeras i kö för återställning eller så har användaren återställts manuellt. Återställ –> ändringar som görs vid användning av rekommenderad åtgärd återställs i användardatabasen. Återställd –> återställt ändringarna som gjorts genom rekommenderad åtgärd i användardatabasen. Ignorerad –> användare uttryckligen ignorerat/ignorerat den rekommenderade åtgärden.
RecommendedActionErrorInfo	Innehåller felinformation för en rekommenderad åtgärd för Azure SQL Database, server eller elastisk pool.
RecommendedActionImpactRecord	Innehåller information om uppskattad eller observerad påverkan på olika mått för en rekommenderad Åtgärd för Azure SQL Database, Server eller Elastisk pool.
RecommendedActionImplementationInfo	Innehåller information för manuell implementering för en rekommenderad åtgärd för Azure SQL Database, server eller elastisk pool.
RecommendedActionInitiatedBy	Hämtar vem som initierade körningen av den här rekommenderade åtgärden. Möjliga värden är: Användare –> När användaren uttryckligen meddelade systemet att tillämpa den rekommenderade åtgärden. System –> När statusen för automatisk körning av den här rådgivaren var inställd på "Aktiverad", i vilket fall systemet tillämpade den.
RecommendedActionMetricInfo	Innehåller tidsserier med olika mått som påverkas för en rekommenderad åtgärd för Azure SQL Database, server eller elastisk pool.
RecommendedActionStateInfo	Innehåller information om aktuellt tillstånd för en rekommenderad åtgärd för Azure SQL Database, server eller elastisk pool.

Advisor

Objekt

Database, Server eller Elastic Pool Advisor.

Name	Typ	Description
id	string	Resurs-ID.
kind	string	Resurstyp.
location	string	Resursplats.
name	string	Resursnamn.
properties.advisorStatus	AdvisorStatus	Hämtar statusen för tillgängligheten för den här rådgivaren till kunder. Möjliga värden är GA, PublicPreview, LimitedPublicPreview och PrivatePreview.
properties.autoExecuteStatus	AutoExecuteStatus	Hämtar statusen för automatisk körning (om systemet ska kunna köra rekommendationerna) för den här rådgivaren. Möjliga värden är "Aktiverad" och "Inaktiverad"
properties.autoExecuteStatusInheritedFrom	AutoExecuteStatusInheritedFrom	Hämtar resursen från vilken aktuellt värde för status för automatisk körning ärvs. Status för automatisk körning kan anges på (och ärvas från) olika nivåer i resurshierarkin. Möjliga värden är "Subscription", "Server", "ElasticPool", "Database" och "Default" (när status inte uttryckligen anges på någon nivå).
properties.lastChecked	string (date-time)	Hämtar den tid då den aktuella resursen analyserades för rekommendationer av den här rådgivaren.
properties.recommendationsStatus	string	Hämtar den statusen för rekommendationer för den här rådgivaren och anledning till att inte ha några rekommendationer. Möjliga värden inkluderar, men är inte begränsade till, "Ok" (tillgängliga rekommendationer), LowActivity (inte tillräckligt med arbetsbelastning för att analysera), "DbSeemsTuned" (databasen går bra) osv.
properties.recommendedActions	RecommendedAction[]	Hämtar de rekommenderade åtgärderna för den här rådgivaren.
type	string	Resurstyp.

AdvisorStatus

Uppräkning

Hämtar statusen för tillgängligheten för den här rådgivaren till kunder. Möjliga värden är GA, PublicPreview, LimitedPublicPreview och PrivatePreview.

Värde	Description
GA
LimitedPublicPreview
PrivatePreview
PublicPreview

AutoExecuteStatus

Uppräkning

Hämtar statusen för automatisk körning (om systemet ska kunna köra rekommendationerna) för den här rådgivaren. Möjliga värden är "Aktiverad" och "Inaktiverad"

Värde	Description
Default
Disabled
Enabled

AutoExecuteStatusInheritedFrom

Uppräkning

Hämtar resursen från vilken aktuellt värde för status för automatisk körning ärvs. Status för automatisk körning kan anges på (och ärvas från) olika nivåer i resurshierarkin. Möjliga värden är "Subscription", "Server", "ElasticPool", "Database" och "Default" (när status inte uttryckligen anges på någon nivå).

Värde	Description
Database
Default
ElasticPool
Server
Subscription

ImplementationMethod

Uppräkning

Hämtar den metod där den här rekommenderade åtgärden kan implementeras manuellt. t.ex. TSql, AzurePowerShell.

Värde	Description
AzurePowerShell
TSql

IsRetryable

Uppräkning

Hämtar om felet kan ignoreras och rekommenderad åtgärd kan göras om. Möjliga värden är: Ja/Nej

Värde	Description
No
Yes

RecommendedAction

Objekt

Rekommenderad åtgärd för databas, server eller elastisk pool.

Name	Typ	Description
id	string	Resurs-ID.
kind	string	Resurstyp.
location	string	Resursplats.
name	string	Resursnamn.
properties.details	object	Hämtar ytterligare information som är specifik för den här rekommenderade åtgärden.
properties.errorDetails	RecommendedActionErrorInfo	Hämtar felinformationen om och varför den här rekommenderade åtgärden sätts till feltillstånd.
properties.estimatedImpact	RecommendedActionImpactRecord[]	Hämtar den uppskattade effektinformationen för den här rekommenderade åtgärden, t.ex. uppskattad cpu-vinst, uppskattad diskutrymmesändring
properties.executeActionDuration	string (duration)	Hämtar den tid det tar att tillämpa den här rekommenderade åtgärden på användarresursen. t.ex. tidsåtgång för att skapa index
properties.executeActionInitiatedBy	RecommendedActionInitiatedBy	Hämtar om godkännande för att tillämpa den här rekommenderade åtgärden gavs av användare/system.
properties.executeActionInitiatedTime	string (date-time)	Hämtar den tid då den här rekommenderade åtgärden godkändes för körning.
properties.executeActionStartTime	string (date-time)	Hämtar den tid då systemet började tillämpa den här rekommenderade åtgärden på användarresursen. t.ex. starttid för indexskapande
properties.implementationDetails	RecommendedActionImplementationInfo	Hämtar implementeringsinformationen för den här rekommenderade åtgärden så att användaren kan tillämpa den manuellt.
properties.isArchivedAction	boolean	Hämtar om den här rekommenderade åtgärden föreslogs för en tid sedan, men användaren valde att ignorera detta och systemet lade till en ny rekommenderad åtgärd igen.
properties.isExecutableAction	boolean	Hämtar om den här rekommenderade åtgärden kan användas av användaren
properties.isRevertableAction	boolean	Hämtar om ändringar som tillämpas av den här rekommenderade åtgärden kan återställas av användaren
properties.lastRefresh	string (date-time)	Hämtar tid när den rekommenderade åtgärden senast uppdaterades.
properties.linkedObjects	string[]	Hämtar eventuella länkade objekt.
properties.observedImpact	RecommendedActionImpactRecord[]	Hämtar den observerade/faktiska effektinformationen för den här rekommenderade åtgärden, t.ex. faktisk cpu-vinst, ändring av verkligt diskutrymme
properties.recommendationReason	string	Hämtar anledningen till att rekommendera den här åtgärden. t.ex. DuplicateIndex
properties.revertActionDuration	string (duration)	Hämtar den tid det tar för att återställa ändringar av den här rekommenderade åtgärden på användarresursen. t.ex. tidsåtgång för att ta bort det skapade indexet.
properties.revertActionInitiatedBy	RecommendedActionInitiatedBy	Hämtar om godkännande för att återställa den här rekommenderade åtgärden gavs av användare/system.
properties.revertActionInitiatedTime	string (date-time)	Hämtar den tid då den här rekommenderade åtgärden godkändes för återställning.
properties.revertActionStartTime	string (date-time)	Hämtar den tid då systemet började återställa ändringar av den här rekommenderade åtgärden på användarresursen. t.ex. tid när indexsänkningen körs.
properties.score	integer (int32)	Hämtar effekten av den här rekommenderade åtgärden. Möjliga värden är 1 – Låg påverkan, 2 – Medelpåverkan och 3 – Hög påverkan
properties.state	RecommendedActionStateInfo	Hämtar information om det aktuella tillståndet som den rekommenderade åtgärden finns i.
properties.timeSeries	RecommendedActionMetricInfo[]	Hämtar tidsserieinformationen för mått för den här rekommenderade åtgärden, t.ex. tidsserier för CPU-förbrukning
properties.validSince	string (date-time)	Hämtar tiden sedan när den här rekommenderade åtgärden är giltig.
type	string	Resurstyp.

RecommendedActionCurrentState

Uppräkning

Aktuellt tillstånd som den rekommenderade åtgärden är i. Några vanliga tillstånd är: Aktiv –> rekommenderade åtgärden är aktiv och ingen åtgärd har vidtagits ännu. Väntar –> rekommenderade åtgärden godkänns för och väntar på körning. Kör –> rekommenderad åtgärd tillämpas på användardatabasen. Verifiera –> rekommenderade åtgärden har tillämpats och verifieras av systemets användbarhet. Lyckades –> rekommenderade åtgärden tillämpades och förbättringar hittades under verifieringen. Väntar på återställning –> verifieringen hittade liten eller ingen förbättring, så den rekommenderade åtgärden placeras i kö för återställning eller så har användaren återställts manuellt. Återställ –> ändringar som görs vid användning av rekommenderad åtgärd återställs i användardatabasen. Återställd –> återställt ändringarna som gjorts genom rekommenderad åtgärd i användardatabasen. Ignorerad –> användare uttryckligen ignorerat/ignorerat den rekommenderade åtgärden.

Värde	Description
Active
Error
Executing
Expired
Ignored
Monitoring
Pending
PendingRevert
Resolved
RevertCancelled
Reverted
Reverting
Success
Verifying

RecommendedActionErrorInfo

Objekt

Innehåller felinformation för en rekommenderad åtgärd för Azure SQL Database, server eller elastisk pool.

Name	Typ	Description
errorCode	string	Hämtar orsaken till att den rekommenderade åtgärden har försatts i feltillstånd. t.ex. DatabaseHasQdsOff, IndexAlreadyExists
isRetryable	IsRetryable	Hämtar om felet kan ignoreras och rekommenderad åtgärd kan göras om. Möjliga värden är: Ja/Nej

RecommendedActionImpactRecord

Objekt

Innehåller information om uppskattad eller observerad påverkan på olika mått för en rekommenderad Åtgärd för Azure SQL Database, Server eller Elastisk pool.

Name	Typ	Description
absoluteValue	number (double)	Hämtar det absoluta värdet för den här dimensionen om det är tillämpligt. t.ex. antal frågor som påverkas
changeValueAbsolute	number (double)	Hämtar den absoluta ändringen i värdet för den här dimensionen. t.ex., Absolut diskutrymmesändring i Megabyte
changeValueRelative	number (double)	Hämtar den relativa ändringen i värdet för den här dimensionen. t.ex. relativ diskutrymmesändring i procent
dimensionName	string	Hämtar namnet på effektdimensionen. t.ex. CPUChange, DiskSpaceChange, NumberOfQueriesAffected.
unit	string	Hämtar namnet på effektdimensionen. t.ex. CPUChange, DiskSpaceChange, NumberOfQueriesAffected.

RecommendedActionImplementationInfo

Objekt

Innehåller information för manuell implementering för en rekommenderad åtgärd för Azure SQL Database, server eller elastisk pool.

Name	Typ	Description
method	ImplementationMethod	Hämtar den metod där den här rekommenderade åtgärden kan implementeras manuellt. t.ex. TSql, AzurePowerShell.
script	string	Hämtar det manuella implementeringsskriptet. T.ex. T-SQL-skript som kan köras på databasen.

RecommendedActionInitiatedBy

Uppräkning

Hämtar vem som initierade körningen av den här rekommenderade åtgärden. Möjliga värden är: Användare –> När användaren uttryckligen meddelade systemet att tillämpa den rekommenderade åtgärden. System –> När statusen för automatisk körning av den här rådgivaren var inställd på "Aktiverad", i vilket fall systemet tillämpade den.

Värde	Description
System
User

RecommendedActionMetricInfo

Objekt

Innehåller tidsserier med olika mått som påverkas för en rekommenderad åtgärd för Azure SQL Database, server eller elastisk pool.

Name	Typ	Description
metricName	string	Hämtar namnet på måttet. t.ex. CPU, antal frågor.
startTime	string (date-time)	Hämtar starttiden för tidsintervallet som anges av denna MetricInfo.
timeGrain	string	Hämtar varaktigheten för tidsintervallet för det värde som anges av denna MetricInfo. t.ex. PT1H (1 timme)
unit	string	Hämtar den enhet där mått mäts. t.ex. DTU, frekvens
value	number (double)	Hämtar värdet för måttet i tidsintervallet som anges av denna MetricInfo.

RecommendedActionStateInfo

Objekt

Innehåller information om aktuellt tillstånd för en rekommenderad åtgärd för Azure SQL Database, server eller elastisk pool.

Name	Typ	Description
actionInitiatedBy	RecommendedActionInitiatedBy	Hämtar vem som initierade körningen av den här rekommenderade åtgärden. Möjliga värden är: Användare –> När användaren uttryckligen meddelade systemet att tillämpa den rekommenderade åtgärden. System –> När statusen för automatisk körning av den här rådgivaren var inställd på "Aktiverad", i vilket fall systemet tillämpade den.
currentValue	RecommendedActionCurrentState	Aktuellt tillstånd som den rekommenderade åtgärden är i. Några vanliga tillstånd är: Aktiv –> rekommenderade åtgärden är aktiv och ingen åtgärd har vidtagits ännu. Väntar –> rekommenderade åtgärden godkänns för och väntar på körning. Kör –> rekommenderad åtgärd tillämpas på användardatabasen. Verifiera –> rekommenderade åtgärden har tillämpats och verifieras av systemets användbarhet. Lyckades –> rekommenderade åtgärden tillämpades och förbättringar hittades under verifieringen. Väntar på återställning –> verifieringen hittade liten eller ingen förbättring, så den rekommenderade åtgärden placeras i kö för återställning eller så har användaren återställts manuellt. Återställ –> ändringar som görs vid användning av rekommenderad åtgärd återställs i användardatabasen. Återställd –> återställt ändringarna som gjorts genom rekommenderad åtgärd i användardatabasen. Ignorerad –> användare uttryckligen ignorerat/ignorerat den rekommenderade åtgärden.
lastModified	string (date-time)	Hämtar den tid då tillståndet senast ändrades

Dela via

Database Advisors - Get

URI-parametrar

Svar

Exempel

Get database advisor

Exempelbegäran

Exempelsvar

Definitioner

Advisor

AdvisorStatus

AutoExecuteStatus

AutoExecuteStatusInheritedFrom

ImplementationMethod

IsRetryable

RecommendedAction

RecommendedActionCurrentState

RecommendedActionErrorInfo

RecommendedActionImpactRecord

RecommendedActionImplementationInfo

RecommendedActionInitiatedBy

RecommendedActionMetricInfo

RecommendedActionStateInfo

Ytterligare resurser