'\" t
.\"     Title: tinysparql-sql
.\"    Author: The TinySPARQL developers
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 04/15/2026
.\"    Manual: TinySPARQL manual
.\"    Source: \ \& 3.11.1
.\"  Language: English
.\"
.TH "TINYSPARQL\-SQL" "1" "04/15/2026" "\ \& 3\&.11\&.1" "TinySPARQL manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
tinysparql-sql \- استفاده از SQL برای پرس‌وجو در پایگاه‌های دادهٔ TinySPARQL\&.
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
tinysparql sql \-q <sql> | \-f <file>
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
این دستور امکان کاوش و بررسی پایگاه دادهٔ جاری را فراهم می‌کند\&. هنگام استفاده از دستورهایی مانند \fBtinysparql sparql\fR، عبارت SPARQL استفاده‌شده پیش از اجرا روی پایگاه داده به SQL ترجمه می‌شود\&. این امر امکان استفادهٔ مستقیم از پایگاه داده با SQL را بدون نیاز به موتور SPARQL میسر می‌سازد\&.
.sp
کاربر می‌تواند پرس‌وجو را به دو روش اجرا کند؛ با ارائهٔ یک \fIfile\fR حاوی پرس‌وجو یا با ارسال یک رشته به همراه پرس‌وجوی \fIsql\fR\&.
.sp
آرگومان \fIfile\fR می‌تواند یک مسیر محلی یا یک URI باشد\&. همچنین لزومی ندارد که این مسیر حتماً مطلق باشد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-f, \-\-file=<\fR\fB\fIfile\fR\fR\fB>\fR
.RS 4
استفاده از یک
\fIfile\fR
با محتوای SPARQL برای اجرای پرس‌وجو\&. فراموش نکنید که تمام پرس‌وجوها باید با نقطه‌ویرگول (;) خاتمه یابند و اطراف نام جدول‌ها نیز از نقل‌قول استفاده شود\&. این نقل‌قول‌ها از این رو حائز اهمیت هستند که بیشتر جدول‌ها بر اساس کلاس‌های هستی‌شناسی (ontology) مانند "nfo:Document" نام‌گذاری شده‌اند و پرس‌وجوها بدون استفاده از نقل‌قول با خطا مواجه خواهند شد\&.
.RE
.PP
\fB\-q, \-\-query=<\fR\fB\fIsql\fR\fR\fB>\fR
.RS 4
استفاده از یک رشتهٔ
\fIsql\fR
برای پرس‌وجو از پایگاه داده\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
نمایش ۱۰ ورودی نخست "nfo:Document" که در آن‌ها TOC برابر با NULL نیست
.RS 4
.sp
.if n \{\
.RS 4
.\}
.nf
$ tinysparql sql \-q \*(AqSELECT * FROM "nfo:Document" WHERE "nfo:tableOfContents" NOT NULL LIMIT 10;\*(Aq
.fi
.if n \{\
.RE
.\}
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBtinysparql\-sparql\fR(1), \fBtinysparql\-info\fR(1)\&.
.sp
\fBhttp://en\&.wikipedia\&.org/wiki/SQL\fR