.\" 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-EXPORT-SCHEMA" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-vector-export-schema \- برون‌بری OGR_SCHEMA از یک مجموعه‌داده برداری
.sp
در نسخه 3.13 اضافه شد.

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
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]
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal vector export\-schema\fP ویژگی \fBOGR_SCHEMA\fP را از یک مجموعه‌داده برداری تحت پشتیبانی GDAL برون‌بری کرده و هنگام استفاده از طریق خط فرمان، آن را در جریان خروجی استاندارد، و هنگام استفاده از طریق API، در پارامتر \fBoutput\fP برمی‌گرداند.
.sp
\fBOGR_SCHEMA\fP یک شیء JSON است که ساختار یک مجموعه‌داده برداری را بر اساس تعریف شِما در \X'tty: link https://github.com/OSGeo/gdal/blob/release/3.13/ogr/data/ogr_fields_override.schema.json'\fI\%ogr_fields_override.schema.json\fP\X'tty: link' توصیف می‌کند.
.sp
دستور \fBgdal vector export\-schema\fP می‌تواند به عنوان مرحله پایانی یک خط لوله (pipeline) استفاده شود.
.sp
گزینه‌های زیر در دسترس هستند:
.SH "گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)"
.INDENT 0.0
.TP
.B \-l, \-\-layer, \-\-input\-layer <INPUT\-LAYER>
نام یک یا چند لایه برای بررسی. اگر نام لایه‌ای مشخص نشود، تمام لایه‌ها انتخاب خواهند شد.
.UNINDENT
.SH "گزینه‌های استاندارد (STANDARD OPTIONS)"
.INDENT 0.0
.TP
.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
گزینه باز کردن مجموعه‌داده (مختص هر قالب).
.sp
می‌تواند تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-if, \-\-input\-format <format>
نام قالب/درایور مورد تلاش برای باز کردن فایل(های) ورودی. به‌طور کلی مشخص کردن آن ضروری نیست، اما هنگامی که تشخیص خودکار درایور در انتخاب درایور مناسب ناموفق باشد، می‌تواند برای صرف‌نظر از تشخیص خودکار به کار رود.
این گزینه می‌تواند چندین بار برای مشخص کردن چندین درایور کاندید تکرار شود.
توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند؛ به‌ویژه این‌که برخی درایورها نیازمندی‌هایی برای پسوند فایل دارند.
.sp
می‌تواند تکرار شود.
.UNINDENT
.SH "وضعیت خروج (RETURN STATUS CODE)"
.sp
برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا مقداری غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به شکل هشدار صادر می‌شوند، به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱: استخراج OGR_SCHEMA از فایل poly.gpkg"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal vector export\-schema poly.gpkg
.EE
.UNINDENT
.UNINDENT
.SS "مثال ۲: ذخیره OGR_SCHEMA در یک فایل"
.sp
هنگام استفاده از Windows PowerShell 5.1، هدایت خروجی با \fB>\fP یا \fBOut\-File \-Encoding utf8\fP یک خروجی UTF\-8 به همراه BOM (Byte Order Mark) تولید می‌کند. هنگام استفاده از این شِما با \fI\%gdal vector create\fP ممکن است با خطای \fBERROR 1: JSON parsing error: unexpected character (at offset 0)\fP مواجه شود.
.sp
در PowerShell 5.1، برای خروجی‌های JSON که فاقد نویسه‌های غیر ASCII هستند از \fB\-Encoding ascii\fP استفاده کنید.
Bash
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal vector export\-schema natural_earth_vector.gpkg \-\-layer \(dqne_50m_admin_0_countries\(dq > countries.json
.EE
.UNINDENT
.UNINDENT
PowerShell
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# PowerShell 5.1
gdal vector export\-schema natural_earth_vector.gpkg \-\-layer \(dqne_50m_admin_0_countries\(dq | Out\-File countries.json \-Encoding ascii

# PowerShell 7+
gdal vector export\-schema natural_earth_vector.gpkg \-\-layer \(dqne_50m_admin_0_countries\(dq | Out\-File countries.json \-Encoding utf8
.EE
.UNINDENT
.UNINDENT
.SS "مثال ۳: اعتبارسنجی فایل OGR_SCHEMA با استفاده از پایتون"
.sp
اعتبارسنجی در برابر آخرین نسخه تعریف شِما در \X'tty: link https://github.com/OSGeo/gdal/blob/release/3.13/ogr/data/ogr_fields_override.schema.json'\fI\%ogr_fields_override.schema.json\fP\X'tty: link' با استفاده از بسته پایتون \X'tty: link https://pypi.org/project/check-jsonschema'\fI\%check\-jsonschema\fP\X'tty: link' موجود در PyPI.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ pip install check\-jsonschema
$ check\-jsonschema \-\-schemafile https://raw.githubusercontent.com/OSGeo/gdal/master/ogr/data/ogr_fields_override.schema.json countries.json \-\-verbose
.EE
.UNINDENT
.UNINDENT
.SS "مثال ۴: ایجاد یک OGR_SCHEMA در انتهای یک خط لوله"
.sp
این مثال پیش از برون‌بری OGR_SCHEMA حاصل، فیلد \fBpop_est\fP را به \fBestimated_population\fP تغییر نام داده و نوع آن را از \fBReal\fP به \fBInteger\fP تبدیل می‌کند.
Bash
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal vector pipeline \e
    ! read natural_earth_vector.gpkg \-\-layer ne_50m_admin_0_countries \e
    ! sql \-\-sql \(dqSELECT geom,name,abbrev,pop_est AS estimated_population FROM ne_50m_admin_0_countries\(dq \-\-output\-layer \(dqcountries\(dq \e
    ! set\-field\-type \-\-field\-name \(dqestimated_population\(dq \-\-field\-type Integer \e
    ! export\-schema
.EE
.UNINDENT
.UNINDENT
PowerShell
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal vector pipeline \(ga
    ! read natural_earth_vector.gpkg \-\-layer ne_50m_admin_0_countries \(ga
    ! sql \-\-sql \(dqSELECT geom,name,abbrev,pop_est AS estimated_population FROM ne_50m_admin_0_countries\(dq \-\-output\-layer \(dqcountries\(dq \(ga
    ! set\-field\-type \-\-field\-name \(dqestimated_population\(dq \-\-field\-type Integer \(ga
    ! export\-schema
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Alessandro Pasotti <elpaso@itopen.it>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.