# Introdução
<a name="aurora-analytics-getting-started"></a>

O Aurora PostgreSQL inclui o recurso de analytics por padrão nas versões compatíveis do mecanismo. Para usá-lo, habilite o recurso por meio de uma configuração no grupo de parâmetros do cluster de banco de dados e, em seguida, instale a extensão `aurora_analytics` em cada banco de dados em que deseja usá-lo.

A extensão cria um wrapper de dados estrangeiros e um servidor estrangeiro chamado `aurora_analytics_server`. Em seguida, crie tabelas estrangeiras do PostgreSQL vinculadas a esse servidor que apontem para os dados no Amazon S3 ou nas Tabelas do Amazon S3.

**Topics**
+ [Pré-requisitos](aurora-analytics-prerequisites.md)
+ [Instalar a extensão](#aurora-analytics-getting-started-install)
+ [Executar sua primeira consulta](#aurora-analytics-getting-started-first-query)
+ [Próximas etapas](#aurora-analytics-getting-started-next-steps)

## Instalar a extensão
<a name="aurora-analytics-getting-started-install"></a>

Depois que `aurora_analytics.enabled` estiver definido como `true`, instale a extensão em cada banco de dados em que deseja usá-la.

**Como instalar a extensão**

1. Conecte-se ao cluster de banco de dados do Aurora PostgreSQL usando `psql`, outro cliente PostgreSQL ou a [API de dados do 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 a extensão :

   ```
   CREATE EXTENSION aurora_analytics;
   ```

**nota**  
Para criar a extensão, é necessário ter o perfil `rds_superuser` ou ser um usuário ao qual o perfil `rds_extension` tenha sido concedido e ao qual essa extensão tenha sido delegada. Para delegar a extensão a um usuário que não seja superusuário, execute o seguinte comando como `rds_superuser`:  

```
GRANT rds_extension TO your_user;
ALTER USER your_user SET rds.allowed_delegated_extensions = 'aurora_analytics';
```
Consulte mais informações em [Como usar o suporte a extensões delegadas do Amazon Relational Database Service para PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/PostgreSQL_delegated_extension_support.html).

É necessário instalar a extensão separadamente em cada banco de dados em que deseja usá-la.

## Executar sua primeira consulta
<a name="aurora-analytics-getting-started-first-query"></a>

Depois que a extensão for instalada, é possível criar uma tabela estrangeira e consultar os dados no Amazon S3 usando SQL padrão. Consulte informações detalhadas sobre a sintaxe e as opções das tabelas estrangeiras em [Trabalhar com tabelas estrangeiras](aurora-analytics-foreign-tables.md).

O exemplo a seguir cria uma tabela estrangeira que aponta para arquivos Parquet no Amazon S3 e consulta esses dados:

```
-- 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;
```

Quando você especifica uma lista de colunas vazia (`()`), a extensão infere automaticamente os nomes das colunas e os tipos de dados com base na fonte remota.

## Próximas etapas
<a name="aurora-analytics-getting-started-next-steps"></a>

Depois de verificar se a extensão está instalada, é possível criar tabelas estrangeiras que façam referência aos dados no Amazon S3. Para obter mais informações, consulte [Trabalhar com tabelas estrangeiras](aurora-analytics-foreign-tables.md).