Создание учетной записи и таблицы Azure Cosmos DB с автомасштабированием с помощью Azure CLI

  • Статья

Область применения: Таблица

Сценарий, приведенный в этой статье, создает учетную запись и таблицу Azure Cosmos DB для таблицы с автомасштабированием.

Необходимые компоненты

  • Если у вас еще нет подписки Azure, создайте бесплатную учетную запись Azure, прежде чем начинать работу.

  • Для этого скрипта требуется Azure CLI 2.12.1 или более поздней версии.

    • Скрипт можно запустить в среде Bash в Azure Cloud Shell. Когда Cloud Shell откроется, убедитесь, что в поле среды в левом верхнем углу окна оболочки отображается Bash. Cloud Shell всегда содержит последнюю версию Azure CLI.

      Cloud Shell автоматически проходит аутентификацию под учетной записью, с помощью которой вы выполнили вход на портале Azure. Вы можете использовать az account set для входа в другую подписку, заменив <subscriptionId> идентификатором подписки Azure.

      subscription="<subscriptionId>" # add subscription here

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

    • При желании вы можете установить Azure CLI для локального запуска скрипта. Выполните команду az version, чтобы узнать вашу версию Azure CLI и установленные зависимые библиотеки, а затем выполните команду az upgrade, если требуется выполнить обновление. При появлении запроса установите расширения Azure CLI. Если вы работаете в Windows или macOS, Azure CLI можно запустить в контейнере Docker.

      Если вы используете локальную установку, войдите в Azure, выполнив команду az login и следуя подсказкам на экране. Сведения о других возможностях, доступных при входе, см. в статье Вход с помощью Azure CLI.

Пример скрипта

Выполните следующий сценарий, чтобы создать группу ресурсов Azure, учетную запись Azure Cosmos DB для таблицы и API для таблицы с возможностью автомасштабирования. Создание ресурсов может занять некоторое время.

# 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 with --capabilities EnableTable create an Azure Cosmos DB account for API for Table.
  • az cosmosdb table create with --max-throughput 1000 create an Azure Cosmos DB for Table table with autoscale capabilities.

Очистка ресурсов

Если вам больше не нужны созданные вами ресурсы, используйте команду az group delete, чтобы удалить группу ресурсов и все содержащиеся в ней ресурсы, включая учетную запись и пространство ключей Azure Cosmos DB. Удаление ресурсов может занять некоторое время.

az group delete --name $resourceGroup

Следующие шаги