Database Automatic Tuning - Update

Szolgáltatás:

SQL Database

API verzió:

2023-08-01

Frissítse a céladatbázis automatikus hangolási tulajdonságait.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/automaticTuning/current?api-version=2023-08-01

URI paraméterek

Név	Ban	Szükséges	Típus	Leírás
databaseName	path	True	string	Az adatbázis neve.
resourceGroupName	path	True	string	Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
serverName	path	True	string	A kiszolgáló neve.
subscriptionId	path	True	string	Az Azure-előfizetést azonosító előfizetés-azonosító.
api-version	query	True	string	A kéréshez használni kívánt API-verzió.

Kérő Testület

Név	Típus	Leírás
properties.desiredState	AutomaticTuningMode	A kívánt állapot automatikus finomhangolása.
properties.options	<string,  AutomaticTuningOptions>	Automatikus hangolási beállítások definíciója.

Válaszok

Név	Típus	Leírás
200 OK	DatabaseAutomaticTuning	Sikeresen frissítette a megadott adatbázis automatikus hangolási beállításait.
Other Status Codes	ErrorResponse	Hibaválaszok: *** 400 FeatureDisabledOnSelectedEdition – A felhasználó olyan funkciót próbált használni, amely le van tiltva az aktuális adatbázis-kiadásban. 400 InvalidIdentifier – Az azonosító NULL vagy érvénytelen Unicode karaktert tartalmaz. 400 SystemDatabasesNotSupported – A felhasználó automatikus hangolási információkat próbált lekérni a rendszeradatbázisokról. 400 DataWarehouseNotSupported – Az SQL Data Warehouse nem támogatja az automatikus hangolást. 400 InvalidAutomaticTuningUpsertRequest – Az automatikus frissítési kérelem törzse nem létezik, vagy nincs tulajdonságobjektuma. 400 InvalidAdvisorAutoExecuteStatus – A tanácsadó megadott automatikus végrehajtási állapota nem engedélyezett. 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található 404 DatabaseDoesNotExist – A kért adatbázis nem található 404 SubscriptionDoesNotHaveElasticPool – A kért rugalmas készlet nem található 404 OperationIdNotFound – Az azonosítóval rendelkező művelet nem létezik. 404 AutomaticTuningOptionNotFound – A kért automatikus hangolási beállítás nem található. 405 Nem támogatott – Ez a funkció nem támogatott. 409 Ütközés – A kérés nem dolgozható fel a kérelem ütközése miatt. 409 CannotCancelOperation – A felügyeleti művelet olyan állapotban van, amely nem törölhető. 409 OperationCancelled – A felhasználó megszakította a műveletet. 409 OperationInterrupted – Az erőforráson lévő művelet nem hajtható végre, mert egy másik művelet megszakította ugyanazon az erőforráson. 409 DefaultAdvisorStateNotAllowedInCustomDbMode – A DEFAULT advisor állapota nem engedélyezett EGYÉNI módban 409 DisabledBySystem – Ezt a beállítást a rendszer letiltja 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések. 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható kérelmek maximálisnál több kérése. 500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Próbálkozzon újra a művelettel. 503 ServiceTemporarilyUnavailable – A szolgáltatás átmenetileg nem érhető el. 503 TooManyRequests – A rendelkezésre álló erőforrások által feldolgozható maximális kérelmeken túli kérések.

Példák

Updates database automatic tuning settings with all properties

Updates database automatic tuning settings with minimal properties

Updates database automatic tuning settings with all properties

Mintakérés

HTTP

PATCH https://management.azure.com/subscriptions/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/databases/db1/automaticTuning/current?api-version=2023-08-01

{
  "properties": {
    "desiredState": "Auto",
    "options": {
      "createIndex": {
        "desiredState": "Off"
      },
      "dropIndex": {
        "desiredState": "On"
      },
      "forceLastGoodPlan": {
        "desiredState": "Default"
      }
    }
  }
}

Mintaválasz

Állapotkód:

200

{
  "id": "/subscriptions/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/databases/db1/automaticTuning/current",
  "name": "current",
  "type": "Microsoft.Sql/servers/databases/automaticTuning",
  "properties": {
    "desiredState": "Auto",
    "actualState": "Auto",
    "options": {
      "forceLastGoodPlan": {
        "desiredState": "Default",
        "actualState": "On",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "createIndex": {
        "desiredState": "Off",
        "actualState": "Off"
      },
      "dropIndex": {
        "desiredState": "On",
        "actualState": "On"
      },
      "maintainIndex": {
        "desiredState": "Default",
        "actualState": "Off",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      }
    }
  }
}

Updates database automatic tuning settings with minimal properties

Mintakérés

HTTP

PATCH https://management.azure.com/subscriptions/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/databases/db1/automaticTuning/current?api-version=2023-08-01

{
  "properties": {
    "desiredState": "Auto"
  }
}

Mintaválasz

Állapotkód:

200

{
  "id": "/subscriptions/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/databases/db1/automaticTuning/current",
  "name": "current",
  "type": "Microsoft.Sql/servers/databases/automaticTuning",
  "properties": {
    "desiredState": "Auto",
    "actualState": "Auto",
    "options": {
      "forceLastGoodPlan": {
        "desiredState": "Default",
        "actualState": "On",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "createIndex": {
        "desiredState": "Default",
        "actualState": "On",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "dropIndex": {
        "desiredState": "Default",
        "actualState": "Off",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "maintainIndex": {
        "desiredState": "Default",
        "actualState": "Off",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      }
    }
  }
}

Meghatározások

Név	Leírás
AutomaticTuningDisabledReason	Ok leírása, ha a kívánt és a tényleges állapot eltérő.
AutomaticTuningMode	A kívánt állapot automatikus finomhangolása.
AutomaticTuningOptionModeActual	Automatikus finomhangolási beállítás tényleges állapota.
AutomaticTuningOptionModeDesired	Automatikus finomhangolási beállítás kívánt állapota.
AutomaticTuningOptions	Az egyes tanácsadók automatikus hangolási tulajdonságai.
DatabaseAutomaticTuning	Adatbázisszintű automatikus hangolás.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz

AutomaticTuningDisabledReason

Felsorolás

Ok leírása, ha a kívánt és a tényleges állapot eltérő.

Érték	Leírás
Default
Disabled
AutoConfigured
InheritedFromServer
QueryStoreOff
QueryStoreReadOnly
NotSupported

AutomaticTuningMode

Felsorolás

A kívánt állapot automatikus finomhangolása.

Érték	Leírás
Inherit
Custom
Auto
Unspecified

AutomaticTuningOptionModeActual

Felsorolás

Automatikus finomhangolási beállítás tényleges állapota.

Érték	Leírás
Off
On

AutomaticTuningOptionModeDesired

Felsorolás

Automatikus finomhangolási beállítás kívánt állapota.

Érték	Leírás
Off
On
Default

AutomaticTuningOptions

Tárgy

Az egyes tanácsadók automatikus hangolási tulajdonságai.

Név	Típus	Leírás
actualState	AutomaticTuningOptionModeActual	Automatikus finomhangolási beállítás tényleges állapota.
desiredState	AutomaticTuningOptionModeDesired	Automatikus finomhangolási beállítás kívánt állapota.
reasonCode	integer (int32)	Okkód, ha a kívánt és a tényleges állapot eltérő.
reasonDesc	AutomaticTuningDisabledReason	Ok leírása, ha a kívánt és a tényleges állapot eltérő.

DatabaseAutomaticTuning

Tárgy

Adatbázisszintű automatikus hangolás.

Név	Típus	Leírás
id	string	Erőforrás-azonosító.
name	string	Erőforrás neve.
properties.actualState	AutomaticTuningMode	A tényleges állapot automatikus finomhangolása.
properties.desiredState	AutomaticTuningMode	A kívánt állapot automatikus finomhangolása.
properties.options	<string,  AutomaticTuningOptions>	Automatikus hangolási beállítások definíciója.
type	string	Erőforrás típusa.

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Név	Típus	Leírás
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Név	Típus	Leírás
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Tárgy

Hibaválasz

Név	Típus	Leírás
error	ErrorDetail	A hibaobjektum.