Databases - Update

Ссылка

Служба:: SQL Database

Версия API:: 2014-04-01

Обновляет имеющуюся базу данных.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
databaseName	path	True	string	Имя обновляемой базы данных.
resourceGroupName	path	True	string	Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
serverName	path	True	string	Имя сервера.
subscriptionId	path	True	string	Идентификатор подписки Azure.
api-version	query	True	string	Версия API для использования в запросе.

Текст запроса

Имя	Тип	Описание
parameters	DatabaseUpdate	Обязательные параметры для обновления базы данных.

Ответы

Имя	Тип	Описание
200 OK	Database	ОК
202 Accepted		Принято

Примеры

Update a database max

Update a database min

Update a database max

Образец запроса

HTTP

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"
  }
}

Пример ответа

Код состояния:: 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
  }
}

Код состояния:: 202

Update a database min

Образец запроса

HTTP

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

{}

Пример ответа

Код состояния:: 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
  }
}

Код состояния:: 202

Определения

Имя	Описание
CreateMode	Указывает режим создания базы данных. По умолчанию: регулярное создание базы данных. Копировать: создает базу данных как копию существующей базы данных. sourceDatabaseId должен быть указан в качестве идентификатора ресурса базы данных-источника. OnlineSecondary/NonReadableSecondary: создает базу данных в качестве (доступной для чтения или нечитаемой) вторичной реплика существующей базы данных. SourceDatabaseId должен быть указан в качестве идентификатора ресурса существующей базы данных-источника. PointInTimeRestore. Создает базу данных путем восстановления резервной копии существующей базы данных на определенный момент времени. sourceDatabaseId необходимо указать в качестве идентификатора ресурса существующей базы данных, а также параметр restorePointInTime. Восстановление. Создает базу данных путем восстановления геореплицированной резервной копии. sourceDatabaseId должен быть указан в качестве идентификатора ресурса восстанавливаемой базы данных для восстановления. Восстановление. Создает базу данных путем восстановления резервной копии удаленной базы данных. Необходимо указать sourceDatabaseId. Если sourceDatabaseId является исходным идентификатором ресурса базы данных, необходимо указать sourceDatabaseDeletionDate. В противном случае sourceDatabaseId должен быть восстанавливаемым идентификатором удаленного ресурса базы данных, а sourceDatabaseDeletionDate игнорируется. Параметр restorePointInTime также может быть указан для восстановления с более ранней точки во времени. RestoreLongTermRetentionBackup: создает базу данных путем восстановления из хранилища долгосрочного хранения. recoveryServicesRecoveryPointResourceId должен быть указан в качестве идентификатора ресурса точки восстановления. Copy, NonReadableSecondary, OnlineSecondary и RestoreLongTermRetentionBackup не поддерживаются для выпуска DataWarehouse.
Database	Представляет базу данных.
DatabaseEdition	Выпуск базы данных. Перечисление DatabaseEditions содержит все допустимые выпуски. Если параметр createMode имеет значение NonReadableSecondary или OnlineSecondary, это значение игнорируется. Список номеров SKU может отличаться в зависимости от региона и предложения поддержки. Чтобы определить номера SKU (включая имя SKU, уровень или выпуск, семейство и емкость), доступные для вашей подписки в регионе Azure, используйте `Capabilities_ListByLocation` REST API или одну из следующих команд: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
DatabaseUpdate	Обязательные параметры для обновления базы данных.
OperationImpact	Предполагаемое влияние выполнения рекомендуемого действия индекса.
ReadScale	Условного. Если база данных является георепликой, readScale указывает, разрешены ли подключения только для чтения к этой базе данных. Не поддерживается для выпуска DataWarehouse.
RecommendedIndex	Рекомендуемые индексы для этой базы данных.
RecommendedIndexAction	Предлагаемое действие индекса. Вы можете создать отсутствующий индекс, удалить неиспользуемый индекс или перестроить существующий индекс, чтобы повысить его производительность.
RecommendedIndexState	Текущее состояние рекомендации.
RecommendedIndexType	Тип индекса (CLUSTERED, NONCLUSTERED, COLUMNSTORE, CLUSTERED COLUMNSTORE)
SampleName	Указывает имя примера схемы, применяемой при создании этой базы данных. Если параметр createMode не имеет значение Default, это значение игнорируется. Не поддерживается для выпуска DataWarehouse.
ServiceObjectiveName	Имя настроенной цели уровня обслуживания базы данных. Это цель уровня обслуживания, которая находится в процессе применения к базе данных. После успешного обновления он будет соответствовать значению свойства serviceLevelObjective. Список номеров SKU может отличаться в зависимости от региона и предложения поддержки. Чтобы определить номера SKU (включая имя SKU, уровень или выпуск, семейство и емкость), доступные для вашей подписки в регионе Azure, используйте `Capabilities_ListByLocation` REST API или одну из следующих команд: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
ServiceTierAdvisor	Список помощников по уровню служб для этой базы данных. Развернутое свойство
SloUsageMetric	Возвращает или задает serviceLevelObjectiveUsageMetrics для помощника по уровню служб.
TransparentDataEncryption	Сведения о прозрачном шифровании данных для этой базы данных.
TransparentDataEncryptionStatus	Состояние прозрачного шифрования данных базы данных.

