Esri Geodatabase (File Geodb Open API) 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.

Database Connection

Select the Esri File Geodatabase destination folder.

  • When unchecked (default) and a database already exists, then tables and features are written to the existing database.
  • When checked, any existing database is deleted before writing begins. Checking this option also enables the Template File parameter.
Warning  After a database is deleted, it cannot be recovered – all data is lost.

If a database does not exist when writing begins, a new database is created.

If a template File Geodatabase is specified, the destination File Geodatabase is replaced with a copy of the template before writing begins.

General Parameters

This setting defines the writer behavior when a Feature Dataset is provided. There are three options:

  • Write Feature Dataset (default) – If a Feature Dataset is specified, it will write it if possible.
  • Warn and Ignore Feature Dataset – In this mode, if a Feature Dataset is specified, a warning will be logged and the writer will treat it as if the Feature Dataset was not provided.
  • Error and End Translation – In this mode, if a Feature Dataset is specified, an error will be logged and the translation will end.

Advanced

This parameter allows for the execution of SQL statements before writing to a table. For example, it may be necessary to clean up a table before attempting to write to it. The statements will be executed only when the first feature arrives at the writer.

For detailed information about SQL functions, click the corresponding menu item in the SQL to Run editor helpClosed.

Available menu options depend on the format.

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.

This parameter allows for the execution of SQL statements after a set of tables has been written. For example, it may be necessary to clean up a temporary view after creating it.

For detailed information about SQL functions, click the corresponding menu item in the SQL to Run editor helpClosed.

Available menu options depend on the format.

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.

Enables Load Only mode when feature operation is set to Insert.

Load only mode disables the updating of the spatial index while data is loading on a feature class or table, and then rebuilds the indexes.

Note  On Enterprise Geodatabase, this mode only works if writing to a feature class (not table), and the feature class has no extensions.
  • Yes – Load Only mode used for inserts when possible.
  • No – Load only mode used only when creating a new feature class or table.