Skip to content

Commit

Permalink
Correct name for TPC-H and TPC-DS connectors
Browse files Browse the repository at this point in the history
  • Loading branch information
mosabua committed Nov 13, 2024
1 parent 712e779 commit 70ed876
Show file tree
Hide file tree
Showing 9 changed files with 30 additions and 30 deletions.
4 changes: 2 additions & 2 deletions docs/src/main/sphinx/connector.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,8 +43,8 @@ Snowflake <connector/snowflake>
SQL Server <connector/sqlserver>
System <connector/system>
Thrift <connector/thrift>
TPCDS <connector/tpcds>
TPCH <connector/tpch>
TPC-DS <connector/tpcds>
TPC-H <connector/tpch>
Vertica <connector/vertica>
```

Expand Down
18 changes: 9 additions & 9 deletions docs/src/main/sphinx/connector/tpcds.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,28 @@
# TPCDS connector
# TPC-DS connector

The TPCDS connector provides a set of schemas to support the
The TPC-DS connector provides a set of schemas to support the
[TPC Benchmark™ DS (TPC-DS)](http://www.tpc.org/tpcds/). TPC-DS is a database
benchmark used to measure the performance of complex decision support databases.

This connector can be used to test the capabilities and query
syntax of Trino without configuring access to an external data
source. When you query a TPCDS schema, the connector generates the
source. When you query a TPC-DS schema, the connector generates the
data on the fly using a deterministic algorithm.

Use the [](/connector/faker) to create and query arbitrary data.

## Configuration

To configure the TPCDS connector, create a catalog properties file
To configure the TPC-DS connector, create a catalog properties file
`etc/catalog/example.properties` with the following contents:

```text
connector.name=tpcds
```

## TPCDS schemas
## TPC-DS schemas

The TPCDS connector supplies several schemas:
The TPC-DS connector supplies several schemas:

```
SHOW SCHEMAS FROM example;
Expand All @@ -46,9 +46,9 @@ SHOW SCHEMAS FROM example;
```

Ignore the standard schema `information_schema`, which exists in every
catalog, and is not directly provided by the TPCDS connector.
catalog, and is not directly provided by the TPC-DS connector.

Every TPCDS schema provides the same set of tables. Some tables are
Every TPC-DS schema provides the same set of tables. Some tables are
identical in all schemas. The *scale factor* of the tables in a particular
schema is determined from the schema name. For example, the schema
`sf1` corresponds to scale factor `1` and the schema `sf300`
Expand All @@ -61,7 +61,7 @@ testing.
(tpcds-type-mapping)=
## Type mapping

Trino supports all data types used within the TPCDS schemas so no mapping is
Trino supports all data types used within the TPC-DS schemas so no mapping is
required.

(tpcds-sql-support)=
Expand Down
22 changes: 11 additions & 11 deletions docs/src/main/sphinx/connector/tpch.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
# TPCH connector
# TPC-H connector

The TPCH connector provides a set of schemas to support the
The TPC-H connector provides a set of schemas to support the
[TPC Benchmark™ H (TPC-H)](http://www.tpc.org/tpch/). TPC-H is a database
benchmark used to measure the performance of highly-complex decision support databases.

This connector can be used to test the capabilities and query
syntax of Trino without configuring access to an external data
source. When you query a TPCH schema, the connector generates the
source. When you query a TPC-H schema, the connector generates the
data on the fly using a deterministic algorithm.

Use the [](/connector/faker) to create and query arbitrary data.

## Configuration

To configure the TPCH connector, create a catalog properties file
To configure the TPC-H connector, create a catalog properties file
`etc/catalog/example.properties` with the following contents:

```text
Expand All @@ -22,17 +22,17 @@ connector.name=tpch

In the TPC-H specification, each column is assigned a prefix based on its
corresponding table name, such as `l_` for the `lineitem` table. By default, the
TPCH connector simplifies column names by excluding these prefixes with the
TPC-H connector simplifies column names by excluding these prefixes with the
default of `tpch.column-naming` to `SIMPLIFIED`. To use the long, standard
column names, use the configuration in the catalog properties file:

```text
tpch.column-naming=STANDARD
```

## TPCH schemas
## TPC-H schemas

The TPCH connector supplies several schemas:
The TPC-H connector supplies several schemas:

```
SHOW SCHEMAS FROM example;
Expand All @@ -55,21 +55,21 @@ SHOW SCHEMAS FROM example;
```

Ignore the standard schema `information_schema`, which exists in every
catalog, and is not directly provided by the TPCH connector.
catalog, and is not directly provided by the TPC-H connector.

Every TPCH schema provides the same set of tables. Some tables are
Every TPC-H schema provides the same set of tables. Some tables are
identical in all schemas. Other tables vary based on the *scale factor*,
which is determined based on the schema name. For example, the schema
`sf1` corresponds to scale factor `1` and the schema `sf300`
corresponds to scale factor `300`. The TPCH connector provides an
corresponds to scale factor `300`. The TPC-H connector provides an
infinite number of schemas for any scale factor, not just the few common
ones listed by `SHOW SCHEMAS`. The `tiny` schema is an alias for scale
factor `0.01`, which is a very small data set useful for testing.

(tpch-type-mapping)=
## Type mapping

Trino supports all data types used within the TPCH schemas so no mapping
Trino supports all data types used within the TPC-H schemas so no mapping
is required.

(tpch-sql-support)=
Expand Down
4 changes: 2 additions & 2 deletions docs/src/main/sphinx/optimizer/pushdown.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ You can check if pushdown for a specific query is performed by looking at the
pushed down to the connector, the explain plan does **not** show that `Aggregate` operator.
The explain plan only shows the operations that are performed by Trino.

As an example, we loaded the TPCH data set into a PostgreSQL database and then
As an example, we loaded the TPC-H data set into a PostgreSQL database and then
queried it using the PostgreSQL connector:

```
Expand Down Expand Up @@ -199,7 +199,7 @@ EXPLAIN SELECT c.custkey, o.orderkey
FROM orders o JOIN customer c ON c.custkey = o.custkey;
```

The following plan results from the PostgreSQL connector querying TPCH
The following plan results from the PostgreSQL connector querying TPC-H
data in a PostgreSQL database. It does not show any `Join` operator as a
result of the successful join push down.

Expand Down
2 changes: 1 addition & 1 deletion docs/src/main/sphinx/overview/concepts.md
Original file line number Diff line number Diff line change
Expand Up @@ -164,7 +164,7 @@ Trino contains [many built-in connectors](/connector):
[Prometheus](/connector/prometheus), [SingleStore](/connector/singlestore),
and [Snowflake](/connector/snowflake) connectors.
* A number of other utility connectors such as the [JMX](/connector/jmx),
[System](/connector/system), and [TPCH](/connector/tpch) connectors.
[System](/connector/system), and [TPC-H](/connector/tpch) connectors.

Every catalog uses a specific connector. If you examine a catalog configuration
file, you see that each contains a mandatory property `connector.name` with the
Expand Down
2 changes: 1 addition & 1 deletion docs/src/main/sphinx/release/release-0.148.md
Original file line number Diff line number Diff line change
Expand Up @@ -103,5 +103,5 @@ along with the server.

## Other connectors

- Add support for `varchar(n)` to the Redis, TPCH, MongoDB, Local File
- Add support for `varchar(n)` to the Redis, TPC-H, MongoDB, Local File
and Example HTTP connectors.
4 changes: 2 additions & 2 deletions docs/src/main/sphinx/release/release-0.183.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,11 +37,11 @@
- Improve error message for small ORC files that are completely corrupt or not actually ORC.
- Add predicate pushdown for the hidden column `"$path"`.

## TPCH
## TPC-H

- Add column statistics for schemas `tiny` and `sf1`.

## TPCDS
## TPC-DS

- Add column statistics for schemas `tiny` and `sf1`.

Expand Down
2 changes: 1 addition & 1 deletion docs/src/main/sphinx/release/release-0.184.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@
- Reduce system memory usage when reading table columns containing string values
from ORC or DWRF files. This can prevent high GC overhead or out-of-memory crashes.

## TPCDS
## TPC-DS

- Fix display of table statistics when running `SHOW STATS FOR ...`.

Expand Down
2 changes: 1 addition & 1 deletion docs/src/main/sphinx/release/release-0.60.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ anymore.
The {doc}`/client/cli` now supports `USE CATALOG` and
`USE SCHEMA`.

## TPCH connector
## TPC-H connector

We have added a new connector that will generate synthetic data following the
TPC-H specification. This connector makes it easy to generate large datasets for
Expand Down

0 comments on commit 70ed876

Please sign in to comment.