Microsoft.SQL-servers/databases

  • Artikel

Bicep-resourcedefinitie

Het resourcetype servers/databases kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie wijzigingenlogboek voor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een resource Microsoft.Sql/servers/databases wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

resource symbolicname 'Microsoft.Sql/servers/databases@2023-05-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
  }
}

Eigenschapswaarden

servers/databases

Naam Description Waarde
naam De resourcenaam

Meer informatie over het instellen van namen en typen voor onderliggende resources in Bicep.		 tekenreeks (vereist)

Tekenlimiet: 1-128

Geldige tekens:
Kan het volgende niet gebruiken:
<>*%&:\/? of besturingstekens

Kan niet eindigen met punt of spatie.
location Resourcelocatie. tekenreeks (vereist)
tags Resourcetags. Woordenlijst met tagnamen en -waarden. Tags in sjablonen bekijken
sku De database-SKU.

De lijst met SKU's kan verschillen per regio en ondersteuningsaanbieding. Gebruik Capabilities_ListByLocation de REST API of een van de volgende opdrachten om de SKU's (inclusief de SKU-naam, laag/editie, familie en capaciteit) te bepalen die beschikbaar zijn voor uw abonnement in een Azure-regio:

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



Azure PowerShell:
Get-AzSqlServerServiceObjective -Locatie {location}

 SKU
Bovenliggende In Bicep kunt u de bovenliggende resource voor een onderliggende resource opgeven. U hoeft deze eigenschap alleen toe te voegen wanneer de onderliggende resource buiten de bovenliggende resource wordt gedeclareerd.

Zie Onderliggende resource buiten bovenliggende resource voor meer informatie.		 Symbolische naam voor resource van het type: servers
identity De Azure Active Directory-identiteit van de database. DatabaseIdentity
properties Resource-eigenschappen. DatabaseEigenschappen

DatabaseIdentity

Naam Description Waarde
type Het identiteitstype 'Geen'
'UserAssigned'
userAssignedIdentities De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Naam Description Waarde
{aangepaste eigenschap} DatabaseUserIdentity

DatabaseUserIdentity

Dit object bevat geen eigenschappen die tijdens de implementatie moeten worden ingesteld. Alle eigenschappen zijn ReadOnly.

DatabaseEigenschappen

Naam Description Waarde
autoPauseDelay Tijd in minuten waarna de database automatisch wordt onderbroken. De waarde -1 betekent dat automatisch onderbreken is uitgeschakeld int
availabilityZone Hiermee geeft u de beschikbaarheidszone op waaraan de database is vastgemaakt. '1'
'2'
'3'
'NoPreference'
catalogCollation Sortering van de metagegevenscatalogus. 'DATABASE_DEFAULT'
'SQL_Latin1_General_CP1_CI_AS'
Sortering De sortering van de database. tekenreeks
createMode Hiermee geeft u de modus voor het maken van de database op.

Standaardinstelling: regelmatig database maken.

Kopiëren: hiermee maakt u een database als een kopie van een bestaande database. sourceDatabaseId moet worden opgegeven als de resource-id van de brondatabase.

Secundair: hiermee maakt u een database als een secundaire replica van een bestaande database. sourceDatabaseId moet worden opgegeven als de resource-id van de bestaande primaire database.

PointInTimeRestore: hiermee maakt u een database door een back-up naar een bepaald tijdstip van een bestaande database te herstellen. sourceDatabaseId moet worden opgegeven als de resource-id van de bestaande database en restorePointInTime moet worden opgegeven.

Herstel: hiermee maakt u een database door een geo-gerepliceerde back-up te herstellen. sourceDatabaseId moet worden opgegeven als de herstelbare databaseresource-id om te herstellen.

Herstellen: hiermee maakt u een database door een back-up van een verwijderde database te herstellen. sourceDatabaseId moet worden opgegeven. Als sourceDatabaseId de oorspronkelijke resource-id van de database is, moet sourceDatabaseDeletionDate worden opgegeven. Anders moet sourceDatabaseId de herstelbare verwijderde databaseresource-id zijn en moet sourceDatabaseDeletionDate worden genegeerd. restorePointInTime kan ook worden opgegeven om te herstellen vanaf een eerder tijdstip.

RestoreLongTermRetentionBackup: hiermee maakt u een database door te herstellen vanuit een langetermijnretentiekluis. recoveryServicesRecoveryPointResourceId moet worden opgegeven als de resource-id van het herstelpunt.

Copy, Secondary en RestoreLongTermRetentionBackup worden niet ondersteund voor de DataWarehouse-editie.		 'Kopiëren'
'Standaard'
'OnlineSecondary'
'PointInTimeRestore'
'Herstel'
'Herstellen'
'RestoreExternalBackup'
'RestoreExternalBackupSecondary'
'RestoreLongTermRetentionBackup'
'Secundair'
elasticPoolId De resource-id van de elastische pool die deze database bevat. tekenreeks
encryptionProtector De Azure Key Vault-URI van de database als deze is geconfigureerd met per database door de klant beheerde sleutels. tekenreeks
encryptionProtectorAutoRotation De vlag voor het in- of uitschakelen van automatische rotatie van de AKV-sleutel van de databaseversleutelingsbeveiliging. booleaans
federatedClientId De client-id die wordt gebruikt voor CMK-scenario voor meerdere tenants per database tekenreeks

Beperkingen:
Minimale lengte = 36
Maximale lengte = 36
Patroon = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
freeLimitExhaustionBehavior Hiermee geeft u het gedrag op wanneer maandelijkse gratis limieten zijn uitgeput voor de gratis database.

AutoPause: De database wordt automatisch onderbroken bij uitputting van de gratis limieten voor de rest van de maand.

BillForUsage: De database blijft online na uitputting van de gratis limieten en eventuele overschrijdingen worden gefactureerd.		 'AutoPause'
'BillOverUsage'
highAvailabilityReplicaCount Het aantal secundaire replica's dat aan de database is gekoppeld en dat wordt gebruikt om hoge beschikbaarheid te bieden. Niet van toepassing op een Hyperscale-database in een elastische pool. int
isLedgerOn Of deze database al dan niet een grootboekdatabase is, wat betekent dat alle tabellen in de database grootboektabellen zijn. Opmerking: de waarde van deze eigenschap kan niet worden gewijzigd nadat de database is gemaakt. booleaans
keys De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt DatabasePropertiesKeys
licenseType Het licentietype dat moet worden toegepast op deze database. LicenseIncludedals u een licentie nodig hebt of BasePrice als u een licentie hebt en in aanmerking komt voor de Azure Hybrid Benefit. 'Basisprijs'
'LicenseIncluded'
longTermRetentionBackupResourceId De resource-id van de langetermijnretentieback-up die is gekoppeld aan de maakbewerking van deze database. tekenreeks
maintenanceConfigurationId Onderhoudsconfiguratie-id die is toegewezen aan de database. Deze configuratie definieert de periode waarop de onderhoudsupdates worden uitgevoerd. tekenreeks
manualCutover Of door de klant beheerde handmatige cutover moet worden uitgevoerd tijdens de bewerking Database bijwerken naar de Hyperscale-laag.

Deze eigenschap is alleen van toepassing bij het schalen van database van Bedrijfskritiek/Algemeen/Premium/Standard-laag naar hyperscale-laag.

