نام (NAME)

gdal-vector-write - نوشتن یک مجموعه داده برداری (فقط در خط لوله)

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

توضیحات (DESCRIPTION)

عملیات write فقط برای استفاده در یک gdal pipeline است، و یک مجموعه داده برداری را می‌نویسد. این آخرین مرحله از یک خط لوله است.

برای نوشتن یک مجموعه داده موقت در میانه یک خط لوله، از gdal vector materialize استفاده کنید.

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

* write [گزینه‌ها] <OUTPUT>
--------------------------
نوشتن یک مجموعه داده برداری.
آرگومان‌های موضعی:
  -o, --output <OUTPUT>                                مجموعه داده برداری خروجی [الزامی]
گزینه‌ها:
  -f, --of, --format, --output-format <OUTPUT-FORMAT>  قالب خروجی (مقدار "GDALG" مجاز است)
  --co, --creation-option <KEY>=<VALUE>                گزینه ایجاد [تکرارپذیر]
  --lco, --layer-creation-option <KEY>=<VALUE>         گزینه ایجاد لایه [تکرارپذیر]
  --overwrite                                          آیا رونویسی روی مجموعه داده خروجی موجود مجاز است
  --update                                             آیا مجموعه داده موجود در حالت به‌روزرسانی باز شود
  --overwrite-layer                                    آیا رونویسی روی لایه خروجی موجود مجاز است
  --append                                             آیا افزودن به لایه موجود مجاز است
                                                       ناسازگار با --upsert
  -l, --output-layer <OUTPUT-LAYER>                    نام لایه خروجی
  --skip-errors                                        نادیده گرفتن خطاها هنگام نوشتن عوارض
  --no-create-empty-layers                             جلوگیری از ایجاد لایه‌هایی که هیچ عارضه‌ای در آن‌ها نوشته نخواهد شد
گزینه‌های پیشرفته:
  --output-oo, --output-open-option <KEY>=<VALUE>      گزینه‌های باز کردن خروجی [تکرارپذیر]
  --upsert                                             درج یا به‌روزرسانی (Upsert) عوارض (به معنای الحاق است)
                                                       ناسازگار با --append

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

-f, --of, --format, --output-format <OUTPUT-FORMAT>: تعیین قالب برداری خروجی مورد استفاده. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: gdal --formats | grep vector | grep rw | sort

--co, --creation-option <NAME>=<VALUE>

بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد مجموعه داده دارند که می‌توان از آن‌ها برای کنترل ویژگی‌های خاص فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoPackage از گزینه‌های ایجاد برای کنترل نسخه پشتیبانی می‌کند.

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

گزینه‌های ایجاد مجموعه داده موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده هیچ گزینه ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات مربوط به همان قالب مرجع قطعی اطلاعات درباره گزینه‌های ایجاد درایور است. برای گزینه‌های مجاز ایجاد هر قالب، به مستندات اختصاصی قالب در Vector drivers مراجعه کنید.

توجه داشته باشید که گزینه‌های ایجاد مجموعه داده با گزینه‌های ایجاد لایه تفاوت دارند.

--lco, --layer-creation-option <NAME>=<VALUE>

بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد لایه دارند که می‌توان از آن‌ها برای کنترل ویژگی‌های خاص لایه ایجادشده استفاده کرد. برای نمونه، درایور GeoPackage از گزینه‌های ایجاد لایه برای کنترل شناسه عارضه یا نام ستون هندسه، تنظیم شناسه یا توضیحات و غیره پشتیبانی می‌کند.

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

گزینه‌های ایجاد لایه موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده هیچ گزینه ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات مربوط به همان قالب مرجع قطعی اطلاعات درباره گزینه‌های ایجاد درایور است. برای گزینه‌های مجاز ایجاد هر قالب، به مستندات اختصاصی قالب در Vector drivers مراجعه کنید.

توجه داشته باشید که گزینه‌های ایجاد لایه با گزینه‌های ایجاد مجموعه داده تفاوت دارند.

--overwrite: اجازه دادن به برنامه برای رونویسی روی فایل یا مجموعه داده هدف موجود. در غیر این صورت، به طور پیش‌فرض، اگر فایل یا مجموعه داده هدف از قبل وجود داشته باشد، gdal با خطا متوقف می‌شود.

--update: تعیین اینکه آیا یک مجموعه داده خروجی موجود در حالت به‌روزرسانی باز شود یا خیر.

--overwrite-layer: تعیین اینکه آیا رونویسی روی لایه برداری خروجی موجود مجاز است یا خیر.

--append: تعیین اینکه آیا الحاق عوارض به لایه(های) موجود مجاز است یا خیر. این گزینه همچنین در صورتی که مجموعه داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند.

--output-layer <NAME>: نام لایه‌ای را مشخص می‌کند که عوارض در آن نوشته خواهند شد. اگر مشخص نشود، نام لایه‌های خروجی همانند نام لایه‌های ورودی خواهد بود.

--output-open-option, --output-oo <NAME>=<VALUE>

افزوده‌شده در نگارش 3.12.

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

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

--skip-errors: افزوده‌شده در نگارش 3.12.
تعیین اینکه آیا خطاهای ناشی از عدم موفقیت در نوشتن عارضه(ها) نادیده گرفته شوند یا خیر. توجه داشته باشید که این گزینه اندازه واحد تراکنش را به یک عارضه در هر زمان تنظیم می‌کند، که ممکن است هنگام درج در پایگاه‌های داده باعث کاهش شدید سرعت شود.

--upsert

افزوده‌شده در نگارش 3.12.

گونه‌ای از --append که در آن به جای الحاق با OGRLayer::CreateFeature()، از عملیات OGRLayer::UpsertFeature() برای درج یا به‌روزرسانی عوارض استفاده می‌شود.

این قابلیت در حال حاضر تنها در چند درایور پیاده‌سازی شده است: GPKG -- GeoPackage vector، Elasticsearch: Geographically Encoded Objects for Elasticsearch و MongoDBv3 (درایورهایی که upsert را پیاده‌سازی می‌کنند قابلیت GDAL_DCAP_UPSERT را نمایش می‌دهند).

عملیات upsert در صورت تنظیم بودن FID عارضه ورودی (و خالی نبودن نام ستون FID)، از آن به عنوان کلید برای به‌روزرسانی عوارض موجود استفاده می‌کند. بسیار حیاتی است که اطمینان حاصل شود FID در لایه‌های مبدأ و مقصد سازگار است.

برای درایور GPKG، همچنین امکان upsert عوارضی که FID آن‌ها تنظیم نشده یا فاقد اهمیت است وجود دارد (گزینه --unset-fid از gdal vector edit می‌تواند برای نادیده گرفتن FID از عارضه مبدأ استفاده شود)، در صورتی که یک ستون UNIQUE وجود داشته باشد که کلید اصلی عددی صحیح نباشد.

مثال‌ها (EXAMPLES)

مثال ۱: نوشتن یک فایل GeoPackage

$ gdal vector pipeline ... [other commands here] ... ! write out.gpkg --overwrite

نویسنده (AUTHOR)

Even Rouault <even.rouault@spatialys.com>

حق نشر (COPYRIGHT)

1998-2026

August 18, 2026