Database Recommended Actions - List By Database Advisor

  • Referensi
Service:
SQL Database
API Version:
2021-02-01-preview

Mendapatkan daftar Tindakan yang Direkomendasikan Database.

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

Parameter URI

Name In Required Type Description
advisorName
 path True
  • string

Nama Advisor Database.
databaseName
 path True
  • string

Nama database.
resourceGroupName
 path True
  • string

Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal.
serverName
 path True
  • string

Nama server.
subscriptionId
 path True
  • string

ID langganan yang mengidentifikasi langganan Azure.
api-version
 query True
  • string

Versi API yang digunakan untuk permintaan.

Respons

Name Type Description
200 OK

Berhasil mengambil daftar tindakan yang direkomendasikan database.
Other Status Codes

Respons Kesalahan: ***

  • 400 FeatureDisabledOnSelectedEdition - Pengguna mencoba menggunakan fitur yang dinonaktifkan pada edisi database saat ini.

  • 400 InvalidIdentifier - Pengidentifikasi berisi NULL atau karakter unicode yang tidak valid.

  • 404 DatabaseDoesNotExist - Database yang diminta tidak ditemukan

  • 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan

  • 404 SubscriptionDoesNotHaveElasticPool - Kumpulan elastis yang diminta tidak ditemukan

  • 404 AdvisorNotFound - Advisor yang diminta tidak ditemukan.

  • 404 RecommendedActionNotFound - Tindakan yang direkomendasikan yang diminta tidak ditemukan.

  • 404 AdvisorNotFound - Advisor yang diminta tidak ditemukan.

  • 404 RecommendedActionNotFound - Tindakan yang direkomendasikan yang diminta tidak ditemukan.

  • 405 NotSupported - Fungsionalitas ini tidak didukung.

  • Konflik 409 - Permintaan tidak dapat diproses karena konflik dalam permintaan.

  • 503 ServiceTemporarilyUnavailable - Fitur untuk sementara tidak tersedia.

Contoh

Sample Request

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/recommendedActions?api-version=2021-02-01-preview

Sample Response

