إنشاء حساب Azure Cosmos DB ل NoSQL

ينطبق على: NoSQL

يحتوي حساب Azure Cosmos DB ل NoSQL على جميع موارد Azure Cosmos DB: قواعد البيانات والحاويات والعناصر. يوفر الحساب نقطة نهاية فريدة للعديد من الأدوات ومجموعات SDK للاتصال بـ Azure Cosmos DB وتنفيذ العمليات اليومية. لمزيد من المعلومات حول الموارد في قاعدة بيانات Azure Cosmos DB، راجع نموذج مورد Azure Cosmos DB.

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

• حساب Azure باشتراك نشط. أنشئ حساباً مجانياً.

إنشاء حساب

إنشاء حساب Azure Cosmos DB واحد باستخدام واجهة برمجة التطبيقات ل NoSQL.

Azure CLI

1. قم بإنشاء متغيرات shell لـ accountName وresourceGroupNameوالموقع.

   # Variable for resource group name
   resourceGroupName="msdocs-cosmos"
   
   # Variable for location
   location="westus"
   
   # Variable for account name with a randomnly generated suffix
   let suffix=$RANDOM*$RANDOM
   accountName="msdocs-$suffix"
   

2. إذا لم تكن قد قمت بتسجيل الدخول بالفعل، فسجل الدخول إلى Azure واجهة مستوى الاستدعاء باستخدام الأمر az login.

3. استخدم الأمر az group create لإنشاء مجموعة الموارد جديدة في اشتراكك.

   az group create \
       --name $resourceGroupName \
       --location $location
   

4. az cosmosdb create استخدم الأمر لإنشاء حساب Azure Cosmos DB جديد لحساب NoSQL مع الإعدادات الافتراضية.

   az cosmosdb create \
       --resource-group $resourceGroupName \
       --name $accountName \
       --locations regionName=$location
   

PowerShell

1. إنشاء متغيرات shell لـ ACCOUNT_NAME وRESOURCE_GROUP_NAME وLOCATION.

   # Variable for resource group name
   $RESOURCE_GROUP_NAME = "msdocs-cosmos"
   
   # Variable for location
   $LOCATION = "West US"
   
   # Variable for account name with a randomnly generated suffix
   $SUFFIX = Get-Random
   $ACCOUNT_NAME = "msdocs-$SUFFIX"
   

2. إذا لم تكن قد قمت بذلك بالفعل، فقم بتسجيل الدخول إلى Azure PowerShell باستخدام الأمرConnect-AzAccount cmdlet.

3. استخدم cmdlet New-AzResourceGroup لإنشاء مجموعة الموارد جديدة في اشتراكك.

   $parameters = @{
       Name = $RESOURCE_GROUP_NAME
       Location = $LOCATION
   }
   New-AzResourceGroup @parameters    
   

4. New-AzCosmosDBAccount استخدم cmdlet لإنشاء حساب Azure Cosmos DB جديد ل NoSQL مع الإعدادات الافتراضية.

   $parameters = @{
       ResourceGroupName = $RESOURCE_GROUP_NAME
       Name = $ACCOUNT_NAME
       Location = $LOCATION
   }
   New-AzCosmosDBAccount @parameters
   

المدخل

تلميح

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

1. تسجيل الدخول إلى ⁧⁩مدخل Microsoft Azure⁧⁩.

2. من قائمة مدخل Microsoft Azure أو الصفحة الرئيسية، حدد Create a resource.

3. في الصفحة جديد، ابحث عن Azure Cosmos DB وحدده.

4. في صفحة تحديد خيار واجهة برمجة التطبيقات ، حدد الخيار إنشاء داخل قسم NoSQL - التوصية . تحتوي قاعدة بيانات Azure Cosmosos على خمس واجهات برمجة تطبيقات: SQL وMongoDB وGremlin وTable وCassandra. تعرف على المزيد حول واجهة برمجة التطبيقات ل NoSQL.

   

5. في صفحة Create Azure Cosmos DB Account، أدخل للمعلومات التالية:

   إعداد	القيمة	الوصف
   الاشتراك	اسم الاشتراك	حدد اشتراك Azure الذي ترغب في استخدامه لحساب Azure Cosmos DB هذا.
   مجموعة الموارد	اسم مجموعة الموارد	حدد مجموعة موارد، أو حدد إنشاء جديد، ثم أدخل اسمًا فريدًا لمجموعة الموارد الجديدة.
   اسم الحساب	اسم فريد	أدخل اسما لتعريف حساب Azure Cosmos DB الخاص بك. سيتم استخدام الاسم كجزء من اسم مجال مؤهل بالكامل (FQDN) مع لاحقة من documents.azure.com، لذلك يجب أن يكون الاسم فريدًا بشكل عام. لا يمكن أن يحتوي الخادم إلا على أحرف صغيرة وأرقام وحرف الواصلة (-). يجب أن يتراوح طول الاسم أيضًا بين 3 و44 حرفًا.
   ‏‏الموقع	المنطقة الأقرب إلى مستخدميك	حدد موقعًا جغرافيًا لاستضافة حساب Azure Cosmos DB. استخدم الموقع الأقرب إلى المستخدمين لمنحهم أسرع وصول إلى البيانات.
   وضع السعة	معدل النقل أو من دون خادم	حدد Provisioned throughput لإنشاء حساب في وضع معدل النقل المتوفر. حدد Serverless لإنشاء حساب في وضع دون خادم.
   تطبيق Azure Cosmos DB خصم الطبقة الحرة	تطبيق أو عدم تطبيق	مع المستوى المجاني من Azure Cosmos DB، سوف تحصل على أول 1000 RU/ثانية و25 غيغابايت من التخزين مجانًا في حساب. تعرف على المزيد حول الطبقة المجانية.

   ملاحظة

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

   

6. حدد Review + create.

7. راجع الإعدادات التي تقدمها، ثم حدد Create. يستغرق إنشاء جهاز ظاهر بضع دقائق. انتظر حتى يتم عرض صفحة المدخل، اكتمل التوزيع قبل الانتقال.

8. حدد الانتقال إلى المورد للانتقال إلى صفحة حساب Azure Cosmos DB.

   

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

في هذا الدليل، تعلمت كيفية إنشاء حساب Azure Cosmos DB ل NoSQL. يمكنك الآن إنشاء تطبيق باستخدام حساب Azure Cosmos DB الخاص بك.

إنشاء تطبيق وحدة تحكم .NET باستخدام Azure Cosmos DB ل NoSQL