Microsoft.Sql servers/databases 2022-05-01-preview
- najnowsze
- 2024-05-01-preview
-
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:
- grupy zasobów — zobacz polecenia wdrażania grupy zasobów
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@2022-05-01-preview' = {
parent: resourceSymbolicName
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
autoPauseDelay: int
catalogCollation: 'string'
collation: 'string'
createMode: 'string'
elasticPoolId: 'string'
federatedClientId: 'string'
highAvailabilityReplicaCount: int
isLedgerOn: bool
licenseType: 'string'
longTermRetentionBackupResourceId: 'string'
maintenanceConfigurationId: 'string'
maxSizeBytes: int
minCapacity: int
preferredEnclaveType: 'string'
readScale: 'string'
recoverableDatabaseId: 'string'
recoveryServicesRecoveryPointId: 'string'
requestedBackupStorageRedundancy: 'string'
restorableDroppedDatabaseId: 'string'
restorePointInTime: 'string'
sampleName: 'string'
secondaryType: 'string'
sourceDatabaseDeletionDate: 'string'
sourceDatabaseId: 'string'
sourceResourceId: 'string'
zoneRedundant: bool
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
Wartości właściwości
Identyfikator bazy danych
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ tożsamości | "Brak" "UserAssigned" |
| userAssignedIdentities | Identyfikatory zasobów tożsamości przypisanych przez użytkownika do użycia | DatabaseIdentityUserAssignedIdentities |
DatabaseIdentityUserAssignedIdentities
| Nazwa | Opis | Wartość |
|---|
Właściwości bazy danych
| Nazwa | Opis | Wartość |
|---|---|---|
| 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. | struna |
| 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. |
"Kopiuj" "Wartość domyślna" "OnlineSecondary" "PointInTimeRestore" "Odzyskiwanie" "Przywracanie" "RestoreExternalBackup" "RestoreExternalBackupSecondary" "RestoreLongTermRetentionBackup" "Pomocnicza" |
| elasticPoolId | Identyfikator zasobu elastycznej puli zawierającej tę bazę danych. | struna |
| federatedClientId | Identyfikator klienta używany dla scenariusza cmK dla dzierżawy między dzierżawami bazy danych | struna Ograniczenia: Minimalna długość = 36 Maksymalna długość = 36 Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| highAvailabilityReplicaCount | Liczba replik pomocniczych skojarzonych z bazą danych, które są używane do zapewnienia wysokiej dostępności. Nie dotyczy bazy danych w warstwie Hiperskala w puli elastycznej. | Int |
| isLedgerOn | Niezależnie od tego, czy ta baza danych jest bazą danych rejestru, co oznacza, że wszystkie tabele w bazie danych są tabelami rejestru. Uwaga: nie można zmienić wartości tej właściwości po utworzeniu bazy danych. | Bool |
| licenseType | Typ licencji do zastosowania dla tej bazy danych.
LicenseIncluded, jeśli potrzebujesz licencji lub BasePrice, jeśli 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. | struna |
| maintenanceConfigurationId | Identyfikator konfiguracji konserwacji przypisany do bazy danych. Ta konfiguracja określa okres, w których będą wykonywane aktualizacje konserwacji. | struna |
| 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 |
| preferredEnclaveType | Typ enklawy żądanej w bazie danych, tj. domyślne lub enklawy VBS. | "Wartość domyślna" "VBS" |
| readScale | Stan routingu tylko do odczytu. Jeśli ta opcja jest włączona, połączenia, które mają intencję aplikacji ustawioną na odczyt w parametrach połączenia, mogą być kierowane do repliki pomocniczej tylko do odczytu w tym samym regionie. Nie dotyczy bazy danych w warstwie Hiperskala w puli elastycznej. | "Wyłączone" "Włączone" |
| recoverableDatabaseId | Identyfikator zasobu możliwej do odzyskania bazy danych skojarzonej z operacją tworzenia tej bazy danych. | struna |
| recoveryServicesRecoveryPointId | Identyfikator zasobu punktu odzyskiwania skojarzonego z operacją tworzenia tej bazy danych. | struna |
| requestedBackupStorageRedundancy | Typ konta magazynu, który ma być używany do przechowywania kopii zapasowych dla tej bazy danych. | "Geo" "GeoZone" "Lokalny" "Strefa" |
| restorableDroppedDatabaseId | Identyfikator zasobu usuniętej bazy danych skojarzonej z operacją tworzenia tej bazy danych. | struna |
| restorePointInTime | Określa punkt w czasie (ISO8601 format) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych. | struna |
| sampleName | Nazwa przykładowego schematu, który ma być stosowany podczas tworzenia tej bazy danych. | "AdventureWorksLT" "WideWorldImportersFull" "WideWorldImportersStd" |
| secondaryType | Pomocniczy typ bazy danych, jeśli jest pomocniczy. Prawidłowe wartości to Geo, Named i Standby. | "Geo" "Nazwane" "Wstrzymanie" |
| sourceDatabaseDeletionDate | Określa czas usunięcia bazy danych. | struna |
| sourceDatabaseId | Identyfikator zasobu źródłowej bazy danych skojarzonej z operacją tworzenia tej bazy danych. | struna |
| sourceResourceId | Identyfikator zasobu źródła skojarzonego z operacją tworzenia tej bazy danych. Ta właściwość jest obsługiwana tylko w przypadku wersji DataWarehouse i umożliwia przywracanie między subskrypcjami. Jeśli parametr sourceResourceId jest określony, parametr sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId i sourceDatabaseDeletionDate nie może być określony, a właściwość CreateMode musi być typu PointInTimeRestore, Restore lub Recover. Jeśli parametr createMode to PointInTimeRestore, parametr sourceResourceId musi być identyfikatorem zasobu istniejącej bazy danych lub istniejącej puli SQL, a należy określić parametr restorePointInTime. Gdy tryb createMode to Restore, identyfikator sourceResourceId musi być identyfikatorem zasobu przywracalnej usuniętej bazy danych lub można przywrócić porzuconą pulę SQL. Gdy tryb createMode jest odzyskiwane, identyfikator sourceResourceId musi być identyfikatorem zasobu możliwej do odzyskania bazy danych lub możliwej do odzyskania puli SQL. Jeśli subskrypcja źródłowa należy do innej dzierżawy niż subskrypcja docelowa, nagłówek "x-ms-authorization-auxiliary" musi zawierać token uwierzytelniania dla dzierżawy źródłowej. Aby uzyskać więcej informacji na temat nagłówka "x-ms-authorization-auxiliary", zobacz /azure/azure-resource-manager/management/authenticate-multi-tenant |
struna |
| 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 |
DatabaseUserIdentity
| Nazwa | Opis | Wartość |
|---|
Microsoft.Sql/servers/databases
| Nazwa | Opis | Wartość |
|---|---|---|
| tożsamość | Tożsamość usługi Azure Active Directory bazy danych. | DatabaseIdentity |
| lokalizacja | Lokalizacja zasobu. | ciąg (wymagany) |
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| rodzic | 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 |
| Właściwości | Właściwości zasobu. | DatabaseProperties |
| Numer jednostki magazynowej | 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 twojej subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu API REST Capabilities_ListByLocation lub jednego z następujących poleceń:azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />programu PowerShellGet-AzSqlServerServiceObjective -Location <lokalizacji> ```` |
sku |
| Tagi | Tagi zasobów | Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
Numer jednostki magazynowej
| Nazwa | Opis | Wartość |
|---|---|---|
| pojemność | Pojemność określonej jednostki SKU. | Int |
| rodzina | Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. | struna |
| nazwa | Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3. | ciąg (wymagany) |
| rozmiar | Rozmiar konkretnej jednostki SKU | struna |
| kondygnacja | Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. | struna |
TrackedResourceTags
| Nazwa | Opis | Wartość |
|---|
Przykłady z przewodnika Szybki start
W poniższych przykładach szybkiego startu wdrożono ten typ zasobu.
| Plik Bicep | Opis |
|---|---|
| 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:
- grupy zasobów — zobacz polecenia wdrażania grupy zasobów
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": "2022-05-01-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"autoPauseDelay": "int",
"catalogCollation": "string",
"collation": "string",
"createMode": "string",
"elasticPoolId": "string",
"federatedClientId": "string",
"highAvailabilityReplicaCount": "int",
"isLedgerOn": "bool",
"licenseType": "string",
"longTermRetentionBackupResourceId": "string",
"maintenanceConfigurationId": "string",
"maxSizeBytes": "int",
"minCapacity": "int",
"preferredEnclaveType": "string",
"readScale": "string",
"recoverableDatabaseId": "string",
"recoveryServicesRecoveryPointId": "string",
"requestedBackupStorageRedundancy": "string",
"restorableDroppedDatabaseId": "string",
"restorePointInTime": "string",
"sampleName": "string",
"secondaryType": "string",
"sourceDatabaseDeletionDate": "string",
"sourceDatabaseId": "string",
"sourceResourceId": "string",
"zoneRedundant": "bool"
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
Wartości właściwości
Identyfikator bazy danych
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ tożsamości | "Brak" "UserAssigned" |
| userAssignedIdentities | Identyfikatory zasobów tożsamości przypisanych przez użytkownika do użycia | DatabaseIdentityUserAssignedIdentities |
DatabaseIdentityUserAssignedIdentities
| Nazwa | Opis | Wartość |
|---|
Właściwości bazy danych
| Nazwa | Opis | Wartość |
|---|---|---|
| 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. | struna |
| 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. |
"Kopiuj" "Wartość domyślna" "OnlineSecondary" "PointInTimeRestore" "Odzyskiwanie" "Przywracanie" "RestoreExternalBackup" "RestoreExternalBackupSecondary" "RestoreLongTermRetentionBackup" "Pomocnicza" |
| elasticPoolId | Identyfikator zasobu elastycznej puli zawierającej tę bazę danych. | struna |
| federatedClientId | Identyfikator klienta używany dla scenariusza cmK dla dzierżawy między dzierżawami bazy danych | struna Ograniczenia: Minimalna długość = 36 Maksymalna długość = 36 Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| highAvailabilityReplicaCount | Liczba replik pomocniczych skojarzonych z bazą danych, które są używane do zapewnienia wysokiej dostępności. Nie dotyczy bazy danych w warstwie Hiperskala w puli elastycznej. | Int |
| isLedgerOn | Niezależnie od tego, czy ta baza danych jest bazą danych rejestru, co oznacza, że wszystkie tabele w bazie danych są tabelami rejestru. Uwaga: nie można zmienić wartości tej właściwości po utworzeniu bazy danych. | Bool |
| licenseType | Typ licencji do zastosowania dla tej bazy danych.
LicenseIncluded, jeśli potrzebujesz licencji lub BasePrice, jeśli 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. | struna |
| maintenanceConfigurationId | Identyfikator konfiguracji konserwacji przypisany do bazy danych. Ta konfiguracja określa okres, w których będą wykonywane aktualizacje konserwacji. | struna |
| 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 |
| preferredEnclaveType | Typ enklawy żądanej w bazie danych, tj. domyślne lub enklawy VBS. | "Wartość domyślna" "VBS" |
| readScale | Stan routingu tylko do odczytu. Jeśli ta opcja jest włączona, połączenia, które mają intencję aplikacji ustawioną na odczyt w parametrach połączenia, mogą być kierowane do repliki pomocniczej tylko do odczytu w tym samym regionie. Nie dotyczy bazy danych w warstwie Hiperskala w puli elastycznej. | "Wyłączone" "Włączone" |
| recoverableDatabaseId | Identyfikator zasobu możliwej do odzyskania bazy danych skojarzonej z operacją tworzenia tej bazy danych. | struna |
| recoveryServicesRecoveryPointId | Identyfikator zasobu punktu odzyskiwania skojarzonego z operacją tworzenia tej bazy danych. | struna |
| requestedBackupStorageRedundancy | Typ konta magazynu, który ma być używany do przechowywania kopii zapasowych dla tej bazy danych. | "Geo" "GeoZone" "Lokalny" "Strefa" |
| restorableDroppedDatabaseId | Identyfikator zasobu usuniętej bazy danych skojarzonej z operacją tworzenia tej bazy danych. | struna |
| restorePointInTime | Określa punkt w czasie (ISO8601 format) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych. | struna |
| sampleName | Nazwa przykładowego schematu, który ma być stosowany podczas tworzenia tej bazy danych. | "AdventureWorksLT" "WideWorldImportersFull" "WideWorldImportersStd" |
| secondaryType | Pomocniczy typ bazy danych, jeśli jest pomocniczy. Prawidłowe wartości to Geo, Named i Standby. | "Geo" "Nazwane" "Wstrzymanie" |
| sourceDatabaseDeletionDate | Określa czas usunięcia bazy danych. | struna |
| sourceDatabaseId | Identyfikator zasobu źródłowej bazy danych skojarzonej z operacją tworzenia tej bazy danych. | struna |
| sourceResourceId | Identyfikator zasobu źródła skojarzonego z operacją tworzenia tej bazy danych. Ta właściwość jest obsługiwana tylko w przypadku wersji DataWarehouse i umożliwia przywracanie między subskrypcjami. Jeśli parametr sourceResourceId jest określony, parametr sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId i sourceDatabaseDeletionDate nie może być określony, a właściwość CreateMode musi być typu PointInTimeRestore, Restore lub Recover. Jeśli parametr createMode to PointInTimeRestore, parametr sourceResourceId musi być identyfikatorem zasobu istniejącej bazy danych lub istniejącej puli SQL, a należy określić parametr restorePointInTime. Gdy tryb createMode to Restore, identyfikator sourceResourceId musi być identyfikatorem zasobu przywracalnej usuniętej bazy danych lub można przywrócić porzuconą pulę SQL. Gdy tryb createMode jest odzyskiwane, identyfikator sourceResourceId musi być identyfikatorem zasobu możliwej do odzyskania bazy danych lub możliwej do odzyskania puli SQL. Jeśli subskrypcja źródłowa należy do innej dzierżawy niż subskrypcja docelowa, nagłówek "x-ms-authorization-auxiliary" musi zawierać token uwierzytelniania dla dzierżawy źródłowej. Aby uzyskać więcej informacji na temat nagłówka "x-ms-authorization-auxiliary", zobacz /azure/azure-resource-manager/management/authenticate-multi-tenant |
struna |
| 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 |
DatabaseUserIdentity
| Nazwa | Opis | Wartość |
|---|
Microsoft.Sql/servers/databases
| Nazwa | Opis | Wartość |
|---|---|---|
| apiVersion | Wersja interfejsu API | "2022-05-01-preview" |
| tożsamość | Tożsamość usługi Azure Active Directory bazy danych. | DatabaseIdentity |
| lokalizacja | Lokalizacja zasobu. | ciąg (wymagany) |
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| Właściwości | Właściwości zasobu. | DatabaseProperties |
| Numer jednostki magazynowej | 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 twojej subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu API REST Capabilities_ListByLocation lub jednego z następujących poleceń:azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />programu PowerShellGet-AzSqlServerServiceObjective -Location <lokalizacji> ```` |
sku |
| Tagi | Tagi zasobów | Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
| typ | Typ zasobu | "Microsoft.Sql/servers/databases" |
Numer jednostki magazynowej
| Nazwa | Opis | Wartość |
|---|---|---|
| pojemność | Pojemność określonej jednostki SKU. | Int |
| rodzina | Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. | struna |
| nazwa | Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3. | ciąg (wymagany) |
| rozmiar | Rozmiar konkretnej jednostki SKU | struna |
| kondygnacja | Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. | struna |
TrackedResourceTags
| Nazwa | Opis | Wartość |
|---|
Szablony szybkiego startu
Następujące szablony szybkiego startu wdrażają ten typ zasobu.
| Szablon | Opis |
|---|---|
|
azure SQL Server z inspekcją zapisaną w usłudze Log Analytics wdrażanie  |
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 wdrażanie |
Ten szablon umożliwia tworzenie usługi SQL Database i serwera. |
| dedykowana pula SQL z Transparent Encryption wdrażanie |
Tworzy program SQL Server i dedykowaną pulę SQL (dawniej SQL DW) z funkcją Transparent Data Encryption. |
|
wdrażanie nowej elastycznej puli SQL wdrażanie |
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 wdrażanie |
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 wdrażanie |
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 wdrażanie |
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 wdrażanie |
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ą wdrażanie |
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 wdrażanie |
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 ΑΙ wdrażanie |
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 wdrażanie |
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:
- grupy zasobów
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@2022-05-01-preview"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
location = "string"
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
autoPauseDelay = int
catalogCollation = "string"
collation = "string"
createMode = "string"
elasticPoolId = "string"
federatedClientId = "string"
highAvailabilityReplicaCount = int
isLedgerOn = bool
licenseType = "string"
longTermRetentionBackupResourceId = "string"
maintenanceConfigurationId = "string"
maxSizeBytes = int
minCapacity = int
preferredEnclaveType = "string"
readScale = "string"
recoverableDatabaseId = "string"
recoveryServicesRecoveryPointId = "string"
requestedBackupStorageRedundancy = "string"
restorableDroppedDatabaseId = "string"
restorePointInTime = "string"
sampleName = "string"
secondaryType = "string"
sourceDatabaseDeletionDate = "string"
sourceDatabaseId = "string"
sourceResourceId = "string"
zoneRedundant = bool
}
})
}
Wartości właściwości
Identyfikator bazy danych
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ tożsamości | "Brak" "UserAssigned" |
| userAssignedIdentities | Identyfikatory zasobów tożsamości przypisanych przez użytkownika do użycia | DatabaseIdentityUserAssignedIdentities |
DatabaseIdentityUserAssignedIdentities
| Nazwa | Opis | Wartość |
|---|
Właściwości bazy danych
| Nazwa | Opis | Wartość |
|---|---|---|
| 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. | struna |
| 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. |
"Kopiuj" "Wartość domyślna" "OnlineSecondary" "PointInTimeRestore" "Odzyskiwanie" "Przywracanie" "RestoreExternalBackup" "RestoreExternalBackupSecondary" "RestoreLongTermRetentionBackup" "Pomocnicza" |
| elasticPoolId | Identyfikator zasobu elastycznej puli zawierającej tę bazę danych. | struna |
| federatedClientId | Identyfikator klienta używany dla scenariusza cmK dla dzierżawy między dzierżawami bazy danych | struna Ograniczenia: Minimalna długość = 36 Maksymalna długość = 36 Wzorzec = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| highAvailabilityReplicaCount | Liczba replik pomocniczych skojarzonych z bazą danych, które są używane do zapewnienia wysokiej dostępności. Nie dotyczy bazy danych w warstwie Hiperskala w puli elastycznej. | Int |
| isLedgerOn | Niezależnie od tego, czy ta baza danych jest bazą danych rejestru, co oznacza, że wszystkie tabele w bazie danych są tabelami rejestru. Uwaga: nie można zmienić wartości tej właściwości po utworzeniu bazy danych. | Bool |
| licenseType | Typ licencji do zastosowania dla tej bazy danych.
LicenseIncluded, jeśli potrzebujesz licencji lub BasePrice, jeśli 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. | struna |
| maintenanceConfigurationId | Identyfikator konfiguracji konserwacji przypisany do bazy danych. Ta konfiguracja określa okres, w których będą wykonywane aktualizacje konserwacji. | struna |
| 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 |
| preferredEnclaveType | Typ enklawy żądanej w bazie danych, tj. domyślne lub enklawy VBS. | "Wartość domyślna" "VBS" |
| readScale | Stan routingu tylko do odczytu. Jeśli ta opcja jest włączona, połączenia, które mają intencję aplikacji ustawioną na odczyt w parametrach połączenia, mogą być kierowane do repliki pomocniczej tylko do odczytu w tym samym regionie. Nie dotyczy bazy danych w warstwie Hiperskala w puli elastycznej. | "Wyłączone" "Włączone" |
| recoverableDatabaseId | Identyfikator zasobu możliwej do odzyskania bazy danych skojarzonej z operacją tworzenia tej bazy danych. | struna |
| recoveryServicesRecoveryPointId | Identyfikator zasobu punktu odzyskiwania skojarzonego z operacją tworzenia tej bazy danych. | struna |
| requestedBackupStorageRedundancy | Typ konta magazynu, który ma być używany do przechowywania kopii zapasowych dla tej bazy danych. | "Geo" "GeoZone" "Lokalny" "Strefa" |
| restorableDroppedDatabaseId | Identyfikator zasobu usuniętej bazy danych skojarzonej z operacją tworzenia tej bazy danych. | struna |
| restorePointInTime | Określa punkt w czasie (ISO8601 format) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych. | struna |
| sampleName | Nazwa przykładowego schematu, który ma być stosowany podczas tworzenia tej bazy danych. | "AdventureWorksLT" "WideWorldImportersFull" "WideWorldImportersStd" |
| secondaryType | Pomocniczy typ bazy danych, jeśli jest pomocniczy. Prawidłowe wartości to Geo, Named i Standby. | "Geo" "Nazwane" "Wstrzymanie" |
| sourceDatabaseDeletionDate | Określa czas usunięcia bazy danych. | struna |
| sourceDatabaseId | Identyfikator zasobu źródłowej bazy danych skojarzonej z operacją tworzenia tej bazy danych. | struna |
| sourceResourceId | Identyfikator zasobu źródła skojarzonego z operacją tworzenia tej bazy danych. Ta właściwość jest obsługiwana tylko w przypadku wersji DataWarehouse i umożliwia przywracanie między subskrypcjami. Jeśli parametr sourceResourceId jest określony, parametr sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId i sourceDatabaseDeletionDate nie może być określony, a właściwość CreateMode musi być typu PointInTimeRestore, Restore lub Recover. Jeśli parametr createMode to PointInTimeRestore, parametr sourceResourceId musi być identyfikatorem zasobu istniejącej bazy danych lub istniejącej puli SQL, a należy określić parametr restorePointInTime. Gdy tryb createMode to Restore, identyfikator sourceResourceId musi być identyfikatorem zasobu przywracalnej usuniętej bazy danych lub można przywrócić porzuconą pulę SQL. Gdy tryb createMode jest odzyskiwane, identyfikator sourceResourceId musi być identyfikatorem zasobu możliwej do odzyskania bazy danych lub możliwej do odzyskania puli SQL. Jeśli subskrypcja źródłowa należy do innej dzierżawy niż subskrypcja docelowa, nagłówek "x-ms-authorization-auxiliary" musi zawierać token uwierzytelniania dla dzierżawy źródłowej. Aby uzyskać więcej informacji na temat nagłówka "x-ms-authorization-auxiliary", zobacz /azure/azure-resource-manager/management/authenticate-multi-tenant |
struna |
| 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 |
DatabaseUserIdentity
| Nazwa | Opis | Wartość |
|---|
Microsoft.Sql/servers/databases
| Nazwa | Opis | Wartość |
|---|---|---|
| tożsamość | Tożsamość usługi Azure Active Directory bazy danych. | DatabaseIdentity |
| lokalizacja | Lokalizacja zasobu. | ciąg (wymagany) |
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| parent_id | Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. | Identyfikator zasobu typu: serwerów |
| Właściwości | Właściwości zasobu. | DatabaseProperties |
| Numer jednostki magazynowej | 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 twojej subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu API REST Capabilities_ListByLocation lub jednego z następujących poleceń:azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />programu PowerShellGet-AzSqlServerServiceObjective -Location <lokalizacji> ```` |
sku |
| Tagi | Tagi zasobów | Słownik nazw tagów i wartości. |
| typ | Typ zasobu | "Microsoft.Sql/servers/databases@2022-05-01-preview" |
Numer jednostki magazynowej
| Nazwa | Opis | Wartość |
|---|---|---|
| pojemność | Pojemność określonej jednostki SKU. | Int |
| rodzina | Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj. | struna |
| nazwa | Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3. | ciąg (wymagany) |
| rozmiar | Rozmiar konkretnej jednostki SKU | struna |
| kondygnacja | Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. | struna |
TrackedResourceTags
| Nazwa | Opis | Wartość |
|---|