مشاركة عبر

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

  • مقالة

ينطبق على: جدول

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

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

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

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

    • يمكنك تشغيل البرنامج النصي في بيئة 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 للجدول، وواجهة برمجة التطبيقات لجدول Table مع إمكانية التحجيم التلقائي. قد تستغرق الموارد بعض الوقت لإنشائها.

# Create a Table API table with autoscale

# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="msdocs-cosmosdb-rg-$randomIdentifier"
tag="autoscale-table-cosmosdb"
account="msdocs-account-cosmos-$randomIdentifier" #needs to be lower case
table="msdocs-table-cosmos-$randomIdentifier"
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 Table API
echo "Creating $account"
az cosmosdb create --name $account --resource-group $resourceGroup --capabilities EnableTable --default-consistency-level Eventual --locations regionName="$location" failoverPriority=0 isZoneRedundant=False

# Create a Table API Table with autoscale
echo "Create $table with $maxThroughput"
az cosmosdb table create --account-name $account --resource-group $resourceGroup --name $table --max-throughput $maxThroughput

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

  • ينشئ az group create مجموعة موارد لتخزين جميع الموارد.
  • ينشئ az cosmosdb create مع --capabilities EnableTable حساب Azure Cosmos DB لواجهة برمجة التطبيقات للجدول.
  • az cosmosdb table create with --max-throughput 1000 creates a Azure Cosmos DB for Table table table with autoscale capabilities.

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

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

az group delete --name $resourceGroup

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