خوادم/قواعد بيانات Microsoft.Sql

تعريف مورد Bicep

يمكن نشر نوع مورد الخوادم/قواعد البيانات مع العمليات التي تستهدف:

مجموعات الموارد - راجع أوامر نشر مجموعة الموارد

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

تنسيق المورد

لإنشاء مورد Microsoft.Sql/servers/databases، أضف Bicep التالي إلى القالب الخاص بك.

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

قيم الخصائص

Microsoft.Sql/servers/databases

Name	Description	Value
identity	هوية Azure Active Directory لقاعدة البيانات.	DatabaseIdentity
location	موقع المورد.	سلسلة (مطلوب)
name	اسم المورد	سلسلة (مطلوب)
parent	في Bicep، يمكنك تحديد المورد الأصل لمورد تابع. تحتاج فقط إلى إضافة هذه الخاصية عند الإعلان عن المورد التابع خارج المورد الأصل. لمزيد من المعلومات، راجع مورد تابع خارج المورد الأصل.	اسم رمزي للمورد من النوع: خوادم
properties	خصائص المورد.	DatabaseProperties
sku	قاعدة بيانات SKU. قد تختلف قائمة وحدات SKU حسب المنطقة وعرض الدعم. لتحديد وحدات SKU (بما في ذلك اسم SKU والطبقة/الإصدار والعائلة والسعة) المتوفرة لاشتراكك في منطقة Azure، استخدم `Capabilities_ListByLocation` واجهة برمجة تطبيقات REST أو أحد الأوامر التالية: azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />باور شيل <موقع Get-AzSqlServerServiceObjective -Location> ````	Sku
tags	علامات الموارد	قاموس أسماء العلامات والقيم. راجع العلامات في القوالب

DatabaseIdentity

Name	Description	Value
type	نوع الهوية	'None' 'UserAssigned'
userAssignedIdentities	معرفات الموارد للهويات المعينة للمستخدم لاستخدامها	DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Name	Description	Value

DatabaseKey

Name	Description	Value

DatabaseProperties

Name	Description	Value
autoPauseDelay	الوقت بالدقائق التي يتم بعدها إيقاف قاعدة البيانات مؤقتا تلقائيا. تعني قيمة -1 أنه تم تعطيل الإيقاف المؤقت التلقائي	int
availabilityZone	تحديد منطقة التوفر التي تم تثبيت قاعدة البيانات عليها.	'1' '2' '3' 'NoPreference'
catalogCollation	ترتيب كتالوج بيانات التعريف.	'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS'
collation	ترتيب قاعدة البيانات.	string
createMode	تحديد وضع إنشاء قاعدة البيانات. الافتراضي: إنشاء قاعدة بيانات عادية. نسخ: ينشئ قاعدة بيانات كنسخة من قاعدة بيانات موجودة. يجب تحديد sourceDatabaseId كمعرف المورد لقاعدة البيانات المصدر. ثانوي: ينشئ قاعدة بيانات كنسخة متماثلة ثانوية من قاعدة بيانات موجودة. يجب تحديد sourceDatabaseId كمعرف المورد لقاعدة البيانات الأساسية الموجودة. PointInTimeRestore: ينشئ قاعدة بيانات عن طريق استعادة نسخة احتياطية لنقطة زمنية لقاعدة بيانات موجودة. يجب تحديد sourceDatabaseId كمعرف المورد لقاعدة البيانات الموجودة، ويجب تحديد restorePointInTime. الاسترداد: ينشئ قاعدة بيانات عن طريق استعادة نسخة احتياطية منسوخة جغرافيا. يجب تحديد sourceDatabaseId كمعرف مورد قاعدة بيانات قابل للاسترداد لاستعادته. استعادة: إنشاء قاعدة بيانات عن طريق استعادة نسخة احتياطية من قاعدة بيانات محذوفة. يجب تحديد sourceDatabaseId. إذا كان sourceDatabaseId هو معرف المورد الأصلي لقاعدة البيانات، فيجب تحديد sourceDatabaseDeletionDate. وإلا يجب أن يكون sourceDatabaseId معرف مورد قاعدة البيانات الذي تم إسقاطه قابلا للاستعادة ويتم تجاهل sourceDatabaseDeletionDate. قد يتم أيضا تحديد restorePointInTime للاستعادة من نقطة زمنية سابقة. RestoreLongTermRetentionBackup: ينشئ قاعدة بيانات عن طريق الاستعادة من مخزن استبقاء طويل المدى. يجب تحديد recoveryServicesRecoveryPointResourceId كمعرف مورد نقطة الاسترداد. النسخ والثانوي والاستعادةLongTermRetentionBackup غير مدعومة لإصدار DataWarehouse.	'Copy' 'Default' 'OnlineSecondary' 'PointInTimeRestore' 'Recovery' 'Restore' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secondary'
elasticPoolId	معرف المورد للمجموعة المرنة التي تحتوي على قاعدة البيانات هذه.	string
encryptionProtector	عنوان URI لمخزن مفاتيح azure لقاعدة البيانات إذا تم تكوينه باستخدام المفاتيح المدارة لعميل قاعدة البيانات.	string
encryptionProtectorAutoRotation	العلامة لتمكين أو تعطيل التدوير التلقائي لمفتاح AKV لأداة حماية تشفير قاعدة البيانات.	bool
federatedClientId	معرف العميل المستخدم للمستأجر المشترك لكل سيناريو CMK لقاعدة البيانات	string Constraints: الحد الأدنى للطول = 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 المستخدمة لتوفير قابلية وصول عالية. لا ينطبق على قاعدة بيانات Hyperscale داخل تجمع مرن.	int
isLedgerOn	ما إذا كانت قاعدة البيانات هذه قاعدة بيانات دفتر الأستاذ أم لا، مما يعني أن جميع الجداول في قاعدة البيانات هي جداول دفتر الأستاذ. ملاحظة: لا يمكن تغيير قيمة هذه الخاصية بعد إنشاء قاعدة البيانات.	bool
keys	معرفات الموارد للهويات المعينة للمستخدم لاستخدامها	DatabasePropertiesKeys
licenseType	نوع الترخيص الذي يجب تطبيقه على قاعدة البيانات هذه. `LicenseIncluded` إذا كنت بحاجة إلى ترخيص، أو `BasePrice` إذا كان لديك ترخيص وكنت مؤهلا للحصول على Azure Hybrid Benefit.	'BasePrice' 'LicenseIncluded'
longTermRetentionBackupResourceId	معرف المورد للنسخ الاحتياطي الاستبقاء طويل المدى المرتبط بإنشاء عملية قاعدة البيانات هذه.	string
maintenanceConfigurationId	معرف تكوين الصيانة المعين لقاعدة البيانات. يحدد هذا التكوين الفترة التي ستحدث فيها تحديثات الصيانة.	string
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	معرف المورد لقاعدة البيانات القابلة للاسترداد المقترنة بإنشاء عملية قاعدة البيانات هذه.	string
recoveryServicesRecoveryPointId	معرف المورد لنقطة الاسترداد المقترنة بإنشاء عملية قاعدة البيانات هذه.	string
requestedBackupStorageRedundancy	نوع حساب التخزين الذي سيتم استخدامه لتخزين النسخ الاحتياطية لقاعدة البيانات هذه.	'Geo' 'GeoZone' 'Local' 'Zone'
restorableDroppedDatabaseId	معرف المورد لقاعدة البيانات التي تم إسقاطها القابلة للاستعادة المقترنة بإنشاء عملية قاعدة البيانات هذه.	string
restorePointInTime	تحديد النقطة الزمنية (تنسيق ISO8601) لقاعدة البيانات المصدر التي ستتم استعادتها لإنشاء قاعدة البيانات الجديدة.	string
sampleName	اسم نموذج المخطط لتطبيقه عند إنشاء قاعدة البيانات هذه.	'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd'
secondaryType	النوع الثانوي لقاعدة البيانات إذا كانت ثانوية. القيم الصالحة هي Geo و Named و Standby.	'Geo' 'Named' 'Standby'
sourceDatabaseDeletionDate	تحديد الوقت الذي تم فيه حذف قاعدة البيانات.	string
sourceDatabaseId	معرف المورد لقاعدة البيانات المصدر المقترنة بإنشاء عملية قاعدة البيانات هذه.	string
sourceResourceId	معرف المورد للمصدر المقترن بعملية إنشاء قاعدة البيانات هذه. هذه الخاصية مدعومة فقط لإصدار DataWarehouse وتسمح بالاستعادة عبر الاشتراكات. عند تحديد sourceResourceId، يجب عدم تحديد sourceDatabaseId، recoverableDatabaseId، restoreableDroppedDatabaseId و sourceDatabaseDeletionDate ويجب أن يكون CreateMode PointInTimeRestore أو Restore أو Recover. عندما يكون createMode PointInTimeRestore، يجب أن يكون sourceResourceId هو معرف المورد لقاعدة البيانات الموجودة أو تجمع sql الموجود، ويجب تحديد restorePointInTime. عندما يكون createMode هو Restore، يجب أن يكون sourceResourceId معرف المورد لقاعدة البيانات التي تم إسقاطها القابلة للاستعادة أو تجمع sql المسقط القابل للاستعادة. عندما يكون createMode هو Recover، يجب أن يكون sourceResourceId هو معرف المورد لقاعدة البيانات القابلة للاسترداد أو تجمع sql القابل للاسترداد. عندما ينتمي اشتراك المصدر إلى مستأجر مختلف عن الاشتراك الهدف، يجب أن يحتوي عنوان "x-ms-authorization-auxiliary" على رمز المصادقة المميز للمستأجر المصدر. لمزيد من التفاصيل حول عنوان "x-ms-authorization-auxiliary"، راجع /azure/azure-resource-manager/management/authenticate-multi-tenant	string
useFreeLimit	ما إذا كانت قاعدة البيانات تستخدم حدودا شهرية مجانية أم لا. مسموح به في قاعدة بيانات واحدة في اشتراك.	bool
zoneRedundant	سواء كانت قاعدة البيانات هذه زائدة عن الحاجة أم لا، ما يعني أن النسخ المتماثلة لقاعدة البيانات هذه ستنتشر عبر مناطق توفر متعددة.	bool

DatabasePropertiesKeys

Name	Description	Value

DatabaseUserIdentity

Name	Description	Value

Sku

Name	Description	Value
capacity	سعة SKU المعينة.	int
family	إذا كانت الخدمة تحتوي على أجيال مختلفة من الأجهزة، لنفس SKU، فيمكن التقاط ذلك هنا.	string
name	اسم SKU، عادة، حرف + رمز رقم، على سبيل المثال P3.	سلسلة (مطلوب)
size	حجم وحدة SKU المعينة	string
tier	مستوى أو إصدار SKU المحدد، على سبيل المثال Basic، Premium.	string

TrackedResourceTags

Name	Description	Value