Wanneer manualCutover is opgegeven, wacht de schaalbewerking totdat de invoer van de gebruiker cutover naar de Hyperscale-database activeert.

Als u een cutover wilt activeren, geeft u de parameter performCutover op wanneer de schaalbewerking de status Wachtend heeft.		 booleaans
maxSizeBytes De maximale grootte van de database, uitgedrukt in bytes. int
minCapaciteit Minimale capaciteit die de database altijd heeft toegewezen, indien niet onderbroken Gebruik de functie json() om een decimale waarde op te geven. int of json decimaal
performCutover Door de klant beheerde handmatige cutover activeren tijdens de wachtstatus terwijl de schaalbewerking wordt uitgevoerd.

Deze eigenschapsparameter is alleen van toepassing op schaalbewerkingen die samen met de parameter manualCutover worden gestart.

Deze eigenschap is alleen van toepassing wanneer het schalen van de database van Bedrijfskritiek/Algemeen/Premium/Standard-laag naar hyperscale-laag al wordt uitgevoerd.

Wanneer performCutover is opgegeven, wordt met de schaalbewerking cutover geactiveerd en wordt een rolwijziging uitgevoerd in de Hyperscale-database.		 booleaans
preferredEnclaveType Type enclave dat is aangevraagd voor de database, bijvoorbeeld standaard- of VBS-enclaves. 'Standaard'
'VBS'
readScale De status van alleen-lezenroutering. Als deze optie is ingeschakeld, kunnen verbindingen waarvoor de toepassingsintentie is ingesteld op alleen-lezen in hun verbindingsreeks, worden doorgestuurd naar een alleen-lezen secundaire replica in dezelfde regio. Niet van toepassing op een Hyperscale-database binnen een elastische pool. 'Uitgeschakeld'
Ingeschakeld
recoverableDatabaseId De resource-id van de herstelbare database die is gekoppeld aan de maakbewerking van deze database. tekenreeks
recoveryServicesRecoveryPointId De resource-id van het herstelpunt dat is gekoppeld aan het maken van deze database. tekenreeks
requestedBackupStorageRedundancy Het type opslagaccount dat moet worden gebruikt voor het opslaan van back-ups voor deze database. 'Geo'
'GeoZone'
'Lokaal'
'Zone'
restorableDroppedDatabaseId De resource-id van de herstelbare verwijderde database die is gekoppeld aan de maakbewerking van deze database. tekenreeks
restorePointInTime Hiermee geeft u het tijdstip (ISO8601 indeling) op van de brondatabase die wordt hersteld om de nieuwe database te maken. tekenreeks
sampleName De naam van het voorbeeldschema dat moet worden toegepast bij het maken van deze database. 'AdventureWorksLT'
'WideWorldImportersFull'
'WideWorldImportersStd'
secondaryType Het secundaire type van de database als het een secundaire database is. Geldige waarden zijn Geo, Benoemd en Stand-by. 'Geo'
'Benoemd'
'Stand-by'
sourceDatabaseDeletionDate Hiermee geeft u de tijd op waarop de database is verwijderd. tekenreeks
sourceDatabaseId De resource-id van de brondatabase die is gekoppeld aan het maken van deze database. tekenreeks
sourceResourceId De resource-id van de bron die is gekoppeld aan de maakbewerking van deze database.

Deze eigenschap wordt alleen ondersteund voor de DataWarehouse-editie en maakt het mogelijk om verschillende abonnementen te herstellen.

Wanneer sourceResourceId is opgegeven, moeten sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId en sourceDatabaseDeletionDate niet worden opgegeven en moet CreateMode PointInTimeRestore, Restore of Recover zijn.

Wanneer createMode PointInTimeRestore is, moet sourceResourceId de resource-id van de bestaande database of bestaande SQL-pool zijn en moet restorePointInTime worden opgegeven.

Wanneer createMode Herstellen is, moet sourceResourceId de resource-id zijn van herstelbare verwijderde database of herstelbare verwijderde SQL-pool.

Wanneer createMode Herstellen is, moet sourceResourceId de resource-id zijn van de herstelbare database of herstelbare SQL-pool.

Wanneer het bronabonnement deel uitmaakt van een andere tenant dan het doelabonnement, moet de header x-ms-authorization-auxiliary verificatietoken voor de brontenant bevatten. Zie /azure/azure-resource-manager/management/authenticate-multi-tenant voor meer informatie over de header x-ms-authorization-auxiliary		 tekenreeks
useFreeLimit Of de database gratis maandelijkse limieten gebruikt. Toegestaan voor één database in een abonnement. booleaans
zoneRedundant Of deze database zoneredundant is of niet, wat betekent dat de replica's van deze database worden verdeeld over meerdere beschikbaarheidszones. booleaans

DatabaseEigenschappenSleutels

Naam Description Waarde
{aangepaste eigenschap} DatabaseKey

DatabaseKey

Dit object bevat geen eigenschappen die tijdens de implementatie moeten worden ingesteld. Alle eigenschappen zijn Alleen-lezen.

Sku

Naam Description Waarde
capacity Capaciteit van de specifieke SKU. int
gezin Als de service verschillende generaties hardware heeft, voor dezelfde SKU, kan dat hier worden vastgelegd. tekenreeks
naam De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3. tekenreeks (vereist)
grootte Grootte van de specifieke SKU tekenreeks
laag De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium. tekenreeks

Snelstartsjablonen

Met de volgende snelstartsjablonen wordt dit resourcetype geïmplementeerd.

Template Beschrijving
Django-app met SQL-databases

Implementeren op Azure		 Deze sjabloon maakt gebruik van de Azure Linux CustomScript-extensie om een toepassing te implementeren. In dit voorbeeld wordt een Ubuntu-VM gemaakt, python, Django en Apache op de achtergrond geïnstalleerd en vervolgens een eenvoudige Django-app gemaakt. De sjabloon maakt ook een SQL Database, met een voorbeeldtabel met enkele voorbeeldgegevens die worden weergegeven in de webbrowser met behulp van een query
EPiserverCMS in Azure

Implementeren op Azure		 Met deze sjabloon kunt u resources maken die vereist zijn voor de implementatie van EpiServerCMS in Azure
LANSA Windows VM ScaleSet automatisch schalen met Azure SQL Database

Implementeren op Azure		 Met de sjabloon wordt een Windows VMSS geïmplementeerd met een gewenst aantal VM's in de schaalset en een LANSA MSI die op elke VM moet worden geïnstalleerd. Zodra de VM-schaalset is geïmplementeerd, wordt een aangepaste scriptextensie gebruikt om de LANSA MSI te installeren)
Octopus Deploy 3.0 implementeren met een proeflicentie

Implementeren op Azure		 Met deze sjabloon kunt u één Octopus Deploy 3.0-server implementeren met een proeflicentie. Hiermee wordt geïmplementeerd op één Windows Server 2012R2-VM (Standard D2) en SQL DB (S1-laag) op de locatie die is opgegeven voor de resourcegroep.
Orchard CMS Video Portal Web App

Implementeren op Azure		 Deze sjabloon biedt een eenvoudige manier om Orchard CMS te implementeren op Azure App Service Web Apps met de Azure Media Services-module ingeschakeld en geconfigureerd.
Schaalbare Umbraco CMS-web-app