CreateMode

Указывает режим создания базы данных.

По умолчанию: регулярное создание базы данных.

Копировать: создает базу данных как копию существующей базы данных. sourceDatabaseId должен быть указан в качестве идентификатора ресурса базы данных-источника.

OnlineSecondary/NonReadableSecondary: создает базу данных в качестве (доступной для чтения или нечитаемой) вторичной реплика существующей базы данных. SourceDatabaseId должен быть указан в качестве идентификатора ресурса существующей базы данных-источника.

PointInTimeRestore. Создает базу данных путем восстановления резервной копии существующей базы данных на определенный момент времени. sourceDatabaseId необходимо указать в качестве идентификатора ресурса существующей базы данных, а также параметр restorePointInTime.

Восстановление. Создает базу данных путем восстановления геореплицированной резервной копии. sourceDatabaseId должен быть указан в качестве идентификатора ресурса восстанавливаемой базы данных для восстановления.

Восстановление. Создает базу данных путем восстановления резервной копии удаленной базы данных. Необходимо указать sourceDatabaseId. Если sourceDatabaseId является исходным идентификатором ресурса базы данных, необходимо указать sourceDatabaseDeletionDate. В противном случае sourceDatabaseId должен быть восстанавливаемым идентификатором удаленного ресурса базы данных, а sourceDatabaseDeletionDate игнорируется. Параметр restorePointInTime также может быть указан для восстановления с более ранней точки во времени.

RestoreLongTermRetentionBackup: создает базу данных путем восстановления из хранилища долгосрочного хранения. recoveryServicesRecoveryPointResourceId должен быть указан в качестве идентификатора ресурса точки восстановления.

Copy, NonReadableSecondary, OnlineSecondary и RestoreLongTermRetentionBackup не поддерживаются для выпуска DataWarehouse.

Имя	Тип	Описание
Copy	string
Default	string
NonReadableSecondary	string
OnlineSecondary	string
PointInTimeRestore	string
Recovery	string
Restore	string
RestoreLongTermRetentionBackup	string

Database

Представляет базу данных.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
kind	string	Тип базы данных. Это метаданные, используемые для портал Azure взаимодействия.
location	string	Расположение ресурса.
name	string	Имя ресурса.
properties.collation	string	Параметры сортировки базы данных. Если параметр createMode не имеет значение Default, это значение игнорируется.
properties.containmentState	integer	Состояние автономности базы данных.
properties.createMode	CreateMode	Указывает режим создания базы данных. По умолчанию: регулярное создание базы данных. Копировать: создает базу данных как копию существующей базы данных. sourceDatabaseId должен быть указан в качестве идентификатора ресурса базы данных-источника. OnlineSecondary/NonReadableSecondary: создает базу данных в качестве (доступной для чтения или нечитаемой) вторичной реплика существующей базы данных. SourceDatabaseId должен быть указан в качестве идентификатора ресурса существующей базы данных-источника. PointInTimeRestore. Создает базу данных путем восстановления резервной копии существующей базы данных на определенный момент времени. sourceDatabaseId необходимо указать в качестве идентификатора ресурса существующей базы данных, а также параметр restorePointInTime. Восстановление. Создает базу данных путем восстановления геореплицированной резервной копии. sourceDatabaseId должен быть указан в качестве идентификатора ресурса восстанавливаемой базы данных для восстановления. Восстановление. Создает базу данных путем восстановления резервной копии удаленной базы данных. Необходимо указать sourceDatabaseId. Если sourceDatabaseId является исходным идентификатором ресурса базы данных, необходимо указать sourceDatabaseDeletionDate. В противном случае sourceDatabaseId должен быть восстанавливаемым идентификатором удаленного ресурса базы данных, а sourceDatabaseDeletionDate игнорируется. Параметр restorePointInTime также может быть указан для восстановления с более ранней точки во времени. RestoreLongTermRetentionBackup: создает базу данных путем восстановления из хранилища долгосрочного хранения. recoveryServicesRecoveryPointResourceId должен быть указан в качестве идентификатора ресурса точки восстановления. Copy, NonReadableSecondary, OnlineSecondary и RestoreLongTermRetentionBackup не поддерживаются для выпуска DataWarehouse.
properties.creationDate	string	Дата создания базы данных (ISO8601 формате).
properties.currentServiceObjectiveId	string	Текущий целевой идентификатор уровня обслуживания базы данных. Это идентификатор текущей активной цели уровня обслуживания.
properties.databaseId	string	Идентификатор базы данных.
properties.defaultSecondaryLocation	string	Регион-получатель по умолчанию для этой базы данных.
properties.earliestRestoreDate	string	В ней записываются самые ранние дата и время начала восстановления для этой базы данных (ISO8601 формате).
properties.edition	DatabaseEdition	Выпуск базы данных. Перечисление DatabaseEditions содержит все допустимые выпуски. Если параметр createMode имеет значение NonReadableSecondary или OnlineSecondary, это значение игнорируется. Список номеров SKU может отличаться в зависимости от региона и предложения поддержки. Чтобы определить номера SKU (включая имя SKU, уровень или выпуск, семейство и емкость), доступные для вашей подписки в регионе Azure, используйте `Capabilities_ListByLocation` REST API или одну из следующих команд: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
properties.elasticPoolName	string	Имя эластичного пула, в который входит база данных. Если elasticPoolName и requestedServiceObjectiveName обновлены, значение requestedServiceObjectiveName игнорируется. Не поддерживается для выпуска DataWarehouse.
properties.failoverGroupId	string	Идентификатор ресурса группы отработки отказа, содержащей эту базу данных.
properties.maxSizeBytes	string	Максимальный размер базы данных, выраженный в байтах. Если параметр createMode не имеет значение Default, это значение игнорируется. Чтобы просмотреть возможные значения, запросите API возможностей (/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationID}/capabilities), на который ссылается operationId: "Capabilities_ListByLocation".
properties.readScale	ReadScale	Условного. Если база данных является георепликой-получателем, readScale указывает, разрешены ли к ней подключения только для чтения. Не поддерживается для выпуска DataWarehouse.
properties.recommendedIndex	RecommendedIndex[]	Рекомендуемые индексы для этой базы данных.
properties.recoveryServicesRecoveryPointResourceId	string	Условного. Если параметр createMode имеет значение RestoreLongTermRetentionBackup, это значение является обязательным. Указывает идентификатор ресурса точки восстановления для восстановления.
properties.requestedServiceObjectiveId	string	Настроенный целевой идентификатор уровня обслуживания базы данных. Это цель уровня обслуживания, которая находится в процессе применения к базе данных. После успешного обновления он будет соответствовать значению свойства currentServiceObjectiveId. Если значения requestedServiceObjectiveId и requestedServiceObjectiveName обновлены, значение requestedServiceObjectiveId переопределяет значение requestedServiceObjectiveName. Список номеров SKU может отличаться в зависимости от региона и предложения поддержки. Чтобы определить идентификаторы цели службы, доступные для подписки в регионе `Capabilities_ListByLocation` Azure, используйте REST API.
properties.requestedServiceObjectiveName	ServiceObjectiveName	Имя настроенной цели уровня обслуживания базы данных. Это цель уровня обслуживания, которая находится в процессе применения к базе данных. После успешного обновления он будет соответствовать значению свойства serviceLevelObjective. Список номеров SKU может отличаться в зависимости от региона и предложения поддержки. Чтобы определить номера SKU (включая имя SKU, уровень или выпуск, семейство и емкость), доступные вашей подписке в регионе Azure, используйте `Capabilities_ListByLocation` REST API или одну из следующих команд: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
properties.restorePointInTime	string	Условного. Если параметр createMode имеет значение PointInTimeRestore, это значение является обязательным. Если параметр createMode имеет значение Restore, это значение является необязательным. Указывает точку во времени (ISO8601 формате) базы данных-источника, которая будет восстановлена для создания новой базы данных. Значение должно быть больше или равно значению параметра раннийrestoreDate базы данных-источника.
properties.sampleName	SampleName	Указывает имя примера схемы, применяемой при создании этой базы данных. Если параметр createMode не имеет значение Default, это значение игнорируется. Не поддерживается для выпуска DataWarehouse.
properties.serviceLevelObjective	ServiceObjectiveName	Текущая цель уровня обслуживания базы данных.
properties.serviceTierAdvisors	ServiceTierAdvisor[]	Список помощников по уровню служб для этой базы данных. Расширенное свойство
properties.sourceDatabaseDeletionDate	string	Условного. Если параметр createMode имеет значение Restore, а sourceDatabaseId — исходный идентификатор ресурса удаленной базы данных при ее существовании (в отличие от текущего восстанавливаемого идентификатора удаленной базы данных), то это значение является обязательным. Указывает время удаления базы данных.
properties.sourceDatabaseId	string	Условного. Если параметр createMode имеет значение Copy, NonReadableSecondary, OnlineSecondary, PointInTimeRestore, Recovery или Restore, то это значение является обязательным. Указывает идентификатор ресурса базы данных-источника. Если параметр createMode имеет значение NonReadableSecondary или OnlineSecondary, имя базы данных-источника должно совпадать с именем создаваемой базы данных.
properties.status	string	Состояние базы данных.
properties.transparentDataEncryption	TransparentDataEncryption[]	Сведения о прозрачном шифровании данных для этой базы данных.
properties.zoneRedundant	boolean	Является ли база данных избыточной между зонами, что означает, что реплики этой базы данных будут распределены по нескольким зонам доступности.
tags	object	Теги ресурсов.
type	string	Тип ресурса.

DatabaseEdition

Выпуск базы данных. Перечисление DatabaseEditions содержит все допустимые выпуски. Если параметр createMode имеет значение NonReadableSecondary или OnlineSecondary, это значение игнорируется.

Список номеров SKU может отличаться в зависимости от региона и предложения поддержки. Чтобы определить номера SKU (включая имя SKU, уровень или выпуск, семейство и емкость), доступные для вашей подписки в регионе Azure, используйте Capabilities_ListByLocation REST API или одну из следующих команд:

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

Get-AzSqlServerServiceObjective -Location <location>

Имя	Тип	Описание
Basic	string
Business	string
BusinessCritical	string
DataWarehouse	string
Free	string
GeneralPurpose	string
Hyperscale	string
Premium	string
PremiumRS	string
Standard	string
Stretch	string
System	string
System2	string
Web	string

DatabaseUpdate

Обязательные параметры для обновления базы данных.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.collation	string	Параметры сортировки базы данных. Если параметр createMode не имеет значение Default, это значение игнорируется.
properties.containmentState	integer	Состояние автономности базы данных.
properties.createMode	CreateMode	Указывает режим создания базы данных. По умолчанию: регулярное создание базы данных. Копировать: создает базу данных как копию существующей базы данных. sourceDatabaseId необходимо указать в качестве идентификатора ресурса базы данных-источника. OnlineSecondary/NonReadableSecondary: создает базу данных в качестве (доступной для чтения или нечитаемой) вторичной реплика существующей базы данных. SourceDatabaseId необходимо указать в качестве идентификатора ресурса существующей базы данных-источника. PointInTimeRestore. Создает базу данных путем восстановления резервной копии существующей базы данных на определенный момент времени. SourceDatabaseId необходимо указать в качестве идентификатора ресурса существующей базы данных, а также параметр restorePointInTime. Восстановление. Создает базу данных путем восстановления геореплицированной резервной копии. SourceDatabaseId необходимо указать в качестве идентификатора ресурса восстанавливаемой базы данных для восстановления. Восстановление. Создает базу данных путем восстановления резервной копии удаленной базы данных. Необходимо указать sourceDatabaseId. Если sourceDatabaseId является исходным идентификатором ресурса базы данных, необходимо указать sourceDatabaseDeletionDate. В противном случае sourceDatabaseId должен быть восстанавливаемым идентификатором удаленного ресурса базы данных, а sourceDatabaseDeletionDate игнорируется. Также можно указать restorePointInTime для восстановления с более ранней точки во времени. RestoreLongTermRetentionBackup: создает базу данных путем восстановления из хранилища долгосрочного хранения. recoveryServicesRecoveryPointResourceId должен быть указан в качестве идентификатора ресурса точки восстановления. Copy, NonReadableSecondary, OnlineSecondary и RestoreLongTermRetentionBackup не поддерживаются для выпуска DataWarehouse.
properties.creationDate	string	Дата создания базы данных (ISO8601 формате).
properties.currentServiceObjectiveId	string	Текущий целевой идентификатор уровня обслуживания базы данных. Это идентификатор текущей активной цели уровня обслуживания.
properties.databaseId	string	Идентификатор базы данных.
properties.defaultSecondaryLocation	string	Регион-получатель по умолчанию для этой базы данных.
properties.earliestRestoreDate	string	В ней записываются самые ранние дата и время начала восстановления для этой базы данных (ISO8601 формате).
properties.edition	DatabaseEdition	Выпуск базы данных. Перечисление DatabaseEditions содержит все допустимые выпуски. Если параметр createMode имеет значение NonReadableSecondary или OnlineSecondary, это значение игнорируется. Список номеров SKU может отличаться в зависимости от региона и предложения поддержки. Чтобы определить номера SKU (включая имя SKU, уровень или выпуск, семейство и емкость), доступные вашей подписке в регионе Azure, используйте `Capabilities_ListByLocation` REST API или одну из следующих команд: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
properties.elasticPoolName	string	Имя эластичного пула, в который входит база данных. Если elasticPoolName и requestedServiceObjectiveName обновлены, значение requestedServiceObjectiveName игнорируется. Не поддерживается для выпуска DataWarehouse.
properties.failoverGroupId	string	Идентификатор ресурса группы отработки отказа, содержащей эту базу данных.
properties.maxSizeBytes	string	Максимальный размер базы данных, выраженный в байтах. Если параметр createMode не имеет значение Default, это значение игнорируется. Чтобы просмотреть возможные значения, запросите API возможностей (/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationID}/capabilities), на который ссылается operationId: "Capabilities_ListByLocation".
properties.readScale	ReadScale	Условного. Если база данных является георепликой, readScale указывает, разрешены ли подключения только для чтения к этой базе данных. Не поддерживается для выпуска DataWarehouse.
properties.recommendedIndex	RecommendedIndex[]	Рекомендуемые индексы для этой базы данных.
properties.recoveryServicesRecoveryPointResourceId	string	Условного. Если параметр createMode имеет значение RestoreLongTermRetentionBackup, это значение является обязательным. Указывает идентификатор ресурса точки восстановления для восстановления.
properties.requestedServiceObjectiveId	string	Настроенный целевой идентификатор уровня обслуживания базы данных. Это цель уровня обслуживания, которая находится в процессе применения к базе данных. После успешного обновления он будет соответствовать значению свойства currentServiceObjectiveId. Если значения requestedServiceObjectiveId и requestedServiceObjectiveName обновлены, значение requestedServiceObjectiveId переопределяет значение requestedServiceObjectiveName. Список номеров SKU может отличаться в зависимости от региона и предложения поддержки. Чтобы определить идентификаторы цели службы, доступные для подписки в регионе `Capabilities_ListByLocation` Azure, используйте REST API.
properties.requestedServiceObjectiveName	ServiceObjectiveName	Имя настроенной цели уровня обслуживания базы данных. Это цель уровня обслуживания, которая находится в процессе применения к базе данных. После успешного обновления он будет соответствовать значению свойства serviceLevelObjective. Список номеров SKU может отличаться в зависимости от региона и предложения поддержки. Чтобы определить номера SKU (включая имя SKU, уровень или выпуск, семейство и емкость), доступные вашей подписке в регионе Azure, используйте `Capabilities_ListByLocation` REST API или одну из следующих команд: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
properties.restorePointInTime	string	Условного. Если параметр createMode имеет значение PointInTimeRestore, это значение является обязательным. Если параметр createMode имеет значение Restore, это значение является необязательным. Указывает точку во времени (ISO8601 формат) базы данных-источника, которая будет восстановлена для создания новой базы данных. Значение должно быть больше или равно значению аргумента earliestRestoreDate базы данных-источника.
properties.sampleName	SampleName	Указывает имя примера схемы, применяемой при создании этой базы данных. Если параметр createMode не имеет значение Default, это значение игнорируется. Не поддерживается для выпуска DataWarehouse.
properties.serviceLevelObjective	ServiceObjectiveName	Текущая цель уровня обслуживания базы данных.
properties.serviceTierAdvisors	ServiceTierAdvisor[]	Список помощников по уровню служб для этой базы данных. Развернутое свойство
properties.sourceDatabaseDeletionDate	string	Условного. Если параметр createMode имеет значение Restore, а sourceDatabaseId — исходный идентификатор ресурса удаленной базы данных при ее существовании (в отличие от текущего восстанавливаемого идентификатора базы данных), то это значение является обязательным. Указывает время удаления базы данных.
properties.sourceDatabaseId	string	Условного. Если параметр createMode имеет значение Copy, NonReadableSecondary, OnlineSecondary, PointInTimeRestore, Recovery или Restore, то это значение является обязательным. Указывает идентификатор ресурса базы данных-источника. Если параметр createMode имеет значение NonReadableSecondary или OnlineSecondary, имя базы данных-источника должно совпадать с именем создаваемой базы данных.
properties.status	string	Состояние базы данных.
properties.transparentDataEncryption	TransparentDataEncryption[]	Сведения о прозрачном шифровании данных для этой базы данных.
properties.zoneRedundant	boolean	Является ли эта база данных избыточной между зонами. Это означает, что реплики этой базы данных будут распределены между несколькими зонами доступности.
tags	object	Теги ресурсов.
type	string	Тип ресурса.

