الصفحة الرئيسية>المتعلقة بالبرمجة>جافا كود المصدر
تنزيل

شعار ترينو

Trino هو محرك استعلام SQL سريع التوزيع لتحليلات البيانات الضخمة.

راجع دليل المستخدم للحصول على تعليمات النشر ووثائق المستخدم النهائي.

تطوير

تعرف على التطوير لجميع مشاريع منظمة Trino:

  • رؤية
  • عملية المساهمة
  • سحب الطلب والالتزام بالمبادئ التوجيهية
  • إرشادات مذكرة الإصدار

تشتمل المعلومات الإضافية في قسم التطوير بالموقع على أدوار مختلفة، مثل المساهمين والمراجعين والمشرفين والعمليات ذات الصلة والجوانب الأخرى.

راجع دليل مطور Trino للحصول على معلومات حول SPI وتنفيذ الموصلات والمكونات الإضافية الأخرى وبروتوكول العميل واختبارات الكتابة وتفاصيل المستوى الأدنى الأخرى.

راجع التطوير للحصول على معلومات حول نمط التعليمات البرمجية وعملية التطوير والإرشادات.

راجع المساهمة للتعرف على متطلبات المساهمة.

حماية

راجع سياسة أمان المشروع للحصول على معلومات حول الإبلاغ عن الثغرات الأمنية.

يدعم Trino الإصدارات القابلة للتكرار اعتبارًا من الإصدار 449.

متطلبات البناء

  • نظام التشغيل Mac OS X أو Linux
  • جافا 23.0.0+، 64 بت
  • عامل ميناء
    • قم بإيقاف تشغيل SELinux أو الأنظمة الأخرى التي تعمل على تعطيل الوصول للكتابة إلى الخروج المحلي، للسماح للحاويات بتركيب أجزاء من شجرة مصدر Trino

بناء ترينو

Trino هو مشروع Maven القياسي. ما عليك سوى تشغيل الأمر التالي من الدليل الجذر للمشروع: 

 ./mvnw clean install -DskipTests

في الإصدار الأول، يقوم Maven بتنزيل جميع التبعيات من الإنترنت وتخزينها مؤقتًا في المستودع المحلي ( ~/.m2/repository )، الأمر الذي قد يستغرق بعض الوقت، اعتمادًا على سرعة الاتصال لديك. عمليات البناء اللاحقة تكون أسرع.

لدى Trino مجموعة شاملة من الاختبارات التي تستغرق وقتًا طويلاً للتشغيل، وبالتالي يتم تعطيلها بواسطة الأمر أعلاه. يتم تشغيل هذه الاختبارات بواسطة نظام CI عند إرسال طلب سحب. نوصي بإجراء الاختبارات محليًا فقط لمناطق التعليمات البرمجية التي تقوم بتغييرها.

تشغيل Trino في IDE الخاص بك

ملخص

بعد إنشاء Trino لأول مرة، يمكنك تحميل المشروع إلى IDE الخاص بك وتشغيل الخادم. نوصي باستخدام IntelliJ IDEA. نظرًا لأن Trino هو مشروع Maven قياسي، فيمكنك بسهولة استيراده إلى IDE الخاص بك. في IntelliJ، اختر Open Project من مربع Quick Start أو اختر Open من قائمة File وحدد ملف pom.xml الجذر.

بعد فتح المشروع في IntelliJ، تأكد مرة أخرى من تكوين Java SDK بشكل صحيح للمشروع:

  • افتح قائمة "ملف" وحدد "بنية المشروع".
  • في قسم SDKs، تأكد من تحديد JDK 23 (قم بإنشاء واحدة في حالة عدم وجودها)
  • في قسم المشروع، تأكد من ضبط مستوى لغة المشروع على 23

تشغيل خادم الاختبار

إن أبسط طريقة لتشغيل Trino للتطوير هي تشغيل فئة TpchQueryRunner . سيبدأ إصدار تطوير للخادم الذي تم تكوينه باستخدام موصل TPCH. يمكنك بعد ذلك استخدام واجهة سطر الأوامر (CLI) لتنفيذ الاستعلامات على هذا الخادم. تحتوي العديد من الموصلات الأخرى على فئة *QueryRunner الخاصة بها والتي يمكنك استخدامها عند العمل على موصل معين.

تشغيل السيرفر الكامل

يأتي Trino مع نموذج تكوين يجب أن يعمل خارج الصندوق من أجل التطوير. استخدم الخيارات التالية لإنشاء تكوين تشغيل:

  • الفئة الرئيسية: io.trino.server.DevelopmentServer
  • خيارات VM: -ea -Dconfig=etc/config.properties -Dlog.levels-file=etc/log.properties -Djdk.attach.allowAttachSelf=true
  • دليل العمل: $MODULE_DIR$
  • استخدم مسار فئة الوحدة النمطية: trino-server-dev

يجب أن يكون دليل العمل هو الدليل الفرعي trino-server-dev . في IntelliJ، يؤدي استخدام $MODULE_DIR$ إلى تحقيق ذلك تلقائيًا.

إذا لم تكن VM options موجودة في مربع الحوار، فستحتاج إلى تحديد Modify options وتمكين Add VM options .

لضبط المكونات الإضافية التي تم تمكينها لخادم التطوير، اضبط قيمة plugin.bundles في config.properties . يجب أن يمثل كل إدخال في هذه القائمة مكونًا إضافيًا محددًا بواسطة أحد الخيارات التالية:

  • مسار إلى ملف pom.xml أو *.pom يصف مشروع Maven الذي ينتج مكونًا إضافيًا.
  • إحداثيات Maven، على شكل <groupId>:<artifactId>[:<extension>[:<classifier>]]:<version> . سيتم تحميل المكون الإضافي عبر Maven وبالتالي يجب أن يكون متاحًا في مستودعك المحلي أو مستودع بعيد.
  • مسار إلى دليل البرنامج المساعد الذي يحتوي على ملفات JAR. راجع نشر مكون إضافي مخصص لمزيد من التفاصيل.

إذا كنت تريد استخدام مكون إضافي في كتالوج، فيجب عليك إضافة ملف <catalog_name>.properties المطابق إلى testing/trino-server-dev/etc/catalog .

تشغيل سطر الأوامر

ابدأ تشغيل واجهة سطر الأوامر (CLI) للاتصال بالخادم وتشغيل استعلامات SQL: 

 client/trino-cli/target/trino-cli-*-executable.jar

قم بتشغيل استعلام لرؤية العقد الموجودة في المجموعة: 

 SELECT * FROM system.runtime.nodes;

قم بتشغيل استعلام على موصل TPCH: 

 SELECT * FROM tpch.tiny.region;
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل