trino

Trino 是一個用於大數據分析的快速分散式 SQL 查詢引擎。

有關部署說明和最終用戶文檔，請參閱用戶手冊。

發展

了解所有 Trino 組織專案的開發：

• 想像
• 投稿流程
• 拉取請求和提交指南
• 發行說明指南

網站開發部分的更多資訊包括不同的角色，如貢獻者、審查者和維護者、相關流程和其他方面。

有關 SPI、實現連接器和其他插件、客戶端協定、編寫測試和其他較低層級詳細資訊的信息，請參閱 Trino 開發人員指南。

有關程式碼風格、開發過程和指南的信息，請參閱開發。

有關貢獻要求，請參閱貢獻。

安全

有關報告漏洞的信息，請參閱專案安全策略。

Trino 從版本 449 開始支援可重現的建置。

建置要求

• Mac OS X 或 Linux
• Java 23.0.0+，64 位
• 碼頭工人
  • 關閉 SELinux 或其他停用本機結帳寫入存取的系統，以允許容器掛載 Trino 來源樹的部分內容

建設三諾

Trino 是一個標準的 Maven 專案。只需從專案根目錄執行以下命令：

 ./mvnw clean install -DskipTests

在第一個建置中，Maven 從互聯網下載所有依賴項並將它們緩存在本機儲存庫 ( ~/.m2/repository ) 中，這可能需要一段時間，具體取決於您的連線速度。後續建置速度更快。

Trino 有一套全面的測試，需要相當長的時間才能運行，因此可以透過上述命令停用。當您提交拉取請求時，這些測試會由 CI 系統執行。我們建議僅在本地對您更改的程式碼區域執行測試。

在 IDE 中運行 Trino

概述

第一次建置 Trino 後，您可以將專案載入到 IDE 中並執行伺服器。我們建議使用 IntelliJ IDEA。由於 Trino 是一個標準的 Maven 項目，因此您可以輕鬆地將其匯入到您的 IDE 中。在 IntelliJ 中，從「快速啟動」方塊中選擇「開啟專案」 ，或從「檔案」選單中選擇「開啟」並選擇根pom.xml檔案。

在 IntelliJ 中開啟專案後，仔細檢查是否已為該專案正確配置了 Java SDK：

• 開啟檔案選單並選擇項目結構
• 在 SDK 部分中，請確保選擇 JDK 23（如果不存在則建立一個）
• 在「專案」部分中，確保「專案語言等級」設定為 23

運行測試伺服器

運行 Trino 進行開發的最簡單方法是運行TpchQueryRunner類別。它將啟動配置有 TPCH 連接器的伺服器的開發版本。然後，您可以使用 CLI 對此伺服器執行查詢。許多其他連接器都有自己的*QueryRunner類，您可以在處理特定連接器時使用它們。

運行完整的伺服器

Trino 附帶了範例配置，可以開箱即用地進行開發。使用以下選項建立運行配置：

• 主類別： io.trino.server.DevelopmentServer
• 虛擬機器選項： -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 。

若要調整為開發伺服器啟用哪些插件，請調整config.properties中的plugin.bundles的值。此清單中的每個條目必須代表由下列選項之一指定的插件：

• 描述產生插件的 Maven 專案的pom.xml或*.pom檔案的路徑。
• Maven 座標，格式為<groupId>:<artifactId>[:<extension>[:<classifier>]]:<version> 。該插件將透過 Maven 加載，因此必須在本地存儲庫或遠端存儲庫中可用。
• 包含 JAR 檔案的插件目錄的路徑。有關更多詳細信息，請參閱部署自訂插件。

如果要使用目錄中的插件，則必須將對應的<catalog_name>.properties檔案新增至testing/trino-server-dev/etc/catalog 。

運行 CLI

啟動 CLI 連線到伺服器並執行 SQL 查詢：

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

執行查詢以查看叢集中的節點：

 SELECT * FROM system.runtime.nodes;

針對 TPCH 連接器執行查詢：

 SELECT * FROM tpch.tiny.region;