Skip to main content

Upgrade the ST_Geometry type in a PostgreSQL database

Available with Standard or Advanced license.

The ST_Geometry library contains new functionality or fixes at each ArcGIS release. The database administrator can upgrade the ST_Geometry type in a PostgreSQL database using the Create Spatial Type geoprocessing tool or the CreateSpatialType ArcPy function.

Note:

The st_geometry.dll file requires the Microsoft Visual C++ Redistributable Package (x64) when deployed on a Microsoft Windows server. See ArcGIS requirements for using PostgreSQL for the package version required. If this package is not present on the PostgreSQL server, download it from the Microsoft site and install it.

Upgrading the ST_Geometry type from the 11.2 version drops and re-creates the spatial indexes that you defined on the ST_Geometry columns in user-defined tables.

To upgrade the ST_Geometry type, complete the following steps:

  1. Grant superuser authority to the sde login role in the database cluster if the login does not already have it.

  2. Download a new version of the ST_Geometry package from My Esri.

    If the option to download is not present, contact your ArcGIS organization administrator.

  3. Extract the contents of the downloaded file.

  4. Make a backup copy of, or rename. the existing st_geometry library on the PostgreSQL server.

  5. Copy the new st_geometry library from where you extracted the package's contents, and place the new library in the PostgreSQL lib directory.

    • If PostgreSQL is installed on a Linux server, place the st_geometry.so file in the lib directory.

      To determine the correct location, run pg_config as the postgres user. The value that is returned for PKGLIBDIR is the lib directory where you need to place the st_geometry.so file. Sign in to the machine as the root user to copy the file or files to the lib location.

      Note:

      If your Linux operating system does not include libstdcc++.so.6.0.29 or a later release of the library, also place the libstdcc++.so.6 library in the PostgreSQL lib directory.

    • If PostgreSQL is installed on a Windows server, place the st_geometry.dll file in the %PostgreSQL%\lib directory.

  6. Open a project in ArcGIS Pro, open the Catalog pane, and connect to the database as the sde user.

    A database connection (.sde) file is created in the project folder.

  7. To update the ST_Geometry type, subtypes, and functions in the database, run the Create Spatial Type geoprocessing tool or a Python script that uses the CreateSpatialType ArcPy function.

    Use the .sde file you created in the previous step for the database connection.