Ler em inglês

Compartilhar via

Microsoft.Sql servers/databases 2024-05-01-preview

  • Artigo
Escolher um idioma de implantação

Definição de recurso do Bicep

O tipo de recurso servidores/bancos de dados pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Sql/servers/databases, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.Sql/servers/databases@2024-05-01-preview' = {
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    autoPauseDelay: int
    availabilityZone: 'string'
    catalogCollation: 'string'
    collation: 'string'
    createMode: 'string'
    elasticPoolId: 'string'
    encryptionProtector: 'string'
    encryptionProtectorAutoRotation: bool
    federatedClientId: 'string'
    freeLimitExhaustionBehavior: 'string'
    highAvailabilityReplicaCount: int
    isLedgerOn: bool
    keys: {
      {customized property}: {}
    }
    licenseType: 'string'
    longTermRetentionBackupResourceId: 'string'
    maintenanceConfigurationId: 'string'
    manualCutover: bool
    maxSizeBytes: int
    minCapacity: int
    performCutover: bool
    preferredEnclaveType: 'string'
    readScale: 'string'
    recoverableDatabaseId: 'string'
    recoveryServicesRecoveryPointId: 'string'
    requestedBackupStorageRedundancy: 'string'
    restorableDroppedDatabaseId: 'string'
    restorePointInTime: 'string'
    sampleName: 'string'
    secondaryType: 'string'
    sourceDatabaseDeletionDate: 'string'
    sourceDatabaseId: 'string'
    sourceResourceId: 'string'
    useFreeLimit: bool
    zoneRedundant: bool
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

DatabaseIdentity

Nome Descrição Valor
tipo O tipo de identidade 'None'
'UserAssigned'
userAssignedIdentities As IDs de recurso das identidades atribuídas pelo usuário a serem usadas DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Nome Descrição Valor

DatabaseKey

Nome Descrição Valor

DatabaseProperties

Nome Descrição Valor
autoPauseDelay Tempo em minutos após o qual o banco de dados é pausado automaticamente. Um valor de -1 significa que a pausa automática está desabilitada int
availabilityZone Especifica a zona de disponibilidade à qual o banco de dados está fixado. '1'
'2'
'3'
'NoPreference'
catalogCollation Ordenação do catálogo de metadados. 'DATABASE_DEFAULT'
'SQL_Latin1_General_CP1_CI_AS'
Agrupamento A ordenação do banco de dados. corda
createMode Especifica o modo de criação de banco de dados.

Padrão: criação regular de banco de dados.

Cópia: cria um banco de dados como uma cópia de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados de origem.

Secundário: cria um banco de dados como uma réplica secundária de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados primário existente.

PointInTimeRestore: cria um banco de dados restaurando um backup pontual de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados existente e restorePointInTime deve ser especificado.

Recuperação: cria um banco de dados restaurando um backup replicado geograficamente. sourceDatabaseId deve ser especificado como a ID do recurso de banco de dados recuperável para restaurar.

Restauração: cria um banco de dados restaurando um backup de um banco de dados excluído. sourceDatabaseId deve ser especificado. Se sourceDatabaseId for a ID de recurso original do banco de dados, sourceDatabaseDeletionDate deverá ser especificado. Caso contrário, sourceDatabaseId deve ser a ID do recurso de banco de dados descartado restaurável e sourceDatabaseDeletionDate será ignorado. restorePointInTime também pode ser especificado para restaurar de um ponto anterior no tempo.

RestoreLongTermRetentionBackup: cria um banco de dados restaurando de um cofre de retenção de longo prazo. recoveryServicesRecoveryPointResourceId deve ser especificado como a ID do recurso do ponto de recuperação.

Não há suporte para Cópia, Secundária e RestoreLongTermRetentionBackup para a edição DataWarehouse.		 'Copiar'
'Padrão'
'OnlineSecondary'
'PointInTimeRestore'
'Recuperação'
'Restaurar'
'RestoreExternalBackup'
'RestoreExternalBackupSecondary'
'RestoreLongTermRetentionBackup'
'Secundário'
elasticPoolId O identificador de recurso do pool elástico que contém esse banco de dados. corda
encryptionProtector O URI do cofre de chaves do azure do banco de dados se ele estiver configurado por Chaves Gerenciadas pelo Cliente de Banco de Dados. corda
encryptionProtectorAutoRotation O sinalizador para habilitar ou desabilitar a rotação automática da chave AKV do protetor de criptografia de banco de dados. Bool
federatedClientId A ID do cliente usada para o cenário de CMK entre locatários por banco de dados corda

Restrições:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
freeLimitExhaustionBehavior Especifica o comportamento quando os limites gratuitos mensais são esgotados para o banco de dados gratuito.

AutoPause: o banco de dados será pausado automaticamente após o esgotamento dos limites gratuitos para o restante do mês.

BillForUsage: O banco de dados continuará online após o esgotamento dos limites gratuitos e qualquer excedente será cobrado.		 'AutoPause'
'BillOverUsage'
highAvailabilityReplicaCount O número de réplicas secundárias associadas ao banco de dados Business Critical, Premium ou Hyperscale Edition que são usadas para fornecer alta disponibilidade. Não aplicável a um banco de dados de Hiperescala em um pool elástico. int
isLedgerOn Se esse banco de dados é ou não um banco de dados do razão, o que significa que todas as tabelas no banco de dados são tabelas do razão. Observação: o valor dessa propriedade não pode ser alterado após a criação do banco de dados. Bool
Chaves As IDs de recurso das identidades atribuídas pelo usuário a serem usadas DatabasePropertiesKeys
licenseType O tipo de licença a ser aplicado a esse banco de dados. LicenseIncluded se você precisar de uma licença ou BasePrice se tiver uma licença e estiver qualificado para o Benefício Híbrido do Azure. 'BasePrice'
'LicenseIncluded'
longTermRetentionBackupResourceId O identificador de recurso do backup de retenção de longo prazo associado à operação de criação desse banco de dados. corda
maintenanceConfigurationId ID de configuração de manutenção atribuída ao banco de dados. Essa configuração define o período em que as atualizações de manutenção ocorrerão. corda
manualCutover Se a substituição manual controlada pelo cliente precisa ou não ser feita durante a operação Atualizar Banco de Dados para a camada de Hiperescala.

Essa propriedade só é aplicável ao dimensionar o banco de dados da camada Business Critical/General Purpose/Premium/Standard para a camada de Hiperescala.

Quando manualCutover for especificado, a operação de dimensionamento aguardará a entrada do usuário para disparar a substituição para o banco de dados da Hiperescala.

Para disparar a substituição, forneça o parâmetro 'performCutover' quando a operação De dimensionamento estiver em estado de espera.		 Bool
maxSizeBytes O tamanho máximo do banco de dados expresso em bytes. int
minCapacity Capacidade mínima que o banco de dados sempre alocará, se não estiver em pausa int
performCutover Para disparar a substituição manual controlada pelo cliente durante o estado de espera enquanto a operação de dimensionamento está em andamento.

Esse parâmetro de propriedade só é aplicável para operações de dimensionamento iniciadas junto com o parâmetro 'manualCutover'.

Essa propriedade só é aplicável quando o dimensionamento do banco de dados da camada Business Critical/General Purpose/Premium/Standard para a camada de Hiperescala já está em andamento.

Quando performCutover for especificado, a operação de dimensionamento disparará a substituição e executará a alteração de função no banco de dados da Hiperescala.		 Bool
preferredEnclaveType Tipo de enclave solicitado no banco de dados, ou seja, enclaves padrão ou VBS. 'Padrão'
'VBS'
readScale O estado do roteamento somente leitura. Se habilitada, as conexões que têm a intenção do aplicativo definida como readonly na cadeia de conexão podem ser roteadas para uma réplica secundária somente leitura na mesma região. Não aplicável a um banco de dados de Hiperescala em um pool elástico. 'Desabilitado'
'Habilitado'
recoverableDatabaseId O identificador de recurso do banco de dados recuperável associado à operação de criação desse banco de dados. corda
recoveryServicesRecoveryPointId O identificador de recurso do ponto de recuperação associado à operação de criação desse banco de dados. corda
requestedBackupStorageRedundancy O tipo de conta de armazenamento a ser usado para armazenar backups para esse banco de dados. 'Geo'
'GeoZone'
'Local'
'Zone'
restorableDroppedDatabaseId O identificador de recurso do banco de dados restaurador descartado associado à operação de criação desse banco de dados. corda
restorePointInTime Especifica o ponto no tempo (formato ISO8601) do banco de dados de origem que será restaurado para criar o novo banco de dados. corda
sampleName O nome do esquema de exemplo a ser aplicado ao criar esse banco de dados. 'AdventureWorksLT'
'WideWorldImportersFull'
'WideWorldImportersStd'
secondaryType O tipo secundário do banco de dados se ele for secundário. Os valores válidos são Geo, Named e Standby. 'Geo'
'Nomeado'
'Standby'
sourceDatabaseDeletionDate Especifica a hora em que o banco de dados foi excluído. corda
sourceDatabaseId O identificador de recurso do banco de dados de origem associado à operação de criação deste banco de dados. corda
sourceResourceId O identificador de recurso da origem associada à operação de criação deste banco de dados.

Essa propriedade só tem suporte para a edição DataWarehouse e permite restaurar entre assinaturas.

Quando sourceResourceId é especificado, sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId e sourceDatabaseDeletionDate não devem ser especificados e CreateMode deve ser PointInTimeRestore, Restore ou Recover.

Quando createMode for PointInTimeRestore, sourceResourceId deve ser a ID do recurso do banco de dados existente ou do pool de sql existente, e restorePointInTime deve ser especificado.

Quando createMode é Restore, sourceResourceId deve ser a ID do recurso do banco de dados descartado restaurável ou do pool de sql descartado restaurável.

Quando createMode for Recover, sourceResourceId deverá ser a ID do recurso do banco de dados recuperável ou do pool de sql recuperável.

Quando a assinatura de origem pertence a um locatário diferente da assinatura de destino, o cabeçalho "x-ms-authorization-auxiliary" deve conter o token de autenticação para o locatário de origem. Para obter mais detalhes sobre o cabeçalho "x-ms-authorization-auxiliary", consulte /azure/azure-resource-manager/management/authenticate-multi-tenant		 corda
useFreeLimit Se o banco de dados usa ou não limites mensais gratuitos. Permitido em um banco de dados em uma assinatura. Bool
zoneRedundant Se esse banco de dados é ou não redundante por zona, o que significa que as réplicas desse banco de dados serão distribuídas entre várias zonas de disponibilidade. Bool

DatabasePropertiesKeys

Nome Descrição Valor

DatabaseUserIdentity

Nome Descrição Valor

Microsoft.Sql/servers/databases

Nome Descrição Valor
identidade A identidade do Azure Active Directory do banco de dados. DatabaseIdentity
localização Local do recurso. cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
pai No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte recurso filho fora do recurso pai.		 Nome simbólico para o recurso do tipo: servidores
Propriedades Propriedades do recurso. DatabaseProperties
Sku A SKU do banco de dados.

A lista de SKUs pode variar de acordo com a região e a oferta de suporte. Para determinar os SKUs (incluindo o nome da SKU, camada/edição, família e capacidade) que estão disponíveis para sua assinatura em uma região do Azure, use a API REST Capabilities_ListByLocation ou um dos seguintes comandos:

azurecli<br />az sql db list-editions -l &lt;location&gt; -o table<br />````<br /><br />powershell
Get-AzSqlServerServiceObjective -Location <local>
````		 de SKU
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos

Sku

Nome Descrição Valor
capacidade Capacidade da SKU específica. int
família Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui. corda
nome O nome da SKU, normalmente, uma letra + código de número, por exemplo, P3. cadeia de caracteres (obrigatório)
tamanho Tamanho da SKU específica corda
camada A camada ou edição da SKU específica, por exemplo, Basic, Premium. corda

TrackedResourceTags

Nome Descrição Valor

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
SQL Server do Azure com auditoria gravada no Log Analytics Esse modelo permite implantar um SQL Server do Azure com Auditoria habilitada para gravar logs de auditoria no Log Analytics (workspace do OMS)
criar um SQL Server e um banco de dados Esse modelo permite que você crie o Banco de Dados SQL e o Servidor.
pool de SQL dedicado com o Transparent Encryption Cria um SQL Server e um pool de SQL dedicado (antigo SQL DW) com Transparent Data Encryption.
implantar a Análise Esportiva no de Arquitetura do Azure Cria uma conta de armazenamento do Azure com o ADLS Gen 2 habilitado, uma instância do Azure Data Factory com serviços vinculados para a conta de armazenamento (um Banco de Dados SQL do Azure, se implantado) e uma instância do Azure Databricks. A identidade do AAD para o usuário que implanta o modelo e a identidade gerenciada para a instância do ADF receberá a função colaborador de dados de blob de armazenamento na conta de armazenamento. Também há opções para implantar uma instância do Azure Key Vault, um Banco de Dados SQL do Azure e um Hub de Eventos do Azure (para casos de uso de streaming). Quando um Azure Key Vault é implantado, a identidade gerenciada do data factory e a identidade do AAD para o usuário que implanta o modelo receberão a função de Usuário de Segredos do Key Vault.
exemplo de ponto de extremidade privado Este modelo mostra como criar um ponto de extremidade privado apontando para o SQL Server do Azure
provisionar um aplicativo Web com um banco de dados SQL Esse modelo provisiona um aplicativo Web, um Banco de Dados SQL, configurações de Dimensionamento Automático, regras de alerta e Insights do Aplicativo. Ele configura uma cadeia de conexão no aplicativo Web para o banco de dados.
Sonarqube Docker Web App no Linux com o SQL do Azure Este modelo implanta o Sonarqube em um contêiner do Linux do aplicativo Web do Serviço de Aplicativo do Azure usando a imagem oficial do Sonarqube e apoiado por um SQL Server do Azure.
Aplicativo Web com Identidade Gerenciada, SQL Server e ΑΙ Exemplo simples para implantar a infraestrutura do Azure para aplicativo + dados + identidade gerenciada + monitoramento

Definição de recurso de modelo do ARM

O tipo de recurso servidores/bancos de dados pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Sql/servers/databases, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.Sql/servers/databases",
  "apiVersion": "2024-05-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "autoPauseDelay": "int",
    "availabilityZone": "string",
    "catalogCollation": "string",
    "collation": "string",
    "createMode": "string",
    "elasticPoolId": "string",
    "encryptionProtector": "string",
    "encryptionProtectorAutoRotation": "bool",
    "federatedClientId": "string",
    "freeLimitExhaustionBehavior": "string",
    "highAvailabilityReplicaCount": "int",
    "isLedgerOn": "bool",
    "keys": {
      "{customized property}": {
      }
    },
    "licenseType": "string",
    "longTermRetentionBackupResourceId": "string",
    "maintenanceConfigurationId": "string",
    "manualCutover": "bool",
    "maxSizeBytes": "int",
    "minCapacity": "int",
    "performCutover": "bool",
    "preferredEnclaveType": "string",
    "readScale": "string",
    "recoverableDatabaseId": "string",
    "recoveryServicesRecoveryPointId": "string",
    "requestedBackupStorageRedundancy": "string",
    "restorableDroppedDatabaseId": "string",
    "restorePointInTime": "string",
    "sampleName": "string",
    "secondaryType": "string",
    "sourceDatabaseDeletionDate": "string",
    "sourceDatabaseId": "string",
    "sourceResourceId": "string",
    "useFreeLimit": "bool",
    "zoneRedundant": "bool"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

DatabaseIdentity

Nome Descrição Valor
tipo O tipo de identidade 'None'
'UserAssigned'
userAssignedIdentities As IDs de recurso das identidades atribuídas pelo usuário a serem usadas DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Nome Descrição Valor

DatabaseKey

Nome Descrição Valor

DatabaseProperties

Nome Descrição Valor
autoPauseDelay Tempo em minutos após o qual o banco de dados é pausado automaticamente. Um valor de -1 significa que a pausa automática está desabilitada int
availabilityZone Especifica a zona de disponibilidade à qual o banco de dados está fixado. '1'
'2'
'3'
'NoPreference'
catalogCollation Ordenação do catálogo de metadados. 'DATABASE_DEFAULT'
'SQL_Latin1_General_CP1_CI_AS'
Agrupamento A ordenação do banco de dados. corda
createMode Especifica o modo de criação de banco de dados.

Padrão: criação regular de banco de dados.

Cópia: cria um banco de dados como uma cópia de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados de origem.

Secundário: cria um banco de dados como uma réplica secundária de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados primário existente.

PointInTimeRestore: cria um banco de dados restaurando um backup pontual de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados existente e restorePointInTime deve ser especificado.

Recuperação: cria um banco de dados restaurando um backup replicado geograficamente. sourceDatabaseId deve ser especificado como a ID do recurso de banco de dados recuperável para restaurar.

Restauração: cria um banco de dados restaurando um backup de um banco de dados excluído. sourceDatabaseId deve ser especificado. Se sourceDatabaseId for a ID de recurso original do banco de dados, sourceDatabaseDeletionDate deverá ser especificado. Caso contrário, sourceDatabaseId deve ser a ID do recurso de banco de dados descartado restaurável e sourceDatabaseDeletionDate será ignorado. restorePointInTime também pode ser especificado para restaurar de um ponto anterior no tempo.

RestoreLongTermRetentionBackup: cria um banco de dados restaurando de um cofre de retenção de longo prazo. recoveryServicesRecoveryPointResourceId deve ser especificado como a ID do recurso do ponto de recuperação.

Não há suporte para Cópia, Secundária e RestoreLongTermRetentionBackup para a edição DataWarehouse.		 'Copiar'
'Padrão'
'OnlineSecondary'
'PointInTimeRestore'
'Recuperação'
'Restaurar'
'RestoreExternalBackup'
'RestoreExternalBackupSecondary'
'RestoreLongTermRetentionBackup'
'Secundário'
elasticPoolId O identificador de recurso do pool elástico que contém esse banco de dados. corda
encryptionProtector O URI do cofre de chaves do azure do banco de dados se ele estiver configurado por Chaves Gerenciadas pelo Cliente de Banco de Dados. corda
encryptionProtectorAutoRotation O sinalizador para habilitar ou desabilitar a rotação automática da chave AKV do protetor de criptografia de banco de dados. Bool
federatedClientId A ID do cliente usada para o cenário de CMK entre locatários por banco de dados corda

Restrições:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
freeLimitExhaustionBehavior Especifica o comportamento quando os limites gratuitos mensais são esgotados para o banco de dados gratuito.

AutoPause: o banco de dados será pausado automaticamente após o esgotamento dos limites gratuitos para o restante do mês.

BillForUsage: O banco de dados continuará online após o esgotamento dos limites gratuitos e qualquer excedente será cobrado.		 'AutoPause'
'BillOverUsage'
highAvailabilityReplicaCount O número de réplicas secundárias associadas ao banco de dados Business Critical, Premium ou Hyperscale Edition que são usadas para fornecer alta disponibilidade. Não aplicável a um banco de dados de Hiperescala em um pool elástico. int
isLedgerOn Se esse banco de dados é ou não um banco de dados do razão, o que significa que todas as tabelas no banco de dados são tabelas do razão. Observação: o valor dessa propriedade não pode ser alterado após a criação do banco de dados. Bool
Chaves As IDs de recurso das identidades atribuídas pelo usuário a serem usadas DatabasePropertiesKeys
licenseType O tipo de licença a ser aplicado a esse banco de dados. LicenseIncluded se você precisar de uma licença ou BasePrice se tiver uma licença e estiver qualificado para o Benefício Híbrido do Azure. 'BasePrice'
'LicenseIncluded'
longTermRetentionBackupResourceId O identificador de recurso do backup de retenção de longo prazo associado à operação de criação desse banco de dados. corda
maintenanceConfigurationId ID de configuração de manutenção atribuída ao banco de dados. Essa configuração define o período em que as atualizações de manutenção ocorrerão. corda
manualCutover Se a substituição manual controlada pelo cliente precisa ou não ser feita durante a operação Atualizar Banco de Dados para a camada de Hiperescala.

Essa propriedade só é aplicável ao dimensionar o banco de dados da camada Business Critical/General Purpose/Premium/Standard para a camada de Hiperescala.

Quando manualCutover for especificado, a operação de dimensionamento aguardará a entrada do usuário para disparar a substituição para o banco de dados da Hiperescala.

Para disparar a substituição, forneça o parâmetro 'performCutover' quando a operação De dimensionamento estiver em estado de espera.		 Bool
maxSizeBytes O tamanho máximo do banco de dados expresso em bytes. int
minCapacity Capacidade mínima que o banco de dados sempre alocará, se não estiver em pausa int
performCutover Para disparar a substituição manual controlada pelo cliente durante o estado de espera enquanto a operação de dimensionamento está em andamento.

Esse parâmetro de propriedade só é aplicável para operações de dimensionamento iniciadas junto com o parâmetro 'manualCutover'.

Essa propriedade só é aplicável quando o dimensionamento do banco de dados da camada Business Critical/General Purpose/Premium/Standard para a camada de Hiperescala já está em andamento.

Quando performCutover for especificado, a operação de dimensionamento disparará a substituição e executará a alteração de função no banco de dados da Hiperescala.		 Bool
preferredEnclaveType Tipo de enclave solicitado no banco de dados, ou seja, enclaves padrão ou VBS. 'Padrão'
'VBS'
readScale O estado do roteamento somente leitura. Se habilitada, as conexões que têm a intenção do aplicativo definida como readonly na cadeia de conexão podem ser roteadas para uma réplica secundária somente leitura na mesma região. Não aplicável a um banco de dados de Hiperescala em um pool elástico. 'Desabilitado'
'Habilitado'
recoverableDatabaseId O identificador de recurso do banco de dados recuperável associado à operação de criação desse banco de dados. corda
recoveryServicesRecoveryPointId O identificador de recurso do ponto de recuperação associado à operação de criação desse banco de dados. corda
requestedBackupStorageRedundancy O tipo de conta de armazenamento a ser usado para armazenar backups para esse banco de dados. 'Geo'
'GeoZone'
'Local'
'Zone'
restorableDroppedDatabaseId O identificador de recurso do banco de dados restaurador descartado associado à operação de criação desse banco de dados. corda
restorePointInTime Especifica o ponto no tempo (formato ISO8601) do banco de dados de origem que será restaurado para criar o novo banco de dados. corda
sampleName O nome do esquema de exemplo a ser aplicado ao criar esse banco de dados. 'AdventureWorksLT'
'WideWorldImportersFull'
'WideWorldImportersStd'
secondaryType O tipo secundário do banco de dados se ele for secundário. Os valores válidos são Geo, Named e Standby. 'Geo'
'Nomeado'
'Standby'
sourceDatabaseDeletionDate Especifica a hora em que o banco de dados foi excluído. corda
sourceDatabaseId O identificador de recurso do banco de dados de origem associado à operação de criação deste banco de dados. corda
sourceResourceId O identificador de recurso da origem associada à operação de criação deste banco de dados.

Essa propriedade só tem suporte para a edição DataWarehouse e permite restaurar entre assinaturas.

Quando sourceResourceId é especificado, sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId e sourceDatabaseDeletionDate não devem ser especificados e CreateMode deve ser PointInTimeRestore, Restore ou Recover.

Quando createMode for PointInTimeRestore, sourceResourceId deve ser a ID do recurso do banco de dados existente ou do pool de sql existente, e restorePointInTime deve ser especificado.

Quando createMode é Restore, sourceResourceId deve ser a ID do recurso do banco de dados descartado restaurável ou do pool de sql descartado restaurável.

Quando createMode for Recover, sourceResourceId deverá ser a ID do recurso do banco de dados recuperável ou do pool de sql recuperável.

Quando a assinatura de origem pertence a um locatário diferente da assinatura de destino, o cabeçalho "x-ms-authorization-auxiliary" deve conter o token de autenticação para o locatário de origem. Para obter mais detalhes sobre o cabeçalho "x-ms-authorization-auxiliary", consulte /azure/azure-resource-manager/management/authenticate-multi-tenant		 corda
useFreeLimit Se o banco de dados usa ou não limites mensais gratuitos. Permitido em um banco de dados em uma assinatura. Bool
zoneRedundant Se esse banco de dados é ou não redundante por zona, o que significa que as réplicas desse banco de dados serão distribuídas entre várias zonas de disponibilidade. Bool

DatabasePropertiesKeys

Nome Descrição Valor

DatabaseUserIdentity

Nome Descrição Valor

Microsoft.Sql/servers/databases

Nome Descrição Valor
apiVersion A versão da API '2024-05-01-preview'
identidade A identidade do Azure Active Directory do banco de dados. DatabaseIdentity
localização Local do recurso. cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Propriedades do recurso. DatabaseProperties
Sku A SKU do banco de dados.

A lista de SKUs pode variar de acordo com a região e a oferta de suporte. Para determinar os SKUs (incluindo o nome da SKU, camada/edição, família e capacidade) que estão disponíveis para sua assinatura em uma região do Azure, use a API REST Capabilities_ListByLocation ou um dos seguintes comandos:

azurecli<br />az sql db list-editions -l &lt;location&gt; -o table<br />````<br /><br />powershell
Get-AzSqlServerServiceObjective -Location <local>
````		 de SKU
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.Sql/servers/databases'

Sku

Nome Descrição Valor
capacidade Capacidade da SKU específica. int
família Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui. corda
nome O nome da SKU, normalmente, uma letra + código de número, por exemplo, P3. cadeia de caracteres (obrigatório)
tamanho Tamanho da SKU específica corda
camada A camada ou edição da SKU específica, por exemplo, Basic, Premium. corda

TrackedResourceTags

Nome Descrição Valor

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
SQL Server do Azure com auditoria gravada no Log Analytics

Implantar no Azure 		Esse modelo permite implantar um SQL Server do Azure com Auditoria habilitada para gravar logs de auditoria no Log Analytics (workspace do OMS)
criar um SQL Server e um banco de dados

Implantar no Azure 		Esse modelo permite que você crie o Banco de Dados SQL e o Servidor.
pool de SQL dedicado com o Transparent Encryption

Implantar no Azure 		Cria um SQL Server e um pool de SQL dedicado (antigo SQL DW) com Transparent Data Encryption.
implantar um novo pool elástico do SQL

Implantar no Azure 		Esse modelo permite implantar um novo Pool Elástico do SQL com seu novo SQL Server associado e novos Bancos de Dados SQL a serem atribuídos a ele.
implantar a Análise Esportiva no de Arquitetura do Azure

Implantar no Azure 		Cria uma conta de armazenamento do Azure com o ADLS Gen 2 habilitado, uma instância do Azure Data Factory com serviços vinculados para a conta de armazenamento (um Banco de Dados SQL do Azure, se implantado) e uma instância do Azure Databricks. A identidade do AAD para o usuário que implanta o modelo e a identidade gerenciada para a instância do ADF receberá a função colaborador de dados de blob de armazenamento na conta de armazenamento. Também há opções para implantar uma instância do Azure Key Vault, um Banco de Dados SQL do Azure e um Hub de Eventos do Azure (para casos de uso de streaming). Quando um Azure Key Vault é implantado, a identidade gerenciada do data factory e a identidade do AAD para o usuário que implanta o modelo receberão a função de Usuário de Segredos do Key Vault.
HDInsight com O Ambari + Hive Metastore DB personalizado na VNET

Implantar no Azure 		Esse modelo permite que você crie um cluster HDInsight em uma rede virtual existente com um novo BD SQL que serve como um banco de dados Ambari personalizado e Metastore do Hive. Você deve ter um SQL Sever existente, uma conta de armazenamento e uma VNET.
exemplo de ponto de extremidade privado

Implantar no Azure 		Este modelo mostra como criar um ponto de extremidade privado apontando para o SQL Server do Azure
provisionar um aplicativo Web com um banco de dados SQL

Implantar no Azure 		Esse modelo provisiona um aplicativo Web, um Banco de Dados SQL, configurações de Dimensionamento Automático, regras de alerta e Insights do Aplicativo. Ele configura uma cadeia de conexão no aplicativo Web para o banco de dados.
Serviços de Área de Trabalho Remota com de Alta Disponibilidade

Implantar no Azure 		Este código de exemplo do modelo arm implantará um laboratório de da Coleção de Sessão dos Serviços de Área de Trabalho Remota 2019 com alta disponibilidade. A meta é implantar uma solução totalmente redundante e altamente disponível para os Serviços de Área de Trabalho Remota usando o Windows Server 2019.
Sonarqube Docker Web App no Linux com o SQL do Azure

Implantar no Azure 		Este modelo implanta o Sonarqube em um contêiner do Linux do aplicativo Web do Serviço de Aplicativo do Azure usando a imagem oficial do Sonarqube e apoiado por um SQL Server do Azure.
Aplicativo Web com Identidade Gerenciada, SQL Server e ΑΙ

Implantar no Azure 		Exemplo simples para implantar a infraestrutura do Azure para aplicativo + dados + identidade gerenciada + monitoramento
WebApp consumindo um ponto de extremidade privado do SQL do Azure

Implantar no Azure 		Este modelo mostra como criar um aplicativo Web que consome um ponto de extremidade privado apontando para o SQL Server do Azure

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso servidores/bancos de dados pode ser implantado com operações direcionadas:

  • grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Sql/servers/databases, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/servers/databases@2024-05-01-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  sku = {
    capacity = int
    family = "string"
    name = "string"
    size = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      autoPauseDelay = int
      availabilityZone = "string"
      catalogCollation = "string"
      collation = "string"
      createMode = "string"
      elasticPoolId = "string"
      encryptionProtector = "string"
      encryptionProtectorAutoRotation = bool
      federatedClientId = "string"
      freeLimitExhaustionBehavior = "string"
      highAvailabilityReplicaCount = int
      isLedgerOn = bool
      keys = {
        {customized property} = {
        }
      }
      licenseType = "string"
      longTermRetentionBackupResourceId = "string"
      maintenanceConfigurationId = "string"
      manualCutover = bool
      maxSizeBytes = int
      minCapacity = int
      performCutover = bool
      preferredEnclaveType = "string"
      readScale = "string"
      recoverableDatabaseId = "string"
      recoveryServicesRecoveryPointId = "string"
      requestedBackupStorageRedundancy = "string"
      restorableDroppedDatabaseId = "string"
      restorePointInTime = "string"
      sampleName = "string"
      secondaryType = "string"
      sourceDatabaseDeletionDate = "string"
      sourceDatabaseId = "string"
      sourceResourceId = "string"
      useFreeLimit = bool
      zoneRedundant = bool
    }
  })
}

Valores de propriedade

DatabaseIdentity

Nome Descrição Valor
tipo O tipo de identidade 'None'
'UserAssigned'
userAssignedIdentities As IDs de recurso das identidades atribuídas pelo usuário a serem usadas DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Nome Descrição Valor

DatabaseKey

Nome Descrição Valor

DatabaseProperties

Nome Descrição Valor
autoPauseDelay Tempo em minutos após o qual o banco de dados é pausado automaticamente. Um valor de -1 significa que a pausa automática está desabilitada int
availabilityZone Especifica a zona de disponibilidade à qual o banco de dados está fixado. '1'
'2'
'3'
'NoPreference'
catalogCollation Ordenação do catálogo de metadados. 'DATABASE_DEFAULT'
'SQL_Latin1_General_CP1_CI_AS'
Agrupamento A ordenação do banco de dados. corda
createMode Especifica o modo de criação de banco de dados.

Padrão: criação regular de banco de dados.

Cópia: cria um banco de dados como uma cópia de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados de origem.

Secundário: cria um banco de dados como uma réplica secundária de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados primário existente.

PointInTimeRestore: cria um banco de dados restaurando um backup pontual de um banco de dados existente. sourceDatabaseId deve ser especificado como a ID do recurso do banco de dados existente e restorePointInTime deve ser especificado.

Recuperação: cria um banco de dados restaurando um backup replicado geograficamente. sourceDatabaseId deve ser especificado como a ID do recurso de banco de dados recuperável para restaurar.

Restauração: cria um banco de dados restaurando um backup de um banco de dados excluído. sourceDatabaseId deve ser especificado. Se sourceDatabaseId for a ID de recurso original do banco de dados, sourceDatabaseDeletionDate deverá ser especificado. Caso contrário, sourceDatabaseId deve ser a ID do recurso de banco de dados descartado restaurável e sourceDatabaseDeletionDate será ignorado. restorePointInTime também pode ser especificado para restaurar de um ponto anterior no tempo.

RestoreLongTermRetentionBackup: cria um banco de dados restaurando de um cofre de retenção de longo prazo. recoveryServicesRecoveryPointResourceId deve ser especificado como a ID do recurso do ponto de recuperação.

Não há suporte para Cópia, Secundária e RestoreLongTermRetentionBackup para a edição DataWarehouse.		 'Copiar'
'Padrão'
'OnlineSecondary'
'PointInTimeRestore'
'Recuperação'
'Restaurar'
'RestoreExternalBackup'
'RestoreExternalBackupSecondary'
'RestoreLongTermRetentionBackup'
'Secundário'
elasticPoolId O identificador de recurso do pool elástico que contém esse banco de dados. corda
encryptionProtector O URI do cofre de chaves do azure do banco de dados se ele estiver configurado por Chaves Gerenciadas pelo Cliente de Banco de Dados. corda
encryptionProtectorAutoRotation O sinalizador para habilitar ou desabilitar a rotação automática da chave AKV do protetor de criptografia de banco de dados. Bool
federatedClientId A ID do cliente usada para o cenário de CMK entre locatários por banco de dados corda

Restrições:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
freeLimitExhaustionBehavior Especifica o comportamento quando os limites gratuitos mensais são esgotados para o banco de dados gratuito.

AutoPause: o banco de dados será pausado automaticamente após o esgotamento dos limites gratuitos para o restante do mês.

BillForUsage: O banco de dados continuará online após o esgotamento dos limites gratuitos e qualquer excedente será cobrado.		 'AutoPause'
'BillOverUsage'
highAvailabilityReplicaCount O número de réplicas secundárias associadas ao banco de dados Business Critical, Premium ou Hyperscale Edition que são usadas para fornecer alta disponibilidade. Não aplicável a um banco de dados de Hiperescala em um pool elástico. int
isLedgerOn Se esse banco de dados é ou não um banco de dados do razão, o que significa que todas as tabelas no banco de dados são tabelas do razão. Observação: o valor dessa propriedade não pode ser alterado após a criação do banco de dados. Bool
Chaves As IDs de recurso das identidades atribuídas pelo usuário a serem usadas DatabasePropertiesKeys
licenseType O tipo de licença a ser aplicado a esse banco de dados. LicenseIncluded se você precisar de uma licença ou BasePrice se tiver uma licença e estiver qualificado para o Benefício Híbrido do Azure. 'BasePrice'
'LicenseIncluded'
longTermRetentionBackupResourceId O identificador de recurso do backup de retenção de longo prazo associado à operação de criação desse banco de dados. corda
maintenanceConfigurationId ID de configuração de manutenção atribuída ao banco de dados. Essa configuração define o período em que as atualizações de manutenção ocorrerão. corda
manualCutover Se a substituição manual controlada pelo cliente precisa ou não ser feita durante a operação Atualizar Banco de Dados para a camada de Hiperescala.

Essa propriedade só é aplicável ao dimensionar o banco de dados da camada Business Critical/General Purpose/Premium/Standard para a camada de Hiperescala.

Quando manualCutover for especificado, a operação de dimensionamento aguardará a entrada do usuário para disparar a substituição para o banco de dados da Hiperescala.

Para disparar a substituição, forneça o parâmetro 'performCutover' quando a operação De dimensionamento estiver em estado de espera.		 Bool
maxSizeBytes O tamanho máximo do banco de dados expresso em bytes. int
minCapacity Capacidade mínima que o banco de dados sempre alocará, se não estiver em pausa int
performCutover Para disparar a substituição manual controlada pelo cliente durante o estado de espera enquanto a operação de dimensionamento está em andamento.

