Partager via


Serveurs/bases de données Microsoft.Sql 2023-02-01-preview

Définition de ressource Bicep

Le type de ressource serveurs/bases de données peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Sql/servers/databases, ajoutez le Bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Sql/servers/databases@2023-02-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  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: json('decimal-as-string')
    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
  }
}

Valeurs de propriétés

servers/databases

Nom Description Valeur
name Nom de la ressource

Découvrez comment définir des noms et des types pour des ressources enfants dans Bicep.
string (obligatoire)

Limite de caractères : 1-128

Caractères valides :
Impossibilité d’utiliser :
<>*%&:\/? ou des caractères de contrôle.

Ne peut pas se terminer par un point ou un espace.
location Emplacement de la ressource. string (obligatoire)
tags Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
sku Référence SKU de base de données.

La liste des références SKU peut varier selon la région et l’offre de support. Pour déterminer les références SKU (y compris le nom de la référence SKU, le niveau/édition, la famille et la capacité) disponibles pour votre abonnement dans une région Azure, utilisez l’API Capabilities_ListByLocation REST ou l’une des commandes suivantes :

Azure CLI :
az sql db list-editions -l {location} -o table



Azure PowerShell :
Get-AzSqlServerServiceObjective -Location {location}

Sku
parent Dans Bicep, vous pouvez spécifier la ressource parente pour une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente.

Pour plus d’informations, consultez Ressource enfant en dehors de la ressource parente.
Nom symbolique de la ressource de type : serveurs
identité Identité Azure Active Directory de la base de données. DatabaseIdentity
properties Propriétés de ressource. DatabaseProperties

DatabaseIdentity

Nom Description Valeur
type Type d’identité 'None'
'UserAssigned'
userAssignedIdentities ID de ressource des identités affectées par l’utilisateur à utiliser DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Nom Description Valeur
{propriété personnalisée} DatabaseUserIdentity

DatabaseUserIdentity

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

DatabaseProperties

Nom Description Valeur
autoPauseDelay Durée en minutes après laquelle la base de données est automatiquement suspendue. La valeur -1 signifie que la pause automatique est désactivée int
availabilityZone Spécifie la zone de disponibilité à laquelle la base de données est épinglée. « 1 »
'2'
'3'
'NoPreference'
catalogCollation Classement du catalogue de métadonnées. 'DATABASE_DEFAULT'
'SQL_Latin1_General_CP1_CI_AS'
collation Classement de la base de données. string
createMode Spécifie le mode de création de la base de données.

Par défaut : création régulière de base de données.

Copier : crée une base de données en tant que copie d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données source.

Secondaire : crée une base de données en tant que réplica secondaire d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données primaire existante.

PointInTimeRestore : crée une base de données en restaurant une sauvegarde dans le temps d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données existante, et restorePointInTime doit être spécifié.

Récupération : crée une base de données en restaurant une sauvegarde géorépliquée. sourceDatabaseId doit être spécifié comme ID de ressource de base de données récupérable à restaurer.

Restaurer : crée une base de données en restaurant une sauvegarde d’une base de données supprimée. sourceDatabaseId doit être spécifié. Si sourceDatabaseId est l’ID de ressource d’origine de la base de données, sourceDatabaseDeletionDate doit être spécifié. Sinon, sourceDatabaseId doit être l’ID de ressource de base de données supprimée pouvant être restaurée et sourceDatabaseDeletionDate est ignoré. restorePointInTime peut également être spécifié pour la restauration à partir d’un point antérieur dans le temps.

RestoreLongTermRetentionBackup : crée une base de données en restaurant à partir d’un coffre de rétention à long terme. recoveryServicesRecoveryPointResourceId doit être spécifié comme ID de ressource du point de récupération.

Copy, Secondary et RestoreLongTermRetentionBackup ne sont pas pris en charge pour l’édition DataWarehouse.
'Copier'
'Par défaut'
'OnlineSecondary'
'PointInTimeRestore'
'Récupération'
'Restaurer'
'RestoreExternalBackup'
'RestoreExternalBackupSecondary'
'RestoreLongTermRetentionBackup'
'Secondaire'
elasticPoolId Identificateur de ressource du pool élastique contenant cette base de données. string
encryptionProtector URI du coffre de clés Azure de la base de données s’il est configuré avec chaque clé gérée par le client de base de données. string
encryptionProtectorAutoRotation Indicateur permettant d’activer ou de désactiver la rotation automatique de la clé AKV du protecteur de chiffrement de base de données. bool
federatedClientId ID client utilisé pour le scénario CMK interlocataire par base de données string

Contraintes :
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
freeLimitExhaustionBehavior Spécifie le comportement lorsque les limites de gratuité mensuelles sont épuisées pour la base de données gratuite.

AutoPause : la base de données est automatiquement suspendue en cas d’épuisement des limites gratuites pendant le reste du mois.

BillForUsage : la base de données continuera d’être en ligne en cas d’épuisement des limites gratuites et tout dépassement sera facturé.
'AutoPause'
'BillOverUsage'
highAvailabilityReplicaCount Nombre de réplicas secondaires associés à la base de données qui sont utilisés pour fournir une haute disponibilité. Non applicable à une base de données Hyperscale au sein d’un pool élastique. int
isLedgerOn Indique si cette base de données est une base de données de registre, ce qui signifie que toutes les tables de la base de données sont des tables de registre. Remarque : la valeur de cette propriété ne peut pas être modifiée une fois la base de données créée. bool
clés ID de ressource des identités affectées par l’utilisateur à utiliser DatabasePropertiesKeys
licenseType Type de licence à appliquer pour cette base de données. LicenseIncludedsi vous avez besoin d’une licence, ou BasePrice si vous disposez d’une licence et que vous êtes éligible pour le Azure Hybrid Benefit. 'BasePrice'
'LicenseIncluded'
longTermRetentionBackupResourceId Identificateur de ressource de la sauvegarde de rétention à long terme associée à l’opération de création de cette base de données. string
maintenanceConfigurationId ID de configuration de maintenance attribué à la base de données. Cette configuration définit la période pendant laquelle les mises à jour de maintenance se produisent. string
manualCutover Indique si le basculement manuel contrôlé par le client doit ou non être effectué pendant l’opération de mise à jour de la base de données au niveau Hyperscale.

Cette propriété s’applique uniquement lors de la mise à l’échelle de la base de données du niveau critique pour l'entreprise/usage général/Premium/Standard au niveau Hyperscale.

Lorsque manualCutover est spécifié, l’opération de mise à l’échelle attend que l’entrée utilisateur déclenche le basculement vers la base de données Hyperscale.

Pour déclencher le basculement, indiquez le paramètre « performCutover » lorsque l’opération de mise à l’échelle est en état d’attente.
bool
maxSizeBytes Taille maximale de la base de données exprimée en octets. int
minCapacité Capacité minimale que la base de données aura toujours allouée, s’il n’est pas suspendu Pour spécifier une valeur décimale, utilisez la fonction json(). décimal int ou json
performCutover Pour déclencher le basculement manuel contrôlé par le client pendant l’état d’attente pendant que l’opération de mise à l’échelle est en cours.

Ce paramètre de propriété s’applique uniquement aux opérations de mise à l’échelle lancées avec le paramètre « manualCutover ».

Cette propriété s’applique uniquement lorsque la mise à l’échelle de la base de données du niveau critique pour l'entreprise/usage général/Premium/Standard vers le niveau Hyperscale est déjà en cours.

Lorsque performCutover est spécifié, l’opération de mise à l’échelle déclenche un basculement et effectue un changement de rôle vers la base de données Hyperscale.
bool
preferredEnclaveType Type d’enclave demandé sur la base de données, c’est-à-dire les enclaves par défaut ou VBS. 'Par défaut'
'VBS'
readScale État du routage en lecture seule. Si cette option est activée, les connexions dont l’intention d’application est définie sur readonly dans leur chaîne de connexion peuvent être routées vers un réplica secondaire en lecture seule dans la même région. Non applicable à une base de données Hyperscale au sein d’un pool élastique. 'Désactivé'
'Enabled'
recoverableDatabaseId Identificateur de ressource de la base de données récupérable associée à l’opération de création de cette base de données. string
recoveryServicesRecoveryPointId Identificateur de ressource du point de récupération associé à l’opération de création de cette base de données. string
requestedBackupStorageRedundancy Type de compte de stockage à utiliser pour stocker les sauvegardes de cette base de données. 'Geo'
'GeoZone'
'Local'
'Zone'
restorableDroppedDatabaseId Identificateur de ressource de la base de données supprimée restaurable associée à l’opération de création de cette base de données. string
restorePointInTime Spécifie le point dans le temps (format ISO8601) de la base de données source qui sera restaurée pour créer la nouvelle base de données. string
sampleName Nom de l’exemple de schéma à appliquer lors de la création de cette base de données. 'AdventureWorksLT'
'WideWorldImportersFull'
'WideWorldImportersStd'
secondaryType Type secondaire de la base de données s’il s’agit d’une base de données secondaire. Les valeurs valides sont Geo, Named et Standby. 'Geo'
'Nommé'
'Veille'
sourceDatabaseDeletionDate Spécifie l’heure à laquelle la base de données a été supprimée. string
sourceDatabaseId Identificateur de ressource de la base de données source associée à l’opération de création de cette base de données. string
sourceResourceId Identificateur de ressource de la source associée à l’opération de création de cette base de données.

Cette propriété est uniquement prise en charge pour l’édition DataWarehouse et permet la restauration entre les abonnements.

Lorsque sourceResourceId est spécifié, sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId et sourceDatabaseDeletionDate ne doivent pas être spécifiés et CreateMode doit être PointInTimeRestore, Restore ou Recover.

Lorsque createMode est PointInTimeRestore, sourceResourceId doit être l’ID de ressource de la base de données existante ou du pool SQL existant, et restorePointInTime doit être spécifié.

Lorsque createMode est Restore, sourceResourceId doit être l’ID de ressource de la base de données supprimée ou du pool SQL supprimé restaurable.

Lorsque createMode est Recover, sourceResourceId doit être l’ID de ressource de la base de données récupérable ou du pool SQL récupérable.

Lorsque l’abonnement source appartient à un locataire différent de l’abonnement cible, l’en-tête « x-ms-authorization-auxiliary » doit contenir un jeton d’authentification pour le locataire source. Pour plus d’informations sur l’en-tête « x-ms-authorization-auxiliary », consultez /azure/azure-resource-manager/management/authenticate-multi-tenant
string
useFreeLimit Indique si la base de données utilise ou non des limites mensuelles gratuites. Autorisé sur une base de données dans un abonnement. bool
zoneRedundant Indique si cette base de données est redondante interzone ou non, ce qui signifie que les réplicas de cette base de données seront répartis sur plusieurs zones de disponibilité. bool

DatabasePropertiesKeys

Nom Description Valeur
{propriété personnalisée} DatabaseKey

DatabaseKey

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

Sku

Nom Description Valeur
capacité Capacité de la référence SKU particulière. int
famille Si le service a différentes générations de matériel, pour la même référence SKU, cela peut être capturé ici. string
name Nom de la référence SKU, généralement une lettre + un code numérique, par exemple P3. chaîne (obligatoire)
taille Taille de la référence SKU particulière string
Niveau Niveau ou édition de la référence SKU particulière, par exemple De base, Premium. string

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Application Django avec bases de données SQL

Déployer sur Azure
Ce modèle utilise l’extension Azure Linux CustomScript pour déployer une application. Cet exemple crée une machine virtuelle Ubuntu, effectue une installation silencieuse de Python, Django et Apache, puis crée une application Django simple. Le modèle crée également un SQL Database, avec un exemple de table avec des exemples de données qui s’affichent dans le navigateur web à l’aide d’une requête
EPiserverCMS dans Azure

Déployer sur Azure
Ce modèle vous permet de créer des ressources requises pour le déploiement d’EpiServerCMS dans Azure
Mise à l’échelle automatique DE LANSA Windows VM ScaleSet avec Azure SQL Database

Déployer sur Azure
Le modèle déploie une machine virtuelle Windows avec un nombre souhaité de machines virtuelles dans le groupe identique et un MSI LANSA à installer dans chaque machine virtuelle. Une fois le groupe de machines virtuelles identiques déployé, une extension de script personnalisé est utilisée pour installer le MSI LANSA)
Déployer Octopus Deploy 3.0 avec une licence d’évaluation

Déployer sur Azure
Ce modèle vous permet de déployer un seul serveur Octopus Deploy 3.0 avec une licence d’évaluation. Cette opération sera déployée sur une seule machine virtuelle Windows Server 2012R2 (Standard D2) et UNE base de données SQL (niveau S1) à l’emplacement spécifié pour le groupe de ressources.
Application web du portail vidéo Orchard CMS

Déployer sur Azure
Ce modèle fournit un moyen simple de déployer Orchard CMS sur Azure App Service Web Apps avec le module Azure Media Services activé et configuré.
Application web Umbraco CMS évolutive

Déployer sur Azure
Ce modèle fournit un moyen simple de déployer l’application web umbraco CMS sur Azure App Service Web Apps.
Application web CMS simple Umbraco

