qEndpoint
Release 2.4.0
데브
소셜 네트워크에 대한 QA 회사
qacompany/qendpointqacompany/qendpoint-wikidataQendpoint는 전체 텍스트 및 GeosparQL 지원을 제공하는 매우 확장 가능한 트리플 스토어입니다. 독립형 SPARQL 엔드 포인트 또는 종속성으로 사용할 수 있습니다. Qendpoint는 예를 들어 Kohesio에서 사용되는데, 여기서 UI와의 각 상호 작용은 Qendpoint의 기본 SPARQL 쿼리에 해당합니다. 또한 Qendpoint는 Qanswer Enabeling 질문의 일부이며 RDF 그래프에 대한 답변입니다.
백엔드/벤치 마크
프론트 엔드 (백엔드를 실행 해야하는 필수)
Scoop 패키지 관리자를 사용하여 Qendpoint를 설치할 수 있습니다.
the-qa-company 버킷을 추가 해야하는 다음 qendpoint 매니페스트를 설치할 수 있습니다.이 명령을 사용하여 수행 할 수 있습니다.
# 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 qendpointBrew 패키지 관리자를 사용하여 Qendpoint를 설치할 수 있습니다.
이 명령을 사용하는 것입니다
brew install the-qa-company/tap/qendpoint Brew 또는 Scoop에 액세스 할 수없는 경우 Qendpoint 명령 줄 인터페이스는 qendpoint-cli.zip 파일의 릴리스 페이지에서 사용할 수 있습니다. 그것을 추출하면 경로에 추가 할 수있는 빈 디렉토리를 사용할 수 있습니다.
이 링크에서 Qendpoint를 복제 git clone https://github.com/the-qa-company/qEndpoint.git
백엔드 디렉토리 cd qendpoint-backend 로 이동하십시오
이 명령을 사용하여 프로젝트를 컴파일하십시오 : mvn clean install -DskipTests
java -jar target/qendpoint-backend-1.2.3-exec.jar 사용하여 프로젝트를 실행하십시오 (버전을 최신 버전으로 바꾸십시오)
프로젝트를 종속성으로 사용할 수 있습니다 (버전을 최신 버전으로 바꾸십시오).
<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-frontend 로 이동하십시오npm install 사용하여 패키지를 설치하십시오npm start 사용하여 프로젝트를 실행하십시오 Linux, MacOS 및 Windows 용 엔드 포인트 설치 프로그램은 여기에서 찾을 수 있으며 설치 업체에는 명령 줄 (CLI)이 포함되어 있지 않으며 엔드 포인트 만 포함합니다 .
미리 구성된 Docker 이미지 중 하나를 사용할 수 있습니다.
qacompany/qendpointDockerHub : Qacompany/Qendpoint
이 docker 이미지에는 엔드 포인트가 포함되어 있으므로 데이터 세트를 업로드하고 사용을 시작할 수 있습니다.
이미지를 실행하면 인덱스를 다운로드하고 아래 스 니펫을 사용하여 리포지토리를 설정하여 환경을 준비합니다.
docker run -p 1234:1234 --name qendpoint qacompany/qendpointDocker Environnement Value Mem_Size를 설정하여 할당 된 메모리의 크기를 지정할 수도 있습니다. 기본적 으로이 값은 6G로 설정됩니다. 큰 데이터 세트로 메모리가 부족하기 때문에이 값을 4G 미만으로 설정해서는 안됩니다. 더 큰 데이터 세트의 경우 큰 데이터 세트에는 더 큰 값이 권장됩니다. 예를 들어, Wikidata-All은 10g 이상 실행되지 않습니다.
docker run -p 1234:1234 --name qendpoint --env MEM_SIZE=6G qacompany/qendpoint다음 명령을 사용하여 컨테이너를 중지하고 (Qendpoint는 컨테이너의 이름입니다) 언제든지 컨테이너를 다시 실행할 수 있습니다.
docker stop qendpoint
docker start qendpoint:이 컨테이너 는 데이터 인덱스의 크기로 인해 디스크의 막대한 부분을 차지할 수 있으므로 아래 명령을 사용하여 더 이상 필요하지 않은 경우 컨테이너를 삭제하십시오.
docker rm qendpointqacompany/qendpoint-wikidataDockerHub : Qacompany/Qendpoint-Wikidata
이 Docker 이미지에는 서버의 Wikidata Truthy 문이 포함 된 인덱스를 다운로드하는 스크립트가 포함 된 엔드 포인트가 포함되어 있으므로 인덱스 다운로드를 기다리고 사용하기 시작해야합니다.
이미지를 실행하면 인덱스를 다운로드하고 아래 코드를 사용하여 리포지토리를 설정하여 환경을 준비합니다.
docker run -p 1234:1234 --name qendpoint-wikidata qacompany/qendpoint-wikidataDocker Environnement Value Mem_Size를 설정하여 할당 된 메모리의 크기를 지정할 수도 있습니다. 기본적 으로이 값은 6G로 설정되며 대형 데이터 세트에는 더 큰 값이 권장됩니다.
docker run -p 1234:1234 --name qendpoint-wikidata --env MEM_SIZE=6G qacompany/qendpoint-wikidata 환경 값 HDT_Base를 사용하여 다운로드 할 데이터 세트를 지정할 수 있습니다. 기본적으로 값은 wikidata_truthy 이지만 현재 사용 가능한 값은 다음과 같습니다.
wikidata_truthy -Wikidata Truthy 진술 (최소 6G 의 메모리가 필요합니다)wikidata_all -Wikidata -All 문 (최소 10G 의 메모리가 필요합니다) docker run -p 1234:1234 --name qendpoint-wikidata --env MEM_SIZE=10G --env HDT_BASE=wikidata_all qacompany/qendpoint-wikidata아래 코드를 사용하여 컨테이너를 중지하고 (Qendpoint는 컨테이너의 이름입니다) 언제든지 컨테이너를 다시 실행할 수 있습니다.
docker stop qendpoint-wikidata
docker start qendpoint-wikidata참고이 컨테이너는 데이터 인덱스의 크기로 인해 디스크의 막대한 부분을 차지할 수 있으므로 아래와 같이 명령을 사용하여 더 이상 필요하지 않은 경우 컨테이너를 삭제하십시오.
docker rm qendpoint-wikidatasparql 쿼리를 작성하여 실행할 수있는 GUI가있는 http : // localhost : 1234에 액세스 할 수 있으며, HTTP를 통해 모든 응용 프로그램에서 쿼리를 실행하는 데 사용할 수있는 나머지 API가 있습니다.
curl -H ' Accept: application/sparql-results+json ' localhost:1234/api/endpoint/sparql --data-urlencode ' query=select * where{ ?s ?p ?o } limit 10 '참고 첫 번째 쿼리는 인덱스를 메모리에 매핑하는 데 약간의 시간이 걸립니다. 나중에는 훨씬 빠릅니다!
대부분의 결과 형식을 사용할 수 있으며 예를 들어 사용할 수 있습니다.
application/sparql-results+jsonapplication/sparql-results+xmlapplication/x-binary-rdf-results-table이 명령으로 엔드 포인트를 실행할 수 있습니다.
java -jar endpoint.jar &백엔드 소스에서 Application.Properties 파일의 템플릿을 찾을 수 있습니다.
그래프의 HDT 파일이있는 경우 HDT-Store 디렉토리에 엔드 포인트를로드하기 전에 (기본적으로 hdt-store/index_dev.hdt )를 넣을 수 있습니다.
HDT가없는 경우 엔드 포인트가 실행되는 동안 명령을 실행하여 데이터 세트를 엔드 포인트에 업로드 할 수 있습니다.
curl " http://127.0.0.1:1234/api/endpoint/load " -F " [email protected] " mydataset.nt 가로드 할 RDF 파일 인 경우 RDF4J에서 사용하는 모든 형식을 사용할 수 있습니다.
이 메소드를 사용하여 SPARQL 저장소를 만들 수 있습니다. 저장소를 시작하는 것을 잊지 마십시오.
// Create a SPARQL repository
SparqlRepository repository = CompiledSail . compiler (). compileToSparqlRepository ();
// Init the repository
repository . init (); executeTupleQuery , executeBooleanQuery , executeGraphQuery 또는 execute 사용하여 SPARQL 쿼리를 실행할 수 있습니다.
// 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" ));
}
}사용 후 저장소를 종료하는 것을 잊지 마십시오
// Shutdown the repository (better to release resources)
repository . shutDown (); getRepository() 메소드로 RDF4J 저장소를 얻을 수 있습니다.
// get the rdf4j repository (if required)
SailRepository rdf4jRepo = repository . getRepository ();로컬로 Qendpoint를 실행하십시오
cd wikibase
prefixes.sparql 파일을 Qendpoint 설치로 이동하십시오
(다시) 끝점을 시작하여 접두사를 사용하십시오
달리다
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:08Zwikibase에 매개 변수를 조정할 수 있습니다.이 경우 EU 지식 그래프를 쿼리하고 있으며 시작 시간을 변경할 수도 있습니다.
제안 된 기능 목록 (및 알려진 문제)은 열린 문제를 참조하십시오.
다음 장소 중 하나에서 관리자에게 연락하십시오.
당신이 말하고 싶다면 감사 하거나/그리고 Qendpoint의 적극적인 개발을 지원합니다.
우선, 시간을내어 기부 해 주셔서 감사합니다 ! 공헌은 오픈 소스 커뮤니티를 배우고, 영감을주고, 창조 할 수있는 놀라운 장소입니다. 당신이하는 모든 기여는 다른 사람들에게 도움이 될 것이며 대단히 감사합니다 .
기여 가이드 라인을 읽고 참여해 주셔서 감사합니다!
이 저장소의 원래 설정은 QA Company의 것입니다.
모든 저자 및 기고자의 전체 목록은 기고자 페이지를 참조하십시오.
Qendpoint는 보안의 모범 사례를 따르지만 100% 보안은 보장 할 수 없습니다. Qendpoint는 보증 없이 "그대로" 제공됩니다. 자신의 위험에 사용하십시오.
자세한 내용과 보안 문제를보고하려면 보안 문서를 참조하십시오.
이 프로젝트는 GNU General Public License V3 에 따라 통지와 함께 라이센스가 부여됩니다.
자세한 내용은 라이센스를 참조하십시오.