Implementeren op Azure		 Deze sjabloon biedt een eenvoudige manier om de umbraco CMS-web-app op Azure App Service Web Apps te implementeren.
Eenvoudige Umbraco CMS-web-app

Implementeren op Azure		 Deze sjabloon biedt een eenvoudige manier om de umbraco CMS-web-app op Azure App Service Web Apps te implementeren.
Enterprise Governance-AppService, SQL DB, AD, OMS, Runbooks

Implementeren op Azure		 Cloudacceptatie voor een onderneming, klein of groot, vereist verantwoorde en efficiënte governancemodellen om waarde te halen uit hun cloudimplementaties. CloudWise (een codenaam voor de oplossing), is een samengestelde oplossing die beschikbaar is via QuickStarts voor Azure-partners, is een acceptatie-enabler voor klanten, systeemintegrators en partners, die een selfservicebare, geautomatiseerde governance- en bewerkingsoplossing biedt, gericht op het optimaliseren van uw kosten, het verbeteren van de betrouwbaarheid van uw toepassing(en) en het verminderen van bedrijfsrisico's. De oplossing benadrukt de belangrijkste governancepijlers van zichtbaarheid en beheer.
eShop-website met ILB ASE

Implementeren op Azure		 Een App Service Environment is een Premium-serviceplanoptie van Azure App Service die een volledig geïsoleerde en toegewezen omgeving biedt voor het veilig uitvoeren van Azure App Service-apps op grote schaal, waaronder Web Apps, Mobile Apps en API-apps.
WebApp die een Azure SQL privé-eindpunt gebruikt

Implementeren op Azure		 Deze sjabloon laat zien hoe u een web-app maakt die een privé-eindpunt gebruikt dat verwijst naar Azure SQL Server
Extern bureaublad-services met hoge beschikbaarheid

Implementeren op Azure		 Met deze voorbeeldcode van een ARM-sjabloon wordt een sessieverzamelingslab voor Extern bureaublad-services 2019 geïmplementeerd met hoge beschikbaarheid. Het doel is het implementeren van een volledig redundante, maximaal beschikbare oplossing voor Extern bureaublad-services, met behulp van Windows Server 2019.
De Sports Analytics in Azure-architectuur implementeren

Implementeren op Azure		 Hiermee maakt u een Azure-opslagaccount waarvoor ADLS Gen 2 is ingeschakeld, een Azure Data Factory-exemplaar met gekoppelde services voor het opslagaccount (een Azure SQL Database indien geïmplementeerd) en een Azure Databricks-exemplaar. Aan de AAD-identiteit voor de gebruiker die de sjabloon implementeert en de beheerde identiteit voor het ADF-exemplaar wordt de rol Inzender voor opslagblobgegevens verleend voor het opslagaccount. Er zijn ook opties voor het implementeren van een Azure Key Vault-exemplaar, een Azure SQL Database en een Azure Event Hub (voor streaming-use cases). Wanneer een Azure Key Vault wordt geïmplementeerd, krijgen de beheerde identiteit van data factory en de AAD-identiteit voor de gebruiker die de sjabloon implementeert, de rol Key Vault Geheimengebruiker.
Web-app met een SQL Database, Azure Cosmos DB, Azure Search

Implementeren op Azure		 Deze sjabloon richt een web-app, een SQL Database, Azure Cosmos DB, Azure Search en Application Insights in.
Migreren naar Azure SQL database met behulp van Azure DMS

Implementeren op Azure		 De Azure Database Migration Service (DMS) is ontworpen om het proces van het migreren van on-premises databases naar Azure te stroomlijnen. DMS vereenvoudigt de migratie van bestaande on-premises SQL Server- en Oracle-databases naar Azure SQL Database-, Azure SQL Managed Instance- of Microsoft-SQL Server in een virtuele Azure-machine. Met deze sjabloon wordt een exemplaar van Azure Database Migration Service geïmplementeerd, een Azure-VM waarop sql-server is geïnstalleerd, die fungeert als een bronserver met een vooraf gemaakte database en een doel-Azure SQL DB-server met een vooraf gemaakt schema van de database die moet worden gemigreerd van de bronserver naar de doelserver. De sjabloon implementeert ook de vereiste resources, zoals NIC, vnet, enzovoort voor de ondersteuning van de bron-VM, DMS-service en doelserver.
HDInsight met aangepaste Ambari + Hive Metastore DB in VNET

Implementeren op Azure		 Met deze sjabloon kunt u een HDInsight-cluster maken in een bestaand virtueel netwerk met een nieuwe SQL-database die fungeert als zowel een aangepaste Ambari-database als een Hive-metastore. U moet een bestaande SQL-server, opslagaccount en VNET hebben.
Een HDInsight-cluster en een SQL-database implementeren

Implementeren op Azure		 Met deze sjabloon kunt u een HDInsight-cluster en een SQL Database maken voor het testen van Sqoop.
Voorbeeld van privé-eindpunt

Implementeren op Azure		 Deze sjabloon laat zien hoe u een privé-eindpunt maakt dat verwijst naar Azure SQL Server
Azure SQL Server met controle geschreven naar Event Hub

Implementeren op Azure		 Met deze sjabloon kunt u een Azure SQL server implementeren waarvoor Controle is ingeschakeld om auditlogboeken naar Event Hub te schrijven
Azure SQL Server met controle geschreven naar Log Analytics

Implementeren op Azure		 Met deze sjabloon kunt u een Azure SQL server implementeren waarvoor controle is ingeschakeld om auditlogboeken naar Log Analytics (OMS-werkruimte) te schrijven
Toegewezen SQL-pool met transparante versleuteling

Implementeren op Azure		 Hiermee maakt u een SQL Server en een toegewezen SQL-pool (voorheen SQL DW) met Transparent Data Encryption.
Een SQL Server en database maken

Implementeren op Azure		 Met deze sjabloon kunt u SQL Database en server maken.
Een SQL Database inrichten met TDE

Implementeren op Azure		 Met deze sjabloon wordt een SQL Server met een firewall geopend voor Azure-verkeer en een SQL-database met Transparent Data Encryption (TDE).
Een nieuwe elastische SQL-pool implementeren

Implementeren op Azure		 Met deze sjabloon kunt u een nieuwe elastische SQL-pool implementeren met de nieuwe gekoppelde SQL Server en nieuwe SQL-databases die u eraan kunt toewijzen.
Azure SQL servers en database maken met failovergroep

Implementeren op Azure		 Hiermee maakt u twee Azure SQL servers, een database en een failovergroep.
App Service Environment met Azure SQL back-end

Implementeren op Azure		 Met deze sjabloon maakt u een App Service Environment met een Azure SQL back-end, samen met privé-eindpunten en bijbehorende resources die doorgaans worden gebruikt in een privé-/geïsoleerde omgeving.
Een mobiele app inrichten met een SQL Database

Implementeren op Azure		 Deze sjabloon richt een mobiele app, SQL Database en Notification Hub in. Hiermee configureert u een verbindingsreeks in de mobiele app voor de database en notification hub.
Web-app met beheerde identiteit, SQL Server en ΑΙ

Implementeren op Azure		 Eenvoudig voorbeeld voor het implementeren van een Azure-infrastructuur voor app + gegevens + beheerde identiteit + bewaking
Een web-app + Redis-cache + SQL DB maken met een sjabloon

Implementeren op Azure		 Met deze sjabloon maakt u een Azure-web-app met Redis-cache en een SQL Database.
Een web-app inrichten met een SQL Database

Implementeren op Azure		 Deze sjabloon richt een web-app, een SQL Database, instellingen voor automatisch schalen, waarschuwingsregels en App Insights in. Hiermee configureert u een verbindingsreeks in de web-app voor de database.
Webtoepassing maken, configureren en implementeren op een Azure-VM

Implementeren op Azure		 Een Virtuele Windows-machine met SQL Azure-database maken en configureren en een webtoepassing implementeren in de omgeving met behulp van PowerShell DSC
Sonarqube Docker-web-app in Linux met Azure SQL

Implementeren op Azure		 Met deze sjabloon wordt Sonarqube geïmplementeerd in een Azure App Service Web App Linux-container met behulp van de officiële Sonarqube-installatiekopieën en ondersteund door een Azure SQL Server.

Resourcedefinitie van ARM-sjabloon

Het resourcetype servers/databases kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie wijzigingenlogboek voor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een resource Microsoft.Sql/servers/databases wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

{
  "type": "Microsoft.Sql/servers/databases",
  "apiVersion": "2023-05-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"
  }
}

Eigenschapswaarden

servers/databases

Naam Description Waarde
type Het resourcetype 'Microsoft.Sql/servers/databases'
apiVersion De resource-API-versie '2023-05-01-preview'
naam De resourcenaam

Meer informatie over het instellen van namen en typen voor onderliggende resources in JSON ARM-sjablonen.		 tekenreeks (vereist)

Tekenlimiet: 1-128

Geldige tekens:
Kan het volgende niet gebruiken:
<>*%&:\/? of besturingstekens

Kan niet eindigen met punt of spatie.
location Resourcelocatie. tekenreeks (vereist)
tags Resourcetags. Woordenlijst met tagnamen en -waarden. Tags in sjablonen bekijken
sku De database-SKU.

De lijst met SKU's kan verschillen per regio en ondersteuningsaanbieding. Gebruik Capabilities_ListByLocation de REST API of een van de volgende opdrachten om de SKU's (inclusief de SKU-naam, laag/editie, familie en capaciteit) te bepalen die beschikbaar zijn voor uw abonnement in een Azure-regio:

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



Azure PowerShell:
Get-AzSqlServerServiceObjective -Locatie {location}

 SKU
identity De Azure Active Directory-identiteit van de database. DatabaseIdentity
properties Resource-eigenschappen. DatabaseEigenschappen

DatabaseIdentity

Naam Description Waarde
type Het identiteitstype 'Geen'
'UserAssigned'
userAssignedIdentities De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Naam Description Waarde
{aangepaste eigenschap} DatabaseUserIdentity

DatabaseUserIdentity

Dit object bevat geen eigenschappen die tijdens de implementatie moeten worden ingesteld. Alle eigenschappen zijn ReadOnly.

DatabaseEigenschappen

Naam Description Waarde
autoPauseDelay Tijd in minuten waarna de database automatisch wordt onderbroken. De waarde -1 betekent dat automatisch onderbreken is uitgeschakeld int
availabilityZone Hiermee geeft u de beschikbaarheidszone op waaraan de database is vastgemaakt. '1'
'2'
'3'
'NoPreference'
catalogCollation Sortering van de metagegevenscatalogus. 'DATABASE_DEFAULT'
'SQL_Latin1_General_CP1_CI_AS'
Sortering De sortering van de database. tekenreeks
createMode Hiermee geeft u de modus voor het maken van de database op.

Standaardinstelling: regelmatig database maken.

Kopiëren: hiermee maakt u een database als een kopie van een bestaande database. sourceDatabaseId moet worden opgegeven als de resource-id van de brondatabase.

Secundair: hiermee maakt u een database als een secundaire replica van een bestaande database. sourceDatabaseId moet worden opgegeven als de resource-id van de bestaande primaire database.

PointInTimeRestore: hiermee maakt u een database door een back-up naar een bepaald tijdstip van een bestaande database te herstellen. sourceDatabaseId moet worden opgegeven als de resource-id van de bestaande database en restorePointInTime moet worden opgegeven.

Herstel: Hiermee maakt u een database door een geo-gerepliceerde back-up te herstellen. sourceDatabaseId moet worden opgegeven als de herstelbare databaseresource-id om te herstellen.

Herstellen: hiermee maakt u een database door een back-up van een verwijderde database te herstellen. sourceDatabaseId moet worden opgegeven. Als sourceDatabaseId de oorspronkelijke resource-id van de database is, moet sourceDatabaseDeletionDate worden opgegeven. Anders moet sourceDatabaseId de herstelbare verwijderde databaseresource-id zijn en wordt sourceDatabaseDeletionDate genegeerd. restorePointInTime kan ook worden opgegeven om te herstellen vanaf een eerder tijdstip.

RestoreLongTermRetentionBackup: hiermee maakt u een database door te herstellen vanuit een kluis voor langetermijnretentie. recoveryServicesRecoveryPointResourceId moet worden opgegeven als de resource-id van het herstelpunt.

Copy, Secondary en RestoreLongTermRetentionBackup worden niet ondersteund voor de DataWarehouse-editie.		 'Kopiëren'
'Standaard'
'OnlineSecondary'
'PointInTimeRestore'
'Herstel'
'Herstellen'
'RestoreExternalBackup'
'RestoreExternalBackupSecondary'
'RestoreLongTermRetentionBackup'
'Secundair'
elasticPoolId De resource-id van de elastische pool die deze database bevat. tekenreeks
encryptionProtector De Azure Key Vault-URI van de database als deze is geconfigureerd met per database door de klant beheerde sleutels. tekenreeks
encryptionProtectorAutoRotation De vlag om automatische rotatie van de AKV-sleutel van de databaseversleutelingsbeveiliging in of uit te schakelen. booleaans
federatedClientId De client-id die wordt gebruikt voor CMK-scenario voor meerdere tenants per database tekenreeks

Beperkingen:
Minimale lengte = 36
Maximale lengte = 36
Patroon = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
freeLimitExhaustionBehavior Hiermee geeft u het gedrag op wanneer maandelijkse gratis limieten zijn uitgeput voor de gratis database.

AutoPause: de database wordt automatisch onderbroken wanneer de gratis limieten voor de rest van de maand zijn uitgeput.

BillForUsage: De database blijft online bij uitputting van de gratis limieten en eventuele overschrijding wordt gefactureerd.		 'AutoPause'
'BillOverUsage'
highAvailabilityReplicaCount Het aantal secundaire replica's dat is gekoppeld aan de database die wordt gebruikt om hoge beschikbaarheid te bieden. Niet van toepassing op een Hyperscale-database binnen een elastische pool. int
isLedgerOn Of deze database al dan niet een grootboekdatabase is, wat betekent dat alle tabellen in de database grootboektabellen zijn. Opmerking: de waarde van deze eigenschap kan niet worden gewijzigd nadat de database is gemaakt. booleaans
keys De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt DatabaseEigenschappenSleutels
licenseType Het licentietype dat moet worden aangevraagd voor deze database. LicenseIncludedals u een licentie nodig hebt of BasePrice als u een licentie hebt en in aanmerking komt voor de Azure Hybrid Benefit. 'Basisprijs'
'LicenseIncluded'
longTermRetentionBackupResourceId De resource-id van de langetermijnretentieback-up die is gekoppeld aan de maakbewerking van deze database. tekenreeks
maintenanceConfigurationId Onderhoudsconfiguratie-id die is toegewezen aan de database. Deze configuratie definieert de periode waarin de onderhoudsupdates worden uitgevoerd. tekenreeks
manualCutover Of door de klant beheerde handmatige cutover moet worden uitgevoerd tijdens de bewerking Database bijwerken naar hyperscale-laag.

Deze eigenschap is alleen van toepassing bij het schalen van database van Bedrijfskritiek/Algemeen/Premium/Standard-laag naar hyperscale-laag.

Wanneer manualCutover is opgegeven, wacht de schaalbewerking totdat de invoer van de gebruiker cutover naar de Hyperscale-database activeert.

Als u cutover wilt activeren, geeft u de parameter performCutover op wanneer de schaalbewerking de status Wachten heeft.		 booleaans
maxSizeBytes De maximale grootte van de database, uitgedrukt in bytes. int
minCapacity Minimale capaciteit die de database altijd heeft toegewezen, indien niet onderbroken Als u een decimale waarde wilt opgeven, gebruikt u de functie json(). int of json decimaal
performCutover Door de klant beheerde handmatige cutover activeren tijdens de wachtstatus terwijl de schaalbewerking wordt uitgevoerd.

Deze eigenschapsparameter is alleen van toepassing op schaalbewerkingen die samen met de parameter manualCutover worden gestart.

Deze eigenschap is alleen van toepassing wanneer het schalen van de database van Bedrijfskritiek/Algemeen/Premium/Standard-laag naar hyperscale-laag al wordt uitgevoerd.

Wanneer performCutover is opgegeven, wordt met de schaalbewerking cutover geactiveerd en wordt een rolwijziging uitgevoerd in de Hyperscale-database.		 booleaans
preferredEnclaveType Type enclave dat is aangevraagd voor de database, bijvoorbeeld standaard- of VBS-enclaves. 'Standaard'
'VBS'
readScale De status van alleen-lezenroutering. Als deze optie is ingeschakeld, kunnen verbindingen waarvoor de toepassingsintentie is ingesteld op alleen-lezen in hun verbindingsreeks, worden doorgestuurd naar een alleen-lezen secundaire replica in dezelfde regio. Niet van toepassing op een Hyperscale-database binnen een elastische pool. 'Uitgeschakeld'
Ingeschakeld
recoverableDatabaseId De resource-id van de herstelbare database die is gekoppeld aan de maakbewerking van deze database. tekenreeks
recoveryServicesRecoveryPointId De resource-id van het herstelpunt dat is gekoppeld aan de maakbewerking van deze database. tekenreeks
requestedBackupStorageRedundancy Het opslagaccounttype dat moet worden gebruikt voor het opslaan van back-ups voor deze database. 'Geo'
'GeoZone'
'Lokaal'
Zone
restorableDroppedDatabaseId De resource-id van de herstelbare verwijderde database die is gekoppeld aan de maakbewerking van deze database. tekenreeks
restorePointInTime Hiermee geeft u het tijdstip (ISO8601 indeling) op van de brondatabase die wordt hersteld om de nieuwe database te maken. tekenreeks
sampleName De naam van het voorbeeldschema dat moet worden toegepast bij het maken van deze database. 'AdventureWorksLT'
'WideWorldImportersFull'
'WideWorldImportersStd'
secondaryType Het secundaire type van de database als het een secundaire database is. Geldige waarden zijn Geo, Benoemd en Stand-by. 'Geo'
'Benoemd'
'Stand-by'
sourceDatabaseDeletionDate Hiermee geeft u het tijdstip op waarop de database is verwijderd. tekenreeks
sourceDatabaseId De resource-id van de brondatabase die is gekoppeld aan de maakbewerking van deze database. tekenreeks
sourceResourceId De resource-id van de bron die is gekoppeld aan de maakbewerking van deze database.

Deze eigenschap wordt alleen ondersteund voor de DataWarehouse-editie en maakt het mogelijk om verschillende abonnementen te herstellen.

Wanneer sourceResourceId is opgegeven, moeten sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId en sourceDatabaseDeletionDate niet worden opgegeven en moet CreateMode PointInTimeRestore, Restore of Recover zijn.

Wanneer createMode PointInTimeRestore is, moet sourceResourceId de resource-id van de bestaande database of bestaande SQL-pool zijn en moet restorePointInTime worden opgegeven.

Wanneer createMode Herstellen is, moet sourceResourceId de resource-id zijn van herstelbare verwijderde database of herstelbare verwijderde SQL-pool.

Wanneer createMode Herstellen is, moet sourceResourceId de resource-id zijn van de herstelbare database of herstelbare SQL-pool.

Wanneer het bronabonnement tot een andere tenant behoort dan het doelabonnement, moet de header x-ms-authorization-auxiliary verificatietoken voor de brontenant bevatten. Zie /azure/azure-resource-manager/management/authenticate-multi-tenant voor meer informatie over de header x-ms-authorization-auxiliary		 tekenreeks
useFreeLimit Of de database gratis maandelijkse limieten gebruikt. Toegestaan voor één database in een abonnement. booleaans
zoneRedundant Of deze database zone-redundant is of niet, wat betekent dat de replica's van deze database worden verdeeld over meerdere beschikbaarheidszones. booleaans

DatabasePropertiesKeys

Naam Description Waarde
{aangepaste eigenschap} DatabaseKey

DatabaseKey

Dit object bevat geen eigenschappen die tijdens de implementatie moeten worden ingesteld. Alle eigenschappen zijn ReadOnly.

Sku

Naam Description Waarde
capacity Capaciteit van de specifieke SKU. int
gezin Als de service verschillende generaties hardware voor dezelfde SKU heeft, kan die hier worden vastgelegd. tekenreeks
naam De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3. tekenreeks (vereist)
grootte Grootte van de specifieke SKU tekenreeks
laag De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium. tekenreeks

Snelstartsjablonen

Met de volgende quickstart-sjablonen wordt dit resourcetype geïmplementeerd.

Template Beschrijving
Django-app met SQL-databases

Implementeren op Azure		 Deze sjabloon maakt gebruik van de Azure Linux CustomScript-extensie om een toepassing te implementeren. In dit voorbeeld wordt een Ubuntu-VM gemaakt, python, Django en Apache op de achtergrond geïnstalleerd en vervolgens een eenvoudige Django-app gemaakt. De sjabloon maakt ook een SQL Database, met een voorbeeldtabel met enkele voorbeeldgegevens die worden weergegeven in de webbrowser met behulp van een query
EPiserverCMS in Azure

Implementeren op Azure		 Met deze sjabloon kunt u resources maken die vereist zijn voor de implementatie van EpiServerCMS in Azure
LANSA Windows VM ScaleSet automatisch schalen met Azure SQL Database

