Database Advisors - Get

Pobiera doradcę bazy danych.

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

Parametry identyfikatora URI

Nazwisko W Wymagane Typ Opis
advisorName
path True

string

Nazwa klasyfikatora bazy danych.

databaseName
path True

string

Nazwa bazy danych.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

serverName
path True

string

Nazwa serwera.

subscriptionId
path True

string (uuid)

Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwisko Typ Opis
200 OK

Advisor

Operacja Azure zakończyła się pomyślnie.

Other Status Codes

ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwisko Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Get database advisor

Przykładowe żądanie

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=2025-01-01

Przykładowa odpowiedź

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

Definicje

Nazwisko Opis
Advisor

Doradca bazy danych, serwera lub elastycznej puli.

AdvisorStatus

Pobiera stan dostępności tego doradcy dla klientów. Możliwe wartości to "GA", "PublicPreview", "LimitedPublicPreview" i "PrivatePreview".

AutoExecuteStatus

Pobiera stan automatycznego wykonywania (czy umożliwić systemowi wykonywanie zaleceń) tego doradcy. Możliwe wartości to "Włączone" i "Wyłączone"

AutoExecuteStatusInheritedFrom

Pobiera zasób, z którego jest dziedziczona bieżąca wartość stanu automatycznego wykonywania. Stan automatycznego wykonywania można ustawić na różnych poziomach w hierarchii zasobów (i dziedziczone z nich). Możliwe wartości to "Subscription", "Server", "ElasticPool", "Database" i "Default" (jeśli stan nie jest jawnie ustawiony na żadnym poziomie).

createdByType

Typ tożsamości, która utworzyła zasób.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

ImplementationMethod

Pobiera metodę, w której tę zalecaną akcję można zaimplementować ręcznie. np. TSql, AzurePowerShell.

IsRetryable

Pobiera informację o tym, czy błąd może zostać zignorowany i można ponowić próbę wykonania zalecanej akcji. Możliwe wartości to: Tak/Nie

RecommendedAction

Zalecana akcja bazy danych, serwera lub puli elastycznej.

RecommendedActionCurrentState

Bieżący stan, w których znajduje się zalecana akcja. Niektóre często używane stany to: Aktywne —> zalecane działanie jest aktywne i nie podjęto jeszcze żadnej akcji. Oczekujące —> zalecana akcja jest zatwierdzona i oczekuje na wykonanie. Wykonywanie —> zalecana akcja jest stosowana w bazie danych użytkowników. Weryfikowanie —> zastosowano zalecaną akcję i jest weryfikowana jej przydatności przez system. Powodzenie —> zastosowano zalecaną akcję i znaleziono ulepszenia podczas weryfikacji. Oczekiwanie na przywrócenie —> weryfikacja nie znalazła żadnych ulepszeń, dlatego zalecana akcja jest ustawiana w kolejce w celu przywracania lub ręcznego przywracania użytkownika. Przywracanie —> zmiany wprowadzone podczas stosowania zalecanej akcji są przywracane w bazie danych użytkownika. Przywrócono —> pomyślnie przywrócić zmiany wprowadzone przez zalecaną akcję w bazie danych użytkowników. Ignorowane —> użytkownik jawnie zignorował/odrzucił zalecaną akcję.

RecommendedActionErrorInfo

Zawiera informacje o błędach dla Azure SQL Database, serwera lub puli elastycznej Zalecane Akcje.

RecommendedActionImpactRecord

Zawiera informacje o szacowanym lub obserwowanym wpływie na różne metryki dla Azure SQL Database, serwera lub puli elastycznych (Recommended Action).

RecommendedActionImplementationInfo

Zawiera informacje dotyczące ręcznej implementacji dla Azure SQL Database, Server lub Elastic Pool Zalecane Działanie.

RecommendedActionInitiatedBy

Pobiera, jeśli zatwierdzenie zastosowania tej zalecanej akcji zostało podane przez użytkownika/system.

RecommendedActionMetricInfo

Zawiera szereg czasowy różnych dotkniętych metryk dla Azure SQL Database, serwera lub puli elastycznych Zalecane Akcje.

RecommendedActionStateInfo

Zawiera informacje o aktualnym stanie dla Azure SQL Database, serwera lub puli elastycznych zalecanych działań.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Advisor

Doradca bazy danych, serwera lub elastycznej puli.

Nazwisko Typ Opis
id

string (arm-id)

W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

kind

string

Rodzaj zasobu.

location

string

Lokalizacja zasobu.

name

string

Nazwa zasobu

properties.advisorStatus

AdvisorStatus

Pobiera stan dostępności tego doradcy dla klientów. Możliwe wartości to "GA", "PublicPreview", "LimitedPublicPreview" i "PrivatePreview".

properties.autoExecuteStatus

AutoExecuteStatus

Pobiera stan automatycznego wykonywania (czy umożliwić systemowi wykonywanie zaleceń) tego doradcy. Możliwe wartości to "Włączone" i "Wyłączone"

properties.autoExecuteStatusInheritedFrom

AutoExecuteStatusInheritedFrom

Pobiera zasób, z którego jest dziedziczona bieżąca wartość stanu automatycznego wykonywania. Stan automatycznego wykonywania można ustawić na różnych poziomach w hierarchii zasobów (i dziedziczone z nich). Możliwe wartości to "Subscription", "Server", "ElasticPool", "Database" i "Default" (jeśli stan nie jest jawnie ustawiony na żadnym poziomie).

properties.lastChecked

string (date-time)

Pobiera czas, kiedy bieżący zasób został przeanalizowany pod kątem zaleceń przez tego doradcę.

properties.recommendationsStatus

string

Pobiera ten stan zaleceń dla tego doradcy i przyczynę braku żadnych zaleceń. Możliwe wartości obejmują, ale nie są ograniczone do "Ok" (dostępne rekomendacje),LowActivity (za mało obciążenia do przeanalizowania), "DbSeemsTuned" (baza danych radzi sobie dobrze) itp.

properties.recommendedActions

RecommendedAction[]

Pobiera zalecane akcje dla tego doradcy.

systemData

systemData

Metadane Azure Resource Manager zawierające informacje createdBy i modifiedBy.

type

string

Typ zasobu. Np. "Microsoft. Compute/virtualMachines" lub "Microsoft. Storage/storageAccounts"

AdvisorStatus

Pobiera stan dostępności tego doradcy dla klientów. Możliwe wartości to "GA", "PublicPreview", "LimitedPublicPreview" i "PrivatePreview".

Wartość Opis
GA

ogólna dostępność

PublicPreview

Publiczna wersja zapoznawcza

LimitedPublicPreview

OgraniczonyPublicznyPrzegląd

PrivatePreview

PrivatePreview

AutoExecuteStatus

Pobiera stan automatycznego wykonywania (czy umożliwić systemowi wykonywanie zaleceń) tego doradcy. Możliwe wartości to "Włączone" i "Wyłączone"

Wartość Opis
Enabled

Enabled

Disabled

Wyłączony

Default

Wartość domyślna

AutoExecuteStatusInheritedFrom

Pobiera zasób, z którego jest dziedziczona bieżąca wartość stanu automatycznego wykonywania. Stan automatycznego wykonywania można ustawić na różnych poziomach w hierarchii zasobów (i dziedziczone z nich). Możliwe wartości to "Subscription", "Server", "ElasticPool", "Database" i "Default" (jeśli stan nie jest jawnie ustawiony na żadnym poziomie).

Wartość Opis
Default

Wartość domyślna

Subscription

Subscription

Server

Serwer

ElasticPool

Elastyczna pula

Database

Baza danych

createdByType

Typ tożsamości, która utworzyła zasób.

Wartość Opis
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwisko Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwisko Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Błąd dodatkowe informacje.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Cel błędu.

