NAME¶
RDF::Query::Plan::Service - Executable query plan for remote SPARQL queries.
VERSION¶
This document describes RDF::Query::Plan::Service version 2.912.
METHODS¶
Beyond the methods documented below, this class inherits methods from the
RDF::Query::Plan class.
- "new ( $endpoint, $plan, $silent, $sparql, [ \%logging_keys ]
)"
- Returns a new SERVICE (remote endpoint call) query plan object.
"<$endpoint"> is the URL of the endpoint (as a node
object). "<$plan"> is the query plan representing the
query to be sent to the remote endpoint (needed for cost estimates).
"<$sparql"> is the serialized SPARQL query to be sent to
the remote endpoint. Finally, if present,
"<%logging_keys"> is a HASH containing the keys to use in
logging the execution of this plan. Valid HASH keys are:
* bf - The bound/free string representing C<<$plan>>
- "new_from_plan ( $endpoint, $plan, $context )"
- Returns a new SERVICE query plan object. "<$endpoint"> is
the URL of the endpoint (as a string). "<$plan"> is the
query plan representing the query to be sent to the remote endpoint. The
exact SPARQL serialization that will be used is obtained by getting the
originating RDF::Query::Algebra object from "<$plan">, and
serializing it (with the aid of the RDF::Query::ExecutionContext object
"<$context">).
- "execute ( $execution_context )"
- "next"
- "close"
- "endpoint"
- "sparql"
- Returns the SPARQL query (as a string) that will be sent to the remote
endpoint.
- "lhs"
- "silent"
- Returns a boolean value indicating whether the service plan will ignore
errors.
- "pattern"
- Returns the query plan that will be used in the remote service call.
- "distinct"
- Returns true if the pattern is guaranteed to return distinct results.
- "ordered"
- Returns true if the pattern is guaranteed to return ordered results.
- "plan_node_name"
- Returns the string name of this plan node, suitable for use in
serialization.
- "plan_prototype"
- Returns a list of scalar identifiers for the type of the content
(children) nodes of this plan node. See RDF::Query::Plan for a list of the
allowable identifiers.
- "plan_node_data"
- Returns the data for this plan node that corresponds to the values
described by the signature returned by "plan_prototype".
- "graph ( $g )"
- "explain"
- Returns a string serialization of the query plan appropriate for display
on the command line.
AUTHOR¶
Gregory Todd Williams <gwilliams@cpan.org>