Azure Cosmos DB for NoSQL 的具体化视图（预览版）

登录到 Azure 门户。

前往你的 API for NoSQL 帐户。

在资源菜单中，选择“设置”。

在“功能”部分中的“设置”下，将“NoSQL API 的具体化视图(预览版)”选项切换为“打开”。

在新对话框中，选择“启用”为帐户启用此功能。

登录 Azure CLI。

az login

为现有 API for NoSQL 帐户的资源组和帐户名称定义变量。

# Variable for resource group name
resourceGroupName="<resource-group-name>"

# Variable for account name
accountName="<account-name>"

# Variable for Azure subscription
subscriptionId="<subscription-id>"

使用功能清单创建一个名为 capabilities.json 的新 JSON 文件。

{
  "properties": {
    "enableMaterializedViews": true
  }
}

获取帐户的标识符，并将其存储在名为 $accountId 的 shell 变量中。

accountId="/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/$accountName"

使用 REST API 和带有 HTTP PATCH 谓词的 az rest 为帐户启用预览具体化视图功能。

az rest \
    --method PATCH \
    --uri "https://management.chinacloudapi.cn/$accountId?api-version=2022-11-15-preview" \
    --body @capabilities.json

登录到 Azure 门户。

前往你的 API for NoSQL 帐户。

在资源菜单中，选择“具体化视图生成器”。

在“具体化视图生成器”页面上，为生成器配置 SKU 和实例数。

选择“保存”。

使用生成器清单创建一个名为 builder.json 的新 JSON 文件：

{
  "properties": {
    "serviceType": "materializedViewsBuilder",
    "instanceCount": 1,
    "instanceSize": "Cosmos.D4s"
  }
}

使用 REST API 和带有 HTTP PUT 谓词的 az rest 为帐户启用具体化视图生成器：

az rest \
    --method PUT \
    --uri "https://management.chinacloudapi.cn$accountId/services/materializedViewsBuilder?api-version=2022-11-15-preview" \
    --body @builder.json

等待几分钟，然后再次使用 az rest 和 HTTP GET 谓词检查状态。 输出中的状态现应为 Running。

az rest \
    --method GET \
    --uri "https://management.chinacloudapi.cn$accountId/services/materializedViewsBuilder?api-version=2022-11-15-preview"

使用 Azure 门户、Azure SDK、Azure CLI 或 REST API 创建一个将 /accountId 用作分区键路径的源容器。 将此源容器命名为 mv-src。

在源容器中插入几个项。 若要遵循本文中所示的示例，请确保项具有 accountId、fullName 和 emailAddress 字段。 示例项可能类似于以下示例：

{
  "accountId": "prikrylova-libuse",
  "emailAddress": "libpri@contoso.com",
  "name": {
    "first": "Libuse",
    "last": "Prikrylova"
  }
}

现在，使用不同于源容器的分区键路径创建名为 mv-target 的具体化视图。 对于此示例，请将 /emailAddress 指定为 mv-target 容器的分区键路径。

1. 首先，为具体化视图创建定义清单，并将其保存在名为 definition.json 的 JSON 文件中：

   {
     "location": "China North",
     "tags": {},
     "properties": {
       "resource": {
         "id": "mv-target",
         "partitionKey": {
           "paths": [
             "/emailAddress"
           ],
           "kind": "Hash"
         },
         "materializedViewDefinition": {
           "sourceCollectionId": "mv-src",
           "definition": "SELECT s.accountId, s.emailAddress FROM s"
         }
       },
       "options": {
         "throughput": 400
       }
     }
   }        
   

现在，发出 REST API 调用以创建 mv_definition.json 文件中定义的具体化视图。 使用 Azure CLI 发出 REST API 调用。

1. 为具体化视图的名称和源数据库名称创建变量：

   materializedViewName="mv-target"
   
   # Variable for database name used in later section
   databaseName="<database-that-contains-source-collection>"
   

2. 如果还没有的话，请获取帐户的标识符，并将其存储在名为 $accountId 的 shell 变量中。

   accountId="/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/$accountName"
   

3. 发出 REST API 调用以创建具体化视图：

   az rest \
       --method PUT \
       --uri "https://management.chinacloudapi.cn$accountId/sqlDatabases/";\
             "$databaseName/containers/$materializedViewName?api-version=2022-11-15-preview" \
       --body @definition.json \
       --headers content-type=application/json
   

4. 使用 REST API 检查具体化视图容器的创建状态：

   az rest \
       --method GET \
       --uri "https://management.chinacloudapi.cn$accountId/sqlDatabases/";\
             "$databaseName/containers/$materializedViewName?api-version=2022-11-15-preview" \
       --headers content-type=application/json \
       --query "{mvCreateStatus: properties.Status}"