qEndpoint
Release 2.4.0
enchufe
La compañía de control de calidad sobre las redes sociales
qacompany/qendpointqacompany/qendpoint-wikidataQendpoint es una tienda triple altamente escalable con soporte de texto completo y geosparql. Se puede usar como un punto final SPARQL independiente, o como dependencia. El punto Qend se usa, por ejemplo, en Kohesio, donde cada interacción con la interfaz de usuario corresponde a una consulta SPARQL subyacente en el punto Qend. También Qendpoint es parte de la pregunta de Qanswer Enabeling respondiendo a los gráficos RDF.
Para el backend/punto de referencia
Para el frontend (no es obligatorio ejecutar el backend)
Puede instalar QendPoint utilizando el Manager de paquetes SCOOP.
Debe agregar el cubo the-qa-company , y luego podrá instalar el manifiesto qendpoint , se puede hacer utilizando estos comandos
# Add the-qa-company bucket
scoop bucket add the - qa - company https: // github.com / the - qa - company / scoop - bucket.git
# Install qEndpoint CLI
scoop install qendpointPuede instalar QendPoint usando el Administrador de paquetes Brew.
Puede instalar está usando este comando
brew install the-qa-company/tap/qendpoint Si no tiene acceso a Brew o Scoop, la interfaz de línea de comandos QendPoint está disponible en la página Liberar en el archivo qendpoint-cli.zip . Al extraerlo, puede un directorio bin que se puede agregar a su ruta.
Clon the Qendpoint desde este enlace: git clone https://github.com/the-qa-company/qEndpoint.git
Pase al directorio de back-end cd qendpoint-backend
Compile el proyecto utilizando este comando: mvn clean install -DskipTests
Ejecute el proyecto usando java -jar target/qendpoint-backend-1.2.3-exec.jar (reemplace la versión por la última versión)
Puede usar el proyecto como dependencia (reemplace la versión por la última versión)
<dependency>
<groupId>com.the_qa_company</groupId>
<artifactId>qendpoint</artifactId>
<version>1.2.3</version>
</dependency>
git clone https://github.com/the-qa-company/qEndpoint.gitcd qendpoint-frontendnpm installnpm start Los instaladores de punto final para Linux, MacOS y Windows se pueden encontrar aquí, los instaladores no contienen la línea de comando (CLI), solo el punto final .
Puede usar una de nuestras imágenes de Docker preconfiguradas.
qacompany/qendpointDockerhub : Qacompany/Qendpoint
Esta imagen de Docker contiene el punto final, puede cargar su conjunto de datos y comenzar a usarlo.
Solo tiene que ejecutar la imagen y preparará el entorno descargando el índice y configurando el repositorio utilizando el fragmento a continuación:
docker run -p 1234:1234 --name qendpoint qacompany/qendpointTambién puede especificar el tamaño de la memoria asignada configurando el valor de entorno Docker Mem_Size . Por defecto, este valor se establece en 6g. No debe establecer este valor por debajo de 4G porque ciertamente se quedará sin memoria con un conjunto de datos grande. Para un conjunto de datos más grande, también se recomienda un valor mayor para un gran conjunto de datos, como ejemplo, Wikidata-All no se ejecutará sin al menos 10 g.
docker run -p 1234:1234 --name qendpoint --env MEM_SIZE=6G qacompany/qendpointPuede detener el contenedor y volver a ejecutarlo en cualquier momento manteniendo los datos dentro (Qendpoint es el nombre del contenedor) utilizando los siguientes comandos:
docker stop qendpoint
docker start qendpoint: Tenga en cuenta que este contenedor puede ocupar una gran parte del disco debido al tamaño del índice de datos, así que asegúrese de eliminar el contenedor si ya no lo necesita utilizando el comando a continuación:
docker rm qendpointqacompany/qendpoint-wikidataDockerhub : Qacompany/Qendpoint-Wikidata
Esta imagen de Docker contiene el punto final con un script para descargar un índice que contiene las declaraciones Wikidata verdady de nuestros servidores, por lo que simplemente tiene que esperar la descarga del índice y comenzar a usarlo.
Solo tiene que ejecutar la imagen y preparará el entorno descargando el índice y configurando el repositorio utilizando el código a continuación:
docker run -p 1234:1234 --name qendpoint-wikidata qacompany/qendpoint-wikidataTambién puede especificar el tamaño de la memoria asignada configurando el valor de entorno Docker Mem_Size . Por defecto, este valor se establece en 6G, también se recomienda un valor mayor para un gran conjunto de datos, como ejemplo, Wikidata-All no se ejecutará sin al menos 10G.
docker run -p 1234:1234 --name qendpoint-wikidata --env MEM_SIZE=6G qacompany/qendpoint-wikidata Puede especificar el conjunto de datos para descargar utilizando el valor ambiental hdt_base , de forma predeterminada, el valor es wikidata_truthy , pero los valores actuales disponibles son:
wikidata_truthy - Wikidata verdady declaraciones (necesita al menos 6G de memoria)wikidata_all - declaraciones wikidata -todas (necesita al menos 10G de memoria) docker run -p 1234:1234 --name qendpoint-wikidata --env MEM_SIZE=10G --env HDT_BASE=wikidata_all qacompany/qendpoint-wikidataPuede detener el contenedor y volver a ejecutarlo en cualquier momento manteniendo los datos dentro (Qendpoint es el nombre del contenedor) utilizando el siguiente código:
docker stop qendpoint-wikidata
docker start qendpoint-wikidataNota Este contenedor puede ocupar una gran parte del disco debido al tamaño del índice de datos, así que asegúrese de eliminar el contenedor si ya no lo necesita usando el comando como se muestra a continuación:
docker rm qendpoint-wikidataPuede acceder a http: // localhost: 1234 donde hay una GUI donde puede escribir consultas SPARQL y ejecutarlas, y hay la API RESTful disponible que puede usar para ejecutar consultas desde cualquier aplicación a través de HTTP de lo mismo:
curl -H ' Accept: application/sparql-results+json ' localhost:1234/api/endpoint/sparql --data-urlencode ' query=select * where{ ?s ?p ?o } limit 10 'Nota La primera consulta tomará algo de tiempo para mapear el índice de memoria, ¡más adelante será mucho más rápido!
La mayoría de los formatos de resultados están disponibles, puede usar, por ejemplo:
application/sparql-results+jsonapplication/sparql-results+xmlapplication/x-binary-rdf-results-tablePuede ejecutar el punto final con este comando:
java -jar endpoint.jar &Puede encontrar una plantilla del archivo Application.Properties en la fuente de backend
Si tiene el archivo HDT de su gráfico, puede colocarlo antes de cargar el punto final en el directorio HDT-Store (por defecto hdt-store/index_dev.hdt )
Si no tiene el HDT, puede cargar el conjunto de datos al punto final ejecutando el comando mientras el punto final se ejecuta:
curl " http://127.0.0.1:1234/api/endpoint/load " -F " [email protected] " Donde mydataset.nt es el archivo RDF para cargar, puede usar todos los formatos utilizados por RDF4J.
Puede crear un repositorio SPARQL usando este método, no olvide iniciar el repositorio
// Create a SPARQL repository
SparqlRepository repository = CompiledSail . compiler (). compileToSparqlRepository ();
// Init the repository
repository . init (); Puede ejecutar consultas SPARQL utilizando executeTupleQuery , executeBooleanQuery , executeGraphQuery o execute .
// execute the a tuple query
try ( ClosableResult < TupleQueryResult > execute = sparqlRepository . executeTupleQuery (
// the sparql query
"SELECT * WHERE { ?s ?p ?o }" ,
// the timeout
10
)) {
// get the result, no need to close it, closing execute will close the result
TupleQueryResult result = execute . getResult ();
// the tuples
for ( BindingSet set : result ) {
System . out . println ( "Subject: " + set . getValue ( "s" ));
System . out . println ( "Predicate: " + set . getValue ( "p" ));
System . out . println ( "Object: " + set . getValue ( "o" ));
}
}No olvide cerrar el repositorio después del uso
// Shutdown the repository (better to release resources)
repository . shutDown (); Puede obtener el repositorio rdf4j con el método getRepository() .
// get the rdf4j repository (if required)
SailRepository rdf4jRepo = repository . getRepository ();Ejecutar el Qendpoint localmente
cd wikibase
Mueva el archivo prefixes.sparql a su instalación de Qendpoint
(re) inicie su punto final para usar los prefijos
correr
java -cp wikidata-query-tools-0.3.59-SNAPSHOT-jar-with-dependencies.jar org.wikidata.query.rdf.tool.Update
--sparqlUrl http://localhost:1234/api/endpoint/sparql
--wikibaseHost https://linkedopendata.eu/
--wikibaseUrl https://linkedopendata.eu/
--conceptUri https://linkedopendata.eu/
--wikibaseScheme https
--entityNamespaces 120,122
--start 2022-06-28T11:27:08ZPuede adaptar los parámetros a su wikibase, en este caso estamos consultando el gráfico de conocimiento de la UE, también puede cambiar la hora de inicio.
Consulte los problemas abiertos para una lista de características propuestas (y problemas conocidos).
Comuníquese con el mantenedor en uno de los siguientes lugares:
Si desea decir gracias o apoyar el desarrollo activo de Qendpoint:
En primer lugar, ¡gracias por tomarse el tiempo para contribuir! Las contribuciones son las que hacen que la comunidad de código abierto sea un lugar tan increíble para aprender, inspirar y crear. Cualquier contribución que haga beneficiará a todos los demás y es muy apreciado .
¡Lea nuestras pautas de contribución y gracias por participar!
La configuración original de este repositorio es por la compañía de control de calidad.
Para obtener una lista completa de todos los autores y contribuyentes, consulte la página de contribuyentes.
Qendpoint sigue buenas prácticas de seguridad, pero el 100% de seguridad no puede estar asegurado. Qendpoint se proporciona "como está" sin ninguna garantía . Use bajo su propio riesgo.
Para obtener más información e informar problemas de seguridad, consulte nuestra documentación de seguridad.
Este proyecto tiene licencia bajo la GNU General Public License V3 con un aviso.
Vea la licencia para más información.