Status code:
200 
[
  {
    "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/databases/IndexAdvisor_test_3/advisors/CreateIndex/recommendedActions/IR_[CRM]_[DataPoints]_4821CD2F9510D98184BB",
    "name": "IR_[CRM]_[DataPoints]_4821CD2F9510D98184BB",
    "type": "Microsoft.Sql/servers/databases/advisors/recommendedActions",
    "location": "East Asia",
    "kind": "",
    "properties": {
      "recommendationReason": "",
      "validSince": "2017-03-01T14:38:04Z",
      "lastRefresh": "2017-03-01T14:38:04Z",
      "state": {
        "currentValue": "Active",
        "lastModified": "2017-03-01T14:38:05Z"
      },
      "isExecutableAction": true,
      "isRevertableAction": true,
      "isArchivedAction": false,
      "score": 1,
      "implementationDetails": {
        "method": "TSql",
        "script": "CREATE NONCLUSTERED INDEX [nci_wi_DataPoints_B892614093BAC56295EF6018BD4CB51B] ON [CRM].[DataPoints] ([Name],[Money],[Power]) INCLUDE ([Hour], [System], [LastChanged]) WITH (ONLINE = ON)"
      },
      "errorDetails": {},
      "estimatedImpact": [
        {
          "dimensionName": "ActionDuration",
          "unit": "Seconds",
          "absoluteValue": 1440
        },
        {
          "dimensionName": "SpaceChange",
          "unit": "Megabytes",
          "absoluteValue": 209.3125
        }
      ],
      "observedImpact": [],
      "timeSeries": [],
      "details": {
        "indexName": "nci_wi_DataPoints_B892614093BAC56295EF6018BD4CB51B",
        "indexType": "NONCLUSTERED",
        "schema": "[CRM]",
        "table": "[DataPoints]",
        "indexColumns": "[Name],[Money],[Power]",
        "includedColumns": "[Hour], [System], [LastChanged]"
      }
    }
  },
  {
    "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/databases/IndexAdvisor_test_3/advisors/CreateIndex/recommendedActions/IR_[dbo]_[DataPoints]_F5D2F347AA22DB46E4CC",
    "name": "IR_[dbo]_[DataPoints]_F5D2F347AA22DB46E4CC",
    "type": "Microsoft.Sql/servers/databases/advisors/recommendedActions",
    "location": "East Asia",
    "kind": "",
    "properties": {
      "recommendationReason": "",
      "validSince": "2017-03-01T14:38:05Z",
      "lastRefresh": "2017-03-01T14:38:05Z",
      "state": {
        "currentValue": "Success",
        "actionInitiatedBy": "User",
        "lastModified": "2017-03-01T14:38:05Z"
      },
      "isExecutableAction": true,
      "isRevertableAction": true,
      "isArchivedAction": false,
      "executeActionStartTime": "2017-03-01T14:38:05Z",
      "executeActionDuration": "PT1M",
      "executeActionInitiatedBy": "User",
      "executeActionInitiatedTime": "2017-03-01T14:38:05Z",
      "score": 3,
      "implementationDetails": {
        "method": "TSql",
        "script": "DROP INDEX [nci_wi_DataPoints_609E4B7D6A3813990ED44B28B340C8FC] ON [dbo].[DataPoints]"
      },
      "errorDetails": {},
      "estimatedImpact": [
        {
          "dimensionName": "ActionDuration",
          "unit": "Seconds",
          "absoluteValue": 5040
        },
        {
          "dimensionName": "SpaceChange",
          "unit": "Megabytes",
          "absoluteValue": 120
        }
      ],
      "observedImpact": [
        {
          "dimensionName": "AffectedQueriesCpuUtilization",
          "unit": "CpuCores",
          "changeValueAbsolute": -12.7,
          "changeValueRelative": -0.9
        },
        {
          "dimensionName": "CpuUtilization",
          "unit": "CpuCores",
          "changeValueAbsolute": -12.7,
          "changeValueRelative": -0.3175
        },
        {
          "dimensionName": "QueriesWithImprovedPerformance",
          "unit": "Count",
          "absoluteValue": 12
        },
        {
          "dimensionName": "QueriesWithRegressedPerformance",
          "unit": "Count",
          "absoluteValue": 1
        },
        {
          "dimensionName": "SpaceChange",
          "unit": "Megabytes",
          "absoluteValue": 130.742187
        },
        {
          "dimensionName": "VerificationProgress",
          "unit": "Percent",
          "absoluteValue": 0
        }
      ],
      "timeSeries": [],
      "details": {
        "indexName": "nci_wi_DataPoints_609E4B7D6A3813990ED44B28B340C8FC",
        "indexType": "NONCLUSTERED",
        "schema": "[dbo]",
        "table": "[DataPoints]",
        "indexColumns": "[Name],[Money]",
        "includedColumns": "[Power],[Pineapple]",
        "indexActionStartTime": "2017-03-01T14:38:05.337",
        "indexActionDuration": "00:01:00"
      }
    }
  },
  {
    "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/databases/IndexAdvisor_test_3/advisors/CreateIndex/recommendedActions/IR_[dbo]_[Employees]_560E15A98D14CA09BDFB",
    "name": "IR_[dbo]_[Employees]_560E15A98D14CA09BDFB",
    "type": "Microsoft.Sql/servers/databases/advisors/recommendedActions",
    "location": "East Asia",
    "kind": "",
    "properties": {
      "recommendationReason": "",
      "validSince": "2017-03-01T14:38:05Z",
      "lastRefresh": "2017-03-01T14:38:05Z",
      "state": {
        "currentValue": "Active",
        "lastModified": "2017-03-01T14:38:05Z"
      },
      "isExecutableAction": true,
      "isRevertableAction": true,
      "isArchivedAction": false,
      "score": 3,
      "implementationDetails": {
        "method": "TSql",
        "script": "CREATE NONCLUSTERED INDEX [nci_wi_Employees_8C18C2AF4267DC77793040782641CCDE] ON [dbo].[Employees] ([City], [State]) INCLUDE ([Postal]) WITH (ONLINE = ON)"
      },
      "errorDetails": {},
      "estimatedImpact": [
        {
          "dimensionName": "ActionDuration",
          "unit": "Seconds",
          "absoluteValue": 17
        },
        {
          "dimensionName": "SpaceChange",
          "unit": "Megabytes",
          "absoluteValue": 128
        }
      ],
      "observedImpact": [],
      "timeSeries": [],
      "details": {
        "indexName": "nci_wi_Employees_8C18C2AF4267DC77793040782641CCDE",
        "indexType": "NONCLUSTERED",
        "schema": "[dbo]",
        "table": "[Employees]",
        "indexColumns": "[City], [State]",
        "includedColumns": "[Postal]"
      }
    }
  }
]

