Oracle Spatial GeoRaster Reader/Writer

FME can read and write GeoRaster and attribute data stored using Oracle Spatial. This module communicates directly with Oracle Spatial for maximum throughput.

Note  If you are reading or writing attributes only, use the FME Oracle Non-Spatial Reader/Writer.

This section assumes familiarity with Oracle Spatial, its GeoRaster support, and its indexing mechanisms.

Tip  The FeatureReader transformer performs queries against any FME-supported format.

Oracle Spatial GeoRaster Product and System Requirements

Dependencies  Raster data is supported only for Oracle 10g and above.
Compatibility  Oracle libraries are not yet available for the macOS M1 ARM architecture (Apple Silicon). Please use an alternative platform such as Intel macOS.

Format

FME Platform

Operating System

Reader/Writer

FME Form

FME Flow

FME Flow Hosted

Windows 64-bit

Linux

Mac

Reader

Yes

Yes

Yes

Yes

- Linux Intel: Yes

- Linux ARM: Yes

- macOS Intel: Yes

- macOS ARM: No

Writer

Yes

Yes

Yes

Yes

- Linux Intel: Yes

- Linux ARM: Yes

- macOS Intel: Yes

- macOS ARM: No

Format Notes

Oracle Instant Client

Instant Client can be used to run your OCI, OCCI, JDBC, and ODBC applications without installing a full Oracle Client. Instant Client supports SQL*Plus.

See the FME Community for more information on how Instant Client works with FME.

Oracle Wallet

 To use an Oracle Wallet with FME, leave the Username and Password parameters empty, and enter the name of the Oracle Wallet as the value of the Service Name or Easy Connect parameter.

Reader Overview

This reader reads GeoRaster tables from Oracle Spatial databases.

Writer Overview

The Oracle Spatial GeoRaster writer module stores raster and attribute data in an Oracle Spatial database. Only uppercase table names are supported.

Transaction Support

The Oracle Spatial GeoRaster writer provides transaction support that eases the data loading process. Occasionally, a data load operation terminates prematurely due to data difficulties. The transaction support provides a mechanism for reloading corrected data without data loss or duplication.
Table Creation

The Oracle Spatial GeoRaster writer uses the information within the FME mapping file to automatically create database tables as needed. Creation of related tables is also supported, such as the Raster Data Table (RDT) for GeoRaster columns. Metadata tables and triggers are also created or updated accordingly.
Table Dropping

The Oracle Spatial GeoRaster writer has a parameter that allows each table to be written to be dropped if recreating, or truncated if appending. Metadata information is updated using triggers for rasters. Likewise, related tables, such as RDTs for GeoRaster columns will be dropped when empty. Metadata tables are updated via DML triggers, however the triggers themselves are not currently dropped.
Index Creation

The Oracle Spatial GeoRaster writer will set up and populate all needed indexes and index tables as part of the loading process.
Bulk Loading

The Oracle Spatial GeoRaster writer uses a bulk loading technique to ensure speedy data load.
Raster Interleaving

Raster data can be written using Band SeQuential (BSQ), Band Interleaved by Line (BIL) or Band Interleaved by Pixel (BIP) interleaving. The default interleaving is BSQ.
Raster Pyramid Generation

Native pyramid generation can be performed as a post-process once writing is complete. Number of levels and the resampling type can be optionally specified.
Raster Validation

Native validation can optionally be performed as a post-process once writing is complete.
Raster Compression

Native DEFLATE, JPEG-B and JPEG-F compression can optionally be performed as a post-process once writing is complete.
Note  Repeatedly reading and saving data may decrease the data quality for this format. In addition, FME Workbench may not know which format the data comes from, and whether it is the output of lossy compression. If you know that source data comes with lossy compression, you should also set the compression level to 0 or None. Although this compression setting still does not guarantee the exact copy of the source data, the output will be very close to the original.

FME Raster Features

FME raster features represent raster data and use several concepts that are unlike those used in the handling of vector data.

For comprehensive information about how FME processes raster data, see Rasters.

Oracle supports rasters with an arbitrary number of bands, provided all bands are the same data type. Any number of bands may optionally have a palette.

Oracle supports reading and writing 1-, 2-, and 4-bit rasters. Note that the smallest data type supported by FME is 1 byte (8 bits). Thus, on reading, 1-, 2-, and 4-bit rasters are automatically converted to 8 bits. On writing, an option is provided to reduce the size of 8-bit rasters to 1, 2, or 4 bits.