Class QuerySourceSparql

constructor

• new QuerySourceSparql(
      url: string,
      context: IActionContext,
      mediatorHttp: MediatorHttp,
      bindMethod: BindMethod,
      dataFactory: ComunicaDataFactory,
      algebraFactory: Factory,
      bindingsFactory: BindingsFactory,
      forceHttpGet: boolean,
      cacheSize: number,
      countTimeout: number,
      cardinalityCountQueries: boolean,
      cardinalityEstimateConstruction: boolean,
      defaultGraph?: string,
      unionDefaultGraph?: boolean,
      datasets?: IDataset[],
  ): QuerySourceSparql

  Parameters

  • url: string
  • context: IActionContext
  • mediatorHttp: MediatorHttp
  • bindMethod: BindMethod
  • dataFactory: ComunicaDataFactory
  • algebraFactory: Factory
  • bindingsFactory: BindingsFactory
  • forceHttpGet: boolean
  • cacheSize: number
  • countTimeout: number
  • cardinalityCountQueries: boolean
  • cardinalityEstimateConstruction: boolean
  • OptionaldefaultGraph: string
  • OptionalunionDefaultGraph: boolean
  • Optionaldatasets: IDataset[]

  Returns QuerySourceSparql

ReadonlyreferenceValue

estimateOperationCardinality

• estimateOperationCardinality(
      operation: Operation,
  ): Promise<QueryResultCardinality>

  Performs local cardinality estimation for the specified SPARQL algebra operation, which should result in better estimation performance at the expense of accuracy.

  Parameters

  • operation: Operation

    A query operation.

  Returns Promise<QueryResultCardinality>

getSelectorShape

• getSelectorShape(): Promise<FragmentSelectorShape>

  Get the selector type that is supported by this source.

  Returns Promise<FragmentSelectorShape>

operationToNormalizedCountQuery

• operationToNormalizedCountQuery(operation: Operation): string

  Convert an algebra operation into a query string, and if the operation is a simple triple pattern, then also replace any variables with s, p, and o to increase the chance of cache hits.

  Parameters

  • operation: Operation

    The operation to convert into a query string.

  Returns string

  Query string for a COUNT query over the operation.

queryBindings

• queryBindings(
      operationIn: Operation,
      context: IActionContext,
      options?: IQueryBindingsOptions,
  ): BindingsStream

  Returns a (possibly lazy) stream that returns all bindings matching the operation.

  Passed operations MUST conform to the query shape exposed by the selector type returned from getSelectorShape. The given operation represents a Linked Data Fragments selector.

  The returned stream MUST expose the property 'metadata' of type MetadataBindings. The implementor is reponsible for handling cases where 'metadata' is being called without the stream being in flow-mode. This metadata object can become invalidated (see metadata.state), in which case the 'metadata' property must and will be updated.

  Parameters

  • operationIn: Operation
  • context: IActionContext

    The query context.
  • Optionaloptions: IQueryBindingsOptions

    Options for querying bindings

  Returns BindingsStream

  The resulting bindings stream.

  See

  https://linkeddatafragments.org/specification/linked-data-fragments/#selectors

queryBindingsRemote

• queryBindingsRemote(
      endpoint: string,
      query: string,
      variables: Variable[],
      context: IActionContext,
      undefVariables: Variable[],
  ): Promise<BindingsStream>

  Send a SPARQL query to a SPARQL endpoint and retrieve its bindings as a stream.

  Parameters

  • endpoint: string

    A SPARQL endpoint URL.
  • query: string

    A SPARQL query string.
  • variables: Variable[]

    The expected variables.
  • context: IActionContext

    The source context.
  • undefVariables: Variable[]

    Variables that may have undefs.

  Returns Promise<BindingsStream>

  A stream of bindings.

queryBoolean

• queryBoolean(operation: Ask, context: IActionContext): Promise<boolean>

  Returns a promise resolving to the ask response of the given operation.

  This method should only be supported if the selector type returned from getSelectorShape supports ask queries.

  Parameters

  • operation: Ask

    The query operation to execute.
  • context: IActionContext

    The query context.

  Returns Promise<boolean>

  The resulting ask reply.

queryQuads

• queryQuads(operation: Operation, context: IActionContext): AsyncIterator<Quad>

  Returns a (possibly lazy) stream that returns all quads matching the operation.

  This method should only be supported if the selector type returned from getSelectorShape supports construct queries.

  Parameters

  • operation: Operation

    The query operation to execute.
  • context: IActionContext

    The query context.

  Returns AsyncIterator<Quad>

  The resulting quads stream.

queryVoid

• queryVoid(operation: Update, context: IActionContext): Promise<void>

  Returns a promise resolving when the given update operation succeeds.

  This method should only be supported if the selector type returned from getSelectorShape supports update queries.

  Parameters

  • operation: Update

    The query operation to execute.
  • context: IActionContext

    The query context.

  Returns Promise<void>

  The void response.

toString

• toString(): string

  Returns a string representation of this source.

  Returns string

StaticaddBindingsToOperation

• addBindingsToOperation(
      algebraFactory: Factory,
      bindMethod: BindMethod,
      operation: Operation,
      addBindings: { bindings: BindingsStream; metadata: MetadataBindings },
  ): Promise<Operation>

  Create an operation that includes the bindings from the given bindings stream.

  Parameters

  • algebraFactory: Factory

    The algebra factory.
  • bindMethod: BindMethod

    A method for adding bindings to an operation.
  • operation: Operation

    The operation to bind to.
  • addBindings: { bindings: BindingsStream; metadata: MetadataBindings }

    The bindings to add.

    • bindings: BindingsStream

      The bindings stream.

    • metadata: MetadataBindings

      The bindings metadata.

  Returns Promise<Operation>

StaticgetOperationUndefs

• getOperationUndefs(operation: Operation): Variable[]

  Check if the given operation may produce undefined values.

  Parameters

  • operation: Operation

  Returns Variable[]

StaticoperationToCountQuery

• operationToCountQuery(
      dataFactory: ComunicaDataFactory,
      algebraFactory: Factory,
      operation: Operation,
  ): string

  Convert an operation to a count query for the number of matching triples for this pattern.

  Parameters

  • dataFactory: ComunicaDataFactory

    The data factory.
  • algebraFactory: Factory

    The algebra factory.
  • operation: Operation

    A query operation.

  Returns string

  A count query string.

StaticoperationToQuery

• operationToQuery(operation: Operation): string

  Convert an operation to a query for this pattern.

  Parameters

  • operation: Operation

    A query operation.

  Returns string

  A query string.

StaticoperationToSelectQuery

• operationToSelectQuery(
      algebraFactory: Factory,
      operation: Operation,
      variables: Variable[],
  ): string

  Convert an operation to a select query for this pattern.

  Parameters

  • algebraFactory: Factory

    The algebra factory.
  • operation: Operation

    A query operation.
  • variables: Variable[]

    The variables in scope for the operation.

  Returns string

  A select query string.