بدء استخدام Azure Cosmos DB ل MongoDB باستخدام .NET

ينطبق على: MongoDB

توضح هذه المقالة كيفية الاتصال ب Azure Cosmos DB ل MongoDB باستخدام .NET Core وحزم NuGet ذات الصلة. بمجرد الاتصال، يمكنك إجراء عمليات على قواعد البيانات والحاويات والمستندات.

إشعار

يتوفر مثال القصاصات البرمجية على GitHub كمشروع Microsoft.NET Core.

API للوثائق | المرجعية MongoDB حزمة MongoDB (NuGet)

المتطلبات الأساسية

حساب Azure مع اشتراك نشط. أنشئ حساباً مجاناً.
.NET 6.0
واجهة سطر الأوامر من Azure (واجهة مستوى الاستدعاء) أو Azure PowerShell
Azure Cosmos DB لمورد MongoDB

إنشاء تطبيق Microsoft.NET Core جديد

أنشئ تطبيق Microsoft.NET Core جديد في مجلد فارغ باستخدام terminal تفضِله. لهذا السيناريو، ستستخدم تطبيق وحدة تحكم. استخدم الأمر dotnet new لإنشاء تطبيق وحدة التحكم وتسميته.
```
dotnet new console -o app
```
أضف حزمة MongoDB NuGet إلى مشروع وحدة التحكم. استخدم الأمر الذي dotnet add package يحدد اسم حزمة NuGet.
```
dotnet add package MongoDB.Driver
```
لتشغيل التطبيق، استخدم terminal للانتقال إلى دليل التطبيق وتشغيل التطبيق.
```
dotnet run
```

الاتصال ب Azure Cosmos DB ل MongoDB باستخدام برنامج تشغيل MongoDB الأصلي

للاتصال بـ Azure Cosmos DB باستخدام برنامج تشغيل الجهاز الأصلي MongoDB، أنشئ مثيل للفئة MongoClient. هذه الفئة هي نقطة البداية لتنفيذ جميع العمليات على قواعد بيانات MongoDb. تقبل الدالة الإنشائية الأكثر شيوعاً لـ MongoClient سلسلة اتصال، والتي يمكنك استردادها باستخدام الخطوات التالية:

الحصول على اسم المورد

إنشاء متغير shell لدى resourceGroupName.

# Variable for resource group name
resourceGroupName="msdocs-cosmos"

استخدم الأمر az cosmosdb list لاسترداد اسم حساب Azure Cosmos DB الأول في مجموعة الموارد وتخزينه في متغير accountName shell.

# Retrieve most recently created account name
accountName=$(
    az cosmosdb list \
        --resource-group $resourceGroupName \
        --query "[0].name" \
        --output tsv
)

إنشاء متغير shell لدى RESOURCE_GROUP_NAME.

# Variable for resource group name
$RESOURCE_GROUP_NAME = "msdocs-cosmos"

استخدم الأمر cmdlet Get-AzCosmosDBAccountKey لاسترداد اسم حساب Azure Cosmos DB الأول في مجموعة الموارد الخاصة بك وتخزينه في متغير accountName shell.
```
# Get the name of the first Azure Cosmos DB account in your resource group
$ACCOUNT_NAME = (Get-AzCosmosDBAccount -ResourceGroupName $RESOURCE_GROUP_NAME)[0].Name
```

استرداد سلسلة الاتصال الخاصة بك

ابحث عن واجهة برمجة التطبيقات ل MongoDB سلسلة الاتصال من قائمة سلسلة الاتصال للحساب باستخدام az cosmosdb keys list الأمر .
```
az cosmosdb keys list --type connection-strings \
    --resource-group $resourceGroupName \
    --name $accountName 
```
سجّل قيم المفتاح الأساسي. سوف تستخدم بيانات الاعتماد هذه لاحقًا.

ابحث عن سلسلة الاتصال من قائمة سلاسل الاتصال والمفاتيح للحساب باستخدام Get-AzCosmosDBAccountKey cmdlet.

$parameters = @{
    ResourceGroupName = $RESOURCE_GROUP_NAME
    Name = $ACCOUNT_NAME
    Type = "ConnectionStrings"
}    
Get-AzCosmosDBAccountKey @parameters |
    Select-Object -Property "Primary MongoDB Connection String"

سجّل قيمة سلسلة الاتصال. سوف تستخدم بيانات الاعتماد هذه لاحقًا.

تلميح

نوصي باستخدام اسم مجموعة الموارد msdocs-cosmosفي هذا الدليل.

قم بتسجيل الدخول إلى بوابة Azure.
انتقل إلى صفحة حساب Azure Cosmos DB ل MongoDB الموجودة.
من صفحة حساب Azure Cosmos DB ل MongoDB، حدد خيار قائمة التنقل سلسلة الاتصال.
سجّل القيمة من حقل PRIMARY CONNECTION STRING. يمكنك استخدام هذه القيمة في خطوة لاحقة.

تكوين متغيرات البيئة

لاستخدام قيم CONNECTION STRING داخل التعليمات البرمجية الخاصة بك، قم بتعيين هذه القيمة في البيئة المحلية التي تقوم بتشغيل التطبيق. لتعيين متغير البيئة، استخدم المحطة terminal المفضلة لديك لتشغيل الأوامر التالية:

$env:COSMOS_CONNECTION_STRING = "<cosmos-connection-string>"

export COSMOS_CONNECTION_STRING="<cosmos-connection-string>"

الملف .env هو طريقة قياسية لتخزين متغيرات البيئة في مشروع. أنشئ ملف .env في جذر المشروع الخاص بك. إضافة الأسطر التالية إلى الملف .env:

COSMOS_CONNECTION_STRING="<cosmos-connection-string>"

إنشاء MongoClient بسلسلة الاتصال

حدد مثيلًا جديدًا للفئة MongoClient باستخدام الدالة الإنشائية ومتغير سلسلة الاتصال الذي عيّنته مسبقًا.

// New instance of CosmosClient class
var client = new MongoClient(Environment.GetEnvironmentVariable("COSMOS_CONNECTION_STRING"));

var settings = client.Settings;

Console.WriteLine(settings.Server.Host);

استخدام فئات عميل MongoDB مع Azure Cosmos DB لواجهة برمجة التطبيقات ل MongoDB

قبل البدء في إنشاء التطبيق، لنلقِ نظرة على التدرج الهرمي للموارد في قاعدة بيانات Azure Cosmos DB. تحتوي قاعدة بيانات Azure Cosmos DB على نموذج كائن محدد يُستخدم لإنشاء الموارد والوصول إليها. تنشئ قاعدة بيانات Azure Cosmos DB موارد في تدرج هرمي يتكون من الحسابات وقواعد البيانات والحاويات والمستندات.

رسم تخطيطي ل Azure Cosmos DB للتسلسل الهرمي ل MongoDB بما في ذلك الحسابات وقواعد البيانات والمجموعات والمستندات.

يُمثل كل نوع من الموارد بفئة C# مقترنة أو أكثر. فيما يلي قائمة بالفئات الأكثر شيوعاً:

الفصل	‏‏الوصف
`MongoClient`	توفر هذه الفئة تمثيلا منطقيا من جانب العميل لواجهة برمجة التطبيقات لطبقة MongoDB على Azure Cosmos DB. يتم استخدام كائن العميل لتكوين الطلبات وتنفيذها على الخدمة.
`MongoDatabase`	هذه الفئة مرجع لإحدى قواعد البيانات التي قد تكون موجودة في الخدمة أو قد لا تكون موجودة بعد. يُتحقق من صحة قاعدة البيانات أو إنشائها من جانب الخادم عند محاولة إجراء عملية عليها.
`Collection`	هذه الفئة هي إشارة إلى مجموعة قد لا تكون موجودة في الخدمة بعد. يتم التحقق من صحة المجموعة من جانب الخادم عندما تحاول استخدامها.

توضح لك الإرشادات التالية كيفية استخدام كل فئة من هذه الفئات لإنشاء التطبيق وإدارة البيانات.

الدليل:

(راجع أيضًا )

الخطوات التالية

الآن بعد أن قمت بالاتصال بواجهة برمجة تطبيقات لحساب MongoDB، استخدم الدليل التالي لإنشاء قواعد البيانات وإدارتها.

إنشاء قاعدة بيانات في Azure Cosmos DB ل MongoDB باستخدام .NET

الملاحظات

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

Last updated on 2024-08-15