OperationImpact

Предполагаемое влияние выполнения рекомендуемого действия индекса.

Имя	Тип	Описание
changeValueAbsolute	number	Абсолютное влияние на измерение.
changeValueRelative	number	Относительное влияние на измерение (null, если не применимо)
name	string	Имя измерения влияния.
unit	string	Единица измерения, в которой измеряется предполагаемое влияние на измерение.

ReadScale

Условного. Если база данных является георепликой, readScale указывает, разрешены ли подключения только для чтения к этой базе данных. Не поддерживается для выпуска DataWarehouse.

Имя	Тип	Описание
Disabled	string
Enabled	string

RecommendedIndex

Рекомендуемые индексы для этой базы данных.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.action	RecommendedIndexAction	Предлагаемое действие индекса. Вы можете создать отсутствующий индекс, удалить неиспользуемый индекс или перестроить существующий индекс, чтобы повысить его производительность.
properties.columns	string[]	Столбцы, на основе которых создается индекс
properties.created	string	Дата и время создания ресурса в формате UTC (формат ISO8601).
properties.estimatedImpact	OperationImpact[]	Предполагаемое влияние выполнения рекомендуемого действия индекса.
properties.includedColumns	string[]	Список имен столбцов для включения в индекс
properties.indexScript	string	Полный скрипт индекса сборки
properties.indexType	RecommendedIndexType	Тип индекса (CLUSTERED, NONCLUSTERED, COLUMNSTORE, CLUSTERED COLUMNSTORE)
properties.lastModified	string	Дата и время последнего изменения этого ресурса в формате UTC (ISO8601 формате).
properties.reportedImpact	OperationImpact[]	Значения, сообщаемые после завершения действия индекса.
properties.schema	string	Схема, в которой находится таблица для построения индекса
properties.state	RecommendedIndexState	Текущее состояние рекомендации.
properties.table	string	Таблица, на основе которой создается индекс.
type	string	Тип ресурса.

