'\" t
.\"     Title: tinysparql-query
.\"    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: Persian
.\"
.TH "TINYSPARQL\-QUERY" "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\-query \- ارسال پرس‌وجو به اندپوینت‌های SPARQL\&.
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
tinysparql query [(\-d |\-\-database) <file> | (\-b | \-\-dbus\-service) <busname> | (\-r | \-\-remote\-service) <url>]
    (\-f | \-\-file) <file>] [(\-u | \-\-update)] [\-a <parameter>:<value>]\&.\&.\&. [SPARQL]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
این دستور امکان اجرای پرس‌وجوها یا به‌روزرسانی‌ها را روی یک اندپوینت SPARQL فراهم می‌کند\&.
.sp
هنگامی که فراخواننده یک پرس‌وجو را اجرا می‌کند، پرس‌وجو به زبان SPARQL است\&. این کار می‌تواند به دو روش انجام شود؛ چه با ارائه یک \fIfile\fR حاوی پرس‌وجو، چه با ارائه یک رشته حاوی پرس‌وجوی \fIsparql\fR\&.
.sp
آرگومان \fIfile\fR می‌تواند یک مسیر محلی یا یک شناسه URI باشد\&. همچنین لزومی ندارد که یک مسیر مطلق باشد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-b, \-\-dbus\-service=<\fR\fB\fIservice_name\fR\fR\fB>\fR
.RS 4
اتصال به یک اندپوینت SPARQL با نام D\-Bus مشخص‌شده\&.
.RE
.PP
\fB\-d, \-\-database\-path=<\fR\fB\fIdatabase_path\fR\fR\fB>\fR
.RS 4
اتصال به یک پایگاه‌داده از طریق مکان آن در سیستم‌فایل\&.
.RE
.PP
\fB\-r, \-\-remote\-service=<\fR\fB\fIurl\fR\fR\fB>\fR
.RS 4
اتصال به یک اندپوینت HTTP SPARQL\&.
.RE
.PP
\fB\-f, \-\-file=<\fR\fB\fIfile\fR\fR\fB>\fR
.RS 4
استفاده از یک
\fIfile\fR
با محتوای SPARQL برای پرس‌وجو یا به‌روزرسانی\&.
.RE
.PP
\fB\-u, \-\-update\fR
.RS 4
این گزینه باید همراه با
\fB\-\-query\fR
استفاده شود\&. این گزینه به "tinysparql query" می‌گوید که از افزونه‌های به‌روزرسانی SPARQL استفاده کند تا متوجه شود که این درخواست یک درخواست معمولی جستجوی داده نیست\&. بنابراین اگر پرس‌وجوی شما به منظور تغییر داده‌ها در پایگاه‌داده است، به این گزینه نیاز است\&.
.RE
.PP
\fB\-a, \-\-arg=<\fR\fB\fIparameter\fR\fR\fB>:<\fR\fB\fIvalue\fR\fR\fB>\fR
.RS 4
یک آرگومان برای یک پارامتر اعلام‌شده در رشته پرس‌وجوی SPARQL ارائه می‌دهد\&. این گزینه ممکن است با
\fB\-\-file\fR،
\fB\-\-query\fR
یا
\fB\-\-update\fR
استفاده شود\&. برای چندین پارامتر می‌توان چندین آرگومان ارائه کرد\&. مقادیر آرگومان به صورت یک رشته جداشده با دونقطه شامل ۳ مقدار ارائه می‌شوند: نام، نوع و مقدار\&. نام همان نام استفاده‌شده در رشته پرس‌وجو است، مقدار همان مقدار مورد نظر است، و نوع یک رشته تک‌نویسه‌ای است که نوع را تعریف می‌کند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBi\fR: مقدار یک عدد صحیح را توصیف می‌کند
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBd\fR: مقدار یک عدد ممیز شناور را توصیف می‌کند
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBb\fR: مقدار یک مقدار بولی را توصیف می‌کند
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBs\fR: مقدار یک رشته متنی ساده را توصیف می‌کند
.RE
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
پرس‌وجو از یک اندپوینت D\-Bus
.RS 4
.sp
.if n \{\
.RS 4
.\}
.nf
$ tinysparql query \-\-dbus\-service org\&.example\&.Endpoint "SELECT (\*(AqHello World\*(Aq AS ?str) {}"
.fi
.if n \{\
.RE
.\}
.RE
.PP
به‌روزرسانی مستقیم پایگاه‌داده از روی یک پرس‌وجو در یک فایل
.RS 4
.sp
.if n \{\
.RS 4
.\}
.nf
$ tinysparql query \-\-database /tmp/db/ \-\-update \-\-file \&./update\&.rq
.fi
.if n \{\
.RE
.\}
.RE
.PP
استفاده از \fB\-\-arg\fR برای ارائه آرگومان‌ها به پارامترهای پرس‌وجو
.RS 4
.sp
.if n \{\
.RS 4
.\}
.nf
$ tinysparql query \-b org\&.example\&.Endpoint \e
    \-a name:s:"John" \-a age:i:42 \-a available:b:true \e
    "SELECT (~name AS ?name) (~age AS ?age) (~available AS ?avail) { }"
.fi
.if n \{\
.RE
.\}
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBtinysparql\-endpoint\fR(1)\&.
.sp
https://gnome\&.pages\&.gitlab\&.gnome\&.org/tinysparql/tutorial\&.html