#1287: legacy script to reinstall old PostGIS gist op. Added to FAQ when you need...

git-svn-id: http://svn.osgeo.org/postgis/trunk@10712 b70326c6-7e19-0410-871a-916f4a2858ee

diff --git a/doc/faq.xml b/doc/faq.xml
index 5e78ee98a55abf9266d2b664de67d4599dd54f26..4026b35705101696b3743eb6cec1350b7902b5ad 100644 (file)
--- a/doc/faq.xml
+++ b/doc/faq.xml
@@ -29,6 +29,30 @@
             to get back all the 200 some-odd old functions we removed.</para>
       </answer>
     </qandaentry>
+    
+    <qandaentry id="legacy_faq_gist">
+      <question>
+        <para>When I load open street map data with osm2pgsql, I'm getting an error     
+    failed: ERROR:  operator class "gist_geometry_ops" does not exist for access me
+thod "gist"
+Error occurred.  This worked fine in PostGIS 1.5</para>
+      </question>
+
+      <answer>
+        <para>In PostGIS 2, the default geometry operator class gist_geometry_ops was changed to gist_geometry_ops_2d and the gist_geometry_ops was completely removed. This was done because PostGIS 2 also introduced Nd spatial indexes for 3D support and the old name was deemed confusing and a misnomer.</para>
+        <para>Some older applications that as part of the process create tables and indexes, explicitly referenced the operator class name.  This was unnecessary if you want the default 2D index.  So if you manage said good, change index creation from:</para>
+        <para>BAD:</para>
+        <programlisting>CREATE INDEX idx_my_table_geom ON my_table USING gist(geom gist_geometry_ops);</programlisting>
+        <para>To GOOD:</para>
+         <programlisting>CREATE INDEX idx_my_table_geom ON my_table USING gist(geom);</programlisting>
+         
+         <para>The only case where you WILL need to specify the operator class is if you want a 3D spatial index as follows:</para>
+         <programlisting>CREATE INDEX idx_my_super3d_geom ON my_super3d USING gist(geom gist_geometry_ops_nd);</programlisting>
+         
+         <para>If you are unfortunate to be stuck with compiled code you can't change that has the old gist_geometry_ops hard-coded, then you can create the old class using the <filename>legacy_gist.sql</filename> packaged in PostGIS 2.0.2+. However if you use this fix, you are advised to at a later point drop the index and recreate it without the operator class.  This will save you grief in the future when you need to upgrade again.</para>
+      </answer>
+    </qandaentry>
+
     <qandaentry>
       <question>
         <para>I'm running PostgreSQL 9.0 and I can no longer read/view geometries in OpenJump, Safe FME, and some other tools?</para>

diff --git a/postgis/Makefile.in b/postgis/Makefile.in
index f21a0e116bb92ae857f860ee1e78deac179a10a2..c1d8ba949182e5a3baf0d7cc7486ee1962d36460 100644 (file)
--- a/postgis/Makefile.in
+++ b/postgis/Makefile.in
@@ -15,7 +15,7 @@ MODULE_big=postgis-@POSTGIS_MAJOR_VERSION@.@POSTGIS_MINOR_VERSION@
 MODULEDIR=contrib/$(MODULE_big)
 
 # Files to be copied to the contrib/ directory
-DATA_built=postgis.sql uninstall_postgis.sql postgis_upgrade_20_21.sql postgis_upgrade_21_minor.sql legacy.sql uninstall_legacy.sql legacy_minimal.sql
+DATA_built=postgis.sql uninstall_postgis.sql postgis_upgrade_20_21.sql postgis_upgrade_21_minor.sql legacy.sql uninstall_legacy.sql legacy_minimal.sql legacy_gist.sql
 DATA=../spatial_ref_sys.sql
 
 # SQL preprocessor

diff --git a/postgis/legacy_gist.sql.in b/postgis/legacy_gist.sql.in
new file mode 100644 (file)
index 0000000..bc89cc5
--- /dev/null
+++ b/postgis/legacy_gist.sql.in
@@ -0,0 +1,27 @@
+CREATE OPERATOR CLASS gist_geometry_ops\r
+       FOR TYPE geometry USING GIST AS\r
+       STORAGE box2df,\r
+       OPERATOR        1        <<  ,\r
+       OPERATOR        2        &<      ,\r
+       OPERATOR        3        &&  ,\r
+       OPERATOR        4        &>      ,\r
+       OPERATOR        5        >>      ,\r
+       OPERATOR        6        ~=      ,\r
+       OPERATOR        7        ~       ,\r
+       OPERATOR        8        @       ,\r
+       OPERATOR        9        &<| ,\r
+       OPERATOR        10       <<| ,\r
+       OPERATOR        11       |>> ,\r
+       OPERATOR        12       |&> ,\r
+\r
+       OPERATOR        13       <-> FOR ORDER BY pg_catalog.float_ops,\r
+       OPERATOR        14       <#> FOR ORDER BY pg_catalog.float_ops,\r
+       FUNCTION        8        geometry_gist_distance_2d (internal, geometry, int4),\r
+\r
+       FUNCTION        1        geometry_gist_consistent_2d (internal, geometry, int4),\r
+       FUNCTION        2        geometry_gist_union_2d (bytea, internal),\r
+       FUNCTION        3        geometry_gist_compress_2d (internal),\r
+       FUNCTION        4        geometry_gist_decompress_2d (internal),\r
+       FUNCTION        5        geometry_gist_penalty_2d (internal, internal, internal),\r
+       FUNCTION        6        geometry_gist_picksplit_2d (internal, internal),\r
+       FUNCTION        7        geometry_gist_same_2d (geom1 geometry, geom2 geometry, internal);
\ No newline at end of file