.\" 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-CONVERT" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-vector-convert \- تبدیل مجموعه‌داده‌های برداری .sp افزوده‌شده در نسخه 3.11. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal vector convert [OPTIONS] Convert a vector dataset. Positional arguments: \-i, \-\-input Input vector datasets [required] [not available in pipelines] \-o, \-\-output Output vector dataset [required] [not available in pipelines] Common Options: \-h, \-\-help Display help message and exit \-\-json\-usage Display usage as JSON document and exit \-\-config = Configuration option [may be repeated] \-q, \-\-quiet Quiet mode (no progress bar or warning message) [not available in pipelines] Options: \-l, \-\-layer, \-\-input\-layer Input layer name(s) [may be repeated] [not available in pipelines] \-f, \-\-of, \-\-format, \-\-output\-format Output format (\(dqGDALG\(dq allowed) [not available in pipelines] \-\-co, \-\-creation\-option = Creation option [may be repeated] [not available in pipelines] \-\-lco, \-\-layer\-creation\-option = Layer creation option [may be repeated] [not available in pipelines] \-\-overwrite Whether overwriting existing output dataset is allowed [not available in pipelines] \-\-update Whether to open existing dataset in update mode [not available in pipelines] \-\-overwrite\-layer Whether overwriting existing output layer is allowed [not available in pipelines] \-\-append Whether appending to existing layer is allowed [not available in pipelines] Mutually exclusive with \-\-upsert \-\-output\-layer Output layer name [not available in pipelines] \-\-skip\-errors Skip errors when writing features [not available in pipelines] \-\-no\-create\-empty\-layers Avoid creating layers to which no features will be written [not available in pipelines] Advanced Options: \-\-if, \-\-input\-format Input formats [may be repeated] [not available in pipelines] \-\-oo, \-\-open\-option = Open options [may be repeated] [not available in pipelines] \-\-output\-oo, \-\-output\-open\-option = Output open options [may be repeated] [not available in pipelines] \-\-upsert Upsert features (implies \(aqappend\(aq) [not available in pipelines] Mutually exclusive with \-\-append .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp از \fBgdal vector convert\fP می‌توان برای تبدیل داده‌ها بین قالب‌های مختلف استفاده کرد. .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-append مشخص می‌کند که آیا الحاق عوارض به لایه(های) موجود مجاز است یا خیر. این گزینه در صورت عدم وجود مجموعه‌داده خروجی، آن را نیز ایجاد می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ساخت مجموعه‌داده دارند که می‌توان از آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoPackage از گزینه‌های ساخت برای کنترل نسخه پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساخت مجموعه‌داده بسته به درایور قالب متفاوت است و برخی قالب‌های ساده هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات قالب، مرجع قطعی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز هر قالب، به مستندات ویژه قالب در \fI\%Vector drivers\fP مراجعه کنید. .sp توجه داشته باشید که گزینه‌های ساخت مجموعه‌داده با گزینه‌های ساخت لایه متفاوت هستند. .UNINDENT .INDENT 0.0 .TP .B \-\-if, \-\-input\-format نام قالب/درایور کاندید برای باز کردن فایل(های) ورودی. معمولاً تعیین آن ضروری نیست، اما در مواردی که تشخیص خودکار درایور مناسب با شکست مواجه می‌شود، می‌توان از آن استفاده کرد. این گزینه می‌تواند چندین بار برای تعیین چندین درایور کاندید تکرار شود. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند؛ به‌ویژه آن‌که برخی درایورها پیش‌نیازهایی درباره پسوند فایل دارند. .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-input\-layer نام یک یا چند لایه را برای پردازش مشخص می‌کند. به‌طور پیش‌فرض، تمام لایه‌ها پردازش خواهند شد. .UNINDENT .INDENT 0.0 .TP .B \-\-lco, \-\-layer\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ساخت لایه دارند که می‌توان از آن‌ها برای کنترل جزئیات لایه ایجادشده استفاده کرد. برای نمونه، درایور GeoPackage از گزینه‌های ساخت لایه برای کنترل شناسه عارضه یا نام ستون هندسه (geometry)، تنظیم شناسه یا توضیحات و غیره پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساخت لایه موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده هیچ گزینه ساخت لایه‌ای ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات مربوط به آن قالب منبع قطعی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز هر قالب، به مستندات ویژه قالب در \fI\%Vector drivers\fP مراجعه کنید. .sp توجه داشته باشید که گزینه‌های ساخت لایه با گزینه‌های ساخت مجموعه‌داده متفاوت هستند. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-create\-empty\-layers افزوده‌شده در نسخه 3.13. .sp از ایجاد لایه‌هایی که هیچ عارضه‌ای در آن‌ها نوشته نخواهد شد جلوگیری می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه‌داده (ویژه هر قالب). .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-f, \-\-of, \-\-format, \-\-output\-format تعیین قالب برداری خروجی مورد استفاده. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: \fBgdal \-\-formats | grep vector | grep rw | sort\fP .UNINDENT .INDENT 0.0 .TP .B \-\-output\-layer نام لایه‌ای را مشخص می‌کند که عوارض در آن نوشته خواهند شد. اگر مشخص نشود، نام لایه‌های خروجی با نام لایه‌های ورودی یکسان خواهد بود. .UNINDENT .INDENT 0.0 .TP .B \-\-output\-open\-option, \-\-output\-oo = افزوده‌شده در نسخه 3.12. .sp گزینه باز کردن مجموعه‌داده برای مجموعه‌داده خروجی (ویژه هر قالب). .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite به برنامه اجازه می‌دهد فایل یا مجموعه‌داده مقصد موجود را بازنویسی کند. در غیر این صورت، به‌طور پیش‌فرض، در صورتی که فایل یا مجموعه‌داده مقصد از قبل وجود داشته باشد، \fBgdal\fP با خطا متوقف می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite\-layer مشخص می‌کند که آیا بازنویسی لایه برداری خروجی موجود مجاز است یا خیر. .UNINDENT .INDENT 0.0 .TP .B \-\-skip\-errors افزوده‌شده در نسخه 3.12. .sp مشخص می‌کند که آیا خطاهای مربوط به نوشتن عارضه(ها) نادیده گرفته شوند یا خیر. توجه داشته باشید که این گزینه اندازه واحد تراکنش را به یک عارضه در هر زمان تنظیم می‌کند، که ممکن است هنگام درج داده‌ها در پایگاه‌های داده باعث افت شدید سرعت شود. .UNINDENT .INDENT 0.0 .TP .B \-\-update مشخص می‌کند که آیا مجموعه‌داده خروجی موجود در حالت به‌روزرسانی (update) باز شود یا خیر. .UNINDENT .INDENT 0.0 .TP .B \-\-upsert افزوده‌شده در نسخه 3.12. .sp گونه‌ای از \fI\%\-\-append\fP که در آن عملیات \fI\%OGRLayer::UpsertFeature()\fP برای درج یا به‌روزرسانی عوارض به جای الحاق با \fI\%OGRLayer::CreateFeature()\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 به عنوان کلید برای به‌روزرسانی عوارض موجود استفاده می‌کند. اطمینان از سازگاری FID در لایه‌های مبدأ و مقصد بسیار حیاتی است. .sp برای درایور GPKG، همچنین امکان upsert عوارضی که FID آن‌ها تنظیم نشده یا نامعتبر است وجود دارد (می‌توان از گزینه \fB\-\-unset\-fid\fP در \fI\%gdal vector edit\fP برای نادیده گرفتن FID از عارضه مبدأ استفاده کرد)، مشروط بر این که یک ستون UNIQUE وجود داشته باشد که کلید اصلی عددی صحیح نباشد. .UNINDENT .INDENT 0.0 .TP .B \-q, \-\-quiet پنهان کردن نوار پیشرفت و برخی پیام‌های هشدار. .UNINDENT .SH "وضعیت خروج (EXIT STATUS)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر را برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار ارسال می‌شوند، به عنوان اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: تبدیل فایل poly.shp به یک GeoPackage" .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal vector convert poly.shp output.gpkg .EE .UNINDENT .UNINDENT .SS "مثال ۲: افزودن لایه جدید از فایل line.shp به یک GeoPackage موجود و تغییر نام آن به \(dqlines\(dq" .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal vector convert \-\-update \-\-output\-layer=lines line.shp output.gpkg .EE .UNINDENT .UNINDENT .SS "مثال ۳: الحاق عوارض از فایل poly2.shp به لایه موجود poly در یک GeoPackage، بدون نوار پیشرفت" .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal vector convert \-\-quiet \-\-append \-\-output\-layer=poly poly2.shp output.gpkg .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Even Rouault .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .