gpfdist:// Protocol

A newer version of this documentation is available. Click here to view the most up-to-date release of the Greenplum 4.x documentation.

gpfdist:// Protocol

The gpfdist:// protocol is used in a URI to reference a running gpfdist instance. The gpfdist utility serves external data files from a directory on a file host to all Greenplum Database segments in parallel.

gpfdist is located in the $GPHOME/bin directory on your Greenplum Database master host and on each segment host.

Run gpfdist on the host where the external data files reside. gpfdist uncompresses gzip (.gz) and bzip2 (.bz2) files automatically. You can use the wildcard character (*) or other C-style pattern matching to denote multiple files to read. The files specified are assumed to be relative to the directory that you specified when you started the gpfdist instance.

All primary segments access the external file(s) in parallel, subject to the number of segments set in the gp_external_max_segments server configuration parameter. Use multiple gpfdist data sources in a CREATE EXTERNAL TABLE statement to scale the external table's scan performance. For more information about configuring gpfdist, see Using the Greenplum Parallel File Server (gpfdist).

See the gpfdist reference documentation for more information about using gpfdist with external tables.