Definisi

ImplementationMethod

Mendapatkan metode di mana tindakan yang direkomendasikan ini dapat diimplementasikan secara manual. misalnya, TSql, AzurePowerShell.
IsRetryable

Mendapatkan apakah kesalahan dapat diabaikan dan tindakan yang direkomendasikan dapat dicoba kembali. Nilai yang mungkin adalah: Ya/Tidak
RecommendedAction

Tindakan yang Direkomendasikan Database, Server, atau Kumpulan Elastis.
RecommendedActionCurrentState

Status saat ini, tindakan yang disarankan ada. Beberapa status yang umum digunakan adalah: Aktif -> tindakan yang direkomendasikan aktif dan belum ada tindakan yang diambil. Tertunda -> tindakan yang direkomendasikan disetujui dan sedang menunggu eksekusi. Menjalankan -> tindakan yang direkomendasikan sedang diterapkan pada database pengguna. Memverifikasi -> tindakan yang direkomendasikan diterapkan dan sedang diverifikasi kegunaannya oleh sistem. Berhasil -> tindakan yang direkomendasikan diterapkan dan perbaikan ditemukan selama verifikasi. Kembali tertunda -> verifikasi menemukan sedikit atau tidak ada peningkatan sehingga tindakan yang direkomendasikan diantrekan untuk kembali atau pengguna telah kembali secara manual. Mengembalikan -> perubahan yang dilakukan saat menerapkan tindakan yang direkomendasikan sedang dikembalikan pada database pengguna. Dikembalikan -> berhasil mengembalikan perubahan yang dibuat oleh tindakan yang direkomendasikan pada database pengguna. Diabaikan -> pengguna secara eksplisit mengabaikan/membuang tindakan yang direkomendasikan.
RecommendedActionErrorInfo

Berisi informasi kesalahan untuk Tindakan yang Direkomendasikan Azure SQL Database, Server, atau Kumpulan Elastis.
RecommendedActionImpactRecord

Berisi informasi perkiraan atau dampak yang diamati pada berbagai metrik untuk Tindakan yang Direkomendasikan Azure SQL Database, Server, atau Kumpulan Elastis.
RecommendedActionImplementationInfo

Berisi informasi untuk implementasi manual untuk Tindakan yang Direkomendasikan Azure SQL Database, Server, atau Kumpulan Elastis.
RecommendedActionInitiatedBy

Mendapatkan siapa yang memulai eksekusi tindakan yang direkomendasikan ini. Nilai yang Mungkin adalah: Pengguna -> Saat sistem pemberitahuan eksplisit pengguna menerapkan tindakan yang direkomendasikan. Sistem -> Ketika status eksekusi otomatis advisor ini diatur ke 'Diaktifkan', dalam hal ini sistem menerapkannya.
RecommendedActionMetricInfo

