Introducción a Aurora DSQL

Elija Nueva conexión de base de datos.

En la ventana Nueva conexión de base de datos, elija PostgreSQL.

En la pestaña Configuración de la conexión/Principal, elija Conectar por: host e introduzca la siguiente información.

1. Host: utilice el punto de conexión del clúster.

   Base de datos: ingrese postgres

   Autenticación: elija Database Native

   Nombre de usuario: ingrese admin

   Contraseña: genere un token de autenticación. Copie el token generado y utilícelo como contraseña.

Ignore cualquier advertencia y pegue el token de autenticación en el campo Contraseña de DBeaver.

Debe estar conectado al clúster y puede empezar a ejecutar instrucciones SQL.

Elija Nuevo origen de datos y elija PostgreSQL.

En la pestaña Orígenes de datos/General, introduzca la siguiente información:

1. Host: utilice el punto de conexión del clúster.

   Puerto: Aurora DSQL utiliza el predeterminado de PostgreSQL: 5432

   Base de datos: Aurora DSQL utiliza la predeterminada de PostgreSQL de postgres

   Autenticación: elija User & Password .

   Nombre de usuario: ingrese admin.

   Contraseña: genere un token y péguelo en este campo.

   URL: no modifique este campo. Se rellenará automáticamente según los demás campos.

Contraseña: proporciónela mediante la generación de un token de autenticación. Copie la salida resultante del generador de tokens y péguela en el campo de contraseña.

Debe estar conectado al clúster y puede empezar a ejecutar instrucciones SQL:

Inicie sesión en la AWS Management Console y abra la consola de Aurora DSQL en https://console.aws.amazon.com/dsql.

Elija Crear clúster y, a continuación, Una sola región.

(Opcional) En Configuración del clúster, seleccione cualquiera de las siguientes opciones:

(Opcional) En Etiquetas, elija o ingrese una etiqueta para este clúster.

Elija Create cluster.

En la consola de Aurora DSQL, elija el clúster al que desea conectarse.

Elija Conectar.

Copie el punto de conexión desde Punto de conexión (host).

Asegúrese de elegir Conectarse como administrador en la sección Token de autenticación (contraseña).

Copie el token de autenticación generado. Este token es válido durante 15 minutos.

En la línea de comandos del sistema operativo, utilice el siguiente comando para iniciar psql y conectarse al clúster. Reemplace your_cluster_endpoint por el punto de conexión de clúster que ha copiado anteriormente.

PGSSLMODE=require \
  psql --dbname postgres \
  --username admin \
  --host your_cluster_endpoint

Cuando se le pida una contraseña, introduzca el token de autenticación que ha copiado anteriormente. Si intenta conectarse mediante un token caducado, se denegará la solicitud de conexión. Para obtener más información, consulte Generación de un token de autenticación en Amazon Aurora DSQL.

Pulse Intro. Debe ver una petición de PostgreSQL.

postgres=>

Si obtiene un error de acceso denegado, asegúrese de que la identidad de IAM tiene el permiso dsql:DbConnectAdmin. Si tiene el permiso y sigue teniendo errores de acceso denegado, consulte Solución de problemas de IAM y ¿Cómo puedo solucionar los errores de acceso denegado u operación no autorizada con una política de IAM?

Cree un esquema denominado example.

CREATE SCHEMA example;

Cree una tabla de facturas que utilice un UUID generado automáticamente como la clave principal.

CREATE TABLE example.invoice(
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(), 
    created timestamp, 
    purchaser int, 
    amount float);

Cree un índice secundario que utilice la tabla vacía.

CREATE INDEX ASYNC invoice_created_idx on example.invoice(created);

Cree una tabla de departamentos.

CREATE TABLE example.department(id INT PRIMARY KEY UNIQUE, name text, email text);

Utilice el comando psql \include para cargar el archivo denominado department-insert-multirow.sql que descargó del repositorio aws-samples/aurora-dsql-samples en GitHub. Reemplace my-path por la ruta a la copia local.

\include my-path/department-insert-multirow.sql

Utilice el comando psql \copy para cargar el archivo denominado invoice.csv que descargó del repositorio aws-samples/aurora-dsql-samples en GitHub. Reemplace my-path por la ruta a la copia local.

\copy example.invoice(created, purchaser, amount) from my-path/invoice.csv csv

Consulte los departamentos y ordénelos por las ventas totales.

SELECT name, sum(amount) AS sum_amount
FROM example.department LEFT JOIN example.invoice ON department.id=invoice.purchaser
GROUP BY name
HAVING sum(amount) > 0
ORDER BY sum_amount DESC;

En la siguiente salida de ejemplo se muestra que el departamento tres es el que tiene más ventas.

           name           |     sum_amount     
--------------------------+--------------------
 Example Department Three |  54061.67752854594
 Example Department Seven |  53869.65965365204
 Example Department Eight |  52199.73742066634
 Example Department One   | 52034.078869900826
 Example Department Six   |  50886.15556256385
 Example Department Two   |  50589.98422247931
 Example Department Five  | 49549.852635496005
 Example Department Four  |  49266.15578027619
(8 rows)

Inicie sesión en la AWS Management Console y abra la consola de Aurora DSQL en https://console.aws.amazon.com/dsql.

En el panel de navegación, seleccione Clusters (Clústeres).

Elija Crear clúster y, a continuación, Varias regiones.

(Opcional) En Configuración del clúster, seleccione cualquiera de las siguientes opciones para el clúster inicial:

En Configuración de varias regiones, elija las siguientes opciones para el clúster inicial:

(Opcional) Elija etiquetas para el clúster inicial.

Elija Crear clúster para crear el clúster inicial. Si no ingresó un ARN en el paso anterior, la consola mostrará la notificación Configuración del clúster pendiente.

En la notificación Configuración del clúster pendiente, elija Completar la configuración del clúster de varias regiones. Esta acción inicia la creación de un segundo clúster en otra región.

Elija una de las siguientes opciones para el segundo clúster:

Elija Crear clúster en your-second-region, donde your-second-region es la ubicación del segundo clúster. La consola se abre en la segunda región.

(Opcional) Elija la configuración del clúster para el segundo clúster. Por ejemplo, puede elegir una AWS KMS key.

Elija Crear clúster para crear el segundo clúster.

Elija Emparejar en initial-cluster-region, donde initial-cluster-region es la región que aloja el primer clúster que creó.

Cuando se le pida confirmación, elija Confirmar. Este paso completa la creación del clúster de varias regiones.

Abra la consola de Aurora DSQL y elija la región del segundo clúster.

Seleccione Clusters (Clústeres).

Seleccione la fila del segundo clúster en el clúster de varias regiones.

En Acciones, elija Abrir en CloudShell.

Elija Conectar como administrador.

Elija Launch CloudShell.

Seleccione Ejecutar.

Cree un esquema de ejemplo siguiendo los pasos de Paso 3: ejecución de comandos SQL de ejemplo en Aurora DSQL.

Transacciones de ejemplo

CREATE SCHEMA example;
CREATE TABLE example.invoice(id UUID PRIMARY KEY DEFAULT gen_random_uuid(), created timestamp, purchaser int, amount float);
CREATE INDEX ASYNC invoice_created_idx on example.invoice(created);
CREATE TABLE example.department(id INT PRIMARY KEY UNIQUE, name text, email text);

Utilice los comandos copy y include de psql para cargar datos de ejemplo. Para obtener más información, consulte Paso 3: ejecución de comandos SQL de ejemplo en Aurora DSQL.

\copy example.invoice(created, purchaser, amount) from samples/invoice.csv csv
\include samples/department-insert-multirow.sql

En la consola de Aurora DSQL, elija la región del clúster inicial.

Seleccione Clusters (Clústeres).

Seleccione la fila del segundo clúster en el clúster de varias regiones.

En Acciones, elija Abrir en CloudShell.

Elija Conectar como administrador.

Elija Launch CloudShell.

Seleccione Ejecutar.

Consulte los datos que ha insertado en el segundo clúster.

SELECT name, sum(amount) AS sum_amount
FROM example.department 
LEFT JOIN example.invoice ON department.id=invoice.purchaser 
GROUP BY name 
HAVING sum(amount) > 0
ORDER BY sum_amount DESC;