qEndpoint
Release 2.4.0
dev
Perusahaan QA melalui jejaring sosial
qacompany/qendpointqacompany/qendpoint-wikidataQendPoint adalah toko triple yang sangat diskalakan dengan dukungan teks lengkap dan geosparql. Ini dapat digunakan sebagai titik akhir sparql mandiri, atau sebagai ketergantungan. QendPoint misalnya digunakan dalam Kohesio di mana setiap interaksi dengan UI sesuai dengan kueri SPARQL yang mendasarinya di QendPoint. Juga QendPoint adalah bagian dari pertanyaan enabeling Qanswer yang menjawab melalui grafik RDF.
Untuk backend/benchmark
Untuk frontend (tidak wajib menjalankan backend)
Anda dapat menginstal QendPoint menggunakan manajer paket scoop.
Anda perlu menambahkan ember the-qa-company , dan kemudian Anda akan dapat menginstal manifes qendpoint , itu dapat dilakukan dengan menggunakan perintah ini
# 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 qendpointAnda dapat menginstal QendPoint menggunakan Brew Package Manager.
Anda dapat menginstal menggunakan perintah ini
brew install the-qa-company/tap/qendpoint Jika Anda tidak memiliki akses ke minuman atau scoop, antarmuka baris perintah QendPoint tersedia di halaman rilis di bawah file qendpoint-cli.zip . Dengan mengekstraknya, Anda dapat direktori bin yang dapat ditambahkan ke jalur Anda.
Kloning QendPoint dari tautan ini: git clone https://github.com/the-qa-company/qEndpoint.git
Pindah ke cd qendpoint-backend
Kompilasi proyek menggunakan perintah ini: mvn clean install -DskipTests
Jalankan proyek menggunakan java -jar target/qendpoint-backend-1.2.3-exec.jar (ganti versi dengan versi terbaru)
Anda dapat menggunakan proyek sebagai ketergantungan (ganti versi dengan versi terbaru)
<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 Installer titik akhir untuk Linux, MacOS dan Windows dapat ditemukan di sini, installer tidak berisi baris perintah (CLI), hanya titik akhir .
Anda dapat menggunakan salah satu gambar Docker kami yang telah dikonfigurasi sebelumnya.
qacompany/qendpointDockerhub : Qacompany/QendPoint
Gambar Docker ini berisi titik akhir, Anda dapat mengunggah dataset Anda dan mulai menggunakannya.
Anda hanya perlu menjalankan gambar dan itu akan mempersiapkan lingkungan dengan mengunduh indeks dan menyiapkan repositori menggunakan cuplikan di bawah ini:
docker run -p 1234:1234 --name qendpoint qacompany/qendpointAnda juga dapat menentukan ukuran memori yang dialokasikan dengan mengatur Nilai Lapangan Docker Mem_Size . Secara default nilai ini diatur ke 6G. Anda tidak boleh mengatur nilai ini di bawah 4G karena Anda pasti akan kehabisan memori dengan dataset besar. Untuk dataset yang lebih besar, nilai yang lebih besar juga direkomendasikan untuk dataset besar, sebagai contoh, wikidata-semua tidak akan berjalan tanpa setidaknya 10g.
docker run -p 1234:1234 --name qendpoint --env MEM_SIZE=6G qacompany/qendpointAnda dapat menghentikan wadah dan menjalankannya kapan saja menjaga data di dalam (QendPoint adalah nama wadah) menggunakan perintah berikut:
docker stop qendpoint
docker start qendpoint: Perhatikan wadah ini dapat menempati sebagian besar disk karena ukuran indeks data, jadi pastikan untuk menghapus wadah jika Anda tidak membutuhkannya lagi dengan menggunakan perintah di bawah ini:
docker rm qendpointqacompany/qendpoint-wikidataDockerhub : Qacompany/Qendpoint-Wikidata
Gambar Docker ini berisi titik akhir dengan skrip untuk mengunduh indeks yang berisi pernyataan Wikidata Truthy dari server kami, jadi Anda hanya perlu menunggu unduhan indeks dan mulai menggunakannya.
Anda hanya perlu menjalankan gambar dan itu akan mempersiapkan lingkungan dengan mengunduh indeks dan menyiapkan repositori menggunakan kode di bawah ini:
docker run -p 1234:1234 --name qendpoint-wikidata qacompany/qendpoint-wikidataAnda juga dapat menentukan ukuran memori yang dialokasikan dengan mengatur Nilai Lapangan Docker Mem_Size . Secara default nilai ini diatur ke 6G, nilai yang lebih besar juga direkomendasikan untuk dataset besar, sebagai contoh, wikidata-semua tidak akan berjalan tanpa setidaknya 10g.
docker run -p 1234:1234 --name qendpoint-wikidata --env MEM_SIZE=6G qacompany/qendpoint-wikidata Anda dapat menentukan dataset untuk mengunduh menggunakan nilai hdt_base , secara default nilainya adalah wikidata_truthy , tetapi nilai yang tersedia saat ini adalah:
wikidata_truthy - Pernyataan Wikidata Truthy (membutuhkan setidaknya 6G memori)wikidata_all - pernyataan wikidata -all (membutuhkan setidaknya 10G memori) docker run -p 1234:1234 --name qendpoint-wikidata --env MEM_SIZE=10G --env HDT_BASE=wikidata_all qacompany/qendpoint-wikidataAnda dapat menghentikan wadah dan menjalankannya kapan saja menjaga data di dalam (QendPoint adalah nama wadah) menggunakan kode di bawah ini:
docker stop qendpoint-wikidata
docker start qendpoint-wikidataPerhatikan wadah ini dapat menempati sebagian besar disk karena ukuran indeks data, jadi pastikan untuk menghapus wadah jika Anda tidak membutuhkannya lagi menggunakan perintah seperti yang ditunjukkan di bawah ini:
docker rm qendpoint-wikidataAnda dapat mengakses http: // localhost: 1234 di mana ada GUI di mana Anda dapat menulis kueri sparql dan menjalankannya, dan ada API Restful yang tersedia yang dapat Anda gunakan untuk menjalankan kueri dari aplikasi apa pun melalui http seperti demikian:
curl -H ' Accept: application/sparql-results+json ' localhost:1234/api/endpoint/sparql --data-urlencode ' query=select * where{ ?s ?p ?o } limit 10 'Catatan Permintaan pertama akan membutuhkan waktu untuk memetakan indeks ke memori, nanti akan jauh lebih cepat!
Sebagian besar format hasil tersedia, Anda dapat menggunakan misalnya:
application/sparql-results+jsonapplication/sparql-results+xmlapplication/x-binary-rdf-results-tableAnda dapat menjalankan titik akhir dengan perintah ini:
java -jar endpoint.jar &Anda dapat menemukan templat file application.properties di sumber backend
Jika Anda memiliki file HDT dari grafik Anda, Anda dapat meletakkannya sebelum memuat titik akhir di direktori hdt-store (secara default hdt-store/index_dev.hdt )
Jika Anda tidak memiliki HDT, Anda dapat mengunggah dataset ke titik akhir dengan menjalankan perintah saat titik akhir berjalan:
curl " http://127.0.0.1:1234/api/endpoint/load " -F " [email protected] " Di mana mydataset.nt adalah file RDF yang akan dimuat, Anda dapat menggunakan semua format yang digunakan oleh RDF4J.
Anda dapat membuat repositori SPARQL menggunakan metode ini, jangan lupa untuk memulai repositori
// Create a SPARQL repository
SparqlRepository repository = CompiledSail . compiler (). compileToSparqlRepository ();
// Init the repository
repository . init (); Anda dapat menjalankan kueri SPARQL menggunakan executeTupleQuery , executeBooleanQuery , executeGraphQuery atau 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" ));
}
}Jangan lupa untuk mematikan repositori setelah penggunaan
// Shutdown the repository (better to release resources)
repository . shutDown (); Anda bisa mendapatkan repositori RDF4J dengan metode getRepository() .
// get the rdf4j repository (if required)
SailRepository rdf4jRepo = repository . getRepository ();Jalankan QendPoint secara lokal
cd wikibase
Pindahkan prefixes.sparql file.sparql ke instalasi QendPoint Anda
(kembali) Mulai titik akhir Anda untuk menggunakan awalan
berlari
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:08ZAnda dapat menyesuaikan parameter ke wikibase Anda, dalam hal ini kami menanyakan grafik pengetahuan UE, Anda juga dapat mengubah waktu mulai.
Lihat masalah terbuka untuk daftar fitur yang diusulkan (dan masalah yang diketahui).
Jangkau pengelola di salah satu tempat berikut:
Jika Anda ingin mengucapkan terima kasih atau/dan mendukung pengembangan aktif QendPoint:
Pertama -tama, terima kasih telah meluangkan waktu untuk berkontribusi! Kontribusi inilah yang membuat komunitas open-source menjadi tempat yang luar biasa untuk belajar, menginspirasi, dan menciptakan. Kontribusi apa pun yang Anda buat akan menguntungkan orang lain dan sangat dihargai .
Harap baca pedoman kontribusi kami, dan terima kasih telah terlibat!
Pengaturan asli dari repositori ini adalah oleh perusahaan QA.
Untuk daftar lengkap semua penulis dan kontributor, lihat halaman kontributor.
QendPoint mengikuti praktik keamanan yang baik, tetapi keamanan 100% tidak dapat dijamin. QendPoint disediakan "sebagaimana adanya" tanpa jaminan apa pun. Gunakan dengan risiko Anda sendiri.
Untuk informasi lebih lanjut dan untuk melaporkan masalah keamanan, silakan merujuk ke dokumentasi keamanan kami.
Proyek ini dilisensikan di bawah Lisensi Publik Umum GNU V3 dengan pemberitahuan.
Lihat lisensi untuk informasi lebih lanjut.
