Share via


Microsoft.Sql managedInstances

Bicep kaynak tanımı

managedInstances kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.Sql/managedInstances kaynağı oluşturmak için şablonunuza aşağıdaki Bicep'i ekleyin.

resource symbolicname 'Microsoft.Sql/managedInstances@2023-05-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    administratorLogin: 'string'
    administratorLoginPassword: 'string'
    administrators: {
      administratorType: 'ActiveDirectory'
      azureADOnlyAuthentication: bool
      login: 'string'
      principalType: 'string'
      sid: 'string'
      tenantId: 'string'
    }
    authenticationMetadata: 'string'
    collation: 'string'
    databaseFormat: 'string'
    dnsZonePartner: 'string'
    hybridSecondaryUsage: 'string'
    instancePoolId: 'string'
    isGeneralPurposeV2: bool
    keyId: 'string'
    licenseType: 'string'
    maintenanceConfigurationId: 'string'
    managedInstanceCreateMode: 'string'
    minimalTlsVersion: 'string'
    pricingModel: 'string'
    primaryUserAssignedIdentityId: 'string'
    proxyOverride: 'string'
    publicDataEndpointEnabled: bool
    requestedBackupStorageRedundancy: 'string'
    restorePointInTime: 'string'
    servicePrincipal: {
      type: 'string'
    }
    sourceManagedInstanceId: 'string'
    storageIOps: int
    storageSizeInGB: int
    storageThroughputMBps: int
    subnetId: 'string'
    timezoneId: 'string'
    vCores: int
    zoneRedundant: bool
  }
}

Özellik değerleri

managedInstances

Ad Açıklama Değer
name Kaynak adı dize (gerekli)

Karakter sınırı: 1-63

Geçerli karakterler:
Küçük harfler, rakamlar ve kısa çizgiler.

Kısa çizgiyle başlayamaz veya bitemez.

Kaynak adı Azure genelinde benzersiz olmalıdır.
location Kaynak konumu. dize (gerekli)
etiketler Kaynak etiketleri. Etiket adlarının ve değerlerinin sözlüğü. Bkz . Şablonlardaki etiketler
Sku Yönetilen örnek SKU'su. sku.name için izin verilen değerler: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH Sku
identity Yönetilen örneğin Azure Active Directory kimliği. ResourceIdentity
properties Kaynak özellikleri. ManagedInstanceProperties

ResourceIdentity

Ad Açıklama Değer
tür Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory sorumlusu oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın. 'Yok'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Ad Açıklama Değer
{özelleştirilmiş özellik} UserIdentity

UserIdentity

Bu nesne dağıtım sırasında ayarlanacağı herhangi bir özellik içermez. Tüm özellikler Salt Okunur'dır.

ManagedInstanceProperties

Ad Açıklama Değer
administratorLogin Yönetilen örneğin yönetici kullanıcı adı. Yalnızca yönetilen örnek oluşturulurken belirtilebilir (ve oluşturma için gereklidir). string
administratorLoginPassword Yönetici oturum açma parolası (yönetilen örnek oluşturmak için gereklidir). string

Kısıtlama -ları:
Hassas değer. Güvenli parametre olarak geçirin.
Yöneticiler Örneğin Azure Active Directory yöneticisi. Bu yalnızca örnek oluşturma zamanında kullanılabilir. Örnek güncelleştirmesi için kullanılırsa yoksayılır veya hataya neden olur. Güncelleştirmeler için tek tek API'lerin kullanılması gerekir. ManagedInstanceExternalAdministrator
authenticationMetadata Yönetilen örneğin kimlik doğrulaması meta veri arama modu. 'AzureAD'
'Eşleştirilmiş'
'Windows'
Harmanlama Yönetilen örneğin harmanlanması. string
databaseFormat SQL altyapısı sürümüne özgü örnek veritabanlarının iç biçimini belirtir. 'AlwaysUpToDate'
'SQLServer2022'
dnsZonePartner Bu yönetilen örnek oluşturulduktan sonra DNS bölgesi paylaşılacak olan başka bir yönetilen örneğin kaynak kimliği. string
hybridSecondaryUsage Karma ikincil kullanım. Olası değerler :'Etkin' (varsayılan değer) ve 'Pasif'tir (müşteri ikincil değeri Pasif DR olarak kullanır). 'Etkin'
'Pasif'
instancePoolId Bu yönetilen sunucunun ait olduğu örnek havuzunun kimliği. string
isGeneralPurposeV2 Bunun Genel Amaçlı sürümünün GPv2 çeşidi olup olmadığı. bool
keyId Şifreleme için kullanılacak anahtarın CMK URI'si. string
licenseType Lisans türü. Olası değerler şunlardır: 'LicenseIncluded' (yeni SQL lisansı dahil olmak üzere normal fiyat) ve 'BasePrice' (kendi SQL lisanslarınızı getirmek için indirimli AHB fiyatı). 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Bu yönetilen örneğe uygulanacak bakım yapılandırma kimliğini belirtir. string
managedInstanceCreateMode Veritabanı oluşturma modunu belirtir.

Varsayılan: Normal örnek oluşturma.

Geri Yükleme: Bir dizi yedeklemeyi belirli bir noktaya geri yükleyerek bir örnek oluşturur. RestorePointInTime ve SourceManagedInstanceId belirtilmelidir.
'Varsayılan'
'PointInTimeRestore'
minimalTlsVersion En düşük TLS sürümü. İzin verilen değerler: 'Yok', '1.0', '1.1', '1.2' string
pricingModel Hava durumu veya Yönetilen Örnek değil freemium'dır. 'Freemium'
'Normal'
primaryUserAssignedIdentityId Varsayılan olarak kullanılacak kullanıcı tarafından atanan kimliğin kaynak kimliği. string
proxyOverride Örneğe bağlanmak için kullanılan bağlantı türü. 'Varsayılan'
'Proxy'
'Yeniden Yönlendirme'
publicDataEndpointEnabled Genel veri uç noktasının etkinleştirilip etkinleştirilmediği. bool
requestedBackupStorageRedundancy Bu örneğin yedeklerini depolamak için kullanılacak depolama hesabı türü. Seçenekler Şunlardır: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) ve GeoZone(GeoZoneRedundantStorage) 'Geo'
'GeoZone'
'Yerel'
'Bölge'
restorePointInTime Yeni veritabanını oluşturmak için geri yüklenecek kaynak veritabanının zaman noktasını (ISO8601 biçimi) belirtir. string
servicePrincipal Yönetilen örneğin hizmet sorumlusu. ServicePrincipal
sourceManagedInstanceId Bu örneğin oluşturma işlemiyle ilişkili kaynak yönetilen örneğin kaynak tanımlayıcısı. string
storageIOps Depolama IOps. En düşük değer: 120. En yüksek değer: 120000. Yalnızca 1 IOps'lık artışlara izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır. int
storageSizeInGB GB cinsinden depolama boyutu. En düşük değer: 32. En yüksek değer: 16384. Yalnızca 32 GB artışa izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır. int
storageThroughputMBps MB/sn'de depolama aktarım hızı. En düşük değer: 25. Maksimum değer: 4000. Yalnızca 1 MB/sn artışa izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır. int
subnetId Yönetilen örneğin alt ağ kaynak kimliği. string
timezoneId Saat diliminin kimliği. İzin verilen değerler Windows tarafından desteklenen saat dilimleridir.
Windows, kimlik de dahil olmak üzere desteklenen saat dilimleriyle ilgili ayrıntıları kayıt defterinde
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones.
SELECT name AS timezone_id FROM sys.time_zone_info sorgulayarak bu kayıt defteri değerlerini SQL Server aracılığıyla alabilirsiniz.
Kimlik listesi, PowerShell'de [System.TimeZoneInfo]::GetSystemTimeZones() yürütülerek de elde edilebilir.
Geçerli saat dilimi kimliğine örnek olarak "Pasifik Standart Saati" veya "W. Avrupa Standart Saati".
string
Sanal çekirdekler Sanal çekirdek sayısı. İzin verilen değerler: 8, 16, 24, 32, 40, 64, 80. int
zoneRedundant multi-az'nin etkinleştirilip etkinleştirilmediği. bool

