Prise en main

Aurora PostgreSQL inclut la fonctionnalité d'analyse par défaut sur les versions de moteur prises en charge. Pour l'utiliser, vous activez la fonctionnalité via un paramètre de groupe de paramètres de cluster de base de données, puis vous installez l'aurora_analyticsextension dans chaque base de données où vous souhaitez l'utiliser.

L'extension crée un wrapper de données étranger et un serveur étranger nomméaurora_analytics_server. Vous créez ensuite des tables étrangères PostgreSQL liées à ce serveur qui pointent vers vos données dans Amazon S3 ou Amazon S3 Tables.

Rubriques

• Conditions préalables

• Installation de l’extension

• Exécution de votre première requête

• Étapes suivantes

Installation de l’extension

Une fois aurora_analytics.enabled défini surtrue, installez l'extension dans chaque base de données où vous souhaitez l'utiliser.

Pour installer l’extension

1. Connectez-vous à votre cluster de base de données Aurora PostgreSQL à l'aide d'un autre psql client PostgreSQL ou de l'API RDS Data.

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

2. Installez l'extension  :

   CREATE EXTENSION aurora_analytics;

Note

Pour créer l'extension, vous devez avoir le rds_superuser rôle ou être un utilisateur à qui le rds_extension rôle a été attribué et qui a délégué cette extension. Pour déléguer l'extension à un utilisateur qui n'est pas un superutilisateur, exécutez la commande suivante en tant que : rds_superuser

GRANT rds_extension TO your_user;
ALTER USER your_user SET rds.allowed_delegated_extensions = 'aurora_analytics';

Pour plus d'informations, consultez Utilisation de la prise en charge déléguée des extensions Amazon Relational Database Service pour PostgreSQL.

Vous devez installer l'extension séparément dans chaque base de données où vous souhaitez l'utiliser.

Exécution de votre première requête

Une fois l'extension installée, vous pouvez créer une table étrangère et interroger vos données Amazon S3 à l'aide du SQL standard. Pour des informations détaillées sur la syntaxe et les options des tables étrangères, consultezTravailler avec des tables étrangères.

L'exemple suivant crée une table étrangère qui pointe vers des fichiers Parquet dans Amazon S3 et l'interroge :

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

Lorsque vous spécifiez une liste de colonnes vide (()), l'extension déduit automatiquement les noms des colonnes et les types de données à partir de la source distante.

Étapes suivantes

Après avoir vérifié que l'extension est installée, vous pouvez créer des tables étrangères qui font référence à vos données dans Amazon S3. Pour plus d'informations, consultez Travailler avec des tables étrangères.