Greenplum Database Tutorials

For use with the Greenplum Database Sandbox

Data Loading

Loading external data into Greenplum Database tables can be accomplished in different ways. We will use three methods to load the FAA data:

By using external tables in conjunction with Greenplum Database's parallel file server (gpfdist), administrators can achieve maximum parallelism and load bandwidth from their Greenplum Database system.

Figure 1. External Tables Using Greenplum Parallel File Server (gpfdist)

External Tables Using Greenplum Parallel File Server

Another Greenplum utility, gpload, runs a load task that you specify in a YAML-formatted control file. You describe the source data locations, format, transformations required, participating hosts, database destinations, and other particulars in the control file and gpload executes the load. This allows you to describe a complex task and execute it in a controlled, repeatable fashion.

In the following exercises, you load data into the tutorial database using each of these methods.


Load data with the INSERT statement

The faa.d_cancellation_codes table is a simple two-column look-up table, easily loaded with an INSERT statement.

  1. Change to the directory containing the FAA data and scripts:

    $ cd ~/gpdb-sandbox-tutorials/faa

  2. Use the \d psql meta-command to describe the faa.d_cancellation_codes table:

    tutorial=# \d d_cancellation_codes
    Table "faa.d_cancellation_codes"
       Column    | Type | Modifiers
     cancel_code | text |
     cancel_desc | text |
    Distributed by: (cancel_code)
  3. Load the data into the table with a multirow INSERT statement (alternatively issue \i insert_into_cancellation_codes.sql):

    tutorial=# INSERT INTO faa.d_cancellation_codes
    tutorial-# VALUES ('A', 'Carrier'),
    tutorial-# ('B', 'Weather'),
    tutorial-# ('C', 'NAS'),
    tutorial-# ('D', 'Security'),
    tutorial-# ('', 'none');
    INSERT 0 5

Load data with the COPY statement

The COPY statement moves data between the file system and database tables. Data for five of the FAA tables is in the following CSV-formatted text files:

  1. In a text editor, review the .csv data files.

    • L_AIRLINE_ID.csv
    • L_AIRPORTS.csv
    • L_DISTANCE_GROUP_250.csv
      Notice that the first line of each file contains the column names and that the last line of the file contains the characters “.”, which signals the end of the input data.
  2. In a text editor, review the following scripts:

    • copy_into_airlines.sql
    • copy_into_airports.sql
    • copy_into_delay_groups.sql
    • copy_into_distance_groups.sql
    • copy_into_wac.sql
      The HEADER keyword prevents the \copy command from interpreting the column names as data.
  3. Run the following scripts to load the data:

    tutorial-# =# \i copy_into_airlines.sql
    tutorial-# =# \i copy_into_airports.sql
    tutorial-# =# \i copy_into_delay_groups.sql
    tutorial-# =# \i copy_into_distance_groups.sql
    tutorial-# =# \i copy_into_wac.sql

Load data with gpdist

For the FAA fact table, we will use an ETL (Extract, Transform, Load) process to load data from the source gzip files into a loading table, and then insert the data into a query and reporting table. For the best load speed, use the gpfdist Greenplum utility to distribute the rows to the segments. In a production system, gpfdist runs on the servers where the data is located. With a single-node Greenplum Database instance, there is only one host, and you run gpdist on it. Starting gpfdist is like starting a file server; there is no data movement until a request is made on the process.

Note: This exercise loads data using the Greenplum Database external table feature to move data from external data files into the database. Moving data between the database and external tables is a security consideration, so only superusers are permitted to use the feature. Therefore, you will run this exercise as the gpadmin database user.

  1. Execute gpfdist. Use the –d switch to set the “home” directory used to search for files in the faa directory. Use the –p switch to set the port and background the process.

    $ gpfdist -d ~/gpdb-sandbox-tutorials/faa -p 8081 > /tmp/gpfdist.log 2>&1 &

  2. Check that gpfdist is running with the ps command:

    $ ps -A | grep gpfdist

  3. View the contents of the gpfdist log.

    more /tmp/gpfdist.log

  4. Start a psql session as gpadmin and execute the create_load_tables.sql script. This script creates two tables: the faa_otp_load table, into which gpdist will load the data, and the faa_load_errors table, where load errors will be logged. (The faa_load_errors table may already exist. Ignore the error message.) The faa_otp_load table is structured to match the format of the input data from the FAA Web site.

    $ psql -U gpadmin tutorial

    tutorial=# \i create_load_tables.sql
  5. Create an external table definition with the same structure as the faa_otp_load table.

    tutorial=# \i create_ext_table.sql
    psql:create_ext_table.sql:5: NOTICE:  HEADER means that each one
    of the data files has a header row.

    This is a pure metadata operation. No data has moved from the data files on the host to the database yet. The external table definition references files in the faa directory that match the pattern otp*.gz. There are two matching files, one containing data for December 2009, the other for January 2010.

  6. Move data from the external table to the faa_otp_load table.

    tutorial=#  INSERT INTO faa.faa_otp_load SELECT * FROM faa.ext_load_otp;
    NOTICE:  Found 26526 data formatting errors (26526 or more input rows).
    Rejected related input data.
    INSERT 0 1024552

    Greenplum moves data from the gzip files into the load table in the database. In a production environment, you could have many gpfdist processes running, one on each host or several on one host, each on a separate port number.

  7. Examine the errors briefly. (The \x on psql meta-command changes the display of the results to one line per column, which is easier to read for some result sets.)

    tutorial=# \x
    Expanded display is on.
    tutorial=# SELECT DISTINCT relname, errmsg, count(*)
               FROM faa.faa_load_errors GROUP BY 1,2;
    -[ RECORD 1 ]-------------------------------------------------
    relname | ext_load_otp
    errmsg  | invalid input syntax for integer: "", column deptime
    count   | 26526
  8. Exit the psql shell:

    tutorial=# \q