ManagedInstanceExternalAdministrator

Ad Açıklama Değer
administratorType Sunucu yöneticisinin türü. 'ActiveDirectory'
azureADOnlyAuthentication Yalnızca Azure Active Directory Kimlik Doğrulaması etkinleştirildi. bool
oturum aç Sunucu yöneticisinin oturum açma adı. string
principalType Sunucu yöneticisinin Asıl Türü. 'Uygulama'
'Grup'
'Kullanıcı'
Sid Sunucu yöneticisinin SID (nesne kimliği). string

Kısıtlama -ları:
En az uzunluk = 36
Maksimum uzunluk = 36
Desen = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
tenantId Yöneticinin kiracı kimliği. string

Kısıtlama -ları:
En az uzunluk = 36
Maksimum uzunluk = 36
Desen = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ServicePrincipal

Ad Açıklama Değer
tür Hizmet sorumlusu türü. 'Yok'
'SystemAssigned'

Sku

Ad Açıklama Değer
capacity Belirli bir SKU'nun kapasitesi. int
aile Hizmetin aynı SKU için farklı nesil donanımları varsa, bu burada yakalanabilir. string
name SKU adı, genellikle bir harf + Sayı kodu, örneğin P3. dize (gerekli)
boyut Belirli bir SKU'nun boyutu string
tier Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü. string

Hızlı başlangıç şablonları

Aşağıdaki hızlı başlangıç şablonları bu kaynak türünü dağıtır.

Şablon Description
Ağ ile SQL Yönetilen Örneği dağıtma

Azure’a dağıtın
Azure SQL Yönetilen Örneği desteklemek ve Yönetilen Örneği dağıtmak için UDR ve NSG dağıtma
Yeni sanal ağ içinde SQL MI oluşturma

Azure’a dağıtın
Azure Sql Veritabanı Yönetilen Örneği'ni (SQL MI) yeni Sanal Ağ dağıtın.
Günlüklerin ve ölçümlerin yapılandırılmış gönderilmesiyle SQL MI oluşturma

Azure’a dağıtın
Bu şablon, günlükleri ve ölçümleri (tanılama çalışma alanı, depolama hesabı, olay hub'ı) depolamak için kullanılan SQL MI ve ek kaynakları dağıtmanıza olanak tanır.
Yeni sanal ağ içinde sıçrama kutusu ile SQL MI oluşturma

Azure’a dağıtın
Yeni Sanal Ağ içinde SSMS ile Azure Sql Veritabanı Yönetilen Örneği (SQL MI) ve JumpBox'ı dağıtın.
Noktadan siteye bağlantı yapılandırılmış SQL MI oluşturma

Azure’a dağıtın
Yeni sanal ağ içinde noktadan siteye bağlantı için yapılandırılmış Azure Sql Veritabanı Yönetilen Örneği (SQL MI) ve Sanal ağ geçidini dağıtın.

ARM şablonu kaynak tanımı

managedInstances kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.Sql/managedInstances kaynağı oluşturmak için şablonunuza aşağıdaki JSON'u ekleyin.

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2023-05-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "administratorLogin": "string",
    "administratorLoginPassword": "string",
    "administrators": {
      "administratorType": "ActiveDirectory",
      "azureADOnlyAuthentication": "bool",
      "login": "string",
      "principalType": "string",
      "sid": "string",
      "tenantId": "string"
    },
    "authenticationMetadata": "string",
    "collation": "string",
    "databaseFormat": "string",
    "dnsZonePartner": "string",
    "hybridSecondaryUsage": "string",
    "instancePoolId": "string",
    "isGeneralPurposeV2": "bool",
    "keyId": "string",
    "licenseType": "string",
    "maintenanceConfigurationId": "string",
    "managedInstanceCreateMode": "string",
    "minimalTlsVersion": "string",
    "pricingModel": "string",
    "primaryUserAssignedIdentityId": "string",
    "proxyOverride": "string",
    "publicDataEndpointEnabled": "bool",
    "requestedBackupStorageRedundancy": "string",
    "restorePointInTime": "string",
    "servicePrincipal": {
      "type": "string"
    },
    "sourceManagedInstanceId": "string",
    "storageIOps": "int",
    "storageSizeInGB": "int",
    "storageThroughputMBps": "int",
    "subnetId": "string",
    "timezoneId": "string",
    "vCores": "int",
    "zoneRedundant": "bool"
  }
}