ErrorResponse

Odpowiedź na błąd

Nazwisko Typ Opis
error

ErrorDetail

Obiekt błędu.

ImplementationMethod

Pobiera metodę, w której tę zalecaną akcję można zaimplementować ręcznie. np. TSql, AzurePowerShell.

Wartość Opis
TSql

TSql

AzurePowerShell

AzurePowerShell

IsRetryable

Pobiera informację o tym, czy błąd może zostać zignorowany i można ponowić próbę wykonania zalecanej akcji. Możliwe wartości to: Tak/Nie

Wartość Opis
Yes

Yes

No

Nie.

RecommendedAction

Zalecana akcja bazy danych, serwera lub puli elastycznej.

Nazwisko Typ Opis
id

string (arm-id)

W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

kind

string

Rodzaj zasobu.

location

string

Lokalizacja zasobu.

name

string

Nazwa zasobu

properties.details

object

Pobiera dodatkowe szczegóły specyficzne dla tej zalecanej akcji.

properties.errorDetails

RecommendedActionErrorInfo

Pobiera szczegóły błędu, jeśli i dlaczego ta zalecana akcja zostanie umieszczona w stanie błędu.

properties.estimatedImpact

RecommendedActionImpactRecord[]

Pobiera informacje o szacowanym wpływie dla tej zalecanej akcji, np. Szacowany zysk procesora CPU, Szacowana zmiana miejsca na dysku

properties.executeActionDuration

string (duration)

Pobiera czas stosowania tej zalecanej akcji dla zasobu użytkownika. np. czas potrzebny na utworzenie indeksu

properties.executeActionInitiatedBy

RecommendedActionInitiatedBy

Pobiera, jeśli zatwierdzenie zastosowania tej zalecanej akcji zostało podane przez użytkownika/system.

properties.executeActionInitiatedTime

string (date-time)

Pobiera czas zatwierdzenia tej zalecanej akcji do wykonania.

properties.executeActionStartTime

string (date-time)

Pobiera czas, kiedy system zaczął stosować tę zalecaną akcję dla zasobu użytkownika. np. czas rozpoczęcia tworzenia indeksu

properties.implementationDetails

RecommendedActionImplementationInfo

Pobiera szczegóły implementacji tej zalecanej akcji, aby użytkownik zastosował go ręcznie.

properties.isArchivedAction

boolean

Pobiera, jeśli ta zalecana akcja została zasugerowana jakiś czas temu, ale użytkownik zdecydował się zignorować to i system dodał nową zalecaną akcję ponownie.

properties.isExecutableAction

boolean

Pobiera, jeśli ta zalecana akcja jest wykonywana przez użytkownika

properties.isRevertableAction

boolean

Pobiera, jeśli zmiany zastosowane przez tę zalecaną akcję można przywrócić przez użytkownika

properties.lastRefresh

string (date-time)

Pobiera czas ostatniego odświeżenia tej zalecanej akcji.

properties.linkedObjects

string[]

Pobiera połączone obiekty, jeśli istnieją.

properties.observedImpact

RecommendedActionImpactRecord[]

Pobiera zaobserwowane/rzeczywiste informacje o wpływie dla tej zalecanej akcji, np. rzeczywista przyrost procesora CPU, rzeczywista zmiana miejsca na dysku

properties.recommendationReason

string

Pobiera przyczynę rekomendowania tej akcji. np. DuplicateIndex

properties.revertActionDuration

string (duration)

Pobiera czas potrzebny na przywrócenie zmian tej zalecanej akcji dla zasobu użytkownika. np. czas potrzebny na usunięcie utworzonego indeksu.

properties.revertActionInitiatedBy

RecommendedActionInitiatedBy

Pobiera, jeśli zatwierdzenie dla przywracania tej zalecanej akcji zostało podane przez użytkownika/system.

properties.revertActionInitiatedTime

string (date-time)

Pobiera czas, kiedy ta zalecana akcja została zatwierdzona do przywracania.

properties.revertActionStartTime

string (date-time)

Pobiera czas, kiedy system zaczął przywracać zmiany tej zalecanej akcji dla zasobu użytkownika. np. czas wykonywania spadku indeksu.

properties.score

integer (int32)

Pobiera wpływ tej zalecanej akcji. Możliwe wartości to 1 — niski wpływ, 2 — średni wpływ i 3 — duży wpływ

properties.state

RecommendedActionStateInfo

Pobiera informacje o bieżącym stanie, w których znajduje się zalecana akcja.

properties.timeSeries

RecommendedActionMetricInfo[]

Pobiera informacje o metrykach szeregów czasowych dla tej zalecanej akcji, np. szereg czasu użycia procesora CPU

properties.validSince

string (date-time)

Pobiera czas, od kiedy ta zalecana akcja jest prawidłowa.

systemData

systemData

Metadane Azure Resource Manager zawierające informacje createdBy i modifiedBy.

type

string

Typ zasobu. Np. "Microsoft. Compute/virtualMachines" lub "Microsoft. Storage/storageAccounts"

RecommendedActionCurrentState

Bieżący stan, w których znajduje się zalecana akcja. Niektóre często używane stany to: Aktywne —> zalecane działanie jest aktywne i nie podjęto jeszcze żadnej akcji. Oczekujące —> zalecana akcja jest zatwierdzona i oczekuje na wykonanie. Wykonywanie —> zalecana akcja jest stosowana w bazie danych użytkowników. Weryfikowanie —> zastosowano zalecaną akcję i jest weryfikowana jej przydatności przez system. Powodzenie —> zastosowano zalecaną akcję i znaleziono ulepszenia podczas weryfikacji. Oczekiwanie na przywrócenie —> weryfikacja nie znalazła żadnych ulepszeń, dlatego zalecana akcja jest ustawiana w kolejce w celu przywracania lub ręcznego przywracania użytkownika. Przywracanie —> zmiany wprowadzone podczas stosowania zalecanej akcji są przywracane w bazie danych użytkownika. Przywrócono —> pomyślnie przywrócić zmiany wprowadzone przez zalecaną akcję w bazie danych użytkowników. Ignorowane —> użytkownik jawnie zignorował/odrzucił zalecaną akcję.

Wartość Opis
Active

Aktywne

Pending

W oczekiwaniu

Executing

Uruchamianie

Verifying

Weryfikacja

PendingRevert

PendingRevert

RevertCancelled

RevertCancelled

Reverting

Powrót

Reverted

Przywrócone

Ignored

Ignorowane

Expired

Wygasła

Monitoring

Nadzorowanie

Resolved

Rozwiązano

Success

Powodzenie

Error

Błąd

RecommendedActionErrorInfo

Zawiera informacje o błędach dla Azure SQL Database, serwera lub puli elastycznej Zalecane Akcje.

Nazwisko Typ Opis
errorCode

string

Pobiera powód, dla którego zalecana akcja została umieszczona w stanie błędu. np. DatabaseHasQdsOff, IndexAlreadyExists

isRetryable

IsRetryable

Pobiera informację o tym, czy błąd może zostać zignorowany i można ponowić próbę wykonania zalecanej akcji. Możliwe wartości to: Tak/Nie

RecommendedActionImpactRecord

Zawiera informacje o szacowanym lub obserwowanym wpływie na różne metryki dla Azure SQL Database, serwera lub puli elastycznych (Recommended Action).

Nazwisko Typ Opis
absoluteValue

number (double)

Pobiera wartość bezwzględną tego wymiaru, jeśli ma to zastosowanie. np. liczba zapytań, których dotyczy problem

changeValueAbsolute

number (double)

Pobiera bezwzględną zmianę wartości tego wymiaru. np. zmiana bezwzględnego miejsca na dysku w megabajtach

changeValueRelative

number (double)

Pobiera względną zmianę wartości tego wymiaru. np. względna zmiana miejsca na dysku w procentach

dimensionName

string

Pobiera nazwę wymiaru wpływu. np. CPUChange, DiskSpaceChange, NumberOfQueriesAffected.

unit

string

Pobiera nazwę wymiaru wpływu. np. CPUChange, DiskSpaceChange, NumberOfQueriesAffected.

RecommendedActionImplementationInfo

Zawiera informacje dotyczące ręcznej implementacji dla Azure SQL Database, Server lub Elastic Pool Zalecane Działanie.

Nazwisko Typ Opis
method

ImplementationMethod

Pobiera metodę, w której tę zalecaną akcję można zaimplementować ręcznie. np. TSql, AzurePowerShell.

script

string

Pobiera skrypt implementacji ręcznej. Np. skrypt języka T-SQL, który można wykonać w bazie danych.

RecommendedActionInitiatedBy

Pobiera, jeśli zatwierdzenie zastosowania tej zalecanej akcji zostało podane przez użytkownika/system.

Wartość Opis
User

Użytkownik

System

System

RecommendedActionMetricInfo

Zawiera szereg czasowy różnych dotkniętych metryk dla Azure SQL Database, serwera lub puli elastycznych Zalecane Akcje.

Nazwisko Typ Opis
metricName

string

Pobiera nazwę metryki. np. procesor CPU, liczba zapytań.

startTime

string (date-time)

Pobiera godzinę rozpoczęcia interwału czasu podanego przez tę wartość MetricInfo.

timeGrain

string

Pobiera czas trwania interwału czasu dla wartości podanej przez tę wartość MetricInfo. np. PT1H (1 godzina)

unit

string

Pobiera jednostkę, w której mierzona jest metryka. np. DTU, częstotliwość

value

number (double)

Pobiera wartość metryki w interwale czasu podanym przez tę wartość MetricInfo.

RecommendedActionStateInfo

Zawiera informacje o aktualnym stanie dla Azure SQL Database, serwera lub puli elastycznych zalecanych działań.

Nazwisko Typ Opis
actionInitiatedBy

RecommendedActionInitiatedBy

Pobiera, kto zainicjował wykonywanie tej zalecanej akcji. Możliwa wartość to: Użytkownik —> Gdy użytkownik jawnie powiadomił system o zastosowaniu zalecanej akcji. System —> Gdy stan automatycznego wykonywania tego klasyfikatora został ustawiony na wartość "Włączone", w takim przypadku system go zastosował.

currentValue

RecommendedActionCurrentState

Bieżący stan, w których znajduje się zalecana akcja. Niektóre często używane stany to: Aktywne —> zalecane działanie jest aktywne i nie podjęto jeszcze żadnej akcji. Oczekujące —> zalecana akcja jest zatwierdzona i oczekuje na wykonanie. Wykonywanie —> zalecana akcja jest stosowana w bazie danych użytkowników. Weryfikowanie —> zastosowano zalecaną akcję i jest weryfikowana jej przydatności przez system. Powodzenie —> zastosowano zalecaną akcję i znaleziono ulepszenia podczas weryfikacji. Oczekiwanie na przywrócenie —> weryfikacja nie znalazła żadnych ulepszeń, dlatego zalecana akcja jest ustawiana w kolejce w celu przywracania lub ręcznego przywracania użytkownika. Przywracanie —> zmiany wprowadzone podczas stosowania zalecanej akcji są przywracane w bazie danych użytkownika. Przywrócono —> pomyślnie przywrócić zmiany wprowadzone przez zalecaną akcję w bazie danych użytkowników. Ignorowane —> użytkownik jawnie zignorował/odrzucił zalecaną akcję.

lastModified

string (date-time)

Pobiera czas ostatniej modyfikacji stanu

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwisko Typ Opis
createdAt

string (date-time)

Sygnatura czasowa tworzenia zasobu (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string (date-time)

Znacznik czasu ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.