Création d'TLEextensions pour SQL

Pour créer l'TLEextension d'exemple

Les étapes suivantes utilisent un exemple de base de données nommé labdb. Cette base de données appartient à l'utilisateur principal postgres. Le rôle postgres possède également les autorisations du rôle pgtle_admin.

1. Utilisez-le psql pour vous connecter à . RDSpour une SQL instance de base de données Postgre.

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

2. Créez une TLE extension nommée pg_distance en copiant le code suivant et en le collant dans votre console de psql session.

   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_$
   );

   Vous devez voir la sortie suivante.

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

   Les artefacts qui constituent l'extension pg_distance sont désormais installés dans votre base de données. Ces artefacts incluent le fichier de contrôle et le code de l'extension, qui sont des éléments qui doivent être présents pour que l'extension puisse être créée à l'aide de la commande CREATE EXTENSION. En d'autres termes, il vous reste à créer l'extension pour mettre ses fonctions à la disposition des utilisateurs de la base de données.

3. Pour créer cette extension, utilisez la commande CREATE EXTENSION comme vous le feriez pour toute autre extension. Comme pour les autres extensions, l'utilisateur de la base de données doit disposer des autorisations CREATE dans la base de données.

   CREATE EXTENSION pg_distance;

4. Pour tester l'pg_distanceTLEextension, vous pouvez l'utiliser pour calculer la distance de Manhattan entre quatre points.

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

   Pour calculer la distance euclidienne entre le même ensemble de points, vous pouvez utiliser ce qui suit.

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

Pour mettre à jour une TLE extension existante et spécifier la version par défaut

1. Connectez-vous à pour SQL instance de base de données Postgre à l'aide psql d'un autre outil client, tel que. pgAdmin

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

2. Modifiez l'TLEextension existante en copiant le code suivant et en le collant dans votre console de psql session.

   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_$
   );

   Vous voyez une réponse similaire à la suivante.

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

   Vous pouvez faire de cette version de l'extension la version par défaut, afin que les utilisateurs de base de données n'aient pas à spécifier de version lorsqu'ils créent ou mettent à jour l'extension dans leur base de données.

3. Pour indiquer que la version modifiée (version 0.2) de votre TLE extension est la version par défaut, utilisez la pgtle.set_default_version fonction illustrée dans l'exemple suivant.

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

   Pour de plus amples informations sur cette fonction, veuillez consulter pgtle.set_default_version.

4. Une fois le code en place, vous pouvez mettre à jour l'TLEextension installée de la manière habituelle, en utilisant ALTER EXTENSION ... UPDATE la commande, comme indiqué ici :

   ALTER EXTENSION pg_distance UPDATE;