Oracle Spatial GeoRaster Writer Parameters

About Database Connections

Database formats include a Database Connection parameter that defines and stores authentication information. For general information about sharing database connections, please see Using Database Connections. Using Database Connections.

Note that Database Connection parameters differ slightly, depending on context and/or database format.

Connection

From the Connection parameter in a database format, you can do one of the following:

    Select an existing, previously defined connection. See the section Reusing a Database Connection in Using Database Connections

    Select Add Database Connection to define a new connection. See database-specific parameters below, as well as the section Adding a Database Connection in a Workspace in Using Database Connections The new connection can be made visible only to the current user, or can be shared among multiple users.

Oracle Workspace

The name of the Oracle Workspace Manager workspace that will be used by the writer. All tables will be written using the same workspace.

If this parameter is omitted, or left blank, the default LIVE workspace will be used.

Persistent Connection

If this parameter is checked (default), the Oracle database connection remains open for other requestors. A persistent connection is useful for workspaces that are long-running, or published using FME Flow.

If this parameter is unchecked, the connection to the Oracle database is closed as soon as possible after data processing is complete.

Layer Parameters

Uppercase Column Names

If this parameter is checked, the writer automatically makes the column names uppercase, and disallows characters in the column names that require quoting within Oracle.

This parameter is only applicable when generating a writer.

Advanced

Bulk Write Size

This parameter, also known as chunk size, specifies how many features the writer transmits over the network at a time to the database. Features will get cached in memory until this feature count is reached, and then they will be transmitted as a single chunk to the database. Features Per Transaction is normally a multiple of this parameter. Once all chunks in a transaction are received by the database, the transaction is committed.

Note that the bulk write feature count is at the writer level and not the feature type level.

This parameter has a significant impact on performance. When the database server is physically remote, round-trip time for data transmission can cause bottlenecks in data loading. To reduce network round-trip time, increase the value of this parameter.

This parameter is often confused with Features Per Transaction. Each bulk write is a part of exactly one transaction. So, if Bulk Write Size is greater than Features Per Transaction, then it is automatically reset to the value of the latter.

For optimal performance, make Features Per Transaction large (but not excessive), and set Bulk Write Size to the same value.

Features Per Transaction

This parameter specifies how many features are written to the database before they are committed. It is usually a multiple of Bulk Write Size.

Note that the written feature count is at the writer level and not the feature type level.

  • If this parameter is set to a small number: when a transaction fails, only a small number of features (for example, all features in that transaction) get rolled back.
  • If this parameter is set to a large number: when a transaction fails, a large number of features get rolled back.

In terms of performance, it is undesirable to have this parameter set to a small number because the overhead of the numerous commits might be excessive. It is also undesirable to have this parameter set to a large number because the overhead of keeping track of the large transaction on the database server can be significant.

For optimal performance, make Features Per Transaction large (but not excessive), and set Bulk Write Size to the same value.

Enforce Strict Attribute Conversion

This parameter specifies how the writer proceeds when a problem arises while converting a value from one of a feature’s attributes to an Oracle column value.

Examples of such problems would be the truncation of a string value to fit into the target character column, an error in writing a non-numeric attribute to a numeric column, or an error converting an FME geometry into an SDO_GEOMETRY value.

  • Yes: The conversion errors result in warnings. Features are logged and dropped from the translation.
  • No: The writer will silently write null values or truncated strings when conversion errors occur.
  • Warn: The writer warns and writes null values or truncated strings when conversion errors occur.