Microsoft.Sql サーバー/データベース
- 最新の を
する - 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
Bicep リソース定義
サーバー/データベースのリソースの種類は、次を対象とする操作でデプロイできます。
- リソース グループの - リソース グループのデプロイ コマンド 参照
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.Sql/servers/databases リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.Sql/servers/databases@2024-05-01-preview' = {
parent: resourceSymbolicName
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
autoPauseDelay: int
availabilityZone: 'string'
catalogCollation: 'string'
collation: 'string'
createMode: 'string'
elasticPoolId: 'string'
encryptionProtector: 'string'
encryptionProtectorAutoRotation: bool
federatedClientId: 'string'
freeLimitExhaustionBehavior: 'string'
highAvailabilityReplicaCount: int
isLedgerOn: bool
keys: {
{customized property}: {}
}
licenseType: 'string'
longTermRetentionBackupResourceId: 'string'
maintenanceConfigurationId: 'string'
manualCutover: bool
maxSizeBytes: int
minCapacity: int
performCutover: bool
preferredEnclaveType: 'string'
readScale: 'string'
recoverableDatabaseId: 'string'
recoveryServicesRecoveryPointId: 'string'
requestedBackupStorageRedundancy: 'string'
restorableDroppedDatabaseId: 'string'
restorePointInTime: 'string'
sampleName: 'string'
secondaryType: 'string'
sourceDatabaseDeletionDate: 'string'
sourceDatabaseId: 'string'
sourceResourceId: 'string'
useFreeLimit: bool
zoneRedundant: bool
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
プロパティ値
DatabaseIdentity
| 名前 | 形容 | 価値 |
|---|---|---|
| 種類 | ID の種類 | 'None' 'UserAssigned' |
| userAssignedIdentities | 使用するユーザー割り当て ID のリソース ID | DatabaseIdentityUserAssignedIdentities |
DatabaseIdentityUserAssignedIdentities
| 名前 | 形容 | 価値 |
|---|
DatabaseKey
| 名前 | 形容 | 価値 |
|---|
DatabaseProperties
| 名前 | 形容 | 価値 |
|---|---|---|
| autoPauseDelay | データベースが自動的に一時停止されるまでの時間 (分)。 -1 の値は、自動一時停止が無効になっていることを意味します | int |
| availabilityZone | データベースがピン留めされる可用性ゾーンを指定します。 | '1' '2' '3' 'NoPreference' |
| catalogCollation | メタデータ カタログの照合順序。 | 'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS' |
| 照合 | データベースの照合順序。 | 糸 |
| createMode | データベースの作成モードを指定します。 既定値: 通常のデータベース作成。 コピー: 既存のデータベースのコピーとしてデータベースを作成します。 sourceDatabaseId は、ソース データベースのリソース ID として指定する必要があります。 セカンダリ: 既存のデータベースのセカンダリ レプリカとしてデータベースを作成します。 sourceDatabaseId は、既存のプライマリ データベースのリソース ID として指定する必要があります。 PointInTimeRestore: 既存のデータベースの特定の時点のバックアップを復元してデータベースを作成します。 sourceDatabaseId を既存のデータベースのリソース ID として指定し、restorePointInTime を指定する必要があります。 復旧: geo レプリケートされたバックアップを復元してデータベースを作成します。 sourceDatabaseId は、復元する回復可能なデータベース リソース ID として指定する必要があります。 復元: 削除されたデータベースのバックアップを復元してデータベースを作成します。 sourceDatabaseId を指定する必要があります。 sourceDatabaseId がデータベースの元のリソース ID である場合は、sourceDatabaseDeletionDate を指定する必要があります。 それ以外の場合、sourceDatabaseId は復元可能な破棄されたデータベース リソース ID である必要があり、sourceDatabaseDeletionDate は無視されます。 restorePointInTime は、以前の時点から復元するように指定することもできます。 RestoreLongTermRetentionBackup: 長期保持コンテナーから復元することでデータベースを作成します。 recoveryServicesRecoveryPointResourceId は、復旧ポイントのリソース ID として指定する必要があります。 DataWarehouse エディションでは、コピー、セカンダリ、RestoreLongTermRetentionBackup はサポートされていません。 |
'Copy' 'Default' 'OnlineSecondary' 'PointInTimeRestore' 'Recovery' 'Restore' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secondary' |
| elasticPoolId | このデータベースを含むエラスティック プールのリソース識別子。 | 糸 |
| encryptionProtector | データベースカスタマー マネージド キーごとに構成されている場合の、データベースの Azure Key Vault URI。 | 糸 |
| encryptionProtectorAutoRotation | データベース暗号化保護機能 AKV キーの自動ローテーションを有効または無効にするフラグ。 | bool |
| federatedClientId | データベース CMK ごとのテナント間のシナリオに使用されるクライアント ID | 糸 制約： 最小長 = 36 最大長 = 36 パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| freeLimitExhaustionBehavior | 空きデータベースに対して毎月の空き制限が使い果たされたときの動作を指定します。 自動一時停止: 残りの月の空き制限が使い果たされると、データベースは自動的に一時停止されます。 BillForUsage: 空き制限が使い果たされると、データベースは引き続きオンラインになり、超過分は課金されます。 |
'AutoPause' 'BillOverUsage' |
| highAvailabilityReplicaCount | 高可用性を提供するために使用される Business Critical、Premium、または Hyperscale Edition データベースに関連付けられているセカンダリ レプリカの数。 エラスティック プール内の Hyperscale データベースには適用されません。 | int |
| isLedgerOn | このデータベースが台帳データベースであるかどうかは、データベース内のすべてのテーブルが台帳テーブルであることを意味します。 注: このプロパティの値は、データベースの作成後は変更できません。 | bool |
| キー | 使用するユーザー割り当て ID のリソース ID | DatabasePropertiesKeys |
| licenseType | このデータベースに適用するライセンスの種類。 ライセンスが必要な場合は LicenseIncluded、ライセンスを所有していて Azure ハイブリッド特典の対象となる場合は BasePrice します。 |
'BasePrice' 'LicenseIncluded' |
| longTermRetentionBackupResourceId | このデータベースの作成操作に関連付けられている長期保有バックアップのリソース識別子。 | 糸 |
| maintenanceConfigurationId | データベースに割り当てられたメンテナンス構成 ID。 この構成では、メンテナンスの更新が行われる期間を定義します。 | 糸 |
| manualCutover | お客様が管理する手動カットオーバーを、データベースの更新操作中に Hyperscale レベルに行う必要があるかどうか。 このプロパティは、データベースを Business Critical/General Purpose/Premium/Standard レベルから Hyperscale レベルにスケーリングする場合にのみ適用されます。 manualCutover を指定すると、スケーリング操作はユーザー入力が Hyperscale データベースへのカットオーバーをトリガーするまで待機します。 カットオーバーをトリガーするには、スケーリング操作が待機状態のときに 'performCutover' パラメーターを指定してください。 |
bool |
| maxSizeBytes | バイト単位で表されるデータベースの最大サイズ。 | int |
| minCapacity | 一時停止されていない場合、データベースが常に割り当てる最小限の容量 | int |
| performCutover | スケーリング操作の進行中に待機状態の間に、顧客が制御する手動カットオーバーをトリガーします。 このプロパティ パラメーターは、'manualCutover' パラメーターと共に開始されるスケーリング操作にのみ適用されます。 このプロパティは、Business Critical/General Purpose/Premium/Standard レベルから Hyperscale レベルへのデータベースのスケーリングが既に進行中の場合にのみ適用されます。 performCutover を指定すると、スケーリング操作によってカットオーバーがトリガーされ、Hyperscale データベースへのロール変更が実行されます。 |
bool |
| preferredEnclaveType | データベースで要求されたエンクレーブの種類 (既定または VBS エンクレーブ)。 | 'Default' 'VBS' |
| readScale | 読み取り専用ルーティングの状態。 有効にした場合、アプリケーションの意図が接続文字列で読み取り専用に設定されている接続は、同じリージョンの読み取り専用セカンダリ レプリカにルーティングされる可能性があります。 エラスティック プール内の Hyperscale データベースには適用されません。 | 'Disabled' 'Enabled' |
| recoverableDatabaseId | このデータベースの作成操作に関連付けられている回復可能なデータベースのリソース識別子。 | 糸 |
| recoveryServicesRecoveryPointId | このデータベースの作成操作に関連付けられている復旧ポイントのリソース識別子。 | 糸 |
| requestedBackupStorageRedundancy | このデータベースのバックアップを格納するために使用するストレージ アカウントの種類。 | 'Geo' 'GeoZone' 'Local' 'Zone' |
| restorableDroppedDatabaseId | このデータベースの作成操作に関連付けられている、復元可能な削除されたデータベースのリソース識別子。 | 糸 |
| restorePointInTime | 新しいデータベースを作成するために復元されるソース データベースの時点 (ISO8601形式) を指定します。 | 糸 |
| sampleName | このデータベースの作成時に適用するサンプル スキーマの名前。 | 'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd' |
| secondaryType | データベースがセカンダリの場合は、そのセカンダリ の種類。 有効な値は Geo、Named、Standby です。 | 'Geo' 'Named' 'スタンバイ' |
| sourceDatabaseDeletionDate | データベースが削除された時刻を指定します。 | 糸 |
| sourceDatabaseId | このデータベースの作成操作に関連付けられているソース データベースのリソース識別子。 | 糸 |
| sourceResourceId | このデータベースの作成操作に関連付けられているソースのリソース識別子。 このプロパティは DataWarehouse エディションでのみサポートされており、サブスクリプション間で復元できます。 sourceResourceId が指定されている場合、sourceDatabaseId、recoverableDatabaseId、restorableDroppedDatabaseId、sourceDatabaseDeletionDate を指定しないでください。CreateMode は PointInTimeRestore、Restore、または Recover である必要があります。 createMode が PointInTimeRestore の場合、sourceResourceId は既存のデータベースまたは既存の SQL プールのリソース ID である必要があり、restorePointInTime を指定する必要があります。 createMode が Restore の場合、sourceResourceId は、復元可能な削除されたデータベースまたは復元可能な削除された SQL プールのリソース ID である必要があります。 createMode が Recover の場合、sourceResourceId は回復可能なデータベースまたは回復可能な SQL プールのリソース ID である必要があります。 ソース サブスクリプションがターゲット サブスクリプションとは異なるテナントに属している場合、"x-ms-authorization-auxiliary" ヘッダーにはソース テナントの認証トークンが含まれている必要があります。 "x-ms-authorization-auxiliary" ヘッダーの詳細については、/azure/azure-resource-manager/management/authenticate-multi-tenant に関するページを参照してください。 |
糸 |
| useFreeLimit | データベースが無料の月次制限を使用しているかどうか。 サブスクリプション内の 1 つのデータベースで許可されます。 | bool |
| zoneRedundant | このデータベースがゾーン冗長かどうか。つまり、このデータベースのレプリカは複数の可用性ゾーンに分散されます。 | bool |
DatabasePropertiesKeys
| 名前 | 形容 | 価値 |
|---|
DatabaseUserIdentity
| 名前 | 形容 | 価値 |
|---|
Microsoft.Sql/servers/databases
| 名前 | 形容 | 価値 |
|---|---|---|
| 同一性 | データベースの Azure Active Directory ID。 | DatabaseIdentity |
| 場所 | リソースの場所。 | string (必須) |
| 名前 | リソース名 | string (必須) |
| 親 | Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。 詳細については、「親リソースの外部 |
種類のリソースのシンボリック名: サーバー |
| プロパティ | リソースのプロパティ。 | DatabaseProperties |
| sku | データベース SKU。 SKU の一覧は、リージョンとサポート プランによって異なる場合があります。 Azure リージョンのサブスクリプションで使用できる SKU (SKU 名、レベル/エディション、ファミリ、容量を含む) を確認するには、 Capabilities_ListByLocation REST API または次のいずれかのコマンドを使用します。powershell の azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />場所 Get-AzSqlServerServiceObjective -Location <> ```` |
SKU |
| タグ | リソース タグ | タグ名と値のディクショナリ。 テンプレート の |
SKU
| 名前 | 形容 | 価値 |
|---|---|---|
| 能力 | 特定の SKU の容量。 | int |
| 家族 | 同じ SKU に対して、サービスの世代が異なるハードウェアがある場合は、ここでキャプチャできます。 | 糸 |
| 名前 | SKU の名前 。通常は、文字 + 番号コード (P3 など)。 | string (必須) |
| 大きさ | 特定の SKU のサイズ | 糸 |
| 層 | 特定の SKU のレベルまたはエディション (Basic、Premium など)。 | 糸 |
TrackedResourceTags
| 名前 | 形容 | 価値 |
|---|
クイック スタートのサンプル
次のクイック スタート サンプルでは、このリソースの種類をデプロイします。
| Bicep ファイル | 形容 |
|---|---|
| Log Analytics に書き込まれた監査を使用して Azure SQL Server を |
このテンプレートを使用すると、監査が有効になっている Azure SQL サーバーをデプロイして、Log Analytics (OMS ワークスペース) に監査ログを書き込むことができます。 |
| SQL Server とデータベース を作成する | このテンプレートを使用すると、SQL Database とサーバーを作成できます。 |
| Transparent Encryption を使用した専用 SQL プールの |
Transparent Data Encryption を使用して SQL Server と専用 SQL プール (旧称 SQL DW) を作成します。 |
| Azure アーキテクチャ に Sports Analytics をデプロイする |
ADLS Gen 2 が有効な Azure ストレージ アカウント、ストレージ アカウントのリンクされたサービスを持つ Azure Data Factory インスタンス (デプロイされている場合は Azure SQL Database)、Azure Databricks インスタンスを作成します。 テンプレートをデプロイするユーザーの AAD ID と ADF インスタンスのマネージド ID には、ストレージ アカウントのストレージ BLOB データ共同作成者ロールが付与されます。 Azure Key Vault インスタンス、Azure SQL Database、Azure Event Hub (ストリーミングユース ケース用) をデプロイするオプションもあります。 Azure Key Vault がデプロイされると、テンプレートをデプロイするユーザーのデータ ファクトリマネージド ID と AAD ID に Key Vault シークレット ユーザー ロールが付与されます。 |
| プライベート エンドポイントの例 | このテンプレートは、Azure SQL Server を指すプライベート エンドポイントを作成する方法を示しています |
| SQL Database を使用して Web アプリをプロビジョニングする | このテンプレートは、Web アプリ、SQL Database、自動スケール設定、アラート ルール、App Insights をプロビジョニングします。 Web アプリでデータベースの接続文字列を構成します。 |
| Azure SQL を使用して Linux 上の Sonarqube Docker Web App を |
このテンプレートは、公式の Sonarqube イメージを使用して Azure App Service Web アプリ Linux コンテナーに Sonarqube をデプロイし、Azure SQL Server によってサポートされます。 |
| マネージド ID、SQL Server、ΑΙ を使用した Web アプリの |
アプリ + データ + マネージド ID + 監視用の Azure インフラストラクチャをデプロイする簡単な例 |
ARM テンプレート リソース定義
サーバー/データベースのリソースの種類は、次を対象とする操作でデプロイできます。
- リソース グループの - リソース グループのデプロイ コマンド 参照
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.Sql/servers/databases リソースを作成するには、次の JSON をテンプレートに追加します。
{
"type": "Microsoft.Sql/servers/databases",
"apiVersion": "2024-05-01-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"autoPauseDelay": "int",
"availabilityZone": "string",
"catalogCollation": "string",
"collation": "string",
"createMode": "string",
"elasticPoolId": "string",
"encryptionProtector": "string",
"encryptionProtectorAutoRotation": "bool",
"federatedClientId": "string",
"freeLimitExhaustionBehavior": "string",
"highAvailabilityReplicaCount": "int",
"isLedgerOn": "bool",
"keys": {
"{customized property}": {
}
},
"licenseType": "string",
"longTermRetentionBackupResourceId": "string",
"maintenanceConfigurationId": "string",
"manualCutover": "bool",
"maxSizeBytes": "int",
"minCapacity": "int",
"performCutover": "bool",
"preferredEnclaveType": "string",
"readScale": "string",
"recoverableDatabaseId": "string",
"recoveryServicesRecoveryPointId": "string",
"requestedBackupStorageRedundancy": "string",
"restorableDroppedDatabaseId": "string",
"restorePointInTime": "string",
"sampleName": "string",
"secondaryType": "string",
"sourceDatabaseDeletionDate": "string",
"sourceDatabaseId": "string",
"sourceResourceId": "string",
"useFreeLimit": "bool",
"zoneRedundant": "bool"
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
プロパティ値
DatabaseIdentity
| 名前 | 形容 | 価値 |
|---|---|---|
| 種類 | ID の種類 | 'None' 'UserAssigned' |
| userAssignedIdentities | 使用するユーザー割り当て ID のリソース ID | DatabaseIdentityUserAssignedIdentities |
DatabaseIdentityUserAssignedIdentities
| 名前 | 形容 | 価値 |
|---|
DatabaseKey
| 名前 | 形容 | 価値 |
|---|
DatabaseProperties
| 名前 | 形容 | 価値 |
|---|---|---|
| autoPauseDelay | データベースが自動的に一時停止されるまでの時間 (分)。 -1 の値は、自動一時停止が無効になっていることを意味します | int |
| availabilityZone | データベースがピン留めされる可用性ゾーンを指定します。 | '1' '2' '3' 'NoPreference' |
| catalogCollation | メタデータ カタログの照合順序。 | 'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS' |
| 照合 | データベースの照合順序。 | 糸 |
| createMode | データベースの作成モードを指定します。 既定値: 通常のデータベース作成。 コピー: 既存のデータベースのコピーとしてデータベースを作成します。 sourceDatabaseId は、ソース データベースのリソース ID として指定する必要があります。 セカンダリ: 既存のデータベースのセカンダリ レプリカとしてデータベースを作成します。 sourceDatabaseId は、既存のプライマリ データベースのリソース ID として指定する必要があります。 PointInTimeRestore: 既存のデータベースの特定の時点のバックアップを復元してデータベースを作成します。 sourceDatabaseId を既存のデータベースのリソース ID として指定し、restorePointInTime を指定する必要があります。 復旧: geo レプリケートされたバックアップを復元してデータベースを作成します。 sourceDatabaseId は、復元する回復可能なデータベース リソース ID として指定する必要があります。 復元: 削除されたデータベースのバックアップを復元してデータベースを作成します。 sourceDatabaseId を指定する必要があります。 sourceDatabaseId がデータベースの元のリソース ID である場合は、sourceDatabaseDeletionDate を指定する必要があります。 それ以外の場合、sourceDatabaseId は復元可能な破棄されたデータベース リソース ID である必要があり、sourceDatabaseDeletionDate は無視されます。 restorePointInTime は、以前の時点から復元するように指定することもできます。 RestoreLongTermRetentionBackup: 長期保持コンテナーから復元することでデータベースを作成します。 recoveryServicesRecoveryPointResourceId は、復旧ポイントのリソース ID として指定する必要があります。 DataWarehouse エディションでは、コピー、セカンダリ、RestoreLongTermRetentionBackup はサポートされていません。 |
'Copy' 'Default' 'OnlineSecondary' 'PointInTimeRestore' 'Recovery' 'Restore' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secondary' |
| elasticPoolId | このデータベースを含むエラスティック プールのリソース識別子。 | 糸 |
| encryptionProtector | データベースカスタマー マネージド キーごとに構成されている場合の、データベースの Azure Key Vault URI。 | 糸 |
| encryptionProtectorAutoRotation | データベース暗号化保護機能 AKV キーの自動ローテーションを有効または無効にするフラグ。 | bool |
| federatedClientId | データベース CMK ごとのテナント間のシナリオに使用されるクライアント ID | 糸 制約： 最小長 = 36 最大長 = 36 パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| freeLimitExhaustionBehavior | 空きデータベースに対して毎月の空き制限が使い果たされたときの動作を指定します。 自動一時停止: 残りの月の空き制限が使い果たされると、データベースは自動的に一時停止されます。 BillForUsage: 空き制限が使い果たされると、データベースは引き続きオンラインになり、超過分は課金されます。 |
'AutoPause' 'BillOverUsage' |
| highAvailabilityReplicaCount | 高可用性を提供するために使用される Business Critical、Premium、または Hyperscale Edition データベースに関連付けられているセカンダリ レプリカの数。 エラスティック プール内の Hyperscale データベースには適用されません。 | int |
| isLedgerOn | このデータベースが台帳データベースであるかどうかは、データベース内のすべてのテーブルが台帳テーブルであることを意味します。 注: このプロパティの値は、データベースの作成後は変更できません。 | bool |
| キー | 使用するユーザー割り当て ID のリソース ID | DatabasePropertiesKeys |
| licenseType | このデータベースに適用するライセンスの種類。 ライセンスが必要な場合は LicenseIncluded、ライセンスを所有していて Azure ハイブリッド特典の対象となる場合は BasePrice します。 |
'BasePrice' 'LicenseIncluded' |
| longTermRetentionBackupResourceId | このデータベースの作成操作に関連付けられている長期保有バックアップのリソース識別子。 | 糸 |
| maintenanceConfigurationId | データベースに割り当てられたメンテナンス構成 ID。 この構成では、メンテナンスの更新が行われる期間を定義します。 | 糸 |
| manualCutover | お客様が管理する手動カットオーバーを、データベースの更新操作中に Hyperscale レベルに行う必要があるかどうか。 このプロパティは、データベースを Business Critical/General Purpose/Premium/Standard レベルから Hyperscale レベルにスケーリングする場合にのみ適用されます。 manualCutover を指定すると、スケーリング操作はユーザー入力が Hyperscale データベースへのカットオーバーをトリガーするまで待機します。 カットオーバーをトリガーするには、スケーリング操作が待機状態のときに 'performCutover' パラメーターを指定してください。 |
bool |
| maxSizeBytes | バイト単位で表されるデータベースの最大サイズ。 | int |
| minCapacity | 一時停止されていない場合、データベースが常に割り当てる最小限の容量 | int |
| performCutover | スケーリング操作の進行中に待機状態の間に、顧客が制御する手動カットオーバーをトリガーします。 このプロパティ パラメーターは、'manualCutover' パラメーターと共に開始されるスケーリング操作にのみ適用されます。 このプロパティは、Business Critical/General Purpose/Premium/Standard レベルから Hyperscale レベルへのデータベースのスケーリングが既に進行中の場合にのみ適用されます。 performCutover を指定すると、スケーリング操作によってカットオーバーがトリガーされ、Hyperscale データベースへのロール変更が実行されます。 |
bool |
| preferredEnclaveType | データベースで要求されたエンクレーブの種類 (既定または VBS エンクレーブ)。 | 'Default' 'VBS' |
| readScale | 読み取り専用ルーティングの状態。 有効にした場合、アプリケーションの意図が接続文字列で読み取り専用に設定されている接続は、同じリージョンの読み取り専用セカンダリ レプリカにルーティングされる可能性があります。 エラスティック プール内の Hyperscale データベースには適用されません。 | 'Disabled' 'Enabled' |
| recoverableDatabaseId | このデータベースの作成操作に関連付けられている回復可能なデータベースのリソース識別子。 | 糸 |
| recoveryServicesRecoveryPointId | このデータベースの作成操作に関連付けられている復旧ポイントのリソース識別子。 | 糸 |
| requestedBackupStorageRedundancy | このデータベースのバックアップを格納するために使用するストレージ アカウントの種類。 | 'Geo' 'GeoZone' 'Local' 'Zone' |
| restorableDroppedDatabaseId | このデータベースの作成操作に関連付けられている、復元可能な削除されたデータベースのリソース識別子。 | 糸 |
| restorePointInTime | 新しいデータベースを作成するために復元されるソース データベースの時点 (ISO8601形式) を指定します。 | 糸 |
| sampleName | このデータベースの作成時に適用するサンプル スキーマの名前。 | 'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd' |
| secondaryType | データベースがセカンダリの場合は、そのセカンダリ の種類。 有効な値は Geo、Named、Standby です。 | 'Geo' 'Named' 'スタンバイ' |
| sourceDatabaseDeletionDate | データベースが削除された時刻を指定します。 | 糸 |
| sourceDatabaseId | このデータベースの作成操作に関連付けられているソース データベースのリソース識別子。 | 糸 |
| sourceResourceId | このデータベースの作成操作に関連付けられているソースのリソース識別子。 このプロパティは DataWarehouse エディションでのみサポートされており、サブスクリプション間で復元できます。 sourceResourceId が指定されている場合、sourceDatabaseId、recoverableDatabaseId、restorableDroppedDatabaseId、sourceDatabaseDeletionDate を指定しないでください。CreateMode は PointInTimeRestore、Restore、または Recover である必要があります。 createMode が PointInTimeRestore の場合、sourceResourceId は既存のデータベースまたは既存の SQL プールのリソース ID である必要があり、restorePointInTime を指定する必要があります。 createMode が Restore の場合、sourceResourceId は、復元可能な削除されたデータベースまたは復元可能な削除された SQL プールのリソース ID である必要があります。 createMode が Recover の場合、sourceResourceId は回復可能なデータベースまたは回復可能な SQL プールのリソース ID である必要があります。 ソース サブスクリプションがターゲット サブスクリプションとは異なるテナントに属している場合、"x-ms-authorization-auxiliary" ヘッダーにはソース テナントの認証トークンが含まれている必要があります。 "x-ms-authorization-auxiliary" ヘッダーの詳細については、/azure/azure-resource-manager/management/authenticate-multi-tenant に関するページを参照してください。 |
糸 |
| useFreeLimit | データベースが無料の月次制限を使用しているかどうか。 サブスクリプション内の 1 つのデータベースで許可されます。 | bool |
| zoneRedundant | このデータベースがゾーン冗長かどうか。つまり、このデータベースのレプリカは複数の可用性ゾーンに分散されます。 | bool |
DatabasePropertiesKeys
| 名前 | 形容 | 価値 |
|---|
DatabaseUserIdentity
| 名前 | 形容 | 価値 |
|---|
Microsoft.Sql/servers/databases
| 名前 | 形容 | 価値 |
|---|---|---|
| apiVersion | API のバージョン | '2024-05-01-preview' |
| 同一性 | データベースの Azure Active Directory ID。 | DatabaseIdentity |
| 場所 | リソースの場所。 | string (必須) |
| 名前 | リソース名 | string (必須) |
| プロパティ | リソースのプロパティ。 | DatabaseProperties |
| sku | データベース SKU。 SKU の一覧は、リージョンとサポート プランによって異なる場合があります。 Azure リージョンのサブスクリプションで使用できる SKU (SKU 名、レベル/エディション、ファミリ、容量を含む) を確認するには、 Capabilities_ListByLocation REST API または次のいずれかのコマンドを使用します。powershell の azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />場所 Get-AzSqlServerServiceObjective -Location <> ```` |
SKU |
| タグ | リソース タグ | タグ名と値のディクショナリ。 テンプレート の |
| 種類 | リソースの種類 | 'Microsoft.Sql/servers/databases' |
SKU
| 名前 | 形容 | 価値 |
|---|---|---|
| 能力 | 特定の SKU の容量。 | int |
| 家族 | 同じ SKU に対して、サービスの世代が異なるハードウェアがある場合は、ここでキャプチャできます。 | 糸 |
| 名前 | SKU の名前 。通常は、文字 + 番号コード (P3 など)。 | string (必須) |
| 大きさ | 特定の SKU のサイズ | 糸 |
| 層 | 特定の SKU のレベルまたはエディション (Basic、Premium など)。 | 糸 |
TrackedResourceTags
| 名前 | 形容 | 価値 |
|---|
クイック スタート テンプレート
次のクイック スタート テンプレートでは、このリソースの種類をデプロイします。
| テンプレート | 形容 |
|---|---|
| Log Analytics に書き込まれた監査を使用して Azure SQL Server を Azure |
このテンプレートを使用すると、監査が有効になっている Azure SQL サーバーをデプロイして、Log Analytics (OMS ワークスペース) に監査ログを書き込むことができます。 |
|
SQL Server とデータベース を作成する Azure にデプロイする |
このテンプレートを使用すると、SQL Database とサーバーを作成できます。 |
| Transparent Encryption を使用した専用 SQL プールの Azure |
Transparent Data Encryption を使用して SQL Server と専用 SQL プール (旧称 SQL DW) を作成します。 |
|
新しい SQL エラスティック プール をデプロイする Azure にデプロイする |
このテンプレートを使用すると、新しい SQL エラスティック プールと、それに割り当てる新しい SQL Server と新しい SQL Database をデプロイできます。 |
| Azure アーキテクチャ に Sports Analytics をデプロイする Azure |
ADLS Gen 2 が有効な Azure ストレージ アカウント、ストレージ アカウントのリンクされたサービスを持つ Azure Data Factory インスタンス (デプロイされている場合は Azure SQL Database)、Azure Databricks インスタンスを作成します。 テンプレートをデプロイするユーザーの AAD ID と ADF インスタンスのマネージド ID には、ストレージ アカウントのストレージ BLOB データ共同作成者ロールが付与されます。 Azure Key Vault インスタンス、Azure SQL Database、Azure Event Hub (ストリーミングユース ケース用) をデプロイするオプションもあります。 Azure Key Vault がデプロイされると、テンプレートをデプロイするユーザーのデータ ファクトリマネージド ID と AAD ID に Key Vault シークレット ユーザー ロールが付与されます。 |
| VNET でカスタム Ambari + Hive メタストア DB を使用して HDInsight を Azure |
このテンプレートを使用すると、カスタム Ambari DB と Hive Metastore の両方として機能する新しい SQL DB を使用して、既存の仮想ネットワークに HDInsight クラスターを作成できます。 既存の SQL Sever、ストレージ アカウント、VNET が必要です。 |
|
プライベート エンドポイントの例 Azure にデプロイする |
このテンプレートは、Azure SQL Server を指すプライベート エンドポイントを作成する方法を示しています |
|
SQL Database を使用して Web アプリをプロビジョニングする Azure にデプロイする |
このテンプレートは、Web アプリ、SQL Database、自動スケール設定、アラート ルール、App Insights をプロビジョニングします。 Web アプリでデータベースの接続文字列を構成します。 |
| 高可用性 を使用したリモート デスクトップ サービスの Azure |
この ARM テンプレートサンプル コードでは、高可用性を備えた Remote Desktop Services 2019 Session Collection ラボをデプロイします。 目標は、Windows Server 2019 を使用して、リモート デスクトップ サービス用の完全冗長で高可用性のソリューションを展開することです。 |
| Azure SQL を使用して Linux 上の Sonarqube Docker Web App を Azure |
このテンプレートは、公式の Sonarqube イメージを使用して Azure App Service Web アプリ Linux コンテナーに Sonarqube をデプロイし、Azure SQL Server によってサポートされます。 |
| マネージド ID、SQL Server、ΑΙ を使用した Web アプリの Azure |
アプリ + データ + マネージド ID + 監視用の Azure インフラストラクチャをデプロイする簡単な例 |
| Azure SQL プライベート エンドポイント を使用する WebApp の Azure |
このテンプレートでは、Azure SQL Server を指すプライベート エンドポイントを使用する Web アプリを作成する方法を示します |
Terraform (AzAPI プロバイダー) リソース定義
サーバー/データベースのリソースの種類は、次を対象とする操作でデプロイできます。
- リソース グループの
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.Sql/servers/databases リソースを作成するには、次の Terraform をテンプレートに追加します。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Sql/servers/databases@2024-05-01-preview"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
location = "string"
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
autoPauseDelay = int
availabilityZone = "string"
catalogCollation = "string"
collation = "string"
createMode = "string"
elasticPoolId = "string"
encryptionProtector = "string"
encryptionProtectorAutoRotation = bool
federatedClientId = "string"
freeLimitExhaustionBehavior = "string"
highAvailabilityReplicaCount = int
isLedgerOn = bool
keys = {
{customized property} = {
}
}
licenseType = "string"
longTermRetentionBackupResourceId = "string"
maintenanceConfigurationId = "string"
manualCutover = bool
maxSizeBytes = int
minCapacity = int
performCutover = bool
preferredEnclaveType = "string"
readScale = "string"
recoverableDatabaseId = "string"
recoveryServicesRecoveryPointId = "string"
requestedBackupStorageRedundancy = "string"
restorableDroppedDatabaseId = "string"
restorePointInTime = "string"
sampleName = "string"
secondaryType = "string"
sourceDatabaseDeletionDate = "string"
sourceDatabaseId = "string"
sourceResourceId = "string"
useFreeLimit = bool
zoneRedundant = bool
}
})
}
プロパティ値
DatabaseIdentity
| 名前 | 形容 | 価値 |
|---|---|---|
| 種類 | ID の種類 | 'None' 'UserAssigned' |
| userAssignedIdentities | 使用するユーザー割り当て ID のリソース ID | DatabaseIdentityUserAssignedIdentities |
DatabaseIdentityUserAssignedIdentities
| 名前 | 形容 | 価値 |
|---|
DatabaseKey
| 名前 | 形容 | 価値 |
|---|
DatabaseProperties
| 名前 | 形容 | 価値 |
|---|---|---|
| autoPauseDelay | データベースが自動的に一時停止されるまでの時間 (分)。 -1 の値は、自動一時停止が無効になっていることを意味します | int |
| availabilityZone | データベースがピン留めされる可用性ゾーンを指定します。 | '1' '2' '3' 'NoPreference' |
| catalogCollation | メタデータ カタログの照合順序。 | 'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS' |
| 照合 | データベースの照合順序。 | 糸 |
| createMode | データベースの作成モードを指定します。 既定値: 通常のデータベース作成。 コピー: 既存のデータベースのコピーとしてデータベースを作成します。 sourceDatabaseId は、ソース データベースのリソース ID として指定する必要があります。 セカンダリ: 既存のデータベースのセカンダリ レプリカとしてデータベースを作成します。 sourceDatabaseId は、既存のプライマリ データベースのリソース ID として指定する必要があります。 PointInTimeRestore: 既存のデータベースの特定の時点のバックアップを復元してデータベースを作成します。 sourceDatabaseId を既存のデータベースのリソース ID として指定し、restorePointInTime を指定する必要があります。 復旧: geo レプリケートされたバックアップを復元してデータベースを作成します。 sourceDatabaseId は、復元する回復可能なデータベース リソース ID として指定する必要があります。 復元: 削除されたデータベースのバックアップを復元してデータベースを作成します。 sourceDatabaseId を指定する必要があります。 sourceDatabaseId がデータベースの元のリソース ID である場合は、sourceDatabaseDeletionDate を指定する必要があります。 それ以外の場合、sourceDatabaseId は復元可能な破棄されたデータベース リソース ID である必要があり、sourceDatabaseDeletionDate は無視されます。 restorePointInTime は、以前の時点から復元するように指定することもできます。 RestoreLongTermRetentionBackup: 長期保持コンテナーから復元することでデータベースを作成します。 recoveryServicesRecoveryPointResourceId は、復旧ポイントのリソース ID として指定する必要があります。 DataWarehouse エディションでは、コピー、セカンダリ、RestoreLongTermRetentionBackup はサポートされていません。 |
'Copy' 'Default' 'OnlineSecondary' 'PointInTimeRestore' 'Recovery' 'Restore' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secondary' |
| elasticPoolId | このデータベースを含むエラスティック プールのリソース識別子。 | 糸 |
| encryptionProtector | データベースカスタマー マネージド キーごとに構成されている場合の、データベースの Azure Key Vault URI。 | 糸 |
| encryptionProtectorAutoRotation | データベース暗号化保護機能 AKV キーの自動ローテーションを有効または無効にするフラグ。 | bool |
| federatedClientId | データベース CMK ごとのテナント間のシナリオに使用されるクライアント ID | 糸 制約： 最小長 = 36 最大長 = 36 パターン = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| freeLimitExhaustionBehavior | 空きデータベースに対して毎月の空き制限が使い果たされたときの動作を指定します。 自動一時停止: 残りの月の空き制限が使い果たされると、データベースは自動的に一時停止されます。 BillForUsage: 空き制限が使い果たされると、データベースは引き続きオンラインになり、超過分は課金されます。 |
'AutoPause' 'BillOverUsage' |
| highAvailabilityReplicaCount | 高可用性を提供するために使用される Business Critical、Premium、または Hyperscale Edition データベースに関連付けられているセカンダリ レプリカの数。 エラスティック プール内の Hyperscale データベースには適用されません。 | int |
| isLedgerOn | このデータベースが台帳データベースであるかどうかは、データベース内のすべてのテーブルが台帳テーブルであることを意味します。 注: このプロパティの値は、データベースの作成後は変更できません。 | bool |
| キー | 使用するユーザー割り当て ID のリソース ID | DatabasePropertiesKeys |
| licenseType | このデータベースに適用するライセンスの種類。 ライセンスが必要な場合は LicenseIncluded、ライセンスを所有していて Azure ハイブリッド特典の対象となる場合は BasePrice します。 |
'BasePrice' 'LicenseIncluded' |
| longTermRetentionBackupResourceId | このデータベースの作成操作に関連付けられている長期保有バックアップのリソース識別子。 | 糸 |
| maintenanceConfigurationId | データベースに割り当てられたメンテナンス構成 ID。 この構成では、メンテナンスの更新が行われる期間を定義します。 | 糸 |
| manualCutover | お客様が管理する手動カットオーバーを、データベースの更新操作中に Hyperscale レベルに行う必要があるかどうか。 このプロパティは、データベースを Business Critical/General Purpose/Premium/Standard レベルから Hyperscale レベルにスケーリングする場合にのみ適用されます。 manualCutover を指定すると、スケーリング操作はユーザー入力が Hyperscale データベースへのカットオーバーをトリガーするまで待機します。 カットオーバーをトリガーするには、スケーリング操作が待機状態のときに 'performCutover' パラメーターを指定してください。 |
bool |
| maxSizeBytes | バイト単位で表されるデータベースの最大サイズ。 | int |
| minCapacity | 一時停止されていない場合、データベースが常に割り当てる最小限の容量 | int |
| performCutover | スケーリング操作の進行中に待機状態の間に、顧客が制御する手動カットオーバーをトリガーします。 このプロパティ パラメーターは、'manualCutover' パラメーターと共に開始されるスケーリング操作にのみ適用されます。 このプロパティは、Business Critical/General Purpose/Premium/Standard レベルから Hyperscale レベルへのデータベースのスケーリングが既に進行中の場合にのみ適用されます。 performCutover を指定すると、スケーリング操作によってカットオーバーがトリガーされ、Hyperscale データベースへのロール変更が実行されます。 |
bool |
| preferredEnclaveType | データベースで要求されたエンクレーブの種類 (既定または VBS エンクレーブ)。 | 'Default' 'VBS' |
| readScale | 読み取り専用ルーティングの状態。 有効にした場合、アプリケーションの意図が接続文字列で読み取り専用に設定されている接続は、同じリージョンの読み取り専用セカンダリ レプリカにルーティングされる可能性があります。 エラスティック プール内の Hyperscale データベースには適用されません。 | 'Disabled' 'Enabled' |
| recoverableDatabaseId | このデータベースの作成操作に関連付けられている回復可能なデータベースのリソース識別子。 | 糸 |
| recoveryServicesRecoveryPointId | このデータベースの作成操作に関連付けられている復旧ポイントのリソース識別子。 | 糸 |
| requestedBackupStorageRedundancy | このデータベースのバックアップを格納するために使用するストレージ アカウントの種類。 | 'Geo' 'GeoZone' 'Local' 'Zone' |
| restorableDroppedDatabaseId | このデータベースの作成操作に関連付けられている、復元可能な削除されたデータベースのリソース識別子。 | 糸 |
| restorePointInTime | 新しいデータベースを作成するために復元されるソース データベースの時点 (ISO8601形式) を指定します。 | 糸 |
| sampleName | このデータベースの作成時に適用するサンプル スキーマの名前。 | 'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd' |
| secondaryType | データベースがセカンダリの場合は、そのセカンダリ の種類。 有効な値は Geo、Named、Standby です。 | 'Geo' 'Named' 'スタンバイ' |
| sourceDatabaseDeletionDate | データベースが削除された時刻を指定します。 | 糸 |
| sourceDatabaseId | このデータベースの作成操作に関連付けられているソース データベースのリソース識別子。 | 糸 |
| sourceResourceId | このデータベースの作成操作に関連付けられているソースのリソース識別子。 このプロパティは DataWarehouse エディションでのみサポートされており、サブスクリプション間で復元できます。 sourceResourceId が指定されている場合、sourceDatabaseId、recoverableDatabaseId、restorableDroppedDatabaseId、sourceDatabaseDeletionDate を指定しないでください。CreateMode は PointInTimeRestore、Restore、または Recover である必要があります。 createMode が PointInTimeRestore の場合、sourceResourceId は既存のデータベースまたは既存の SQL プールのリソース ID である必要があり、restorePointInTime を指定する必要があります。 createMode が Restore の場合、sourceResourceId は、復元可能な削除されたデータベースまたは復元可能な削除された SQL プールのリソース ID である必要があります。 createMode が Recover の場合、sourceResourceId は回復可能なデータベースまたは回復可能な SQL プールのリソース ID である必要があります。 ソース サブスクリプションがターゲット サブスクリプションとは異なるテナントに属している場合、"x-ms-authorization-auxiliary" ヘッダーにはソース テナントの認証トークンが含まれている必要があります。 "x-ms-authorization-auxiliary" ヘッダーの詳細については、/azure/azure-resource-manager/management/authenticate-multi-tenant に関するページを参照してください。 |
糸 |
| useFreeLimit | データベースが無料の月次制限を使用しているかどうか。 サブスクリプション内の 1 つのデータベースで許可されます。 | bool |
| zoneRedundant | このデータベースがゾーン冗長かどうか。つまり、このデータベースのレプリカは複数の可用性ゾーンに分散されます。 | bool |
DatabasePropertiesKeys
| 名前 | 形容 | 価値 |
|---|
DatabaseUserIdentity
| 名前 | 形容 | 価値 |
|---|
Microsoft.Sql/servers/databases
| 名前 | 形容 | 価値 |
|---|---|---|
| 同一性 | データベースの Azure Active Directory ID。 | DatabaseIdentity |
| 場所 | リソースの場所。 | string (必須) |
| 名前 | リソース名 | string (必須) |
| parent_id | このリソースの親であるリソースの ID。 | 種類のリソースの ID: サーバー |
| プロパティ | リソースのプロパティ。 | DatabaseProperties |
| sku | データベース SKU。 SKU の一覧は、リージョンとサポート プランによって異なる場合があります。 Azure リージョンのサブスクリプションで使用できる SKU (SKU 名、レベル/エディション、ファミリ、容量を含む) を確認するには、 Capabilities_ListByLocation REST API または次のいずれかのコマンドを使用します。powershell の azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />場所 Get-AzSqlServerServiceObjective -Location <> ```` |
SKU |
| タグ | リソース タグ | タグ名と値のディクショナリ。 |
| 種類 | リソースの種類 | "Microsoft.Sql/servers/databases@2024-05-01-preview" |
SKU
| 名前 | 形容 | 価値 |
|---|---|---|
| 能力 | 特定の SKU の容量。 | int |
| 家族 | 同じ SKU に対して、サービスの世代が異なるハードウェアがある場合は、ここでキャプチャできます。 | 糸 |
| 名前 | SKU の名前 。通常は、文字 + 番号コード (P3 など)。 | string (必須) |
| 大きさ | 特定の SKU のサイズ | 糸 |
| 層 | 特定の SKU のレベルまたはエディション (Basic、Premium など)。 | 糸 |
TrackedResourceTags
| 名前 | 形容 | 価値 |
|---|