Esse parâmetro de propriedade só é aplicável para operações de dimensionamento iniciadas junto com o parâmetro 'manualCutover'.

Essa propriedade só é aplicável quando o dimensionamento do banco de dados da camada Business Critical/General Purpose/Premium/Standard para a camada de Hiperescala já está em andamento.

Quando performCutover for especificado, a operação de dimensionamento disparará a substituição e executará a alteração de função no banco de dados da Hiperescala.		 Bool
preferredEnclaveType Tipo de enclave solicitado no banco de dados, ou seja, enclaves padrão ou VBS. 'Padrão'
'VBS'
readScale O estado do roteamento somente leitura. Se habilitada, as conexões que têm a intenção do aplicativo definida como readonly na cadeia de conexão podem ser roteadas para uma réplica secundária somente leitura na mesma região. Não aplicável a um banco de dados de Hiperescala em um pool elástico. 'Desabilitado'
'Habilitado'
recoverableDatabaseId O identificador de recurso do banco de dados recuperável associado à operação de criação desse banco de dados. corda
recoveryServicesRecoveryPointId O identificador de recurso do ponto de recuperação associado à operação de criação desse banco de dados. corda
requestedBackupStorageRedundancy O tipo de conta de armazenamento a ser usado para armazenar backups para esse banco de dados. 'Geo'
'GeoZone'
'Local'
'Zone'
restorableDroppedDatabaseId O identificador de recurso do banco de dados restaurador descartado associado à operação de criação desse banco de dados. corda
restorePointInTime Especifica o ponto no tempo (formato ISO8601) do banco de dados de origem que será restaurado para criar o novo banco de dados. corda
sampleName O nome do esquema de exemplo a ser aplicado ao criar esse banco de dados. 'AdventureWorksLT'
'WideWorldImportersFull'
'WideWorldImportersStd'
secondaryType O tipo secundário do banco de dados se ele for secundário. Os valores válidos são Geo, Named e Standby. 'Geo'
'Nomeado'
'Standby'
sourceDatabaseDeletionDate Especifica a hora em que o banco de dados foi excluído. corda
sourceDatabaseId O identificador de recurso do banco de dados de origem associado à operação de criação deste banco de dados. corda
sourceResourceId O identificador de recurso da origem associada à operação de criação deste banco de dados.

Essa propriedade só tem suporte para a edição DataWarehouse e permite restaurar entre assinaturas.

Quando sourceResourceId é especificado, sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId e sourceDatabaseDeletionDate não devem ser especificados e CreateMode deve ser PointInTimeRestore, Restore ou Recover.

Quando createMode for PointInTimeRestore, sourceResourceId deve ser a ID do recurso do banco de dados existente ou do pool de sql existente, e restorePointInTime deve ser especificado.

Quando createMode é Restore, sourceResourceId deve ser a ID do recurso do banco de dados descartado restaurável ou do pool de sql descartado restaurável.

Quando createMode for Recover, sourceResourceId deverá ser a ID do recurso do banco de dados recuperável ou do pool de sql recuperável.

Quando a assinatura de origem pertence a um locatário diferente da assinatura de destino, o cabeçalho "x-ms-authorization-auxiliary" deve conter o token de autenticação para o locatário de origem. Para obter mais detalhes sobre o cabeçalho "x-ms-authorization-auxiliary", consulte /azure/azure-resource-manager/management/authenticate-multi-tenant		 corda
useFreeLimit Se o banco de dados usa ou não limites mensais gratuitos. Permitido em um banco de dados em uma assinatura. Bool
zoneRedundant Se esse banco de dados é ou não redundante por zona, o que significa que as réplicas desse banco de dados serão distribuídas entre várias zonas de disponibilidade. Bool

DatabasePropertiesKeys

Nome Descrição Valor

DatabaseUserIdentity

Nome Descrição Valor

Microsoft.Sql/servers/databases

Nome Descrição Valor
identidade A identidade do Azure Active Directory do banco de dados. DatabaseIdentity
localização Local do recurso. cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
parent_id A ID do recurso que é o pai desse recurso. ID do recurso do tipo: servidores
Propriedades Propriedades do recurso. DatabaseProperties
Sku A SKU do banco de dados.

A lista de SKUs pode variar de acordo com a região e a oferta de suporte. Para determinar os SKUs (incluindo o nome da SKU, camada/edição, família e capacidade) que estão disponíveis para sua assinatura em uma região do Azure, use a API REST Capabilities_ListByLocation ou um dos seguintes comandos:

azurecli<br />az sql db list-editions -l &lt;location&gt; -o table<br />````<br /><br />powershell
Get-AzSqlServerServiceObjective -Location <local>
````		 de SKU
Tags Marcas de recurso Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.Sql/servers/databases@2024-05-01-preview"

Sku

Nome Descrição Valor
capacidade Capacidade da SKU específica. int
família Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui. corda
nome O nome da SKU, normalmente, uma letra + código de número, por exemplo, P3. cadeia de caracteres (obrigatório)
tamanho Tamanho da SKU específica corda
camada A camada ou edição da SKU específica, por exemplo, Basic, Premium. corda

TrackedResourceTags

Nome Descrição Valor