إنشاء حساب 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 CLI باستخدام الأمر 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
   

بوويرشيل

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. استخدم New-AzResourceGroup cmdlet لإنشاء مجموعة موارد جديدة في اشتراكك.

   $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. قم بتسجيل الدخول إلى بوابة Azure.

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

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

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

   

5. في صفحة إنشاء حساب Azure Cosmos DB، أدخل المعلومات التالية:

   الإعداد	قيمة	‏‏الوصف
   الاشتراك	اسم الاشتراك	حدد اشتراك 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. راجع الإعدادات التي تقدمها، ثم حدد إنشاء. يستغرق إنشاء جهاز ظاهر بضع دقائق. انتظر حتى يتم عرض صفحة المدخل، اكتمل التوزيع الخاص بك قبل المضي قدمًا.

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

   

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

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

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