Mapping File Directives

Reader Directives

The suffixes listed are prefixed by the current <ReaderKeyword> in a mapping file. By default, the <ReaderKeyword> for the DB2 Spatial reader is DB2SPATIAL.

DEF

Required/Optional

Optional

The syntax of the definition is:

DB2SPATIAL_DEF <tableName> \
	[db2_type <type>] \
	[db2_envelope_minx <xmin>]	\
	[db2_envelope_miny <ymax>]	\
	[db2_envelope_maxx <xmin>]	\
	[db2_envelope_maxy <ymax>]	\
	[db2_spatial_predicate <spatialPredicate>] \
	[db2_predicate_result <predicateResult>] \
	[db2_where_clause <whereClause>]	\
	[db2_sql <sqlQuery>] \
	[<fieldName> <fieldType>] +

The <fieldType> of each field must be given, but it is not verified against the database definition for the field. In effect, it is ignored.

The column(s) which has geometry should not be specified on the DEF line. In case a feature type has more than one registered geometry column or layer, than DB2 Spatial Reader module will arbitrarily choose one as the primary geometry column and consider the other(s) as attribute columns.

The <tableName> can be either fully qualified or not. A fully qualified table name consist of two parts separated by a period (.). The first part is the <schema name> and second part is the <table name>. The <table name> part must match a table in the schema specified by the <schema name> part of the <tableName>. If a schema name is not provided as part of the table name, then the username will be considered the schema name. This will be used as the feature type of all the features read from the table. For example, if a user wants to read a table from its own schema then only the table name can be provided, but if the user wants to read from a different user’s schema, then table name should be qualified with schema name.

The definition allows specification of separate search parameters for each table. If any of the configuration parameters are given, they will override, for that table, whatever global values have been specified by the reader directives listed above. If any of these parameters is not specified, the global values will be used.

The following table summarizes the definition line configuration parameters:

Parameter

Contents

db2_type

This specifies the type of geometry the features to be read from the layer will have.

db2_geometry_column

This specifies the spatial layer or geometry column to use for reading spatial data in case the table has multiple geometry/spatial columns.

db2_envelope_minx db2_envelope_miny db2_envelope_maxx db2_envelope_maxy

These specify the spatial extent of the features to be read from the layer. If these are not all specified, the values from the <ReaderKeyword>_SEARCH_ENVELOPE directive are used.

db2_spatial_predicate

This specifies the spatial predicate to be tested for this layer. Its default value is set to INTERSECTS.

Note: This DEF line option is valid only if there is a valid spatial envelope specified by db2_envelope_minx, db2_envelope_miny, db2_envelope_maxx and db2_envelope_maxy.

db2_predicate_result

This specifies the result to be used for the Spatial predicate specified in db2_spatial_predicate option.

db2_where_clause

This specifies the SQL WHERE clause applied to the attributes of the layer’s features to limit the set of features returned. If this is not specified, the value of the <ReaderKeyword>_WHERE_CLAUSE directive is used.

db2_sql

This specifies an SQL SELECT query to be used as the source for the results. If this is specified, the DB2 Spatial reader will execute the query, and use the resulting rows as the features instead of reading from the table <layerName>. All returned features will have a feature type of <layerName>, and attributes for all columns selected by the query.

The db2_where_clause and all parameters which specify a spatial constraint – db2_envelope_minx, db2_interaction, and so on – are ignored if db2_sql is supplied.

If no <whereClause> is specified, all rows in the table will be read and returned as individual features. If a <whereClause> is specified, only those rows that are selected by the clause will be read. Note that the <whereClause> does not include the word “where”.

The db2_sql parameter allows a user to specify an arbitrary SQL SELECT query. If this is specified, FME will execute the query, and use each row of data returned from the query to define a feature. Each of these features will be given the feature type named in the DEF line, and will contain attributes for every column returned by the SELECT. In this case, all DEF line parameters regarding a WHERE clause or spatial querying is ignored, as it is possible to embed this information directly in the text of the <sqlQuery>.

The following example joins the tables ROADS and ROADNAMES, placing the resulting data into FME features with a feature type of MYROADS. Imagine that ROADS defines the geometry for the roads, and has a numeric field named ID, and that ROADNAMES joins the numeric field ID with character arrays with the roads’ names.

DB2SPATIAL_DEF MYROADS	\
	db2_sql “SELECT * FROM ROADS, \
             ROADNAMES WHERE ROADS.ID = ROADNAMES.ID”

IDs

Required/Optional: Optional

This optional specification is used to limit the available and defined database tables files that will be read. If no IDs are specified, then all defined and available tables are read. The syntax of the IDs directive is:

DB2SPATIAL_IDs <featureType1> \
	<featureType2> \
	<featureTypeN> 

The feature types must match those used in DEF lines.

The example below selects only the ROADS table for input during a translation:

DB2SPATIAL_IDs ROADS

Workbench Parameter: Feature Types to Read

SIMPLIFY_AGGREGATES

Required/Optional: Optional

This directive specifies whether multi-geometry or aggregate features with one member are read as stored or simplified and read as single member. e.g. an aggregate of points or multipoint features with only one point will be returned as a simple point if the value of this directive is YES.

Values: YES | NO

Default value: NO

Example:

The syntax of the DB2SPATIAL_SIMPLIFY_AGGREGATES directive is:

DB2SPATIAL_SIMPLIFY_AGGREGATES YES

Workbench Parameter: Simplify Aggregate Geometry

SPATIAL_PREDICATE

Required/Optional: Optional

This specifies the type of spatial relationship which must exist between the search envelope and the geometry in the target layer. Any supported relationship, in combination with the SPATIAL_PREDICATE_RESULT directive, can be used to filter the features being read.

Values: CONTAINS, CROSSES, DISJOINT, EQUALS, INTERSECTS, ORDERINGEQUALS, OVERLAPS, TOUCHES, WITHIN

Default value: INTERSECTS

For example,

DB2SPATIAL_SPATIAL_PREDICATE INTERSECTS
DB2SPATIAL_SPATIAL_PREDICATE_RESULT FALSE

This would result in a spatial filter using DB2 Spatial’s native spatial function

DB2GSE.ST_Intersects( g1 geometry, g2 geometry) = 0

where g1 is the search envelope and g2 is the target feature. This will cause FME to return only those features that satisfy the spatial predicate above.

The following table lists the valid spatial predicate relationships.

Search Method

Description

CONTAINS

Determines whether the search envelope is completely contained by the target feature.

CROSSES

Determines whether the intersection of search envelope and the target feature results in a geometry object whose dimension is one less than the maximum dimension of the source geometries. Also determines if the intersection object contains points that are interior to both source geometries and are not equal to either of the source objects.

DISJOINT

Determines whether the intersection of search envelope with the target feature is an empty set.

EQUALS

Determines whether the search envelope and target feature are of the same type and have identical x,y coordinate values.

INTERSECTS

Determines whether the intersection of search envelope and target feature does not result in an empty set. This is the exact opposite of DISJOINT.

ORDERINGEQUALS

Determines whether the search envelope and target feature are equal and the coordinates are in the same order.

OVERLAPS

Determines whether the search envelope and target feature overlap each other.

TOUCHES

Determines whether any of the points common to search envelope and target feature intersect the interiors of both geometries. At least one geometry must be a linestring, polygon, multilinestring, multipolygon.

WITHIN

Determines whether the target feature is completely within the search envelope.

This is exactly opposite to CONTAINS.

For more details on Spatial predicate, please refer to the IBM DB2 Spatial Extender User’s Guide and Reference.

Workbench Parameter: Spatial Relationship to Search Envelope

WHERECLAUSE

Required/Optional: Optional

This specifies an SQL WHERE clause, which is applied to the table’s columns to limit the resulting features. This feature is currently limited to apply only to the attributes of the target table, and does not allow for joining multiple tables together. The effect of table joins can be achieved using the object model, by specifying the entire queries in the DEF line with a db2_sql parameter.

By default, there is no WHERE clause applied to the results, so all features in the layer are returned.

Example:

DB2SPATIAL_WHERECLAUSE “se_row_id > 45”

Workbench Parameter: WHERE Clause

BEGIN_SQL{n}

Sometimes, you must execute some SQL statements prior to opening a table. For example, it may be necessary to ensure that a view exists before attempting to read from it.

Upon opening a connection to read from a database, the reader looks for the directive <ReaderKeyword>_BEGIN_SQL{n} (for n=0,1,2,...), and executes each such directive’s value as an SQL statement on the database connection.

Multiple SQL commands can be delimited by a character specified using the FME_SQL_DELIMITER directive, embedded at the beginning of the SQL block. The single character following this directive will be used to split the SQL block into SQL statements, which will then be sent to the database for execution. Note: Include a space before the character.

For example:

FME_SQL_DELIMITER ;
DELETE FROM instructors ;
DELETE FROM people
WHERE LastName='Doe' AND FirstName='John'

Multiple delimiters are not allowed and the delimiter character will be stripped before being sent to the database.

Any errors occurring during the execution of these SQL statements will normally terminate the reader or writer (depending on where the SQL statement is executed) with an error. If the specified statement is preceded by a hyphen (“-”), such errors are ignored.

Required/Optional

Optional

Workbench Parameter

Begin SQL

END_SQL{n}

Sometimes you must execute some SQL statements after a set of tables has been read. For example, it may be necessary to clean up a temporary view after creating it in BEGIN_SQL.

Just before closing a connection on a database, the reader looks for the directive <ReaderKeyword>_END_SQL{n} (for n=0,1,2,...), and executes each such directive’s value as an SQL statement on the database connection.

Multiple SQL commands can be delimited by a character specified using the FME_SQL_DELIMITER directive, embedded at the beginning of the SQL block. The single character following this directive will be used to split the SQL block into SQL statements, which will then be sent to the database for execution. Note: Include a space before the character.

For example:

FME_SQL_DELIMITER ;
DELETE FROM instructors ;
DELETE FROM people
WHERE LastName='Doe' AND FirstName='John'

Multiple delimiters are not allowed and the delimiter character will be stripped before being sent to the database.

Any errors occurring during the execution of these SQL statements will normally terminate the reader or writer (depending on where the SQL statement is executed) with an error. If the specified statement is preceded by a hyphen (“-”), such errors are ignored.

Required/Optional

Optional

Workbench Parameter

End SQL

PERSISTENT_CONNECTION

A user may want to keep a connection to a database for reuse during a particular FME session. For example, when running a batch of 100 mapping files on the same database connection, it may be desirable to keep a connection open and save the processing time required to make and break a database connection.

A database connection will be determined to be the same when the database name, the username, the password, and the transaction interval are the same.

Values: YES | NO

Default value: NO

Example:

DB2SPATIAL_PERSISTENT_CONNECTION YES

Workbench Parameter: Persistent Connection

RETRIEVE_ALL_SCHEMAS

This parameter is applicable only when generating a mapping file, generating a workspace, or when retrieving schemas in an FME Objects application.

When set to yes, schemas for all of the tables and feature classes in the database are returned.

When set to no (or missing), and if RETRIEVE_ALL_TABLE_NAMES is similarly set to no (or missing), only schemas requested by the IDs parameter are returned.

Required/Optional

Optional

Values

YES | NO (default)

NO: The reader will return the schemas for the feature types specified in the IDs. If no features are specified in IDs, then FME returns the schema features for all the tables.

If this value is not specified, then it is assumed to be No.

YES: Indicates to the reader to return all the schemas of the tables in the database.

Mapping File Syntax

Not applicable.

FME Objects applications would include RETRIEVE_ALL_SCHEMAS followed by “YES” in the parameters array passed to IFMEUniversalReader::open().

Workbench Parameter

Not applicable

RETRIEVE_ALL_TABLE_NAMES

This parameter is only applicable when generating a mapping file, generating a workspace or when retrieving schemas in an FME Objects application.

When set to yes, and if RETRIEVE_ALL_SCHEMAS is set to no (or missing), names for all of the tables and feature classes in the database are returned. When set to no (or missing), and if RETRIEVE_ALL_SCHEMAS is similarly set to no (or missing), the schemas requested by the IDs directive are returned.

Note: If RETRIEVE_ALL_SCHEMAS is also set to Yes, then RETRIEVE_ALL_SCHEMAS takes precedence.

Required/Optional

Optional

Values

YES | NO (default)

Mapping File Syntax

Not applicable.

FME Objects applications would include RETRIEVE_ALL_TABLE_NAMES followed by “YES” in the parameters array passed to IFMEUniversalReader::open().

Workbench Parameter

Not applicable (used when you browse a Table List)

SEARCH_ENVELOPE

Using the minimum and maximum x and y parameters, define a bounding box that will be used to filter the input features. Only features that interact with the bounding box are returned.

If all four coordinates of the search envelope are specified as 0, the search envelope will be disabled.

Mapping File Syntax

<ReaderKeyword>_SEARCH_ENVELOPE <minX> <minY> <maxX> <maxY>

Note: If all four coordinates of the search envelope are specified as zero, the search envelope will be disabled.

Required/Optional

Optional

Workbench Parameter

Minimum X, Minimum Y, Maximum X, Maximum Y

SEARCH_ENVELOPE_COORDINATE_SYSTEM

This directive specifies the coordinate system of the search envelope if it is different than the coordinate system of the data.

The COORDINATE_SYSTEM directive, which specifies the coordinate system associated with the data to be read, must always be set if the SEARCH_ENVELOPE_COORDINATE_SYSTEM directive is set.

If this directive is set, the minimum and maximum points of the search envelope are reprojected from the SEARCH_ENVELOPE_COORDINATE_SYSTEM to the reader COORDINATE_SYSTEM prior to applying the envelope.

Required/Optional

Optional

Mapping File Syntax

<ReaderKeyword>_SEARCH_ENVELOPE_COORDINATE_SYSTEM <coordinate system>

Workbench Parameter

Search Envelope Coordinate System

CLIP_TO_ENVELOPE

This directive specifies whether or not FME should clip features to the envelope specified in the SEARCH_ENVELOPE directive.

Values

YES | NO (default)

Mapping File Syntax

<ReaderKeyword>_CLIP_TO_ENVELOPE [yes | no]

Workbench Parameter

Clip To Envelope

EXPOSED_ATTRS

This directive allows the selection of format attributes to be explicitly added to the reader feature type.

This is similar to exposing format attributes on a reader feature type once it has been generated; however, it is even more powerful because it enables schema-driven applications other than Workbench to access and leverage these attributes as if they were explicitly on the schema as user attributes.

The result of picking a list of attributes is a comma-separated list of attribute names and types that will be added to the schema features. Currently all reader feature types will receive the same set of additional schema attributes for a given instance of the reader.

Required/Optional

Optional

Mapping File Syntax

Not applicable.

While it is possible for FME Objects applications to invoke this directive, the required format is not documented.

This directive is intended for use in our GUI applications (for example, Workbench) only.

Workbench Parameter

Additional Attributes to Expose

Writer Directives

The directives processed by the DB2 Spatial writer are listed below. The suffixes shown are prefixed by the current <WriterKeyword> in a mapping file. By default, the <WriterKeyword> for the DB2 Spatial writer is DB2SPATIAL when using the object model.

DEF

Required/Optional: Optional

Each DB2 Spatial table must be defined before it can be written. The general form of a DB2 Spatial definition statement is:

DB2SPATIAL_DEF <tableName>  \
    [db2_overwrite_table <YES|NO|TRUNCATE>] \
    [db2_multi_geometry <YES|NO|FIRST_FEATURE>] \
    [db2_geometry_column <geometry>] \
    [db2_offset_x  <x offset value>] \
    [db2_offset_y <y offset value>] \
    [db2_scale_x <x and y scale value>] \
    [db2_grid_0 <finest grid size>] \
    [db2_grid_1 <middle grid size>] \
    [db2_grid_2 <coarsest grid size>] \
    [db2_sql <sql statement>] \
    [db2_update_key_columns <column>[,<column>]...] \
	 	[db2_delete_key_columns <column>[,<column>]...] \
		[<fieldName> <fieldType>]*

The table definition allows complete control of the layer that will be created. If the layer already exists, the majority of the DEF line parameters will be ignored and need not be given. As well, if the table already exists in the database, then it is not necessary to list the fields and their types – FME will use the schema information in the database to determine this. FME will ignore the field names and types specified on the DEF line, except for the one with type geometry.

If the table does not exist, then the field names and types are used to first create the table. In any case, if a <fieldType> is given, it may be any field type supported by the target database.

The DB2 Spatial writer will use db2_geometry_column parameter to set the name of geometry column for the new table. If the db2_geometry_column parameter is not specified then a default name “geometr” will be used for the geometry column.

The configuration parameters present on the definition line are described in the following table:

Parameter

Contents

db2_overwrite_table

This parameter can be set to one of <YES|NO|TRUNCATE>.

  • YES: The table will be dropped if it exists, and then created.
  • NO: The table will be created if it does not exist.
  • TRUNCATE: The table will be created if it does not exist. If the table exists, all the rows from the table will be deleted.

db2_multi_geometry

This parameter is in effect only when creating a new table.

This specifies whether geometry features should be written as multi geometries (e.g. ST_MULTIPOINT) or single geometries (e.g. ST_POINT).

  • YES:  The table created has multi geometries (for example, when the geometry column type is ST_MULTIPOINT, point features are aggregated as IFMEMultiPoints and written out as ST_MULTIPOINT values).
  • NO: The geometry column of the created table is singular (that is, ST_POINT), and IFMEMulti geometries are split (e.g. IFMEMultiPoint split into IFMEPoints).
  • FIRST_FEATURE: The type of the geometry column will be determined based on the first feature entering the writer. For example, if the first feature contains an IFMEPoint, then the geometry column type will be ST_POINT.

Note that of the 3 options, YES is the least lossy. With the other 2 options, it is possible to have a single IFMEMultiPoint feature be broken up into multiple IFMEPoints, which would result in multiple rows in the target table.

db2_geometry_column

This parameter can be used to specify name of the spatial layer (geometry column name). If it is not specified db2 spatial writer module will use default name “geometry” for the spatial layer.

db2_offset_x

db2_offset_y

This parameter is enabled only when creating a new table. If this parameter is not 0, then it overrides the global OFFSET_X (OFFSET_Y) directive. This parameter is of type DOUBLE.

db2_offset_x and db2_offset_y correspond to the columns X_OFFSET (and MIN_X) and Y_OFFSET (and MIN_Y) in the catalog view DB2GSE.ST_SPATIAL_REFERENCE_SYSTEMS.

This parameter specifies the minimum x (y) coordinate of the spatial reference system for the target table. If a geometry feature has x (y) coordinates below this value, then the feature is rejected or translation is aborted depending on the value of the writer directive ABORT_ON_BAD_DATA.

db2_scale_x

This parameter is enabled only when creating a new table. If this parameter is not 1, then it overrides the global SCALE_X directive. This parameter is of type DOUBLE.

This parameter specifies the resolution of the spatial reference system. The resolution of the spatial reference system is equal to 1 divided by db2_scale_x. For example, if db2_scale_x is 1, all coordinates will be rounded to integers. As another example, if db2_scale_x is 10, 1/10 is 0.1, and all coordinates will be rounded to the nearest 0.1, which means a coordinate value of 2.149 will be written as 2.1.

db2_scale_x corresponds to the column X_SCALE and Y_SCALE in the catalog view DB2GSE.ST_SPATIAL_REFERENCE_SYSTEMS. Y_SCALE is constrained by the database to be identical to X_SCALE.

The parameters db2_offset_x, db2_offset_y, and db2_scale_x together define the maximum x and y coordinates in the spatial reference system for the target table, which are stored as MAX_X and MAX_Y in the corresponding row in the catalog view DB2GSE.SPATIAL_REFERENCE_SYSTEMS. If a geometry feature has x (y) coordinates above MAX_X (MAX_Y), then the feature is rejected or translation is aborted depending on the value of the writer directive ABORT_ON_BAD_DATA.

db2_grid_0

This parameter is enabled only when creating a new table.

This parameter specifies the finest spatial index grid size. If 0, then a spatial index is not created.

db2_grid_1

This parameter is enabled only when creating a new table.

This parameter specifies the middle spatial index grid size. If 0, then a spatial index is not created.

db2_grid_2

This parameter is enabled only when creating a new table.

This parameter specifies the coarsest spatial index grid size. If 0, then a spatial index is not created.

db2_sql

This specifies an SQL INSERT or UPDATE query to be used to define the results. If this is specified, the DB2 Spatial writer will execute the query, defining one row for each feature from FME. The values in the query are specified by embedding “?attrName” in the query itself, where attrName is the name of the FME feature’s attribute.

For example:

INSERT INTO MyTable VALUES(?ID,?NAME,?DESC)

In this example, the attributes named ID, NAME and DESC will be taken from each feature written to <tableName>.

or

INSERT INTO MyTable (ID,NAME)

VALUES(?ID,?NAME)

In this example, the attributes named ID and NAME will be taken from each feature written to <tableName>. If not all attributes are to be written, then a column list should be specified as shown in the second example statement where 2 out of 3 columns are being written.

It is also very important that the attributes named in the query must be listed on the DEF line so that FME knows what type to use. There is no necessary or implied correlation between the FME attribute name and the db2 column name.

db2_update_key_
columns

This instructs the DB2 Spatial writer to perform an UPDATE operation on the table, rather than performing an INSERT. The argument is a comma-separated list of the columns which are matched against the corresponding FME attributes’ values to specify which rows are to be updated with the other attribute values.

For example:

db2_update_key_columns ID,NAME

In this case the FME attribute is always matched against the db2 column with the same name. Also, the target table is always the feature type specified in the DEF line. Each column listed with the db2_update_key_columns directive must be defined with a type on the DEF line, in addition to the columns whose values will be updated by the operation. This cannot be used with db2_delete_key_columns. Also, the keys cannot be of type BLOB, CLOB, or LONG_VARCHAR.

db2_delete_key_
columns

This instructs the DB2 Spatial writer to perform a DELETE operation on the table, rather than performing an INSERT. The argument is a comma-separated list of the columns which are matched against the corresponding FME attributes’ values to specify which rows are to be deleted when their values match the other attribute values.

For example:

db2_delete_key_columns ID,NAME

would delete those rows in the table whose values match the attribute values passed in through this DEF line. The FME attribute is always matched against the DB2 Spatial column with the same name. Also, the target table is always the feature type specified in the DEF line. Each column listed with the db2_delete_key_columns directive must be defined with a type on the DEF line, in addition to the columns whose values will be updated by the operation. This cannot be used with db2_update_key_columns. Also, the keys cannot be of type BLOB, CLOB, or LONG_VARCHAR.

 

TRANSACTION_INTERVAL

This statement informs the FME about the number of features to be placed in each transaction before a transaction is committed to the database.

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

Parameter

Contents

<transaction_interval>

The number of features in a single transaction.

Default: 1000

Example:

DB2SPATIAL_TRANSACTION_INTERVAL 2500

Workbench Parameter: Transaction Interval

PERSISTENT_CONNECTION

Required/Optional: Optional

A user may want to keep a connection to a database for reuse during a particular FME session. For example, when running a batch of 100 mapping files on the same database connection, it may be desirable to keep a connection open and save the processing time required to make and break a database connection.

A database connection will be determined to be the same when the database name, the username, the password, and the transaction interval are the same.

Values: YES | NO

Default: NO

Example:

DB2SPATIAL_PERSISTENT_CONNECTION YES

Workbench Parameter: Persistent Connection

ABORT_ON_BAD_DATA

Required/Optional: Optional

Some features’ geometries may fail DB2 Spatial Extender’s check constraints based on the offset, scale, and coordinate system values. These features, as well as others with out-of-range or invalid attribute values, will be rejected and cannot be written to the database. If the value of this directive is YES then the translation will be aborted immediately after encountering such a problem. If this directive is set to NO then the translation will continue but the rejected features will not be written to the database.

Values: YES | NO

Default: YES

Example:

DB2SPATIAL_ABORT_ON_BAD_DATA YES

Workbench Parameter: Abort Translation On Bad Data

OFFSET_X

Required/Optional: Optional

This directive can be used to set the global x offset for the entire translation. If a dataset contains many different tables but the same x offset applies to all of them, then this is a convenient way of setting the x offset. This value can be overridden by DEF line parameter db2_offset_x.

Default: 0

Example:

DB2SPATIAL_OFFSET_X -12456

Workbench Parameter: Min X (X_OFFSET)

OFFSET_Y

Required/Optional: Optional

This directive is used only when creating new tables. It can be conveniently used to set the DEF line parameter db2_offset_y for all DEF lines in a writer. However, you can override this writer default in a DEF line by specifying a non-default value for db2_offset_y.

Please see documentation for the DEF line parameterdb2_offset_y for further details.

Default: 0

Example:

DB2SPATIAL_OFFSET_Y -1245

Workbench Parameter: Min Y (Y_OFFSET)

SCALE_X

Required/Optional: Optional

This directive is used only when creating new tables. It can be conveniently used to set the DEF line parameter db2_scale_x for all DEF lines in a writer. However, you can override this writer default in a DEF line by specifying a non-default value for db2_scale_x.

Please see documentation for the DEF line parameter db2_scale_x for further details.

Default: 1

Example:

DB2SPATIAL_SCALE_X 1000

Workbench Parameter: Scale Factor X SCALE

SCALE_Y

Required/Optional: Optional

This directive can be used to set the global y scale value for the entire translation. If a dataset contain many different tables but the same y scale applies to all of them, then this is a convenient way of setting the y scale value. This value can be overridden by DEF line parameter db2_scale_y.

Default: 1

Example:

DB2SPATIAL_SCALE_Y 1000

GRID_0

Required/Optional: Optional

This directive can be used to set the global finest grid size for the spatial grid index. If a dataset contains many different tables but the same finest grid size applies to all of them, then this is a convenient way of setting the finest grid size value. This value can be overridden by DEF line parameter db2_grid_0.

Default: 0

Example:

DB2SPATIAL_GRID_0 10

Workbench Parameter: Finest Spatial Grid Index Size

GRID_1

Required/Optional: Optional

This directive can be used to set the global middle grid size for the spatial grid index. If a dataset contains many different tables but the same middle grid size applies to all of them, then this is a convenient way of setting the middle grid size value. This value can be overridden by DEF line parameter db2_grid_1.

Default: 0

Example:

DB2SPATIAL_GRID_1 100

Workbench Parameter: Middle Spatial Grid Index Size

GRID_2

Required/Optional: Optional

This directive can be used to set the global coarsest grid size for the spatial grid index. If a dataset contains many different tables but the same coarsest grid size applies to all of them, then this is a convenient way of setting the coarsest grid size value. This value can be overridden by DEF line parameter db2_grid_2.

Default: 0

Example:

DB2SPATIAL_GRID_2 1000

Workbench Parameter: Coarsest Spatial Grid Size