Implementeren op Azure		 Met de sjabloon wordt een Windows VMSS geïmplementeerd met een gewenst aantal VM's in de schaalset en een LANSA MSI die op elke VM moet worden geïnstalleerd. Zodra de VM-schaalset is geïmplementeerd, wordt een aangepaste scriptextensie gebruikt om de LANSA MSI te installeren)
Octopus Deploy 3.0 implementeren met een proeflicentie

Implementeren op Azure		 Met deze sjabloon kunt u één Octopus Deploy 3.0-server implementeren met een proeflicentie. Hiermee wordt geïmplementeerd op één Windows Server 2012R2-VM (Standard D2) en SQL DB (S1-laag) op de locatie die is opgegeven voor de resourcegroep.
Orchard CMS Video Portal Web App

Implementeren op Azure		 Deze sjabloon biedt een eenvoudige manier om Orchard CMS te implementeren op Azure App Service Web Apps met de Azure Media Services-module ingeschakeld en geconfigureerd.
Schaalbare Umbraco CMS-web-app

Implementeren op Azure		 Deze sjabloon biedt een eenvoudige manier om umbraco CMS-web-app op Azure App Service Web Apps te implementeren.
Eenvoudige Umbraco CMS-web-app

Implementeren op Azure		 Deze sjabloon biedt een eenvoudige manier om umbraco CMS-web-app op Azure App Service Web Apps te implementeren.
Enterprise Governance-AppService, SQL DB, AD, OMS, Runbooks

Implementeren op Azure		 Cloudacceptatie voor een onderneming, klein of groot, vereist verantwoorde en efficiënte governancemodellen om waarde te ontlenen aan hun cloudimplementaties. CloudWise (een codenaam voor de oplossing), een samengestelde oplossing die beschikbaar is via QuickStarts van Azure-partners, is een acceptatie-enabler voor klanten, systeemintegrators en partners, die een zelfservicebare, geautomatiseerde governance- en bewerkingsoplossing biedt, gericht op het optimaliseren van uw kosten, het verbeteren van de betrouwbaarheid van uw toepassing(en) en het verminderen van bedrijfsrisico's. De oplossing markeert de belangrijkste governancepijlers van zichtbaarheid en beheer.
eShop-website met ILB ASE

Implementeren op Azure		 Een App Service Environment is een Premium-serviceabonnement van Azure App Service die een volledig geïsoleerde en toegewezen omgeving biedt voor het veilig uitvoeren van Azure App Service apps op grote schaal, waaronder Web Apps, Mobile Apps en API-apps.
WebApp gebruikt een Azure SQL privé-eindpunt

Implementeren op Azure		 Deze sjabloon laat zien hoe u een web-app maakt die gebruikmaakt van een privé-eindpunt dat verwijst naar Azure SQL Server
Extern bureaublad-services met hoge beschikbaarheid

Implementeren op Azure		 Met deze voorbeeldcode van een ARM-sjabloon wordt een sessieverzamelingslab voor Extern bureaublad-services 2019 geïmplementeerd met hoge beschikbaarheid. Het doel is om een volledig redundante, maximaal beschikbare oplossing voor Extern bureaublad-services te implementeren met behulp van Windows Server 2019.
Sportanalyse implementeren in Azure-architectuur

Implementeren op Azure		 Hiermee maakt u een Azure-opslagaccount waarvoor ADLS Gen 2 is ingeschakeld, een Azure Data Factory-exemplaar met gekoppelde services voor het opslagaccount (een Azure SQL Database indien geïmplementeerd) en een Azure Databricks-exemplaar. Aan de AAD-identiteit voor de gebruiker die de sjabloon implementeert en de beheerde identiteit voor het ADF-exemplaar wordt de rol Bijdrager voor opslagblobgegevens toegewezen voor het opslagaccount. Er zijn ook opties voor het implementeren van een Azure Key Vault-exemplaar, een Azure SQL Database en een Azure Event Hub (voor gebruiksvoorbeelden voor streaming). Wanneer een Azure Key Vault wordt geïmplementeerd, krijgen de beheerde identiteit van data factory en de AAD-identiteit voor de gebruiker die de sjabloon implementeert, de rol Key Vault geheimengebruiker.
Web-app met een SQL Database, Azure Cosmos DB, Azure Search

Implementeren op Azure		 Met deze sjabloon richt u een web-app, een SQL Database, Azure Cosmos DB, Azure Search en Application Insights in.
Migreren naar Azure SQL database met behulp van Azure DMS

Implementeren op Azure		 De Azure Database Migration Service (DMS) is ontworpen om het proces van het migreren van on-premises databases naar Azure te stroomlijnen. DMS vereenvoudigt de migratie van bestaande on-premises SQL Server- en Oracle-databases naar Azure SQL Database, Azure SQL Managed Instance of Microsoft SQL Server in een virtuele Azure-machine. Met deze sjabloon wordt een exemplaar van Azure Database Migration Service geïmplementeerd, een Azure-VM waarop sql-server is geïnstalleerd. Deze fungeert als een bronserver met een vooraf gemaakte database en een doelserver Azure SQL DB-server met een vooraf gemaakt schema van de database die moet worden gemigreerd van de bron-naar-doelserver. Met de sjabloon worden ook de vereiste resources geïmplementeerd, zoals NIC, vnet, enzovoort voor de ondersteuning van de bron-VM, DMS-service en doelserver.
HDInsight met aangepaste Ambari + Hive Metastore DB in VNET

Implementeren op Azure		 Met deze sjabloon kunt u een HDInsight-cluster maken in een bestaand virtueel netwerk met een nieuwe SQL-database die fungeert als zowel een aangepaste Ambari-database als een Hive-metastore. U moet een bestaande SQL-server, een opslagaccount en een bestaand VNET hebben.
Een HDInsight-cluster en een SQL-database implementeren

Implementeren op Azure		 Met deze sjabloon kunt u een HDInsight-cluster en een SQL Database maken voor het testen van Sqoop.
Voorbeeld van privé-eindpunt

Implementeren op Azure		 Deze sjabloon laat zien hoe u een privé-eindpunt maakt dat verwijst naar Azure SQL Server
Azure SQL server met controle geschreven naar Event Hub

Implementeren op Azure		 Met deze sjabloon kunt u een Azure SQL server implementeren waarvoor Controle is ingeschakeld om auditlogboeken naar Event Hub te schrijven
Azure SQL Server met controle geschreven naar Log Analytics

Implementeren op Azure		 Met deze sjabloon kunt u een Azure SQL server implementeren met controle ingeschakeld om auditlogboeken te schrijven naar Log Analytics (OMS-werkruimte)
Toegewezen SQL-pool met transparante versleuteling

Implementeren op Azure		 Hiermee maakt u een SQL Server en een toegewezen SQL-pool (voorheen SQL DW) met Transparent Data Encryption.
Een SQL Server en database maken

Implementeren op Azure		 Met deze sjabloon kunt u SQL Database en server maken.
Een SQL Database inrichten met TDE

Implementeren op Azure		 Met deze sjabloon wordt een SQL Server met een firewall geopend voor Azure-verkeer en een SQL-database met Transparent Data Encryption (TDE).
Een nieuwe elastische SQL-pool implementeren

Implementeren op Azure		 Met deze sjabloon kunt u een nieuwe elastische SQL-pool implementeren met de bijbehorende nieuwe gekoppelde SQL Server en nieuwe SQL-databases om eraan toe te wijzen.
Azure SQL servers en database maken met failovergroep

