.\" 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-SELECT" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-vector-select \- انتخاب زیرمجموعه‌ای از فیلدها از یک مجموعه‌داده برداری .sp در نسخه 3.11 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal vector select [OPTIONS] Select a subset of fields from 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] \-\-fields Fields to select (or exclude if \-\-exclude) [may be repeated] [required] 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 \-\-skip\-errors Skip errors when writing features [not available in pipelines] \-\-active\-layer Set active layer (if not specified, all) \-\-exclude Exclude specified fields Mutually exclusive with \-\-ignore\-missing\-fields \-\-ignore\-missing\-fields Ignore missing fields Mutually exclusive with \-\-exclude 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 select\fP می‌تواند برای انتخاب زیرمجموعه‌ای از فیلدها استفاده شود. .sp همچنین \fBselect\fP می‌تواند به عنوان مرحله‌ای از \fI\%gdal vector pipeline\fP به کار رود\&. .SH "خروجی GDALG (مجموعه‌داده برخط / جریانی) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))" .sp این برنامه از سریال‌سازی خط فرمان به صورت یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند. فایل حاصل را می‌توان سپس به عنوان یک مجموعه‌داده برداری با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP باز کرد و خط لوله مشخص‌شده را به صورت برخط (on\-the\-fly) / جریانی (streamed) اعمال نمود. .SH "گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-exclude رفتار الگوریتم را به گونه‌ای تغییر می‌دهد که همه فیلدها انتخاب شوند، به جز مواردی که با \fI\%\-\-fields\fP مشخص شده‌اند\&. .UNINDENT .INDENT 0.0 .TP .B \-\-fields فهرستی از فیلدهای لایه ورودی که با ویرگول از هم جدا شده‌اند برای کپی شدن در لایه جدید (یا مستثنی شدن در صورتی که \fI\%\-\-exclude\fP تعیین شده باشد). .sp نام‌های فیلدی که دارای فاصله، ویرگول یا علامت گیومه (double\-quote) هستند باید با گیومه دوتایی در ابتدا و انتها احاطه شوند، و نویسه‌های گیومه در نام یک فیلد باید با بک‌اسلش اسکیپ شوند. .sp بسته به پوسته مورد استفاده، ممکن است نقل‌قول‌های بیشتری لازم باشد. برای نمونه، جهت انتخاب \fBregular_field\fP، \fBa_field_with space, and comma\fP و \fBa field with \(dq double quote\fP در یک پوسته یونیکس: .INDENT 7.0 .INDENT 3.5 .sp .EX \-\-fields \(dqregular_field,\e\(dqa_field_with space, and comma\e\(dq,\e\(dqa field with \e\e\e\(dq double quote\e\(dq\(dq .EE .UNINDENT .UNINDENT .sp هر فیلد حتی اگر چندین بار در فهرست ذکر شده باشد، تنها یک بار انتخاب می‌شود. .sp فیلدهای هندسه نیز می‌توانند در این فهرست مشخص شوند. اگر لایه مبدأ هیچ نام صریحی برای فیلد هندسه نداشته باشد، باید از \fB_ogr_geometry_\fP برای انتخاب فیلد هندسه منحصربه‌فرد استفاده شود. .sp تعیین نام فیلد مبدئی که وجود ندارد، منجر به بروز خطا می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-ignore\-missing\-fields به‌طور پیش‌فرض، اگر فیلد مشخص‌شده توسط \fI\%\-\-fields\fP در لایه(های) ورودی وجود نداشته باشد، خطایی صادر شده و پردازش متوقف می‌شود. هنگام تعیین \fI\%\-\-ignore\-missing\-fields\fP، تنها یک هشدار صادر شده و فیلدهای ناموجود صرفاً نادیده گرفته می‌شوند. .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-active\-layer تنظیم لایه فعال. هنگامی که این گزینه تعیین شود، تنها لایه‌ای که با نام آن مشخص شده است تحت پردازش قرار می‌گیرد. سایر لایه‌ها تغییری نخواهند کرد. اگر این گزینه مشخص نشود، تمامی لایه‌ها تحت پردازش قرار خواهند گرفت. .UNINDENT .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 نام یک یا چند لایه را برای پردازش مشخص می‌کند. به‌طور پیش‌فرض، تمام لایه‌ها پردازش خواهند شد. برای خواندن و نوشتن تمام لایه‌ها اما فقط پردازش یک زیرمجموعه، از \fI\%\-\-active\-layer\fP استفاده کنید\&. .UNINDENT .INDENT 0.0 .TP .B \-\-lco, \-\-layer\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ساخت لایه دارند که می‌توانند برای کنترل خصوصیات لایه ایجادشده استفاده شوند. برای نمونه، درایور GeoPackage از گزینه‌های ساخت لایه برای کنترل شناسه عارضه یا نام ستون هندسه، تنظیم شناسه یا توضیحات و غیره پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساخت لایه موجود بسته به درایور قالب متفاوت است، و برخی از قالب‌های ساده هیچ گزینه ساخت لایه‌ای ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات قالب، مرجع قطعی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز هر قالب، به مستندات ویژه قالب \fI\%Vector drivers\fP مراجعه کنید. .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 آیا مجموعه‌داده خروجی موجود در حالت به‌روزرسانی باز شود یا خیر. .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، همچنین امکان درج یا به‌روزرسانی عوارضی که FID آن‌ها تنظیم نشده یا فاقد اهمیت است وجود دارد (می‌توان از گزینه \fB\-\-unset\-fid\fP در \fI\%gdal vector edit\fP برای نادیده گرفتن FID عارضه مبدأ استفاده کرد)، مشروط بر اینکه یک ستون UNIQUE وجود داشته باشد که کلید اصلی عددی صحیح نباشد. .UNINDENT .SH "وضعیت خروج (EXIT STATUS)" .sp برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیر صفر را برمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار صادر می‌شوند، به عنوان اجرای موفقیت‌آمیز در نظر گرفته خواهند شد). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: انتخاب فیلد EAS_ID و فیلد هندسه از یک Shapefile" .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal vector select in.shp out.gpkg \(dqEAS_ID,_ogr_geometry_\(dq \-\-overwrite .EE .UNINDENT .UNINDENT .SS "مثال ۲: حذف فیلدهای حساس از یک لایه" .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal vector select in.shp out.gpkg \-\-exclude \(dqname,surname,address\(dq \-\-overwrite .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Even Rouault .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .