Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Tags

spatialengine

Properties

Name

Type

Required

Description

id

string

yes

Unique identifier

dbtype

'oracle'

yes

The name of the driver to use, in this case Oracle

host

string

yes

The hostname or ip address of the Oracle server

port

number

yes

The port number that the Oracle instance is running on

database

string

no

The database parameter for the connection url

username

string

yes

The userid used when connecting to the database

password

string

yes

The password used when connecting to the database

schema

string

no

The schema used when connecting to the database

minconnections

integer

no

The minimum number of pooled connection. Default 1

maxconnections

integer

no

The maximum number of open connections. Default 10

validateconnections

boolean

no

Check connection is alive before using it. Default false

fetchsize

integer

no

The number of records read with each iteraction with the dbms. Default 1000

connectiontimeout

integer

no

The number of seconds the connection pool will wait before timing out attempting to get a new connection. Default 20 (seconds)

primarykeymetadatatable

string

no

The optional table containing primary key structure and sequence associations. Can be expressed as 'schema.name' or just 'name'. Default none

maxopenpreparedstatements

integer

no

Maximum number of prepared statements kept open and cached for each connection in the pool. Set to 0 to have unbounded caching, to -1 to disable caching. Default 50

geometrymetadatatablestringnoThe optional table containing metadata about the geometry for the tables being accessed via this spatial engine.

Sub-tags

None

Content

None

Notes

...

pk_policy can be 'assigned', 'sequence' or 'autogenerated' depending upon how the key column value is generated. The pk_sequence value only need to be set if the policy is 'sequence'.
'sequence' means that the value for the column is generated using a database sequence, and the 'pk_sequence' value must be set.
'autogenerated' means that the value for the column is generated by the database using another method.
'assigned' means that the value for the column is determined by the current maximum value +1, if the column is an integral type, or as a random string if the column is textual.

Column

Description

table_schema

Name of the database schema in which the table is located.

table_name

Name of the table to be published

pk_column

Name of a column used to form the feature IDs

pk_column_idx

Index of the column in a multi-column key. In case multi column keys are needed multiple records with the same table schema and table name will be used.

pk_policy

The new value generation policy, used in case a new feature needs to be added in the table ('assigned', 'sequence' or 'autogenerated').

pk_sequence

The name of the database sequence to be used when generating a new value for the pk_column.

Using primary key metadata configuration

You can also specify the above information directly in the spatial engin configuration.

Name

Description

name
The table name
schema
The optional table schema
columnThe column in the the table that contains the unique id
policyHow the key is generated
sequenceThe name of the database sequence to use if the policy is 'sequence'


Code Block
<spatial:spatialengine id="sdbeos">
  <dbtype>oracle</dbtype>
  <host>sdbeos</host>
  <port>1521</port>
  <database>staging</database>
  <user>data_viewer</user>
  <passwd>ENCSSJKXUMJBMTPGEJFGCXCQFXJJZUTMJZJ</passwd>
  <schema>ASSETS</schema>
  <primarykeymetadata>
    <table schema="ASSETS" name="PARK" column="GID" policy="autogenerated"/>
    <table schema="ASSETS" name="PROPERTY" column="PARK_ID" type="autogenerated"/>
    <table schema="ASSETS" name="ROAD" column="OBJECTID" type="autogenerated"/>
  </primarykeymetadata>
</spatial:spatialengine>

...

Code Block
CREATE TABLE GEOMETRY_COLUMNS(
   F_TABLE_SCHEMA VARCHAR(30) NOT NULL,
   F_TABLE_NAME VARCHAR(30) NOT NULL,
   F_GEOMETRY_COLUMN VARCHAR(30) NOT NULL,
   COORD_DIMENSION INTEGER,
   SRID INTEGER NOT NULL,
   TYPE VARCHAR(30) NOT NULL,
   UNIQUE(F_TABLE_SCHEMA, F_TABLE_NAME, F_GEOMETRY_COLUMN),
   CHECK(TYPE IN ('POINT','LINELINESTRING', 'POLYGON', 'COLLECTION', 'MULTIPOINT', 'MULTILINEMULTILINESTRING', 'MULTIPOLYGON', 'GEOMETRY') )
);

...

As of Weave 2.5.16 it's possible to specify the information contained in the geometry metadata table directly in the spatial engine configuration.

NameDescription
name
The table name
schema
The optional table schema
type
The geometry type (point, 
line
linestring, curve, polygon, multipoint, 
multiline
multilinestring, multicurve, multipolygon)
srid
The geometry srid
dimension
The geometry dimension


Code Block
languagexml
<spatial:spatialengine id="sdbeos">
  <dbtype>oracle</dbtype>
  <host>sdbeos</host>
  <port>1521</port>
  <database>staging</database>
  <user>data_viewer</user>
  <passwd>ENCSSJKXUMJBMTPGEJFGCXCQFXJJZUTMJZJ</passwd>
  <schema>ASSETS</schema>
  <geometrymetadata>
    <table name="PARK" type="multipolygon" srid="28355" dimension="2"/>
    <table name="PROPERTY" type="polygon" srid="28355" dimension="2"/>
    <table name="ROAD" type="linelinestring" srid="28355" dimension="2"/>
  </geometrymetadata>
</spatial:spatialengine>

...