Writer Directives

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

DATASET

The dataset is the Windows Azure storage service. This value is sometimes referred to as the account name and is the first part of the URL used to access the service from a browser. For example:

http://<storage service>.cloudapp.net

Required/Optional

Required

DEF

The syntax of the definition is:

OGDI_DEF <tableName>
ogdi_drop_table (yes|no)
ogdi_writer_mode (INHERIT_FROM_WRITER|INSERT|UPDATE|DELETE)
ogdi_source (text)
ogdi_category (text)
ogdi_description (text)
ogdi_metadataurl (text url)
ogdi_entitykind (text)
ogdi_keywords (text)
ogdi_geographiccoverage (text)
ogdi_updatefrequency (text)
ogdi_expiredate (YYYY-MM-DD)
[<fieldName> <fieldType>] +
 
ogdi_drop_tabl e

This specifies that if the table exists by this name, it should be dropped and recreated before any features are written to it.

NO

ogdi_table_mode

The the default operation mode of the feature type. Valid values are INSERT, UPDATE, DELETE and INHERIT_FROM_WRITER. Note that INSERT mode allows for only INSERT operations where as UPDATE and DELETE can be overwritten at the feature levels. INHERIT_FROM_WRITER simply indicates to take this value from the writer level and not to override it at the feature type level.

INHERIT_FROM_WRITER

ogdi_source Arbitrary text description of the source of the data
ogdi_category Arbitrary text name of the category to which the table belongs
ogdi_description Arbitrary text description of the table and its contents
ogdi_metadataurl URL for metadata information
ogdi_entitykind Arbitrary text description of entity kinds in the table
ogdi_keywords Arbitrary text keywords to identify the table
ogdi_geographiccoverage Arbitrary text description of the geographic coverage
ogdi_updatefrequency Arbitrary text description of the table update frequency
ogdi_expiredate Date describing the end of usefulness of the table data

Required/Optional

Required

STORAGE_KEY

This specifies the primary access key for accessing the Microsoft Windows Azure Storage service.

<WriterKeyword>_STORAGE_KEY a1b2C3k1/a1b2C3k1a1b2C3k1a1b2C3k1a1b2C3k1a1b2C3k1a1b2C3k1/a1b2C3k1a1b2C3k1a1b2C3k1a1b2==

Required/Optional

Required

WRITER_MODE

Note: For more information on this directive, see the chapter Database Writer Mode.

This directive determines which operations will be performed by default by this writer.

This operation can be set to INSERT, UPDATE or DELETE. The default writer level value for this operation can be overwritten at the feature type or table level. The corresponding feature type def parameter name is called ogdi_writer_mode. It has the same valid options as the writer level mode and additionally the value INHERIT_FROM_WRITER which causes the writer level mode to be inherited by the feature type as the default for features contained in that table.

If the WRITER_MODE statement is not specified, then a value of INSERT is given.

Required/Optional

Optional

Mapping File Syntax

WRITER_MODE UPDATE

Workbench Parameter

Writer Mode