قاعدة بيانات Microsoft.DocumentDBAccounts/sqlDatabases/containers 2024-02-15-preview

تعريف مورد Bicep

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

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

تنسيق المورد

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

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2024-02-15-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    options: {
      autoscaleSettings: {
        maxThroughput: int
      }
      throughput: int
    }
    resource: {
      analyticalStorageTtl: int
      clientEncryptionPolicy: {
        includedPaths: [
          {
            clientEncryptionKeyId: 'string'
            encryptionAlgorithm: 'string'
            encryptionType: 'string'
            path: 'string'
          }
        ]
        policyFormatVersion: int
      }
      computedProperties: [
        {
          name: 'string'
          query: 'string'
        }
      ]
      conflictResolutionPolicy: {
        conflictResolutionPath: 'string'
        conflictResolutionProcedure: 'string'
        mode: 'string'
      }
      createMode: 'string'
      defaultTtl: int
      id: 'string'
      indexingPolicy: {
        automatic: bool
        compositeIndexes: [
          {
            order: 'string'
            path: 'string'
          }
        ]
        excludedPaths: [
          {
            path: 'string'
          }
        ]
        includedPaths: [
          {
            indexes: [
              {
                dataType: 'string'
                kind: 'string'
                precision: int
              }
            ]
            path: 'string'
          }
        ]
        indexingMode: 'string'
        spatialIndexes: [
          {
            path: 'string'
            types: [
              'string'
            ]
          }
        ]
      }
      materializedViewDefinition: {
        definition: 'string'
        sourceCollectionId: 'string'
      }
      partitionKey: {
        kind: 'string'
        paths: [
          'string'
        ]
        version: int
      }
      restoreParameters: {
        restoreSource: 'string'
        restoreTimestampInUtc: 'string'
        restoreWithTtlDisabled: bool
      }
      uniqueKeyPolicy: {
        uniqueKeys: [
          {
            paths: [
              'string'
            ]
          }
        ]
      }
    }
  }
}

قيم Property

databaseAccounts/sqlDatabases/containers

الاسم الوصف القيمة
الاسم اسم المورد

تعرف على كيفية تعيين الأسماء والأنواع للموارد التابعة في Bicep.
سلسلة (مطلوبة)
الموقع موقع مجموعة الموارد التي ينتمي إليها المورد. سلسلة
العلامات العلامات هي قائمة بأزواج قيم المفاتيح التي تصف المورد. يمكن استخدام هذه العلامات في عرض هذا المورد وتجميعه (عبر مجموعات الموارد). يمكن توفير 15 علامة كحد أقصى لمورد. يجب أن تحتوي كل علامة على مفتاح لا يزيد عن 128 حرفا وقيمة لا تزيد عن 256 حرفا. على سبيل المثال، يتم تعيين التجربة الافتراضية لنوع القالب باستخدام "defaultExperience": "Cassandra". تتضمن قيم "defaultExperience" الحالية أيضا "Table" و"Graph" و"DocumentDB" و"MongoDB". قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
أصل في Bicep، يمكنك تحديد المورد الأصل لمورد تابع. تحتاج فقط إلى إضافة هذه الخاصية عند الإعلان عن المورد التابع خارج المورد الأصل.

لمزيد من المعلومات، راجع المورد التابع خارج المورد الأصل.
اسم رمزي للمورد من النوع: sqlDatabases
الهوية هوية المورد. ManagedServiceIdentity
خصائص خصائص لإنشاء حاوية Azure Cosmos DB وتحديثها. SqlContainerCreateUpdatePropertiesOrSqlContainerGetP... (مطلوب)

ManagedServiceIdentity

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

ManagedServiceIdentityUserAssignedIdentities

الاسم الوصف القيمة
{خاصية مخصصة} Components1Jq1T4ISchemasManagedserviceidentityProper...

Components1Jq1T4ISchemasManagedserviceidentityProper...

لا يحتوي هذا الكائن على أي خصائص لتعيينها أثناء التوزيع. جميع الخصائص هي ReadOnly.

SqlContainerCreateUpdatePropertiesOrSqlContainerGetP...

الاسم الوصف القيمة
خيارات زوج قيم المفاتيح من الخيارات التي سيتم تطبيقها على الطلب. يتوافق هذا مع العناوين المرسلة مع الطلب. CreateUpdateOptionsOrSqlContainerGetPropertiesOption...
المورد تنسيق JSON القياسي للحاوية SqlContainerResourceOrSqlContainerGetPropertiesResou... (مطلوب)