أمثلة الاستخدام

الوحدات النمطية التي تم التحقق منها من Azure

يمكن استخدام الوحدات النمطية Azure Verified لنشر نوع المورد هذا.

الوحدة النمطية	Description
قاعدة بيانات Azure SQL	وحدة موارد AVM لقاعدة بيانات Azure SQL

نماذج Azure Quickstart

تحتوي قوالب Azure Quickstart التالية على نماذج Bicep لنشر نوع المورد هذا.

ملف Bicep	Description
Azure SQL Server مع التدقيق المكتوب إلى Log Analytics	يسمح لك هذا القالب بنشر خادم Azure SQL مع تمكين التدقيق لكتابة سجلات التدقيق إلى Log Analytics (مساحة عمل OMS)
إنشاء SQL Server وقاعدة بيانات	يسمح لك هذا القالب بإنشاء قاعدة بيانات وخادم SQL.
تجمع SQL مخصص مع تشفير شفاف	إنشاء SQL Server وتجمع SQL مخصص (المعروف سابقا ب SQL DW) مع تشفير البيانات الشفاف.
نشر التحليلات الرياضية على تصميم Azure	إنشاء حساب تخزين Azure مع تمكين ADLS Gen 2، ومثيل Azure Data Factory مع خدمات مرتبطة لحساب التخزين (قاعدة بيانات Azure SQL إذا تم نشرها)، ومثيل Azure Databricks. سيتم منح هوية AAD للمستخدم الذي ينشر القالب والهوية المدارة لمثيل ADF دور Storage Blob Data Contributor على حساب التخزين. هناك أيضا خيارات لنشر مثيل Azure Key Vault وقاعدة بيانات Azure SQL ومركز أحداث Azure (لحالات استخدام البث). عند نشر Azure Key Vault، سيتم منح الهوية المدارة لمصنع البيانات وهوية AAD للمستخدم الذي ينشر القالب دور مستخدم Key Vault Secrets.
مثال نقطة النهاية الخاصة	يوضح هذا القالب كيفية إنشاء نقطة نهاية خاصة تشير إلى Azure SQL Server
توفير تطبيق ويب باستخدام قاعدة بيانات SQL	يقوم هذا القالب بتوفير تطبيق ويب وقاعدة بيانات SQL وإعدادات التحجيم التلقائي وقواعد التنبيه وApp Insights. يقوم بتكوين سلسلة اتصال في تطبيق الويب لقاعدة البيانات.
Sonarqube Docker Web App على Linux باستخدام Azure SQL	ينشر هذا القالب Sonarqube في حاوية Linux لتطبيق ويب Azure App Service باستخدام صورة Sonarqube الرسمية مدعومة من Azure SQL Server.
Web App مع الهوية المدارة وSQL Server و Ι	مثال بسيط لنشر البنية الأساسية ل Azure للتطبيق + البيانات + الهوية المدارة + المراقبة

تعريف مورد قالب ARM

يمكن نشر نوع مورد الخوادم/قواعد البيانات مع العمليات التي تستهدف:

مجموعات الموارد - راجع أوامر نشر مجموعة الموارد

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

تنسيق المورد

لإنشاء مورد Microsoft.Sql/servers/databases، أضف JSON التالي إلى القالب الخاص بك.

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

قيم الخصائص

Microsoft.Sql/servers/databases

Name	Description	Value
apiVersion	إصدار واجهة برمجة التطبيقات	'2024-11-01-preview'
identity	هوية Azure Active Directory لقاعدة البيانات.	DatabaseIdentity
location	موقع المورد.	سلسلة (مطلوب)
name	اسم المورد	سلسلة (مطلوب)
properties	خصائص المورد.	DatabaseProperties
sku	قاعدة بيانات SKU. قد تختلف قائمة وحدات SKU حسب المنطقة وعرض الدعم. لتحديد وحدات SKU (بما في ذلك اسم SKU والطبقة/الإصدار والعائلة والسعة) المتوفرة لاشتراكك في منطقة Azure، استخدم `Capabilities_ListByLocation` واجهة برمجة تطبيقات REST أو أحد الأوامر التالية: azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />باور شيل <موقع Get-AzSqlServerServiceObjective -Location> ````	Sku
tags	علامات الموارد	قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
type	نوع المورد	'Microsoft.Sql/servers/databases'

DatabaseIdentity

Name	Description	Value
type	نوع الهوية	'None' 'UserAssigned'
userAssignedIdentities	معرفات الموارد للهويات المعينة للمستخدم لاستخدامها	DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Name	Description	Value

DatabaseKey

Name	Description	Value

DatabaseProperties