Implementeren op Azure		 Hiermee maakt u twee Azure SQL servers, een database en een failovergroep.
App Service Environment met Azure SQL back-end

Implementeren op Azure		 Met deze sjabloon maakt u een App Service Environment met een Azure SQL back-end, samen met privé-eindpunten, samen met gekoppelde resources die doorgaans worden gebruikt in een privé-/geïsoleerde omgeving.
Een mobiele app inrichten met een SQL Database

Implementeren op Azure		 Deze sjabloon richt een mobiele app, SQL Database en Notification Hub in. Hiermee configureert u een verbindingsreeks in de mobiele app voor de database en notification hub.
Web-app met beheerde identiteit, SQL Server en ΑΙ

Implementeren op Azure		 Eenvoudig voorbeeld voor het implementeren van Een Azure-infrastructuur voor app + gegevens + beheerde identiteit + bewaking
Een web-app + Redis-cache + SQL-database maken met een sjabloon

Implementeren op Azure		 Met deze sjabloon maakt u een Azure-web-app met Redis-cache en een SQL Database.
Een web-app inrichten met een SQL Database

Implementeren op Azure		 Deze sjabloon richt een web-app, een SQL Database, instellingen voor automatisch schalen, waarschuwingsregels en App Insights in. Hiermee configureert u een verbindingsreeks in de web-app voor de database.
Webtoepassing maken, configureren en implementeren op een Azure-VM

Implementeren op Azure		 Een Virtuele Windows-machine maken en configureren met SQL Azure database en webtoepassing implementeren in de omgeving met behulp van PowerShell DSC
Sonarqube Docker-web-app in Linux met Azure SQL

Implementeren op Azure		 Met deze sjabloon wordt Sonarqube geïmplementeerd in een Linux-container van Azure App Service web-app met behulp van de officiële Sonarqube-installatiekopieën en ondersteund door een Azure SQL Server.

Terraform-resourcedefinitie (AzAPI-provider)

Het resourcetype servers/databases kan worden geïmplementeerd met bewerkingen die zijn gericht op:

  • Resourcegroepen

Zie wijzigingenlogboek voor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource Microsoft.Sql/servers/databases wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/servers/databases@2023-05-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"
    }
  })
}

Eigenschapswaarden

servers/databases

Naam Description Waarde
type Het resourcetype "Microsoft.Sql/servers/databases@2023-05-01-preview"
naam De resourcenaam tekenreeks (vereist)

Tekenlimiet: 1-128

Geldige tekens:
Kan het volgende niet gebruiken:
<>*%&:\/? of besturingstekens

Kan niet eindigen met punt of spatie.
location Resourcelocatie. tekenreeks (vereist)
parent_id De id van de resource die het bovenliggende item voor deze resource is. Id voor resource van het type: servers
tags Resourcetags. Woordenlijst met tagnamen en -waarden.
sku De database-SKU.

De lijst met SKU's kan verschillen per regio en ondersteuningsaanbieding. Gebruik Capabilities_ListByLocation de REST API of een van de volgende opdrachten om de SKU's (inclusief de SKU-naam, laag/editie, familie en capaciteit) te bepalen die beschikbaar zijn voor uw abonnement in een Azure-regio:

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



Azure PowerShell:
Get-AzSqlServerServiceObjective -Locatie {location}

 SKU
identity De Azure Active Directory-identiteit van de database. DatabaseIdentity
properties Resource-eigenschappen. DatabaseEigenschappen

DatabaseIdentity

Naam Description Waarde
type Het identiteitstype "UserAssigned"
identity_ids De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt Matrix met gebruikersidentiteits-id's.

DatabaseIdentityUserAssignedIdentities

Naam Description Waarde
{aangepaste eigenschap} DatabaseUserIdentity

DatabaseUserIdentity

Dit object bevat geen eigenschappen die tijdens de implementatie moeten worden ingesteld. Alle eigenschappen zijn ReadOnly.

DatabaseEigenschappen

Naam Description Waarde
autoPauseDelay Tijd in minuten waarna de database automatisch wordt onderbroken. De waarde -1 betekent dat automatisch onderbreken is uitgeschakeld int
availabilityZone Hiermee geeft u de beschikbaarheidszone op waaraan de database is vastgemaakt. '1'
"2"
"3"
"NoPreference"
catalogCollation Sortering van de metagegevenscatalogus. "DATABASE_DEFAULT"
"SQL_Latin1_General_CP1_CI_AS"
Sortering De sortering van de database. tekenreeks
createMode Hiermee geeft u de modus voor het maken van de database op.

Standaardinstelling: regelmatig database maken.

Kopiëren: hiermee maakt u een database als een kopie van een bestaande database. sourceDatabaseId moet worden opgegeven als de resource-id van de brondatabase.

Secundair: hiermee maakt u een database als een secundaire replica van een bestaande database. sourceDatabaseId moet worden opgegeven als de resource-id van de bestaande primaire database.

PointInTimeRestore: hiermee maakt u een database door een back-up naar een bepaald tijdstip van een bestaande database te herstellen. sourceDatabaseId moet worden opgegeven als de resource-id van de bestaande database en restorePointInTime moet worden opgegeven.

Herstel: hiermee maakt u een database door een geo-gerepliceerde back-up te herstellen. sourceDatabaseId moet worden opgegeven als de herstelbare databaseresource-id om te herstellen.

Herstellen: hiermee maakt u een database door een back-up van een verwijderde database te herstellen. sourceDatabaseId moet worden opgegeven. Als sourceDatabaseId de oorspronkelijke resource-id van de database is, moet sourceDatabaseDeletionDate worden opgegeven. Anders moet sourceDatabaseId de herstelbare verwijderde databaseresource-id zijn en moet sourceDatabaseDeletionDate worden genegeerd. restorePointInTime kan ook worden opgegeven om te herstellen vanaf een eerder tijdstip.

RestoreLongTermRetentionBackup: hiermee maakt u een database door te herstellen vanuit een langetermijnretentiekluis. recoveryServicesRecoveryPointResourceId moet worden opgegeven als de resource-id van het herstelpunt.

Copy, Secondary en RestoreLongTermRetentionBackup worden niet ondersteund voor de DataWarehouse-editie.		 "Kopiëren"
"Standaard"
"OnlineSecondary"
"PointInTimeRestore"
"Herstel"
"Herstellen"
"RestoreExternalBackup"
"RestoreExternalBackupSecondary"
"RestoreLongTermRetentionBackup"
"Secundair"
elasticPoolId De resource-id van de elastische pool die deze database bevat. tekenreeks
encryptionProtector De Azure Key Vault-URI van de database als deze is geconfigureerd met per database door de klant beheerde sleutels. tekenreeks
encryptionProtectorAutoRotation De vlag om automatische rotatie van de AKV-sleutel van de databaseversleutelingsbeveiliging in of uit te schakelen. booleaans
federatedClientId De client-id die wordt gebruikt voor CMK-scenario voor meerdere tenants per database tekenreeks

Beperkingen:
Minimale lengte = 36
Maximale lengte = 36
Patroon = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
freeLimitExhaustionBehavior Hiermee geeft u het gedrag op wanneer maandelijkse gratis limieten zijn uitgeput voor de gratis database.

