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 |
|---|---|---|---|---|
|
advisor
|
path | True |
string |
Nazwa klasyfikatora bazy danych. |
|
database
|
path | True |
string |
Nazwa bazy danych. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
|
server
|
path | True |
string |
Nazwa serwera. |
|
subscription
|
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 |
Operacja Azure zakończyła się pomyślnie. |
|
| Other Status Codes |
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. |
|
Advisor |
Pobiera stan dostępności tego doradcy dla klientów. Możliwe wartości to "GA", "PublicPreview", "LimitedPublicPreview" i "PrivatePreview". |
|
Auto |
Pobiera stan automatycznego wykonywania (czy umożliwić systemowi wykonywanie zaleceń) tego doradcy. Możliwe wartości to "Włączone" i "Wyłączone" |
|
Auto |
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). |
|
created |
Typ tożsamości, która utworzyła zasób. |
|
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
|
Error |
Szczegóły błędu. |
|
Error |
Odpowiedź na błąd |
|
Implementation |
Pobiera metodę, w której tę zalecaną akcję można zaimplementować ręcznie. np. TSql, AzurePowerShell. |
|
Is |
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 |
|
Recommended |
Zalecana akcja bazy danych, serwera lub puli elastycznej. |
|
Recommended |
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ę. |
|
Recommended |
Zawiera informacje o błędach dla Azure SQL Database, serwera lub puli elastycznej Zalecane Akcje. |
|
Recommended |
Zawiera informacje o szacowanym lub obserwowanym wpływie na różne metryki dla Azure SQL Database, serwera lub puli elastycznych (Recommended Action). |
|
Recommended |
Zawiera informacje dotyczące ręcznej implementacji dla Azure SQL Database, Server lub Elastic Pool Zalecane Działanie. |
|
Recommended |
Pobiera, jeśli zatwierdzenie zastosowania tej zalecanej akcji zostało podane przez użytkownika/system. |
|
Recommended |
Zawiera szereg czasowy różnych dotkniętych metryk dla Azure SQL Database, serwera lub puli elastycznych Zalecane Akcje. |
|
Recommended |
Zawiera informacje o aktualnym stanie dla Azure SQL Database, serwera lub puli elastycznych zalecanych działań. |
|
system |
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 |
Pobiera stan dostępności tego doradcy dla klientów. Możliwe wartości to "GA", "PublicPreview", "LimitedPublicPreview" i "PrivatePreview". |
|
| properties.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 |
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 |
Pobiera zalecane akcje dla tego doradcy. |
|
| 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 |
Błąd dodatkowe informacje. |
|
| code |
string |
Kod błędu. |
| details |
Szczegóły błędu. |
|
| message |
string |
Komunikat o błędzie. |
| target |
string |
Cel błędu. |
ErrorResponse
Odpowiedź na błąd
| Nazwisko | Typ | Opis |
|---|---|---|
| error |
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 |
Pobiera szczegóły błędu, jeśli i dlaczego ta zalecana akcja zostanie umieszczona w stanie błędu. |
|
| properties.estimatedImpact |
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 |
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 |
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 |
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 |
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 |
Pobiera informacje o bieżącym stanie, w których znajduje się zalecana akcja. |
|
| properties.timeSeries |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |