warp zip

Test ZIP archive access performance using theMinIO s3zip extension for direct file retrieval.

warp zip [FLAGS]

warp zip --host myaistor.example.com:9000 --access-key ACCESS_KEY --secret-key SECRET_KEY

Default: 10000

Number of files to include in the ZIP archive. The command creates ZIP archives containing this many files. Use this flag to test ZIP access performance with different file counts.

Example:

warp zip --host myaistor.example.com:9000 --files 50000 --access-key YOUR_ACCESS_KEY --secret-key YOUR_SECRET_KEY

Default: 10KiB

Size of each file inside the ZIP archive. The file size affects ZIP creation time and access performance. Use this flag to test ZIP behavior with different file sizes.

Valid formats include numbers or values with KiB, MiB, or GiB suffixes (base 2 binary).

Example:

warp zip --host myaistor.example.com:9000 --obj.size 100KiB --access-key YOUR_ACCESS_KEY --secret-key YOUR_SECRET_KEY

This command supports all common flags including connection, performance, object, upload, benchmark control, analysis, and monitoring flags.

The ZIP benchmark tests MinIO s3zip extension performance for direct archive file access.

During the ZIP creation phase, the command generates a ZIP archive containing multiple files. The ZIP file includes the configured number of files with the specified size. The command creates the ZIP archive dynamically and uploads it to the target bucket. Each file within the archive receives a unique name for identification.

During the access phase, the command uses MinIO s3zip extension to retrieve individual files from the archive. The s3zip extension allows direct file access without downloading or extracting the entire archive. The benchmark randomly selects files from the archive for each access operation. File retrieval occurs server-side with the storage system reading specific archive entries.

The command measures file access throughput, retrieval rates, and latency. ZIP access performance tests efficient selective extraction from large archives. The s3zip extension provides performance benefits over downloading complete archives.

The ZIP benchmark provides metrics for archive file access operations.

The output includes file access rate showing files retrieved per second from ZIP archives. Individual file extraction throughput displays data transfer rates for selected files. Latency percentiles show response times at p50, p90, p99, and p99.9 levels for file access operations.

The benchmark reports archive navigation performance showing efficiency of locating files within archives. Error rates display counts and percentages of failed file access operations. Total file accesses show how many individual files were retrieved during the test.

Selective extraction metrics reveal performance advantages of accessing specific files versus full archive downloads. Archive size and file count statistics show scale characteristics of tested ZIP files.

Test ZIP archive file access with default settings:

warp zip --host myaistor.example.com:9000 --access-key ACCESS_KEY --secret-key SECRET_KEY

The command creates a ZIP archive with 10,000 files of 10KiB each and accesses files within it.

Test ZIP access with many files in the archive:

warp zip --host myaistor.example.com:9000 --files 100000 --obj.size 50KiB --access-key YOUR_ACCESS_KEY --secret-key YOUR_SECRET_KEY

Large archives test navigation and access performance with many entries.

Test ZIP archives containing fewer but larger files:

warp zip --host myaistor.example.com:9000 --files 1000 --obj.size 1MiB --access-key YOUR_ACCESS_KEY --secret-key YOUR_SECRET_KEY

This tests file extraction performance for larger individual files.

Test archives with many small files:

warp zip --host myaistor.example.com:9000 --files 50000 --obj.size 1KiB --access-key YOUR_ACCESS_KEY --secret-key YOUR_SECRET_KEY

Many small files test archive navigation overhead and metadata access.

Test concurrent file access from ZIP archives:

warp zip --host myaistor.example.com:9000 --concurrent 50 --files 20000 --access-key YOUR_ACCESS_KEY --secret-key YOUR_SECRET_KEY

This tests how the system handles many simultaneous selective extraction requests.

Test with moderate file count and sizes:

warp zip --host myaistor.example.com:9000 --files 5000 --obj.size 100KiB --access-key YOUR_ACCESS_KEY --secret-key YOUR_SECRET_KEY

Medium archives represent typical application scenarios for ZIP access.