準備

4 分鐘

您會建置 .NET 應用程式，以匯入和查詢 Azure Cosmos DB for NoSQL 容器中的資料。我們會在此討論專案的整體目標，以及如何實作匯入和查詢功能。此外，我們會討論如何為您需要的 NoSQL 帳戶設定 API。

Illustration of the icon of an Azure Cosmos DB account.

專案概觀

此專案的目標是建置及驗證 .NET 主控台應用程式，以上傳和查詢 NoSQL 容器 API 中的項目。 .NET 應用程式會使用 Azure Cosmos DB for NoSQL 的 .NET SDK 來與 Azure 中的服務執行個體互動。專案程式碼會使用交易式批次同時建立多個相關項目。專案程式碼也會使用以字串表示的查詢，來驗證已成功上傳的項目。

下列流程圖顯示應用程式需要執行的商務邏輯：

您需要執行的主要工作如下:

建立 Azure Cosmos DB 帳戶並擷取連接字串。
建立 .NET 主控台應用程式，並將套件參考新增至 Microsoft.Azure.Cosmos SDK。
建立資料庫和容器資源。
將單一項目新增為簡單作業。
建立交易式批次以新增四個項目。
執行並觀察查詢的結果。

設定

若要完成此專案，您需要適用於 NoSQL 帳戶的 API。

建立 Azure Cosmos DB for NoSQL 帳戶

NoSQL API 帳戶將用來儲存您在此專案中建立的資料，以及執行查詢。本章節將引導您完成直接在 Azure Cloud Shell 終端機中使用 Azure CLI 建立新帳戶的步驟。

建立一個名為 suffix 並具有隨機數字的新 shell 變數。在 [沙箱資源群組名稱] 資源群組內，建立一個新的 API for NoSQL 帳戶。
```
let suffix=$RANDOM*$RANDOM

az cosmosdb create \
    --resource-group "<rgn>[sandbox resource group name]</rgn>" \
    --name "mslearn-$suffix" \
    --locations "regionName=westus"
```
重要

此資源群組已由沙箱建立。
等候命令在建立新帳戶之後完成。建立新的帳戶可能需要幾分鐘的時間。

提示

您可以使用 Azure 入口網站來瀏覽至您的新 API for NoSQL 帳戶。

取得帳戶連接字串

現在您已有 API for NoSQL 帳戶，您可以在 Azure CLI 中使用 az cosmosdb keys list 命令來取得該帳戶的認證。在本章節中，您將篩選命令的輸出，只傳回單一連接字串。

首先，取得最近建立的 API for NoSQL 帳戶的名稱。

let resourceGroup="<rgn>[sandbox resource group name]</rgn>"

az cosmosdb list \
    --resource-group $resourceGroup \
    --query "sort_by([].{name:name,created:systemData.createdAt}, &created)" \
    --output table

現在，從最近建立的帳戶清單中取得第一個帳戶的 Primary SQL Connection String 認證。

let resourceGroup="<rgn>[sandbox resource group name]</rgn>"

az cosmosdb keys list \
    --resource-group $resourceGroup \
    --name $(az cosmosdb list \
        --resource-group $resourceGroup \
        --query "sort_by([].{name:name,created:systemData.createdAt}, &created)[0].name" \
        --output tsv) \
    --type connection-strings \
    --query "connectionStrings[?description=='Primary SQL Connection String'].connectionString" \
    --output tsv