TINYSPARQL-QUERY(1) TinySPARQL manual TINYSPARQL-QUERY(1)

tinysparql-query - ارسال پرس‌وجو به اندپوینت‌های SPARQL.

tinysparql query [(-d |--database) <file> | (-b | --dbus-service) <busname> | (-r | --remote-service) <url>]
    (-f | --file) <file>] [(-u | --update)] [-a <parameter>:<value>]... [SPARQL]

این دستور امکان اجرای پرس‌وجوها یا به‌روزرسانی‌ها را روی یک اندپوینت SPARQL فراهم می‌کند.

هنگامی که فراخواننده یک پرس‌وجو را اجرا می‌کند، پرس‌وجو به زبان SPARQL است. این کار می‌تواند به دو روش انجام شود؛ چه با ارائه یک file حاوی پرس‌وجو، چه با ارائه یک رشته حاوی پرس‌وجوی sparql.

آرگومان file می‌تواند یک مسیر محلی یا یک شناسه URI باشد. همچنین لزومی ندارد که یک مسیر مطلق باشد.

-b, --dbus-service=<service_name>

اتصال به یک اندپوینت SPARQL با نام D-Bus مشخص‌شده.

-d, --database-path=<database_path>

اتصال به یک پایگاه‌داده از طریق مکان آن در سیستم‌فایل.

-r, --remote-service=<url>

اتصال به یک اندپوینت HTTP SPARQL.

-f, --file=<file>

استفاده از یک file با محتوای SPARQL برای پرس‌وجو یا به‌روزرسانی.

-u, --update

این گزینه باید همراه با --query استفاده شود. این گزینه به "tinysparql query" می‌گوید که از افزونه‌های به‌روزرسانی SPARQL استفاده کند تا متوجه شود که این درخواست یک درخواست معمولی جستجوی داده نیست. بنابراین اگر پرس‌وجوی شما به منظور تغییر داده‌ها در پایگاه‌داده است، به این گزینه نیاز است.

-a, --arg=<parameter>:<value>

یک آرگومان برای یک پارامتر اعلام‌شده در رشته پرس‌وجوی SPARQL ارائه می‌دهد. این گزینه ممکن است با --file، --query یا --update استفاده شود. برای چندین پارامتر می‌توان چندین آرگومان ارائه کرد. مقادیر آرگومان به صورت یک رشته جداشده با دونقطه شامل ۳ مقدار ارائه می‌شوند: نام، نوع و مقدار. نام همان نام استفاده‌شده در رشته پرس‌وجو است، مقدار همان مقدار مورد نظر است، و نوع یک رشته تک‌نویسه‌ای است که نوع را تعریف می‌کند:
•i: مقدار یک عدد صحیح را توصیف می‌کند
•d: مقدار یک عدد ممیز شناور را توصیف می‌کند
•b: مقدار یک مقدار بولی را توصیف می‌کند
•s: مقدار یک رشته متنی ساده را توصیف می‌کند

پرس‌وجو از یک اندپوینت D-Bus

$ tinysparql query --dbus-service org.example.Endpoint "SELECT ('Hello World' AS ?str) {}"

به‌روزرسانی مستقیم پایگاه‌داده از روی یک پرس‌وجو در یک فایل

$ tinysparql query --database /tmp/db/ --update --file ./update.rq

استفاده از --arg برای ارائه آرگومان‌ها به پارامترهای پرس‌وجو

$ tinysparql query -b org.example.Endpoint \
    -a name:s:"John" -a age:i:42 -a available:b:true \
    "SELECT (~name AS ?name) (~age AS ?age) (~available AS ?avail) { }"

tinysparql-endpoint(1).

https://gnome.pages.gitlab.gnome.org/tinysparql/tutorial.html

04/15/2026   3.11.1