qEndpoint
Release 2.4.0
ديف
شركة ضمان الجودة عبر الشبكات الاجتماعية
qacompany/qendpointqacompany/qendpoint-wikidataيعد QendPoint متجرًا ثلاثيًا قابل للتطوير للغاية مع دعم النص الكامل و Geosparql. يمكن استخدامه كنقطة نهاية sparql مستقلة ، أو كاعتماد. يتم استخدام QendPoint على سبيل المثال في Kohesio حيث يتوافق كل تفاعل مع واجهة المستخدم مع استعلام sparql الأساسي على QendPoint. أيضا QendPoint هو جزء من Qanswer Enabeling سؤال الإجابة على الرسوم البيانية RDF.
للداخل الخلفي/المعيار
للواجهة الأمامية (ليست إلزامية تشغيل الواجهة الخلفية)
يمكنك تثبيت QendPoint باستخدام Manager Scoop Package.
تحتاج إلى إضافة دلو 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 qendpointيمكنك تثبيت QendPoint باستخدام Manager Brew Package.
يمكنك التثبيت هو استخدام هذا الأمر
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-frontendnpm installnpm start يمكن العثور على مثبتات نقطة النهاية لـ Linux و MacOS و Windows هنا ، لا تحتوي المثبتات على سطر الأوامر (CLI) ، فقط نقطة النهاية .
يمكنك استخدام إحدى صور Docker التي تم تكوينها مسبقًا.
qacompany/qendpointDockerhub : Qacompany/Qendpoint
تحتوي صورة Docker هذه على نقطة النهاية ، يمكنك تحميل مجموعة البيانات والبدء في استخدامها.
عليك فقط تشغيل الصورة وسيقوم بإعداد البيئة عن طريق تنزيل الفهرس وإعداد المستودع باستخدام المقتطف أدناه:
docker run -p 1234:1234 --name qendpoint qacompany/qendpointيمكنك أيضًا تحديد حجم الذاكرة المخصصة عن طريق ضبط قيمة Docker Environnement قيمة 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 من خوادمنا ، لذلك عليك ببساطة انتظار تنزيل الفهرس والبدء في استخدامه.
يجب عليك فقط تشغيل الصورة وستقوم بإعداد البيئة عن طريق تنزيل الفهرس وإعداد المستودع باستخدام الرمز أدناه:
docker run -p 1234:1234 --name qendpoint-wikidata qacompany/qendpoint-wikidataيمكنك أيضًا تحديد حجم الذاكرة المخصصة عن طريق ضبط قيمة Docker Environnement قيمة mem_size . بشكل افتراضي ، يتم تعيين هذه القيمة على 6G ، ويوصى أيضًا بقيمة أكبر لمجموعة البيانات الكبيرة ، على سبيل المثال ، لن يتم تشغيل Wikidata-All بدون 10G على الأقل.
docker run -p 1234:1234 --name qendpoint-wikidata --env MEM_SIZE=6G qacompany/qendpoint-wikidata يمكنك تحديد مجموعة البيانات للتنزيل باستخدام قيمة البيئة HDT_Base ، بشكل افتراضي ، القيمة هي wikidata_truthy ، ولكن القيم المتاحة الحالية هي:
wikidata_truthy - بيانات الحقيقة Wikidata (تحتاج إلى 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-wikidataيمكنك الوصول إلى http: // localhost: 1234 حيث يوجد واجهة مستهلك حيث يمكنك كتابة استعلامات sparql وتنفيذها ، وهناك واجهة برمجة التطبيقات المريحة التي يمكنك استخدامها لتشغيل الاستعلامات من أي تطبيق عبر http مثل SO:
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 (افتراضيًا 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 (); يمكنك تنفيذ استعلامات SPARQL باستخدام executeTupleQuery أو executeBooleanQuery أو executeGraphQuery أو 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" ));
}
}لا تنس إغلاق المستودع بعد الاستخدام
// Shutdown the repository (better to release resources)
repository . shutDown (); يمكنك الحصول على مستودع RDF4J باستخدام طريقة getRepository() .
// 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:08Zيمكنك تكييف المعلمات مع wikibase الخاص بك ، وفي هذه الحالة نحن نستفسر عن الرسم البياني المعرفة في الاتحاد الأوروبي ، يمكنك أيضًا تغيير وقت البدء.
راجع المشكلات المفتوحة للحصول على قائمة بالميزات المقترحة (والمشكلات المعروفة).
تواصل مع المشرف في أحد الأماكن التالية:
إذا كنت تريد أن تقول شكراً لك و/ودعم التطوير النشط لـ QendPoint:
بادئ ذي بدء ، شكرا لأخذ الوقت للمساهمة! المساهمات هي التي تجعل مجتمع المصدر المفتوح مكانًا رائعًا للتعلم وإلهامه وإنشائه. أي مساهمات تقدمها ستفيد الجميع ويتم تقديرها كثيرًا .
يرجى قراءة إرشادات المساهمة الخاصة بنا ، وشكرا على المشاركة!
الإعداد الأصلي لهذا المستودع هو من قبل شركة QA.
للحصول على قائمة كاملة بجميع المؤلفين والمساهمين ، راجع صفحة المساهمين.
يتبع QendPoint ممارسات جيدة للأمن ، ولكن لا يمكن ضمان أمان 100 ٪. يتم توفير QendPoint "كما هو" دون أي ضمان . استخدم على مسؤوليتك الخاصة.
لمزيد من المعلومات والإبلاغ عن مشكلات الأمان ، يرجى الرجوع إلى وثائق الأمان الخاصة بنا.
تم ترخيص هذا المشروع بموجب ترخيص GNU General Public V3 مع إشعار.
انظر الترخيص لمزيد من المعلومات.