Özellik değerleri

managedInstances

Ad Açıklama Değer
tür Kaynak türü 'Microsoft.Sql/managedInstances'
apiVersion Kaynak API'sinin sürümü '2023-05-01-preview'
name Kaynak adı dize (gerekli)

Karakter sınırı: 1-63

Geçerli karakterler:
Küçük harfler, rakamlar ve kısa çizgiler.

Kısa çizgiyle başlayamaz veya bitemez.

Kaynak adı Azure genelinde benzersiz olmalıdır.
location Kaynak konumu. dize (gerekli)
etiketler Kaynak etiketleri. Etiket adlarının ve değerlerinin sözlüğü. Bkz . Şablonlardaki etiketler
Sku Yönetilen örnek SKU'su. sku.name için izin verilen değerler: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH Sku
identity Yönetilen örneğin Azure Active Directory kimliği. ResourceIdentity
properties Kaynak özellikleri. ManagedInstanceProperties

ResourceIdentity

Ad Açıklama Değer
tür Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory sorumlusu oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın. 'Yok'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Ad Açıklama Değer
{özelleştirilmiş özellik} UserIdentity

UserIdentity

Bu nesne dağıtım sırasında ayarlanacağı herhangi bir özellik içermez. Tüm özellikler Salt Okunur'dır.

ManagedInstanceProperties

Ad Açıklama Değer
administratorLogin Yönetilen örneğin yönetici kullanıcı adı. Yalnızca yönetilen örnek oluşturulurken belirtilebilir (ve oluşturma için gereklidir). string
administratorLoginPassword Yönetici oturum açma parolası (yönetilen örnek oluşturmak için gereklidir). string

Kısıtlama -ları:
Hassas değer. Güvenli parametre olarak geçirin.
Yöneticiler Örneğin Azure Active Directory yöneticisi. Bu yalnızca örnek oluşturma zamanında kullanılabilir. Örnek güncelleştirmesi için kullanılırsa yoksayılır veya hataya neden olur. Güncelleştirmeler için tek tek API'lerin kullanılması gerekir. ManagedInstanceExternalAdministrator
authenticationMetadata Yönetilen örneğin kimlik doğrulaması meta veri arama modu. 'AzureAD'
'Eşlendi'
'Windows'
Harmanlama Yönetilen örneğin harmanlanması. string
databaseFormat SQL altyapısı sürümüne özgü örnek veritabanlarının iç biçimini belirtir. 'AlwaysUpToDate'
'SQLServer2022'
dnsZonePartner Bu yönetilen örneğin oluşturulduktan sonra DNS bölgesini paylaşacağı başka bir yönetilen örneğin kaynak kimliği. string
hybridSecondaryUsage Karma ikincil kullanım. Olası değerler :'Etkin' (varsayılan değer) ve 'Pasif'tir (müşteri ikincil değeri Pasif DR olarak kullanır). 'Etkin'
'Pasif'
instancePoolId Bu yönetilen sunucunun ait olduğu örnek havuzunun kimliği. string
isGeneralPurposeV2 Bunun Genel Amaçlı sürümünün GPv2 çeşidi olup olmadığı. bool
keyId Şifreleme için kullanılacak anahtarın CMK URI'si. string
licenseType Lisans türü. Olası değerler şunlardır: 'LicenseIncluded' (yeni SQL lisansı dahil olmak üzere normal fiyat) ve 'BasePrice' (kendi SQL lisanslarınızı getirmek için indirimli AHB fiyatı). 'BasePrice'
'LicenseIncluded'
maintenanceConfigurationId Bu yönetilen örneğe uygulanacak bakım yapılandırma kimliğini belirtir. string
managedInstanceCreateMode Veritabanı oluşturma modunu belirtir.

