| GDAL-VECTOR-RENAME-LAYER(1) | GDAL | GDAL-VECTOR-RENAME-LAYER(1) |
نام (NAME)
gdal-vector-rename-layer - تغییر نام لایه یا لایه‌های یک مجموعه‌داده برداری
افزوده‌شده در نسخه 3.13.
خلاصه دستور (SYNOPSIS)
Usage: gdal vector rename-layer [OPTIONS] <INPUT> <OUTPUT>
تغییر نام لایه یا لایه‌های یک مجموعه‌داده برداری.
آرگومان‌های مکانی:
-i, --input <INPUT> مجموعه‌داده‌های برداری ورودی [الزامی] [در خطوط لوله در دسترس نیست]
-o, --output <OUTPUT> مجموعه‌داده برداری خروجی [الزامی] [در خطوط لوله در دسترس نیست]
گزینه‌های عمومی:
-h, --help نمایش پیام راهنما و خروج
--json-usage نمایش نحوه استفاده در قالب سند JSON و خروج
--config <KEY>=<VALUE> گزینه پیکربندی [تکرارپذیر]
-q, --quiet حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خطوط لوله در دسترس نیست]
گزینه‌ها:
-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
--output-layer <OUTPUT-LAYER> نام لایه خروجی
--skip-errors نادیده گرفتن خطاها هنگام نوشتن عوارض [در خطوط لوله در دسترس نیست]
-l, --input-layer <INPUT-LAYER> نام لایه ورودی
--ascii اجبار نام‌ها به استفاده از نویسه‌های ASCII
--lower-case اجبار نام‌ها به حروف کوچک (فقط روی نویسه‌های ASCII)
--filename-compatible اجبار نام‌ها به قابل‌استفاده بودن به عنوان نام فایل
--reserved-characters <RESERVED-CHARACTERS> نویسه یا نویسه‌های رزروشده جهت حذف
--replacement-character <REPLACEMENT-CHARACTER> نویسه جایگزین در صورت عدم امکان تبدیل به ASCII
--max-length <MAX-LENGTH> حداکثر طول نام‌های لایه
گزینه‌های پیشرفته:
--if, --input-format <INPUT-FORMAT> قالب‌های ورودی [تکرارپذیر] [در خطوط لوله در دسترس نیست]
--oo, --open-option <KEY>=<VALUE> گزینه‌های باز کردن [تکرارپذیر] [در خطوط لوله در دسترس نیست]
--output-oo, --output-open-option <KEY>=<VALUE> گزینه‌های باز کردن خروجی [تکرارپذیر] [در خطوط لوله در دسترس نیست]
--upsert به‌روزرسانی یا درج عوارض (مستلزم 'append') [در خطوط لوله در دسترس نیست]
ناسازگار با --append
توضیحات (DESCRIPTION)
دستور gdal vector rename-layer می‌تواند برای تغییر نام لایه یا لایه‌ها استفاده شود.
این دستور دو حالت دارد:
- حالتی که در آن کاربر یک لایه منفرد را با --output-layer به یک نام مشخص تغییر می‌دهد، که در صورت وجود بیش از یک لایه با --input-layer ترکیب می‌شود.
- حالت دیگری که در آن کاربر می‌تواند عملیات‌های گوناگونی را برای دگرگون‌سازی نام‌های لایه‌ها اعمال کند:
- اجبار نویسه‌ها به ASCII: --ascii
- اجبار نویسه‌ها به حروف کوچک: --lower-case
- اجبار سازگاری با نام‌های فایل: --filename-compatible
- حذف یا جایگزینی نویسه‌ها از یک فهرست نویسه‌های رزروشده: --reserved-characters
- کوتاه‌سازی به حداکثر تعداد مشخصی از نویسه‌ها: --max-length
برای گزینه‌های --filename-compatible و --reserved-characters، نویسه‌های ناسازگار حذف می‌شوند، مگر اینکه --replacement-character مشخص شده باشد.
در این حالت، یکتایی نام‌های لایه‌ها نیز با الحاق _{N} (که در آن N یک شماره ترتیبی است) تضمین می‌شود. در صورتی که --max-length روی مقدار بسیار پایینی تنظیم شده باشد، ممکن است یکتایی حاصل نشود.
این زیردستور همچنین به عنوان یک مرحله بالقوه در gdal vector pipeline در دسترس است.
گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)
- --input-layer <INPUT-LAYER>
- نام لایه ورودی. باید همراه با --output-layer استفاده شود.
- --output-layer <OUTPUT-LAYER>
- نام لایه خروجی. اگر چندین لایه ورودی وجود دارد، --output-layer نیز باید مشخص شود.
- --ascii
- اجبار نویسه‌ها به ASCII. در حال حاضر فقط نویسه‌های دارای اعراب در مجموعه‌های نویسه Latin 1 Supplement و Latin Extended A دارای جایگزین معقول ASCII هستند. سایر نویسه‌های غیر ASCII حذف می‌شوند یا با نویسه جایگزین تعیین‌شده توسط --replacement-character جایگزین خواهند شد.
- --lower-case
- اجبار نویسه‌ها به حروف کوچک. در حال حاضر فقط نویسه‌های بزرگ ASCII جایگزین می‌شوند. این گزینه در صورت مشخص شدن --ascii، پس از آن اعمال می‌شود.
- --filename-compatible
- اجبار نام‌های لایه‌ها به سازگار بودن با نام فایل در لینوکس، ویندوز یا مک، مستقل از اینکه این دستور روی چه سیستم‌عاملی اجرا می‌شود.
- --reserved-characters <RESERVED-CHARACTERS>
- نویسه یا نویسه‌های رزروشده جهت حذف یا جایگزینی با نویسه جایگزین تعیین‌شده در --replacement-character.
- --replacement-character <REPLACEMENT-CHARACTER>
- نویسه جایگزین در صورتی که تبدیل به ASCII امکان‌پذیر نباشد یا برای جایگزینی نویسه‌های رزروشده.
- --max-length <MAX-LENGTH>
- کوتاه‌سازی به حداکثر تعداد نویسه مشخص.
گزینه‌های استاندارد (STANDARD OPTIONS)
- --append
- امکان الحاق عوارض به لایه یا لایه‌های موجود را فراهم می‌کند. در صورتی که مجموعه‌داده خروجی هنوز وجود نداشته باشد، آن را نیز ایجاد می‌کند.
- --co, --creation-option <NAME>=<VALUE>
- بسیاری از
قالب‌ها یک
یا چند
گزینه
اختیاری
ایجاد
مجموعه‌داده
دارند که
می‌توانند
برای کنترل
ویژگی‌های
خاص فایل
ایجادشده
استفاده
شوند. برای
مثال،
درایور GeoPackage
از
گزینه‌های
ایجاد برای
کنترل نسخه
پشتیبانی
می‌کند.
می‌تواند تکرار شود.
گزینه‌های ایجاد مجموعه‌داده در دسترس بسته به درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً گزینه ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات خود قالب، منبع معتبر اطلاعات درباره گزینه‌های ایجاد درایور است. برای مشاهده گزینه‌های مجاز ایجاد برای هر قالب، به مستندات اختصاصی قالب در بخش Vector drivers مراجعه کنید.
توجه داشته باشید که گزینه‌های ایجاد مجموعه‌داده با گزینه‌های ایجاد لایه متفاوت هستند.
- --if, --input-format <format>
- نام قالب یا
درایور جهت
تلاش برای
باز کردن
فایل یا
فایل‌های
ورودی. به
طور کلی
مشخص کردن
آن الزامی
نیست، اما
می‌توان از
آن برای
چشم‌پوشی
از تشخیص
خودکار
درایور، در
زمان‌هایی
که در
انتخاب
درایور
مناسب
ناموفق
است،
استفاده
کرد. این
گزینه
می‌تواند
چندین بار
برای تعیین
چندین
درایور
کاندید
تکرار شود.
توجه داشته
باشید که
این گزینه
آن
درایورها
را به باز
کردن
مجموعه‌داده
مجبور
نمی‌کند؛
به ویژه
برخی
درایورها
الزامات
خاصی روی
پسوند فایل
دارند.
می‌تواند تکرار شود.
- --lco, --layer-creation-option <NAME>=<VALUE>
- بسیاری از
قالب‌ها یک
یا چند
گزینه
اختیاری
ایجاد لایه
دارند که
می‌توانند
برای کنترل
ویژگی‌های
خاص لایه
ایجادشده
به کار
روند. برای
مثال،
درایور GeoPackage
از
گزینه‌های
ایجاد لایه
برای کنترل
شناسه
عارضه یا
نام ستون
هندسه،
تنظیم
شناسه یا
توضیحات و
غیره
پشتیبانی
می‌کند.
می‌تواند تکرار شود.
گزینه‌های ایجاد لایه در دسترس بسته به درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً گزینه ایجاد لایه ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات خود قالب، مرجع اصلی اطلاعات درباره گزینه‌های ایجاد درایور است. برای مشاهده گزینه‌های مجاز ایجاد لایه برای هر قالب، به مستندات اختصاصی در بخش Vector drivers مراجعه کنید.
توجه داشته باشید که گزینه‌های ایجاد لایه با گزینه‌های ایجاد مجموعه‌داده متفاوت هستند.
- --oo, --open-option <NAME>=<VALUE>
- گزینه باز
کردن
مجموعه‌داده
(وابسته به
قالب).
می‌تواند تکرار شود.
- -f, --of, --format, --output-format <OUTPUT-FORMAT>
- تعیین قالب برداری خروجی مورد استفاده. مقادیر مجاز با اجرای دستور زیر قابل مشاهده است: gdal --formats | grep vector | grep rw | sort
- --output-layer <NAME>
- نام لایه‌ای را مشخص می‌کند که عوارض در آن نوشته خواهند شد. در صورت عدم تعیین، نام‌های لایه خروجی همانند نام‌های لایه ورودی خواهند بود.
- --output-open-option, --output-oo <NAME>=<VALUE>
- افزوده‌شده
در نسخه 3.12.
گزینه باز کردن مجموعه‌داده برای مجموعه‌داده خروجی (وابسته به قالب).
می‌تواند تکرار شود.
- --overwrite
- اجازه دادن به برنامه برای بازنویسی فایل یا مجموعه‌داده هدف موجود. در غیر این صورت، به طور پیش‌فرض، اگر فایل یا مجموعه‌داده هدف از قبل وجود داشته باشد، gdal خطا می‌دهد.
- --overwrite-layer
- امکان بازنویسی لایه برداری خروجی موجود را فراهم می‌کند.
- --skip-errors
- افزوده‌شده
در نسخه 3.12.
نادیده گرفتن خطاهای رخ‌داده هنگام نوشتن عوارض. توجه داشته باشید که این گزینه اندازه واحد تراکنش را به یک عارضه در هر لحظه تنظیم می‌کند، که ممکن است هنگام درج در پایگاه‌های داده باعث کاهش شدید سرعت شود.
- --update
- باز کردن یک مجموعه‌داده خروجی موجود در حالت به‌روزرسانی.
- --upsert
- افزوده‌شده
در نسخه 3.12.
نوعی دیگر از --append که در آن عملیات OGRLayer::UpsertFeature() برای درج یا به‌روزرسانی عوارض به جای الحاق با OGRLayer::CreateFeature() استفاده می‌شود.
این قابلیت در حال حاضر تنها در چند درایور پیاده‌سازی شده است: 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 وجود داشته باشد که کلید اصلی عددی صحیح نباشد.
کد وضعیت بازگشتی (RETURN STATUS CODE)
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیر صفر بازمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار صادر می‌شوند، اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).
مثال‌ها (EXAMPLES)
مثال ۱: تغییر نام یک لایه مشخص به نام انتخابی کاربر
$ gdal vector rename-layer input.gpkg output.gpkg --input-layer "name with space" --output-layer "without_space"
مثال ۲: اجبار نام‌های لایه به ASCII، حروف کوچک، بدون کاراکتر فاصله و سازگار با نام فایل
$ gdal vector rename-layer input.gpkg output_shp_directory --output-format "ESRI Shapefile" --ascii --lower-case --filename-compatible --reserved-characters " "
نویسنده (AUTHOR)
Even Rouault <even.rouault@spatialys.com>
حق نشر (COPYRIGHT)
1998-2026
| August 18, 2026 |