Condividi tramite

Databases - Update

  • Riferimento
Servizio:
SQL Database
Versione API:
2014-04-01

Aggiorna un database esistente.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
databaseName
 path True

string

Nome del database da aggiornare.
resourceGroupName
 path True

string

Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
serverName
 path True

string

Il nome del server.
subscriptionId
 path True

string

ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version
 query True

string

Versione dell'API da usare per la richiesta.

Corpo della richiesta

Nome Tipo Descrizione
parameters

DatabaseUpdate

Parametri obbligatori per l'aggiornamento di un database.

Risposte

Nome Tipo Descrizione
200 OK

Database

Va bene
202 Accepted

Accettato

Esempio

Update a database max
Update a database min

Update a database max

Esempio di richiesta

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-5961/databases/testdb?api-version=2014-04-01

{
  "properties": {
    "edition": "Standard",
    "status": "Online",
    "createMode": "Default",
    "serviceLevelObjective": "S0",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": "268435456000",
    "currentServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "Japan West",
    "earliestRestoreDate": "2017-02-10T01:52:52.923Z",
    "containmentState": 2,
    "readScale": "Disabled"
  }
}

Risposta di esempio

Codice di stato:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-5961/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases",
  "location": "Japan East",
  "kind": "v12.0,user",
  "properties": {
    "edition": "Standard",
    "status": "Online",
    "serviceLevelObjective": "S0",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "creationDate": "2017-02-24T22:39:46.547Z",
    "maxSizeBytes": "268435456000",
    "currentServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveName": "S0",
    "sampleName": null,
    "defaultSecondaryLocation": "Japan West",
    "earliestRestoreDate": "2017-02-10T01:52:52.923Z",
    "elasticPoolName": null,
    "containmentState": 2,
    "readScale": "Disabled",
    "failoverGroupId": null
  }
}
Codice di stato:
202

Update a database min

Esempio di richiesta

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-5961/databases/testdb?api-version=2014-04-01

{}

Risposta di esempio

Codice di stato:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-5961/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases",
  "location": "Japan East",
  "kind": "v12.0,user",
  "properties": {
    "edition": "Standard",
    "status": "Online",
    "serviceLevelObjective": "S0",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "creationDate": "2017-02-24T22:39:46.547Z",
    "maxSizeBytes": "268435456000",
    "currentServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveName": "S0",
    "sampleName": null,
    "defaultSecondaryLocation": "Japan West",
    "earliestRestoreDate": "2017-02-10T01:52:52.923Z",
    "elasticPoolName": null,
    "containmentState": 2,
    "readScale": "Disabled",
    "failoverGroupId": null
  }
}
Codice di stato:
202

Definizioni

Nome Descrizione
CreateMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione regolare del database.

Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine.

OnlineSecondary/NonReadableSecondary: crea un database come replica secondaria (leggibile o non leggibile) di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente.

PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime.

Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database recuperabile da ripristinare.

Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminato ripristinabile e sourceDatabaseDeletionDate viene ignorato. è anche possibile specificare restorePointInTime per eseguire il ripristino da un punto precedente nel tempo.

RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino.

Copy, NonReadableSecondary, OnlineSecondary e RestoreLongTermRetentionBackup non sono supportati per l'edizione DataWarehouse.
Database

Rappresenta un database.
DatabaseEdition

Edizione del database. L'enumerazione DatabaseEditions contiene tutte le edizioni valide. Se createMode è NonReadableSecondary o OnlineSecondary, questo valore viene ignorato.

