GDAL-VSI-SOZIP(1) GDAL GDAL-VSI-SOZIP(1)

gdal-vsi-sozip - دستورهای مربوط به SOZIP (فایل ZIP بهینه‌سازی‌شده برای دسترسی تصادفی و جستجو)

افزوده‌شده در نسخه 3.11.

ابزار gdal vsi sozip می‌تواند برای موارد زیر استفاده شود:

  • ایجاد یک فایل SOZip (Seek-Optimized ZIP)
  • افزودن فایل‌ها به یک فایل ZIP/SOZip موجود
  • فهرست کردن محتویات یک فایل ZIP/SOZip
  • اعتبارسنجی یک فایل SOZip
  • تبدیل یک فایل Zip موجود به یک فایل بهینه‌سازی‌شده SOZip

Usage: gdal vsi sozip <SUBCOMMAND> [OPTIONS]
where <SUBCOMMAND> is one of:
  - create:   Create a Seek-optimized ZIP (SOZIP) file.
  - list:     List content of a ZIP file, with SOZIP related information.
  - optimize: Create a Seek-optimized ZIP (SOZIP) file from a regular ZIP file.
  - validate: Validate a ZIP file, possibly using SOZIP optimization.
Common Options:
  -h, --help              Display help message and exit
  --json-usage            Display usage as JSON document and exit
  --config <KEY>=<VALUE>  Configuration option [may be repeated]

یک یا چند فایل را به یک فایل zip جدید یا موجود اضافه می‌کند.

Usage: gdal vsi sozip create [OPTIONS] <INPUT> <OUTPUT>
Create a Seek-optimized ZIP (SOZIP) file.
Positional arguments:
  -i, --input <INPUT>                                          Input filenames [may be repeated] [required]
  -o, --output <OUTPUT>                                        Output ZIP filename [required]
Common Options:
  -h, --help                                                   Display help message and exit
  --json-usage                                                 Display usage as JSON document and exit
  --config <KEY>=<VALUE>                                       Configuration option [may be repeated]
  -q, --quiet                                                  Quiet mode (no progress bar or warning message) [not available in pipelines]
Options:
  --overwrite                                                  Whether overwriting existing output dataset is allowed
  -r, --recursive                                              Travels the directory structure of the specified directories recursively
  -j, --junk-paths, --no-paths                                 Store just the name of a saved file, and do not store directory names
  --enable-sozip <ENABLE-SOZIP>                                Whether to automatically/systematically/never apply the SOZIP optimization. ENABLE-SOZIP=auto|yes|no (default: auto)
  --sozip-chunk-size <value in bytes or with K/M suffix>       Chunk size for a seek-optimized file (default: 32768)
  --sozip-min-file-size <value in bytes or with K/M/G suffix>  Minimum file size to decide if a file should be seek-optimized (default: 1 MB)
  --content-type <CONTENT-TYPE>                                Store the Content-Type of the file being added.

نام فایل‌های ورودی. اجباری است. چندین نام فایل یا نام دایرکتوری پذیرفته می‌شود.
نام فایل ZIP خروجی. اجباری است. باید دارای پسوند .zip باشد.
آیا بازنویسی روی خروجی موجود مجاز است یا خیر.
ساختار دایرکتوری‌های مشخص‌شده را به صورت بازگشتی پیمایش می‌کند.
فقط نام فایل ذخیره‌شده را نگهداری می‌کند (مسیرها را نادیده می‌گیرد) و نام دایرکتوری‌ها را ذخیره نمی‌کند. به طور پیش‌فرض، sozip مسیر کامل (نسبت به دایرکتوری جاری) را ذخیره خواهد کرد.
در حالت auto، یک فایل فقط زمانی برای جستجو بهینه‌سازی (seek-optimized) می‌شود که اندازه آن بیشتر از مقدار --sozip-min-file-size باشد. در حالت yes، تمام فایل‌های ورودی برای جستجو بهینه‌سازی خواهند شد. در حالت no، هیچ‌کدام از فایل‌های ورودی برای جستجو بهینه‌سازی نخواهند شد.
اندازه تکه (Chunk size) برای یک فایل بهینه‌سازی‌شده برای جستجو. مقدار پیش‌فرض 32768 بایت است. مقدار بر حسب بایت مشخص می‌شود، یا می‌توان به ترتیب از پسوندهای K و M (به صورت اختیاری با یک فاصله قبل از آن) برای تعیین مقدار بر حسب کیلوبایت یا مگابایت استفاده کرد.
حداقل اندازه فایل برای تصمیم‌گیری درباره این که آیا یک فایل باید برای جستجو بهینه‌سازی شود یا خیر، در حالت --enable-sozip=auto. مقدار پیش‌فرض 1 مگابایت است. مقدار بر حسب بایت مشخص می‌شود، یا می‌توان به ترتیب از پسوندهای K، M یا G (به صورت اختیاری با یک فاصله قبل از آن) برای تعیین مقدار بر حسب کیلوبایت، مگابایت یا گیگابایت استفاده کرد.
نوع محتوا (Content-Type) فایل در حال افزودن را به عنوان یک جفت کلید-مقدار در پسوند فیلد اضافی 'KV' (0x564b) که به ذخیره فراداده‌های کلید-مقدار اختصاص دارد، ذخیره می‌کند.
هیچ پیام اطلاع‌رسانی چاپ نشود (تنها خطاها چاپ می‌شوند).

گزینه پیکربندی GDAL_NUM_THREADS می‌تواند روی ALL_CPUS یا یک مقدار عددی صحیح تنظیم شود تا تعداد ریسمان‌های مورد استفاده برای فایل‌های فشرده‌شده با SOZip را مشخص کند. پیش‌فرض ALL_CPUS است.

