gpsscli start

gpsscli start

(Re)start a Greenplum Stream Server job.

Synopsis

gpsscli start job_name
     [--quit-at-eof] [--no-reuse] [{--force-reset-earliest | --force-reset-latest}]
     [--gpss-host host] [--gpss-port port]
     [-l | --log-dir directory] [-v | --verbose]

gpsscli start {-h | --help}

Description

The gpsscli start command (re)starts a job submitted to a specific Greenplum Stream Server (GPSS) instance. You identify the name of the job. You can also identify the data offset from which you want the operation to begin.

When you start a job, you initiate the data load operation. The job transitions from the Stopped to the Running state.

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.
--quit-at-eof
When you specify this option, gpsscli start reads all pending data, stops the job, and then exits. The default behaviour of gpsscli start is to start the job and then exit.
--no-reuse
The default behaviour of gpsscli start is to reuse an external table that it may have previously created for this job. When the gpss instance servicing this job is configured to not reuse external tables (ReuseTables: false), or when you specify the --no-reuse option, gpsscli start creates a new external table for the job.
--force-reset-earliest
gpsscli start returns an error if its recorded offset is behind that of the current earliest data offset for the client. Specify the --force-reset-earliest option to resume the load operation from the earliest available data offset known to the client.
--force-reset-latest
gpkafka start returns an error if its recorded offset is behind that of the current earliest data offset for the client. Specify the --force-reset-latest option to load only new data emitted from the client.
--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

Start the GPSS job identified by the name nsync_121118:

$ gpsscli start nsync_121118