.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GDAL-VECTOR-WRITE" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-vector-write \- نوشتن یک مجموعه داده برداری (فقط در خط لوله)
.sp
افزوده‌شده در نگارش 3.11.

.SH "توضیحات (DESCRIPTION)"
.sp
عملیات \fBwrite\fP فقط برای استفاده در یک \fI\%gdal pipeline\fP است، و یک مجموعه داده برداری را می‌نویسد. این آخرین مرحله از یک خط لوله است.
.sp
برای نوشتن یک مجموعه داده موقت در میانه یک خط لوله، از \fI\%gdal vector materialize\fP استفاده کنید.
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
* write [گزینه‌ها] <OUTPUT>
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-

نوشتن یک مجموعه داده برداری.

آرگومان‌های موضعی:
  \-o, \-\-output <OUTPUT>                                مجموعه داده برداری خروجی [الزامی]

گزینه‌ها:
  \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>  قالب خروجی (مقدار \(dqGDALG\(dq مجاز است)
  \-\-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
.EE
.UNINDENT
.UNINDENT
.SH "گزینه‌های استاندارد (STANDARD OPTIONS)"
.INDENT 0.0
.TP
.B \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>
تعیین قالب برداری خروجی مورد استفاده. مقادیر مجاز را می‌توان با دستور زیر به دست آورد:
\fBgdal \-\-formats | grep vector | grep rw | sort\fP
.UNINDENT
.INDENT 0.0
.TP
.B \-\-co, \-\-creation\-option <NAME>=<VALUE>
بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد مجموعه داده دارند که می‌توان از آن‌ها برای کنترل ویژگی‌های خاص فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoPackage از گزینه‌های ایجاد برای کنترل نسخه پشتیبانی می‌کند.
.sp
می‌تواند تکرار شود.
.sp
گزینه‌های ایجاد مجموعه داده موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده هیچ گزینه ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان
\fI\%\-\-formats\fP
مشاهده کرد، اما مستندات مربوط به همان قالب مرجع قطعی اطلاعات درباره گزینه‌های ایجاد درایور است. برای گزینه‌های مجاز ایجاد هر قالب، به مستندات اختصاصی قالب در \fI\%Vector drivers\fP مراجعه کنید.
.sp
توجه داشته باشید که گزینه‌های ایجاد مجموعه داده با گزینه‌های ایجاد لایه تفاوت دارند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-lco, \-\-layer\-creation\-option <NAME>=<VALUE>
بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد لایه دارند که می‌توان از آن‌ها برای کنترل ویژگی‌های خاص لایه ایجادشده استفاده کرد. برای نمونه، درایور GeoPackage از گزینه‌های ایجاد لایه برای کنترل شناسه عارضه یا نام ستون هندسه، تنظیم شناسه یا توضیحات و غیره پشتیبانی می‌کند.
.sp
می‌تواند تکرار شود.
.sp
گزینه‌های ایجاد لایه موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده هیچ گزینه ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان
\fI\%\-\-formats\fP
مشاهده کرد، اما مستندات مربوط به همان قالب مرجع قطعی اطلاعات درباره گزینه‌های ایجاد درایور است. برای گزینه‌های مجاز ایجاد هر قالب، به مستندات اختصاصی قالب در \fI\%Vector drivers\fP مراجعه کنید.
.sp
توجه داشته باشید که گزینه‌های ایجاد لایه با گزینه‌های ایجاد مجموعه داده تفاوت دارند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite
اجازه دادن به برنامه برای رونویسی روی فایل یا مجموعه داده هدف موجود.
در غیر این صورت، به طور پیش‌فرض، اگر فایل یا مجموعه داده هدف از قبل وجود داشته باشد، \fBgdal\fP با خطا متوقف می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-update
تعیین اینکه آیا یک مجموعه داده خروجی موجود در حالت به‌روزرسانی باز شود یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite\-layer
تعیین اینکه آیا رونویسی روی لایه برداری خروجی موجود مجاز است یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-append
تعیین اینکه آیا الحاق عوارض به لایه(های) موجود مجاز است یا خیر.
این گزینه همچنین در صورتی که مجموعه داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-output\-layer <NAME>
نام لایه‌ای را مشخص می‌کند که عوارض در آن نوشته خواهند شد. اگر مشخص نشود، نام لایه‌های خروجی همانند نام لایه‌های ورودی خواهد بود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-output\-open\-option, \-\-output\-oo <NAME>=<VALUE>
افزوده‌شده در نگارش 3.12.
.sp
گزینه باز کردن مجموعه داده برای مجموعه داده خروجی (مختص هر قالب).
.sp
می‌تواند تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-skip\-errors
افزوده‌شده در نگارش 3.12.
.sp
تعیین اینکه آیا خطاهای ناشی از عدم موفقیت در نوشتن عارضه(ها) نادیده گرفته شوند یا خیر. توجه داشته باشید که این گزینه اندازه واحد تراکنش را به یک عارضه در هر زمان تنظیم می‌کند، که ممکن است هنگام درج در پایگاه‌های داده باعث کاهش شدید سرعت شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-upsert
افزوده‌شده در نگارش 3.12.
.sp
گونه‌ای از \fI\%\-\-append\fP که در آن به جای الحاق با \fI\%OGRLayer::CreateFeature()\fP، از عملیات \fI\%OGRLayer::UpsertFeature()\fP برای درج یا به‌روزرسانی عوارض استفاده می‌شود.
.sp
این قابلیت در حال حاضر تنها در چند درایور پیاده‌سازی شده است:
\fI\%GPKG \-\- GeoPackage vector\fP، \fI\%Elasticsearch: Geographically Encoded Objects for Elasticsearch\fP و \fI\%MongoDBv3\fP
(درایورهایی که upsert را پیاده‌سازی می‌کنند قابلیت \fI\%GDAL_DCAP_UPSERT\fP را نمایش می‌دهند).
.sp
عملیات upsert در صورت تنظیم بودن FID عارضه ورودی (و خالی نبودن نام ستون FID)، از آن به عنوان کلید برای به‌روزرسانی عوارض موجود استفاده می‌کند. بسیار حیاتی است که اطمینان حاصل شود FID در لایه‌های مبدأ و مقصد سازگار است.
.sp
برای درایور GPKG، همچنین امکان upsert عوارضی که FID آن‌ها تنظیم نشده یا فاقد اهمیت است وجود دارد (گزینه \fB\-\-unset\-fid\fP از \fI\%gdal vector edit\fP می‌تواند برای نادیده گرفتن FID از عارضه مبدأ استفاده شود)، در صورتی که یک ستون UNIQUE وجود داشته باشد که کلید اصلی عددی صحیح نباشد.
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱: نوشتن یک فایل GeoPackage
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal vector pipeline ... [other commands here] ... ! write out.gpkg \-\-overwrite
.EE
.UNINDENT
.UNINDENT
.SH "نویسنده (AUTHOR)"
Even Rouault <even.rouault@spatialys.com>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.