Load data with gpload

Greenplum provides a wrapper program for gpfdist called gpload that does much of the work of setting up the external table and the data movement. In this exercise, you reload the faa_otp_load table using the gpload utility.

  1. Since gpload executes gpfdist, you must first kill the gpfdist process you started in the previous exercise.

    [gpadmin@gpdb-sandbox faa]$ ps -A | grep gpfdist
    4035 pts/0    00:00:02 gpfdist

    Your process id will not be the same, so kill the appropriate one with the kill command, or just use the simpler killall command:

      gpadmin@gpdb-sandbox faa]$ killall gpfdist
      [1]+  Exit 1    gpfdist -d $HOME/gpdb-sandbox-tutorials/faa -p   8081 > /tmp/  gpfdist.log 2>&1
  2. Edit and customize the gpload.yaml input file. Be sure to set the correct path to the faa directory. Notice the TRUNCATE: true preload instruction ensures that the data loaded in the previous exercise will be removed before the load in this exercise starts.

    vi gpload.yaml

    # describe the Greenplum database parameters
    DATABASE: tutorial
    USER: gpadmin
    HOST: localhost
    PORT: 5432
    # describe the location of the source files
    # in this example, the database master lives on the same host as the source files
        - SOURCE:
               - gpdb-sandbox
             PORT: 8081
               - /Users/gpadmin/gpdb-sandbox-tutorials/faa/otp*.gz
        - FORMAT: csv
        - QUOTE: '"'
        - ERROR_LIMIT: 50000
        - ERROR_TABLE: faa.faa_load_errors
        - TABLE: faa.faa_otp_load
        - MODE: INSERT
        - TRUNCATE: true
  3. Execute gpload with the gpload.yaml input file. (Include the -v flag if you want to see details of the loading process.)

    $ gpload -f gpload.yaml -l gpload.log

    2015-10-21 15:05:39|INFO|gpload session started 2015-10-21 15:05:39
    2015-10-21 15:05:39|INFO|started gpfdist -p 8081 -P 8082 -f "/home/gpadmin/gpdb-sandbox-tutorials/faa/otp*.gz" -t 30
    2015-10-21 15:05:58|WARN|26528 bad rows
    2015-10-21 15:05:58|INFO|running time: 18.64 seconds
    2015-10-21 15:05:58|INFO|rows Inserted          = 1024552
    2015-10-21 15:05:58|INFO|rows Updated           = 0
    2015-10-21 15:05:58|INFO|data formatting errors = 0
    2015-10-21 15:05:58|INFO|gpload succeeded with warnings

Create and Load fact tables

The final step of the ELT process is to move data from the load table to the fact table. For the FAA example, you create two fact tables. The faa.otp_r table is a row-oriented table, which will be loaded with data from the faa.faa_otp_load table. The faa.otp_c table has the same structure as the faa.otp_r table, but is column-oriented and partitioned. You will load it with data from the faa.otp_r table. The two tables will contain identical data and allow you to experiment with a column-oriented and partitioned table in addition to a traditional row-oriented table.

  1. Create the faa.otp_r and faa.otp_c tables by executing the create_fact_tables.sql script.

    $ psql -U gpadmin tutorial
    tutorial=# \i create_fact_tables.sql Review the create_fact_tables.sql script and note that some columns are excluded from the fact table and the data types of some columns are cast to a different datatype. The MADlib routines usually require float8 values, so the numeric columns are cast to float8 as part of the transform step.

  2. Load the data from the faa_otp_load table into the faa.otp_r table using the SQL INSERT FROM statement. Load the faa.otp_c table from the faa.otp_r table. Both of these loads can be accomplished by running the load_into_fact_table.sql script.

    tutorial=# \i load_into_fact_table.sql

Data loading summary

The ability to load billions of rows quickly into the Greenplum database is one of its key features. Using “Extract, Load and Transform” (ELT) allows load processes to make use of the massive parallelism of the Greenplum system by staging the data (perhaps just the use of external tables) and then applying data transformations within Greenplum Database. Set-based operations can be done in parallel, maximizing performance.

With other loading mechanisms such as COPY, data is loaded through the master in a single process. This does not take advantage of the parallel processing power of the Greenplum segments. External tables provide a means of leveraging the parallel processing power of the segments for data loading. Also, unlike other loading mechanisms, you can access multiple data sources with one SELECT of an external table.

External tables make static data available inside the database. External tables can be defined with file:// or gpfdist:// protocols. gpfdist is a file server program that loads files in parallel. Since the data is static, external tables can be rescanned during a query execution.

External Web tables allow http:// protocol or an EXECUTE clause to execute an operating system command or script. That data is assumed to be dynamic—query plans involving Web tables do not allow rescanning because the data could change during query execution. Execution plans may be slower, as data must be materialized (I/O) if it cannot fit in memory.

The script or process to populate a table with external Web tables may be executed on every segment host. It is possible, therefore, to have duplication of data. This is something to be aware of and check for when using Web tables, particularly with SQL extract calls to another database.

Project maintained by greenplum-db · Hosted on GitHub Pages — Theme by mattgraham