.\" 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-RENAME-LAYER" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-vector-rename-layer \- تغییر نام لایه یا لایه‌های یک مجموعه‌داده برداری .sp افزوده‌شده در نسخه 3.13. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal vector rename\-layer [OPTIONS] تغییر نام لایه یا لایه‌های یک مجموعه‌داده برداری. آرگومان‌های مکانی: \-i, \-\-input مجموعه‌داده‌های برداری ورودی [الزامی] [در خطوط لوله در دسترس نیست] \-o, \-\-output مجموعه‌داده برداری خروجی [الزامی] [در خطوط لوله در دسترس نیست] گزینه‌های عمومی: \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش نحوه استفاده در قالب سند JSON و خروج \-\-config = گزینه پیکربندی [تکرارپذیر] \-q, \-\-quiet حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خطوط لوله در دسترس نیست] گزینه‌ها: \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی (مقدار \(dqGDALG\(dq مجاز است) [در خطوط لوله در دسترس نیست] \-\-co, \-\-creation\-option = گزینه ایجاد [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-lco, \-\-layer\-creation\-option = گزینه ایجاد لایه [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-overwrite امکان بازنویسی مجموعه‌داده خروجی موجود [در خطوط لوله در دسترس نیست] \-\-update باز کردن مجموعه‌داده موجود در حالت به‌روزرسانی [در خطوط لوله در دسترس نیست] \-\-overwrite\-layer امکان بازنویسی لایه خروجی موجود [در خطوط لوله در دسترس نیست] \-\-append امکان الحاق به لایه موجود [در خطوط لوله در دسترس نیست] ناسازگار با \-\-upsert \-\-output\-layer نام لایه خروجی \-\-skip\-errors نادیده گرفتن خطاها هنگام نوشتن عوارض [در خطوط لوله در دسترس نیست] \-l, \-\-input\-layer نام لایه ورودی \-\-ascii اجبار نام‌ها به استفاده از نویسه‌های ASCII \-\-lower\-case اجبار نام‌ها به حروف کوچک (فقط روی نویسه‌های ASCII) \-\-filename\-compatible اجبار نام‌ها به قابل‌استفاده بودن به عنوان نام فایل \-\-reserved\-characters نویسه یا نویسه‌های رزروشده جهت حذف \-\-replacement\-character نویسه جایگزین در صورت عدم امکان تبدیل به ASCII \-\-max\-length حداکثر طول نام‌های لایه گزینه‌های پیشرفته: \-\-if, \-\-input\-format قالب‌های ورودی [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-oo, \-\-open\-option = گزینه‌های باز کردن [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-output\-oo, \-\-output\-open\-option = گزینه‌های باز کردن خروجی [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-upsert به‌روزرسانی یا درج عوارض (مستلزم \(aqappend\(aq) [در خطوط لوله در دسترس نیست] ناسازگار با \-\-append .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal vector rename\-layer\fP می‌تواند برای تغییر نام لایه یا لایه‌ها استفاده شود. .sp این دستور دو حالت دارد: .INDENT 0.0 .IP \(bu 2 حالتی که در آن کاربر یک لایه منفرد را با \fI\%\-\-output\-layer\fP به یک نام مشخص تغییر می‌دهد، که در صورت وجود بیش از یک لایه با \fI\%\-\-input\-layer\fP ترکیب می‌شود. .IP \(bu 2 حالت دیگری که در آن کاربر می‌تواند عملیات‌های گوناگونی را برای دگرگون‌سازی نام‌های لایه‌ها اعمال کند: .INDENT 2.0 .IP \(bu 2 اجبار نویسه‌ها به ASCII: \fI\%\-\-ascii\fP .IP \(bu 2 اجبار نویسه‌ها به حروف کوچک: \fI\%\-\-lower\-case\fP .IP \(bu 2 اجبار سازگاری با نام‌های فایل: \fI\%\-\-filename\-compatible\fP .IP \(bu 2 حذف یا جایگزینی نویسه‌ها از یک فهرست نویسه‌های رزروشده: \fI\%\-\-reserved\-characters\fP .IP \(bu 2 کوتاه‌سازی به حداکثر تعداد مشخصی از نویسه‌ها: \fI\%\-\-max\-length\fP .UNINDENT .sp برای گزینه‌های \fI\%\-\-filename\-compatible\fP و \fI\%\-\-reserved\-characters\fP، نویسه‌های ناسازگار حذف می‌شوند، مگر اینکه \fI\%\-\-replacement\-character\fP مشخص شده باشد. .sp در این حالت، یکتایی نام‌های لایه‌ها نیز با الحاق \fB_{N}\fP (که در آن N یک شماره ترتیبی است) تضمین می‌شود. در صورتی که \fI\%\-\-max\-length\fP روی مقدار بسیار پایینی تنظیم شده باشد، ممکن است یکتایی حاصل نشود. .UNINDENT .sp این زیردستور همچنین به عنوان یک مرحله بالقوه در \fI\%gdal vector pipeline\fP در دسترس است. .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-input\-layer نام لایه ورودی. باید همراه با \fI\%\-\-output\-layer\fP استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-\-output\-layer نام لایه خروجی. اگر چندین لایه ورودی وجود دارد، \fI\%\-\-output\-layer\fP نیز باید مشخص شود. .UNINDENT .INDENT 0.0 .TP .B \-\-ascii اجبار نویسه‌ها به ASCII. در حال حاضر فقط نویسه‌های دارای اعراب در مجموعه‌های نویسه \X'tty: link https://en.wikipedia.org/wiki/Latin-1_Supplement'\fI\%Latin 1 Supplement\fP\X'tty: link' و \X'tty: link https://en.wikipedia.org/wiki/Latin_Extended-A'\fI\%Latin Extended A\fP\X'tty: link' دارای جایگزین معقول ASCII هستند. سایر نویسه‌های غیر ASCII حذف می‌شوند یا با نویسه جایگزین تعیین‌شده توسط \fI\%\-\-replacement\-character\fP جایگزین خواهند شد. .UNINDENT .INDENT 0.0 .TP .B \-\-lower\-case اجبار نویسه‌ها به حروف کوچک. در حال حاضر فقط نویسه‌های بزرگ ASCII جایگزین می‌شوند. این گزینه در صورت مشخص شدن \fI\%\-\-ascii\fP، پس از آن اعمال می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-filename\-compatible اجبار نام‌های لایه‌ها به سازگار بودن با نام فایل در لینوکس، ویندوز یا مک، مستقل از اینکه این دستور روی چه سیستم‌عاملی اجرا می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-reserved\-characters نویسه یا نویسه‌های رزروشده جهت حذف یا جایگزینی با نویسه جایگزین تعیین‌شده در \fI\%\-\-replacement\-character\fP. .UNINDENT .INDENT 0.0 .TP .B \-\-replacement\-character نویسه جایگزین در صورتی که تبدیل به ASCII امکان‌پذیر نباشد یا برای جایگزینی نویسه‌های رزروشده. .UNINDENT .INDENT 0.0 .TP .B \-\-max\-length کوتاه‌سازی به حداکثر تعداد نویسه مشخص. .UNINDENT .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 \-\-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::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 در لایه‌های مبدأ و مقصد سازگار هستند. .sp برای درایور GPKG، همچنین امکان upsert عوارضی که FID آن‌ها تنظیم نشده یا بی‌اهمیت است وجود دارد (گزینه \fB\-\-unset\-fid\fP از \fI\%gdal vector edit\fP می‌تواند برای نادیده گرفتن FID از عارضه مبدأ استفاده شود)، در صورتی که یک ستون با قید UNIQUE وجود داشته باشد که کلید اصلی عددی صحیح نباشد. .UNINDENT .SH "کد وضعیت بازگشتی (RETURN STATUS CODE)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیر صفر بازمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار صادر می‌شوند، اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: تغییر نام یک لایه مشخص به نام انتخابی کاربر" .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal vector rename\-layer input.gpkg output.gpkg \-\-input\-layer \(dqname with space\(dq \-\-output\-layer \(dqwithout_space\(dq .EE .UNINDENT .UNINDENT .SS "مثال ۲: اجبار نام‌های لایه به ASCII، حروف کوچک، بدون کاراکتر فاصله و سازگار با نام فایل" .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal vector rename\-layer input.gpkg output_shp_directory \-\-output\-format \(dqESRI Shapefile\(dq \-\-ascii \-\-lower\-case \-\-filename\-compatible \-\-reserved\-characters \(dq \(dq .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" Even Rouault .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .