Updated on 2024-03-19 GMT+08:00

Creating a GDS Foreign Table and Importing TPC-H Data

This section describes how to import TPC-H 1000X data using a GDS foreign table. Table 1 lists the number of table rows in the TPC-H sets.

For TPC-DS, skip this section.

Number of Rows in TPC-H Tables

Table 1 TPC-H table rows

No.

Table Name

Number of Rows

1

region

5

2

nation

25

3

supplier

10,000,000

4

customer

150,000,000

5

part

200,000,000

6

partsupp

800,000,000

7

orders

1,500,000,000

8

lineitem

5,999,989,709

Procedure

  1. Run the following commands to create the eight target tables:

      1
      2
      3
      4
      5
      6
      7
      8
      9
     10
     11
     12
     13
     14
     15
     16
     17
     18
     19
     20
     21
     22
     23
     24
     25
     26
     27
     28
     29
     30
     31
     32
     33
     34
     35
     36
     37
     38
     39
     40
     41
     42
     43
     44
     45
     46
     47
     48
     49
     50
     51
     52
     53
     54
     55
     56
     57
     58
     59
     60
     61
     62
     63
     64
     65
     66
     67
     68
     69
     70
     71
     72
     73
     74
     75
     76
     77
     78
     79
     80
     81
     82
     83
     84
     85
     86
     87
     88
     89
     90
     91
     92
     93
     94
     95
     96
     97
     98
     99
    100
    101
    102
    103
    104
    105
    106
    107
    108
    109
    110
    111
    112
    113
    114
    115
    116
    117
    118
    119
    120
    121
    122
    123
    124
    125
    126
    127
    128
    129
    130
    131
    132
    133
    134
    135
    136
    DROP TABLE IF EXISTS region;
    CREATE TABLE region
    (
        R_REGIONKEY  INT NOT NULL,
        R_NAME       CHAR(25) NOT NULL,
        R_COMMENT    VARCHAR(152)
    )
    with (orientation = column)
    distribute by replication;
    
    DROP TABLE IF EXISTS nation;
    CREATE TABLE nation
    (
        N_NATIONKEY  INT NOT NULL,
        N_NAME       CHAR(25) NOT NULL,
        N_REGIONKEY  INT NOT NULL,
        N_COMMENT    VARCHAR(152)
    )
    with (orientation = column)
    distribute by replication;
    
    DROP TABLE IF EXISTS supplier;
    CREATE TABLE supplier
    (
        S_SUPPKEY     INT NOT NULL,
        S_NAME        CHAR(25) NOT NULL,
        S_ADDRESS     VARCHAR(40) NOT NULL,
        S_NATIONKEY   INT NOT NULL,
        S_PHONE       CHAR(15) NOT NULL,
        S_ACCTBAL     DECIMAL(15,2) NOT NULL,
        S_COMMENT     VARCHAR(101) NOT NULL
    )
    with (orientation = column)
    distribute by hash(S_SUPPKEY);
    
    DROP TABLE IF EXISTS customer;
    CREATE TABLE customer
    (
        C_CUSTKEY     INT NOT NULL,
        C_NAME        VARCHAR(25) NOT NULL,
        C_ADDRESS     VARCHAR(40) NOT NULL,
        C_NATIONKEY   INT NOT NULL,
        C_PHONE       CHAR(15) NOT NULL,
        C_ACCTBAL     DECIMAL(15,2)   NOT NULL,
        C_MKTSEGMENT  CHAR(10) NOT NULL,
        C_COMMENT     VARCHAR(117) NOT NULL
    )
    with (orientation = column)
    distribute by hash(C_CUSTKEY);
    
    DROP TABLE IF EXISTS part;
    CREATE TABLE part
    (
        P_PARTKEY     INT NOT NULL,
        P_NAME        VARCHAR(55) NOT NULL,
        P_MFGR        CHAR(25) NOT NULL,
        P_BRAND       CHAR(10) NOT NULL,
        P_TYPE        VARCHAR(25) NOT NULL,
        P_SIZE        INT NOT NULL,
        P_CONTAINER   CHAR(10) NOT NULL,
        P_RETAILPRICE DECIMAL(15,2) NOT NULL,
        P_COMMENT     VARCHAR(23) NOT NULL
    )
    with (orientation = column)
    distribute by hash(P_PARTKEY);
    
    DROP TABLE IF EXISTS partsupp;
    CREATE TABLE partsupp
    (
        PS_PARTKEY     INT NOT NULL,
        PS_SUPPKEY     INT NOT NULL,
        PS_AVAILQTY    INT NOT NULL,
        PS_SUPPLYCOST  DECIMAL(15,2)  NOT NULL,
        PS_COMMENT     VARCHAR(199) NOT NULL
    )
    with (orientation = column)
    distribute by hash(PS_PARTKEY);
    
    DROP TABLE IF EXISTS orders;
    CREATE TABLE orders
    (
        O_ORDERKEY       BIGINT NOT NULL,
        O_CUSTKEY        INT NOT NULL,
        O_ORDERSTATUS    CHAR(1) NOT NULL,
        O_TOTALPRICE     DECIMAL(15,2) NOT NULL,
        O_ORDERDATE      DATE NOT NULL,
        O_ORDERPRIORITY  CHAR(15) NOT NULL,
        O_CLERK          CHAR(15) NOT NULL,
        O_SHIPPRIORITY   INT NOT NULL,
        O_COMMENT        VARCHAR(79) NOT NULL
    )
    with (orientation = column)
    distribute by hash(O_ORDERKEY)
    PARTITION BY RANGE(O_ORDERDATE)
    (
        PARTITION O_ORDERDATE_1 VALUES LESS THAN('1993-01-01 00:00:00'),
        PARTITION O_ORDERDATE_2 VALUES LESS THAN('1994-01-01 00:00:00'),
        PARTITION O_ORDERDATE_3 VALUES LESS THAN('1995-01-01 00:00:00'),
        PARTITION O_ORDERDATE_4 VALUES LESS THAN('1996-01-01 00:00:00'),
        PARTITION O_ORDERDATE_5 VALUES LESS THAN('1997-01-01 00:00:00'),
        PARTITION O_ORDERDATE_6 VALUES LESS THAN('1998-01-01 00:00:00'),
        PARTITION O_ORDERDATE_7 VALUES LESS THAN('1999-01-01 00:00:00')
    );
    
    DROP TABLE IF EXISTS lineitem;
    CREATE TABLE lineitem
    (
        L_ORDERKEY    BIGINT NOT NULL,
        L_PARTKEY     INT NOT NULL,
        L_SUPPKEY     INT NOT NULL,
        L_LINENUMBER  INT NOT NULL,
        L_QUANTITY    DECIMAL(15,2) NOT NULL,
        L_EXTENDEDPRICE  DECIMAL(15,2) NOT NULL,
        L_DISCOUNT    DECIMAL(15,2) NOT NULL,
        L_TAX         DECIMAL(15,2) NOT NULL,
        L_RETURNFLAG  CHAR(1) NOT NULL,
        L_LINESTATUS  CHAR(1) NOT NULL,
        L_SHIPDATE    DATE NOT NULL,
        L_COMMITDATE  DATE NOT NULL,
        L_RECEIPTDATE DATE NOT NULL,
        L_SHIPINSTRUCT CHAR(25) NOT NULL,
        L_SHIPMODE     CHAR(10) NOT NULL,
        L_COMMENT      VARCHAR(44) NOT NULL
    )
    with (orientation = column)
    distribute by hash(L_ORDERKEY)
    PARTITION BY RANGE(L_SHIPDATE)
    (
        PARTITION L_SHIPDATE_1 VALUES LESS THAN('1993-01-01 00:00:00'),
        PARTITION L_SHIPDATE_2 VALUES LESS THAN('1994-01-01 00:00:00'),
        PARTITION L_SHIPDATE_3 VALUES LESS THAN('1995-01-01 00:00:00'),
        PARTITION L_SHIPDATE_4 VALUES LESS THAN('1996-01-01 00:00:00'),
        PARTITION L_SHIPDATE_5 VALUES LESS THAN('1997-01-01 00:00:00'),
        PARTITION L_SHIPDATE_6 VALUES LESS THAN('1998-01-01 00:00:00'),
        PARTITION L_SHIPDATE_7 VALUES LESS THAN('1999-01-01 00:00:00')
    );
    

  2. Run the following commands to create GDS foreign tables (eight tables):

    Replace the IP addresses and port numbers in gsfs:// 192.168.0.90:500x /xxx | gsfs:// 192.168.0.90:500x /xxx with the corresponding GDS listening IP addresses and port numbers provided in Installing and Starting GDS. Use vertical bars (|) to distinguish IP_Port groups. If multiple GDS servers are configured, add the listening IP addresses and ports of all GDS servers to the foreign table.

      1
      2
      3
      4
      5
      6
      7
      8
      9
     10
     11
     12
     13
     14
     15
     16
     17
     18
     19
     20
     21
     22
     23
     24
     25
     26
     27
     28
     29
     30
     31
     32
     33
     34
     35
     36
     37
     38
     39
     40
     41
     42
     43
     44
     45
     46
     47
     48
     49
     50
     51
     52
     53
     54
     55
     56
     57
     58
     59
     60
     61
     62
     63
     64
     65
     66
     67
     68
     69
     70
     71
     72
     73
     74
     75
     76
     77
     78
     79
     80
     81
     82
     83
     84
     85
     86
     87
     88
     89
     90
     91
     92
     93
     94
     95
     96
     97
     98
     99
    100
    101
    102
    103
    104
    105
    106
    107
    108
    109
    110
    111
    112
    113
    114
    115
    116
    117
    118
    119
    120
    121
    122
    123
    124
    125
    126
    127
    128
    129
    130
    131
    132
    133
    134
    135
    136
    137
    138
    139
    140
    141
    142
    143
    144
    145
    146
    147
    148
    149
    150
    151
    152
    153
    154
    155
    156
    157
    DROP FOREIGN TABLE IF EXISTS region_load;
    CREATE FOREIGN TABLE region_load
    (
        R_REGIONKEY  INT,
        R_NAME       CHAR(25), 
        R_COMMENT    VARCHAR(152)
    )
    SERVER gsmpp_server
    OPTIONS(location 'gsfs://192.168.0.90:5000/region*.tbl | gsfs://192.168.0.90:5001/region*.tbl',
    format 'text',
    delimiter '|',
    encoding 'utf8',
    mode 'Normal'
    );
    
    DROP FOREIGN TABLE IF EXISTS nation_load;
    CREATE FOREIGN TABLE nation_load
    (
        N_NATIONKEY  INT,
        N_NAME       CHAR(25),
        N_REGIONKEY  INT,
        N_COMMENT    VARCHAR(152)
    )
    SERVER gsmpp_server
    OPTIONS(location 'gsfs://192.168.0.90:5000/nation.tbl* | gsfs://192.168.0.90:5001/nation.tbl*',
    format 'text',
    delimiter '|',
    encoding 'utf8',
    mode 'Normal'
    );
    
    DROP FOREIGN TABLE IF EXISTS supplier_load;
    CREATE FOREIGN TABLE supplier_load
    (
        S_SUPPKEY     INT, 
        S_NAME        CHAR(25), 
        S_ADDRESS     VARCHAR(40), 
        S_NATIONKEY   INT, 
        S_PHONE       CHAR(15), 
        S_ACCTBAL     DECIMAL(15,2), 
        S_COMMENT     VARCHAR(101) 
    )
    SERVER gsmpp_server
    OPTIONS(location 'gsfs://192.168.0.90:5000/supplier.tbl* | gsfs://192.168.0.90:5001/supplier.tbl*',
    format 'text',
    delimiter '|',
    encoding 'utf8',
    mode 'Normal'
    );
    
    DROP FOREIGN TABLE IF EXISTS customer_load;
    CREATE FOREIGN TABLE customer_load
    (
        C_CUSTKEY     INT, 
        C_NAME        VARCHAR(25), 
        C_ADDRESS     VARCHAR(40), 
        C_NATIONKEY   INT, 
        C_PHONE       CHAR(15), 
        C_ACCTBAL     DECIMAL(15,2),   
        C_MKTSEGMENT  CHAR(10), 
        C_COMMENT     VARCHAR(117)
    )
    SERVER gsmpp_server
    OPTIONS(location 'gsfs://192.168.0.90:5000/customer.tbl* | gsfs://192.168.0.90:5001/customer.tbl*',
    format 'text',
    delimiter '|',
    encoding 'utf8',
    mode 'Normal'
    );
    
    DROP FOREIGN TABLE IF EXISTS part_load;
    CREATE FOREIGN TABLE part_load
    (
        P_PARTKEY     INT, 
        P_NAME        VARCHAR(55), 
        P_MFGR        CHAR(25), 
        P_BRAND       CHAR(10), 
        P_TYPE        VARCHAR(25), 
        P_SIZE        INT, 
        P_CONTAINER   CHAR(10), 
        P_RETAILPRICE DECIMAL(15,2), 
        P_COMMENT     VARCHAR(23) 
    )
    SERVER gsmpp_server
    OPTIONS(location 'gsfs://192.168.0.90:5000/part.tbl* | gsfs://192.168.0.90:5001/part.tbl*',
    format 'text',
    delimiter '|',
    encoding 'utf8',
    mode 'Normal'
    );
    
    DROP FOREIGN TABLE IF EXISTS partsupp_load;
    CREATE FOREIGN TABLE partsupp_load
    (
        PS_PARTKEY     INT, 
        PS_SUPPKEY     INT,
        PS_AVAILQTY    INT, 
        PS_SUPPLYCOST  DECIMAL(15,2),  
        PS_COMMENT     VARCHAR(199) 
    )
    SERVER gsmpp_server
    OPTIONS(location 'gsfs://192.168.0.90:5000/partsupp.tbl* | gsfs://192.168.0.90:5001/partsupp.tbl*',
    format 'text',
    delimiter '|',
    encoding 'utf8',
    mode 'Normal'
    );
    
    
    DROP FOREIGN TABLE IF EXISTS orders_load;
    CREATE FOREIGN TABLE orders_load
    (
        O_ORDERKEY       BIGINT, 
        O_CUSTKEY        INT, 
        O_ORDERSTATUS    CHAR(1), 
        O_TOTALPRICE     DECIMAL(15,2), 
        O_ORDERDATE      DATE, 
        O_ORDERPRIORITY  CHAR(15), 
        O_CLERK          CHAR(15), 
        O_SHIPPRIORITY   INT, 
        O_COMMENT        VARCHAR(79) 
    )
    SERVER gsmpp_server
    OPTIONS(location 'gsfs://192.168.0.90:5000/orders.tbl* | gsfs://192.168.0.90:5001/orders.tbl*',
    format 'text',
    delimiter '|',
    encoding 'utf8',
    mode 'Normal'
    );
    
    DROP FOREIGN TABLE IF EXISTS lineitem_load;
    CREATE FOREIGN TABLE lineitem_load
    (
        L_ORDERKEY    BIGINT,
        L_PARTKEY     INT,
        L_SUPPKEY     INT,
        L_LINENUMBER  INT,
        L_QUANTITY    DECIMAL(15,2), 
        L_EXTENDEDPRICE  DECIMAL(15,2), 
        L_DISCOUNT    DECIMAL(15,2), 
        L_TAX         DECIMAL(15,2), 
        L_RETURNFLAG  CHAR(1), 
        L_LINESTATUS  CHAR(1), 
        L_SHIPDATE    DATE, 
        L_COMMITDATE  DATE, 
        L_RECEIPTDATE DATE, 
        L_SHIPINSTRUCT CHAR(25), 
        L_SHIPMODE     CHAR(10), 
        L_COMMENT      VARCHAR(44)
    )
    SERVER gsmpp_server
    OPTIONS(location 'gsfs://192.168.0.90:5000/lineitem.tbl* | gsfs://192.168.0.90:5001/lineitem.tbl*',
    format 'text',
    delimiter '|',
    encoding 'utf8',
    mode 'Normal'
    );
    

  3. Run the following command to import data:

    1
    2
    3
    4
    5
    6
    7
    8
    INSERT INTO region SELECT * FROM region_load;
    INSERT INTO nation SELECT * FROM nation_load;
    INSERT INTO supplier SELECT * FROM supplier_load;
    INSERT INTO customer SELECT * FROM customer_load;
    INSERT INTO part SELECT * FROM part_load;
    INSERT INTO partsupp SELECT * FROM partsupp_load;
    INSERT INTO orders SELECT * FROM orders_load;
    INSERT INTO lineitem SELECT * FROM lineitem_load;