Mengukur Azure Cosmos DB untuk performa NoSQL dengan kerangka kerja tolok ukur

Buka API yang ada untuk akun NoSQL di portal Azure.

Di menu sumber daya, pilih Data Explorer.

Pada halaman Data Explorer , pilih opsi Kontainer Baru di bilah perintah.

Dalam dialog Kontainer Baru, buat kontainer baru dengan pengaturan berikut:

Jika Anda belum melakukannya, masuk ke Azure CLI menggunakan perintah az login.

Buat variabel shell untuk nilai berikut:

• Nama akun Azure Cosmos DB for NoSQL anda yang sudah ada bernama cosmosAccountName.
• Nama grup sumber daya pertama Anda dengan sumber daya bernama sourceResourceGroupName.
• Nama grup sumber daya kosong kedua Anda bernama targetResourceGroupName.
• Azure Cosmos DB yang ada untuk URI titik akhir akun NoSQL bernama cosmosEndpoint
• Kunci primer akun Azure Cosmos DB for NoSQL yang sudah ada bernama 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 Menggunakan perintah , buat database baru dengan pengaturan berikut:

az cosmosdb sql database create \
    --resource-group $sourceResourceGroupName \
    --account-name $cosmosAccountName \
    --name "ycsb" \
    --throughput 400

az cosmosdb sql container create Menggunakan perintah , buat kontainer baru dengan pengaturan berikut:

az cosmosdb sql container create \
    --resource-group $sourceResourceGroupName \
    --account-name $cosmosAccountName \
    --database-name "ycsb" \
    --name "usertable" \
    --partition-key-path "/id"

Sebarkan kerangka kerja tolok ukur menggunakan templat Azure Resource Manager yang tersedia di tautan ini.

Pada halaman Penyebaran Kustom, parameter berikut

Pilih Tinjau + buat lalu Buat untuk menyebarkan templat.

Tunggu hingga penerapan selesai.

Gunakan az deployment group create untuk menyebarkan kerangka kerja tolok ukur menggunakan templat 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

Tunggu hingga penerapan selesai.

Navigasikan ke akun Azure Storage Anda yang sudah ada di portal Azure.

Navigasi ke tabel penyimpanan bernama ycsbbenchmarkingmetadata dan temukan entitas dengan kunci partisi .ycsb_sql

Amati JobStatus bidang entitas tabel. Awalnya, status pekerjaan adalah Started dan menyertakan tanda waktu di JobStartTime properti tetapi bukan JobFinishTime properti .

Tunggu hingga pekerjaan memiliki status Finished dan menyertakan tanda waktu di JobFinishTime properti.

Navigasikan ke kontainer penyimpanan di akun yang sama dengan awalan ycsbbenchmarking-*. Amati output dan blob diagnostik untuk alat ini.

Buka blob aggregation.csv dan amati kontennya. Anda sekarang harus memiliki himpunan data CSV dengan hasil agregat dari semua klien tolok ukur.

Operation,Count,Throughput,Min(microsecond),Max(microsecond),Avg(microsecond),P9S(microsecond),P99(microsecond)
READ,180000,299,706,448255,1079,1159,2867

Kueri rekaman pekerjaan dalam tabel penyimpanan bernama ycsbbenchmarkingmetadata menggunakan az storage entity query.

az storage entity query \
    --account-name $storageAccountName \
    --connection-string $storageConnectionString \
    --table-name ycsbbenchmarkingmetadata

Amati hasil kueri ini. Hasilnya harus mengembalikan satu pekerjaan dengan JobStartTimeproperti , , JobStatusdan JobFinishTime . Awalnya, status pekerjaan adalah Started dan menyertakan tanda waktu di JobStartTime properti tetapi bukan JobFinishTime properti .

{
  "items": [
    {
      "JobFinishTime": "",
      "JobStartTime": "2023-02-02T13:59:42Z",
      "JobStatus": "Started",
      "NoOfClientsCompleted": "0",
      "NoOfClientsStarted": {
        "edm_type": "Edm.Int64",
        "value": 1
      },
      "PartitionKey": "ycsb_sql",
      ...
    }
  ],
  ...
}

Jika perlu, jalankan az storage entity query beberapa kali hingga pekerjaan memiliki status Finished dan menyertakan tanda waktu dalam JobFinishTime properti.

{
  "items": [
    {
      "JobFinishTime": "2023-02-02T14:21:12Z",
      "JobStartTime": "2023-02-02T13:59:42Z",
      "JobStatus": "Finished",
      ...
    }
  ],
  ...
}

Temukan nama kontainer penyimpanan yang terakhir dimodifikasi dengan awalan ycsbbenchmarking-* penggunaan az storage container list dan kueri JMESPath.

az storage container list \
    --account-name $storageAccountName \
    --connection-string $storageConnectionString \
    --query "sort_by([?starts_with(name, 'ycsbbenchmarking-')], &properties.lastModified)[-1].name" \
    --output tsv

Simpan string kontainer dalam variabel bernama 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 \
)

Gunakan [az storage blob query]/cli/azure/storage/blob#az-storage-blob-query) untuk mengkueri hasil pekerjaan dalam blob penyimpanan yang disimpan dalam kontainer yang terletak sebelumnya.

az storage blob query \
    --account-name $storageAccountName \
    --connection-string $storageConnectionString \
    --container-name $storageContainerName \
    --name aggregation.csv \
    --query-expression "SELECT * FROM BlobStorage"

Amati hasil kueri ini. Anda sekarang harus memiliki himpunan data CSV dengan hasil agregat dari semua klien tolok ukur.

Operation,Count,Throughput,Min(microsecond),Max(microsecond),Avg(microsecond),P9S(microsecond),P99(microsecond)
READ,180000,299,706,448255,1079,1159,2867