from __future__ import annotations
import datetime
import os
import signal
from dataclasses import dataclass
from enum import Enum
from typing import Any, Dict, List, Optional
import numpy as np
import pandas as pd
import pyarrow as pa
import trino
from trino.dbapi import Cursor
from trino.exceptions import TrinoQueryError
from feast.infra.offline_stores.contrib.trino_offline_store.trino_type_map import (
trino_to_pa_value_type,
)
[docs]class QueryStatus(Enum):
PENDING = 0
RUNNING = 1
ERROR = 2
COMPLETED = 3
CANCELLED = 4
[docs]class Trino:
def __init__(
self,
host: Optional[str] = None,
port: Optional[int] = None,
user: Optional[str] = None,
catalog: Optional[str] = None,
auth: Optional[Any] = None,
http_scheme: Optional[str] = None,
):
self.host = host or os.getenv("TRINO_HOST")
self.port = port or os.getenv("TRINO_PORT")
self.user = user or os.getenv("TRINO_USER")
self.catalog = catalog or os.getenv("TRINO_CATALOG")
self.auth = auth or os.getenv("TRINO_AUTH")
self.http_scheme = http_scheme or os.getenv("TRINO_HTTP_SCHEME")
self._cursor: Optional[Cursor] = None
if self.host is None:
raise ValueError("TRINO_HOST must be set if not passed in")
if self.port is None:
raise ValueError("TRINO_PORT must be set if not passed in")
if self.user is None:
raise ValueError("TRINO_USER must be set if not passed in")
if self.catalog is None:
raise ValueError("TRINO_CATALOG must be set if not passed in")
def _get_cursor(self) -> Cursor:
if self._cursor is None:
self._cursor = trino.dbapi.connect(
host=self.host,
port=self.port,
user=self.user,
catalog=self.catalog,
auth=self.auth,
http_scheme=self.http_scheme,
).cursor()
return self._cursor
[docs] def create_query(self, query_text: str) -> Query:
"""
Create a Query object without executing it.
"""
return Query(query_text=query_text, cursor=self._get_cursor())
[docs] def execute_query(self, query_text: str) -> Results:
"""
Create a Query object and execute it.
"""
query = Query(query_text=query_text, cursor=self._get_cursor())
return query.execute()
[docs]class Query(object):
def __init__(self, query_text: str, cursor: Cursor):
self.query_text = query_text
self.status = QueryStatus.PENDING
self._cursor = cursor
signal.signal(signal.SIGINT, self.cancel)
signal.signal(signal.SIGTERM, self.cancel)
[docs] def execute(self) -> Results:
try:
self.status = QueryStatus.RUNNING
start_time = datetime.datetime.utcnow()
self._cursor.execute(operation=self.query_text)
rows = self._cursor.fetchall()
end_time = datetime.datetime.utcnow()
self.execution_time = end_time - start_time
self.status = QueryStatus.COMPLETED
return Results(data=rows, columns=self._cursor._query.columns)
except TrinoQueryError as error:
self.status = QueryStatus.ERROR
raise error
finally:
self.close()
[docs] def close(self):
self._cursor.close()
[docs] def cancel(self, *args):
if self.status != QueryStatus.COMPLETED:
self._cursor.cancel()
self.status = QueryStatus.CANCELLED
self.close()
[docs]@dataclass
class Results:
"""Class for keeping track of the results of a Trino query"""
data: List[List[Any]]
columns: List[Dict]
@property
def columns_names(self) -> List[str]:
return [column["name"] for column in self.columns]
@property
def schema(self) -> Dict[str, str]:
return {column["name"]: column["type"] for column in self.columns}
@property
def pyarrow_schema(self) -> pa.Schema:
return pa.schema(
[
pa.field(column["name"], trino_to_pa_value_type(column["type"]))
for column in self.columns
]
)
[docs] def to_dataframe(self) -> pd.DataFrame:
df = pd.DataFrame(data=self.data, columns=self.columns_names)
for col_name, col_type in self.schema.items():
if col_type.startswith("timestamp"):
df[col_name] = pd.to_datetime(df[col_name])
return df.fillna(np.nan)