Instalar o PostGIS para o AlloyDB Omni

Pré-lançamento

Este produto ou recurso está sujeito aos "Termos das Soluções Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os produtos e recursos pré-GA estão disponíveis no estado em que se encontram e podem ter assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

Para informações sobre o acesso a esta versão, consulte a página de solicitação de acesso.

Selecione uma versão da documentação: 17.5.0

• Atual (17.5.0)
• 17.5.0

Nesta página, descrevemos como adicionar manualmente a extensão PostGIS a uma instalação do AlloyDB Omni existente. A extensão PostGIS permite armazenar, indexar e consultar dados geoespaciais.

Antes de começar

Instale o AlloyDB Omni no seu sistema.

Adicionar o PostGIS à instalação do AlloyDB Omni

Para adicionar a extensão PostGIS à sua instalação do AlloyDB Omni, siga estas etapas:

1. Peça acesso à versão Prévia enviando este formulário.

2. Inicialize o Red Hat Subscription Manager na VM em que você instalou o servidor do AlloyDB Omni:

   sudo dnf install -y subscription-manager
   sudo subscription-manager register --username "RHSM_USER" --password "RHSM_PASS" --auto-attach --force
   

   Substitua:

   • RHSM_USER: o usuário do Red Hat Subscription Manager.
   • RHSM_PASS: a senha do Red Hat Subscription Manager.

3. Ative o repositório do CodeReady Builder:

   sudo subscription-manager repos --enable="codeready-builder-for-rhel-9-$ARCH-rpms"
   

   Substitua ARCH pela arquitetura do RHEL que você quer usar, por exemplo, x86_64.

4. Adicione o repositório Yum do PostgreSQL:

   sudo dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm
   

5. Instale o servidor PostgreSQL e os pacotes de desenvolvimento:

   sudo dnf install -y "postgresql17-server"
   

   Substitua OMNI_VERSION pelo número da versão do AlloyDB Omni, que é 17.

6. Instale a extensão PostGIS:

   sudo dnf install -y postgis35_17
   

7. Crie os symlinks necessários para que as extensões estejam nos caminhos esperados:

   set -e
   PGVER="17"
   
   sudo mkdir -p "/usr/lib/postgresql/${PGVER}/share/extension"
   
   for file in /usr/pgsql-${PGVER}/share/extension/*; do
       target="/usr/lib/postgresql/${PGVER}/share/extension/$(basename "$file")"
       if [[ ! -e "$target" ]]; then
         sudo ln -s "$file" "$target" || (echo "Failed to link \"$file\" to \"$target\", exiting." && exit 1)
         echo "Created extension link for $(basename "$file")"
       else
         echo "Target $target already exists."
       fi
   done
   
   sudo mkdir -p "/usr/lib/postgresql/${PGVER}/lib"
   
   for file in /usr/pgsql-${PGVER}/lib/*; do
       target="/usr/lib/postgresql/${PGVER}/lib/$(basename "$file")"
       if [[ ! -e "$target" ]]; then
         sudo ln -s "$file" "$target" || (echo "Failed to link \"$file\" to \"$target\", exiting." && exit 1)
         echo "Created lib link for $(basename "$file")"
       else
         echo "Target $target already exists."
       fi
     fi
   done
   

8. Conecte-se ao banco de dados com a extensão PostGIS:

   /usr/lib/postgresql/17/bin/psql -h localhost -U postgres
   

9. Ative o PostGIS:

   CREATE EXTENSION IF NOT EXISTS POSTGIS;
   

10. Confirme se o PostGIS está instalado e ativado:

    SELECT postgis_full_version();
    

    O resultado será o seguinte:

    postgres=# SELECT postgis_full_version();
    postgis_full_version
    --------------------------------------------------------------------------------------------------------------------------------
    POSTGIS="3.3.2 4975da8" [EXTENSION] PGSQL="150" GEOS="3.11.1-CAPI-1.17.1" PROJ="9.1.1" LIBXML="2.9.14" LIBJSON="0.16" LIBPROTOBUF="1.4.1" WAGYU="0.5.0 (Internal)"
    (1 row)