Mäta Azure Cosmos DB för NoSQL-prestanda med ett benchmarking-ramverk

Gå till ditt befintliga API för NoSQL-konto i Azure Portal.

I resursmenyn väljer du Datautforskaren.

På sidan Datautforskarenväljer du alternativet Ny container i kommandofältet.

I dialogrutan Ny container skapar du en ny container med följande inställningar:

Om du inte redan har gjort det loggar du in på Azure CLI med kommandot az login .

Skapa gränssnittsvariabler för följande värden:

• Namnet på ditt befintliga Azure Cosmos DB för NoSQL-konto med namnet cosmosAccountName.
• Namnet på din första resursgrupp med resurser med namnet sourceResourceGroupName.
• Namnet på den andra tomma resursgruppen med namnet targetResourceGroupName.
• Befintlig Azure Cosmos DB för NoSQL-kontoslutpunkts-URI med namnet cosmosEndpoint
• Befintlig primärnyckel för Azure Cosmos DB för NoSQL-konto med namnet 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>"

Skapa en ny databas med följande inställningar med hjälp av az cosmosdb sql database create kommandot:

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

Skapa en ny container med följande inställningar med hjälp av az cosmosdb sql container create kommandot:

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

Distribuera benchmarking-ramverket med hjälp av en Azure Resource Manager-mall som är tillgänglig på den här länken.

På sidan för Anpassad distribution är följande parametrar

Välj Granska + skapa och sedan Skapa för att använda mallen.

Vänta tills distributionen har slutförts.

Använd az deployment group create för att distribuera benchmarking-ramverket med hjälp av en Azure Resource Manager-mall.

# 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

Vänta tills distributionen har slutförts.

Gå till ditt befintliga Azure Storage-konto i Azure Portal.

Navigera till en lagringstabell med namnet ycsbbenchmarkingmetadata och leta upp entiteten med partitionsnyckeln ycsb_sql.

Observera fältet för JobStatus tabellentiteten. Inledningsvis är statusen för jobbet Started och den innehåller en tidsstämpel i egenskapen JobStartTime men inte i egenskapen JobFinishTime.

Vänta tills jobbet har statusen Finished och innehåller en tidsstämpel i egenskapen JobFinishTime .

Navigera till lagringscontainern i samma konto med prefixet ycsbbenchmarking-*. Observera utdata och diagnostikblobar för verktyget.

Öppna aggregation.csv blob och observera innehållet. Nu bör du ha en CSV-datauppsättning med aggregerade resultat från alla benchmark-klienter.

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

Fråga jobbposten i en lagringstabell med namnet ycsbbenchmarkingmetadata med .az storage entity query

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

Observera resultatet av den här frågan. Resultatet ska returnera ett enda jobb med JobStartTimeegenskaperna , JobStatusoch JobFinishTime . Inledningsvis är Started statusen för jobbet och den innehåller en tidsstämpel i JobStartTime egenskapen men inte egenskapen JobFinishTime .

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

Om det behövs, kör du az storage entity query flera gånger tills jobbet har en status av Finished och innehåller en tidsstämpel i egenskapen JobFinishTime.

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

Leta reda på namnet på den senast ändrade lagringscontainern med prefixet ycsbbenchmarking-* med hjälp av az storage container list och en JMESPath-fråga.

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

Lagra containersträngen i en variabel med namnet 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 \
)

Använd [az storage blob query]/cli/azure/storage/blob#az-storage-blob-query) för att köra frågor mot jobbresultaten i en lagringsblob som lagras i den tidigare placerade containern.

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

Observera resultatet av den här frågan. Nu bör du ha en CSV-datauppsättning med aggregerade resultat från alla benchmark-klienter.

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