You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@jena.apache.org by "VladimirAlexiev (via GitHub)" <gi...@apache.org> on 2024/04/11 06:23:27 UTC
[I] improve arq command line documentation [jena]
VladimirAlexiev opened a new issue, #2411:
URL: https://github.com/apache/jena/issues/2411
### Version
4.5.0
### Feature
arq --data=<file> --query=<query>
Control
--explain Explain and log query execution
--repeat=N or N,M Do N times or N warmup and then M times (use for timing to overcome start up costs of Java)
--optimize= Turn the query optimizer on or off (default: on)
Time
--time Time the operation
Query Engine
--engine=EngineName Register another engine factory[ref]
--unengine=EngineName Unregister an engine factory
Dataset
--data=FILE Data for the dataset - triple or quad formats
--graph=FILE Graph for default graph of the datset
--namedGraph=FILE Add a graph into the dataset as a named graph
Results
--results= Results format (Result set: text, XML, JSON, CSV, TSV; Graph: RDF serialization)
--desc= Assembler description file
Query
--query, --file File containing a query
--syntax, --in Syntax of the query
--base Base URI for the query
Symbol definition
--set Set a configuration symbol to a value
General
-v --verbose Verbose
-q --quiet Run with minimal output
--debug Output information for debugging
--help
--version Version information
--strict Operate in strict SPARQL mode (no extensions of any kind)
VERSION: 4.5.0
Jena: VERSION: 4.5.0
Jena: BUILD_DATE: 2022-05-01T13:58:04Z
https://jena.apache.org/documentation/query/cmds.html#arqquery
datset
### Are you interested in contributing a solution yourself?
None
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@jena.apache.org.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@jena.apache.org
For additional commands, e-mail: issues-help@jena.apache.org
Re: [I] improve arq command line documentation [jena]
Posted by "ebremer (via GitHub)" <gi...@apache.org>.
ebremer commented on issue #2411:
URL: https://github.com/apache/jena/issues/2411#issuecomment-2902466866
@VladimirAlexiev I'm putting a pull request to update ```arq --help``` https://github.com/apache/jena/pull/3216
*** clarify that --data can be used multiple times, and whether the other Dataset options can
clarified in PR. --data can be used multiple times
*** clarify whether FILE can be a URL (http, https)
can also be a URL (http/https) in ```--data``` and ```--graph``` but not in ```--namedGraph```. It may be useful to augment ```--namedGraph``` to be able to use URL.
*** fix spelling of datset in --graph
fixed in PR
*** if the FILE in --graph and --namedGraph is in quad format, is the graph part of FILE removed?
```--namedGraph``` and ``--graph``` will have their quads ignored. riot will report "Only triples or default graph data expected : named graph data ignored". In my testing, if both options are used, the remaining triples will be merged into one graph.
*** if the FILE in --graph is in triple format, what is the difference from --data?
```--graph``` will ignore quads and merge it with the triples of ```--data``` or its default graph if ```--data``` is quads.
*** if the FILE in --namedGraph is in triple format, is the name/URL of FILE used as the graph name?
no, the path is dropped and only the file name is used. "/dir1/dir2/mydata.ttl" becomes <mydata.ttl> as the named graph name.
*** move --desc to the Dataset section because it concerns input
I can't say I entirely disagree with this. However, "Dataset" section seems to be reserved for just raw data. ``--desc``` assembler file does more than just raw data. I defer @afs on this.
*** describe --desc better
*** https://jena.apache.org/documentation/query/cmds.html#arqquery is much poorer it should be brought in line with the command line help.
I don't mind contributing more to the documentation, but I've never used Jena assembler files before, but I will glance at a manual.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@jena.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@jena.apache.org
For additional commands, e-mail: issues-help@jena.apache.org
Re: [I] improve arq command line documentation [jena]
Posted by "VladimirAlexiev (via GitHub)" <gi...@apache.org>.
VladimirAlexiev commented on issue #2411:
URL: https://github.com/apache/jena/issues/2411#issuecomment-2902709354
The last comment applies to all of the cited doc page, not only about `--desc`
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@jena.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@jena.apache.org
For additional commands, e-mail: issues-help@jena.apache.org
Re: [I] improve arq command line documentation [jena]
Posted by "arne-bdt (via GitHub)" <gi...@apache.org>.
arne-bdt closed issue #2411: improve arq command line documentation
URL: https://github.com/apache/jena/issues/2411
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@jena.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@jena.apache.org
For additional commands, e-mail: issues-help@jena.apache.org
Re: [I] improve arq command line documentation [jena]
Posted by "ebremer (via GitHub)" <gi...@apache.org>.
ebremer commented on issue #2411:
URL: https://github.com/apache/jena/issues/2411#issuecomment-2904458279
@VladimirAlexiev Understood.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@jena.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@jena.apache.org
For additional commands, e-mail: issues-help@jena.apache.org