L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli SKU (inclusi il nome dello SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API REST Capabilities_ListByLocation o uno dei comandi seguenti:

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
DatabaseUpdate

Parametri obbligatori per l'aggiornamento di un database.
OperationImpact

Impatto stimato dell'esecuzione dell'azione di indice consigliata.
ReadScale

Condizionale. Se il database è un database geografico secondario, readScale indica se le connessioni di sola lettura sono consentite a questo database o meno. Non supportato per l'edizione DataWarehouse.
RecommendedIndex

Indici consigliati per questo database.
RecommendedIndexAction

Azione di indice proposta. È possibile creare un indice mancante, eliminare un indice inutilizzato o ricompilare un indice esistente per migliorarne le prestazioni.
RecommendedIndexState

Stato della raccomandazione corrente.
RecommendedIndexType

Tipo di indice (CLUSTERED, NONCLUSTERED, COLUMNSTORE, CLUSTERED COLUMNSTORE)
SampleName

Indica il nome dello schema di esempio da applicare durante la creazione del database. Se createMode non è Default, questo valore viene ignorato. Non supportato per l'edizione DataWarehouse.
ServiceObjectiveName

Nome dell'obiettivo del livello di servizio configurato del database. Si tratta dell'obiettivo del livello di servizio in fase di applicazione al database. Dopo l'aggiornamento, corrisponderà al valore della proprietà serviceLevelObjective.

L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli SKU (inclusi il nome dello SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API REST Capabilities_ListByLocation o uno dei comandi seguenti:

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
ServiceTierAdvisor

Elenco di advisor del livello di servizio per questo database. Proprietà espansa
SloUsageMetric

Ottiene o imposta serviceLevelObjectiveUsageMetrics per advisor del livello di servizio.
TransparentDataEncryption

Informazioni di Transparent Data Encryption per questo database.
TransparentDataEncryptionStatus

Stato di Transparent Data Encryption del database.

CreateMode

Enumerazione

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione regolare del database.

Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine.

OnlineSecondary/NonReadableSecondary: crea un database come replica secondaria (leggibile o non leggibile) di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente.

PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime.

Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database recuperabile da ripristinare.

Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminato ripristinabile e sourceDatabaseDeletionDate viene ignorato. è anche possibile specificare restorePointInTime per eseguire il ripristino da un punto precedente nel tempo.

RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino.

Copy, NonReadableSecondary, OnlineSecondary e RestoreLongTermRetentionBackup non sono supportati per l'edizione DataWarehouse.

Valore Descrizione
Copy
Default
NonReadableSecondary
OnlineSecondary
PointInTimeRestore
Recovery
Restore
RestoreLongTermRetentionBackup

Database

Object

Rappresenta un database.

Nome Tipo Descrizione
id

string

ID risorsa.
kind

string

Tipo di database. Si tratta di metadati usati per l'esperienza del portale di Azure.
location

string

Percorso della risorsa.
name

string

Nome risorsa.
properties.collation

string

Regole di confronto del database. Se createMode non è Default, questo valore viene ignorato.
properties.containmentState

integer (int64)

Stato di contenimento del database.
properties.createMode

CreateMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione regolare del database.

Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine.

OnlineSecondary/NonReadableSecondary: crea un database come replica secondaria (leggibile o non leggibile) di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente.

PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime.

Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database recuperabile da ripristinare.

Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminato ripristinabile e sourceDatabaseDeletionDate viene ignorato. è anche possibile specificare restorePointInTime per eseguire il ripristino da un punto precedente nel tempo.

RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino.

Copy, NonReadableSecondary, OnlineSecondary e RestoreLongTermRetentionBackup non sono supportati per l'edizione DataWarehouse.
properties.creationDate

string (date-time)

Data di creazione del database (formato ISO8601).
properties.currentServiceObjectiveId

string (uuid)

ID obiettivo del livello di servizio corrente del database. Si tratta dell'ID dell'obiettivo del livello di servizio attualmente attivo.
properties.databaseId

string (uuid)

ID del database.
properties.defaultSecondaryLocation

string

Area secondaria predefinita per questo database.
properties.earliestRestoreDate

string (date-time)

Registra la data e l'ora di inizio meno recente disponibili per il database (ISO8601 formato).
properties.edition

DatabaseEdition

Edizione del database. L'enumerazione DatabaseEditions contiene tutte le edizioni valide. Se createMode è NonReadableSecondary o OnlineSecondary, questo valore viene ignorato.

L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli SKU (inclusi il nome dello SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API REST Capabilities_ListByLocation o uno dei comandi seguenti:

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
properties.elasticPoolName

string

Nome del pool elastico in cui si trova il database. Se elasticPoolName e requestedServiceObjectiveName vengono aggiornati entrambi, il valore di requestedServiceObjectiveName viene ignorato. Non supportato per l'edizione DataWarehouse.
properties.failoverGroupId

string

Identificatore della risorsa del gruppo di failover contenente il database.
properties.maxSizeBytes

string

Dimensione massima del database espressa in byte. Se createMode non è Default, questo valore viene ignorato. Per visualizzare i valori possibili, eseguire una query sull'API capabilities (/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationID}/capabilities) a cui fa riferimento operationId: "Capabilities_ListByLocation".
properties.readScale

ReadScale

Condizionale. Se il database è un database geografico secondario, readScale indica se le connessioni di sola lettura sono consentite a questo database o meno. Non supportato per l'edizione DataWarehouse.
properties.recommendedIndex

RecommendedIndex[]

Indici consigliati per questo database.
properties.recoveryServicesRecoveryPointResourceId

string

Condizionale. Se createMode è RestoreLongTermRetentionBackup, questo valore è obbligatorio. Specifica l'ID risorsa del punto di ripristino da cui eseguire il ripristino.
properties.requestedServiceObjectiveId

string (uuid)

ID obiettivo del livello di servizio configurato del database. Si tratta dell'obiettivo del livello di servizio in fase di applicazione al database. Dopo l'aggiornamento, corrisponderà al valore della proprietà currentServiceObjectiveId. Se requestedServiceObjectiveId e requestedServiceObjectiveName vengono aggiornati entrambi, il valore di requestedServiceObjectiveId sostituisce il valore di requestedServiceObjectiveName.

L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli ID obiettivo di servizio disponibili per la sottoscrizione in un'area di Azure, usare l'API REST Capabilities_ListByLocation.
properties.requestedServiceObjectiveName

ServiceObjectiveName

Nome dell'obiettivo del livello di servizio configurato del database. Si tratta dell'obiettivo del livello di servizio in fase di applicazione al database. Dopo l'aggiornamento, corrisponderà al valore della proprietà serviceLevelObjective.

L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli SKU (inclusi il nome dello SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API REST Capabilities_ListByLocation o uno dei comandi seguenti:

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
properties.restorePointInTime

string (date-time)

Condizionale. Se createMode è PointInTimeRestore, questo valore è obbligatorio. Se createMode è Restore, questo valore è facoltativo. Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database. Deve essere maggiore o uguale al valore meno recenteRestoreDate del database di origine.
properties.sampleName

SampleName

Indica il nome dello schema di esempio da applicare durante la creazione del database. Se createMode non è Default, questo valore viene ignorato. Non supportato per l'edizione DataWarehouse.
properties.serviceLevelObjective

ServiceObjectiveName

Obiettivo del livello di servizio corrente del database.
properties.serviceTierAdvisors

ServiceTierAdvisor[]

Elenco di advisor del livello di servizio per questo database. Proprietà espansa
properties.sourceDatabaseDeletionDate

string (date-time)

Condizionale. Se createMode è Restore e sourceDatabaseId è l'ID risorsa originale del database eliminato quando esiste (anziché il relativo ID database eliminato ripristinabile corrente), questo valore è obbligatorio. Specifica l'ora di eliminazione del database.
properties.sourceDatabaseId

string

Condizionale. Se createMode è Copy, NonReadableSecondary, OnlineSecondary, PointInTimeRestore, Recovery o Restore, questo valore è obbligatorio. Specifica l'ID risorsa del database di origine. Se createMode è NonReadableSecondary o OnlineSecondary, il nome del database di origine deve essere uguale al nuovo database in fase di creazione.
properties.status

string

Stato del database.
properties.transparentDataEncryption

TransparentDataEncryption[]

Informazioni di Transparent Data Encryption per questo database.
properties.zoneRedundant

boolean

Indipendentemente dal fatto che il database sia con ridondanza della zona, ovvero le repliche di questo database verranno distribuite in più zone di disponibilità.
tags

object

Tag di risorsa.
type

string

Tipo di risorsa.

DatabaseEdition

Enumerazione

Edizione del database. L'enumerazione DatabaseEditions contiene tutte le edizioni valide. Se createMode è NonReadableSecondary o OnlineSecondary, questo valore viene ignorato.

L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli SKU (inclusi il nome dello SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API REST Capabilities_ListByLocation o uno dei comandi seguenti:

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
Valore Descrizione
Basic
Business
BusinessCritical
DataWarehouse
Free
GeneralPurpose
Hyperscale
Premium
PremiumRS
Standard
Stretch
System
System2
Web

DatabaseUpdate

Object

Parametri obbligatori per l'aggiornamento di un database.

Nome Tipo Descrizione
id

string

ID risorsa.
name

string

Nome risorsa.
properties.collation

string

Regole di confronto del database. Se createMode non è Default, questo valore viene ignorato.
properties.containmentState

integer (int64)

Stato di contenimento del database.
properties.createMode

CreateMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione regolare del database.

Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine.

OnlineSecondary/NonReadableSecondary: crea un database come replica secondaria (leggibile o non leggibile) di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente.

PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime.

Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database recuperabile da ripristinare.

Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminato ripristinabile e sourceDatabaseDeletionDate viene ignorato. è anche possibile specificare restorePointInTime per eseguire il ripristino da un punto precedente nel tempo.

RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino.

Copy, NonReadableSecondary, OnlineSecondary e RestoreLongTermRetentionBackup non sono supportati per l'edizione DataWarehouse.
properties.creationDate

string (date-time)

Data di creazione del database (formato ISO8601).
properties.currentServiceObjectiveId

string (uuid)

ID obiettivo del livello di servizio corrente del database. Si tratta dell'ID dell'obiettivo del livello di servizio attualmente attivo.
properties.databaseId

string (uuid)

ID del database.
properties.defaultSecondaryLocation

string

Area secondaria predefinita per questo database.
properties.earliestRestoreDate

string (date-time)

Registra la data e l'ora di inizio meno recente disponibili per il database (ISO8601 formato).
properties.edition

DatabaseEdition

Edizione del database. L'enumerazione DatabaseEditions contiene tutte le edizioni valide. Se createMode è NonReadableSecondary o OnlineSecondary, questo valore viene ignorato.

L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli SKU (inclusi il nome dello SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API REST Capabilities_ListByLocation o uno dei comandi seguenti:

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
properties.elasticPoolName

string

Nome del pool elastico in cui si trova il database. Se elasticPoolName e requestedServiceObjectiveName vengono aggiornati entrambi, il valore di requestedServiceObjectiveName viene ignorato. Non supportato per l'edizione DataWarehouse.
properties.failoverGroupId

string

Identificatore della risorsa del gruppo di failover contenente il database.
properties.maxSizeBytes

string

Dimensione massima del database espressa in byte. Se createMode non è Default, questo valore viene ignorato. Per visualizzare i valori possibili, eseguire una query sull'API capabilities (/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationID}/capabilities) a cui fa riferimento operationId: "Capabilities_ListByLocation".
properties.readScale

ReadScale

Condizionale. Se il database è un database geografico secondario, readScale indica se le connessioni di sola lettura sono consentite a questo database o meno. Non supportato per l'edizione DataWarehouse.
properties.recommendedIndex

RecommendedIndex[]

Indici consigliati per questo database.
properties.recoveryServicesRecoveryPointResourceId

string

Condizionale. Se createMode è RestoreLongTermRetentionBackup, questo valore è obbligatorio. Specifica l'ID risorsa del punto di ripristino da cui eseguire il ripristino.
properties.requestedServiceObjectiveId

string (uuid)

ID obiettivo del livello di servizio configurato del database. Si tratta dell'obiettivo del livello di servizio in fase di applicazione al database. Dopo l'aggiornamento, corrisponderà al valore della proprietà currentServiceObjectiveId. Se requestedServiceObjectiveId e requestedServiceObjectiveName vengono aggiornati entrambi, il valore di requestedServiceObjectiveId sostituisce il valore di requestedServiceObjectiveName.

L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli ID obiettivo di servizio disponibili per la sottoscrizione in un'area di Azure, usare l'API REST Capabilities_ListByLocation.
properties.requestedServiceObjectiveName

ServiceObjectiveName

Nome dell'obiettivo del livello di servizio configurato del database. Si tratta dell'obiettivo del livello di servizio in fase di applicazione al database. Dopo l'aggiornamento, corrisponderà al valore della proprietà serviceLevelObjective.

L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli SKU (inclusi il nome dello SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API REST Capabilities_ListByLocation o uno dei comandi seguenti:

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
properties.restorePointInTime

string (date-time)

Condizionale. Se createMode è PointInTimeRestore, questo valore è obbligatorio. Se createMode è Restore, questo valore è facoltativo. Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database. Deve essere maggiore o uguale al valore meno recenteRestoreDate del database di origine.
properties.sampleName

SampleName

Indica il nome dello schema di esempio da applicare durante la creazione del database. Se createMode non è Default, questo valore viene ignorato. Non supportato per l'edizione DataWarehouse.
properties.serviceLevelObjective

ServiceObjectiveName

Obiettivo del livello di servizio corrente del database.
properties.serviceTierAdvisors

ServiceTierAdvisor[]

Elenco di advisor del livello di servizio per questo database. Proprietà espansa
properties.sourceDatabaseDeletionDate

string (date-time)

Condizionale. Se createMode è Restore e sourceDatabaseId è l'ID risorsa originale del database eliminato quando esiste (anziché il relativo ID database eliminato ripristinabile corrente), questo valore è obbligatorio. Specifica l'ora di eliminazione del database.
properties.sourceDatabaseId

string

Condizionale. Se createMode è Copy, NonReadableSecondary, OnlineSecondary, PointInTimeRestore, Recovery o Restore, questo valore è obbligatorio. Specifica l'ID risorsa del database di origine. Se createMode è NonReadableSecondary o OnlineSecondary, il nome del database di origine deve essere uguale al nuovo database in fase di creazione.
properties.status

string

Stato del database.
properties.transparentDataEncryption

TransparentDataEncryption[]

Informazioni di Transparent Data Encryption per questo database.
properties.zoneRedundant

boolean

Indipendentemente dal fatto che il database sia con ridondanza della zona, ovvero le repliche di questo database verranno distribuite in più zone di disponibilità.
tags

object

Tag di risorsa.
type

string

Tipo di risorsa.

OperationImpact

Object

Impatto stimato dell'esecuzione dell'azione di indice consigliata.

Nome Tipo Descrizione
changeValueAbsolute

number (double)

Impatto assoluto sulla dimensione.
changeValueRelative

number (double)

Impatto relativo alla dimensione (null, se non applicabile)
name

string

Nome della dimensione di impatto.
unit

string

Unità in cui viene misurato l'impatto stimato sulla dimensione.

ReadScale

Enumerazione

Condizionale. Se il database è un database geografico secondario, readScale indica se le connessioni di sola lettura sono consentite a questo database o meno. Non supportato per l'edizione DataWarehouse.

Valore Descrizione
Disabled
Enabled

RecommendedIndex

Object

Indici consigliati per questo database.

Nome Tipo Descrizione
id

string

ID risorsa.
name

string

Nome risorsa.
properties.action

RecommendedIndexAction

Azione di indice proposta. È possibile creare un indice mancante, eliminare un indice inutilizzato o ricompilare un indice esistente per migliorarne le prestazioni.
properties.columns

string[]

Colonne su cui compilare l'indice
properties.created

string (date-time)

Data/ora UTC che indica quando questa risorsa è stata creata (ISO8601 formato).
properties.estimatedImpact

OperationImpact[]

Impatto stimato dell'esecuzione dell'azione di indice consigliata.
properties.includedColumns

string[]

Elenco di nomi di colonna da includere nell'indice
properties.indexScript

string

Script dell'indice di compilazione completo
properties.indexType

RecommendedIndexType

Tipo di indice (CLUSTERED, NONCLUSTERED, COLUMNSTORE, CLUSTERED COLUMNSTORE)
properties.lastModified

string (date-time)

Data/ora UTC dell'ultima modifica della risorsa (formato ISO8601).
properties.reportedImpact

OperationImpact[]

I valori riportati dopo il completamento dell'azione sull'indice.
properties.schema

string

Schema in cui risiede la tabella in cui compilare l'indice
properties.state

RecommendedIndexState

Stato della raccomandazione corrente.
properties.table

string

Tabella in cui compilare l'indice.
type

string

Tipo di risorsa.

RecommendedIndexAction

Enumerazione

Azione di indice proposta. È possibile creare un indice mancante, eliminare un indice inutilizzato o ricompilare un indice esistente per migliorarne le prestazioni.

Valore Descrizione
Create
Drop
Rebuild

RecommendedIndexState

Enumerazione

Stato della raccomandazione corrente.

Valore Descrizione
Active
Blocked
Executing
Expired
Ignored
Pending
Pending Revert
Reverted
Reverting
Success
Verifying

RecommendedIndexType

Enumerazione

Tipo di indice (CLUSTERED, NONCLUSTERED, COLUMNSTORE, CLUSTERED COLUMNSTORE)

Valore Descrizione
CLUSTERED
CLUSTERED COLUMNSTORE
COLUMNSTORE
NONCLUSTERED

SampleName

Enumerazione

Indica il nome dello schema di esempio da applicare durante la creazione del database. Se createMode non è Default, questo valore viene ignorato. Non supportato per l'edizione DataWarehouse.

Valore Descrizione
AdventureWorksLT

ServiceObjectiveName

Enumerazione

Nome dell'obiettivo del livello di servizio configurato del database. Si tratta dell'obiettivo del livello di servizio in fase di applicazione al database. Dopo l'aggiornamento, corrisponderà al valore della proprietà serviceLevelObjective.

L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli SKU (inclusi il nome dello SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API REST Capabilities_ListByLocation o uno dei comandi seguenti:

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
Valore Descrizione
Basic
DS100
DS1000
DS1200
DS1500
DS200
DS2000
DS300
DS400
DS500
DS600
DW100
DW1000
DW10000c
DW1000c
DW1200
DW1500
DW15000c
DW1500c
DW200
DW2000
DW2000c
DW2500c
DW300
DW3000
DW30000c
DW3000c
DW400
DW500
DW5000c
DW600
DW6000
DW6000c
DW7500c
ElasticPool
Free
P1
P11
P15
P2
P3
P4
P6
PRS1
PRS2
PRS4
PRS6
S0
S1
S12
S2
S3
S4
S6
S7
S9
System
System0
System1
System2
System2L
System3
System3L
System4
System4L

ServiceTierAdvisor

Object

Elenco di advisor del livello di servizio per questo database. Proprietà espansa

Nome Tipo Descrizione
id

string

ID risorsa.
name

string

Nome risorsa.
properties.activeTimeRatio

number (double)

ActiveTimeRatio per Assistente livello di servizio.
properties.avgDtu

number (double)

Ottiene o imposta avgDtu per Assistente livello di servizio.
properties.confidence

number (double)

Ottiene o imposta l'attendibilità per Advisor del livello di servizio.
properties.currentServiceLevelObjective

string

Ottiene o imposta currentServiceLevelObjective per advisor del livello di servizio.
properties.currentServiceLevelObjectiveId

string (uuid)

Ottiene o imposta currentServiceLevelObjectiveId per advisor del livello di servizio.
properties.databaseSizeBasedRecommendationServiceLevelObjective

string

Ottiene o imposta databaseSizeBasedRecommendationServiceLevelObjective per advisor del livello di servizio.
properties.databaseSizeBasedRecommendationServiceLevelObjectiveId

string (uuid)

Ottiene o imposta databaseSizeBasedRecommendationServiceLevelObjectiveId per advisor del livello di servizio.
properties.disasterPlanBasedRecommendationServiceLevelObjective

string

Ottiene o imposta disasterPlanBasedRecommendationServiceLevelObjective per advisor del livello di servizio.
properties.disasterPlanBasedRecommendationServiceLevelObjectiveId

string (uuid)

Ottiene o imposta disasterPlanBasedRecommendationServiceLevelObjectiveId per advisor del livello di servizio.
properties.maxDtu

number (double)

Ottiene o imposta maxDtu per Assistente livello di servizio.
properties.maxSizeInGB

number (double)

Ottiene o imposta maxSizeInGB per Assistente livello di servizio.
properties.minDtu

number (double)

Ottiene o imposta minDtu per Assistente livello di servizio.
properties.observationPeriodEnd

string (date-time)

Inizio del periodo di osservazione (formato ISO8601).
properties.observationPeriodStart

string (date-time)

Inizio del periodo di osservazione (formato ISO8601).
properties.overallRecommendationServiceLevelObjective

string

Ottiene o imposta overallRecommendationServiceLevelObjective per advisor del livello di servizio.
properties.overallRecommendationServiceLevelObjectiveId

string (uuid)

Ottiene o imposta overallRecommendationServiceLevelObjectiveId per Advisor del livello di servizio.
properties.serviceLevelObjectiveUsageMetrics

SloUsageMetric[]

Ottiene o imposta serviceLevelObjectiveUsageMetrics per advisor del livello di servizio.
properties.usageBasedRecommendationServiceLevelObjective

string

Ottiene o imposta usageBasedRecommendationServiceLevelObjective per advisor del livello di servizio.
properties.usageBasedRecommendationServiceLevelObjectiveId

string (uuid)

Ottiene o imposta usageBasedRecommendationServiceLevelObjectiveId per advisor del livello di servizio.
type

string

Tipo di risorsa.

SloUsageMetric

Object

Ottiene o imposta serviceLevelObjectiveUsageMetrics per advisor del livello di servizio.

Nome Tipo Descrizione
inRangeTimeRatio

number (double)

Ottiene o imposta inRangeTimeRatio per la metrica di utilizzo di SLO.
serviceLevelObjective

ServiceObjectiveName

Metrica di utilizzo di serviceLevelObjective per SLO.
serviceLevelObjectiveId

string (uuid)

Metrica di utilizzo di serviceLevelObjectiveId per SLO.

TransparentDataEncryption

Object

Informazioni di Transparent Data Encryption per questo database.

Nome Tipo Descrizione
id

string

ID risorsa.
location

string

Percorso della risorsa.
name

string

Nome risorsa.
properties.status

TransparentDataEncryptionStatus

Stato di Transparent Data Encryption del database.
type

string

Tipo di risorsa.

TransparentDataEncryptionStatus

Enumerazione

Stato di Transparent Data Encryption del database.

Valore Descrizione
Disabled
Enabled