Name	Description	Value
autoPauseDelay	الوقت بالدقائق التي يتم بعدها إيقاف قاعدة البيانات مؤقتا تلقائيا. تعني قيمة -1 أنه تم تعطيل الإيقاف المؤقت التلقائي	int
availabilityZone	تحديد منطقة التوفر التي تم تثبيت قاعدة البيانات عليها.	'1' '2' '3' 'NoPreference'
catalogCollation	ترتيب كتالوج بيانات التعريف.	'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS'
collation	ترتيب قاعدة البيانات.	string
createMode	تحديد وضع إنشاء قاعدة البيانات. الافتراضي: إنشاء قاعدة بيانات عادية. نسخ: ينشئ قاعدة بيانات كنسخة من قاعدة بيانات موجودة. يجب تحديد sourceDatabaseId كمعرف المورد لقاعدة البيانات المصدر. ثانوي: ينشئ قاعدة بيانات كنسخة متماثلة ثانوية من قاعدة بيانات موجودة. يجب تحديد sourceDatabaseId كمعرف المورد لقاعدة البيانات الأساسية الموجودة. PointInTimeRestore: ينشئ قاعدة بيانات عن طريق استعادة نسخة احتياطية لنقطة زمنية لقاعدة بيانات موجودة. يجب تحديد sourceDatabaseId كمعرف المورد لقاعدة البيانات الموجودة، ويجب تحديد restorePointInTime. الاسترداد: ينشئ قاعدة بيانات عن طريق استعادة نسخة احتياطية منسوخة جغرافيا. يجب تحديد sourceDatabaseId كمعرف مورد قاعدة بيانات قابل للاسترداد لاستعادته. استعادة: إنشاء قاعدة بيانات عن طريق استعادة نسخة احتياطية من قاعدة بيانات محذوفة. يجب تحديد sourceDatabaseId. إذا كان sourceDatabaseId هو معرف المورد الأصلي لقاعدة البيانات، فيجب تحديد sourceDatabaseDeletionDate. وإلا يجب أن يكون sourceDatabaseId معرف مورد قاعدة البيانات الذي تم إسقاطه قابلا للاستعادة ويتم تجاهل sourceDatabaseDeletionDate. قد يتم أيضا تحديد restorePointInTime للاستعادة من نقطة زمنية سابقة. RestoreLongTermRetentionBackup: ينشئ قاعدة بيانات عن طريق الاستعادة من مخزن استبقاء طويل المدى. يجب تحديد recoveryServicesRecoveryPointResourceId كمعرف مورد نقطة الاسترداد. النسخ والثانوي والاستعادةLongTermRetentionBackup غير مدعومة لإصدار DataWarehouse.	'Copy' 'Default' 'OnlineSecondary' 'PointInTimeRestore' 'Recovery' 'Restore' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secondary'
elasticPoolId	معرف المورد للمجموعة المرنة التي تحتوي على قاعدة البيانات هذه.	string
encryptionProtector	عنوان URI لمخزن مفاتيح azure لقاعدة البيانات إذا تم تكوينه باستخدام المفاتيح المدارة لعميل قاعدة البيانات.	string
encryptionProtectorAutoRotation	العلامة لتمكين أو تعطيل التدوير التلقائي لمفتاح AKV لأداة حماية تشفير قاعدة البيانات.	bool
federatedClientId	معرف العميل المستخدم للمستأجر المشترك لكل سيناريو CMK لقاعدة البيانات	string Constraints: الحد الأدنى للطول = 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 المستخدمة لتوفير قابلية وصول عالية. لا ينطبق على قاعدة بيانات Hyperscale داخل تجمع مرن.	int
isLedgerOn	ما إذا كانت قاعدة البيانات هذه قاعدة بيانات دفتر الأستاذ أم لا، مما يعني أن جميع الجداول في قاعدة البيانات هي جداول دفتر الأستاذ. ملاحظة: لا يمكن تغيير قيمة هذه الخاصية بعد إنشاء قاعدة البيانات.	bool
keys	معرفات الموارد للهويات المعينة للمستخدم لاستخدامها	DatabasePropertiesKeys
licenseType	نوع الترخيص الذي يجب تطبيقه على قاعدة البيانات هذه. `LicenseIncluded` إذا كنت بحاجة إلى ترخيص، أو `BasePrice` إذا كان لديك ترخيص وكنت مؤهلا للحصول على Azure Hybrid Benefit.	'BasePrice' 'LicenseIncluded'
longTermRetentionBackupResourceId	معرف المورد للنسخ الاحتياطي الاستبقاء طويل المدى المرتبط بإنشاء عملية قاعدة البيانات هذه.	string
maintenanceConfigurationId	معرف تكوين الصيانة المعين لقاعدة البيانات. يحدد هذا التكوين الفترة التي ستحدث فيها تحديثات الصيانة.	string
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	معرف المورد لقاعدة البيانات القابلة للاسترداد المقترنة بإنشاء عملية قاعدة البيانات هذه.	string
recoveryServicesRecoveryPointId	معرف المورد لنقطة الاسترداد المقترنة بإنشاء عملية قاعدة البيانات هذه.	string
requestedBackupStorageRedundancy	نوع حساب التخزين الذي سيتم استخدامه لتخزين النسخ الاحتياطية لقاعدة البيانات هذه.	'Geo' 'GeoZone' 'Local' 'Zone'
restorableDroppedDatabaseId	معرف المورد لقاعدة البيانات التي تم إسقاطها القابلة للاستعادة المقترنة بإنشاء عملية قاعدة البيانات هذه.	string
restorePointInTime	تحديد النقطة الزمنية (تنسيق ISO8601) لقاعدة البيانات المصدر التي ستتم استعادتها لإنشاء قاعدة البيانات الجديدة.	string
sampleName	اسم نموذج المخطط لتطبيقه عند إنشاء قاعدة البيانات هذه.	'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd'
secondaryType	النوع الثانوي لقاعدة البيانات إذا كانت ثانوية. القيم الصالحة هي Geo و Named و Standby.	'Geo' 'Named' 'Standby'
sourceDatabaseDeletionDate	تحديد الوقت الذي تم فيه حذف قاعدة البيانات.	string
sourceDatabaseId	معرف المورد لقاعدة البيانات المصدر المقترنة بإنشاء عملية قاعدة البيانات هذه.	string
sourceResourceId	معرف المورد للمصدر المقترن بعملية إنشاء قاعدة البيانات هذه. هذه الخاصية مدعومة فقط لإصدار DataWarehouse وتسمح بالاستعادة عبر الاشتراكات. عند تحديد sourceResourceId، يجب عدم تحديد sourceDatabaseId، recoverableDatabaseId، restoreableDroppedDatabaseId و sourceDatabaseDeletionDate ويجب أن يكون CreateMode PointInTimeRestore أو Restore أو Recover. عندما يكون createMode PointInTimeRestore، يجب أن يكون sourceResourceId هو معرف المورد لقاعدة البيانات الموجودة أو تجمع sql الموجود، ويجب تحديد restorePointInTime. عندما يكون createMode هو Restore، يجب أن يكون sourceResourceId معرف المورد لقاعدة البيانات التي تم إسقاطها القابلة للاستعادة أو تجمع sql المسقط القابل للاستعادة. عندما يكون createMode هو Recover، يجب أن يكون sourceResourceId هو معرف المورد لقاعدة البيانات القابلة للاسترداد أو تجمع sql القابل للاسترداد. عندما ينتمي اشتراك المصدر إلى مستأجر مختلف عن الاشتراك الهدف، يجب أن يحتوي عنوان "x-ms-authorization-auxiliary" على رمز المصادقة المميز للمستأجر المصدر. لمزيد من التفاصيل حول عنوان "x-ms-authorization-auxiliary"، راجع /azure/azure-resource-manager/management/authenticate-multi-tenant	string
useFreeLimit	ما إذا كانت قاعدة البيانات تستخدم حدودا شهرية مجانية أم لا. مسموح به في قاعدة بيانات واحدة في اشتراك.	bool
zoneRedundant	سواء كانت قاعدة البيانات هذه زائدة عن الحاجة أم لا، ما يعني أن النسخ المتماثلة لقاعدة البيانات هذه ستنتشر عبر مناطق توفر متعددة.	bool

DatabasePropertiesKeys

Name	Description	Value

DatabaseUserIdentity

Name	Description	Value

Sku

Name	Description	Value
capacity	سعة SKU المعينة.	int
family	إذا كانت الخدمة تحتوي على أجيال مختلفة من الأجهزة، لنفس SKU، فيمكن التقاط ذلك هنا.	string
name	اسم SKU، عادة، حرف + رمز رقم، على سبيل المثال P3.	سلسلة (مطلوب)
size	حجم وحدة SKU المعينة	string
tier	مستوى أو إصدار SKU المحدد، على سبيل المثال Basic، Premium.	string

TrackedResourceTags

Name	Description	Value

أمثلة الاستخدام

قوالب Azure Quickstart

قوالب Azure Quickstart التالية توزيع نوع المورد هذا.

Template	Description
Azure SQL Server مع التدقيق المكتوب إلى Log Analytics	يسمح لك هذا القالب بنشر خادم Azure SQL مع تمكين التدقيق لكتابة سجلات التدقيق إلى Log Analytics (مساحة عمل OMS)
إنشاء SQL Server وقاعدة بيانات	يسمح لك هذا القالب بإنشاء قاعدة بيانات وخادم SQL.
تجمع SQL مخصص مع تشفير شفاف	إنشاء SQL Server وتجمع SQL مخصص (المعروف سابقا ب SQL DW) مع تشفير البيانات الشفاف.
نشر تجمع SQL Elastic جديد	يسمح لك هذا القالب بنشر تجمع SQL Elastic جديد مع SQL Server المقترن الجديد وقواعد بيانات SQL الجديدة لتعيينها إليه.
نشر التحليلات الرياضية على تصميم Azure	إنشاء حساب تخزين Azure مع تمكين ADLS Gen 2، ومثيل Azure Data Factory مع خدمات مرتبطة لحساب التخزين (قاعدة بيانات Azure SQL إذا تم نشرها)، ومثيل Azure Databricks. سيتم منح هوية AAD للمستخدم الذي ينشر القالب والهوية المدارة لمثيل ADF دور Storage Blob Data Contributor على حساب التخزين. هناك أيضا خيارات لنشر مثيل Azure Key Vault وقاعدة بيانات Azure SQL ومركز أحداث Azure (لحالات استخدام البث). عند نشر Azure Key Vault، سيتم منح الهوية المدارة لمصنع البيانات وهوية AAD للمستخدم الذي ينشر القالب دور مستخدم Key Vault Secrets.
HDInsight مع Ambari مخصص + قاعدة بيانات Hive Metastore في VNET	يسمح لك هذا القالب بإنشاء مجموعة HDInsight في شبكة ظاهرية موجودة مع قاعدة بيانات SQL جديدة تعمل كقاعدة بيانات Ambari مخصصة وHive Metastore. يجب أن يكون لديك SQL Sever وحساب تخزين وVNET موجود.
مثال نقطة النهاية الخاصة	يوضح هذا القالب كيفية إنشاء نقطة نهاية خاصة تشير إلى Azure SQL Server
توفير تطبيق ويب باستخدام قاعدة بيانات SQL	يقوم هذا القالب بتوفير تطبيق ويب وقاعدة بيانات SQL وإعدادات التحجيم التلقائي وقواعد التنبيه وApp Insights. يقوم بتكوين سلسلة اتصال في تطبيق الويب لقاعدة البيانات.
خدمات سطح المكتب البعيد مع قابلية وصول عالية	سينشر نموذج التعليمات البرمجية لقالب ARM هذا Remote Desktop Services 2019 Session Collection معمل ذي قابلية وصول عالية. الهدف هو نشر حل متكرر بالكامل ومتاح بشكل كبير لخدمات سطح المكتب البعيد، باستخدام Windows Server 2019.
Sonarqube Docker Web App على Linux باستخدام Azure SQL	ينشر هذا القالب Sonarqube في حاوية Linux لتطبيق ويب Azure App Service باستخدام صورة Sonarqube الرسمية مدعومة من Azure SQL Server.
Web App مع الهوية المدارة وSQL Server و Ι	مثال بسيط لنشر البنية الأساسية ل Azure للتطبيق + البيانات + الهوية المدارة + المراقبة
WebApp يستهلك نقطة نهاية خاصة ل Azure SQL	يوضح هذا القالب كيفية إنشاء تطبيق ويب يستهلك نقطة نهاية خاصة تشير إلى Azure SQL Server

