Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
- Latest
- 2024-11-01-preview
- 2024-05-01-preview
- 2023-08-01
- 2023-08-01-preview
- 2023-05-01-preview
- 2023-02-01-preview
- 2022-11-01-preview
- 2022-08-01-preview
- 2022-05-01-preview
- 2022-02-01-preview
- 2021-11-01
- 2021-11-01-preview
- 2021-08-01-preview
- 2021-05-01-preview
- 2021-02-01-preview
- 2020-11-01-preview
- 2020-08-01-preview
- 2020-02-02-preview
- 2019-06-01-preview
- 2017-10-01-preview
- 2017-03-01-preview
- 2014-04-01
Definicja zasobu Bicep
Typ zasobu serwerów/baz danych można wdrożyć przy użyciu operacji docelowych:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Sql/servers/databases, dodaj następujący kod Bicep do szablonu.
resource symbolicname 'Microsoft.Sql/servers/databases@2017-10-01-preview' = {
parent: resourceSymbolicName
location: 'string'
name: 'string'
properties: {
autoPauseDelay: int
catalogCollation: 'string'
collation: 'string'
createMode: 'string'
elasticPoolId: 'string'
licenseType: 'string'
longTermRetentionBackupResourceId: 'string'
maxSizeBytes: int
minCapacity: int
readReplicaCount: int
readScale: 'string'
recoverableDatabaseId: 'string'
recoveryServicesRecoveryPointId: 'string'
restorableDroppedDatabaseId: 'string'
restorePointInTime: 'string'
sampleName: 'string'
sourceDatabaseDeletionDate: 'string'
sourceDatabaseId: 'string'
zoneRedundant: bool
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
Wartości właściwości
Microsoft.Sql/servers/databases
| Name | Description | Value |
|---|---|---|
| lokalizacja | Lokalizacja zasobu. | ciąg (wymagany) |
| name | Nazwa zasobu | ciąg (wymagany) |
| nadrzędny | W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym. Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym. |
Nazwa symboliczna zasobu typu: serwery |
| properties | Właściwości zasobu. | DatabaseProperties |
| sku | Jednostka SKU bazy danych. Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu Capabilities_ListByLocation API REST lub jednego z następujących poleceń:azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />Program PowerShell<lokalizacja Get-AzSqlServerServiceObjective -Location> ```` |
Sku |
| tags | Tagi zasobów | Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
DatabaseProperties
| Name | Description | Value |
|---|---|---|
| autoPauseDelay | Czas w minutach, po którym baza danych jest automatycznie wstrzymana. Wartość -1 oznacza, że automatyczne wstrzymanie jest wyłączone | int |
| catalogCollation | Sortowanie wykazu metadanych. | 'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS' |
| sortowanie | Sortowanie bazy danych. | ciąg |
| createMode | Określa tryb tworzenia bazy danych. Ustawienie domyślne: regularne tworzenie bazy danych. Kopiowanie: tworzy bazę danych jako kopię istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu źródłowej bazy danych. Pomocnicza: tworzy bazę danych jako replikę pomocniczą istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej podstawowej bazy danych. PointInTimeRestore: tworzy bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej bazy danych, a element restorePointInTime musi być określony. Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. sourceDatabaseId musi być określony jako identyfikator zasobu bazy danych, który można odzyskać, aby przywrócić. Przywracanie: tworzy bazę danych, przywracając kopię zapasową usuniętej bazy danych. parametr sourceDatabaseId musi być określony. Jeśli sourceDatabaseId jest oryginalnym identyfikatorem zasobu bazy danych, należy określić parametr sourceDatabaseDeletionDate. W przeciwnym razie parametr sourceDatabaseId musi być identyfikatorem usuniętej bazy danych, a parametr sourceDatabaseDeletionDate jest ignorowany. Można również określić element restorePointInTime w celu przywrócenia z wcześniejszego punktu w czasie. RestoreLongTermRetentionBackup: tworzy bazę danych przez przywrócenie z magazynu przechowywania długoterminowego. recoveryServicesRecoveryPointResourceId musi być określony jako identyfikator zasobu punktu odzyskiwania. Funkcja Copy, Secondary i RestoreLongTermRetentionBackup nie jest obsługiwana w przypadku wersji DataWarehouse. |
'Copy' 'Default' 'OnlineSecondary' 'PointInTimeRestore' 'Recovery' 'Restore' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secondary' |
| elasticPoolId | Identyfikator zasobu elastycznej puli zawierającej tę bazę danych. | ciąg |
| licenseType | Typ licencji do zastosowania dla tej bazy danych.
LicenseIncluded jeśli potrzebujesz licencji lub BasePrice masz licencję i kwalifikujesz się do korzyści użycia hybrydowego platformy Azure. |
'BasePrice' 'LicenseIncluded' |
| longTermRetentionBackupResourceId | Identyfikator zasobu kopii zapasowej długoterminowego przechowywania skojarzonej z operacją tworzenia tej bazy danych. | ciąg |
| maxSizeBytes | Maksymalny rozmiar bazy danych wyrażony w bajtach. | int |
| minCapacity | Minimalna pojemność, którą baza danych zawsze będzie przydzielana, jeśli nie została wstrzymana | int |
| readReplicaCount | Liczba replik pomocniczych do odczytu skojarzonych z bazą danych, do której mogą być kierowane połączenia intencji aplikacji odczytu. Ta właściwość jest ustawiana tylko dla baz danych wersji Hiperskala. | int |
| readScale | W przypadku włączenia połączeń, które mają intencję aplikacji ustawioną na odczyt w parametrach połączenia, mogą być kierowane do repliki pomocniczej tylko do odczytu. Ta właściwość jest ustawiana tylko dla baz danych Premium i Krytyczne dla działania firmy. | 'Disabled' 'Enabled' |
| recoverableDatabaseId | Identyfikator zasobu możliwej do odzyskania bazy danych skojarzonej z operacją tworzenia tej bazy danych. | ciąg |
| recoveryServicesRecoveryPointId | Identyfikator zasobu punktu odzyskiwania skojarzonego z operacją tworzenia tej bazy danych. | ciąg |
| restorableDroppedDatabaseId | Identyfikator zasobu usuniętej bazy danych skojarzonej z operacją tworzenia tej bazy danych. | ciąg |
| restorePointInTime | Określa punkt w czasie (ISO8601 format) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych. | ciąg |
| sampleName | Nazwa przykładowego schematu, który ma być stosowany podczas tworzenia tej bazy danych. | 'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd' |
| sourceDatabaseDeletionDate | Określa czas usunięcia bazy danych. | ciąg |
| sourceDatabaseId | Identyfikator zasobu źródłowej bazy danych skojarzonej z operacją tworzenia tej bazy danych. | ciąg |
| zoneRedundant | Niezależnie od tego, czy ta baza danych jest strefowo nadmiarowa, co oznacza, że repliki tej bazy danych będą rozłożone na wiele stref dostępności. | bool |
Sku
| Name | Description | Value |
|---|---|---|
| dyspozycyjność | Pojemność określonej jednostki SKU. | int |
| family | Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. | ciąg |
| name | Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3. | ciąg (wymagany) |
| size | Rozmiar konkretnej jednostki SKU | ciąg |
| warstwa | Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. | ciąg |
TrackedResourceTags
| Name | Description | Value |
|---|
Przykłady użycia
Przykłady szybkiego startu platformy Azure
Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.
| Plik Bicep | Description |
|---|---|
| azure SQL Server z inspekcją zapisaną w usłudze Log Analytics | Ten szablon umożliwia wdrożenie serwera Azure SQL z włączoną inspekcją w celu zapisywania dzienników inspekcji w obszarze roboczym usługi Log Analytics (OMS) |
| Tworzenie programu SQL Server i bazy danych | Ten szablon umożliwia tworzenie usługi SQL Database i serwera. |
| dedykowana pula SQL z Transparent Encryption | Tworzy program SQL Server i dedykowaną pulę SQL (dawniej SQL DW) z funkcją Transparent Data Encryption. |
| wdrażanie analizy sportowej na platformie Azure | Tworzy konto magazynu platformy Azure z włączoną usługą ADLS Gen 2, wystąpieniem usługi Azure Data Factory z połączonymi usługami dla konta magazynu (jeśli została wdrożona usługa Azure SQL Database) i wystąpieniem usługi Azure Databricks. Tożsamość usługi AAD dla użytkownika wdrażającego szablon i tożsamość zarządzana dla wystąpienia usługi ADF otrzymają rolę Współautor danych obiektu blob usługi Storage na koncie magazynu. Dostępne są również opcje wdrażania wystąpienia usługi Azure Key Vault, usługi Azure SQL Database i usługi Azure Event Hub (w przypadku przypadków użycia przesyłania strumieniowego). Po wdrożeniu usługi Azure Key Vault tożsamość zarządzana fabryki danych i tożsamość usługi AAD dla użytkownika wdrażającego szablon otrzymają rolę Użytkownik wpisów tajnych usługi Key Vault. |
| przykład prywatnego punktu końcowego | Ten szablon przedstawia sposób tworzenia prywatnego punktu końcowego wskazującego program Azure SQL Server |
| aprowizuj aplikację internetową przy użyciu usługi SQL Database | Ten szablon aprowizuje aplikację internetową, bazę danych SQL Database, ustawienia autoskalowania, reguły alertów i usługę App Insights. Konfiguruje parametry połączenia w aplikacji internetowej dla bazy danych. |
| aplikacji internetowej Sonarqube Docker w systemie Linux przy użyciu usługi Azure SQL | Ten szablon wdraża aplikację Sonarqube w kontenerze aplikacji internetowej usługi Azure App Service dla systemu Linux przy użyciu oficjalnego obrazu Sonarqube i wspieranego przez program Azure SQL Server. |
| aplikacja internetowa z tożsamością zarządzaną, programem SQL Server i ΑΙ | Prosty przykład wdrażania infrastruktury platformy Azure dla aplikacji i danych i tożsamości zarządzanej i monitorowania |
Definicja zasobu szablonu usługi ARM
Typ zasobu serwerów/baz danych można wdrożyć przy użyciu operacji docelowych:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Sql/servers/databases, dodaj następujący kod JSON do szablonu.
{
"type": "Microsoft.Sql/servers/databases",
"apiVersion": "2017-10-01-preview",
"name": "string",
"location": "string",
"properties": {
"autoPauseDelay": "int",
"catalogCollation": "string",
"collation": "string",
"createMode": "string",
"elasticPoolId": "string",
"licenseType": "string",
"longTermRetentionBackupResourceId": "string",
"maxSizeBytes": "int",
"minCapacity": "int",
"readReplicaCount": "int",
"readScale": "string",
"recoverableDatabaseId": "string",
"recoveryServicesRecoveryPointId": "string",
"restorableDroppedDatabaseId": "string",
"restorePointInTime": "string",
"sampleName": "string",
"sourceDatabaseDeletionDate": "string",
"sourceDatabaseId": "string",
"zoneRedundant": "bool"
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
Wartości właściwości
Microsoft.Sql/servers/databases
| Name | Description | Value |
|---|---|---|
| apiVersion | Wersja interfejsu API | '2017-10-01-preview' |
| lokalizacja | Lokalizacja zasobu. | ciąg (wymagany) |
| name | Nazwa zasobu | ciąg (wymagany) |
| properties | Właściwości zasobu. | DatabaseProperties |
| sku | Jednostka SKU bazy danych. Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu Capabilities_ListByLocation API REST lub jednego z następujących poleceń:azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />Program PowerShell<lokalizacja Get-AzSqlServerServiceObjective -Location> ```` |
Sku |
| tags | Tagi zasobów | Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
| typ | Typ zasobu | 'Microsoft.Sql/servers/databases' |
DatabaseProperties
| Name | Description | Value |
|---|---|---|
| autoPauseDelay | Czas w minutach, po którym baza danych jest automatycznie wstrzymana. Wartość -1 oznacza, że automatyczne wstrzymanie jest wyłączone | int |
| catalogCollation | Sortowanie wykazu metadanych. | 'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS' |
| sortowanie | Sortowanie bazy danych. | ciąg |
| createMode | Określa tryb tworzenia bazy danych. Ustawienie domyślne: regularne tworzenie bazy danych. Kopiowanie: tworzy bazę danych jako kopię istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu źródłowej bazy danych. Pomocnicza: tworzy bazę danych jako replikę pomocniczą istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej podstawowej bazy danych. PointInTimeRestore: tworzy bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej bazy danych, a element restorePointInTime musi być określony. Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. sourceDatabaseId musi być określony jako identyfikator zasobu bazy danych, który można odzyskać, aby przywrócić. Przywracanie: tworzy bazę danych, przywracając kopię zapasową usuniętej bazy danych. parametr sourceDatabaseId musi być określony. Jeśli sourceDatabaseId jest oryginalnym identyfikatorem zasobu bazy danych, należy określić parametr sourceDatabaseDeletionDate. W przeciwnym razie parametr sourceDatabaseId musi być identyfikatorem usuniętej bazy danych, a parametr sourceDatabaseDeletionDate jest ignorowany. Można również określić element restorePointInTime w celu przywrócenia z wcześniejszego punktu w czasie. RestoreLongTermRetentionBackup: tworzy bazę danych przez przywrócenie z magazynu przechowywania długoterminowego. recoveryServicesRecoveryPointResourceId musi być określony jako identyfikator zasobu punktu odzyskiwania. Funkcja Copy, Secondary i RestoreLongTermRetentionBackup nie jest obsługiwana w przypadku wersji DataWarehouse. |
'Copy' 'Default' 'OnlineSecondary' 'PointInTimeRestore' 'Recovery' 'Restore' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secondary' |
| elasticPoolId | Identyfikator zasobu elastycznej puli zawierającej tę bazę danych. | ciąg |
| licenseType | Typ licencji do zastosowania dla tej bazy danych.
LicenseIncluded jeśli potrzebujesz licencji lub BasePrice masz licencję i kwalifikujesz się do korzyści użycia hybrydowego platformy Azure. |
'BasePrice' 'LicenseIncluded' |
| longTermRetentionBackupResourceId | Identyfikator zasobu kopii zapasowej długoterminowego przechowywania skojarzonej z operacją tworzenia tej bazy danych. | ciąg |
| maxSizeBytes | Maksymalny rozmiar bazy danych wyrażony w bajtach. | int |
| minCapacity | Minimalna pojemność, którą baza danych zawsze będzie przydzielana, jeśli nie została wstrzymana | int |
| readReplicaCount | Liczba replik pomocniczych do odczytu skojarzonych z bazą danych, do której mogą być kierowane połączenia intencji aplikacji odczytu. Ta właściwość jest ustawiana tylko dla baz danych wersji Hiperskala. | int |
| readScale | W przypadku włączenia połączeń, które mają intencję aplikacji ustawioną na odczyt w parametrach połączenia, mogą być kierowane do repliki pomocniczej tylko do odczytu. Ta właściwość jest ustawiana tylko dla baz danych Premium i Krytyczne dla działania firmy. | 'Disabled' 'Enabled' |
| recoverableDatabaseId | Identyfikator zasobu możliwej do odzyskania bazy danych skojarzonej z operacją tworzenia tej bazy danych. | ciąg |
| recoveryServicesRecoveryPointId | Identyfikator zasobu punktu odzyskiwania skojarzonego z operacją tworzenia tej bazy danych. | ciąg |
| restorableDroppedDatabaseId | Identyfikator zasobu usuniętej bazy danych skojarzonej z operacją tworzenia tej bazy danych. | ciąg |
| restorePointInTime | Określa punkt w czasie (ISO8601 format) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych. | ciąg |
| sampleName | Nazwa przykładowego schematu, który ma być stosowany podczas tworzenia tej bazy danych. | 'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd' |
| sourceDatabaseDeletionDate | Określa czas usunięcia bazy danych. | ciąg |
| sourceDatabaseId | Identyfikator zasobu źródłowej bazy danych skojarzonej z operacją tworzenia tej bazy danych. | ciąg |
| zoneRedundant | Niezależnie od tego, czy ta baza danych jest strefowo nadmiarowa, co oznacza, że repliki tej bazy danych będą rozłożone na wiele stref dostępności. | bool |
Sku
| Name | Description | Value |
|---|---|---|
| dyspozycyjność | Pojemność określonej jednostki SKU. | int |
| family | Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. | ciąg |
| name | Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3. | ciąg (wymagany) |
| size | Rozmiar konkretnej jednostki SKU | ciąg |
| warstwa | Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. | ciąg |
TrackedResourceTags
| Name | Description | Value |
|---|
Przykłady użycia
Szablony szybkiego startu platformy Azure
Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.
| Template | Description |
|---|---|
|
azure SQL Server z inspekcją zapisaną w usłudze Log Analytics |
Ten szablon umożliwia wdrożenie serwera Azure SQL z włączoną inspekcją w celu zapisywania dzienników inspekcji w obszarze roboczym usługi Log Analytics (OMS) |
|
Tworzenie programu SQL Server i bazy danych |
Ten szablon umożliwia tworzenie usługi SQL Database i serwera. |
| dedykowana pula SQL z Transparent Encryption |
Tworzy program SQL Server i dedykowaną pulę SQL (dawniej SQL DW) z funkcją Transparent Data Encryption. |
|
Wdrażanie nowej elastycznej puli SQL |
Ten szablon umożliwia wdrożenie nowej elastycznej puli SQL wraz z nowym skojarzonym programem SQL Server i nowymi bazami danych SQL Database w celu przypisania do niego. |
|
wdrażanie analizy sportowej na platformie Azure |
Tworzy konto magazynu platformy Azure z włączoną usługą ADLS Gen 2, wystąpieniem usługi Azure Data Factory z połączonymi usługami dla konta magazynu (jeśli została wdrożona usługa Azure SQL Database) i wystąpieniem usługi Azure Databricks. Tożsamość usługi AAD dla użytkownika wdrażającego szablon i tożsamość zarządzana dla wystąpienia usługi ADF otrzymają rolę Współautor danych obiektu blob usługi Storage na koncie magazynu. Dostępne są również opcje wdrażania wystąpienia usługi Azure Key Vault, usługi Azure SQL Database i usługi Azure Event Hub (w przypadku przypadków użycia przesyłania strumieniowego). Po wdrożeniu usługi Azure Key Vault tożsamość zarządzana fabryki danych i tożsamość usługi AAD dla użytkownika wdrażającego szablon otrzymają rolę Użytkownik wpisów tajnych usługi Key Vault. |
|
HDInsight z niestandardową bazą danych ambari i magazynu metadanych Hive w sieci wirtualnej |
Ten szablon umożliwia utworzenie klastra usługi HDInsight w istniejącej sieci wirtualnej przy użyciu nowej bazy danych SQL, która służy zarówno jako niestandardowa baza danych Ambari DB, jak i magazyn metadanych Hive. Musisz mieć istniejący serwer SQL, konto magazynu i sieć wirtualną. |
| przykład prywatnego punktu końcowego |
Ten szablon przedstawia sposób tworzenia prywatnego punktu końcowego wskazującego program Azure SQL Server |
|
aprowizuj aplikację internetową przy użyciu usługi SQL Database |
Ten szablon aprowizuje aplikację internetową, bazę danych SQL Database, ustawienia autoskalowania, reguły alertów i usługę App Insights. Konfiguruje parametry połączenia w aplikacji internetowej dla bazy danych. |
|
usług pulpitu zdalnego z wysoką dostępnością |
Ten przykładowy kod szablonu usługi ARM wdroży laboratorium kolekcji sesji usług pulpitu zdalnego 2019 z wysoką dostępnością. Celem jest wdrożenie w pełni nadmiarowego, wysoce dostępnego rozwiązania dla usług pulpitu zdalnego przy użyciu systemu Windows Server 2019. |
|
aplikacji internetowej Sonarqube Docker w systemie Linux przy użyciu usługi Azure SQL |
Ten szablon wdraża aplikację Sonarqube w kontenerze aplikacji internetowej usługi Azure App Service dla systemu Linux przy użyciu oficjalnego obrazu Sonarqube i wspieranego przez program Azure SQL Server. |
|
aplikacja internetowa z tożsamością zarządzaną, programem SQL Server i ΑΙ |
Prosty przykład wdrażania infrastruktury platformy Azure dla aplikacji i danych i tożsamości zarządzanej i monitorowania |
|
aplikacja internetowa korzystająca z prywatnego punktu końcowego usługi Azure SQL |
Ten szablon pokazuje, jak utworzyć aplikację internetową, która korzysta z prywatnego punktu końcowego wskazującego na program Azure SQL Server |
Definicja zasobu narzędzia Terraform (dostawcy AzAPI)
Typ zasobu serwerów/baz danych można wdrożyć przy użyciu operacji docelowych:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Sql/servers/databases, dodaj następujący program Terraform do szablonu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Sql/servers/databases@2017-10-01-preview"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
autoPauseDelay = int
catalogCollation = "string"
collation = "string"
createMode = "string"
elasticPoolId = "string"
licenseType = "string"
longTermRetentionBackupResourceId = "string"
maxSizeBytes = int
minCapacity = int
readReplicaCount = int
readScale = "string"
recoverableDatabaseId = "string"
recoveryServicesRecoveryPointId = "string"
restorableDroppedDatabaseId = "string"
restorePointInTime = "string"
sampleName = "string"
sourceDatabaseDeletionDate = "string"
sourceDatabaseId = "string"
zoneRedundant = bool
}
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
}
}
Wartości właściwości
Microsoft.Sql/servers/databases
| Name | Description | Value |
|---|---|---|
| lokalizacja | Lokalizacja zasobu. | ciąg (wymagany) |
| name | Nazwa zasobu | ciąg (wymagany) |
| parent_id | Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. | Identyfikator zasobu typu: serwerów |
| properties | Właściwości zasobu. | DatabaseProperties |
| sku | Jednostka SKU bazy danych. Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu Capabilities_ListByLocation API REST lub jednego z następujących poleceń:azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />Program PowerShell<lokalizacja Get-AzSqlServerServiceObjective -Location> ```` |
Sku |
| tags | Tagi zasobów | Słownik nazw tagów i wartości. |
| typ | Typ zasobu | "Microsoft.Sql/servers/databases@2017-10-01-preview" |
DatabaseProperties
| Name | Description | Value |
|---|---|---|
| autoPauseDelay | Czas w minutach, po którym baza danych jest automatycznie wstrzymana. Wartość -1 oznacza, że automatyczne wstrzymanie jest wyłączone | int |
| catalogCollation | Sortowanie wykazu metadanych. | 'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS' |
| sortowanie | Sortowanie bazy danych. | ciąg |
| createMode | Określa tryb tworzenia bazy danych. Ustawienie domyślne: regularne tworzenie bazy danych. Kopiowanie: tworzy bazę danych jako kopię istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu źródłowej bazy danych. Pomocnicza: tworzy bazę danych jako replikę pomocniczą istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej podstawowej bazy danych. PointInTimeRestore: tworzy bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej bazy danych, a element restorePointInTime musi być określony. Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. sourceDatabaseId musi być określony jako identyfikator zasobu bazy danych, który można odzyskać, aby przywrócić. Przywracanie: tworzy bazę danych, przywracając kopię zapasową usuniętej bazy danych. parametr sourceDatabaseId musi być określony. Jeśli sourceDatabaseId jest oryginalnym identyfikatorem zasobu bazy danych, należy określić parametr sourceDatabaseDeletionDate. W przeciwnym razie parametr sourceDatabaseId musi być identyfikatorem usuniętej bazy danych, a parametr sourceDatabaseDeletionDate jest ignorowany. Można również określić element restorePointInTime w celu przywrócenia z wcześniejszego punktu w czasie. RestoreLongTermRetentionBackup: tworzy bazę danych przez przywrócenie z magazynu przechowywania długoterminowego. recoveryServicesRecoveryPointResourceId musi być określony jako identyfikator zasobu punktu odzyskiwania. Funkcja Copy, Secondary i RestoreLongTermRetentionBackup nie jest obsługiwana w przypadku wersji DataWarehouse. |
'Copy' 'Default' 'OnlineSecondary' 'PointInTimeRestore' 'Recovery' 'Restore' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secondary' |
| elasticPoolId | Identyfikator zasobu elastycznej puli zawierającej tę bazę danych. | ciąg |
| licenseType | Typ licencji do zastosowania dla tej bazy danych.
LicenseIncluded jeśli potrzebujesz licencji lub BasePrice masz licencję i kwalifikujesz się do korzyści użycia hybrydowego platformy Azure. |
'BasePrice' 'LicenseIncluded' |
| longTermRetentionBackupResourceId | Identyfikator zasobu kopii zapasowej długoterminowego przechowywania skojarzonej z operacją tworzenia tej bazy danych. | ciąg |
| maxSizeBytes | Maksymalny rozmiar bazy danych wyrażony w bajtach. | int |
| minCapacity | Minimalna pojemność, którą baza danych zawsze będzie przydzielana, jeśli nie została wstrzymana | int |
| readReplicaCount | Liczba replik pomocniczych do odczytu skojarzonych z bazą danych, do której mogą być kierowane połączenia intencji aplikacji odczytu. Ta właściwość jest ustawiana tylko dla baz danych wersji Hiperskala. | int |
| readScale | W przypadku włączenia połączeń, które mają intencję aplikacji ustawioną na odczyt w parametrach połączenia, mogą być kierowane do repliki pomocniczej tylko do odczytu. Ta właściwość jest ustawiana tylko dla baz danych Premium i Krytyczne dla działania firmy. | 'Disabled' 'Enabled' |
| recoverableDatabaseId | Identyfikator zasobu możliwej do odzyskania bazy danych skojarzonej z operacją tworzenia tej bazy danych. | ciąg |
| recoveryServicesRecoveryPointId | Identyfikator zasobu punktu odzyskiwania skojarzonego z operacją tworzenia tej bazy danych. | ciąg |
| restorableDroppedDatabaseId | Identyfikator zasobu usuniętej bazy danych skojarzonej z operacją tworzenia tej bazy danych. | ciąg |
| restorePointInTime | Określa punkt w czasie (ISO8601 format) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych. | ciąg |
| sampleName | Nazwa przykładowego schematu, który ma być stosowany podczas tworzenia tej bazy danych. | 'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd' |
| sourceDatabaseDeletionDate | Określa czas usunięcia bazy danych. | ciąg |
| sourceDatabaseId | Identyfikator zasobu źródłowej bazy danych skojarzonej z operacją tworzenia tej bazy danych. | ciąg |
| zoneRedundant | Niezależnie od tego, czy ta baza danych jest strefowo nadmiarowa, co oznacza, że repliki tej bazy danych będą rozłożone na wiele stref dostępności. | bool |
Sku
| Name | Description | Value |
|---|---|---|
| dyspozycyjność | Pojemność określonej jednostki SKU. | int |
| family | Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. | ciąg |
| name | Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3. | ciąg (wymagany) |
| size | Rozmiar konkretnej jednostki SKU | ciąg |
| warstwa | Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. | ciąg |
TrackedResourceTags
| Name | Description | Value |
|---|
Przykłady użycia
Przykłady programu Terraform
Podstawowy przykład wdrożenia bazy danych MS SQL.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
azurerm = {
source = "hashicorp/azurerm"
}
}
}
provider "azurerm" {
features {
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
variable "administrator_login_password" {
type = string
description = "The administrator login password for the SQL server"
sensitive = true
}
data "azurerm_client_config" "current" {
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "server" {
type = "Microsoft.Sql/servers@2021-02-01-preview"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
administratorLogin = "mradministrator"
administratorLoginPassword = var.administrator_login_password
minimalTlsVersion = "1.2"
publicNetworkAccess = "Enabled"
restrictOutboundNetworkAccess = "Disabled"
version = "12.0"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
data "azapi_resource_id" "publicMaintenanceConfiguration" {
type = "Microsoft.Maintenance/publicMaintenanceConfigurations@2023-04-01"
parent_id = "/subscriptions/${data.azurerm_client_config.current.subscription_id}"
name = "SQL_Default"
}
resource "azapi_resource" "database" {
type = "Microsoft.Sql/servers/databases@2021-02-01-preview"
parent_id = azapi_resource.server.id
name = var.resource_name
location = var.location
body = {
properties = {
autoPauseDelay = 0
createMode = "Default"
elasticPoolId = ""
highAvailabilityReplicaCount = 0
isLedgerOn = false
licenseType = "LicenseIncluded"
maintenanceConfigurationId = data.azapi_resource_id.publicMaintenanceConfiguration.id
minCapacity = 0
readScale = "Disabled"
requestedBackupStorageRedundancy = "Geo"
zoneRedundant = false
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
Podstawowy przykład wdrożenia bazy danych MS SQL.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
azurerm = {
source = "hashicorp/azurerm"
}
}
}
provider "azurerm" {
features {
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
variable "administrator_login_password" {
type = string
description = "The administrator login password for the SQL server"
sensitive = true
}
data "azurerm_client_config" "current" {
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "server" {
type = "Microsoft.Sql/servers@2021-02-01-preview"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
administratorLogin = "mradministrator"
administratorLoginPassword = var.administrator_login_password
minimalTlsVersion = "1.2"
publicNetworkAccess = "Enabled"
restrictOutboundNetworkAccess = "Disabled"
version = "12.0"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
data "azapi_resource_id" "publicMaintenanceConfiguration" {
type = "Microsoft.Maintenance/publicMaintenanceConfigurations@2023-04-01"
parent_id = "/subscriptions/${data.azurerm_client_config.current.subscription_id}"
name = "SQL_Default"
}
resource "azapi_resource" "database" {
type = "Microsoft.Sql/servers/databases@2021-02-01-preview"
parent_id = azapi_resource.server.id
name = var.resource_name
location = var.location
body = {
properties = {
autoPauseDelay = 0
createMode = "Default"
elasticPoolId = ""
highAvailabilityReplicaCount = 0
isLedgerOn = false
licenseType = "LicenseIncluded"
maintenanceConfigurationId = data.azapi_resource_id.publicMaintenanceConfiguration.id
minCapacity = 0
readScale = "Disabled"
requestedBackupStorageRedundancy = "Geo"
zoneRedundant = false
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}