نام (NAME)

roqet - ابزار پرس‌وجوی RDF در Rasqal

خلاصه دستور (SYNOPSIS)

roqet [OPTIONS] <query-URI> [base-URI]
roqet [OPTIONS]-e query-string [base-URI]
roqet [OPTIONS]-p sparql-protocol-service-URI query-URI [base-URI]
roqet [OPTIONS]-p sparql-protocol-service-URI [-e query-string ] [base-URI]
roqet [OPTIONS]-t query results file [base-URI]

توضیحات (DESCRIPTION)

ابزار roqet امکان پرس‌وجو از محتوای RDF را با استفاده از کتابخانه پرس‌وجوی RDF به نام Rasqal فراهم می‌کند و نتایج مقیدسازی‌های متغیر (variable bindings)، گراف RDF یا نتایج بولی (boolean) را در قالب‌های گوناگون چاپ می‌نماید. پرس‌وجو از query-URI خوانده می‌شود و در صورت وجود، base-URI اختیاری به عنوان URI پایه پرس‌وجو به کار می‌رود.

گزینه‌های اصلی (MAIN OPTIONS)

دستور roqet از نحو استاندارد خط فرمان GNU پیروی می‌کند که در آن در صورت پشتیبانی توسط تابع getopt_long، گزینه‌های طولانی با دو خط تیره (`-') آغاز می‌شوند. در غیر این صورت، تنها گزینه‌های کوتاه در دسترس خواهند بود.

-e, --exec QUERY: رشته پرس‌وجوی ارائه‌شده در آرگومان QUERY را اجرا می‌کند، به‌جای آنکه پرس‌وجو از یک URI خوانده شود (حالتی که در آن -e / --exec مشخص نشده باشد).
-i, --input LANGUAGE: زبان پرس‌وجوی ورودی LANGUAGE را روی یکی از زبان‌های پشتیبانی‌شده تنظیم می‌کند که شامل 'sparql' (زبان پرس‌وجوی SPARQL برای RDF، پیش‌فرض)، 'sparql11' و 'laqrs' است. فهرست کامل زبان‌ها و زیرمجموعه‌های پشتیبانی‌شده در خلاصه راهنما به همراه گزینه -h / --help ارائه شده است.
-p, --protocol SERVICE-URI: پروتکل SPARQL HTTP در SERVICE-URI را برای اجرای پرس‌وجو فراخوانی می‌کند، به‌جای آنکه آن را به صورت محلی در موتور پرس‌وجوی Rasqal اجرا نماید (زمانی که -e داده شده باشد، یا یک رشته پرس‌وجو مشخص شده باشد).
-r, --results FORMAT: قالب خروجی نتایج پرس‌وجو FORMAT را تعیین می‌کند.

: برای مقیدسازی متغیرها، مقادیر FORMAT بسته به موارد پشتیبانی‌شده در Rasqal متفاوت است، اما شامل 'simple' برای یک قالب متنی ساده (پیش‌فرض)، 'xml' برای قالب XML نتایج پرس‌وجوی SPARQL، و 'csv' برای SPARQL CSV، و 'tsv' برای SPARQL TSV، و 'rdfxml' و 'turtle' برای قالب‌های نحوی RDF، و همچنین 'json' برای نسخه JSON نتایج می‌باشد.
: برای نتایج گراف RDF، مقادیر FORMAT عبارتند از 'ntriples' (قالب N-Triples، پیش‌فرض)، 'rdfxml-abbrev' (قالب RDF/XML مختصر)، 'rdfxml' (قالب RDF/XML)، 'turtle' (قالب Turtle)، 'json' (قالب منبع‌محور RDF/JSON)، 'json-triples' (سه‌تایی‌های RDF/JSON) یا 'rss-1.0' (قالب RSS 1.0 که یک نحو RDF/XML نیز هست).
: فهرست دقیق قالب‌ها بستگی به این دارد که libraptor2(3) با چه گزینه‌هایی کامپایل شده باشد، اما فهرست صحیح آن در پیام راهنمای کاربری با -h آورده شده است.

-R, --results-input-format FORMAT: قالب ورودی نتایج پرس‌وجو FORMAT را تعیین می‌کند.

: این گزینه برای استفاده به همراه -t است و مقادیر 'xml' برای قالب XML نتایج پرس‌وجوی SPARQL، و 'csv' برای SPARQL CSV، و 'tsv' برای SPARQL TSV، و همچنین 'turtle' و 'rdfxml' برای قالب‌های نحوی RDF را می‌پذیرد.

-t, --results-input FILE: نتایج پرس‌وجو را از FILE می‌خواند.

سایر گزینه‌ها (OTHER OPTIONS)

-c, --count: تنها سه‌تایی‌ها (triples) را می‌شمارد و هیچ خروجی دیگری تولید نمی‌کند.
-d, --dump-query FORMAT: پرس‌وجوی تحلیل‌شده را در قالب FORMAT داده‌شده چاپ می‌کند؛ یکی از مقادیر 'none' (پیش‌فرض)، 'debug'، 'structure' یا 'sparql'.
-D, --data URI: نشانی URI منبع داده RDF (غیر از یک گراف نام‌دار) را اضافه می‌کند. اگر هیچ منبع داده‌ای مشخص نشده باشد، خود پرس‌وجو باید مانند عبارات SPARQL FROM uri به داده‌ها اشاره کند.
-E, --ignore-errors: پیام‌های خطا را چاپ نمی‌کند و با وضعیت غیر صفر خارج نمی‌شود.
-f, --feature NAME(=VALUE): ویژگی پرس‌وجوی NAME را روی VALUE تنظیم می‌کند، یا در صورت عدم ذکر مقدار، عدد صحیح 1 را برای آن در نظر می‌گیرد. ویژگی‌های شناخته‌شده را می‌توان با -f help یا --feature help مشاهده کرد.
-F, --format NAME: قالب منبع داده name را برای گراف‌های داده بعدی که با -D / --data یا -G / --named فراخوانی می‌شوند تعیین می‌کند. در صورت مشخص نشدن، پیش‌فرض موتور پرس‌وجو حدس زدن قالب است. مقدار name نام یکی از تجزیه‌کننده‌های Raptor است.
-G, --named URI: نشانی URI منبع داده RDF (گراف نام‌دار) را اضافه می‌کند.
-h, --help: خلاصه‌ای از گزینه‌ها را نمایش می‌دهد.
-n, --dryrun: پرس‌وجو را آماده‌سازی می‌کند اما آن را اجرا نمی‌نماید.
-q, --quiet: از نمایش پیام‌های اطلاعاتی اضافی جلوگیری می‌کند.
-s, --source URI: نشانی URI منبع داده RDF (گراف نام‌دار) URI را با افزودن آن به فهرست URIهای منبع داده پرس‌وجو اضافه می‌کند. FORMAT را به 'simple' (پیش‌فرض) یا 'xml' (یک قالب آزمایشی XML) تغییر می‌دهد.
-v, --version: نسخه کتابخانه rasqal را چاپ کرده و خارج می‌شود.
-W, --warnings LEVEL: سطح هشدار LEVEL را در بازه 0 (عدم نمایش هیچ هشداری) تا 100 (نمایش تمام هشدارها) تنظیم می‌کند. مقدار پیش‌فرض Rasqal در میانه این بازه (50) است.

مثال‌ها (EXAMPLES)

: roqet sparql-query-file.rq

اجرای یک پرس‌وجوی SPARQL موجود در فایل محلی sparql-query-file.rq. داده‌های مورد استفاده در عبارت‌های FROM درون فایل پرس‌وجو توصیف خواهند شد.

: roqet -q -i sparql http://example.org/sparql-query.rq

اجرای یک پرس‌وجوی SPARQL واقع در وب در نشانی URI http://example.org/sparql-query.rq بدون پیام‌های اضافی (حالت بی‌صدا، -q).

: roqet -q query-file.rq http://example.org/base

اجرای یک پرس‌وجو (با زبان پیش‌فرض SPARQL) از یک فایل محلی query-file.rq اما با استفاده از URI پایه http://example.org/base جهت تفکیک هرگونه URI نسبی.

: roqet -q -i sparql -r xml http://example.org/sparql-query.rq

اجرای یک پرس‌وجوی SPARQL واقع در وب در نشانی URI http://example.org/sparql-query.rq و قالب‌بندی نتایج در قالب SPARQL Query Results XML بدون پیام‌های اضافی.

: roqet -i sparql -e 'SELECT * WHERE { ?s ?p ?o }' -D stuff.rdf

اجرای یک پرس‌وجوی SPARQL مشخص‌شده در خط فرمان بر روی داده‌های موجود در فایل stuff.rdf. نوع فایل حدس زده خواهد شد و احتمالاً از نوع RDF/XML است.

: roqet -t result.srx -r html

خواندن نتایج یک پرس‌وجوی SPARQL در قالب SPARQL Query Results XML (پیش‌فرض) و چاپ آن به صورت HTML.

: roqet -t result.ttl -R turtle -r csv

خواندن نتایج یک پرس‌وجوی SPARQL در قالب RDF/Turtle و چاپ آن به صورت CSV.

سازگاری با استانداردها (CONFORMING TO)

SPARQL 1.1 Query Language، Steve Harris و Andy Seaborne (ویراستاران)، توصیه‌نامه W3C،‏ ۲۱ مارس ۲۰۱۳ http://www.w3.org/TR/2013/REC-sparql11-query-20130321

SPARQL Query Results XML Format (Second Edition)، Sandro Hawke (ویراستار ویرایش دوم)، Jeen Broekstra و Dave Beckett (ویراستاران)، توصیه‌نامه W3C،‏ ۲۱ مارس ۲۰۱۳. http://www.w3.org/TR/2013/REC-rdf-sparql-XMLres-20130321