Writer Directives

The directives that are processed by the PostGIS Raster writer are listed below. The suffixes shown are prefixed by the current <WriterKeyword>_ in a mapping file. By default, the <WriterKeyword> for the PostGIS raster writer is POSTGIS_RASTER_OUT.

DATASET/DATABASE, HOST, PORT, USER_NAME, PASSWORD

These directives operate in the same manner as they do for the PostGIS raster reader.

START_TRANSACTION

This statement tells the PostGIS raster writer module when to start actually writing features into the database.

The PostGIS raster writer does not write any features until the feature number of features are skipped, and then it begins writing the following features. Normally, the value specified is zero – a non-zero value is only specified when a data load operation is being resumed after failing partway through.

Required/Optional

Optional

Mapping File Syntax

POSTGIS_RASTER_OUT_START_TRANSACTION 0

Workbench Parameter

Starting Feature

TRANSACTION_INTERVAL

This directive determines the number of features that FME will place in each transaction before a transaction is committed to the database.

If the POSTGIS_RASTER_OUT_TRANSACTION_INTERVAL statement is not specified, then a value of 1000 is used as the transaction interval.

Required/Optional

Optional

Mapping File Syntax

POSTGIS_RASTER_OUT_TRANSACTION_INTERVAL 2000

Workbench Parameter: Features Per Transaction

BULK_COPY

This statement tells the PostGIS raster writer module to insert data into the database using either SQL INSERT statements or the SQL COPY command. The default option is the bulk copy using the COPY command, which yields the best performance.

Required/Optional

Optional

Mapping File Syntax

POSTGIS_RASTER_OUT_BULK_COPY YES

Note: The bulk delimiter escaping has improved, and therefore it is no longer necessary as a backup measure. However, if individual inserts are desired, this option can be set to NO.

Workbench Parameter

Bulk Insert

SPATIAL_COLUMN_NAME

The default value of rast creates a spatial column with the name “rast” on the destination tables by default. This value can also be set specifically for individual feature types.

Note: This directive only applies at the time of workspace or mapping file generation.