Déployer sur Azure
Ce modèle fournit un moyen simple de déployer l’application web umbraco CMS sur Azure App Service Web Apps.
Enterprise Governance-AppService, SQL DB, AD, OMS, Runbooks

Déployer sur Azure
L’adoption du cloud pour une entreprise, petite ou grande, nécessite des modèles de gouvernance responsables et efficaces pour tirer de la valeur de leurs déploiements cloud. CloudWise (nom de code de la solution), est une solution composite disponible à partir des démarrages rapides des partenaires Azure, est un outil d’adoption pour les clients, les intégrateurs système et les partenaires, qui fournit une solution de gouvernance et d’opérations automatisée et libre-service, axée sur l’optimisation de vos coûts, l’amélioration de la fiabilité de vos applications et la réduction des risques pour l’entreprise. La solution met en évidence les principaux piliers de gouvernance de visibilité et de contrôle.
Site web eShop avec ILB ASE

Déployer sur Azure
Un environnement App Service est une option de plan de service PremiumAzure App Service qui fournit un environnement totalement isolé et dédié pour exécuter en toute sécurité des applications Azure App Service à grande échelle, comme des applications web, mobiles et d’API.
WebApp consommant un point de terminaison privé Azure SQL

Déployer sur Azure
Ce modèle montre comment créer une application web qui consomme un point de terminaison privé pointant vers Azure SQL Server
Services Bureau à distance avec haute disponibilité

Déployer sur Azure
Cet exemple de code de modèle ARM déploiera un laboratoire de collection de sessions des services Bureau à distance 2019 avec une haute disponibilité. L’objectif est de déployer une solution entièrement redondante et hautement disponible pour les services Bureau à distance, à l’aide de Windows Server 2019.
Déployer Sports Analytics sur l’architecture Azure

Déployer sur Azure
Crée un compte de stockage Azure avec ADLS Gen 2 activé, un Azure Data Factory instance avec des services liés pour le compte de stockage (un Azure SQL Database s’il est déployé) et un instance Azure Databricks. L’identité AAD pour l’utilisateur qui déploie le modèle et l’identité managée pour le instance ADF se verront attribuer le rôle Contributeur aux données blob de stockage sur le compte de stockage. Il existe également des options pour déployer un Key Vault instance Azure, une base de données Azure SQL et un hub d’événements Azure (pour les cas d’usage de streaming). Lorsqu’un Key Vault Azure est déployé, l’identité gérée par la fabrique de données et l’identité AAD de l’utilisateur qui déploie le modèle se voient attribuer le rôle Utilisateur Key Vault Secrets.
Application web avec un SQL Database, Azure Cosmos DB, Recherche Azure

Déployer sur Azure
Ce modèle approvisionne une application web, un SQL Database, Azure Cosmos DB, Recherche Azure et Application Insights.
Migrer vers Azure SQL base de données à l’aide d’Azure DMS

Déployer sur Azure
Le Azure Database Migration Service (DMS) est conçu pour simplifier le processus de migration des bases de données locales vers Azure. DMS simplifie la migration des bases de données oracle et SQL Server locales existantes vers Azure SQL Database, Azure SQL Managed Instance ou Microsoft SQL Server dans une machine virtuelle Azure. Ce modèle déploie une instance du service de migration Azure Database, une machine virtuelle Azure sur laquelle le serveur SQL est installé, qui fera office de serveur source avec une base de données précréée, et un serveur target Azure SQL DB qui aura un schéma précréé de la base de données à migrer de la base de données source vers le serveur cible. Le modèle déploie également les ressources requises telles que la carte réseau, le réseau virtuel, etc. pour la prise en charge de la machine virtuelle source, du service DMS et du serveur cible.
HDInsight avec la base de données Ambari + Hive Metastore personnalisée dans le réseau virtuel

Déployer sur Azure
Ce modèle vous permet de créer un cluster HDInsight dans un réseau virtuel existant avec une nouvelle base de données SQL qui sert à la fois de base de données Ambari personnalisée et de metastore Hive. Vous devez disposer d’un serveur SQL, d’un compte de stockage et d’un réseau virtuel existants.
Déployer un cluster HDInsight et une base de données SQL

Déployer sur Azure
Ce modèle vous permet de créer un cluster HDInsight et un SQL Database pour tester Sqoop.
Exemple de point de terminaison privé

Déployer sur Azure
Ce modèle montre comment créer un point de terminaison privé pointant vers Azure SQL Server
serveur Azure SQL avec audit écrit dans Event Hub

Déployer sur Azure
Ce modèle vous permet de déployer un serveur Azure SQL avec l’audit activé pour écrire des journaux d’audit dans Event Hub
serveur Azure SQL avec audit écrit dans Log Analytics

Déployer sur Azure
Ce modèle vous permet de déployer un serveur Azure SQL avec l’audit activé pour écrire des journaux d’audit dans Log Analytics (espace de travail OMS)
Pool SQL dédié avec chiffrement transparent

Déployer sur Azure
Crée un SQL Server et un pool SQL dédié (anciennement SQL DW) avec Transparent Data Encryption.
Créer une SQL Server et une base de données

Déployer sur Azure
Ce modèle vous permet de créer SQL Database et serveur.
Approvisionner un SQL Database avec TDE

Déployer sur Azure
Ce modèle provisionne un SQL Server avec un pare-feu ouvert pour le trafic Azure et une base de données SQL avec transparent Data Encryption (TDE).
Déployer un nouveau pool élastique SQL

Déployer sur Azure
Ce modèle vous permet de déployer un nouveau pool élastique SQL avec ses nouvelles SQL Server associées et de nouvelles bases de données SQL à lui affecter.
Créer des serveurs Azure SQL et une base de données avec un groupe de basculement

Déployer sur Azure
Crée deux serveurs Azure SQL, une base de données et un groupe de basculement.
App Service Environment avec Azure SQL back-end

Déployer sur Azure
Ce modèle crée une App Service Environment avec un back-end Azure SQL ainsi que des points de terminaison privés ainsi que des ressources associées généralement utilisées dans un environnement privé/isolé.
Approvisionner une application mobile avec un SQL Database

Déployer sur Azure
Ce modèle provisionne une application mobile, un SQL Database et un hub de notification. Il configure un chaîne de connexion dans l’application mobile pour la base de données et le hub de notification.
Application web avec identité managée, SQL Server et ΑΙ

Déployer sur Azure
Exemple simple de déploiement de l’infrastructure Azure pour l’application + les données + l’identité managée + la supervision
Créer une application web + cache Redis + base de données SQL avec un modèle

