View a markdown version of this page

Introdução - Amazon Aurora
Instalar a extensãoExecutar sua primeira consultaPróximas etapas

Introdução

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.

Tópicos

Instalar a extensão

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.

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

  2. 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.

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

Executar sua primeira consulta

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.

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

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.