Microsoft. قاعدة بيانات DocumentDB Accounts/sqlDatabases 2026-03-15

تعريف مورد Bicep

يمكن نشر نوع مورد databaseAccounts/sqlDatabases مع العمليات التي تستهدف:

  • مجموعات الموارد - انظر <أوامر نشر مجموعة الموارد> c1

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

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

عينات Bicep

مثال أساسي لنشر قاعدة بيانات SQL داخل حساب Cosmos DB.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource databaseAccount 'Microsoft.DocumentDB/databaseAccounts@2021-10-15' = {
  name: resourceName
  location: location
  kind: 'GlobalDocumentDB'
  properties: {
    capabilities: []
    consistencyPolicy: {
      defaultConsistencyLevel: 'BoundedStaleness'
      maxIntervalInSeconds: 10
      maxStalenessPrefix: 200
    }
    databaseAccountOfferType: 'Standard'
    defaultIdentity: 'FirstPartyIdentity'
    disableKeyBasedMetadataWriteAccess: false
    disableLocalAuth: false
    enableAnalyticalStorage: false
    enableAutomaticFailover: false
    enableFreeTier: false
    enableMultipleWriteLocations: false
    ipRules: []
    isVirtualNetworkFilterEnabled: false
    locations: [
      {
        failoverPriority: 0
        isZoneRedundant: false
        locationName: 'West Europe'
      }
    ]
    networkAclBypass: 'None'
    networkAclBypassResourceIds: []
    publicNetworkAccess: 'Enabled'
    virtualNetworkRules: []
  }
}

resource sqlDatabase 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2021-10-15' = {
  name: resourceName
  parent: databaseAccount
  properties: {
    options: {
      throughput: 400
    }
    resource: {
      id: resourceName
    }
  }
}

نماذج Azure Quickstart

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

ملف Bicep الوصف
Azure Cosmos DB واجهة برمجة تطبيقات SQL للحساب مع التخزين التحليلي ينشئ هذا القالب حساب Azure Cosmos لواجهة برمجة التطبيقات الأساسية (SQL) مع قاعدة بيانات وحاوية مهيأة بمخزن تحليلي.
أنشئ حساب Azure Cosmos DB مجاني ينشئ هذا القالب حساب Azure Cosmos DB مجاني المستوى لواجهة برمجة تطبيقات SQL مع قاعدة بيانات ذات معدل نقل وحاويات مشتركة.
إنشاء حساب Azure Cosmos DB لواجهة برمجة التطبيقات الأساسية (SQL) ينشئ هذا القالب حساب Azure Cosmos لواجهة برمجة التطبيقات الأساسية (SQL) مع قاعدة بيانات وحاوية مع معدل نقل وخيارات متعددة أخرى.
أنشئ واجهة برمجة تطبيقات SQL لحساب Azure Cosmos DB باستخدام التكبير التلقائي ينشئ هذا القالب واجهة برمجة تطبيقات حساب Azure Cosmos ل Core (SQL) مع قاعدة بيانات وحاوية مع معدل نقل بيانات تلقائي مع خيارات متعددة أخرى.
إنشاء إجراءات مخزنة لواجهة برمجة التطبيقات الأساسية Azure Cosmos DB (SQL) ينشئ هذا القالب حساب Azure Cosmos DB لواجهة برمجة التطبيقات الأساسية (SQL) وحاوية تحتوي على إجراء مخزن، ومشغل، ووظيفة معرفة من قبل المستخدم.
إنشاء تطبيق خدمات Dapr المصغرة باستخدام تطبيقات الحاوية إنشاء تطبيق خدمات Dapr المصغرة باستخدام تطبيقات الحاوية.
ينشئ تطبيق حافلة خدمة pub-sub من Dapr باستخدام تطبيقات الحاوية إنشاء تطبيق Dapr pub-sub servicebus باستخدام Container Apps.
نشر قاعدة بيانات Azure Data Explorer ‏(Kusto) مع اتصال قاعدة بيانات كوزموس نشر Azure Data Explorer ‏(Kusto) DB مع اتصال Cosmos DB.

تنسيق المورد

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

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2026-03-15' = {
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    options: {
      autoscaleSettings: {
        maxThroughput: int
      }
      throughput: int
    }
    resource: {
      createMode: 'string'
      id: 'string'
      restoreParameters: {
        restoreSource: 'string'
        restoreTimestampInUtc: 'string'
        restoreWithTtlDisabled: bool
      }
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

قيم الخصائص

Microsoft.DocumentDB/databaseAccounts/sqlDatabases

اسم الوصف Value
الهوية هوية المورد. ManagedServiceIdentity
مكان موقع مجموعة الموارد التي ينتمي إليها المورد. سلسلة نصية
الاسم اسم المورد سلسلة (مطلوب)
الوالد في Bicep، يمكنك تحديد المورد الأصل لمورد تابع. تحتاج فقط إلى إضافة هذه الخاصية عند الإعلان عن المورد التابع خارج المورد الأصل.

لمزيد من المعلومات، راجع Child Resource External Parent resource.
الاسم الرمزي للمورد من النوع: databaseAccounts
الخصائص خصائص لإنشاء وتحديث قاعدة بيانات Azure Cosmos DB SQL. SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties (مطلوب)
العلامات علامات الموارد قاموس أسماء العلامات والقيم. انظر الوسوم في القوالب

ARMResourcePropertiesTags

اسم الوصف Value

إعدادات التحجيم التلقائي

اسم الوصف Value
الحد الأقصى لمعدل النقل يمثل الحد الأقصى لمعدل النقل، يمكن للمورد توسيع نطاقه. int

CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions

اسم الوصف Value
إعدادات التحجيم التلقائي تحديد إعدادات التحجيم التلقائي. ملاحظة: مطلوب إما معدل النقل أو إعدادات التحجيم التلقائي، ولكن ليس كليهما. AutoscaleSettings
معدل النقل طلب الوحدات في الثانية. على سبيل المثال، "معدل النقل": 10000. int

معرف الخدمة المدارة

اسم الوصف Value
النوع نوع الهوية المستخدمة للمورد. يتضمن النوع "SystemAssigned,UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هويات من الخدمة. "بلا"
"تم تعيين النظام"
"تم تعيين النظام، UserAssigned
"تعيين المستخدم"
معرفات مستخدم معينة قائمة هويات المستخدم المقترنة بالمورد. ستكون مراجع مفاتيح قاموس هوية المستخدم هي معرفات موارد ARM في النموذج: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

اسم الوصف Value

ManagedServiceIdentityUserAssignedIdentities

اسم الوصف Value

معلمات ResourceRestore

اسم الوصف Value
restoreSource معرف حساب قاعدة البيانات القابلة للاستعادة الذي يجب بدء الاستعادة منه. على سبيل المثال: /subscriptions/{subscriptionId}/providers/Microsoft. DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} سلسلة نصية
restoreTimestampInUtc الوقت الذي يجب استعادة الحساب إليه (تنسيق ISO-8601). سلسلة نصية
restoreWithTtlDisabled يحدد ما إذا كان الحساب المستعاد سيعطيل الوقت-To-Live عند الاستعادة الناجحة. bool

SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties

اسم الوصف Value
options زوج قيم المفاتيح من الخيارات التي سيتم تطبيقها على الطلب. يتوافق هذا مع العناوين المرسلة مع الطلب. CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions
resource تنسيق JSON القياسي لقاعدة بيانات SQL SqlDatabaseResourceOrSqlDatabaseGetPropertiesResource (مطلوب)

SqlDatabaseResourceOrSqlDatabaseGetPropertiesResource

اسم الوصف Value
createMode تعداد للإشارة إلى وضع إنشاء الحساب. 'Default'
"استعادة"
id اسم قاعدة بيانات Cosmos DB SQL سلسلة (مطلوب)
restoreParameters معلمات للإشارة إلى معلومات حول الاستعادة ResourceRestoreParameters

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

يمكن نشر نوع مورد databaseAccounts/sqlDatabases مع العمليات التي تستهدف:

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

قوالب Azure Quickstart

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

قالب الوصف
Azure Cosmos DB واجهة برمجة تطبيقات SQL للحساب مع التخزين التحليلي

التوزيع إلى Azure
ينشئ هذا القالب حساب Azure Cosmos لواجهة برمجة التطبيقات الأساسية (SQL) مع قاعدة بيانات وحاوية مهيأة بمخزن تحليلي.
أنشئ حساب Azure Cosmos DB مجاني

التوزيع إلى Azure
ينشئ هذا القالب حساب Azure Cosmos DB مجاني المستوى لواجهة برمجة تطبيقات SQL مع قاعدة بيانات ذات معدل نقل وحاويات مشتركة.
إنشاء حساب Azure Cosmos DB لواجهة برمجة التطبيقات الأساسية (SQL)

التوزيع إلى Azure
ينشئ هذا القالب حساب Azure Cosmos لواجهة برمجة التطبيقات الأساسية (SQL) مع قاعدة بيانات وحاوية مع معدل نقل وخيارات متعددة أخرى.
أنشئ واجهة برمجة تطبيقات SQL لحساب Azure Cosmos DB باستخدام التكبير التلقائي

التوزيع إلى Azure
ينشئ هذا القالب واجهة برمجة تطبيقات حساب Azure Cosmos ل Core (SQL) مع قاعدة بيانات وحاوية مع معدل نقل بيانات تلقائي مع خيارات متعددة أخرى.
إنشاء إجراءات مخزنة لواجهة برمجة التطبيقات الأساسية Azure Cosmos DB (SQL)

التوزيع إلى Azure
ينشئ هذا القالب حساب Azure Cosmos DB لواجهة برمجة التطبيقات الأساسية (SQL) وحاوية تحتوي على إجراء مخزن، ومشغل، ووظيفة معرفة من قبل المستخدم.
إنشاء تطبيق خدمات Dapr المصغرة باستخدام تطبيقات الحاوية

التوزيع إلى Azure
إنشاء تطبيق خدمات Dapr المصغرة باستخدام تطبيقات الحاوية.
ينشئ تطبيق حافلة خدمة pub-sub من Dapr باستخدام تطبيقات الحاوية

التوزيع إلى Azure
إنشاء تطبيق Dapr pub-sub servicebus باستخدام Container Apps.
نشر قاعدة بيانات Azure Data Explorer ‏(Kusto) مع اتصال قاعدة بيانات كوزموس

التوزيع إلى Azure
نشر Azure Data Explorer ‏(Kusto) DB مع اتصال Cosmos DB.

تنسيق المورد

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

{
  "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases",
  "apiVersion": "2026-03-15",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "options": {
      "autoscaleSettings": {
        "maxThroughput": "int"
      },
      "throughput": "int"
    },
    "resource": {
      "createMode": "string",
      "id": "string",
      "restoreParameters": {
        "restoreSource": "string",
        "restoreTimestampInUtc": "string",
        "restoreWithTtlDisabled": "bool"
      }
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

قيم الخصائص

Microsoft.DocumentDB/databaseAccounts/sqlDatabases

اسم الوصف Value
apiVersion إصدار واجهة برمجة التطبيقات '2026-03-15'
الهوية هوية المورد. ManagedServiceIdentity
مكان موقع مجموعة الموارد التي ينتمي إليها المورد. سلسلة نصية
الاسم اسم المورد سلسلة (مطلوب)
الخصائص خصائص لإنشاء وتحديث قاعدة بيانات Azure Cosmos DB SQL. SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties (مطلوب)
العلامات علامات الموارد قاموس أسماء العلامات والقيم. انظر الوسوم في القوالب
النوع نوع المورد "Microsoft.DocumentDB/databaseAccounts/sqlDatabases"

ARMResourcePropertiesTags

اسم الوصف Value

إعدادات التحجيم التلقائي

اسم الوصف Value
الحد الأقصى لمعدل النقل يمثل الحد الأقصى لمعدل النقل، يمكن للمورد توسيع نطاقه. int

CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions

اسم الوصف Value
إعدادات التحجيم التلقائي تحديد إعدادات التحجيم التلقائي. ملاحظة: مطلوب إما معدل النقل أو إعدادات التحجيم التلقائي، ولكن ليس كليهما. AutoscaleSettings
معدل النقل طلب الوحدات في الثانية. على سبيل المثال، "معدل النقل": 10000. int

معرف الخدمة المدارة

اسم الوصف Value
النوع نوع الهوية المستخدمة للمورد. يتضمن النوع "SystemAssigned,UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هويات من الخدمة. "بلا"
"تم تعيين النظام"
"تم تعيين النظام، UserAssigned
"تعيين المستخدم"
معرفات مستخدم معينة قائمة هويات المستخدم المقترنة بالمورد. ستكون مراجع مفاتيح قاموس هوية المستخدم هي معرفات موارد ARM في النموذج: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

اسم الوصف Value

ManagedServiceIdentityUserAssignedIdentities

اسم الوصف Value

معلمات ResourceRestore

اسم الوصف Value
restoreSource معرف حساب قاعدة البيانات القابلة للاستعادة الذي يجب بدء الاستعادة منه. على سبيل المثال: /subscriptions/{subscriptionId}/providers/Microsoft. DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} سلسلة نصية
restoreTimestampInUtc الوقت الذي يجب استعادة الحساب إليه (تنسيق ISO-8601). سلسلة نصية
restoreWithTtlDisabled يحدد ما إذا كان الحساب المستعاد سيعطيل الوقت-To-Live عند الاستعادة الناجحة. bool

SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties

اسم الوصف Value
options زوج قيم المفاتيح من الخيارات التي سيتم تطبيقها على الطلب. يتوافق هذا مع العناوين المرسلة مع الطلب. CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions
resource تنسيق JSON القياسي لقاعدة بيانات SQL SqlDatabaseResourceOrSqlDatabaseGetPropertiesResource (مطلوب)

SqlDatabaseResourceOrSqlDatabaseGetPropertiesResource

اسم الوصف Value
createMode تعداد للإشارة إلى وضع إنشاء الحساب. 'Default'
"استعادة"
id اسم قاعدة بيانات Cosmos DB SQL سلسلة (مطلوب)
restoreParameters معلمات للإشارة إلى معلومات حول الاستعادة ResourceRestoreParameters

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

يمكن نشر نوع مورد databaseAccounts/sqlDatabases مع العمليات التي تستهدف:

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

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

عينات Terraform

مثال أساسي لنشر قاعدة بيانات SQL داخل حساب Cosmos DB.

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

provider "azapi" {
  skip_provider_registration = false
}

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

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

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

resource "azapi_resource" "databaseAccount" {
  type      = "Microsoft.DocumentDB/databaseAccounts@2021-10-15"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    kind = "GlobalDocumentDB"
    properties = {
      capabilities = [
      ]
      consistencyPolicy = {
        defaultConsistencyLevel = "BoundedStaleness"
        maxIntervalInSeconds    = 10
        maxStalenessPrefix      = 200
      }
      databaseAccountOfferType           = "Standard"
      defaultIdentity                    = "FirstPartyIdentity"
      disableKeyBasedMetadataWriteAccess = false
      disableLocalAuth                   = false
      enableAnalyticalStorage            = false
      enableAutomaticFailover            = false
      enableFreeTier                     = false
      enableMultipleWriteLocations       = false
      ipRules = [
      ]
      isVirtualNetworkFilterEnabled = false
      locations = [
        {
          failoverPriority = 0
          isZoneRedundant  = false
          locationName     = "West Europe"
        },
      ]
      networkAclBypass = "None"
      networkAclBypassResourceIds = [
      ]
      publicNetworkAccess = "Enabled"
      virtualNetworkRules = [
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "sqlDatabase" {
  type      = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2021-10-15"
  parent_id = azapi_resource.databaseAccount.id
  name      = var.resource_name
  body = {
    properties = {
      options = {
        throughput = 400
      }
      resource = {
        id = var.resource_name
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

تنسيق المورد

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2026-03-15"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      options = {
        autoscaleSettings = {
          maxThroughput = int
        }
        throughput = int
      }
      resource = {
        createMode = "string"
        id = "string"
        restoreParameters = {
          restoreSource = "string"
          restoreTimestampInUtc = "string"
          restoreWithTtlDisabled = bool
        }
      }
    }
  }
}

قيم الخصائص

Microsoft.DocumentDB/databaseAccounts/sqlDatabases

اسم الوصف Value
الهوية هوية المورد. ManagedServiceIdentity
مكان موقع مجموعة الموارد التي ينتمي إليها المورد. سلسلة نصية
الاسم اسم المورد سلسلة (مطلوب)
parent_id معرف المورد الأصل لهذا المورد. معرف المورد من النوع: databaseAccounts
الخصائص خصائص لإنشاء وتحديث قاعدة بيانات Azure Cosmos DB SQL. SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties (مطلوب)
العلامات علامات الموارد قاموس أسماء العلامات والقيم.
النوع نوع المورد "Microsoft. DocumentDB/databaseAccounts/sqlDatabases@2026-03-15"

ARMResourcePropertiesTags

اسم الوصف Value

إعدادات التحجيم التلقائي

اسم الوصف Value
الحد الأقصى لمعدل النقل يمثل الحد الأقصى لمعدل النقل، يمكن للمورد توسيع نطاقه. int

CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions

اسم الوصف Value
إعدادات التحجيم التلقائي تحديد إعدادات التحجيم التلقائي. ملاحظة: مطلوب إما معدل النقل أو إعدادات التحجيم التلقائي، ولكن ليس كليهما. AutoscaleSettings
معدل النقل طلب الوحدات في الثانية. على سبيل المثال، "معدل النقل": 10000. int

معرف الخدمة المدارة

اسم الوصف Value
النوع نوع الهوية المستخدمة للمورد. يتضمن النوع "SystemAssigned,UserAssigned" كلا من الهوية التي تم إنشاؤها ضمنيا ومجموعة من الهويات المعينة من قبل المستخدم. سيقوم النوع "بلا" بإزالة أي هويات من الخدمة. "بلا"
"تم تعيين النظام"
"تم تعيين النظام، UserAssigned
"تعيين المستخدم"
معرفات مستخدم معينة قائمة هويات المستخدم المقترنة بالمورد. ستكون مراجع مفاتيح قاموس هوية المستخدم هي معرفات موارد ARM في النموذج: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

اسم الوصف Value

ManagedServiceIdentityUserAssignedIdentities

اسم الوصف Value

معلمات ResourceRestore

اسم الوصف Value
restoreSource معرف حساب قاعدة البيانات القابلة للاستعادة الذي يجب بدء الاستعادة منه. على سبيل المثال: /subscriptions/{subscriptionId}/providers/Microsoft. DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} سلسلة نصية
restoreTimestampInUtc الوقت الذي يجب استعادة الحساب إليه (تنسيق ISO-8601). سلسلة نصية
restoreWithTtlDisabled يحدد ما إذا كان الحساب المستعاد سيعطيل الوقت-To-Live عند الاستعادة الناجحة. bool

SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetProperties

اسم الوصف Value
options زوج قيم المفاتيح من الخيارات التي سيتم تطبيقها على الطلب. يتوافق هذا مع العناوين المرسلة مع الطلب. CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions
resource تنسيق JSON القياسي لقاعدة بيانات SQL SqlDatabaseResourceOrSqlDatabaseGetPropertiesResource (مطلوب)

SqlDatabaseResourceOrSqlDatabaseGetPropertiesResource

اسم الوصف Value
createMode تعداد للإشارة إلى وضع إنشاء الحساب. 'Default'
"استعادة"
id اسم قاعدة بيانات Cosmos DB SQL سلسلة (مطلوب)
restoreParameters معلمات للإشارة إلى معلومات حول الاستعادة ResourceRestoreParameters