Déployer sur Azure
Ce modèle crée une application web Azure avec un cache Redis et un SQL Database.
Approvisionner une application web avec un SQL Database

Déployer sur Azure
Ce modèle provisionne une application web, une SQL Database, des paramètres de mise à l’échelle automatique, des règles d’alerte et Des insights d’application. Il configure un chaîne de connexion dans l’application web pour la base de données.
Créer, configurer et déployer une application web sur une machine virtuelle Azure

Déployer sur Azure
Créer et configurer une machine virtuelle Windows avec SQL Azure base de données et déployer une application web dans l’environnement à l’aide de PowerShell DSC
Application web Docker Sonarqube sur Linux avec Azure SQL

Déployer sur Azure
Ce modèle déploie Sonarqube dans un conteneur Linux d’application web Azure App Service à l’aide de l’image Sonarqube officielle et soutenu par un serveur Azure SQL.

Définition de ressources de modèle ARM

Le type de ressource serveurs/bases de données peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Sql/servers/databases, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.Sql/servers/databases",
  "apiVersion": "2023-02-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "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": "[json('decimal-as-string')]",
    "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"
  }
}

Valeurs de propriétés

servers/databases

Nom Description Valeur
type Type de ressource « Microsoft.Sql/servers/databases »
apiVersion Version de l’API de ressource « 2023-02-01-preview »
name Nom de la ressource

Découvrez comment définir des noms et des types pour des ressources enfants dans des modèles ARM JSON.
chaîne (obligatoire)

Limite de caractères : 1-128

Caractères valides :
Impossibilité d’utiliser :
<>*%&:\/? ou des caractères de contrôle.

Ne peut pas se terminer par un point ou un espace.
location Emplacement de la ressource. chaîne (obligatoire)
tags Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
sku Référence SKU de base de données.

La liste des références SKU peut varier selon la région et l’offre de support. Pour déterminer les références SKU (y compris le nom de la référence SKU, le niveau/édition, la famille et la capacité) disponibles pour votre abonnement dans une région Azure, utilisez l’API Capabilities_ListByLocation REST ou l’une des commandes suivantes :

Azure CLI :
az sql db list-editions -l {location} -o table



Azure PowerShell :
Get-AzSqlServerServiceObjective -Location {location}

Sku
identité Identité Azure Active Directory de la base de données. DatabaseIdentity
properties Propriétés de ressource. DatabaseProperties

DatabaseIdentity

Nom Description Valeur
type Type d’identité 'None'
'UserAssigned'
userAssignedIdentities ID de ressource des identités affectées par l’utilisateur à utiliser DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Nom Description Valeur
{propriété personnalisée} DatabaseUserIdentity

DatabaseUserIdentity

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

DatabaseProperties

Nom Description Valeur
autoPauseDelay Durée en minutes après laquelle la base de données est automatiquement suspendue. La valeur -1 signifie que la pause automatique est désactivée int
availabilityZone Spécifie la zone de disponibilité dans laquelle la base de données est épinglée. « 1 »
'2'
'3'
'NoPreference'
catalogCollation Classement du catalogue de métadonnées. 'DATABASE_DEFAULT'
'SQL_Latin1_General_CP1_CI_AS'
collation Classement de la base de données. string
createMode Spécifie le mode de création de la base de données.

Par défaut : création régulière de base de données.

Copier : crée une base de données en tant que copie d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données source.

Secondaire : crée une base de données en tant que réplica secondaire d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données primaire existante.

PointInTimeRestore : crée une base de données en restaurant une sauvegarde dans le temps d’une base de données existante. sourceDatabaseId doit être spécifié comme ID de ressource de la base de données existante, et restorePointInTime doit être spécifié.

Récupération : crée une base de données en restaurant une sauvegarde géorépliquée. sourceDatabaseId doit être spécifié comme ID de ressource de base de données récupérable à restaurer.

Restaurer : crée une base de données en restaurant une sauvegarde d’une base de données supprimée. sourceDatabaseId doit être spécifié. Si sourceDatabaseId est l’ID de ressource d’origine de la base de données, sourceDatabaseDeletionDate doit être spécifié. Sinon, sourceDatabaseId doit être l’ID de ressource de base de données supprimée pouvant être restaurée et sourceDatabaseDeletionDate est ignoré. restorePointInTime peut également être spécifié pour la restauration à partir d’un point antérieur dans le temps.

RestoreLongTermRetentionBackup : crée une base de données en restaurant à partir d’un coffre de rétention à long terme. recoveryServicesRecoveryPointResourceId doit être spécifié comme ID de ressource du point de récupération.

Copy, Secondary et RestoreLongTermRetentionBackup ne sont pas pris en charge pour l’édition DataWarehouse.
'Copier'
'Par défaut'
'OnlineSecondary'
'PointInTimeRestore'
'Récupération'
'Restaurer'
'RestoreExternalBackup'
'RestoreExternalBackupSecondary'
'RestoreLongTermRetentionBackup'
'Secondaire'
elasticPoolId Identificateur de ressource du pool élastique contenant cette base de données. string
encryptionProtector URI du coffre de clés Azure de la base de données s’il est configuré avec chaque clé gérée par le client de base de données. string
encryptionProtectorAutoRotation Indicateur permettant d’activer ou de désactiver la rotation automatique de la clé AKV du protecteur de chiffrement de base de données. bool
federatedClientId ID client utilisé pour le scénario CMK interlocataire par base de données string

Contraintes :
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
freeLimitExhaustionBehavior Spécifie le comportement lorsque les limites de gratuité mensuelles sont épuisées pour la base de données gratuite.

AutoPause : la base de données est automatiquement suspendue en cas d’épuisement des limites gratuites pendant le reste du mois.

BillForUsage : la base de données continuera d’être en ligne en cas d’épuisement des limites gratuites et tout dépassement sera facturé.
'AutoPause'
'BillOverUsage'
highAvailabilityReplicaCount Nombre de réplicas secondaires associés à la base de données qui sont utilisés pour fournir une haute disponibilité. Non applicable à une base de données Hyperscale au sein d’un pool élastique. int
isLedgerOn Indique si cette base de données est une base de données de registre, ce qui signifie que toutes les tables de la base de données sont des tables de registre. Remarque : la valeur de cette propriété ne peut pas être modifiée une fois la base de données créée. bool
clés ID de ressource des identités affectées par l’utilisateur à utiliser DatabasePropertiesKeys
licenseType Type de licence à appliquer pour cette base de données. LicenseIncludedsi vous avez besoin d’une licence, ou BasePrice si vous disposez d’une licence et que vous êtes éligible pour le Azure Hybrid Benefit. 'BasePrice'
'LicenseIncluded'
longTermRetentionBackupResourceId Identificateur de ressource de la sauvegarde de rétention à long terme associée à l’opération de création de cette base de données. string
maintenanceConfigurationId ID de configuration de maintenance attribué à la base de données. Cette configuration définit la période pendant laquelle les mises à jour de maintenance se produisent. string
manualCutover Indique si le basculement manuel contrôlé par le client doit ou non être effectué pendant l’opération de mise à jour de la base de données au niveau Hyperscale.

Cette propriété s’applique uniquement lors de la mise à l’échelle de la base de données du niveau critique pour l'entreprise/usage général/Premium/Standard au niveau Hyperscale.

Lorsque manualCutover est spécifié, l’opération de mise à l’échelle attend que l’entrée utilisateur déclenche le basculement vers la base de données Hyperscale.

Pour déclencher le basculement, indiquez le paramètre « performCutover » lorsque l’opération de mise à l’échelle est en état d’attente.
bool
maxSizeBytes Taille maximale de la base de données exprimée en octets. int
minCapacité Capacité minimale que la base de données aura toujours allouée, s’il n’est pas suspendu Pour spécifier une valeur décimale, utilisez la fonction json(). décimal int ou json
performCutover Pour déclencher le basculement manuel contrôlé par le client pendant l’état d’attente pendant que l’opération de mise à l’échelle est en cours.

Ce paramètre de propriété s’applique uniquement aux opérations de mise à l’échelle lancées avec le paramètre « manualCutover ».

Cette propriété s’applique uniquement lorsque la mise à l’échelle de la base de données du niveau critique pour l'entreprise/usage général/Premium/Standard vers le niveau Hyperscale est déjà en cours.

Lorsque performCutover est spécifié, l’opération de mise à l’échelle déclenche un basculement et effectue un changement de rôle vers la base de données Hyperscale.
bool
preferredEnclaveType Type d’enclave demandé sur la base de données, c’est-à-dire les enclaves par défaut ou VBS. 'Par défaut'
'VBS'
readScale État du routage en lecture seule. Si cette option est activée, les connexions dont l’intention d’application est définie sur readonly dans leur chaîne de connexion peuvent être routées vers un réplica secondaire en lecture seule dans la même région. Non applicable à une base de données Hyperscale au sein d’un pool élastique. 'Désactivé'
'Enabled'
recoverableDatabaseId Identificateur de ressource de la base de données récupérable associée à l’opération de création de cette base de données. string
recoveryServicesRecoveryPointId Identificateur de ressource du point de récupération associé à l’opération de création de cette base de données. string
requestedBackupStorageRedundancy Type de compte de stockage à utiliser pour stocker les sauvegardes de cette base de données. 'Geo'
'GeoZone'
'Local'
'Zone'
restorableDroppedDatabaseId Identificateur de ressource de la base de données supprimée restaurable associée à l’opération de création de cette base de données. string
restorePointInTime Spécifie le point dans le temps (format ISO8601) de la base de données source qui sera restaurée pour créer la nouvelle base de données. string
sampleName Nom de l’exemple de schéma à appliquer lors de la création de cette base de données. 'AdventureWorksLT'
'WideWorldImportersFull'
'WideWorldImportersStd'
secondaryType Type secondaire de la base de données s’il s’agit d’une base de données secondaire. Les valeurs valides sont Geo, Named et Standby. 'Geo'
'Named'
'Veille'
sourceDatabaseDeletionDate Spécifie l’heure à laquelle la base de données a été supprimée. string
sourceDatabaseId Identificateur de ressource de la base de données source associée à l’opération de création de cette base de données. string
sourceResourceId Identificateur de ressource de la source associée à l’opération de création de cette base de données.

Cette propriété est uniquement prise en charge pour l’édition DataWarehouse et permet de restaurer entre les abonnements.

Lorsque sourceResourceId est spécifié, sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId et sourceDatabaseDeletionDate ne doivent pas être spécifiés et CreateMode doit être PointInTimeRestore, Restore ou Recover.

Lorsque createMode a la valeur PointInTimeRestore, sourceResourceId doit être l’ID de ressource de la base de données existante ou du pool SQL existant, et restorePointInTime doit être spécifié.

Lorsque createMode a la valeur Restore, sourceResourceId doit être l’ID de ressource de la base de données supprimée restaurable ou du pool SQL supprimé pouvant être restauré.

Lorsque createMode a la valeur Recover, sourceResourceId doit être l’ID de ressource de la base de données récupérable ou du pool SQL récupérable.

Lorsque l’abonnement source appartient à un locataire différent de l’abonnement cible, l’en-tête « x-ms-authorization-auxiliary » doit contenir un jeton d’authentification pour le locataire source. Pour plus d’informations sur l’en-tête « x-ms-authorization-auxiliary », consultez /azure/azure-resource-manager/management/authenticate-multi-tenant
string
useFreeLimit Indique si la base de données utilise ou non des limites mensuelles gratuites. Autorisé sur une base de données d’un abonnement. bool
zoneRedundant Si cette base de données est redondante interzone ou non, les réplicas de cette base de données seront répartis sur plusieurs zones de disponibilité. bool

DatabasePropertiesKeys

Nom Description Valeur
{propriété personnalisée} DatabaseKey

DatabaseKey

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

Sku

Nom Description Valeur
capacité Capacité de la référence SKU particulière. int
famille Si le service a différentes générations de matériel, pour la même référence SKU, cela peut être capturé ici. string
name Nom de la référence SKU, généralement une lettre + un code numérique, par exemple P3. string (obligatoire)
taille Taille de la référence SKU particulière string
Niveau Niveau ou édition de la référence SKU particulière, par exemple De base, Premium. string

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Application Django avec bases de données SQL

Déployer sur Azure
Ce modèle utilise l’extension Azure Linux CustomScript pour déployer une application. Cet exemple crée une machine virtuelle Ubuntu, effectue une installation silencieuse de Python, Django et Apache, puis crée une application Django simple. Le modèle crée également une SQL Database, avec un exemple de table avec des exemples de données qui s’affichent dans le navigateur web à l’aide d’une requête
EPiserverCMS dans Azure

Déployer sur Azure
Ce modèle vous permet de créer les ressources requises pour le déploiement d’EpiServerCMS dans Azure
Mise à l’échelle automatique de la machine virtuelle Windows LANSA avec Azure SQL Database

Déployer sur Azure
Le modèle déploie un VMSS Windows avec un nombre souhaité de machines virtuelles dans le groupe identique et une MSI LANSA à installer dans chaque machine virtuelle. Une fois que le groupe de machines virtuelles identiques est déployé, une extension de script personnalisé est utilisée pour installer la MSI LANSA)
Déployer Octopus Deploy 3.0 avec une licence d’évaluation

Déployer sur Azure
Ce modèle vous permet de déployer un seul serveur Octopus Deploy 3.0 avec une licence d’évaluation. Cette opération sera déployée sur une seule machine virtuelle Windows Server 2012R2 (Standard D2) et une base de données SQL (niveau S1) à l’emplacement spécifié pour le groupe de ressources.
Orchard CMS Video Portal Web App

Déployer sur Azure
Ce modèle offre un moyen simple de déployer Orchard CMS sur Azure App Service Web Apps avec le module Azure Media Services activé et configuré.
Application web Umbraco CMS scalable

Déployer sur Azure
Ce modèle offre un moyen simple de déployer l’application web umbraco CMS sur Azure App Service Web Apps.
Application web CMS Simple Umbraco

Déployer sur Azure
Ce modèle offre un moyen simple de déployer l’application web umbraco CMS sur Azure App Service Web Apps.
Enterprise Governance-AppService, SQL DB, AD, OMS, Runbooks

Déployer sur Azure
L’adoption du cloud pour une entreprise, petite ou grande, nécessite des modèles de gouvernance responsables et efficaces pour tirer parti de leurs déploiements cloud. CloudWise (nom de code de la solution), est une solution composite disponible dans les guides de démarrage rapide des partenaires Azure, est un outil d’adoption pour les clients, les intégrateurs système et les partenaires, qui fournit une solution de gouvernance et d’opérations automatisée et libre-service, axée sur l’optimisation de vos coûts, l’amélioration de la fiabilité de vos applications, la réduction des risques métier. La solution met en évidence les principaux piliers de gouvernance de visibilité et de contrôle.
Site web eShop avec ILB ASE

Déployer sur Azure
Un environnement App Service est une option de plan de service PremiumAzure App Service qui fournit un environnement totalement isolé et dédié pour exécuter en toute sécurité des applications Azure App Service à grande échelle, comme des applications web, mobiles et d’API.
WebApp consommant un point de terminaison privé Azure SQL

Déployer sur Azure
Ce modèle montre comment créer une application web qui consomme un point de terminaison privé pointant vers Azure SQL Server
Services Bureau à distance avec haute disponibilité

Déployer sur Azure
Cet exemple de code de modèle ARM déploie un laboratoire de collection de sessions des services Bureau à distance 2019 avec une haute disponibilité. L’objectif est de déployer une solution entièrement redondante et hautement disponible pour les services Bureau à distance, à l’aide de Windows Server 2019.
Déployer l’architecture Sports Analytics sur Azure

Déployer sur Azure
Crée un compte de stockage Azure avec ADLS Gen2 activé, un Azure Data Factory instance avec des services liés pour le compte de stockage (une base de données Azure SQL si elle est déployée) et une instance Azure Databricks. L’identité AAD de l’utilisateur qui déploie le modèle et l’identité managée pour le instance ADF se verront attribuer le rôle Contributeur aux données Blob du stockage sur le compte de stockage. Il existe également des options pour déployer un Key Vault instance Azure, une base de données Azure SQL et un hub d’événements Azure (pour les cas d’usage de streaming). Lorsqu’un Key Vault Azure est déployé, l’identité managée de la fabrique de données et l’identité AAD de l’utilisateur qui déploie le modèle se voient attribuer le rôle Utilisateur Key Vault Secrets.
Application web avec un SQL Database, Azure Cosmos DB, Recherche Azure

Déployer sur Azure
Ce modèle provisionne une application web, un SQL Database, Azure Cosmos DB, Azure Search et Application Insights.
Migrer vers Azure SQL base de données à l’aide d’Azure DMS

Déployer sur Azure
Le Azure Database Migration Service (DMS) est conçu pour simplifier le processus de migration des bases de données locales vers Azure. DMS simplifie la migration des bases de données SQL Server et Oracle locales existantes vers Azure SQL Database, Azure SQL Managed Instance ou Microsoft SQL Server dans une machine virtuelle Azure. Ce modèle déploiera une instance d’Azure Database Migration Service, une machine virtuelle Azure sur laquelle sql Server est installé, qui fera office de serveur source avec une base de données précréée, et un serveur de base de données Target Azure SQL qui aura un schéma précréé de la base de données à migrer de la base de données source vers le serveur cible. Le modèle déploie également les ressources requises, telles que la carte réseau, le réseau virtuel, etc. pour la prise en charge de la machine virtuelle source, du service DMS et du serveur cible.
HDInsight avec une base de données personnalisée Ambari + Hive Metastore dans un réseau virtuel

Déployer sur Azure
Ce modèle vous permet de créer un cluster HDInsight dans un réseau virtuel existant avec une nouvelle base de données SQL qui sert à la fois de base de données Ambari personnalisée et de metastore Hive. Vous devez disposer d’un serveur SQL Server, d’un compte de stockage et d’un réseau virtuel existants.
Déployer un cluster HDInsight et une base de données SQL

Déployer sur Azure
Ce modèle vous permet de créer un cluster HDInsight et un SQL Database pour tester Sqoop.
Exemple de point de terminaison privé

Déployer sur Azure
Ce modèle montre comment créer un point de terminaison privé pointant vers Azure SQL Server
Azure SQL Server avec audit écrit dans Event Hub

Déployer sur Azure
Ce modèle vous permet de déployer un serveur Azure SQL avec l’audit activé pour écrire des journaux d’audit dans Event Hub
Azure SQL Server avec l’audit écrit dans Log Analytics

Déployer sur Azure
Ce modèle vous permet de déployer un serveur Azure SQL avec l’audit activé pour écrire des journaux d’audit dans Log Analytics (espace de travail OMS)
Pool SQL dédié avec chiffrement transparent

Déployer sur Azure
Crée un SQL Server et un pool SQL dédié (anciennement SQL DW) avec Transparent Data Encryption.
Créer un SQL Server et une base de données

Déployer sur Azure
Ce modèle vous permet de créer SQL Database et serveur.
Approvisionner un SQL Database avec TDE

Déployer sur Azure
Ce modèle provisionne une SQL Server avec un pare-feu ouvert pour le trafic Azure et une base de données SQL avec Transparent Data Encryption (TDE).
Déployer un nouveau pool élastique SQL

Déployer sur Azure
Ce modèle vous permet de déployer un nouveau pool élastique SQL avec ses nouveaux SQL Server associés et de nouvelles bases de données SQL à lui affecter.
Créer des serveurs Azure SQL et une base de données avec un groupe de basculement

Déployer sur Azure
Crée deux serveurs Azure SQL, une base de données et un groupe de basculement.
App Service Environment avec Azure SQL back-end

Déployer sur Azure
Ce modèle crée une App Service Environment avec un back-end Azure SQL ainsi que des points de terminaison privés, ainsi que des ressources associées généralement utilisées dans un environnement privé/isolé.
Approvisionner une application mobile avec un SQL Database

Déployer sur Azure
Ce modèle provisionne une application mobile, un SQL Database et un hub de notification. Il configure un chaîne de connexion dans l’application mobile pour la base de données et le hub de notification.
Application web avec identité managée, SQL Server et ΑΙ

Déployer sur Azure
Exemple simple de déploiement de l’infrastructure Azure pour l’application + les données + l’identité managée + la supervision
Créer une application web + cache Redis + BASE de données SQL avec un modèle

Déployer sur Azure
Ce modèle crée une application web Azure avec un cache Redis et un SQL Database.
Approvisionner une application web avec un SQL Database

Déployer sur Azure
Ce modèle provisionne une application web, un SQL Database, des paramètres de mise à l’échelle automatique, des règles d’alerte et App Insights. Il configure une chaîne de connexion dans l’application web pour la base de données.
Créer, configurer et déployer une application web sur une machine virtuelle Azure

Déployer sur Azure
Créer et configurer une machine virtuelle Windows avec SQL Azure base de données et déployer une application web dans l’environnement à l’aide de PowerShell DSC
Application web Docker Sonarqube sur Linux avec Azure SQL

Déployer sur Azure
Ce modèle déploie Sonarqube dans un conteneur Linux d’application web Azure App Service à l’aide de l’image Sonarqube officielle et soutenu par un serveur Azure SQL.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource serveurs/bases de données peut être déployé avec des opérations qui ciblent :

  • Groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Sql/servers/databases, ajoutez le Terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/servers/databases@2023-02-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type =  "UserAssigned"
    identity_ids = []
  }
  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 = "decimal-as-string"
      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"
    }
  })
}

Valeurs de propriétés

servers/databases

Nom Description Valeur
type Type de ressource « Microsoft.Sql/servers/databases@2023-02-01-preview »
name Nom de la ressource string (obligatoire)

Limite de caractères : 1-128

Caractères valides :
Impossibilité d’utiliser :
<>*%&:\/? ou des caractères de contrôle.

Ne peut pas se terminer par un point ou un espace.
location Emplacement de la ressource. string (obligatoire)
parent_id ID de la ressource qui est le parent de cette ressource. ID pour la ressource de type : serveurs
tags Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes.
sku Référence SKU de base de données.

La liste des références SKU peut varier selon la région et l’offre de support. Pour déterminer les références SKU (y compris le nom de la référence SKU, le niveau/édition, la famille et la capacité) disponibles pour votre abonnement dans une région Azure, utilisez l’API Capabilities_ListByLocation REST ou l’une des commandes suivantes :

Azure CLI :
az sql db list-editions -l {location} -o table



Azure PowerShell :
Get-AzSqlServerServiceObjective -Location {location}

Sku
identité Identité Azure Active Directory de la base de données. DatabaseIdentity
properties Propriétés de ressource. DatabaseProperties

DatabaseIdentity

Nom Description Valeur
type Type d’identité « UserAssigned »
identity_ids ID de ressource des identités affectées par l’utilisateur à utiliser Tableau d’ID d’identité utilisateur.

DatabaseIdentityUserAssignedIdentities

Nom Description Valeur
{propriété personnalisée} DatabaseUserIdentity

DatabaseUserIdentity

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

DatabaseProperties

Nom Description Valeur
autoPauseDelay Durée en minutes après laquelle la base de données est automatiquement suspendue. La valeur -1 signifie que la pause automatique est désactivée int
availabilityZone Spécifie la zone de disponibilité à laquelle la base de données est épinglée. "1"
"2"
"3"
« NoPreference »
catalogCollation Classement du catalogue de métadonnées. « DATABASE_DEFAULT »
« SQL_Latin1_General_CP1_CI_AS »
collation Classement de la base de données. string
createMode Spécifie le mode de création de la base de données.

Valeur par défaut : création régulière de la base de données.

Copier : crée une base de données en tant que copie d’une base de données existante. sourceDatabaseId doit être spécifié en tant qu’ID de ressource de la base de données source.

Secondaire : crée une base de données en tant que réplica secondaire d’une base de données existante. sourceDatabaseId doit être spécifié en tant qu’ID de ressource de la base de données primaire existante.

PointInTimeRestore : crée une base de données en restaurant une sauvegarde dans le temps d’une base de données existante. sourceDatabaseId doit être spécifié en tant qu’ID de ressource de la base de données existante, et restorePointInTime doit être spécifié.

Récupération : crée une base de données en restaurant une sauvegarde géorépliquée. sourceDatabaseId doit être spécifié en tant qu’ID de ressource de base de données récupérable à restaurer.

Restaurer : crée une base de données en restaurant une sauvegarde d’une base de données supprimée. sourceDatabaseId doit être spécifié. Si sourceDatabaseId est l’ID de ressource d’origine de la base de données, sourceDatabaseDeletionDate doit être spécifié. Sinon, sourceDatabaseId doit être l’ID de ressource de base de données supprimée restaurable et sourceDatabaseDeletionDate est ignoré. restorePointInTime peut également être spécifié pour effectuer une restauration à partir d’un point antérieur dans le temps.

RestoreLongTermRetentionBackup : crée une base de données en restaurant à partir d’un coffre de rétention à long terme. recoveryServicesRecoveryPointResourceId doit être spécifié comme ID de ressource du point de récupération.

Copy, Secondary et RestoreLongTermRetentionBackup ne sont pas pris en charge pour l’édition DataWarehouse.
"Copy"
« Par défaut »
« OnlineSecondary »
« PointInTimeRestore »
« Récupération »
« Restaurer »
« RestoreExternalBackup »
« RestoreExternalBackupSecondary »
« RestoreLongTermRetentionBackup »
« Secondaire »
elasticPoolId Identificateur de ressource du pool élastique contenant cette base de données. string
encryptionProtector URI du coffre de clés Azure de la base de données s’il est configuré avec chaque clé gérée par le client de base de données. string
encryptionProtectorAutoRotation Indicateur permettant d’activer ou de désactiver la rotation automatique de la clé AKV du protecteur de chiffrement de base de données. bool
federatedClientId ID client utilisé pour le scénario CMK interlocataire par base de données string

Contraintes :
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
freeLimitExhaustionBehavior Spécifie le comportement lorsque les limites de gratuité mensuelles sont épuisées pour la base de données gratuite.

AutoPause : la base de données est automatiquement suspendue en cas d’épuisement des limites gratuites pendant le reste du mois.

