azcopy 工作台

藉由上傳或下載測試數據到指定目的地或從指定目的地執行效能效能評定。 針對上傳,系統會自動產生測試數據。

效能評定命令會執行與 'copy' 相同的程式,不同之處在於:

  • 基準檢驗不需要同時要求來源和目的地參數,而只需要一個。 這是您想要上傳或下載的 Blob 容器、Azure 檔案儲存體 Share 或 Azure Data Lake 儲存體 Gen2 文件系統。

  • 'mode' 參數描述 AzCopy 是否應該測試上傳至指定目標或從指定目標下載。 有效值 ar'e 'Upload' 和 'Download'。 默認值為 『Upload』。

  • 對於上傳效能評定,承載是由命令行參數所描述,可控制自動產生多少個檔案,以及檔案的大小。 產生程式會完全在記憶體中發生。 未使用磁碟。

  • 針對下載,承載包含來源上已經存在的檔案。 (請參閱下列範例,以瞭解如何視需要產生測試檔案)。

  • 僅支援複製命令可用的少數選擇性參數。

  • 會測量並報告其他診斷。

  • 針對上傳,預設行為是刪除測試回合結束時傳輸的數據。 針對下載,數據永遠不會實際儲存在本機。

基準檢驗模式會自動調整自己,以達到最大輸送量的平行 TCP 連線數目。 它會在結尾顯示該數位。 若要防止自動調整,請將COPY_CONCURRENCY_VALUE環境變數設定為特定數目的連線。

支援所有一般驗證類型。 不過,效能評定上傳最方便的方法通常是使用 SAS 令牌建立空的容器,並使用 SAS 驗證。 (下載模式需要一組測試數據出現在目標容器中。

azcopy bench [destination] [flags]

範例

使用預設參數執行上傳基準檢驗(適用於對最多 1 Gbps 的網路進行效能評定):

azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>"

執行可上傳 100 個檔案的基準檢驗,每個大小為 2 GiB:(適用於快速網路上的基準檢驗,例如 10 Gbps):'

azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --size-per-file 2G

與上述相同,但使用 50,000 個檔案,每個 8 MiB 的大小和計算其 MD5 哈希(就像 --put-md5 旗標在複製命令中執行此動作一樣)。 基準檢驗時 --put-md5 的目的是測試 MD5 計算是否會影響所選檔案計數和大小的輸送量:

azcopy bench --mode='Upload' "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 50000 --size-per-file 8M --put-md5

執行從目標下載現有檔案的基準檢驗

azcopy bench --mode='Download' "https://[account].blob.core.windows.net/[container]?<SAS?"

執行不會刪除已傳輸檔案的上傳。 (這些檔案接著可作為下載測試的承載)

azcopy bench "https://[account].blob.core.windows.net/[container]?<SAS>" --file-count 100 --delete-test-data=false

選項。

--blob-type string 定義目的地的 Blob 類型。 用來允許對不同的 Blob 類型進行基準檢驗。 與複製命令中同名參數相同 (預設為 “Detect”)

--block-size-mb float 使用此區塊大小(在MiB中指定)。 預設值會根據檔案大小自動計算。 允許小數點數 - 例如 0.25。 與 copy 命令中的同名參數相同

--check-length 在傳輸之後檢查目的地上的檔案長度。 如果來源和目的地之間不符,傳輸會標示為失敗。 (預設值 true)

--delete-test-data 如果為 true,基準檢驗數據將會在基準檢驗執行結束時刪除。 如果您想要將資料保留在目的地,請將它設定為 false - 例如,將它用於基準檢驗模式外的手動測試 (預設值 true)

--file-count (uint) 要使用的自動產生資料檔案數目 (預設值 100)

-h--help 替補席的說明

--log-level (string) 定義記錄檔的記錄詳細資訊、可用的層級:INFO(所有要求/回應)、WARNING(慢速回應)、ERROR(僅失敗的要求),以及 NONE(沒有輸出記錄)。 (預設“INFO”)

--mode (字串)定義 Azcopy 是否應該測試此目標的上傳或下載。 有效值為 'upload' 和 'download'。 默認選項為 『upload』。 (預設 “upload”)

--number-of-folders (uint)如果大於 0,請建立資料夾來分割數據。

--put-blob-size-mb使用此大小(以MiB指定)作為臨界值,以判斷上傳至 Azure 儲存體時,是否要將 Blob 上傳為單一 PUT 要求。 預設值會根據檔案大小自動計算。 允許小數點 (例如:0.25)。

--put-md5 建立每個檔案的 MD5 哈希,並將哈希儲存為目的地 Blob/檔案的 Content-MD5 屬性。 (根據預設,不會建立哈希。)與 copy 命令中的同名參數相同

--size-per-file (字串)每個自動產生的數據檔案大小。 必須是緊接 K、M 或 G. 的數位,例如 12k 或 200G(預設值 “250M”)

繼承自父命令的選項

--cap-mbps (float)以每秒 MB 為單位來限制傳輸速率。 暫時輸送量可能會與上限稍有不同。 如果此選項設定為零,或省略此選項,則不會限制輸送量。

--output-type (字串)命令輸出的格式。 選項包括:text、json。 預設值為 『text』。 (預設 “text”)

--trusted-microsoft-suffixes (字串)指定可以傳送 Microsoft Entra 登入令牌的其他網域後綴。 預設值為 『.core.windows.net;。core.chinacloudapi.cn;。core.cloudapi.de;。core.usgovcloudapi.net;*.storage.azure.net'。 此處所列的任何專案會新增至預設值。 基於安全性,您應該只在這裡放置 Microsoft Azure 網域。 使用分號分隔多個專案。

另請參閱