

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Nozioni di base
<a name="aurora-analytics-getting-started"></a>

Aurora PostgreSQL include la funzionalità di analisi per impostazione predefinita nelle versioni dei motori supportate. Per utilizzarla, è necessario abilitare la funzionalità tramite un'impostazione del gruppo di parametri del cluster DB, quindi installare l'`aurora_analytics`estensione in ogni database in cui si desidera utilizzarla.

L'estensione crea un wrapper di dati esterni e un server esterno denominato. `aurora_analytics_server` Quindi crei tabelle esterne PostgreSQL collegate a questo server che puntano ai tuoi dati in Amazon S3 o Amazon S3 Tables.

**Topics**
+ [Prerequisiti](aurora-analytics-prerequisites.md)
+ [Installazione dell'estensione ](#aurora-analytics-getting-started-install)
+ [Esecuzione della prima query](#aurora-analytics-getting-started-first-query)
+ [Fasi successive](#aurora-analytics-getting-started-next-steps)

## Installazione dell'estensione 
<a name="aurora-analytics-getting-started-install"></a>

After `aurora_analytics.enabled` è impostato su`true`, installa l'estensione in ogni database in cui desideri utilizzarla.

**Per installare l'estensione**

1. [Connettiti al tuo cluster Aurora PostgreSQL DB utilizzando un altro client PostgreSQL o l'`psql`API RDS Data.](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. Installare l'estensione :

   ```
   CREATE EXTENSION aurora_analytics;
   ```

**Nota**  
Per creare l'estensione, devi avere il `rds_superuser` ruolo o essere un utente a cui è stato concesso il ruolo e che ha delegato l'estensione. `rds_extension` Per delegare l'estensione a un non superutente, esegui quanto segue come: `rds_superuser`  

```
GRANT rds_extension TO your_user;
ALTER USER your_user SET rds.allowed_delegated_extensions = 'aurora_analytics';
```
Per ulteriori informazioni, consulta [Utilizzo del supporto delle estensioni delegate di Amazon Relational Database Service per](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/PostgreSQL_delegated_extension_support.html) PostgreSQL.

È necessario installare l'estensione separatamente in ogni database in cui si desidera utilizzarla.

## Esecuzione della prima query
<a name="aurora-analytics-getting-started-first-query"></a>

Dopo aver installato l'estensione, puoi creare una tabella esterna e interrogare i dati di Amazon S3 utilizzando SQL standard. Per informazioni dettagliate sulla sintassi e sulle opzioni delle tabelle esterne, consulta. [Lavorare con tabelle esterne](aurora-analytics-foreign-tables.md)

L'esempio seguente crea una tabella esterna che punta ai file Parquet in Amazon S3 e la interroga:

```
-- 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 specifichi un elenco di colonne vuoto (`()`), l'estensione deduce automaticamente i nomi delle colonne e i tipi di dati dalla fonte remota.

## Fasi successive
<a name="aurora-analytics-getting-started-next-steps"></a>

Dopo aver verificato che l'estensione sia installata, puoi creare tabelle esterne che fanno riferimento ai tuoi dati in Amazon S3. Per ulteriori informazioni, consulta [Lavorare con tabelle esterne](aurora-analytics-foreign-tables.md).