Varsayılan: Normal örnek oluşturma.

Geri Yükleme: Bir dizi yedeklemeyi belirli bir noktaya geri yükleyerek bir örnek oluşturur. RestorePointInTime ve SourceManagedInstanceId belirtilmelidir.
'Varsayılan'
'PointInTimeRestore'
minimalTlsVersion En düşük TLS sürümü. İzin verilen değerler: 'Yok', '1.0', '1.1', '1.2' string
pricingModel Hava durumu veya Yönetilen Örnek değil freemium'dır. 'Freemium'
'Normal'
primaryUserAssignedIdentityId Varsayılan olarak kullanılacak kullanıcı tarafından atanan kimliğin kaynak kimliği. string
proxyOverride Örneğe bağlanmak için kullanılan bağlantı türü. 'Varsayılan'
'Proxy'
'Yeniden Yönlendirme'
publicDataEndpointEnabled Genel veri uç noktasının etkinleştirilip etkinleştirilmediği. bool
requestedBackupStorageRedundancy Bu örneğin yedeklerini depolamak için kullanılacak depolama hesabı türü. Seçenekler Şunlardır: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) ve GeoZone(GeoZoneRedundantStorage) 'Geo'
'GeoZone'
'Yerel'
'Bölge'
restorePointInTime Yeni veritabanını oluşturmak için geri yüklenecek kaynak veritabanının zaman noktasını (ISO8601 biçimi) belirtir. string
servicePrincipal Yönetilen örneğin hizmet sorumlusu. ServicePrincipal
sourceManagedInstanceId Bu örneğin oluşturma işlemiyle ilişkili kaynak yönetilen örneğin kaynak tanımlayıcısı. string
storageIOps Depolama IOps. En düşük değer: 120. En yüksek değer: 120000. Yalnızca 1 IOps'lık artışlara izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır. int
storageSizeInGB GB cinsinden depolama boyutu. En düşük değer: 32. En yüksek değer: 16384. Yalnızca 32 GB artışa izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır. int
storageThroughputMBps MB/sn'de depolama aktarım hızı. En düşük değer: 25. Maksimum değer: 4000. Yalnızca 1 MB/sn artışa izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır. int
subnetId Yönetilen örneğin alt ağ kaynak kimliği. string
timezoneId Saat diliminin kimliği. İzin verilen değerler Windows tarafından desteklenen saat dilimleridir.
Windows, kimlik de dahil olmak üzere desteklenen saat dilimleriyle ilgili ayrıntıları kayıt defterinde
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones.
SELECT name AS timezone_id FROM sys.time_zone_info sorgulayarak bu kayıt defteri değerlerini SQL Server aracılığıyla alabilirsiniz.
Kimlik listesi, PowerShell'de [System.TimeZoneInfo]::GetSystemTimeZones() yürütülerek de elde edilebilir.
Geçerli saat dilimi kimliğine örnek olarak "Pasifik Standart Saati" veya "W. Avrupa Standart Saati".
string
Sanal çekirdekler Sanal çekirdek sayısı. İzin verilen değerler: 8, 16, 24, 32, 40, 64, 80. int
zoneRedundant multi-az'nin etkinleştirilip etkinleştirilmediği. bool

ManagedInstanceExternalAdministrator

Ad Açıklama Değer
administratorType Sunucu yöneticisinin türü. 'ActiveDirectory'
azureADOnlyAuthentication Yalnızca Azure Active Directory Kimlik Doğrulaması etkinleştirildi. bool
oturum aç Sunucu yöneticisinin oturum açma adı. string
principalType Sunucu yöneticisinin Asıl Türü. 'Uygulama'
'Grup'
'Kullanıcı'
Sid Sunucu yöneticisinin SID (nesne kimliği). string

Kısıtlama -ları:
En az uzunluk = 36
Maksimum uzunluk = 36
Desen = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
tenantId Yöneticinin kiracı kimliği. string

