現在比以往任何時候都更有選擇，關於適合用於資料負載的資料庫類型。 選擇資料庫的關鍵因素之一是資料庫或服務的效能，但基準測試效能可能繁瑣且容易出錯。
Azure 資料庫的基準測試框架簡化了效能衡量流程，採用熱門開源基準工具，提供低摩擦的方案，並實施共同最佳實務。 在 Azure Cosmos DB for NoSQL 中，該框架實作了 Java SDK 的最佳實務 ，並使用開源的 YCSB 工具。 在本指南中，你會使用這個基準測試框架來實作讀取工作負載，以熟悉這個框架。
Prerequisites
建立 Azure Cosmos DB 帳戶資源
首先，你在現有的 API 裡建立一個資料庫和容器來管理 NoSQL 帳號。
在 Azure 入口網站中，前往你現有的 NoSQL API 帳戶。
在 [資源] 功能表中，選取 [資料總管]。
在 資料總管 頁面，請在指令列選擇 新容器 選項。
在 新容器 對話框中，請建立一個新的容器，並設定如下：
| 設定 |
Value |
|
資料庫識別碼 |
ycsb |
|
資料庫吞吐量類型 |
手動 |
|
資料庫吞吐量金額 |
400 |
|
容器識別碼 |
usertable |
|
分區鍵 |
/id |
如果您尚未登入，請使用 az login 命令登入 Azure CLI。
建立以下數值的殼變數：
- 你現有的 Azure Cosmos DB for NoSQL 帳號名稱為
cosmosAccountName。
- 你的第一個資源群組，其資源命名為
sourceResourceGroupName。
- 你第二個空資源群組名稱為
targetResourceGroupName。
- 現有的 Azure Cosmos DB for NoSQL 帳戶端點 URI，名為
cosmosEndpoint
- 現有的 Azure Cosmos DB for NoSQL 帳戶主要金鑰命名為
cosmosPrimaryKey
# Variable for Azure Cosmos DB for NoSQL account name
cosmosAccountName="<cosmos-db-nosql-account-name>"
# Variable for resource group with Azure Cosmos DB and Azure Storage accounts
sourceResourceGroupName="<first-resource-group-name>"
# Variable for empty resource group
targetResourceGroupName="<second-resource-group-name>"
# Variable for API for NoSQL endpoint URI
cosmosEndpoint="<cosmos-db-nosql-endpoint-uri>"
# Variable for API for NoSQL primary key
cosmosPrimaryKey="<cosmos-db-nosql-primary-key>"
# Variable for Azure Storage account name
storageAccountName="<storage-account-name>"
# Variable for storage account connection string
storageConnectionString="<storage-connection-string>"
使用該 az cosmosdb sql database create 指令，建立一個包含以下設定的新資料庫：
| 設定 |
Value |
|
資料庫識別碼 |
ycsb |
|
資料庫吞吐量類型 |
手動 |
|
資料庫吞吐量金額 |
400 |
az cosmosdb sql database create \
--resource-group $sourceResourceGroupName \
--account-name $cosmosAccountName \
--name "ycsb" \
--throughput 400
使用該 az cosmosdb sql container create 指令，建立一個新的容器，並設定如下：
| 設定 |
Value |
|
資料庫識別碼 |
ycsb |
|
容器識別碼 |
usertable |
|
分區鍵 |
/id |
az cosmosdb sql container create \
--resource-group $sourceResourceGroupName \
--account-name $cosmosAccountName \
--database-name "ycsb" \
--name "usertable" \
--partition-key-path "/id"
將效能測試框架部署到 Azure
現在，你使用 Azure Resource Manager 範本，將基準測試框架部署到 Azure，並使用預設讀取範本。
請使用此連結提供的 Azure 資源管理器範本來部署基準測試框架。
自訂部署頁面中的以下參數
選擇檢視 + 建立，然後選擇建立來部署範本。
等候部署完成。
使用 az deployment group create Azure Resource Manager 範本部署基準測試框架。
# Variable for raw template JSON on GitHub
templateUri="https://raw.githubusercontent.com/Azure/azure-db-benchmarking/main/cosmos/sql/tools/java/ycsb/recipes/read/try-it-read/azuredeploy.json"
az deployment group create \
--resource-group $targetResourceGroupName \
--name "benchmarking-framework" \
--template-uri $templateUri \
--parameters \
adminPassword='P@ssw.rd' \
resultsStorageConnectionString=$storageConnectionString \
cosmosURI=$cosmosEndpoint \
cosmosKey=$cosmosPrimaryKey
等候部署完成。
查看基準測試結果
現在，你可以使用現有的 Azure 儲存體 帳號來查詢基準作業的狀態並查看彙整結果。 狀態透過儲存資料表儲存，結果則以 CSV 格式彙整成儲存區塊。
在 Azure 入口網站中，進入你現有的 Azure 儲存帳號。
前往名為 ycsbbenchmarkingmetadata 的儲存表，找到具有分割鍵的 ycsb_sql實體。
觀察該資料表實體的JobStatus欄位。 一開始，工作狀態是 Started，且包含 JobStartTime 屬性的時間戳記，但不包含在 JobFinishTime 屬性中。
等到工作有Finished狀態，並在JobFinishTime屬性中包含時間戳。
在同一帳號內，請前往以 ycsbbenchmarking-* 為前綴的儲存容器。 觀察工具的輸出和診斷數據塊。
打開 aggregation.csv 塊，觀察內容。 你現在應該會有一個包含所有基準客戶結果彙整的 CSV 資料集。
Operation,Count,Throughput,Min(microsecond),Max(microsecond),Avg(microsecond),P9S(microsecond),P99(microsecond)
READ,180000,299,706,448255,1079,1159,2867
使用 ycsbbenchmarkingmetadata 查詢儲存表az storage entity query中的工作記錄。
az storage entity query \
--account-name $storageAccountName \
--connection-string $storageConnectionString \
--table-name ycsbbenchmarkingmetadata
請觀察此查詢的結果。 結果應回傳一個包含 JobStartTime、 JobStatus、 及 JobFinishTime 屬性的單一工作。 一開始，工作狀態是 Started，且包含 JobStartTime 屬性的時間戳記，但不包含在 JobFinishTime 屬性中。
{
"items": [
{
"JobFinishTime": "",
"JobStartTime": "2023-02-02T13:59:42Z",
"JobStatus": "Started",
"NoOfClientsCompleted": "0",
"NoOfClientsStarted": {
"edm_type": "Edm.Int64",
"value": 1
},
"PartitionKey": "ycsb_sql",
...
}
],
...
}
如有需要，請多次執行 az storage entity query，直到工作狀態為 Finished，且在 JobFinishTime 屬性中包含時間戳記。
{
"items": [
{
"JobFinishTime": "2023-02-02T14:21:12Z",
"JobStartTime": "2023-02-02T13:59:42Z",
"JobStatus": "Finished",
...
}
],
...
}
找到以 ycsbbenchmarking-* 作為前綴的最近修改儲存容器名稱，使用 az storage container list 和 JMESPath 查詢。
az storage container list \
--account-name $storageAccountName \
--connection-string $storageConnectionString \
--query "sort_by([?starts_with(name, 'ycsbbenchmarking-')], &properties.lastModified)[-1].name" \
--output tsv
將容器字串儲存在一個名為 storageConnectionString的變數中。
storageContainerName=$( \
az storage container list \
--account-name $storageAccountName \
--connection-string $storageConnectionString \
--query "sort_by([?starts_with(name, 'ycsbbenchmarking-')], &properties.lastModified)[-1].name" \
--output tsv \
)
使用 [az storage blob query]/cli/azure/storage/blob#az-storage-blob-query）來查詢儲存在先前容器中的作業結果。
az storage blob query \
--account-name $storageAccountName \
--connection-string $storageConnectionString \
--container-name $storageContainerName \
--name aggregation.csv \
--query-expression "SELECT * FROM BlobStorage"
請觀察此查詢的結果。 你現在應該會有一個包含所有基準客戶結果彙整的 CSV 資料集。
Operation,Count,Throughput,Min(microsecond),Max(microsecond),Avg(microsecond),P9S(microsecond),P99(microsecond)
READ,180000,299,706,448255,1079,1159,2867
食譜
Azure 資料庫的基準測試框架包含封裝工作負載定義的配方，這些定義會傳遞給底層的基準測試工具，實現「一鍵」體驗。 工作負載定義是根據 Azure Cosmos DB 團隊及基準測試工具團隊發布的最佳實務設計的。 這些食譜經過測試並驗證，效果一致。
你可以預期在 GitHub 倉庫中看到所有讀寫配方的延遲時間。
讀取延遲
寫入延遲
常見問題
本節包含執行基準測試工具時可能發生的常見錯誤。 該工具的錯誤日誌通常會存放在 Azure 儲存體 帳號內的容器中。
儲存帳號中容器和 blobs 的截圖。
如果儲存帳號中沒有日誌，這通常是因為儲存連接字串錯誤或缺失所致。 此錯誤會顯示在客戶端虛擬機的 /home/benchmarking 資料夾中的 agent.out 檔案中。
Error while accessing storage account, exiting from this machine in agent.out on the VM
如果 Azure Cosmos DB 端點的 URI 錯誤或無法存取，這個錯誤會在客戶端虛擬機和儲存帳號的 agent.out 檔案中列出。
Caused by: java.net.UnknownHostException: rtcosmosdbsss.documents.azure.com: Name or service not known
如果 Azure Cosmos 資料庫金鑰錯誤，這個錯誤會在 agent.out 檔案中顯示，無論是客戶端虛擬機還是儲存帳號。
The input authorization token can't serve the request. The wrong key is being used….
下一步
