GDAL-VECTOR-UPDATE(1)                GDAL                GDAL-VECTOR-UPDATE(1)

نام (NAME)
       gdal-vector-update - به‌روزرسانی یک مجموعه داده برداری موجود با یک
       مجموعه داده برداری ورودی

       در نسخه 3.13 اضافه شد.


خلاصه دستور (SYNOPSIS)

          نحوه استفاده: gdal vector update [OPTIONS] <INPUT> <OUTPUT>

          به‌روزرسانی یک مجموعه داده برداری موجود با یک مجموعه داده برداری ورودی.

          آرگومان‌های موضعی (Positional arguments):
            -i, --input <INPUT>                              مجموعه داده‌های برداری ورودی [الزامی] [در خطوط لوله در دسترس نیست]
            -o, --output <OUTPUT>                            مجموعه داده برداری خروجی [الزامی]

          گزینه‌های عمومی (Common Options):
            -h, --help                                       نمایش پیام راهنما و خروج
            --json-usage                                     نمایش نحوه استفاده به صورت سند JSON و خروج
            --config <KEY>=<VALUE>                           گزینه پیکربندی [تکرارپذیر]
            -q, --quiet                                      حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خطوط لوله در دسترس نیست]

          گزینه‌ها (Options):
            --input-layer <INPUT-LAYER>                      نام لایه ورودی
            --output-layer <OUTPUT-LAYER>                    نام لایه خروجی
            --mode <MODE>                                    تنظیم حالت به‌روزرسانی. MODE=merge|update-only|append-only (پیش‌فرض: merge)
            --key <KEY>                                      فیلد(هایی) که به عنوان کلید برای شناسایی عوارض استفاده می‌شوند [تکرارپذیر]

          گزینه‌های پیشرفته (Advanced Options):
            --if, --input-format <INPUT-FORMAT>              قالب‌های ورودی [تکرارپذیر] [در خطوط لوله در دسترس نیست]
            --oo, --open-option <KEY>=<VALUE>                گزینه‌های باز کردن [تکرارپذیر] [در خطوط لوله در دسترس نیست]
            --output-oo, --output-open-option <KEY>=<VALUE>  گزینه‌های باز کردن خروجی [تکرارپذیر]

توضیحات (DESCRIPTION)
       دستور gdal vector update می‌تواند برای به‌روزرسانی عوارض یک مجموعه داده
       برداری خروجی موجود با عوارض بردار ورودی استفاده شود. این دستور، عوارض
       منطبق بین ورودی و خروجی را به‌طور پیش‌فرض بر اساس شناسه عارضه (feature
       ID) آن‌ها، یا در صورت استفاده از --key بر اساس مقدار یک یا چند ستون که
       یک کلید را تشکیل می‌دهند، شناسایی می‌کند.

       در حالت پیش‌فرض merge (ادغام)، عوارض یافت‌شده در هر دو لایه به‌روزرسانی
       خواهند شد و عوارضی که فقط در لایه ورودی وجود دارند در لایه خروجی ایجاد
       می‌شوند.

       طرح‌واره‌های لایه‌های ورودی و خروجی نیازی به یکسان بودن ندارند (به جز
       ستون‌های مشخص‌شده توسط --key)، اما برای ستون‌های هندسه باید از یک سیستم
       مرجع مختصات (CRS) یکسان استفاده کنند، زیرا هیچ بازپرتوافکنی درجا
       (on-the-fly) انجام نمی‌شود. اگر ستونی در لایه ورودی وجود داشته باشد اما
       در لایه خروجی نباشد، ایجاد نخواهد شد؛ و اگر ستونی در لایه خروجی وجود
       داشته باشد و در لایه ورودی نباشد، محتوای آن به‌روزرسانی نخواهد شد.

       دستور gdal vector update می‌تواند به عنوان مرحله‌ای از یک خط لوله
       (pipeline) استفاده شود، به‌طوری که مجموعه داده ورودی خروجی مرحله قبلی
       باشد.

گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)

       --input-layer <INPUT-LAYER>
              نام لایه ورودی. در صورتی که مجموعه داده ورودی دارای چندین لایه
              باشد باید مشخص شود.

       --key <KEY>
              فیلد(هایی) که به عنوان کلید برای شناسایی عوارض استفاده می‌شوند.
              برای چندین فیلد، گزینه --key را چندین بار مشخص کنید.

       --mode merge|update-only|append-only
              نحوه انجام به‌روزرسانی‌ها را مشخص می‌کند. حالت پیش‌فرض merge است.

              هنگام استفاده از حالت پیش‌فرض merge، عوارض یافت‌شده در هر دو لایه
              به‌روزرسانی خواهند شد، و عوارضی که فقط در لایه ورودی وجود دارند
              در لایه خروجی ایجاد می‌شوند.

              هنگام استفاده از حالت update-only، عوارض یافت‌شده در هر دو لایه
              به‌روزرسانی خواهند شد، و عوارضی که فقط در لایه ورودی یافت شوند
              نادیده گرفته می‌شوند.

              هنگام استفاده از حالت append-only، عوارض یافت‌شده در هر دو لایه
              به‌روزرسانی نخواهند شد، و عوارضی که فقط در لایه ورودی یافت شوند
              در لایه خروجی ایجاد می‌شوند.

       --output-layer <OUTPUT-LAYER>
              نام لایه خروجی. در صورتی که مجموعه داده خروجی دارای چندین لایه
              باشد باید مشخص شود.

گزینه‌های استاندارد (STANDARD OPTIONS)

       --if, --input-format <format>
              نام قالب/راه‌انداز برای تلاش جهت باز کردن فایل(های) ورودی. عموماً
              نیازی به تعیین آن نیست، اما زمانی که تشخیص خودکار راه‌انداز در
              انتخاب راه‌انداز مناسب ناموفق باشد، می‌توان از آن برای صرف‌نظر از
              تشخیص خودکار استفاده کرد.  این گزینه می‌تواند چندین بار برای
              تعیین چندین راه‌انداز کاندید تکرار شود.  توجه داشته باشید که این
              گزینه راه‌اندازها را مجبور به باز کردن مجموعه داده نمی‌کند؛
              به‌ویژه، برخی از راه‌اندازها نیازمندی‌هایی برای پسوند فایل دارند.

              می‌تواند تکرار شود.

       --oo, --open-option <NAME>=<VALUE>
              گزینه باز کردن مجموعه داده (مختص قالب).

              می‌تواند تکرار شود.

       --output-open-option, --output-oo <NAME>=<VALUE>
              در نسخه 3.12 اضافه شد.


              گزینه باز کردن برای مجموعه داده خروجی (مختص قالب).

              می‌تواند تکرار شود.

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

مثال‌ها (EXAMPLES)
   مثال ۱: به‌روزرسانی out.gpkg موجود با محتوای in.gpkg، با استفاده از
       identifier به عنوان کلید.

          $ gdal vector update --key identifier in.gpkg out.gpkg

نویسنده (AUTHOR)
       Even Rouault <even.rouault@spatialys.com>

حق نشر (COPYRIGHT)
       1998-2026

                                August 18, 2026          GDAL-VECTOR-UPDATE(1)