https://github.com/tisonkun/trino

Official repository of Trino, the distributed SQL query engine for big data, formerly known as PrestoSQL (https://trino.io)
https://github.com/tisonkun/trino

Last synced: 2 days ago
JSON representation

Official repository of Trino, the distributed SQL query engine for big data, formerly known as PrestoSQL (https://trino.io)

• Host: GitHub
• URL: https://github.com/tisonkun/trino
• Owner: tisonkun
• License: apache-2.0
• Fork: true (trinodb/trino)
• Created: 2022-07-03T13:24:36.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2022-09-01T09:27:23.000Z (about 2 years ago)
• Last Synced: 2023-03-04T00:28:17.684Z (over 1 year ago)
• Homepage: https://trino.io
• Size: 154 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE
  • Security: .github/SECURITY.md

Awesome Lists containing this project

README

        


    





    Trino is a fast distributed SQL query engine for big data analytics.





    See the User Manual for deployment instructions and end user documentation.





   

       

   

   

       

   

   

       

   



## Development

See [DEVELOPMENT](.github/DEVELOPMENT.md) for information about code style,

development process, and guidelines.

See [CONTRIBUTING](.github/CONTRIBUTING.md) for contribution requirements.

## Security

See the project [security policy](.github/SECURITY.md) for

information about reporting vulnerabilities.

## Build requirements

* Mac OS X or Linux

* Java 11.0.11+, 64-bit

* Docker

## Building Trino

Trino is a standard Maven project. Simply run the following command from the

project root directory:

    ./mvnw clean install -DskipTests

On the first build, Maven downloads all the dependencies from the internet

and caches them in the local repository (`~/.m2/repository`), which can take a

while, depending on your connection speed. Subsequent builds are faster.

Trino has a comprehensive set of tests that take a considerable amount of time

to run, and are thus disabled by the above command. These tests are run by the

CI system when you submit a pull request. We recommend only running tests

locally for the areas of code that you change.

## Running Trino in your IDE

### Overview

After building Trino for the first time, you can load the project into your IDE

and run the server.  We recommend using

[IntelliJ IDEA](http://www.jetbrains.com/idea/). Because Trino is a standard

Maven project, you easily can import it into your IDE.  In IntelliJ, choose

*Open Project* from the *Quick Start* box or choose *Open*

from the *File* menu and select the root `pom.xml` file.

After opening the project in IntelliJ, double check that the Java SDK is

properly configured for the project:

* Open the File menu and select Project Structure

* In the SDKs section, ensure that JDK 11 is selected (create one if none exist)

* In the Project section, ensure the Project language level is set to 11

### Running a testing server

The simplest way to run Trino for development is to run the `TpchQueryRunner`

class. It will start a development version of the server that is configured with

the TPCH connector. You can then use the CLI to execute queries against this

server. Many other connectors have their own `*QueryRunner` class that you can

use when working on a specific connector.

### Running the full server

Trino comes with sample configuration that should work out-of-the-box for

development. Use the following options to create a run configuration:

* Main Class: `io.trino.server.DevelopmentServer`

* VM Options: `-ea -Dconfig=etc/config.properties -Dlog.levels-file=etc/log.properties -Djdk.attach.allowAttachSelf=true`

* Working directory: `$MODULE_DIR$`

* Use classpath of module: `trino-server-dev`

The working directory should be the `trino-server-dev` subdirectory. In

IntelliJ, using `$MODULE_DIR$` accomplishes this automatically.

If `VM options` doesn't exist in the dialog, you need to select `Modify options`

and enable `Add VM options`.

### Running the CLI

Start the CLI to connect to the server and run SQL queries:

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

Run a query to see the nodes in the cluster:

    SELECT * FROM system.runtime.nodes;

Run a query against the TPCH connector:

    SELECT * FROM tpch.tiny.region;