Berisi rangkaian waktu dari berbagai metrik yang terkena dampak untuk Tindakan yang Direkomendasikan Azure SQL Database, Server, atau Kumpulan Elastis.
RecommendedActionStateInfo

Berisi informasi status saat ini untuk Tindakan yang Direkomendasikan Azure SQL Database, Server, atau Kumpulan Elastis.

ImplementationMethod

Mendapatkan metode di mana tindakan yang direkomendasikan ini dapat diimplementasikan secara manual. misalnya, TSql, AzurePowerShell.

Name Type Description
AzurePowerShell
  • string
TSql
  • string

IsRetryable

Mendapatkan apakah kesalahan dapat diabaikan dan tindakan yang direkomendasikan dapat dicoba kembali. Nilai yang mungkin adalah: Ya/Tidak

Name Type Description
No
  • string
Yes
  • string

RecommendedAction

Tindakan yang Direkomendasikan Database, Server, atau Kumpulan Elastis.

Name Type Description
id
  • string

ID Sumber Daya.
kind
  • string

Jenis sumber daya.
location
  • string

Lokasi sumber daya.
name
  • string

Nama sumber daya.
properties.details
  • object

Mendapatkan detail tambahan khusus untuk tindakan yang direkomendasikan ini.
properties.errorDetails

Mendapatkan detail kesalahan jika dan mengapa tindakan yang direkomendasikan ini dimasukkan ke status kesalahan.
properties.estimatedImpact

Mendapatkan estimasi info dampak untuk tindakan yang direkomendasikan ini misalnya, Estimasi perolehan CPU, Estimasi perubahan Ruang Disk
properties.executeActionDuration
  • string

Mendapatkan waktu yang diperlukan untuk menerapkan tindakan yang direkomendasikan ini pada sumber daya pengguna. misalnya, waktu yang dibutuhkan untuk pembuatan indeks
properties.executeActionInitiatedBy

Mendapatkan jika persetujuan untuk menerapkan tindakan yang direkomendasikan ini diberikan oleh pengguna/sistem.
properties.executeActionInitiatedTime
  • string

Mendapatkan waktu ketika tindakan yang direkomendasikan ini disetujui untuk eksekusi.
properties.executeActionStartTime
  • string

Mendapatkan waktu ketika sistem mulai menerapkan tindakan yang direkomendasikan ini pada sumber daya pengguna. misalnya, waktu mulai pembuatan indeks
properties.implementationDetails

Mendapatkan detail implementasi dari tindakan yang direkomendasikan ini bagi pengguna untuk menerapkannya secara manual.
properties.isArchivedAction
  • boolean

Mendapatkan jika tindakan yang direkomendasikan ini disarankan beberapa waktu lalu tetapi pengguna memilih untuk mengabaikan ini dan sistem menambahkan tindakan baru yang direkomendasikan lagi.
properties.isExecutableAction
  • boolean

Mendapatkan jika tindakan yang direkomendasikan ini dapat ditindaklanjuti oleh pengguna
properties.isRevertableAction
  • boolean

Mendapatkan jika perubahan yang diterapkan oleh tindakan yang direkomendasikan ini dapat dikembalikan oleh pengguna
properties.lastRefresh
  • string

Mendapatkan waktu ketika tindakan yang direkomendasikan ini terakhir disegarkan.
properties.linkedObjects
  • string[]

Mendapatkan objek tertaut, jika ada.
properties.observedImpact

Mendapatkan info dampak yang diamati/aktual untuk tindakan yang direkomendasikan ini misalnya, Perolehan CPU aktual, perubahan Ruang Disk Aktual
properties.recommendationReason
  • string

Mendapatkan alasan untuk merekomendasikan tindakan ini. misalnya, DuplicateIndex
properties.revertActionDuration
  • string

Mendapatkan waktu yang diperlukan untuk mengembalikan perubahan tindakan yang direkomendasikan ini pada sumber daya pengguna. misalnya, waktu yang diperlukan untuk menghilangkan indeks yang dibuat.
properties.revertActionInitiatedBy

Mendapatkan jika persetujuan untuk mengembalikan tindakan yang direkomendasikan ini diberikan oleh pengguna/sistem.
properties.revertActionInitiatedTime
  • string

Mendapatkan waktu ketika tindakan yang direkomendasikan ini disetujui untuk kembali.
properties.revertActionStartTime
  • string

Mendapatkan waktu ketika sistem mulai mengembalikan perubahan tindakan yang direkomendasikan ini pada sumber daya pengguna. misalnya, waktu ketika penurunan indeks dijalankan.
properties.score
  • integer

Mendapatkan dampak dari tindakan yang direkomendasikan ini. Nilai yang mungkin adalah 1 - Dampak rendah, 2 - Dampak Sedang dan 3 - Dampak Tinggi
properties.state

Mendapatkan info status saat ini tempat tindakan yang disarankan.
properties.timeSeries

Mendapatkan info rangkaian waktu metrik untuk tindakan yang direkomendasikan ini misalnya, rangkaian waktu konsumsi CPU
properties.validSince
  • string

Mendapatkan waktu sejak ketika tindakan yang direkomendasikan ini valid.
type
  • string

Jenis sumber daya

RecommendedActionCurrentState

Status saat ini, tindakan yang disarankan ada. Beberapa status yang umum digunakan adalah: Aktif -> tindakan yang direkomendasikan aktif dan belum ada tindakan yang diambil. Tertunda -> tindakan yang direkomendasikan disetujui dan sedang menunggu eksekusi. Menjalankan -> tindakan yang direkomendasikan sedang diterapkan pada database pengguna. Memverifikasi -> tindakan yang direkomendasikan diterapkan dan sedang diverifikasi kegunaannya oleh sistem. Berhasil -> tindakan yang direkomendasikan diterapkan dan perbaikan ditemukan selama verifikasi. Kembali tertunda -> verifikasi menemukan sedikit atau tidak ada peningkatan sehingga tindakan yang direkomendasikan diantrekan untuk kembali atau pengguna telah kembali secara manual. Mengembalikan -> perubahan yang dilakukan saat menerapkan tindakan yang direkomendasikan sedang dikembalikan pada database pengguna. Dikembalikan -> berhasil mengembalikan perubahan yang dibuat oleh tindakan yang direkomendasikan pada database pengguna. Diabaikan -> pengguna secara eksplisit mengabaikan/membuang tindakan yang direkomendasikan.

Name Type 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

Berisi informasi kesalahan untuk Tindakan yang Direkomendasikan Azure SQL Database, Server, atau Kumpulan Elastis.

Name Type Description
errorCode
  • string

Mendapatkan alasan mengapa tindakan yang direkomendasikan dimasukkan ke status kesalahan. misalnya, DatabaseHasQdsOff, IndexAlreadyExists
isRetryable

Mendapatkan apakah kesalahan dapat diabaikan dan tindakan yang direkomendasikan dapat dicoba kembali. Nilai yang mungkin adalah: Ya/Tidak

RecommendedActionImpactRecord

Berisi informasi perkiraan atau dampak yang diamati pada berbagai metrik untuk Tindakan yang Direkomendasikan Azure SQL Database, Server, atau Kumpulan Elastis.

Name Type Description
absoluteValue
  • number

Mendapatkan nilai absolut dimensi ini jika berlaku. misalnya, Jumlah Kueri yang terpengaruh
changeValueAbsolute
  • number

Mendapatkan perubahan absolut dalam nilai dimensi ini. misalnya, perubahan ruang Disk Absolut dalam Megabyte
changeValueRelative
  • number

Mendapatkan perubahan relatif dalam nilai dimensi ini. misalnya, perubahan ruang Disk Relatif dalam Persentase
dimensionName
  • string

Mendapatkan nama dimensi dampak. misalnya, CPUChange, DiskSpaceChange, NumberOfQueriesAffected.
unit
  • string

Mendapatkan nama dimensi dampak. misalnya, CPUChange, DiskSpaceChange, NumberOfQueriesAffected.

RecommendedActionImplementationInfo

Berisi informasi untuk implementasi manual untuk Tindakan yang Direkomendasikan Azure SQL Database, Server, atau Kumpulan Elastis.

Name Type Description
method

Mendapatkan metode di mana tindakan yang direkomendasikan ini dapat diimplementasikan secara manual. misalnya, TSql, AzurePowerShell.
script
  • string

Mendapatkan skrip implementasi manual. misalnya, skrip T-SQL yang dapat dijalankan pada database.

RecommendedActionInitiatedBy

Mendapatkan siapa yang memulai eksekusi tindakan yang direkomendasikan ini. Nilai yang Mungkin adalah: Pengguna -> Saat sistem pemberitahuan eksplisit pengguna menerapkan tindakan yang direkomendasikan. Sistem -> Ketika status eksekusi otomatis advisor ini diatur ke 'Diaktifkan', dalam hal ini sistem menerapkannya.

Name Type Description
System
  • string
User
  • string

RecommendedActionMetricInfo

Berisi rangkaian waktu dari berbagai metrik yang terkena dampak untuk Tindakan yang Direkomendasikan Azure SQL Database, Server, atau Kumpulan Elastis.

Name Type Description
metricName
  • string

Mendapatkan nama metrik. misalnya, CPU, Jumlah Kueri.
startTime
  • string

Mendapatkan waktu mulai interval waktu yang diberikan oleh MetricInfo ini.
timeGrain
  • string

Mendapatkan durasi interval waktu untuk nilai yang diberikan oleh MetricInfo ini. misalnya, PT1H (1 jam)
unit
  • string

Mendapatkan unit di mana metrik diukur. misalnya, DTU, Frekuensi
value
  • number

Mendapatkan nilai metrik dalam interval waktu yang diberikan oleh MetricInfo ini.

RecommendedActionStateInfo

Berisi informasi status saat ini untuk Tindakan yang Direkomendasikan Azure SQL Database, Server, atau Kumpulan Elastis.

Name Type Description
actionInitiatedBy

Mendapatkan siapa yang memulai eksekusi tindakan yang direkomendasikan ini. Nilai yang Mungkin adalah: Pengguna -> Saat sistem pemberitahuan eksplisit pengguna menerapkan tindakan yang direkomendasikan. Sistem -> Ketika status eksekusi otomatis advisor ini diatur ke 'Diaktifkan', dalam hal ini sistem menerapkannya.
currentValue

Status saat ini, tindakan yang disarankan ada. Beberapa status yang umum digunakan adalah: Aktif -> tindakan yang direkomendasikan aktif dan belum ada tindakan yang diambil. Tertunda -> tindakan yang direkomendasikan disetujui dan sedang menunggu eksekusi. Menjalankan -> tindakan yang direkomendasikan sedang diterapkan pada database pengguna. Memverifikasi -> tindakan yang direkomendasikan diterapkan dan sedang diverifikasi kegunaannya oleh sistem. Berhasil -> tindakan yang direkomendasikan diterapkan dan perbaikan ditemukan selama verifikasi. Kembali tertunda -> verifikasi menemukan sedikit atau tidak ada peningkatan sehingga tindakan yang direkomendasikan diantrekan untuk kembali atau pengguna telah kembali secara manual. Mengembalikan -> perubahan yang dilakukan saat menerapkan tindakan yang direkomendasikan sedang dikembalikan pada database pengguna. Dikembalikan -> berhasil mengembalikan perubahan yang dibuat oleh tindakan yang direkomendasikan pada database pengguna. Diabaikan -> pengguna secara eksplisit mengabaikan/membuang tindakan yang direkomendasikan.
lastModified
  • string

Mendapatkan waktu ketika status terakhir diubah