Microsoft Azure - 在 Cosmos DB 中使用 PowerShell

Azure Cosmos DB 是 Azure 的分布式多模型数据库服务。它支持多种数据模型，包括文档、键值、图形、列族和表格。通过使用 PowerShell，可以轻松管理 Cosmos DB。

安装 Azure PowerShell 模块

在开始使用 PowerShell 操作 Cosmos DB 之前，首先需要安装 Azure PowerShell 模块。可以按照以下步骤进行安装：

1. 打开 PowerShell 控制台。

2. 运行以下命令以安装 Azure PowerShell 模块：

   Install-Module -Name Az -AllowClobber
   

   上述命令会从 PowerShell 库中安装 Az 模块，并在需要时替换旧版本。

连接到 Azure 帐户

安装完 Azure PowerShell 模块后，可以使用 PowerShell 连接到 Azure 帐户。可以按照以下步骤进行连接：

1. 运行以下命令以登录到 Azure 帐户：

   Connect-AzAccount
   

2. 根据提示输入 Azure 帐户的凭据。

   输入凭据后，会向 PowerShell 提供 Azure 帐户的访问令牌，以便在执行 Azure 命令时进行身份验证。

在 Cosmos DB 中创建数据库和容器

使用 PowerShell 可以轻松在 Cosmos DB 中创建数据库和容器。可以按照以下步骤进行创建：

1. 运行以下命令创建 Cosmos DB 数据库：

   New-AzCosmosDBSqlDatabase -ResourceGroupName "<your-resource-group-name>" -AccountName "<your-cosmos-db-account-name>" -Name "<your-database-name>"
   

2. 运行以下命令创建 Cosmos DB 容器：

   New-AzCosmosDBSqlContainer -ResourceGroupName "<your-resource-group-name>" -AccountName "<your-cosmos-db-account-name>" -DatabaseName "<your-database-name>" -Name "<your-container-name>" -PartitionKeyPath "/<partition-key-property>" -Throughput <throughput-level>
   

   • <your-resource-group-name>：资源组名称。
   • <your-cosmos-db-account-name>：Cosmos DB 帐户名称。
   • <your-database-name>：数据库名称。
   • <your-container-name>：容器名称。
   • <partition-key-property>：分区键属性。
   • <throughput-level>：吞吐量级别。最低可以设置为 400 RU/s。

将数据插入 Cosmos DB 容器

使用 PowerShell 可以将数据轻松地插入 Cosmos DB 容器。可以按照以下步骤进行插入：

1. 运行以下命令以创建 Cosmos DB 文档：

   $document = @{
       id = "<document-id>"
       value = "<document-value>"
     }
   

   • <document-id>：文档 ID。
   • <document-value>：文档值。

2. 运行以下命令以将文档插入 Cosmos DB 容器：

   New-AzCosmosDBSqlDocument -ResourceGroupName "<your-resource-group-name>" -AccountName "<your-cosmos-db-account-name>" -DatabaseName "<your-database-name>" -ContainerName "<your-container-name>" -Document $document
   

在 Cosmos DB 中查询数据

使用 PowerShell 可以轻松地查询 Cosmos DB 容器中的数据。可以按照以下步骤进行查询：

1. 运行以下命令以查询 Cosmos DB 容器中的所有文档：

   Get-AzCosmosDBSqlDocument -ResourceGroupName "<your-resource-group-name>" -AccountName "<your-cosmos-db-account-name>" -DatabaseName "<your-database-name>" -ContainerName "<your-container-name>"
   

2. 运行以下命令以查询 Cosmos DB 容器中与给定条件匹配的文档：

   $query = "SELECT * FROM c WHERE c.<property> = '<property-value>'"
   $results = Get-AzCosmosDBSqlQuery -ResourceGroupName "<your-resource-group-name>" -AccountName "<your-cosmos-db-account-name>" -DatabaseName "<your-database-name>" -ContainerName "<your-container-name>" -Query $query
   

   • <property>：属性名称。
   • <property-value>：属性值。

总结

使用 PowerShell 可以轻松地在 Cosmos DB 中创建数据库和容器、将数据插入容器以及查询容器中的数据。Azure PowerShell 库提供了多个功能强大的命令，可以常规管理 Azure 资源。