Kısıtlama -ları:
En az uzunluk = 36
Maksimum uzunluk = 36
Desen = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ServicePrincipal

Ad Açıklama Değer
tür Hizmet sorumlusu türü. 'Yok'
'SystemAssigned'

Sku

Ad Açıklama Değer
capacity Belirli bir SKU'nun kapasitesi. int
aile Hizmetin aynı SKU için farklı nesil donanımları varsa, bu burada yakalanabilir. string
name SKU adı, genellikle bir harf + Sayı kodu, örneğin P3. dize (gerekli)
boyut Belirli bir SKU'nun boyutu string
tier Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü. string

Hızlı başlangıç şablonları

Aşağıdaki hızlı başlangıç şablonları bu kaynak türünü dağıtır.

Şablon Description
Ağ ile SQL Yönetilen Örneği dağıtma

Azure’a dağıtın
Azure SQL Yönetilen Örneği desteklemek ve Yönetilen Örneği dağıtmak için UDR ve NSG dağıtma
Yeni sanal ağ içinde SQL MI oluşturma

Azure’a dağıtın
Azure Sql Veritabanı Yönetilen Örneği'ni (SQL MI) yeni Sanal Ağ dağıtın.
Günlüklerin ve ölçümlerin yapılandırılmış gönderilmesiyle SQL MI oluşturma

Azure’a dağıtın
Bu şablon, günlükleri ve ölçümleri (tanılama çalışma alanı, depolama hesabı, olay hub'ı) depolamak için kullanılan SQL MI ve ek kaynakları dağıtmanıza olanak tanır.
Yeni sanal ağ içinde sıçrama kutusu ile SQL MI oluşturma

Azure’a dağıtın
Yeni Sanal Ağ içinde SSMS ile Azure Sql Veritabanı Yönetilen Örneği (SQL MI) ve JumpBox'ı dağıtın.
Noktadan siteye bağlantı yapılandırılmış SQL MI oluşturma

Azure’a dağıtın
Yeni sanal ağ içinde noktadan siteye bağlantı için yapılandırılmış Azure Sql Veritabanı Yönetilen Örneği (SQL MI) ve Sanal ağ geçidini dağıtın.

Terraform (AzAPI sağlayıcısı) kaynak tanımı

managedInstances kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • Kaynak grupları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.Sql/managedInstances kaynağı oluşturmak için şablonunuza aşağıdaki Terraform'u ekleyin.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2023-05-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      administratorLogin = "string"
      administratorLoginPassword = "string"
      administrators = {
        administratorType = "ActiveDirectory"
        azureADOnlyAuthentication = bool
        login = "string"
        principalType = "string"
        sid = "string"
        tenantId = "string"
      }
      authenticationMetadata = "string"
      collation = "string"
      databaseFormat = "string"
      dnsZonePartner = "string"
      hybridSecondaryUsage = "string"
      instancePoolId = "string"
      isGeneralPurposeV2 = bool
      keyId = "string"
      licenseType = "string"
      maintenanceConfigurationId = "string"
      managedInstanceCreateMode = "string"
      minimalTlsVersion = "string"
      pricingModel = "string"
      primaryUserAssignedIdentityId = "string"
      proxyOverride = "string"
      publicDataEndpointEnabled = bool
      requestedBackupStorageRedundancy = "string"
      restorePointInTime = "string"
      servicePrincipal = {
        type = "string"
      }
      sourceManagedInstanceId = "string"
      storageIOps = int
      storageSizeInGB = int
      storageThroughputMBps = int
      subnetId = "string"
      timezoneId = "string"
      vCores = int
      zoneRedundant = bool
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  })
}

Özellik değerleri

managedInstances

Ad Açıklama Değer
tür Kaynak türü "Microsoft.Sql/managedInstances@2023-05-01-preview"
name Kaynak adı dize (gerekli)

Karakter sınırı: 1-63

Geçerli karakterler:
Küçük harfler, rakamlar ve kısa çizgiler.

Kısa çizgiyle başlayamaz veya bitemez.

