trino

Trino adalah mesin kueri SQL yang didistribusikan dengan cepat untuk analisis data besar.

Lihat Panduan Pengguna untuk instruksi penerapan dan dokumentasi pengguna akhir.

Perkembangan

Pelajari tentang pengembangan untuk semua proyek organisasi Trino:

• Penglihatan
• Proses kontribusi
• Tarik permintaan dan lakukan pedoman
• Pedoman catatan rilis

Informasi lebih lanjut di bagian pengembangan situs web mencakup berbagai peran, seperti kontributor, peninjau, dan pengelola, proses terkait, dan aspek lainnya.

Lihat panduan pengembang Trino untuk informasi tentang SPI, penerapan konektor dan plugin plugin lainnya, protokol klien, pengujian penulisan, dan detail tingkat rendah lainnya.

Lihat PENGEMBANGAN untuk informasi tentang gaya kode, proses pengembangan, dan pedoman.

Lihat KONTRIBUSI untuk persyaratan kontribusi.

Keamanan

Lihat kebijakan keamanan proyek untuk informasi tentang pelaporan kerentanan.

Trino mendukung build yang dapat direproduksi pada versi 449.

Persyaratan bangunan

• Mac OS X atau Linux
• Java 23.0.0+, 64-bit
• Buruh pelabuhan
  • Matikan SELinux atau sistem lain yang menonaktifkan akses tulis ke checkout lokal, untuk memungkinkan kontainer memasang bagian dari pohon sumber Trino

Membangun Trino

Trino adalah proyek standar Maven. Cukup jalankan perintah berikut dari direktori root proyek:

 ./mvnw clean install -DskipTests

Pada build pertama, Maven mengunduh semua dependensi dari internet dan menyimpannya dalam cache di repositori lokal ( ~/.m2/repository ), yang dapat memakan waktu cukup lama, bergantung pada kecepatan koneksi Anda. Pembangunan berikutnya lebih cepat.

Trino memiliki serangkaian pengujian komprehensif yang memerlukan banyak waktu untuk dijalankan, dan karenanya dinonaktifkan oleh perintah di atas. Pengujian ini dijalankan oleh sistem CI saat Anda mengirimkan permintaan penarikan. Kami merekomendasikan hanya menjalankan pengujian secara lokal untuk area kode yang Anda ubah.

Menjalankan Trino di IDE Anda

Ringkasan

Setelah membangun Trino untuk pertama kalinya, Anda dapat memuat proyek ke IDE Anda dan menjalankan server. Kami merekomendasikan penggunaan IntelliJ IDEA. Karena Trino adalah proyek Maven standar, Anda dapat dengan mudah mengimpornya ke IDE Anda. Di IntelliJ, pilih Open Project dari kotak Quick Start atau pilih Open dari menu File dan pilih file root pom.xml .

Setelah membuka proyek di IntelliJ, periksa kembali apakah Java SDK dikonfigurasi dengan benar untuk proyek tersebut:

• Buka menu File dan pilih Struktur Proyek
• Di bagian SDK, pastikan JDK 23 dipilih (buat jika tidak ada)
• Di bagian Proyek, pastikan tingkat bahasa Proyek diatur ke 23

Menjalankan server pengujian

Cara paling sederhana menjalankan Trino untuk pengembangan adalah dengan menjalankan kelas TpchQueryRunner . Ini akan memulai versi pengembangan server yang dikonfigurasi dengan konektor TPCH. Anda kemudian dapat menggunakan CLI untuk menjalankan kueri terhadap server ini. Banyak konektor lain yang memiliki kelas *QueryRunner sendiri yang dapat Anda gunakan saat bekerja pada konektor tertentu.

Menjalankan server penuh

Trino hadir dengan contoh konfigurasi yang dapat langsung digunakan untuk pengembangan. Gunakan opsi berikut untuk membuat konfigurasi proses:

• Kelas Utama: io.trino.server.DevelopmentServer
• Opsi VM: -ea -Dconfig=etc/config.properties -Dlog.levels-file=etc/log.properties -Djdk.attach.allowAttachSelf=true
• Direktori kerja: $MODULE_DIR$
• Gunakan jalur kelas modul: trino-server-dev

Direktori kerja harus berupa subdirektori trino-server-dev . Di IntelliJ, penggunaan $MODULE_DIR$ menyelesaikan ini secara otomatis.

Jika VM options tidak ada dalam dialog, Anda harus memilih Modify options dan aktifkan Add VM options .

Untuk menyesuaikan plugin mana yang diaktifkan untuk server pengembangan, sesuaikan nilai plugin.bundles di config.properties . Setiap entri dalam daftar ini harus mewakili plugin yang ditentukan oleh salah satu opsi berikut:

• Jalur ke file pom.xml atau *.pom yang menjelaskan proyek Maven yang menghasilkan plugin.
• Koordinat Maven, dalam bentuk <groupId>:<artifactId>[:<extension>[:<classifier>]]:<version> . Plugin akan dimuat melalui Maven dan oleh karena itu harus tersedia di repositori lokal Anda atau repositori jarak jauh.
• Jalur ke direktori plugin yang berisi file JAR. Lihat Menyebarkan plugin khusus untuk detail selengkapnya.

Jika Anda ingin menggunakan plugin dalam katalog, Anda harus menambahkan file <catalog_name>.properties yang sesuai ke testing/trino-server-dev/etc/catalog .

Menjalankan CLI

Mulai CLI untuk menyambung ke server dan menjalankan kueri SQL:

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

Jalankan kueri untuk melihat node di cluster:

 SELECT * FROM system.runtime.nodes;

Jalankan kueri terhadap konektor TPCH:

 SELECT * FROM tpch.tiny.region;