RecommendedIndexAction

Предлагаемое действие индекса. Вы можете создать отсутствующий индекс, удалить неиспользуемый индекс или перестроить существующий индекс, чтобы повысить его производительность.

Имя	Тип	Описание
Create	string
Drop	string
Rebuild	string

RecommendedIndexState

Текущее состояние рекомендации.

Имя	Тип	Описание
Active	string
Blocked	string
Executing	string
Expired	string
Ignored	string
Pending	string
Pending Revert	string
Reverted	string
Reverting	string
Success	string
Verifying	string

RecommendedIndexType

Тип индекса (CLUSTERED, NONCLUSTERED, COLUMNSTORE, CLUSTERED COLUMNSTORE)

Имя	Тип	Описание
CLUSTERED	string
CLUSTERED COLUMNSTORE	string
COLUMNSTORE	string
NONCLUSTERED	string

SampleName

Указывает имя примера схемы, применяемой при создании этой базы данных. Если параметр createMode не имеет значение Default, это значение игнорируется. Не поддерживается для выпуска DataWarehouse.

Имя	Тип	Описание
AdventureWorksLT	string

ServiceObjectiveName

Имя настроенной цели уровня обслуживания базы данных. Это цель уровня обслуживания, которая находится в процессе применения к базе данных. После успешного обновления он будет соответствовать значению свойства serviceLevelObjective.

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

Get-AzSqlServerServiceObjective -Location <location>

Имя	Тип	Описание
Basic	string
DS100	string
DS1000	string
DS1200	string
DS1500	string
DS200	string
DS2000	string
DS300	string
DS400	string
DS500	string
DS600	string
DW100	string
DW1000	string
DW10000c	string
DW1000c	string
DW1200	string
DW1500	string
DW15000c	string
DW1500c	string
DW200	string
DW2000	string
DW2000c	string
DW2500c	string
DW300	string
DW3000	string
DW30000c	string
DW3000c	string
DW400	string
DW500	string
DW5000c	string
DW600	string
DW6000	string
DW6000c	string
DW7500c	string
ElasticPool	string
Free	string
P1	string
P11	string
P15	string
P2	string
P3	string
P4	string
P6	string
PRS1	string
PRS2	string
PRS4	string
PRS6	string
S0	string
S1	string
S12	string
S2	string
S3	string
S4	string
S6	string
S7	string
S9	string
System	string
System0	string
System1	string
System2	string
System2L	string
System3	string
System3L	string
System4	string
System4L	string

ServiceTierAdvisor

Список помощников по уровню служб для этой базы данных. Развернутое свойство

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.activeTimeRatio	number	ActiveTimeRatio для помощника по уровню служб.
properties.avgDtu	number	Возвращает или задает avgDtu для помощника по уровню служб.
properties.confidence	number	Возвращает или задает достоверность для помощника по уровню служб.
properties.currentServiceLevelObjective	string	Возвращает или задает currentServiceLevelObjective для помощника по уровню служб.
properties.currentServiceLevelObjectiveId	string	Возвращает или задает currentServiceLevelObjectiveId для помощника по уровню служб.
properties.databaseSizeBasedRecommendationServiceLevelObjective	string	Возвращает или задает databaseSizeBasedRecommendationServiceLevelObjective для помощника уровня служб.
properties.databaseSizeBasedRecommendationServiceLevelObjectiveId	string	Возвращает или задает databaseSizeBasedRecommendationServiceLevelObjectiveId для помощника уровня служб.
properties.disasterPlanBasedRecommendationServiceLevelObjective	string	Возвращает или задает значение disasterPlanBasedRecommendationServiceLevelObjective для помощника уровня служб.
properties.disasterPlanBasedRecommendationServiceLevelObjectiveId	string	Возвращает или задает значение disasterPlanBasedRecommendationServiceLevelObjectiveId для помощника по уровню служб.
properties.maxDtu	number	Возвращает или задает maxDtu для помощника по уровню служб.
properties.maxSizeInGB	number	Возвращает или задает maxSizeInGB для помощника по уровню служб.
properties.minDtu	number	Возвращает или задает minDtu для помощника по уровню служб.
properties.observationPeriodEnd	string	Начало периода наблюдения (ISO8601 формате).
properties.observationPeriodStart	string	Начало периода наблюдения (ISO8601 формате).
properties.overallRecommendationServiceLevelObjective	string	Возвращает или задает значение overallRecommendationServiceLevelObjective для помощника уровня служб.
properties.overallRecommendationServiceLevelObjectiveId	string	Возвращает или задает значение overallRecommendationServiceLevelObjectiveId для помощника по уровню служб.
properties.serviceLevelObjectiveUsageMetrics	SloUsageMetric[]	Возвращает или задает serviceLevelObjectiveUsageMetrics для помощника по уровню служб.
properties.usageBasedRecommendationServiceLevelObjective	string	Возвращает или задает usageBasedRecommendationServiceLevelObjective для помощника по уровню служб.
properties.usageBasedRecommendationServiceLevelObjectiveId	string	Возвращает или задает usageBasedRecommendationServiceLevelObjectiveId для помощника по уровню служб.
type	string	Тип ресурса.

SloUsageMetric

Возвращает или задает serviceLevelObjectiveUsageMetrics для помощника по уровню служб.

Имя	Тип	Описание
inRangeTimeRatio	number	Возвращает или задает inRangeTimeRatio для метрики использования SLO.
serviceLevelObjective	ServiceObjectiveName	Метрика использования serviceLevelObjective для SLO.
serviceLevelObjectiveId	string	Метрика serviceLevelObjectiveId для использования SLO.

TransparentDataEncryption

Сведения о прозрачном шифровании данных для этой базы данных.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
location	string	Расположение ресурса.
name	string	Имя ресурса.
properties.status	TransparentDataEncryptionStatus	Состояние прозрачного шифрования данных базы данных.
type	string	Тип ресурса.

TransparentDataEncryptionStatus

Состояние прозрачного шифрования данных базы данных.

Имя	Тип	Описание
Disabled	string
Enabled	string

Поделиться через

Databases - Update

Параметры URI

Текст запроса

Ответы

Примеры

Update a database max

Образец запроса

Пример ответа

Update a database min

Образец запроса

Пример ответа

Определения

CreateMode

Database

DatabaseEdition

DatabaseUpdate

OperationImpact

ReadScale

RecommendedIndex

RecommendedIndexAction

RecommendedIndexState

RecommendedIndexType

SampleName

ServiceObjectiveName

ServiceTierAdvisor

SloUsageMetric

TransparentDataEncryption

TransparentDataEncryptionStatus

Дополнительные ресурсы