Untuk membuat contoh TLE ekstensi

Langkah-langkah berikut menggunakan contoh basis data bernama labdb. Basis data ini milik pengguna utama postgres. Peran postgres juga memiliki izin peran pgtle_admin.

1. Gunakan psql untuk terhubung ke instance penulis cluster Aurora SQL Postgre DB Anda.

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

2. Buat TLE ekstensi bernama pg_distance dengan menyalin kode berikut dan menempelkannya ke konsol psql sesi Anda.

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

   Anda akan melihat output seperti berikut.

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

   Artefak yang membentuk ekstensi pg_distance sekarang diinstal di basis data Anda. Artefak ini mencakup file kontrol dan kode untuk ekstensi, yang merupakan item yang harus ada sehingga ekstensi dapat dibuat menggunakan perintah CREATE EXTENSION. Dengan kata lain, Anda masih perlu membuat ekstensi agar fungsinya tersedia bagi pengguna basis data.

3. Untuk membuat ekstensi, gunakan perintah CREATE EXTENSION seperti yang Anda lakukan untuk ekstensi lainnya. Seperti ekstensi lainnya, pengguna basis data harus memiliki izin CREATE dalam basis data.

   CREATE EXTENSION pg_distance;

4. Untuk menguji pg_distance TLE ekstensi, Anda dapat menggunakannya untuk menghitung jarak Manhattan antara empat titik.

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

   Untuk menghitung Jarak Euclidean antara kumpulan titik yang sama, Anda dapat menggunakan berikut.

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

Untuk memperbarui TLE ekstensi yang ada dan menentukan versi default

1. Connect ke instance penulis cluster Aurora Postgre SQL DB Anda RDS lain, seperti. pgAdmin

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

2. Ubah TLE ekstensi yang ada dengan menyalin kode berikut dan menempelkannya ke konsol psql sesi Anda.

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

   Anda akan melihat hasil yang mirip dengan berikut ini.

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

   Anda dapat menjadikan versi ekstensi ini sebagai versi default, sehingga pengguna basis data tidak perlu menentukan versi saat mereka membuat atau memperbarui ekstensi di basis data mereka.

3. Untuk menentukan bahwa versi modifikasi (versi 0.2) TLE ekstensi Anda adalah versi default, gunakan pgtle.set_default_version fungsi seperti yang ditunjukkan pada contoh berikut.

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

   Untuk informasi selengkapnya tentang fungsi ini, lihat pgtle.set_default_version.

4. Dengan kode di tempat, Anda dapat memperbarui TLE ekstensi yang diinstal dengan cara biasa, dengan menggunakan ALTER EXTENSION ... UPDATE perintah, seperti yang ditunjukkan di sini:

   ALTER EXTENSION pg_distance UPDATE;