gdal vsi sozip create my.gpkg my.gpkg.zip

gdal vsi sozip create -r source_dir/ my.gpkg.zip

ایجاد یک فایل zip جدید از محتوای یک فایل موجود، و در صورت لزوم اعمال بهینه‌سازی SOZip.

Usage: gdal vsi sozip optimize [OPTIONS] <INPUT> <OUTPUT>
Create a Seek-optimized ZIP (SOZIP) file from a regular ZIP file.
Positional arguments:
  -i, --input <INPUT>                                          Input ZIP filename [required]
  -o, --output <OUTPUT>                                        Output ZIP filename [required]
Common Options:
  -h, --help                                                   Display help message and exit
  --json-usage                                                 Display usage as JSON document and exit
  --config <KEY>=<VALUE>                                       Configuration option [may be repeated]
  -q, --quiet                                                  Quiet mode (no progress bar or warning message) [not available in pipelines]
Options:
  --overwrite                                                  Whether overwriting existing output dataset is allowed
  --enable-sozip <ENABLE-SOZIP>                                Whether to automatically/systematically/never apply the SOZIP optimization. ENABLE-SOZIP=auto|yes|no (default: auto)
  --sozip-chunk-size <value in bytes or with K/M suffix>       Chunk size for a seek-optimized file (default: 32768)
  --sozip-min-file-size <value in bytes or with K/M/G suffix>  Minimum file size to decide if a file should be seek-optimized (default: 1 MB)

نام فایل ZIP ورودی. اجباری است.
نام فایل ZIP خروجی. اجباری است. باید دارای پسوند .zip باشد.
آیا بازنویسی روی خروجی موجود مجاز است یا خیر.
در حالت auto، یک فایل فقط در صورتی برای جستجو بهینه‌سازی (seek-optimized) می‌شود که اندازه آن بالاتر از مقدار --sozip-chunk-size باشد. در حالت yes، تمام فایل‌های ورودی برای جستجو بهینه‌سازی خواهند شد. در حالت no، هیچ‌کدام از فایل‌های ورودی برای جستجو بهینه‌سازی نخواهند شد.
اندازه تکه (Chunk size) برای یک فایل بهینه‌سازی‌شده برای جستجو. مقدار پیش‌فرض 32768 بایت است. مقدار بر حسب بایت مشخص می‌شود، یا می‌توان به ترتیب از پسوندهای K و M برای تعیین مقدار بر حسب کیلوبایت یا مگابایت استفاده کرد.
حداقل اندازه فایل برای تصمیم‌گیری درباره این که آیا یک فایل باید برای جستجو بهینه‌سازی شود یا خیر، در حالت --enable-sozip=auto. مقدار پیش‌فرض 1 مگابایت است. مقدار بر حسب بایت مشخص می‌شود، یا می‌توان به ترتیب از پسوندهای K، M یا G برای تعیین مقدار بر حسب کیلوبایت، مگابایت یا گیگابایت استفاده کرد.
هیچ پیام اطلاع‌رسانی چاپ نشود (تنها خطاها چاپ می‌شوند).

گزینه پیکربندی GDAL_NUM_THREADS می‌تواند روی ALL_CPUS یا یک مقدار عددی صحیح تنظیم شود تا تعداد ریسمان‌های مورد استفاده برای فایل‌های فشرده‌شده با SOZip را مشخص کند. پیش‌فرض ALL_CPUS است.

gdal vsi sozip optimize in.zip sozip_optimized.zip

فهرست کردن فایل‌های موجود در فایل zip با خروجی‌ای مشابه با ابزار Info-ZIP unzip، همراه با افزودن یک ستون که نشان می‌دهد آیا هر فایل برای جستجو بهینه‌سازی شده است یا خیر.

Usage: gdal vsi sozip list [OPTIONS] <INPUT>
List content of a ZIP file, with SOZIP related information.
Positional arguments:
  -i, --input <INPUT>     Input ZIP filename [required]
Common Options:
  -h, --help              Display help message and exit
  --json-usage            Display usage as JSON document and exit
  --config <KEY>=<VALUE>  Configuration option [may be repeated]

نام فایل ZIP ورودی. اجباری است.

gdal vsi sozip list my.zip

یک فایل SOZip را اعتبارسنجی می‌کند. اعتبارسنجی پایه ZIP به شکل سبک انجام می‌شود، و محدود به پیمایش رکوردهای ZIP با استفاده از خواننده ZIP مبتنی بر InfoZIP است که در GDAL استفاده می‌شود. اما اعتبارسنجی جنبه‌های اختصاصی SOZip به طور دقیق‌تر و کامل‌تری انجام می‌گیرد.

Usage: gdal vsi sozip list [OPTIONS] <INPUT>
List content of a ZIP file, with SOZIP related information.
Positional arguments:
  -i, --input <INPUT>     Input ZIP filename [required]
Common Options:
  -h, --help              Display help message and exit
  --json-usage            Display usage as JSON document and exit
  --config <KEY>=<VALUE>  Configuration option [may be repeated]

نام فایل ZIP ورودی. اجباری است.
هیچ پیام اطلاع‌رسانی چاپ نشود (تنها خطاها چاپ می‌شوند).
فعال‌سازی حالت پرگویی (verbose).

این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، به عنوان اجرای موفق در نظر گرفته می‌شوند).

gdal vsi sozip validate my.zip

Even Rouault <even.rouault@spatialys.com>

1998-2026

August 18, 2026