Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Amazon Aurora PostgreSQLfungsi yang ditentukan pengguna untuk Amazon Location Service

Anda dapat menggunakan Amazon Location Service untuk bekerja dengan koordinat dan alamat yang disimpan dalam tabel database untuk membersihkan dan memperkaya data geospasial Anda.

Sebagai contoh:

Tutorial ini menunjukkan cara memformat dan memperkaya alamat yang disimpan dalam tabel Amazon Aurora PostgreSQL database menggunakan Amazon Location Service.

Kode sampel tersedia di repositori sampel Amazon Location Service GitHub, yang AWS CloudFormation menyertakan templat.

Ikhtisar

Arsitektur melibatkan integrasi berikut:

Prasyarat

Sebelum Anda mulai, Anda memerlukan prasyarat berikut:

Quick start

Sebagai alternatif untuk melalui langkah-langkah dalam tutorial ini, Anda dapat meluncurkan tumpukan cepat untuk menyebarkan AWS Lambda fungsi yang mendukung operasi SearchPlaceIndexForText Lokasi Amazon. Ini secara otomatis mengonfigurasi AWS akun Anda untuk memungkinkan Amazon Aurora menelepon. AWS Lambda

Setelah Anda mengkonfigurasi AWS akun Anda, Anda perlu:

Buat sumber daya indeks tempat

Mulailah dengan membuat sumber daya indeks tempat untuk mendukung kueri geocoding.

Buat AWS Lambda fungsi untuk geocoding

Untuk membuat koneksi antara Amazon Aurora PostgreSQL dan Amazon Location Service, Anda memerlukan AWS Lambda fungsi untuk menangani permintaan dari mesin database. Fungsi ini menerjemahkan peristiwa fungsi yang ditentukan pengguna Lambda dan memanggil operasi Lokasi Amazon. SearchPlaceIndexForText

Anda dapat membuat fungsi menggunakan AWS Lambda konsol, theAWS Command Line Interface, atau AWS Lambda API.

Untuk membuat fungsi yang ditentukan pengguna Lambda menggunakan konsol

Berikan Amazon Aurora PostgreSQL akses ke AWS Lambda

Sebelum Amazon Aurora PostgreSQL dapat menjalankan AWS Lambda fungsi, Anda harus memberikan izin akses.

Jika Amazon Aurora PostgreSQL klaster Anda tidak dapat diakses publik, Anda harus terlebih dahulu membuat titik akhir VPC AWS Lambda agar Amazon Aurora memanggil fungsi Lambda Anda.

Buat Endpoint VPC untuk AWS Lambda

Buat kebijakan IAM untuk memberikan izin untuk menjalankan fungsi Anda AWS Lambda

Buat peran IAM untuk memberikan izin ke Amazon Relational Database Service (Amazon RDS)

Dengan membuat peran IAM, Amazon Aurora PostgreSQL dapat mengambil peran atas nama Anda untuk mengakses fungsi Lambda Anda. Untuk informasi selengkapnya, lihat Membuat peran untuk mendelegasikan izin ke pengguna IAM dalam Panduan Pengguna IAM.

Contoh berikut adalah AWS CLI perintah yang menciptakan peran bernama AuroraGeocoderInvokeRole:

aws iam create-role  --role-name rds-lambda-role --assume-role-policy-document '{
    "Version": "2012-10-17",
    "Statement": [
        {
        "Effect": "Allow",
        "Principal": {
            "Service": "rds.amazonaws.com"
        },
        "Action": "sts:AssumeRole"
        }
    ] 
}'

Lampirkan kebijakan IAM Anda ke peran IAM

Bila Anda memiliki peran IAM, lampirkan kebijakan IAM yang telah Anda buat.

Contoh berikut adalah AWS CLI perintah yang melampirkan kebijakan AuroraGeocoderInvokeke peran AuroraGeocoderInvokeRole.

aws iam attach-role-policy  --policy-arn AuroraGeocoderInvoke  --role-name AuroraGeocoderInvokeRole

Tambahkan peran IAM ke cluster Amazon Aurora DB

Contoh berikut adalah AWS CLI perintah untuk menambahkan peran IAM ke cluster Amazon Aurora PostgreSQL DB bernama MyAuroraCluster.

aws rds add-role-to-db-cluster \
--db-cluster-identifier MyAuroraCluster \
--feature-name Lambda \
--role-arn AuroraGeocoderInvokeRole   \
--region your-region

Memanggil fungsi AWS Lambda

Setelah Anda memberikan izin Amazon Aurora PostgreSQL untuk menjalankan fungsi Lambda geocoding Anda, Anda dapat membuat fungsi yang Amazon Aurora PostgreSQL ditentukan pengguna untuk menjalankan fungsi geocoding. AWS Lambda Untuk informasi selengkapnya, lihat Memanggil AWS Lambda fungsi dari kluster Amazon Aurora PostgreSQL DB di Panduan Pengguna Amazon Aurora.

Instal ekstensi PostgreSQL yang diperlukan

Untuk menginstal ekstensi dan aws_lambda ekstensi PostgreSQL yang diperlukan, lihat aws _commons Ringkasan penggunaan fungsi Lambda di Panduan Pengguna Amazon Aurora.

CREATE EXTENSION IF NOT EXISTS aws_lambda CASCADE;

Instal ekstensi PostGIS yang diperlukan

PostGIS adalah ekstensi dari PostgreSQL untuk menyimpan dan mengelola informasi spasial. Untuk informasi selengkapnya, lihat Bekerja dengan ekstensi PostGIS di Panduan Pengguna Layanan Amazon Relational Database Service.

CREATE EXTENSION IF NOT EXISTS postgis;

Buat fungsi yang ditentukan pengguna SQL yang memanggil fungsi Lambda

Dalam editor SQL, buat fungsi baru yang ditentukan pengguna f_SearchPlaceIndexForText untuk memanggil fungsi: AuroraGeocoder

CREATE OR REPLACE FUNCTION f_SearchPlaceIndexForText(
  text text,
  bias_position geometry(Point, 4326) DEFAULT NULL,
  filter_bbox box2d DEFAULT NULL,
  filter_countries text[] DEFAULT NULL,
  max_results int DEFAULT 1
)
 RETURNS TABLE (
   label text,
   address_number text,
   street text,
   municipality text,
   postal_code text,
   sub_region text,
   region text,
   country text,
   geom geometry(Point, 4326)
 )
 LANGUAGE plpgsql
 IMMUTABLE
AS $function$
begin
    RETURN QUERY
    WITH results AS (
      SELECT json_array_elements(payload) rsp
      FROM aws_lambda.invoke(
        aws_commons.create_lambda_function_arn('AuroraGeocoder'),
        json_build_object(
          'text', text,
          'biasPosition',
          CASE WHEN bias_position IS NOT NULL THEN
            array_to_json(ARRAY[ST_X(bias_position), ST_Y(bias_position)])
          END,
          'filterBBox',
          CASE WHEN filter_bbox IS NOT NULL THEN
            array_to_json(ARRAY[ST_XMin(filter_bbox), ST_YMin(filter_bbox), ST_XMax(filter_bbox), ST_YMax(filter_bbox)])
          END,
          'filterCountries', filter_countries,
          'maxResults', max_results
        )
      )
    )
    SELECT
      rsp->'Place'->>'Label' AS label,
      rsp->'Place'->>'AddressNumber' AS address_number,
      rsp->'Place'->>'Street' AS street,
      rsp->'Place'->>'Municipality' AS municipality,
      rsp->'Place'->>'PostalCode' AS postal_code,
      rsp->'Place'->>'SubRegion' AS sub_region,
      rsp->'Place'->>'Region' AS region,
      rsp->'Place'->>'Country' AS country,
      ST_GeomFromGeoJSON(
        json_build_object(
          'type', 'Point',
            'coordinates', rsp->'Place'->'Geometry'->'Point'
        )
      ) geom
    FROM results;
