roqet(1) General Commands Manual roqet(1) نام (NAME) roqet - ابزار پرس‌وجوی RDF در Rasqal خلاصه دستور (SYNOPSIS) roqet [OPTIONS] [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 همچنین ببینید (SEE ALSO) librasqal(3), libraptor(3) تغییرات (CHANGES) نویسنده (AUTHOR) Dave Beckett - http://www.dajobe.org 2013-12-11 roqet(1)