تمكين حساب Cosmos DB لاستخدام Azure Synapse Link

  • 5 دقائق

إن Azure Synapse Link لـ Azure Cosmos DB هو قدرة HTAP الأصلية على السحابة التي تتيح التكامل بين Azure Cosmos DB وAzure Synapse Analytics.

A diagram showing Azure Synapse Link integration with Azure Cosmos DB and Azure Synapse Analytics.

في الرسم التخطيطي أعلاه، يتم توضيح الميزات الرئيسية التالية لـ Azure Synapse Link لهيكل Cosmos DB:

  1. توفر حاوية Azure Cosmos DB مخزن معاملات يستند إلى صف تم تحسينه لعمليات القراءة/الكتابة.
  2. توفر الحاوية أيضاً مخزناً تحليلياً مستنداً إلى الأعمدة تم تحسينه لأحمال العمل التحليلية. تحافظ عملية المزامنة التلقائية المدارة بالكامل على مزامنة مخازن البيانات.
  3. يوفر Azure Synapse Link خدمة مرتبطة تربط الحاوية الممكنة للمخزن التحليلي في Azure Cosmos DB بمساحة عمل Azure Synapse Analytics.
  4. يوفر Azure Synapse Analytics أوقات تشغيل Synapse SQL وApache Spark حيث يمكنك تشغيل التعليمات البرمجية لاسترداد البيانات ومعالجتها وتحليلها من مخزن Azure Cosmos DB التحليلي دون التأثير على مخزن بيانات المعاملات في Azure Cosmos DB.

الخطوة الأولى في استخدام Azure Synapse Link لـ Cosmos DB هي تمكينه في حساب Azure Cosmos DB. يتم دعم Azure Synapse Link في الأنواع التالية من حساب Azure Cosmos DB:

  • Azure Cosmos DB لـ NoSQL
  • Azure Cosmos DB for MongoDB
  • Azure Cosmos DB ل Apache Gremlin (معاينة)

يمكنك تمكين Azure Synapse Link في صفحة مدخل Microsoft Azure لحساب Cosmos DB الخاص بك، أو باستخدام Azure CLI أو Azure PowerShell من سطر أوامر أو في برنامج نصي.

استخدام مدخل Microsoft Azure

في مدخل Microsoft Azure، يمكنك تمكين Azure Synapse Link لحساب Cosmos DB على صفحة Azure Synapse Link في قسم Integrations ، كما هو موضح أدناه.

A screenshot showing the option to enable Azure Synapse Link for a Cosmos DB for NoSQL account.

تلميح

بالنسبة إلى Azure Cosmos DB لحسابات NoSQL، هناك أيضا ارتباط في صفحة Data Explorer .

استخدام Azure CLI

لتمكين Azure Synapse Link باستخدام Azure CLI، قم بتشغيل الأمر az cosmosdb create (لإنشاء حساب Cosmos DB جديد) أو أمر az cosmosdb update (لتكوين حساب Cosmos DB موجود) باستخدام المعلمة --enable-analytical-storage true. على سبيل المثال، يقوم الأمر التالي بتحديث حساب Cosmos DB موجود يسمى my-cosmos-db لتمكين Azure Synapse Link.

az cosmosdb update --name my-cosmos-db --resource-group my-rg --enable-analytical-storage true

لتمكين Azure Synapse Link لحساب Azure Cosmos DB لحساب Apache Gremlin، قم بتضمين المعلمة --capabilities EnableGremlin .

باستخدام Azure PowerShell

لتمكين Azure Synapse Link باستخدام Azure PowerShell، قم بتشغيل New-AzCosmosDBAccount cmdlet (لإنشاء حساب Cosmos DB جديد) أو Update-AzCosmosDBAccount cmdlet (لتكوين حساب Cosmos DB موجود) باستخدام المعلمة -EnableAnalyticalStorage 1. على سبيل المثال، يقوم الأمر التالي بتحديث حساب Cosmos DB موجود يسمى my-cosmos-db لتمكين Azure Synapse Link.

Update-AzCosmosDBAccount -Name "my-cosmos-db" -ResourceGroupName "my-rg" -EnableAnalyticalStorage 1

عند التخطيط لتمكين Azure Synapse Link لحساب Cosmos DB، ضع في اعتبارك الحقائق التالية:

  • بعد تمكين Azure Synapse Link لحساب، لا يمكنك تعطيله.

  • لا يؤدي تمكين Azure Synapse Link إلى بدء مزامنة البيانات التشغيلية إلى مخزن تحليلي - يجب عليك أيضاً إنشاء حاوية أو تحديثها بدعم من مخزن تحليلي.

  • عند تمكين Azure Synapse Link لحساب Cosmos DB for NoSQL باستخدام Azure CLI أو PowerShell، يمكنك استخدام --analytical-storage-schema-type المعلمة (Azure CLI) أو -AnalyticalStorageSchemaType (PowerShell) لتحديد نوع المخطط ك WellDefined (افتراضي) أو FullFidelity. بالنسبة لحساب Cosmos DB لحساب MongoDB، يكون نوع المخطط الافتراضي (والمدعم فقط) هو FullFidelity.

  • بعد تعيين نوع مخطط، لا يمكنك تغييره.

    إشعار

    ستتعرف على المزيد حول المخزن التحليلي وأنواع المخططات الخاصة به في الوحدة التالية.