Messen der Leistung von Azure Cosmos DB for NoSQL mit einem Benchmarking-Framework

Navigieren Sie im Azure-Portal zu Ihrem vorhandenen API für NoSQL-Konto.

Wählen Sie im Ressourcenmenü Data Explorer aus.

Wählen Sie auf der Seite Daten-Explorer in der Befehlsleiste die Option Neuer Container aus.

Erstellen Sie im Dialogfeld Neuer Container einen neuen Container mit den folgenden Einstellungen:

Wenn Sie das noch nicht getan haben, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an.

Erstellen Sie Shellvariablen für die folgenden Werte:

• Name Ihres vorhandenen Azure Cosmos DB for NoSQL-Kontos mit dem Namen cosmosAccountName.
• Name Ihrer ersten Ressourcengruppe mit Ressourcen mit dem Namen sourceResourceGroupName.
• Name Ihrer zweiten leeren Ressourcengruppe mit dem Namen targetResourceGroupName.
• Vorhandener Azure Cosmos DB for NoSQL-Kontoendpunkt-URI mit dem Namen cosmosEndpoint
• Vorhandener Primärschlüssel des Azure Cosmos DB for NoSQL-Kontos mit dem Namen 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>"

Erstellen Sie mit dem az cosmosdb sql database create-Befehl eine neue Datenbank mit den folgenden Einstellungen:

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

Erstellen Sie mit dem az cosmosdb sql container create-Befehl einen neuen Container mit den folgenden Einstellungen:

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

Stellen Sie das Benchmarking-Framework mithilfe einer Azure Resource Manager-Vorlage bereit, die unter dem folgenden Link verfügbar ist.

Passen Sie auf der Seite Benutzerdefinierte Bereitstellung die folgenden Parameter an:

Wählen Sie Überprüfen und erstellen und dann Erstellen aus, um die Vorlage bereitzustellen.

Warten Sie, bis die Bereitstellung abgeschlossen ist.

Verwenden Sie az deployment group create, um das Benchmarking-Framework mithilfe einer Azure Resource Manager-Vorlage bereitzustellen.

# 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

Warten Sie, bis die Bereitstellung abgeschlossen ist.

Navigieren Sie im Azure-Portal zu Ihrem bestehenden Azure Storage-Konto.

Navigieren Sie zu einer Speichertabelle mit dem Namen ycsbbenchmarkingmetadata und suchen Sie die Entität mit dem Partitionsschlüssel ycsb_sql.

Sehen Sie sich das Feld JobStatus der Tabelleninstanz genauer an. Zunächst ist der Status des Auftrags Started und die Zeile enthält einen Zeitstempel bei der Eigenschaft JobStartTime, aber nicht bei der Eigenschaft JobFinishTime.

Warten Sie, bis der Auftrag den Status Finished hat und einen Zeitstempel bei der Eigenschaft JobFinishTime erhält.

Navigieren Sie im gleichen Konto zum Speichercontainer mit dem Präfix ycsbbenchmarking-*. Sehen Sie sich die Ausgabe- und Diagnoseblobs für das Tool genauer an.

Öffnen Sie das Blob aggregation.csv und sehen Sie sich den Inhalt an. Sie sollten jetzt einen CSV-Datensatz mit aggregierten Ergebnissen von allen Benchmarkclients sehen.

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

Abfragen des Auftragsdatensatzes in einer Speichertabelle mit dem Namen ycsbbenchmarkingmetadata mit Hilfe von az storage entity query.

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

Sehen Sie sich die Ergebnisse dieser Abfrage an. Die Abfrage sollte einen einzelnen Auftrag mit den Eigenschaften JobStartTime, JobStatus, und JobFinishTime zurückgeben. Zunächst ist der Status des Auftrags Started und die Zeile enthält einen Zeitstempel bei der Eigenschaft JobStartTime, aber nicht bei der Eigenschaft JobFinishTime.

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

Führen Sie az storage entity query bei Bedarf mehrere Male aus, bis der Auftrag den Status Finished hat und bei Eigenschaft JobFinishTime ein Zeitstempel angezeigt wird.

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

Suchen Sie den Namen des zuletzt geänderten Speichercontainers mit dem Präfix ycsbbenchmarking-* mit Hilfe von az storage container list und einer JMESPath-Abfrage.

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

Speichern Sie die Containerzeichenfolge in einer Variablen mit dem Namen 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 \
)

Verwenden Sie [az storage blob query]/cli/azure/storage/blob#az-storage-blob-query), um die Auftragsergebnisse eines Speicherblobs abzufragen, das im zuvor ausgewählten Container gespeichert ist.

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

Sehen Sie sich die Ergebnisse dieser Abfrage an. Sie sollten jetzt einen CSV-Datensatz mit aggregierten Ergebnissen von allen Benchmarkclients sehen.

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