doc/test/comunica

TEST comunica

сравнения rdfLib
https://github.com/comunica/comunica/ github.io: https://comunica.github.io/comunica/

Base docs

Базовые из comunica.dev:

• DOC /query_app
• Comunica Browser
• Версия 2.0.0 , отличия от 1.0

@comunica/query-sparql-file

обратный отсчет

4) Trig

То же самое, что в п.3 только не turtle, а TriG (файл proc1.trig), т.е. фактически меняем запрос sparql-file_local_trig.mjs:

 SELECT ?s ?p ?o ?g  
    WHERE {  
    GRAPH ?g {         
      ?s ?p <http://example.org/p1.3>.  
      ?s ?p ?o  
    }  
  }

В sparql-file_local_trig_all.mjs вывод всего содержимого TriG.
Также см. приемер с graph (quad): https://github.com/comunica/comunica/issues/1223

3) JS query-sparql-file (local file)

sparql-file_local.mjs делает SPARQL запрос к file.ttl (file2.ttl и т.д.) и выводит результат:

{  
  "s": "http://example.org/subject3",
  "p": "http://example.org/predicate3",
  "o": "http://example.org/object3"
}
true
http://example.org/subject3
NamedNode
http://example.org/predicate3
http://example.org/object3

Без FILTER(?o = <http://example.org/object3>) выдавало ошибку: TypeError: Cannot read properties of undefined (reading 'value'), потому что (ИИ):

• В SPARQL-запросе вы ищете триплеты, где объект (?o) равен <h ttp://example.org/object3>. Однако в коде вы пытаетесь вывести значение ?o с помощью binding.get('o').value, хотя ?o в данном случае является константой (не переменной) и не будет присутствовать в результирующих привязках (bindings). SPARQL-запрос возвращает только переменные, указанные в SELECT. В вашем случае это ?s и ?p, так как ?o заменён на конкретное значение <h ttp://example.org/object3>.
• Когда вы вызываете binding.get('o'), вы пытаетесь получить значение переменной ?o, которой нет в результатах, потому что она была заменена на константу. Это приводит к ошибке, так как binding.get('o') возвращает undefined, и попытка обратиться к свойству value у undefined вызывает ошибку.
• Если вы хотите вывести значение объекта, которое вы ищете (в данном случае <h ttp://example.org/object3>), вам нужно либо явно указать его в коде (вывести вручную), либо изменить запрос, чтобы ?o оставался переменной. Вручную, это так:

bindingsStream.on('data', (binding) => {
    console.log(binding.toString()); // Quick way to print bindings for testing

    console.log(binding.has('s')); // Will be true

    // Obtaining values
    console.log(binding.get('s').value);
    console.log(binding.get('s').termType);
    console.log(binding.get('p').value);
    console.log('http://example.org/object3'); // Выводим объект вручную
});

Второй вариант - ИИ предложил через FILTER, см sparql-file_local.mjs
Третий вариант, см. sparql-file_local1.mjs
В исходном примере comunica добавляет вниз запроса ?s ?p ?o видимо чтобы как раз и дать значение перемененой:
?s ?p <http://example.org/object3>.
?s ?p ?o

2) JS query-sparql-file (SPARQL endpoint)

https://www.npmjs.com/package/@comunica/query-sparql-file (Usage within application)
Не заработал, см. исходный файл /sparql_file/sparql-file1_no.js
Поправил:

1. Ругается на await , пишут, что нужно переписать в ESM. Переписал см. require-vs-import
2. Хоть @comunica/query-sparql-file был установлен глобально (см. Установку CLI query-sparql-file ниже), но заработало только после:
   npm install @comunica/query-sparql-file
3. Весь нижний блок // Consume results as an array (easier) закоментировал, т.к. на bindings[0].get тоже ошибка.
   В итоге /sparql_file/sparql-file1.mjs ошибок не выдает, но и результата тоже (нужно далее разбираться).

1) CLI query-sparql-file

https://github.com/comunica/comunica/tree/master/engines/query-sparql-file#readme
https://comunica.dev/docs/query/getting_started/query_cli_file/
https://www.npmjs.com/package/@comunica/query-sparql-file

cd C:\Temp1\comunica\
npm install -g @comunica/query-sparql-file
отступление
вообще, npm install -g можно из любой папки (global).
Т.е. установить пакет в глобальную общую папку node_modules (там, где находится node). Это позволит получить доступ к модулю из командной строки, поскольку папка bin имеет ссылку в PATH:
Users\user\AppData\Roaming\npm
C:\Users\user\AppData\Roaming\npm\comunica-sparql-file-http.cmd
C:\Users\user\AppData\Roaming\npm\node_modules\@comunica\query-sparql-file\
Сам node C:\Program Files\nodejs\node.exe
продолжение
Для использования --query ; --file см.: comunica-sparql-file --help
test

1. remote FOAF profile
   comunica-sparql-file https://ruben.verborgh.org/profile/#me "CONSTRUCT WHERE { ?s ?p ?o } LIMIT 100"
   (из любой папки)
2. remote RDF file, наш SemanticBPM/samples/vad_1/vad_1.ttl
   comunica-sparql-file https://bpmbpm.github.io/SemanticBPM/samples/vad_1/vad_1.ttl "CONSTRUCT WHERE { ?s ?p ?o } LIMIT 100"
   Не путать с comunica-sparql-file https://github.com/bpmbpm/SemanticBPM/blob/main/samples/vad_1/vad_1.ttl "CONSTRUCT WHERE { ?s ?p ?o } LIMIT 100"
   (node:18208) MaxListenersExceededWarning: обнаружена возможная утечка памяти EventEmitter.
   т.е. нужен Github Pages https://bpmbpm.github.io/SemanticBPM/samples/vad_1/vad_1.ttl
3. local RDF file, тот же, но сохраняем файл vad_1.ttl в локальную папку:
   comunica-sparql-file vad_1.ttl "CONSTRUCT WHERE { ?s ?p ?o } LIMIT 100"

Дополнительно:

Comunica N3 RDF Serialize Actor

An RDF Serialize actor that handles Turtle, TriG, N-Quads, N-Triples and N3 using N3.js. https://www.npmjs.com/package/@comunica/actor-rdf-serialize-n3?activeTab=readme

FAQ

local file system

Как выполнить запрос к RDF-файлу в локальной файловой системе?
Вместо использования Comunica SPARQL вы можете использовать Comunica SPARQL File для запроса файлов в локальной файловой системе.
Comunica SPARQL по умолчанию не позволяет выполнять запросы к локальному файлу из соображений безопасности.

bindingsStreamи quadStream

const quadStream = await myEngine.queryQuads(CONSTRUCT ..., {...});

Подробнее

• Объекты Bindings
• 5.1 quadStream

Другое

Data Flow схема

Продолжение