.\" 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 "SQL2CSV" "1" "۱۶ اوت ۲۰۲۴" "2.2.0" "csvkit"
.SH "نام (NAME)"
sql2csv \- اجرای کوئری‌های SQL روی پایگاه‌داده و خروجی در قالب CSV
.SH "توضیحات (DESCRIPTION)"
.sp
اجرای دستورات دلخواه روی یک پایگاه‌داده SQL و ارائه نتایج در قالب CSV:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
usage: sql2csv [\-h] [\-v] [\-l] [\-V] [\-\-db CONNECTION_STRING] [\-\-query QUERY]
               [\-e ENCODING] [\-H]
               [FILE]

اجرای یک کوئری SQL روی پایگاه‌داده و خروجی دادن نتیجه در یک فایل CSV.

آرگومان‌های مکانی:
  FILE                  فایلی که به عنوان کوئری SQL استفاده می‌شود. اگر FILE و
                        \-\-query حذف شوند، کوئری از داده‌های هدایت‌شده (پایپ)
                        از طریق STDIN دریافت می‌شود.

آرگومان‌های اختیاری:
  \-h, \-\-help            نمایش این پیام راهنما و خروج
  \-\-db CONNECTION_STRING
                        رشته اتصال SQLAlchemy برای اتصال به یک پایگاه‌داده.
  \-\-engine\-option ENGINE_OPTION ENGINE_OPTION
                        یک آرگومان کلیدواژه‌ای برای ()create_engine در
                        SQLAlchemy، به‌صورت یک جفت جداشده با فاصله. این گزینه
                        می‌تواند چندین بار مشخص شود. برای نمونه: thick_mode True
  \-\-execution\-option EXECUTION_OPTION EXECUTION_OPTION
                        یک آرگومان کلیدواژه‌ای برای ()execution_options در
                        SQLAlchemy، به‌صورت یک جفت جداشده با فاصله. این گزینه
                        می‌تواند چندین بار مشخص شود. برای نمونه:
                        stream_results True
  \-\-query QUERY         کوئری SQL برای اجرا. بر FILE و STDIN اولویت دارد.
  \-e ENCODING, \-\-encoding ENCODING
                        تعیین کدگذاری فایل کوئری ورودی.
  \-H, \-\-no\-header\-row   عدم خروجی دادن نام ستون‌ها (سطر سرآیند).
.ft P
.fi
.UNINDENT
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.sp
بارگذاری داده‌های نمونه در یک جدول با استفاده از \fI\%csvsql\fP و سپس اجرای کوئری روی آن با استفاده از \fIsql2csv\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
csvsql \-\-db \(dqsqlite:///dummy.db\(dq \-\-tables \(dqtest\(dq \-\-insert examples/dummy.csv
sql2csv \-\-db \(dqsqlite:///dummy.db\(dq \-\-query \(dqselect * from test\(dq
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
بارگذاری داده‌های مربوط به دریافت‌کنندگان کمک مالی در PostgreSQL. سپس یافتن سه ایالتی که بیشترین میزان را دریافت کرده‌اند، ضمن حذف سطرهای خالی:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
createdb recipients
csvsql \-\-db \(dqpostgresql:///recipients\(dq \-\-tables \(dqfy09\(dq \-\-insert examples/realdata/FY09_EDU_Recipients_by_State.csv
sql2csv \-\-db \(dqpostgresql:///recipients\(dq \-\-query \(dqselect * from fy09 where \e\(dqState Name\e\(dq != \(aq\(aq order by fy09.\e\(dqTOTAL\e\(dq limit 3\(dq
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
حتی می‌توانید از آن به عنوان یک ماشین‌حساب ساده SQL استفاده کنید (در این مثال، یک پایگاه‌داده SQLite در حافظه به‌صورت پیش‌فرض استفاده می‌شود):
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
sql2csv \-\-query \(dqselect 300 * 47 % 14 * 27 + 7000\(dq
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
رشته اتصال \fI\%پارامترها را می‌پذیرد\fP\&. برای نمونه، جهت تنظیم کدگذاری یک پایگاه‌داده MySQL:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
sql2csv \-\-db \(aqmysql://user:pass@host/database?charset=utf8\(aq \-\-query \(dqSELECT myfield FROM mytable\(dq
.ft P
.fi
.UNINDENT
.UNINDENT
.SH "نویسنده (AUTHOR)"
Christopher Groskopf و مشارکت‌کنندگان
.SH "حق نشر (COPYRIGHT)"
2016, Christopher Groskopf and James McKinney
.\" Generated by docutils manpage writer.
.