BillForUsage : la base de données continuera d’être en ligne en cas d’épuisement des limites gratuites et tout dépassement sera facturé.
« AutoPause »
« BillOverUsage »
highAvailabilityReplicaCount Nombre de réplicas secondaires associés à la base de données qui sont utilisés pour fournir une haute disponibilité. Non applicable à une base de données Hyperscale au sein d’un pool élastique. int
isLedgerOn Indique si cette base de données est une base de données de registre, ce qui signifie que toutes les tables de la base de données sont des tables de registre. Remarque : la valeur de cette propriété ne peut pas être modifiée une fois la base de données créée. bool
clés ID de ressource des identités affectées par l’utilisateur à utiliser DatabasePropertiesKeys
licenseType Type de licence à appliquer pour cette base de données. LicenseIncludedsi vous avez besoin d’une licence, ou BasePrice si vous disposez d’une licence et que vous êtes éligible pour le Azure Hybrid Benefit. « BasePrice »
« LicenseIncluded »
longTermRetentionBackupResourceId Identificateur de ressource de la sauvegarde de rétention à long terme associée à l’opération de création de cette base de données. string
maintenanceConfigurationId ID de configuration de maintenance attribué à la base de données. Cette configuration définit la période pendant laquelle les mises à jour de maintenance se produisent. string
manualCutover Indique si le basculement manuel contrôlé par le client doit ou non être effectué pendant l’opération de mise à jour de la base de données au niveau Hyperscale.

Cette propriété s’applique uniquement lors de la mise à l’échelle de la base de données du niveau critique pour l'entreprise/usage général/Premium/Standard au niveau Hyperscale.

Lorsque manualCutover est spécifié, l’opération de mise à l’échelle attend que l’entrée utilisateur déclenche le basculement vers la base de données Hyperscale.

Pour déclencher le basculement, indiquez le paramètre « performCutover » lorsque l’opération de mise à l’échelle est en état d’attente.
bool
maxSizeBytes Taille maximale de la base de données exprimée en octets. int
minCapacité Capacité minimale que la base de données aura toujours allouée, si elle n’est pas suspendue Spécifiez une valeur décimale sous forme de chaîne. décimal int ou json
performCutover Pour déclencher le basculement manuel contrôlé par le client pendant l’état d’attente pendant que l’opération de mise à l’échelle est en cours.

Ce paramètre de propriété s’applique uniquement aux opérations de mise à l’échelle lancées avec le paramètre « manualCutover ».

Cette propriété s’applique uniquement lorsque la mise à l’échelle de la base de données du niveau critique pour l'entreprise/usage général/Premium/Standard vers le niveau Hyperscale est déjà en cours.

Lorsque performCutover est spécifié, l’opération de mise à l’échelle déclenche un basculement et effectue un changement de rôle vers la base de données Hyperscale.
bool
preferredEnclaveType Type d’enclave demandé sur la base de données, c’est-à-dire les enclaves par défaut ou VBS. « Par défaut »
« VBS »
readScale État du routage en lecture seule. Si cette option est activée, les connexions dont l’intention d’application est définie sur readonly dans leur chaîne de connexion peuvent être routées vers un réplica secondaire en lecture seule dans la même région. Non applicable à une base de données Hyperscale au sein d’un pool élastique. « Désactivé »
« Activé »
recoverableDatabaseId Identificateur de ressource de la base de données récupérable associée à l’opération de création de cette base de données. string
recoveryServicesRecoveryPointId Identificateur de ressource du point de récupération associé à l’opération de création de cette base de données. string
requestedBackupStorageRedundancy Type de compte de stockage à utiliser pour stocker les sauvegardes de cette base de données. « Géo »
« GeoZone »
« Local »
« Zone »
restorableDroppedDatabaseId Identificateur de ressource de la base de données supprimée restaurable associée à l’opération de création de cette base de données. string
restorePointInTime Spécifie le point dans le temps (format ISO8601) de la base de données source qui sera restaurée pour créer la nouvelle base de données. string
sampleName Nom de l’exemple de schéma à appliquer lors de la création de cette base de données. « AdventureWorksLT »
« WideWorldImportersFull »
« WideWorldImportersStd »
secondaryType Type secondaire de la base de données s’il s’agit d’une base de données secondaire. Les valeurs valides sont Geo, Named et Standby. « Geo »
« Nommé »
« Veille »
sourceDatabaseDeletionDate Spécifie l’heure à laquelle la base de données a été supprimée. string
sourceDatabaseId Identificateur de ressource de la base de données source associée à l’opération de création de cette base de données. string
sourceResourceId Identificateur de ressource de la source associée à l’opération de création de cette base de données.

Cette propriété est uniquement prise en charge pour l’édition DataWarehouse et permet de restaurer entre les abonnements.

Lorsque sourceResourceId est spécifié, sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId et sourceDatabaseDeletionDate ne doivent pas être spécifiés et CreateMode doit être PointInTimeRestore, Restore ou Recover.

Lorsque createMode a la valeur PointInTimeRestore, sourceResourceId doit être l’ID de ressource de la base de données existante ou du pool SQL existant, et restorePointInTime doit être spécifié.

Lorsque createMode a la valeur Restore, sourceResourceId doit être l’ID de ressource de la base de données supprimée restaurable ou du pool SQL supprimé pouvant être restauré.

Lorsque createMode a la valeur Recover, sourceResourceId doit être l’ID de ressource de la base de données récupérable ou du pool SQL récupérable.

Lorsque l’abonnement source appartient à un locataire différent de l’abonnement cible, l’en-tête « x-ms-authorization-auxiliary » doit contenir un jeton d’authentification pour le locataire source. Pour plus d’informations sur l’en-tête « x-ms-authorization-auxiliary », consultez /azure/azure-resource-manager/management/authenticate-multi-tenant
string
useFreeLimit Indique si la base de données utilise ou non des limites mensuelles gratuites. Autorisé sur une base de données d’un abonnement. bool
zoneRedundant Si cette base de données est redondante interzone ou non, les réplicas de cette base de données seront répartis sur plusieurs zones de disponibilité. bool

DatabasePropertiesKeys

Nom Description Valeur
{propriété personnalisée} DatabaseKey

DatabaseKey

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

Sku

Nom Description Valeur
capacité Capacité de la référence SKU particulière. int
famille Si le service a différentes générations de matériel, pour la même référence SKU, cela peut être capturé ici. string
name Nom de la référence SKU, généralement une lettre + un code numérique, par exemple P3. string (obligatoire)
taille Taille de la référence SKU particulière string
Niveau Niveau ou édition de la référence SKU particulière, par exemple De base, Premium. string