AutoPause: de database wordt automatisch onderbroken wanneer de gratis limieten voor de rest van de maand zijn uitgeput.

BillForUsage: De database blijft online bij uitputting van de gratis limieten en eventuele overschrijding wordt gefactureerd.		 "AutoPause"
"BillOverUsage"
highAvailabilityReplicaCount Het aantal secundaire replica's dat is gekoppeld aan de database die wordt gebruikt om hoge beschikbaarheid te bieden. Niet van toepassing op een Hyperscale-database binnen een elastische pool. int
isLedgerOn Of deze database al dan niet een grootboekdatabase is, wat betekent dat alle tabellen in de database grootboektabellen zijn. Opmerking: de waarde van deze eigenschap kan niet worden gewijzigd nadat de database is gemaakt. booleaans
keys De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt DatabaseEigenschappenSleutels
licenseType Het licentietype dat moet worden aangevraagd voor deze database. LicenseIncludedals u een licentie nodig hebt of BasePrice als u een licentie hebt en in aanmerking komt voor de Azure Hybrid Benefit. "Basisprijs"
"LicenseIncluded"
longTermRetentionBackupResourceId De resource-id van de langetermijnretentieback-up die is gekoppeld aan de maakbewerking van deze database. tekenreeks
maintenanceConfigurationId Onderhoudsconfiguratie-id die is toegewezen aan de database. Deze configuratie definieert de periode waarin de onderhoudsupdates worden uitgevoerd. tekenreeks
manualCutover Of door de klant beheerde handmatige cutover moet worden uitgevoerd tijdens de bewerking Database bijwerken naar hyperscale-laag.

Deze eigenschap is alleen van toepassing bij het schalen van database van Bedrijfskritiek/Algemeen/Premium/Standard-laag naar hyperscale-laag.

Wanneer manualCutover is opgegeven, wacht de schaalbewerking totdat de invoer van de gebruiker cutover naar de Hyperscale-database activeert.

Als u cutover wilt activeren, geeft u de parameter performCutover op wanneer de schaalbewerking de status Wachten heeft.		 booleaans
maxSizeBytes De maximale grootte van de database, uitgedrukt in bytes. int
minCapacity Minimale capaciteit die de database altijd heeft toegewezen, indien niet onderbroken Geef een decimale waarde op als een tekenreeks. int of json decimaal
performCutover Door de klant beheerde handmatige cutover activeren tijdens de wachtstatus terwijl de schaalbewerking wordt uitgevoerd.

Deze eigenschapsparameter is alleen van toepassing op schaalbewerkingen die samen met de parameter manualCutover worden gestart.

Deze eigenschap is alleen van toepassing wanneer het schalen van de database van Bedrijfskritiek/Algemeen/Premium/Standard-laag naar hyperscale-laag al wordt uitgevoerd.

Wanneer performCutover is opgegeven, wordt met de schaalbewerking cutover geactiveerd en wordt een rolwijziging uitgevoerd in de Hyperscale-database.		 booleaans
preferredEnclaveType Type enclave dat is aangevraagd voor de database, bijvoorbeeld standaard- of VBS-enclaves. "Standaard"
"VBS"
readScale De status van alleen-lezenroutering. Als deze optie is ingeschakeld, kunnen verbindingen waarvoor de toepassingsintentie is ingesteld op alleen-lezen in hun verbindingsreeks, worden doorgestuurd naar een alleen-lezen secundaire replica in dezelfde regio. Niet van toepassing op een Hyperscale-database binnen een elastische pool. "Uitgeschakeld"
"Ingeschakeld"
recoverableDatabaseId De resource-id van de herstelbare database die is gekoppeld aan de maakbewerking van deze database. tekenreeks
recoveryServicesRecoveryPointId De resource-id van het herstelpunt dat is gekoppeld aan het maken van deze database. tekenreeks
requestedBackupStorageRedundancy Het type opslagaccount dat moet worden gebruikt voor het opslaan van back-ups voor deze database. "Geo"
"GeoZone"
"Lokaal"
"Zone"
restorableDroppedDatabaseId De resource-id van de herstelbare verwijderde database die is gekoppeld aan de maakbewerking van deze database. tekenreeks
restorePointInTime Hiermee geeft u het tijdstip (ISO8601 indeling) op van de brondatabase die wordt hersteld om de nieuwe database te maken. tekenreeks
sampleName De naam van het voorbeeldschema dat moet worden toegepast bij het maken van deze database. "AdventureWorksLT"
"WideWorldImportersFull"
"WideWorldImportersStd"
secondaryType Het secundaire type van de database als het een secundaire database is. Geldige waarden zijn Geo, Benoemd en Stand-by. "Geo"
"Benoemd"
"Stand-by"
sourceDatabaseDeletionDate Hiermee geeft u het tijdstip op waarop de database is verwijderd. tekenreeks
sourceDatabaseId De resource-id van de brondatabase die is gekoppeld aan de maakbewerking van deze database. tekenreeks
sourceResourceId De resource-id van de bron die is gekoppeld aan de maakbewerking van deze database.

Deze eigenschap wordt alleen ondersteund voor de DataWarehouse-editie en maakt het mogelijk om verschillende abonnementen te herstellen.

Wanneer sourceResourceId is opgegeven, moeten sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId en sourceDatabaseDeletionDate niet worden opgegeven en moet CreateMode PointInTimeRestore, Restore of Recover zijn.

Wanneer createMode PointInTimeRestore is, moet sourceResourceId de resource-id van de bestaande database of bestaande SQL-pool zijn en moet restorePointInTime worden opgegeven.

Wanneer createMode Herstellen is, moet sourceResourceId de resource-id zijn van herstelbare verwijderde database of herstelbare verwijderde SQL-pool.

Wanneer createMode Herstellen is, moet sourceResourceId de resource-id zijn van de herstelbare database of herstelbare SQL-pool.

Wanneer het bronabonnement tot een andere tenant behoort dan het doelabonnement, moet de header x-ms-authorization-auxiliary verificatietoken voor de brontenant bevatten. Zie /azure/azure-resource-manager/management/authenticate-multi-tenant voor meer informatie over de header x-ms-authorization-auxiliary		 tekenreeks
useFreeLimit Of de database gratis maandelijkse limieten gebruikt. Toegestaan voor één database in een abonnement. booleaans
zoneRedundant Of deze database zone-redundant is of niet, wat betekent dat de replica's van deze database worden verdeeld over meerdere beschikbaarheidszones. booleaans

DatabasePropertiesKeys

Naam Description Waarde
{aangepaste eigenschap} DatabaseKey

DatabaseKey

Dit object bevat geen eigenschappen die tijdens de implementatie moeten worden ingesteld. Alle eigenschappen zijn ReadOnly.

Sku

Naam Description Waarde
capacity Capaciteit van de specifieke SKU. int
gezin Als de service verschillende generaties hardware voor dezelfde SKU heeft, kan die hier worden vastgelegd. tekenreeks
naam De naam van de SKU, meestal een letter + cijfercode, bijvoorbeeld P3. tekenreeks (vereist)
grootte Grootte van de specifieke SKU tekenreeks
laag De laag of editie van de specifieke SKU, bijvoorbeeld Basic, Premium. tekenreeks