تعريف مورد Terraform (موفر AzAPI)

يمكن نشر نوع مورد الخوادم/قواعد البيانات مع العمليات التي تستهدف:

مجموعات الموارد

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

تنسيق المورد

لإنشاء مورد Microsoft.Sql/servers/databases، أضف Terraform التالي إلى القالب الخاص بك.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/servers/databases@2024-11-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    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"
    }
  }
}

قيم الخصائص

Microsoft.Sql/servers/databases

Name	Description	Value
identity	هوية Azure Active Directory لقاعدة البيانات.	DatabaseIdentity
location	موقع المورد.	سلسلة (مطلوب)
name	اسم المورد	سلسلة (مطلوب)
parent_id	معرف المورد الأصل لهذا المورد.	معرف المورد من النوع: خوادم
properties	خصائص المورد.	DatabaseProperties
sku	قاعدة بيانات SKU. قد تختلف قائمة وحدات SKU حسب المنطقة وعرض الدعم. لتحديد وحدات SKU (بما في ذلك اسم SKU والطبقة/الإصدار والعائلة والسعة) المتوفرة لاشتراكك في منطقة Azure، استخدم `Capabilities_ListByLocation` واجهة برمجة تطبيقات REST أو أحد الأوامر التالية: azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br />باور شيل <موقع Get-AzSqlServerServiceObjective -Location> ````	Sku
tags	علامات الموارد	قاموس أسماء العلامات والقيم.
type	نوع المورد	"Microsoft.Sql/servers/databases@2024-11-01-preview"

DatabaseIdentity

Name	Description	Value
type	نوع الهوية	'None' 'UserAssigned'
userAssignedIdentities	معرفات الموارد للهويات المعينة للمستخدم لاستخدامها	DatabaseIdentityUserAssignedIdentities

DatabaseIdentityUserAssignedIdentities

Name	Description	Value

DatabaseKey

Name	Description	Value

DatabaseProperties

Name	Description	Value
autoPauseDelay	الوقت بالدقائق التي يتم بعدها إيقاف قاعدة البيانات مؤقتا تلقائيا. تعني قيمة -1 أنه تم تعطيل الإيقاف المؤقت التلقائي	int
availabilityZone	تحديد منطقة التوفر التي تم تثبيت قاعدة البيانات عليها.	'1' '2' '3' 'NoPreference'
catalogCollation	ترتيب كتالوج بيانات التعريف.	'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS'
collation	ترتيب قاعدة البيانات.	string
createMode	تحديد وضع إنشاء قاعدة البيانات. الافتراضي: إنشاء قاعدة بيانات عادية. نسخ: ينشئ قاعدة بيانات كنسخة من قاعدة بيانات موجودة. يجب تحديد sourceDatabaseId كمعرف المورد لقاعدة البيانات المصدر. ثانوي: ينشئ قاعدة بيانات كنسخة متماثلة ثانوية من قاعدة بيانات موجودة. يجب تحديد sourceDatabaseId كمعرف المورد لقاعدة البيانات الأساسية الموجودة. PointInTimeRestore: ينشئ قاعدة بيانات عن طريق استعادة نسخة احتياطية لنقطة زمنية لقاعدة بيانات موجودة. يجب تحديد sourceDatabaseId كمعرف المورد لقاعدة البيانات الموجودة، ويجب تحديد restorePointInTime. الاسترداد: ينشئ قاعدة بيانات عن طريق استعادة نسخة احتياطية منسوخة جغرافيا. يجب تحديد sourceDatabaseId كمعرف مورد قاعدة بيانات قابل للاسترداد لاستعادته. استعادة: إنشاء قاعدة بيانات عن طريق استعادة نسخة احتياطية من قاعدة بيانات محذوفة. يجب تحديد sourceDatabaseId. إذا كان sourceDatabaseId هو معرف المورد الأصلي لقاعدة البيانات، فيجب تحديد sourceDatabaseDeletionDate. وإلا يجب أن يكون sourceDatabaseId معرف مورد قاعدة البيانات الذي تم إسقاطه قابلا للاستعادة ويتم تجاهل sourceDatabaseDeletionDate. قد يتم أيضا تحديد restorePointInTime للاستعادة من نقطة زمنية سابقة. RestoreLongTermRetentionBackup: ينشئ قاعدة بيانات عن طريق الاستعادة من مخزن استبقاء طويل المدى. يجب تحديد recoveryServicesRecoveryPointResourceId كمعرف مورد نقطة الاسترداد. النسخ والثانوي والاستعادةLongTermRetentionBackup غير مدعومة لإصدار DataWarehouse.	'Copy' 'Default' 'OnlineSecondary' 'PointInTimeRestore' 'Recovery' 'Restore' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' 'Secondary'
elasticPoolId	معرف المورد للمجموعة المرنة التي تحتوي على قاعدة البيانات هذه.	string
encryptionProtector	عنوان URI لمخزن مفاتيح azure لقاعدة البيانات إذا تم تكوينه باستخدام المفاتيح المدارة لعميل قاعدة البيانات.	string
encryptionProtectorAutoRotation	العلامة لتمكين أو تعطيل التدوير التلقائي لمفتاح AKV لأداة حماية تشفير قاعدة البيانات.	bool
federatedClientId	معرف العميل المستخدم للمستأجر المشترك لكل سيناريو CMK لقاعدة البيانات	string Constraints: الحد الأدنى للطول = 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 المستخدمة لتوفير قابلية وصول عالية. لا ينطبق على قاعدة بيانات Hyperscale داخل تجمع مرن.	int
isLedgerOn	ما إذا كانت قاعدة البيانات هذه قاعدة بيانات دفتر الأستاذ أم لا، مما يعني أن جميع الجداول في قاعدة البيانات هي جداول دفتر الأستاذ. ملاحظة: لا يمكن تغيير قيمة هذه الخاصية بعد إنشاء قاعدة البيانات.	bool
keys	معرفات الموارد للهويات المعينة للمستخدم لاستخدامها	DatabasePropertiesKeys
licenseType	نوع الترخيص الذي يجب تطبيقه على قاعدة البيانات هذه. `LicenseIncluded` إذا كنت بحاجة إلى ترخيص، أو `BasePrice` إذا كان لديك ترخيص وكنت مؤهلا للحصول على Azure Hybrid Benefit.	'BasePrice' 'LicenseIncluded'
longTermRetentionBackupResourceId	معرف المورد للنسخ الاحتياطي الاستبقاء طويل المدى المرتبط بإنشاء عملية قاعدة البيانات هذه.	string
maintenanceConfigurationId	معرف تكوين الصيانة المعين لقاعدة البيانات. يحدد هذا التكوين الفترة التي ستحدث فيها تحديثات الصيانة.	string
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	معرف المورد لقاعدة البيانات القابلة للاسترداد المقترنة بإنشاء عملية قاعدة البيانات هذه.	string
recoveryServicesRecoveryPointId	معرف المورد لنقطة الاسترداد المقترنة بإنشاء عملية قاعدة البيانات هذه.	string
requestedBackupStorageRedundancy	نوع حساب التخزين الذي سيتم استخدامه لتخزين النسخ الاحتياطية لقاعدة البيانات هذه.	'Geo' 'GeoZone' 'Local' 'Zone'
restorableDroppedDatabaseId	معرف المورد لقاعدة البيانات التي تم إسقاطها القابلة للاستعادة المقترنة بإنشاء عملية قاعدة البيانات هذه.	string
restorePointInTime	تحديد النقطة الزمنية (تنسيق ISO8601) لقاعدة البيانات المصدر التي ستتم استعادتها لإنشاء قاعدة البيانات الجديدة.	string
sampleName	اسم نموذج المخطط لتطبيقه عند إنشاء قاعدة البيانات هذه.	'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd'
secondaryType	النوع الثانوي لقاعدة البيانات إذا كانت ثانوية. القيم الصالحة هي Geo و Named و Standby.	'Geo' 'Named' 'Standby'
sourceDatabaseDeletionDate	تحديد الوقت الذي تم فيه حذف قاعدة البيانات.	string
sourceDatabaseId	معرف المورد لقاعدة البيانات المصدر المقترنة بإنشاء عملية قاعدة البيانات هذه.	string
sourceResourceId	معرف المورد للمصدر المقترن بعملية إنشاء قاعدة البيانات هذه. هذه الخاصية مدعومة فقط لإصدار DataWarehouse وتسمح بالاستعادة عبر الاشتراكات. عند تحديد sourceResourceId، يجب عدم تحديد sourceDatabaseId، recoverableDatabaseId، restoreableDroppedDatabaseId و sourceDatabaseDeletionDate ويجب أن يكون CreateMode PointInTimeRestore أو Restore أو Recover. عندما يكون createMode PointInTimeRestore، يجب أن يكون sourceResourceId هو معرف المورد لقاعدة البيانات الموجودة أو تجمع sql الموجود، ويجب تحديد restorePointInTime. عندما يكون createMode هو Restore، يجب أن يكون sourceResourceId معرف المورد لقاعدة البيانات التي تم إسقاطها القابلة للاستعادة أو تجمع sql المسقط القابل للاستعادة. عندما يكون createMode هو Recover، يجب أن يكون sourceResourceId هو معرف المورد لقاعدة البيانات القابلة للاسترداد أو تجمع sql القابل للاسترداد. عندما ينتمي اشتراك المصدر إلى مستأجر مختلف عن الاشتراك الهدف، يجب أن يحتوي عنوان "x-ms-authorization-auxiliary" على رمز المصادقة المميز للمستأجر المصدر. لمزيد من التفاصيل حول عنوان "x-ms-authorization-auxiliary"، راجع /azure/azure-resource-manager/management/authenticate-multi-tenant	string
useFreeLimit	ما إذا كانت قاعدة البيانات تستخدم حدودا شهرية مجانية أم لا. مسموح به في قاعدة بيانات واحدة في اشتراك.	bool
zoneRedundant	سواء كانت قاعدة البيانات هذه زائدة عن الحاجة أم لا، ما يعني أن النسخ المتماثلة لقاعدة البيانات هذه ستنتشر عبر مناطق توفر متعددة.	bool

DatabasePropertiesKeys

Name	Description	Value

DatabaseUserIdentity

Name	Description	Value

Sku

Name	Description	Value
capacity	سعة SKU المعينة.	int
family	إذا كانت الخدمة تحتوي على أجيال مختلفة من الأجهزة، لنفس SKU، فيمكن التقاط ذلك هنا.	string
name	اسم SKU، عادة، حرف + رمز رقم، على سبيل المثال P3.	سلسلة (مطلوب)
size	حجم وحدة SKU المعينة	string
tier	مستوى أو إصدار SKU المحدد، على سبيل المثال Basic، Premium.	string

TrackedResourceTags

Name	Description	Value

أمثلة الاستخدام

عينات Terraform

مثال أساسي لنشر قاعدة بيانات MS SQL.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
    azurerm = {
      source = "hashicorp/azurerm"
    }
  }
}

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

variable "administrator_login_password" {
  type        = string
  description = "The administrator login password for the SQL server"
  sensitive   = true
}

data "azurerm_client_config" "current" {
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "server" {
  type      = "Microsoft.Sql/servers@2021-02-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      administratorLogin            = "mradministrator"
      administratorLoginPassword    = var.administrator_login_password
      minimalTlsVersion             = "1.2"
      publicNetworkAccess           = "Enabled"
      restrictOutboundNetworkAccess = "Disabled"
      version                       = "12.0"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

data "azapi_resource_id" "publicMaintenanceConfiguration" {
  type      = "Microsoft.Maintenance/publicMaintenanceConfigurations@2023-04-01"
  parent_id = "/subscriptions/${data.azurerm_client_config.current.subscription_id}"
  name      = "SQL_Default"
}

resource "azapi_resource" "database" {
  type      = "Microsoft.Sql/servers/databases@2021-02-01-preview"
  parent_id = azapi_resource.server.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      autoPauseDelay                   = 0
      createMode                       = "Default"
      elasticPoolId                    = ""
      highAvailabilityReplicaCount     = 0
      isLedgerOn                       = false
      licenseType                      = "LicenseIncluded"
      maintenanceConfigurationId       = data.azapi_resource_id.publicMaintenanceConfiguration.id
      minCapacity                      = 0
      readScale                        = "Disabled"
      requestedBackupStorageRedundancy = "Geo"
      zoneRedundant                    = false
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

مثال أساسي لنشر قاعدة بيانات MS SQL.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
    azurerm = {
      source = "hashicorp/azurerm"
    }
  }
}

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

variable "administrator_login_password" {
  type        = string
  description = "The administrator login password for the SQL server"
  sensitive   = true
}

data "azurerm_client_config" "current" {
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "server" {
  type      = "Microsoft.Sql/servers@2021-02-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      administratorLogin            = "mradministrator"
      administratorLoginPassword    = var.administrator_login_password
      minimalTlsVersion             = "1.2"
      publicNetworkAccess           = "Enabled"
      restrictOutboundNetworkAccess = "Disabled"
      version                       = "12.0"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

data "azapi_resource_id" "publicMaintenanceConfiguration" {
  type      = "Microsoft.Maintenance/publicMaintenanceConfigurations@2023-04-01"
  parent_id = "/subscriptions/${data.azurerm_client_config.current.subscription_id}"
  name      = "SQL_Default"
}

resource "azapi_resource" "database" {
  type      = "Microsoft.Sql/servers/databases@2021-02-01-preview"
  parent_id = azapi_resource.server.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      autoPauseDelay                   = 0
      createMode                       = "Default"
      elasticPoolId                    = ""
      highAvailabilityReplicaCount     = 0
      isLedgerOn                       = false
      licenseType                      = "LicenseIncluded"
      maintenanceConfigurationId       = data.azapi_resource_id.publicMaintenanceConfiguration.id
      minCapacity                      = 0
      readScale                        = "Disabled"
      requestedBackupStorageRedundancy = "Geo"
      zoneRedundant                    = false
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

الملاحظات

هل كانت هذه الصفحة مفيدة؟

Last updated on 2025-07-28

مشاركة عبر

خوادم/قواعد بيانات Microsoft.Sql

تعريف مورد Bicep

تنسيق المورد

قيم الخصائص

Microsoft.Sql/servers/databases

DatabaseIdentity

DatabaseIdentityUserAssignedIdentities

DatabaseKey

DatabaseProperties

DatabasePropertiesKeys

DatabaseUserIdentity

Sku

TrackedResourceTags

أمثلة الاستخدام

الوحدات النمطية التي تم التحقق منها من Azure

نماذج Azure Quickstart

تعريف مورد قالب ARM

تنسيق المورد

قيم الخصائص

Microsoft.Sql/servers/databases

DatabaseIdentity

DatabaseIdentityUserAssignedIdentities

DatabaseKey

DatabaseProperties

DatabasePropertiesKeys

DatabaseUserIdentity

Sku

TrackedResourceTags

أمثلة الاستخدام

قوالب Azure Quickstart

تعريف مورد Terraform (موفر AzAPI)

تنسيق المورد

قيم الخصائص

Microsoft.Sql/servers/databases

DatabaseIdentity

DatabaseIdentityUserAssignedIdentities

DatabaseKey

DatabaseProperties

DatabasePropertiesKeys

DatabaseUserIdentity

Sku

TrackedResourceTags

أمثلة الاستخدام

عينات Terraform

الملاحظات

الموارد الإضافية