

# Introducción
<a name="aurora-analytics-getting-started"></a>

Aurora PostgreSQL incluye la característica de análisis de forma predeterminada en las versiones de motores compatibles. Para usarla, habilite la característica mediante una configuración de grupo de parámetros del clúster de base de datos y, a continuación, instale la extensión `aurora_analytics` en cada base de datos en la que desee utilizarla.

La extensión crea un contenedor de datos externo y un servidor externo llamado `aurora_analytics_server`. A continuación, cree tablas externas de PostgreSQL vinculadas a este servidor que apuntan a los datos en Amazon S3 o Tablas de Amazon S3.

**Topics**
+ [Requisitos previos](aurora-analytics-prerequisites.md)
+ [Instalación de la extensión](#aurora-analytics-getting-started-install)
+ [Ejecución de la primera consulta](#aurora-analytics-getting-started-first-query)
+ [Siguientes pasos](#aurora-analytics-getting-started-next-steps)

## Instalación de la extensión
<a name="aurora-analytics-getting-started-install"></a>

Después de establecer `aurora_analytics.enabled` en `true`, instale la extensión en cada base de datos en la que desee utilizarla.

**Instalación de la extensión**

1. Conéctese al clúster de la base de datos de Aurora PostgreSQL mediante `psql`, otro cliente de PostgreSQL o la [API de datos de RDS](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html).

   ```
   psql --host=your-cluster-endpoint.region.rds.amazonaws.com --port=5432 --username=postgres --password
   ```

1. Instale la extensión .

   ```
   CREATE EXTENSION aurora_analytics;
   ```

**nota**  
Para crear la extensión, debe tener el rol `rds_superuser` o ser un usuario al que se le haya asignado el rol `rds_extension` y se le haya delegado esta extensión. Para delegar la extensión a una persona que no sea superusuario, ejecute lo siguiente como `rds_superuser`:  

```
GRANT rds_extension TO your_user;
ALTER USER your_user SET rds.allowed_delegated_extensions = 'aurora_analytics';
```
Para obtener más información, consulte [Uso del soporte de extensión delegada de Amazon Relational Database Service para PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/PostgreSQL_delegated_extension_support.html).

Debe instalar la extensión de forma independiente en cada base de datos en la que desee utilizarla.

## Ejecución de la primera consulta
<a name="aurora-analytics-getting-started-first-query"></a>

Una vez instalada la extensión, puede crear una tabla externa y consultar los datos de Amazon S3 mediante SQL estándar. Para obtener información detallada sobre la sintaxis y las opciones de las tablas externas, consulte [Uso de tablas externas](aurora-analytics-foreign-tables.md).

En el ejemplo siguiente, se crea una tabla externa que apunta a los archivos de Parquet de Amazon S3 y la consulta:

```
-- Create a foreign table pointing to Parquet data in S3
CREATE FOREIGN TABLE ft_orders ()
SERVER aurora_analytics_server
OPTIONS (
    location 's3://my-bucket/data/orders/',
    format 'parquet',
    region 'us-east-1'
);

-- Query the foreign table
SELECT COUNT(*) FROM ft_orders;
```

Al especificar una lista de columnas vacía (`()`), la extensión deduce automáticamente los nombres de las columnas y los tipos de datos del origen remoto.

## Siguientes pasos
<a name="aurora-analytics-getting-started-next-steps"></a>

Tras comprobar que la extensión está instalada, puede crear tablas externas que hagan referencia a los datos de Amazon S3. Para obtener más información, consulte [Uso de tablas externas](aurora-analytics-foreign-tables.md).