end;
$function$;

Panggil fungsi SQL ke geocode dari Aurora

Menjalankan pernyataan SQL memanggil fungsi Lambda AuroraGeocoder, yang mengambil catatan alamat dari tabel database dalam Amazon Aurora PostgreSQL database dan geokode mereka menggunakan sumber daya indeks tempat.

Fungsi f_SearchPlaceIndexForText SQL berikut membuat permintaan ke Amazon Location SearchPlaceIndexForText API melalui fungsi AuroraGeocoderLambda. Fungsi mengembalikan geom kolom yang merupakan geometri PostGIS, ST_AsText(geom) yang mengkonversi ke teks.

SELECT *, ST_AsText(geom)
FROM f_SearchPlaceIndexForText('Vancouver, BC');

Secara default, pengembalian akan berisi satu baris. Untuk meminta baris tambahan, hingga MaxResults batas, jalankan pernyataan SQL berikut sambil memberikan BiasPosition dan membatasi hasil di Kanada.

SELECT *
FROM f_SearchPlaceIndexForText('Mount Pleasant', ST_MakePoint(-123.113, 49.260), null, '{"CAN"}', 5);

Untuk memfilter hasil menggunakan kotak pembatas, lalu berikan Box2D asfilter_bbox:

SELECT *
FROM f_SearchPlaceIndexForText('Mount Pleasant', null, 'BOX(-139.06 48.30, -114.03 60.00)'::box2d, '{"CAN"}', 5);

Untuk informasi selengkapnya tentang jenis dan fungsi PostGIS, lihat Referensi PostGIS.

Memperkaya database yang berisi data alamat

Anda dapat membuat alamat yang diformat dan secara bersamaan menormalkan dan geocode menggunakan operasi Lokasi Amazon yang SearchPlaceIndexForText diberikan tabel database dengan data berikut dipecah menjadi kolom berikut:

WITH source_data AS (
  SELECT
    id,
    address || ', ' || city || ', ' || state || ', ' || zip AS formatted_address
  FROM addresses
),
geocoded_data AS (
  SELECT
    *,
    (f_SearchPlaceIndexForText(formatted_address)).*
  FROM source_data
)
SELECT
  id,
  formatted_address,
  label normalized_address,
  ST_Y(geom) latitude,
  ST_X(geom) longitude
FROM geocoded_data
-- limit the number of rows that will be geocoded; remove this to geocode the entire table
LIMIT 1;

Contoh berikut menggambarkan satu baris datatable yang dihasilkan:

 id |      formatted_address         |            normalized_address              |     latitude     |     longitude
----+--------------------------------+--------------------------------------------+------------------+-------------------
 42 | 123 Anytown Ave N, Seattle, WA | 123 Anytown Ave N, Seattle, WA, 12345, USA | 47.6223000127926 | -122.336745971039
(1 row)

Perbarui tabel database dan isi kolom

Contoh berikut memperbarui tabel dan mengisi kolom dengan hasil SearchPlaceIndexForText query:

WITH source_data AS (
  -- select rows that have not been geocoded and created a formatted address for each
  SELECT
    id,
    address || ', ' || city || ', ' || state || ', ' || zip AS formatted_address
  FROM addresses
  WHERE label IS NULL
  -- limit the number of rows that will be geocoded; remove this to geocode the entire table
  LIMIT 1
),
geocoded_data AS (
  -- geocode each row and keep it linked to the source's ID
  SELECT
    id,
    (f_SearchPlaceIndexForText(formatted_address)).*
  FROM source_data
)
UPDATE addresses
-- populate columns
SET
  normalized_address = geocoded_data.label,
  latitude = ST_Y(geocoded_data.geom),
  longitude = ST_X(geocoded_data.geom)
FROM geocoded_data
-- ensure that rows match
WHERE addresses.id = geocoded_data.id;

Langkah selanjutnya

Kode sampel tersedia di repositori sampel Amazon Location Service GitHub, yang AWS CloudFormation menyertakan templat.