gpsscli progress

gpsscli progress

Check the progress of a Greenplum Stream Server job.

Synopsis

gpsscli progress job_name
     [--partition] [--gpss-host host] [--gpss-port port]
     [-l | --log-dir directory] [-v | --verbose]

gpsscli progress {-h | --help}

Description

The gpsscli progress command displays the progress of a job submitted to a Greenplum Stream Server (GPSS) instance. The command displays time, offset information, and message size for each data load operation real-time. By default, gpsscli progress displays information per-batch. You can specify the --partition option to display progress information on a per-partition basis.

gpsscli progress waits indefinitely; the command exits when the job is stopped or GPSS encounters an error.

If the GPSS instance to which you want to send the request is not running on the default host (127.0.0.1) or the default port number (5000), you can specify the GPSS host and/or port via command line options.

Options

job_name
The identifier of a previously-submitted GPSS job. You can specify a job name when you run gpsscli submit, or the command returns a unique job identifier.
--partition
By default, GPSS outputs the job progress by batch, and displays the start and end times, the message number and size, and the number of inserted and rejected rows per batch. When you specify the --partition option, GPSS outputs the job progress by partition, and displays the partition identifier, the start and end times, the beginning and ending offsets, and the message size per partition.
--gpss-host host
Specify the GPSS host. The default host address is 127.0.0.1.
--gpss-port port
Specify the GPSS port number. The default port number is 5000.
-l | --log-dir directory
Specify the directory to which GPSS writes client command log files. GPSS must have write permission to the directory. GPSS creates the log directory if it does not exist.
If you do not provide this option, GPSS writes gpsscli client log files to the $HOME/gpAdminLogs directory.
-v | --verbose
The default behaviour of the command utility is to display information and error messages to stdout. When you specify the --verbose option, GPSS also outputs debug-level messages about the operation.
-h | --help
Show command utility help, and then exit.

Examples

Display the progress of the GPSS job identified by the name nsync_121118:

$ gpsscli progress nsync_121118

Display the per-partition progress of the GPSS job identified by the name nsync_121118:

$ gpsscli progress nsync_121118 --partition