CreateUpdateOptionsOrSqlContainerGetPropertiesOption...

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

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

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

SqlContainerResourceOrSqlContainerGetPropertiesResou...

الاسم الوصف القيمة
analyticalStorageTtl TTL التحليلية. int
clientEncryptionPolicy نهج تشفير العميل للحاوية. ClientEncryptionPolicy
الخصائص المحسوبة قائمة الخصائص المحسوبة ComputedProperty[]
conflictResolutionPolicy نهج حل التعارض للحاوية. ConflictResolutionPolicy
createMode تعداد للإشارة إلى وضع إنشاء الموارد. "افتراضي"
'PointInTimeRestore'
"استعادة"
defaultTtl الوقت الافتراضي للعيش int
المعرف اسم حاوية Cosmos DB SQL سلسلة (مطلوب)
indexingPolicy تكوين نهج الفهرسة. بشكل افتراضي، تكون الفهرسة تلقائية لجميع مسارات المستندات داخل الحاوية سياسة الفهرسة
تم تجسيدViewDefinition تكوين تعريف طرق العرض الفعلية. يجب تحديد هذا فقط لإنشاء حاوية طريقة عرض مجسدة. تم تجسيدViewDefinition
partitionKey تكوين مفتاح القسم الذي سيتم استخدامه لتقسيم البيانات إلى أقسام متعددة ContainerPartitionKey
restoreParameters معلمات للإشارة إلى معلومات حول الاستعادة ResourceRestoreParameters
uniqueKeyPolicy تكوين نهج المفتاح الفريد لتحديد قيود التفرد على المستندات في المجموعة في خدمة Azure Cosmos DB. UniqueKeyPolicy

ClientEncryptionPolicy

الاسم الوصف القيمة
مسارات مضمنة مسارات العنصر التي تحتاج إلى تشفير مع إعدادات خاصة بالمسار. ClientEncryptionIncludedPath[] (مطلوب)
policyFormatVersion إصدار تعريف نهج تشفير العميل. الإصدارات المدعومة هي 1 و2. يدعم الإصدار 2 تشفير مسار مفتاح المعرف والقسم. int (مطلوب)

القيود:
الحد الأدنى للقيمة = 1
الحد الأقصى للقيمة = 2

ClientEncryptionIncludedPath

الاسم الوصف القيمة
clientEncryptionKeyId معرف مفتاح تشفير العميل الذي سيتم استخدامه لتشفير المسار. سلسلة (مطلوب)
encryptionAlgorithm خوارزمية التشفير التي سيتم استخدامها. على سبيل المثال - AEAD_AES_256_CBC_HMAC_SHA256. سلسلة (مطلوبة)
نوع التشفير نوع التشفير المطلوب تنفيذه. على سبيل المثال - محددة، عشوائية. سلسلة (مطلوبة)
مسار المسار الذي يحتاج إلى تشفير. سلسلة (مطلوبة)

حوسبة الحوسبة

الاسم الوصف القيمة
الاسم اسم خاصية حوسبة، على سبيل المثال - "cp_lowerName" سلسلة
استعلام الاستعلام الذي يقيم قيمة الخاصية المحسوبة، على سبيل المثال - "SELECT VALUE LOWER(c.name) FROM c" سلسلة

نهج حل التعارض

الاسم الوصف القيمة
conflictResolutionPath مسار حل التعارض في حالة وضع LastWriterWins. سلسلة
conflictResolutionProcedure إجراء حل التعارضات في حالة الوضع المخصص. سلسلة
الوضع يشير إلى وضع حل التعارض. "مخصص"
"LastWriterWins"

IndexingPolicy

الاسم الوصف القيمة
تلقائي يشير إلى ما إذا كان نهج الفهرسة تلقائيا Bool
المؤشرات المركبة قائمة المسارات المركبة مسار مركب[]
مسارات مستبعدة قائمة المسارات التي يجب استبعادها من الفهرسة ExcludedPath[]
مسارات مضمنة قائمة المسارات المراد تضمينها في الفهرسة IncludedPath[]
وضع الفهرسة يشير إلى وضع الفهرسة. "متناسق"
"كسول"
"لا شيء"
العلامات المكانية قائمة بالتحديدات المكانية SpatialSpec[]

CompositePath

الاسم الوصف القيمة
الترتيب ترتيب الفرز للمسارات المركبة. "تصاعدي"
"تنازلي"
مسار المسار الذي ينطبق عليه سلوك الفهرسة. تبدأ مسارات الفهرس عادة بالجذر وتنتهي بحرف البدل (/path/*) سلسلة

مسار مستبعد

الاسم الوصف القيمة
مسار المسار الذي ينطبق عليه سلوك الفهرسة. تبدأ مسارات الفهرس عادة بالجذر وتنتهي بحرف البدل (/path/*) سلسلة

مسار مضمن

الاسم الوصف القيمة
الفهارس قائمة الفهارس لهذا المسار الفهارس[]
مسار المسار الذي ينطبق عليه سلوك الفهرسة. تبدأ مسارات الفهرس عادة بالجذر وتنتهي بحرف البدل (/path/*) سلسلة

الفهارس

الاسم الوصف القيمة
dataType نوع البيانات الذي يتم تطبيق سلوك الفهرسة عليه. "سلسلة الأسطر"
"تعدد المضلعات"
"رقم"
'نقطة'
"مضلع"
'سلسلة'
نوع يشير إلى نوع الفهرس. 'التجزئة'
'النطاق'
"مكاني"
الضبط دقة الفهرس. -1 هو الحد الأقصى للدقة. int

SpatialSpec

الاسم الوصف القيمة
مسار المسار الذي ينطبق عليه سلوك الفهرسة. تبدأ مسارات الفهرس عادة بالجذر وتنتهي بحرف البدل (/path/*) سلسلة
الأنواع قائمة النوع المكاني للمسار صفيف سلسلة يحتوي على أي من:
"سلسلة الأسطر"
"تعدد المضلعات"
'نقطة'
"مضلع"

معرف العرض المجسد

الاسم الوصف القيمة
التعريف يجب أن يكون التعريف استعلام SQL الذي سيتم استخدامه لجلب البيانات من الحاوية المصدر للتعبئة في حاوية العرض المجسدة. سلسلة (مطلوبة)
sourceCollectionId اسم الحاوية المصدر التي سيتم إنشاء طريقة العرض المجسدة عليها. سلسلة (مطلوبة)

ContainerPartitionKey

الاسم الوصف القيمة
نوع يشير إلى نوع الخوارزمية المستخدمة للتقسيم. بالنسبة إلى MultiHash، يتم دعم مفاتيح أقسام متعددة (بحد أقصى ثلاثة كحد أقصى) لإنشاء الحاوية 'التجزئة'
"MultiHash"
'النطاق'
المسارات قائمة المسارات التي يمكن تقسيم البيانات داخل الحاوية باستخدامها سلسلة []
version يشير إلى إصدار تعريف مفتاح القسم int

القيود:
الحد الأدنى للقيمة = 1
الحد الأقصى للقيمة = 2

ResourceRestoreParameters

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

UniqueKeyPolicy

الاسم الوصف القيمة
المفاتيح الفريدة قائمة المفاتيح الفريدة على التي تفرض قيد التفرد على المستندات في المجموعة في خدمة Azure Cosmos DB. مفتاح فريد[]

مفتاح فريد

الاسم الوصف القيمة
المسارات يجب أن تكون قائمة المسارات فريدة لكل مستند في خدمة Azure Cosmos DB سلسلة []

قوالب التشغيل السريع

تنشر قوالب التشغيل السريع التالية نوع المورد هذا.

قالب الوصف
إنشاء حساب Azure Cosmos DB مجاني

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

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

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

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

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

نشر في Azure
توزيع Azure Data Explorer DB مع اتصال Cosmos DB.

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

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

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

تنسيق المورد

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

{
  "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers",
  "apiVersion": "2024-02-15-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "options": {
      "autoscaleSettings": {
        "maxThroughput": "int"
      },
      "throughput": "int"
    },
    "resource": {
      "analyticalStorageTtl": "int",
      "clientEncryptionPolicy": {
        "includedPaths": [
          {
            "clientEncryptionKeyId": "string",
            "encryptionAlgorithm": "string",
            "encryptionType": "string",
            "path": "string"
          }
        ],
        "policyFormatVersion": "int"
      },
      "computedProperties": [
        {
          "name": "string",
          "query": "string"
        }
      ],
      "conflictResolutionPolicy": {
        "conflictResolutionPath": "string",
        "conflictResolutionProcedure": "string",
        "mode": "string"
      },
      "createMode": "string",
      "defaultTtl": "int",
      "id": "string",
      "indexingPolicy": {
        "automatic": "bool",
        "compositeIndexes": [
          {
            "order": "string",
            "path": "string"
          }
        ],
        "excludedPaths": [
          {
            "path": "string"
          }
        ],
        "includedPaths": [
          {
            "indexes": [
              {
                "dataType": "string",
                "kind": "string",
                "precision": "int"
              }
            ],
            "path": "string"
          }
        ],
        "indexingMode": "string",
        "spatialIndexes": [
          {
            "path": "string",
            "types": [ "string" ]
          }
        ]
      },
      "materializedViewDefinition": {
        "definition": "string",
        "sourceCollectionId": "string"
      },
      "partitionKey": {
        "kind": "string",
        "paths": [ "string" ],
        "version": "int"
      },
      "restoreParameters": {
        "restoreSource": "string",
        "restoreTimestampInUtc": "string",
        "restoreWithTtlDisabled": "bool"
      },
      "uniqueKeyPolicy": {
        "uniqueKeys": [
          {
            "paths": [ "string" ]
          }
        ]
      }
    }
  }
}

قيم Property

databaseAccounts/sqlDatabases/containers

الاسم الوصف القيمة
النوع نوع المورد 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers'
apiVersion إصدار واجهة برمجة تطبيقات المورد 'معاينة 2024-02-15'
الاسم اسم المورد

تعرف على كيفية تعيين الأسماء والأنواع للموارد التابعة في قوالب JSON ARM.
سلسلة (مطلوبة)
الموقع موقع مجموعة الموارد التي ينتمي إليها المورد. سلسلة
العلامات العلامات هي قائمة بأزواج قيم المفاتيح التي تصف المورد. يمكن استخدام هذه العلامات في عرض هذا المورد وتجميعه (عبر مجموعات الموارد). يمكن توفير 15 علامة كحد أقصى لمورد. يجب أن تحتوي كل علامة على مفتاح لا يزيد عن 128 حرفا وقيمة لا تزيد عن 256 حرفا. على سبيل المثال، يتم تعيين التجربة الافتراضية لنوع القالب باستخدام "defaultExperience": "Cassandra". تتضمن قيم "defaultExperience" الحالية أيضا "Table" و"Graph" و"DocumentDB" و"MongoDB". قاموس أسماء العلامات والقيم. راجع العلامات في القوالب
الهوية هوية المورد. ManagedServiceIdentity
خصائص خصائص لإنشاء حاوية Azure Cosmos DB وتحديثها. SqlContainerCreateUpdatePropertiesOrSqlContainerGetP... (مطلوب)

ManagedServiceIdentity

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

ManagedServiceIdentityUserAssignedIdentities

الاسم الوصف القيمة
{خاصية مخصصة} Components1Jq1T4ISchemasManagedserviceidentityProper...

Components1Jq1T4ISchemasManagedserviceidentityProper...

لا يحتوي هذا الكائن على أي خصائص لتعيينها أثناء التوزيع. جميع الخصائص هي ReadOnly.

SqlContainerCreateUpdatePropertiesOrSqlContainerGetP...

الاسم الوصف القيمة
خيارات زوج قيم المفاتيح من الخيارات التي سيتم تطبيقها على الطلب. يتوافق هذا مع العناوين المرسلة مع الطلب. CreateUpdateOptionsOrSqlContainerGetPropertiesOption...
المورد تنسيق JSON القياسي للحاوية SqlContainerResourceOrSqlContainerGetPropertiesResou... (مطلوب)

CreateUpdateOptionsOrSqlContainerGetPropertiesOption...

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

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

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

SqlContainerResourceOrSqlContainerGetPropertiesResou...

الاسم الوصف القيمة
analyticalStorageTtl TTL التحليلية. int
clientEncryptionPolicy نهج تشفير العميل للحاوية. ClientEncryptionPolicy
الخصائص المحسوبة قائمة الخصائص المحسوبة ComputedProperty[]
conflictResolutionPolicy نهج حل التعارض للحاوية. ConflictResolutionPolicy
createMode تعداد للإشارة إلى وضع إنشاء الموارد. "افتراضي"
'PointInTimeRestore'
"استعادة"
defaultTtl الوقت الافتراضي للعيش int
المعرف اسم حاوية Cosmos DB SQL سلسلة (مطلوب)
indexingPolicy تكوين نهج الفهرسة. بشكل افتراضي، تكون الفهرسة تلقائية لجميع مسارات المستندات داخل الحاوية سياسة الفهرسة
تم تجسيدViewDefinition تكوين تعريف طرق العرض الفعلية. يجب تحديد هذا فقط لإنشاء حاوية طريقة عرض مجسدة. تم تجسيدViewDefinition
partitionKey تكوين مفتاح القسم الذي سيتم استخدامه لتقسيم البيانات إلى أقسام متعددة ContainerPartitionKey
restoreParameters معلمات للإشارة إلى معلومات حول الاستعادة ResourceRestoreParameters
uniqueKeyPolicy تكوين نهج المفتاح الفريد لتحديد قيود التفرد على المستندات في المجموعة في خدمة Azure Cosmos DB. UniqueKeyPolicy

ClientEncryptionPolicy

الاسم الوصف القيمة
مسارات مضمنة مسارات العنصر التي تحتاج إلى تشفير مع إعدادات خاصة بالمسار. ClientEncryptionIncludedPath[] (مطلوب)
policyFormatVersion إصدار تعريف نهج تشفير العميل. الإصدارات المدعومة هي 1 و2. يدعم الإصدار 2 تشفير مسار مفتاح المعرف والقسم. int (مطلوب)

القيود:
الحد الأدنى للقيمة = 1
الحد الأقصى للقيمة = 2

ClientEncryptionIncludedPath

الاسم الوصف القيمة
clientEncryptionKeyId معرف مفتاح تشفير العميل الذي سيتم استخدامه لتشفير المسار. سلسلة (مطلوب)
encryptionAlgorithm خوارزمية التشفير التي سيتم استخدامها. على سبيل المثال - AEAD_AES_256_CBC_HMAC_SHA256. سلسلة (مطلوب)
نوع التشفير نوع التشفير المطلوب تنفيذه. على سبيل المثال - محددة، عشوائية. سلسلة (مطلوب)
مسار المسار الذي يجب تشفيره. سلسلة (مطلوب)

حوسبةProperty

الاسم الوصف القيمة
الاسم اسم الخاصية المحسوبة، على سبيل المثال - "cp_lowerName" سلسلة
استعلام الاستعلام الذي يقيم قيمة الخاصية المحسوبة، على سبيل المثال - "SELECT VALUE LOWER(c.name) FROM c" سلسلة

ConflictResolutionPolicy

الاسم الوصف القيمة
conflictResolutionPath مسار حل التعارض في حالة وضع LastWriterWins. سلسلة
conflictResolutionProcedure إجراء حل التعارضات في حالة الوضع المخصص. سلسلة
الوضع يشير إلى وضع حل التعارض. "مخصص"
"LastWriterWins"

IndexingPolicy

الاسم الوصف القيمة
تلقائي يشير إلى ما إذا كان نهج الفهرسة تلقائيا Bool
المؤشرات المركبة قائمة المسارات المركبة مسار مركب[]
مسارات مستبعدة قائمة المسارات التي يجب استبعادها من الفهرسة ExcludedPath[]
مسارات مضمنة قائمة المسارات المراد تضمينها في الفهرسة IncludedPath[]
وضع الفهرسة يشير إلى وضع الفهرسة. "متناسق"
"كسول"
"لا شيء"
العلامات المكانية قائمة بالتحديدات المكانية SpatialSpec[]

CompositePath

الاسم الوصف القيمة
الترتيب ترتيب الفرز للمسارات المركبة. "تصاعدي"
"تنازلي"
مسار المسار الذي ينطبق عليه سلوك الفهرسة. تبدأ مسارات الفهرس عادة بالجذر وتنتهي بحرف البدل (/path/*) سلسلة

مسار مستبعد

الاسم الوصف القيمة
مسار المسار الذي ينطبق عليه سلوك الفهرسة. تبدأ مسارات الفهرس عادة بالجذر وتنتهي بحرف البدل (/path/*) سلسلة

مسار مضمن

الاسم الوصف القيمة
الفهارس قائمة الفهارس لهذا المسار الفهارس[]
مسار المسار الذي ينطبق عليه سلوك الفهرسة. تبدأ مسارات الفهرس عادة بالجذر وتنتهي بحرف البدل (/path/*) سلسلة

الفهارس

الاسم الوصف القيمة
dataType نوع البيانات الذي يتم تطبيق سلوك الفهرسة عليه. "سلسلة الأسطر"
"تعدد المضلعات"
"رقم"
'نقطة'
"مضلع"
'سلسلة'
نوع يشير إلى نوع الفهرس. 'التجزئة'
'النطاق'
"مكاني"
الضبط دقة الفهرس. -1 هو الحد الأقصى للدقة. int

SpatialSpec

الاسم الوصف القيمة
مسار المسار الذي ينطبق عليه سلوك الفهرسة. تبدأ مسارات الفهرس عادة بالجذر وتنتهي بحرف البدل (/path/*) سلسلة
الأنواع قائمة النوع المكاني للمسار صفيف سلسلة يحتوي على أي من:
"سلسلة الأسطر"
"تعدد المضلعات"
'نقطة'
"مضلع"

معرف العرض المجسد

الاسم الوصف القيمة
التعريف يجب أن يكون التعريف استعلام SQL الذي سيتم استخدامه لجلب البيانات من الحاوية المصدر للتعبئة في حاوية العرض المجسدة. سلسلة (مطلوبة)
sourceCollectionId اسم الحاوية المصدر التي سيتم إنشاء طريقة العرض المجسدة عليها. سلسلة (مطلوبة)

ContainerPartitionKey

الاسم الوصف القيمة
نوع يشير إلى نوع الخوارزمية المستخدمة للتقسيم. بالنسبة إلى MultiHash، يتم دعم مفاتيح أقسام متعددة (حتى ثلاثة كحد أقصى) لإنشاء الحاوية "التجزئة"
"MultiHash"
'النطاق'
المسارات قائمة المسارات التي يمكن تقسيم البيانات داخل الحاوية باستخدامها سلسلة []
version يشير إلى إصدار تعريف مفتاح القسم int

القيود:
الحد الأدنى للقيمة = 1
الحد الأقصى للقيمة = 2

ResourceRestoreParameters

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

UniqueKeyPolicy

الاسم الوصف القيمة
المفاتيح الفريدة قائمة المفاتيح الفريدة على التي تفرض قيد التفرد على المستندات في المجموعة في خدمة Azure Cosmos DB. UniqueKey[]

مفتاح فريد

الاسم الوصف القيمة
المسارات يجب أن تكون قائمة المسارات فريدة لكل مستند في خدمة Azure Cosmos DB سلسلة []

قوالب التشغيل السريع

تنشر قوالب التشغيل السريع التالية نوع المورد هذا.

قالب الوصف
إنشاء حساب Azure Cosmos DB مجاني

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

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

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

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

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

نشر في Azure
توزيع Azure Data Explorer DB مع اتصال Cosmos DB.

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

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

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

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

تنسيق المورد

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2024-02-15-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      options = {
        autoscaleSettings = {
          maxThroughput = int
        }
        throughput = int
      }
      resource = {
        analyticalStorageTtl = int
        clientEncryptionPolicy = {
          includedPaths = [
            {
              clientEncryptionKeyId = "string"
              encryptionAlgorithm = "string"
              encryptionType = "string"
              path = "string"
            }
          ]
          policyFormatVersion = int
        }
        computedProperties = [
          {
            name = "string"
            query = "string"
          }
        ]
        conflictResolutionPolicy = {
          conflictResolutionPath = "string"
          conflictResolutionProcedure = "string"
          mode = "string"
        }
        createMode = "string"
        defaultTtl = int
        id = "string"
        indexingPolicy = {
          automatic = bool
          compositeIndexes = [
            {
              order = "string"
              path = "string"
            }
          ]
          excludedPaths = [
            {
              path = "string"
            }
          ]
          includedPaths = [
            {
              indexes = [
                {
                  dataType = "string"
                  kind = "string"
                  precision = int
                }
              ]
              path = "string"
            }
          ]
          indexingMode = "string"
          spatialIndexes = [
            {
              path = "string"
              types = [
                "string"
              ]
            }
          ]
        }
        materializedViewDefinition = {
          definition = "string"
          sourceCollectionId = "string"
        }
        partitionKey = {
          kind = "string"
          paths = [
            "string"
          ]
          version = int
        }
        restoreParameters = {
          restoreSource = "string"
          restoreTimestampInUtc = "string"
          restoreWithTtlDisabled = bool
        }
        uniqueKeyPolicy = {
          uniqueKeys = [
            {
              paths = [
                "string"
              ]
            }
          ]
        }
      }
    }
  })
}

قيم Property

databaseAccounts/sqlDatabases/containers

الاسم الوصف القيمة
النوع نوع المورد "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2024-02-15-preview"
الاسم اسم المورد سلسلة (مطلوب)
الموقع موقع مجموعة الموارد التي ينتمي إليها المورد. سلسلة
parent_id معرف المورد الأصل لهذا المورد. معرف المورد من النوع: sqlDatabases
العلامات العلامات هي قائمة أزواج قيم المفاتيح التي تصف المورد. يمكن استخدام هذه العلامات في عرض هذا المورد وتجميعه (عبر مجموعات الموارد). يمكن توفير 15 علامة كحد أقصى لمورد. يجب أن تحتوي كل علامة على مفتاح لا يزيد عن 128 حرفا وقيمة لا تزيد عن 256 حرفا. على سبيل المثال، يتم تعيين التجربة الافتراضية لنوع القالب باستخدام "defaultExperience": "Cassandra". تتضمن قيم "defaultExperience" الحالية أيضا "Table" و"Graph" و"DocumentDB" و"MongoDB". قاموس أسماء العلامات والقيم.
الهوية هوية المورد. ManagedServiceIdentity
خصائص خصائص لإنشاء حاوية Azure Cosmos DB وتحديثها. SqlContainerCreateUpdatePropertiesOrSqlContainerGetP... (مطلوب)

ManagedServiceIdentity

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

ManagedServiceIdentityUserAssignedIdentities

الاسم الوصف القيمة
{خاصية مخصصة} Components1Jq1T4ISchemasManagedserviceidentityProper...

Components1Jq1T4ISchemasManagedserviceidentityProper...

لا يحتوي هذا الكائن على أي خصائص لتعيينها أثناء التوزيع. جميع الخصائص هي ReadOnly.

SqlContainerCreateUpdatePropertiesOrSqlContainerGetP...

الاسم الوصف القيمة
خيارات زوج قيم المفاتيح من الخيارات التي سيتم تطبيقها على الطلب. يتوافق هذا مع العناوين المرسلة مع الطلب. CreateUpdateOptionsOrSqlContainerGetPropertiesOption...
المورد تنسيق JSON القياسي للحاوية SqlContainerResourceOrSqlContainerGetPropertiesResou... (مطلوب)

CreateUpdateOptionsOrSqlContainerGetPropertiesOption...

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

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

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

SqlContainerResourceOrSqlContainerGetPropertiesResou...

الاسم الوصف القيمة
analyticalStorageTtl مدة البقاء التحليلية. int
نهج تشفير العميل نهج تشفير العميل للحاوية. نهج تشفير العميل
الخصائص الحسابية قائمة الخصائص المحسوبة ComputedProperty[]
conflictResolutionPolicy نهج حل التعارض للحاوية. نهج حل التعارض
createMode تعداد للإشارة إلى وضع إنشاء الموارد. "افتراضي"
"PointInTimeRestore"
"استعادة"
defaultTtl الوقت الافتراضي للعيش int
المعرف اسم حاوية Cosmos DB SQL سلسلة (مطلوبة)
indexingPolicy تكوين نهج الفهرسة. بشكل افتراضي، تكون الفهرسة تلقائية لجميع مسارات المستندات داخل الحاوية سياسة الفهرسة
تم تجسيدViewDefinition تكوين تعريف طرق العرض الفعلية. يجب تحديد هذا فقط لإنشاء حاوية عرض فعلية. معرف العرض المجسد
مفتاح القسم تكوين مفتاح القسم الذي سيتم استخدامه لتقسيم البيانات إلى أقسام متعددة ContainerPartitionKey
مقاييس الاستعادة معلمات للإشارة إلى معلومات حول الاستعادة ResourceRestoreParameters
uniqueKeyPolicy تكوين النهج الرئيسي الفريد لتحديد قيود التفرد على المستندات في المجموعة في خدمة Azure Cosmos DB. UniqueKeyPolicy

نهج تشفير العميل

الاسم الوصف القيمة
مسارات مضمنة مسارات العنصر التي تحتاج إلى تشفير جنبا إلى جنب مع الإعدادات الخاصة بالمسار. ClientEncryptionIncludedPath[] (مطلوب)
policyFormatVersion إصدار تعريف نهج تشفير العميل. الإصدارات المدعومة هي 1 و2. يدعم الإصدار 2 تشفير مسار مفتاح المعرف والقسم. int (مطلوب)

القيود:
الحد الأدنى للقيمة = 1
الحد الأقصى للقيمة = 2

ClientEncryptionIncludedPath

الاسم الوصف القيمة
clientEncryptionKeyId معرف مفتاح تشفير العميل الذي سيتم استخدامه لتشفير المسار. سلسلة (مطلوبة)
encryptionAlgorithm خوارزمية التشفير التي سيتم استخدامها. على سبيل المثال - AEAD_AES_256_CBC_HMAC_SHA256. سلسلة (مطلوبة)
نوع التشفير نوع التشفير المطلوب تنفيذه. على سبيل المثال - محددة، عشوائية. سلسلة (مطلوبة)
مسار المسار الذي يحتاج إلى تشفير. سلسلة (مطلوبة)

حوسبة الحوسبة

الاسم الوصف القيمة
الاسم اسم خاصية حوسبة، على سبيل المثال - "cp_lowerName" سلسلة
استعلام الاستعلام الذي يقيم قيمة الخاصية المحسوبة، على سبيل المثال - "SELECT VALUE LOWER(c.name) FROM c" سلسلة

نهج حل التعارض

الاسم الوصف القيمة
conflictResolutionPath مسار حل التعارض في حالة وضع LastWriterWins. سلسلة
conflictResolutionProcedure إجراء حل التعارضات في حالة الوضع المخصص. سلسلة
الوضع يشير إلى وضع حل التعارض. "مخصص"
"LastWriterWins"

IndexingPolicy

الاسم الوصف القيمة
تلقائي يشير إلى ما إذا كان نهج الفهرسة تلقائيا Bool
المؤشرات المركبة قائمة المسارات المركبة مسار مركب[]
مسارات مستبعدة قائمة المسارات التي يجب استبعادها من الفهرسة ExcludedPath[]
مسارات مضمنة قائمة المسارات المراد تضمينها في الفهرسة IncludedPath[]
وضع الفهرسة يشير إلى وضع الفهرسة. "متناسق"
"كسول"
"لا شيء"
العلامات المكانية قائمة بالتحديدات المكانية SpatialSpec[]

CompositePath

الاسم الوصف القيمة
الترتيب ترتيب الفرز للمسارات المركبة. "تصاعدي"
"تنازلي"
مسار المسار الذي ينطبق عليه سلوك الفهرسة. تبدأ مسارات الفهرس عادة بالجذر وتنتهي بحرف البدل (/path/*) سلسلة

مسار مستبعد

الاسم الوصف القيمة
مسار المسار الذي ينطبق عليه سلوك الفهرسة. تبدأ مسارات الفهرس عادة بالجذر وتنتهي بحرف البدل (/path/*) سلسلة

مسار مضمن

الاسم الوصف القيمة
الفهارس قائمة الفهارس لهذا المسار الفهارس[]
مسار المسار الذي ينطبق عليه سلوك الفهرسة. تبدأ مسارات الفهرس عادة بالجذر وتنتهي بحرف البدل (/path/*) سلسلة

الفهارس

الاسم الوصف القيمة
dataType نوع البيانات الذي يتم تطبيق سلوك الفهرسة عليه. "سلسلة الأسطر"
"تعدد المضلعات"
"رقم"
"نقطة"
"مضلع"
"سلسلة"
نوع يشير إلى نوع الفهرس. "التجزئة"
"النطاق"
"مكاني"
الضبط دقة الفهرس. -1 هو الحد الأقصى للدقة. int

SpatialSpec

الاسم الوصف القيمة
مسار المسار الذي ينطبق عليه سلوك الفهرسة. تبدأ مسارات الفهرس عادة بالجذر وتنتهي بحرف البدل (/path/*) سلسلة
الأنواع قائمة النوع المكاني للمسار صفيف سلسلة يحتوي على أي من:
"سلسلة الأسطر"
"تعدد المضلعات"
"نقطة"
"مضلع"

تم تجسيدViewDefinition

الاسم الوصف القيمة
التعريف يجب أن يكون التعريف استعلام SQL الذي سيتم استخدامه لجلب البيانات من الحاوية المصدر للتعبئة في حاوية العرض الفعلي. سلسلة (مطلوب)
sourceCollectionId اسم الحاوية المصدر التي سيتم إنشاء طريقة العرض المجسدة عليها. سلسلة (مطلوب)

ContainerPartitionKey

الاسم الوصف القيمة
نوع يشير إلى نوع الخوارزمية المستخدمة للتقسيم. بالنسبة إلى MultiHash، يتم دعم مفاتيح أقسام متعددة (حتى ثلاثة كحد أقصى) لإنشاء الحاوية "التجزئة"
"MultiHash"
"النطاق"
المسارات قائمة المسارات التي يمكن تقسيم البيانات داخل الحاوية باستخدامها سلسلة []
version يشير إلى إصدار تعريف مفتاح القسم int

القيود:
الحد الأدنى للقيمة = 1
الحد الأقصى للقيمة = 2

ResourceRestoreParameters

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

UniqueKeyPolicy

الاسم الوصف القيمة
المفاتيح الفريدة قائمة المفاتيح الفريدة على التي تفرض قيد التفرد على المستندات في المجموعة في خدمة Azure Cosmos DB. مفتاح فريد[]

مفتاح فريد

الاسم الوصف القيمة
المسارات يجب أن تكون قائمة المسارات فريدة لكل مستند في خدمة Azure Cosmos DB سلسلة []