Kaynak adı Azure genelinde benzersiz olmalıdır.
location Kaynak konumu. dize (gerekli)
parent_id Bir kaynak grubuna dağıtmak için bu kaynak grubunun kimliğini kullanın. dize (gerekli)
etiketler Kaynak etiketleri. Etiket adlarının ve değerlerinin sözlüğü.
Sku Yönetilen örnek SKU'su. sku.name için izin verilen değerler: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH Sku
identity Yönetilen örneğin Azure Active Directory kimliği. ResourceIdentity
properties Kaynak özellikleri. ManagedInstanceProperties

ResourceIdentity

Ad Açıklama Değer
tür Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory sorumlusu oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın. "SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned"
identity_ids Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri Kullanıcı kimliği kimlikleri dizisi.

ResourceIdentityUserAssignedIdentities

Ad Açıklama Değer
{özelleştirilmiş özellik} UserIdentity

UserIdentity

Bu nesne dağıtım sırasında ayarlanacağı herhangi bir özellik içermez. Tüm özellikler Salt Okunur'dır.

ManagedInstanceProperties

Ad Açıklama Değer
administratorLogin Yönetilen örneğin yönetici kullanıcı adı. Yalnızca yönetilen örnek oluşturulurken belirtilebilir (ve oluşturma için gereklidir). string
administratorLoginPassword Yönetici oturum açma parolası (yönetilen örnek oluşturmak için gereklidir). string

Kısıtlama -ları:
Hassas değer. Güvenli parametre olarak geçirin.
Yöneticiler Örneğin Azure Active Directory yöneticisi. Bu yalnızca örnek oluşturma zamanında kullanılabilir. Örnek güncelleştirmesi için kullanılırsa yoksayılır veya hataya neden olur. Güncelleştirmeler için tek tek API'lerin kullanılması gerekir. ManagedInstanceExternalAdministrator
authenticationMetadata Yönetilen örneğin kimlik doğrulaması meta veri arama modu. "AzureAD"
"Eşleştirilmiş"
"Windows"
Harmanlama Yönetilen örneğin harmanlanması. string
databaseFormat SQL altyapısı sürümüne özgü örnek veritabanlarının iç biçimini belirtir. "AlwaysUpToDate"
"SQLServer2022"
dnsZonePartner Bu yönetilen örneğin oluşturulduktan sonra DNS bölgesini paylaşacağı başka bir yönetilen örneğin kaynak kimliği. string
hybridSecondaryUsage Karma ikincil kullanım. Olası değerler şunlardır: 'Etkin' (varsayılan değer) ve 'Pasif' (müşteri ikincili Pasif DR olarak kullanır). "Etkin"
"Pasif"
instancePoolId Bu yönetilen sunucunun ait olduğu örnek havuzunun kimliği. string
isGeneralPurposeV2 Bunun Genel Amaçlı sürümünün GPv2 çeşitlemesi olup olmadığı. bool
keyId Şifreleme için kullanılacak anahtarın CMK URI'si. string
licenseType Lisans türü. Olası değerler şunlardır: 'LicenseIncluded' (yeni SQL lisansı dahil normal fiyat) ve 'BasePrice' (kendi SQL lisanslarınızı getirmek için indirimli AHB fiyatı). "BasePrice"
"LicenseIncluded"
maintenanceConfigurationId Bu yönetilen örneğe uygulanacak bakım yapılandırma kimliğini belirtir. string
managedInstanceCreateMode Veritabanı oluşturma modunu belirtir.

Varsayılan: Normal örnek oluşturma.

Geri Yükleme: Bir dizi yedeklemeyi belirli bir noktaya geri yükleyerek bir örnek oluşturur. RestorePointInTime ve SourceManagedInstanceId belirtilmelidir.
"Varsayılan"
"PointInTimeRestore"
minimalTlsVersion En düşük TLS sürümü. İzin verilen değerler: 'None', '1.0', '1.1', '1.2' string
pricingModel Hava durumu veya Yönetilen Örnek değildir, freemium'dır. "Freemium"
"Normal"
primaryUserAssignedIdentityId Varsayılan olarak kullanılacak kullanıcı tarafından atanan kimliğin kaynak kimliği. string
proxyOverride Örneğe bağlanmak için kullanılan bağlantı türü. "Varsayılan"
"Proxy"
"Yeniden yönlendirme"
publicDataEndpointEnabled Genel veri uç noktasının etkinleştirilip etkinleştirilmediği. bool
requestedBackupStorageRedundancy Bu örneğe yönelik yedeklemeleri depolamak için kullanılacak depolama hesabı türü. Seçenekler Şunlardır: Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) ve GeoZone(GeoZoneRedundantStorage) "Coğrafi"
"GeoZone"
"Yerel"
"Bölge"
restorePointInTime Yeni veritabanını oluşturmak için geri yüklenecek kaynak veritabanının zaman noktasını (ISO8601 biçimi) belirtir. string
servicePrincipal Yönetilen örneğin hizmet sorumlusu. ServicePrincipal
sourceManagedInstanceId Bu örneğin oluşturma işlemiyle ilişkili kaynak yönetilen örneğin kaynak tanımlayıcısı. string
storageIOps Depolama IOps. En düşük değer: 120. Maksimum değer: 120000. Yalnızca 1 IOps'lık artışlara izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır. int
storageSizeInGB GB cinsinden depolama boyutu. En düşük değer: 32. Maksimum değer: 16384. Yalnızca 32 GB'lık artışlara izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır. int
storageThroughputMBps MB/sn'de depolama aktarım hızı. En düşük değer: 25. Maksimum değer: 4000. Yalnızca 1 MB/sn'lik artışlara izin verilir. Maksimum değer, seçilen donanım ailesine ve sanal çekirdek sayısına bağlıdır. int
subnetId Yönetilen örneğin alt ağ kaynak kimliği. string
timezoneId Saat diliminin kimliği. İzin verilen değerler Windows tarafından desteklenen saat dilimleridir.
Windows, kimliği de dahil olmak üzere desteklenen saat dilimleriyle ilgili ayrıntıları kayıt defterinde
KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones.
SELECT name AS timezone_id FROM sys.time_zone_info sorgulayarak bu kayıt defteri değerlerini SQL Server aracılığıyla alabilirsiniz.
Kimlik listesi, PowerShell'de [System.TimeZoneInfo]::GetSystemTimeZones() yürütülerek de alınabilir.
Geçerli saat dilimi kimliğine örnek olarak "Pasifik Standart Saati" veya "W. Avrupa Standart Saati".
string
Sanal çekirdekler Sanal çekirdek sayısı. İzin verilen değerler: 8, 16, 24, 32, 40, 64, 80. int
zoneRedundant multi-az'nin etkinleştirilip etkinleştirilmediği. bool

ManagedInstanceExternalAdministrator

Ad Açıklama Değer
administratorType Sunucu yöneticisinin türü. "ActiveDirectory"
azureADOnlyAuthentication Yalnızca Azure Active Directory Kimlik Doğrulaması etkinleştirildi. bool
oturum aç Sunucu yöneticisinin oturum açma adı. string
principalType Sunucu yöneticisinin Asıl Türü. "Uygulama"
"Grup"
"Kullanıcı"
Sid Sunucu yöneticisinin SID (nesne kimliği). string

Kısıtlama -ları:
En az uzunluk = 36
Maksimum uzunluk = 36
Desen = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
tenantId Yöneticinin kiracı kimliği. string

Kısıtlama -ları:
En az uzunluk = 36
Maksimum uzunluk = 36
Desen = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ServicePrincipal

Ad Açıklama Değer
tür Hizmet sorumlusu türü. "Hiçbiri"
"SystemAssigned"

Sku

Ad Açıklama Değer
capacity Belirli bir SKU'nun kapasitesi. int
aile Hizmetin aynı SKU için farklı nesil donanımları varsa, bu burada yakalanabilir. string
name SKU adı, genellikle bir harf + Sayı kodu, örneğin P3. dize (gerekli)
boyut Belirli bir SKU'nun boyutu string
tier Temel, Premium gibi belirli bir SKU'nun katmanı veya sürümü. string