مشاركة عبر

إنشاء Azure Cosmos DB لحساب NoSQL وقاعدة البيانات والحاوية باستخدام التحجيم التلقائي

  • مقالة

ينطبق على: NoSQL

ينشئ البرنامج النصي في هذه المقالة حساب Azure Cosmos DB ل NoSQL وقاعدة بيانات وحاوية مع مقياس تلقائي.

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

  • إذا لم يكن لديك اشتراك في Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.

  • يتطلب هذا البرنامج النصي Azure CLI الإصدار 2.0.73 أو أحدث.

    • يمكنك تشغيل البرنامج النصي في بيئة Bash في Azure Cloud Shell. عند فتح Cloud Shell، تأكد من ظهور Bash في حقل البيئة في أعلى يسار نافذة shell. يستخدم Cloud Shell دائمًا أحدث إصدار من Azure CLI.

      تتم مصادقة Cloud Shell تلقائيًا ضمن الحساب الذي استخدمته لتسجيل الدخول إلى مدخل Microsoft Azure. يمكنك استخدام az account set لتسجيل الدخول باستخدام اشتراك مختلف، واستبدال <subscriptionId> بمعرف اشتراك Azure الخاص بك.

      subscription="<subscriptionId>" # add subscription here

az account set -s $subscription # ...or use 'az login'

    • إذا أردت، يمكنك تثبيت Azure CLI لتشغيل البرنامج النصي محليا. شغّل إصدار az للبحث عن إصدار Azure CLI، والمكتبات التابعة التي تم تثبيتها وتشغيل ترقية az إذا كنت بحاجة إلى الترقية. إذا طلب منك ذلك، فقم بتثبيت ملحقات Azure CLI. إذا كنت تعمل على Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker.

      إذا كنت تستخدم تثبيتًا محليًا، فقم بتسجيل الدخول إلى Azure عن طريق تشغيل تسجيل الدخول من az واتباع المطالبات. للحصول على خيارات أخرى لتسجيل دخول، راجع تسجيل الدخول باستخدام Azure CLI.

نموذج البرنامج النصي

قم بتشغيل البرنامج النصي التالي لإنشاء مجموعة موارد Azure، وحساب وقاعدة بيانات Azure Cosmos DB ل NoSQL، وحاوية ذات مقياس تلقائي. قد تستغرق الموارد بعض الوقت لإنشائها.

# Create a SQL API database and container with autoscale

# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="msdocs-cosmosdb-rg-$randomIdentifier"
tag="autoscale-sql-cosmosdb"
account="msdocs-account-cosmos-$randomIdentifier" #needs to be lower case
database="msdocs-db-sql-cosmos"
container="container1"
partitionKey="/partitionKey"
maxThroughput=1000 #minimum = 1000

# Create a resource group
echo "Creating $resourceGroup in $location..."
az group create --name $resourceGroup --location "$location" --tags $tag

# Create a Cosmos account for SQL API
echo "Creating $account"
az cosmosdb create --name $account --resource-group $resourceGroup --default-consistency-level Eventual --locations regionName="$location" failoverPriority=0 isZoneRedundant=False

# Create a SQL API database
echo "Creating $database"
az cosmosdb sql database create --account-name $account --resource-group $resourceGroup --name $database

# Create a SQL API container with autoscale
echo "Creating $container with $maxThroughput"
az cosmosdb sql container create --account-name $account --resource-group $resourceGroup --database-name $database --name $container --partition-key-path $partitionKey --max-throughput $maxThroughput

يستخدم هذا البرنامج النصي الأوامر التالية:

  • ينشئ az group create مجموعة موارد لتخزين جميع الموارد.
  • ينشئ az cosmosdb create حساب Azure Cosmos DB لواجهة برمجة التطبيقات ل NoSQL.
  • تنشئ قاعدة بيانات az cosmosdb sql قاعدة بيانات Azure Cosmos DB لقاعدة بيانات NoSQL.
  • az cosmosdb sql container create with --max-throughput 1000 creates an Azure Cosmos DB for NoSQL container with autoscale capability.

تنظيف الموارد

إذا لم تكن بحاجة إلى الموارد التي قمت بإنشائها، فاستخدم الأمر az group delete لحذف مجموعة الموارد وجميع الموارد التي تحتوي عليها. تتضمن هذه الموارد حساب Azure Cosmos DB وقاعدة البيانات والحاوية. قد تستغرق الموارد بعض الوقت لحذفها.

az group delete --name $resourceGroup

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