Go to file
Geoff Munn 0c8580f3d7 BUGFIX: syntax error fixed 2010-05-28 02:39:52 +00:00
code BUGFIX: syntax error fixed 2010-05-28 02:39:52 +00:00
CHANGELOG Change log, license and readme files included 2009-12-03 21:15:11 +00:00
LICENSE Change log, license and readme files included 2009-12-03 21:15:11 +00:00
README Change log, license and readme files included 2009-12-03 21:15:11 +00:00
_config.php GiST and Tsvector references removed so DB/build will work 2009-01-09 03:43:28 +00:00

README

###############################################
PostgreSQL Module
###############################################

Maintainer Contact
-----------------------------------------------
Geoff Munn (Nickname: gmunn)
<geoff (at) silverstripe (dot) com>

Requirements
-----------------------------------------------
- PostgreSQL 8.3.x or greater must be installed
- PostgreSQL <8.3.0 may work if T-Search is manually installed
- Known to work on OS X Leopard, Windows Server 2008 R2 and probably Linux

Documentation
-----------------------------------------------
http://doc.silverstripe.org/doku.php?id=postgres

Installation Instructions
-----------------------------------------------

Move the 'postgres' folder to the root level of the project.
You'll need to create a database with the desired name manually. 
Run dev/build and you should be set.

Usage Overview
-----------------------------------------------

See the documentation link for examples of PostgreSQL-specific functionality.

Known issues:
-----------------------------------------------

When you're setting this up for the first time, you will need to manually create the database 'SS_project' or whatever it's called.  
I haven't implemented the automatic database creation logic yet.

All column and table names must be double-quoted.  PostgreSQL automatically lower-cases columns, and your queries will fail if you don't.

Ts_vector columns are not automatically detected by the built-in search filters.  
That means if you're doing a search through the CMS on a ModelAdmin object, it will use LIKE queries which are very slow.  
If you're writing your own front-end search system, you can specify the columns to use for search purposes, and you get the full benefits of T-Search.

Most other modules probably don't work.  There are many instances of MySQL-compatible backticks '`' littering existing modules, 
and these need to be changed to double-quotes.  
There may also be instances of MySQL-specific SQL queries which will need to be made database-agnostic where possible.