GDAL-VECTOR-EXPORT-SCHEMA(1)         GDAL         GDAL-VECTOR-EXPORT-SCHEMA(1)

نام (NAME)
       gdal-vector-export-schema - برون‌بری OGR_SCHEMA از یک مجموعه‌داده برداری

       در نسخه 3.13 اضافه شد.


خلاصه دستور (SYNOPSIS)

          Usage: gdal vector export-schema [OPTIONS] <INPUT>...

          Export the OGR_SCHEMA from a vector dataset.

          Positional arguments:
            -i, --dataset, --input <INPUT>            Input vector datasets [may be repeated] [required]

          Common Options:
            -h, --help                                Display help message and exit
            --json-usage                              Display usage as JSON document and exit
            --config <KEY>=<VALUE>                    Configuration option [may be repeated]

          Options:
            -l, --layer, --input-layer <INPUT-LAYER>  Input layer name [may be repeated]

          Advanced Options:
            --oo, --open-option <KEY>=<VALUE>         Open options [may be repeated]
            --if, --input-format <INPUT-FORMAT>       Input formats [may be repeated]

توضیحات (DESCRIPTION)
       دستور gdal vector export-schema ویژگی OGR_SCHEMA را از یک مجموعه‌داده
       برداری تحت پشتیبانی GDAL برون‌بری کرده و هنگام استفاده از طریق خط فرمان،
       آن را در جریان خروجی استاندارد، و هنگام استفاده از طریق API، در پارامتر
       output برمی‌گرداند.

       OGR_SCHEMA یک شیء JSON است که ساختار یک مجموعه‌داده برداری را بر اساس
       تعریف شِما در ogr_fields_override.schema.json توصیف می‌کند.

       دستور gdal vector export-schema می‌تواند به عنوان مرحله پایانی یک خط
       لوله (pipeline) استفاده شود.

       گزینه‌های زیر در دسترس هستند:

گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)

       -l, --layer, --input-layer <INPUT-LAYER>
              نام یک یا چند لایه برای بررسی. اگر نام لایه‌ای مشخص نشود، تمام
              لایه‌ها انتخاب خواهند شد.

گزینه‌های استاندارد (STANDARD OPTIONS)

       --oo, --open-option <NAME>=<VALUE>
              گزینه باز کردن مجموعه‌داده (مختص هر قالب).

              می‌تواند تکرار شود.

       --if, --input-format <format>
              نام قالب/درایور مورد تلاش برای باز کردن فایل(های) ورودی. به‌طور
              کلی مشخص کردن آن ضروری نیست، اما هنگامی که تشخیص خودکار درایور
              در انتخاب درایور مناسب ناموفق باشد، می‌تواند برای صرف‌نظر از تشخیص
              خودکار به کار رود.  این گزینه می‌تواند چندین بار برای مشخص کردن
              چندین درایور کاندید تکرار شود.  توجه داشته باشید که این گزینه آن
              درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند؛ به‌ویژه این‌که
              برخی درایورها نیازمندی‌هایی برای پسوند فایل دارند.

              می‌تواند تکرار شود.

وضعیت خروج (RETURN STATUS CODE)
       برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا مقداری غیر صفر
       برمی‌گرداند (خطاهای غیرمسدودکننده که به شکل هشدار صادر می‌شوند، به عنوان
       اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).

مثال‌ها (EXAMPLES)
   مثال ۱: استخراج OGR_SCHEMA از فایل poly.gpkg

          gdal vector export-schema poly.gpkg

   مثال ۲: ذخیره OGR_SCHEMA در یک فایل
       هنگام استفاده از Windows PowerShell 5.1، هدایت خروجی با > یا Out-File
       -Encoding utf8 یک خروجی UTF-8 به همراه BOM (Byte Order Mark) تولید
       می‌کند. هنگام استفاده از این شِما با gdal vector create ممکن است با خطای
       ERROR 1: JSON parsing error: unexpected character (at offset 0) مواجه
       شود.

       در PowerShell 5.1، برای خروجی‌های JSON که فاقد نویسه‌های غیر ASCII هستند
       از -Encoding ascii استفاده کنید.  Bash

          gdal vector export-schema natural_earth_vector.gpkg --layer "ne_50m_admin_0_countries" > countries.json
       PowerShell

          # PowerShell 5.1
          gdal vector export-schema natural_earth_vector.gpkg --layer "ne_50m_admin_0_countries" | Out-File countries.json -Encoding ascii

          # PowerShell 7+
          gdal vector export-schema natural_earth_vector.gpkg --layer "ne_50m_admin_0_countries" | Out-File countries.json -Encoding utf8

   مثال ۳: اعتبارسنجی فایل OGR_SCHEMA با استفاده از پایتون
       اعتبارسنجی در برابر آخرین نسخه تعریف شِما در
       ogr_fields_override.schema.json با استفاده از بسته پایتون
       check-jsonschema موجود در PyPI.

          $ pip install check-jsonschema
          $ check-jsonschema --schemafile https://raw.githubusercontent.com/OSGeo/gdal/master/ogr/data/ogr_fields_override.schema.json countries.json --verbose

   مثال ۴: ایجاد یک OGR_SCHEMA در انتهای یک خط لوله
       این مثال پیش از برون‌بری OGR_SCHEMA حاصل، فیلد pop_est را به
       estimated_population تغییر نام داده و نوع آن را از Real به Integer
       تبدیل می‌کند.  Bash

          gdal vector pipeline \
              ! read natural_earth_vector.gpkg --layer ne_50m_admin_0_countries \
              ! sql --sql "SELECT geom,name,abbrev,pop_est AS estimated_population FROM ne_50m_admin_0_countries" --output-layer "countries" \
              ! set-field-type --field-name "estimated_population" --field-type Integer \
              ! export-schema
       PowerShell

          gdal vector pipeline `
              ! read natural_earth_vector.gpkg --layer ne_50m_admin_0_countries `
              ! sql --sql "SELECT geom,name,abbrev,pop_est AS estimated_population FROM ne_50m_admin_0_countries" --output-layer "countries" `
              ! set-field-type --field-name "estimated_population" --field-type Integer `
              ! export-schema

نویسندگان (AUTHORS)
       Alessandro Pasotti <elpaso@itopen.it>

کپی‌رایت و تکثیر (COPYRIGHT)
       1998-2026

                                August 18, 2026   GDAL-VECTOR-EXPORT-SCHEMA(1)