Criar extensões TLE para Aurora PostgreSQL

Como criar o exemplo de extensão TLE

As etapas a seguir usam um exemplo de banco de dados chamado labdb. Esse banco de dados é de propriedade do usuário primário postgres. A função postgres também tem as permissões da função pgtle_admin.

1. Use o psql para se conectar à instância de gravador do cluster de banco de dados do Aurora PostgreSQL.

   psql --host=db-instance-123456789012.aws-region.rds.amazonaws.com
   --port=5432 --username=postgres --password --dbname=labdb

2. Crie uma extensão TLE denominada pg_distance copiando o código a seguir e colando-o no console da sessão psql.

   SELECT pgtle.install_extension
   (
    'pg_distance',
    '0.1',
     'Distance functions for two points',
   $_pg_tle_$
       CREATE FUNCTION dist(x1 float8, y1 float8, x2 float8, y2 float8, norm int)
       RETURNS float8
       AS $$
         SELECT (abs(x2 - x1) ^ norm + abs(y2 - y1) ^ norm) ^ (1::float8 / norm);
       $$ LANGUAGE SQL;
   
       CREATE FUNCTION manhattan_dist(x1 float8, y1 float8, x2 float8, y2 float8)
       RETURNS float8
       AS $$
         SELECT dist(x1, y1, x2, y2, 1);
       $$ LANGUAGE SQL;
   
       CREATE FUNCTION euclidean_dist(x1 float8, y1 float8, x2 float8, y2 float8)
       RETURNS float8
       AS $$
         SELECT dist(x1, y1, x2, y2, 2);
       $$ LANGUAGE SQL;
   $_pg_tle_$
   );

   Você verá a saída da forma a seguir.

   install_extension
   ---------------
    t
   (1 row)

   Os artefatos que compõem a extensão pg_distance agora estão instalados em seu banco de dados. Esses artefatos incluem o arquivo de controle e o código da extensão, que são itens que precisam estar presentes para que a extensão possa ser criada usando o comando CREATE EXTENSION. Em outras palavras, você ainda precisa criar a extensão para disponibilizar suas funções aos usuários do banco de dados.

3. Para criar a extensão, use o comando CREATE EXTENSION como você faz com qualquer outra extensão. Assim como acontece com outras extensões, o usuário do banco de dados precisa ter as permissões CREATE no banco de dados.

   CREATE EXTENSION pg_distance;

4. Para testar a extensão TLE pg_distance, você pode usá-la para calcular a distância de Manhattan entre quatro pontos.

   labdb=> SELECT manhattan_dist(1, 1, 5, 5);
   8

   Para calcular a distância euclidiana entre o mesmo conjunto de pontos, você pode usar o seguinte.

   labdb=> SELECT euclidean_dist(1, 1, 5, 5);
   5.656854249492381

Como atualizar uma extensão TLE existente e especificar a versão padrão

1. Conecte-se à instância de gravador de seu cluster de banco de dados do Aurora PostgreSQL usando psql ou outra ferramenta de cliente, como o pgAdmin

   psql --host=db-instance-123456789012.aws-region.rds.amazonaws.com
   --port=5432 --username=postgres --password --dbname=labdb

2. Modifique a extensão TLE existente copiando o código a seguir e colando-o no console da sessão psql.

   SELECT pgtle.install_update_path
   (
    'pg_distance',
    '0.1',
    '0.2',
   $_pg_tle_$
       CREATE OR REPLACE FUNCTION dist(x1 float8, y1 float8, x2 float8, y2 float8, norm int)
       RETURNS float8
       AS $$
         SELECT (abs(x2 - x1) ^ norm + abs(y2 - y1) ^ norm) ^ (1::float8 / norm);
       $$ LANGUAGE SQL IMMUTABLE PARALLEL SAFE;
   
       CREATE OR REPLACE FUNCTION manhattan_dist(x1 float8, y1 float8, x2 float8, y2 float8)
       RETURNS float8
       AS $$
         SELECT dist(x1, y1, x2, y2, 1);
       $$ LANGUAGE SQL IMMUTABLE PARALLEL SAFE;
   
       CREATE OR REPLACE FUNCTION euclidean_dist(x1 float8, y1 float8, x2 float8, y2 float8)
       RETURNS float8
       AS $$
         SELECT dist(x1, y1, x2, y2, 2);
       $$ LANGUAGE SQL IMMUTABLE PARALLEL SAFE;
   $_pg_tle_$
   );

   Você verá uma resposta semelhante ao seguinte.

   install_update_path
   ---------------------
    t
   (1 row)

   Você pode tornar essa versão da extensão a versão padrão, para que os usuários do banco de dados não precisem especificar uma versão ao criar ou atualizar a extensão em seu banco de dados.

3. Para especificar que a versão modificada (versão 0.2) de sua extensão TLE é a versão padrão, use a função pgtle.set_default_version conforme mostrado no exemplo a seguir.

   SELECT pgtle.set_default_version('pg_distance', '0.2');

   Para ter mais informações sobre essa função, consulte pgtle.set_default_version.

4. Com o código implementado, você pode atualizar a extensão TLE instalada da maneira usual, utilizando o comando ALTER EXTENSION ... UPDATE, conforme mostrado aqui:

   ALTER EXTENSION pg_distance UPDATE;