# はじめに
<a name="aurora-analytics-getting-started"></a>

Aurora PostgreSQL には、サポートされているエンジンバージョンにおいて、デフォルトで分析機能が含まれています。これを使用するには、DB クラスターパラメータグループ設定を使用して機能を有効にし、使用する各データベースに `aurora_analytics` 拡張機能をインストールします。

拡張機能は、外部データラッパーと `aurora_analytics_server` という名前の外部サーバーを作成します。次に、Amazon S3 または Amazon S3 Tables のデータを指す、このサーバーにリンクされた PostgreSQL 外部テーブルを作成します。

**Topics**
+ [前提条件](aurora-analytics-prerequisites.md)
+ [拡張機能のインストール](#aurora-analytics-getting-started-install)
+ [最初のクエリを実行する](#aurora-analytics-getting-started-first-query)
+ [次のステップ](#aurora-analytics-getting-started-next-steps)

## 拡張機能のインストール
<a name="aurora-analytics-getting-started-install"></a>

`aurora_analytics.enabled` を `true` に設定したら、使用する各データベースに拡張機能をインストールします。

**拡張機能をインストールするには**

1. `psql`、その他の PostgreSQL クライアント、または [RDS Data API](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html) を使用して、Aurora PostgreSQL DB クラスターに接続します。

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

1.  拡張機能をインストールします。

   ```
   CREATE EXTENSION aurora_analytics;
   ```

**注記**  
拡張機能を作成するには、`rds_superuser` ロールを持っているか、`rds_extension` ロールが付与され、この拡張機能を委任されたユーザーである必要があります。拡張機能をスーパーユーザー以外のユーザーに委任するには、`rds_superuser` として以下を実行します。  

```
GRANT rds_extension TO your_user;
ALTER USER your_user SET rds.allowed_delegated_extensions = 'aurora_analytics';
```
詳細については、「[Amazon Relational Database Service の PostgreSQL 用委任拡張機能サポートの使用](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/PostgreSQL_delegated_extension_support.html)」を参照してください。

拡張機能は、使用するデータベースごとに個別にインストールする必要があります。

## 最初のクエリを実行する
<a name="aurora-analytics-getting-started-first-query"></a>

拡張機能をインストールしたら、外部テーブルを作成し、標準 SQL を使用して Amazon S3 データをクエリできます。外部テーブルの構文とオプションの詳細については、「[外部テーブルの使用](aurora-analytics-foreign-tables.md)」を参照してください。

次の例では、Amazon S3 の Parquet ファイルを指す外部テーブルを作成し、クエリを実行します。

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

空の列リスト (`()`) を指定すると、拡張機能はリモートソースから列名とデータ型を自動的に推測します。

## 次のステップ
<a name="aurora-analytics-getting-started-next-steps"></a>

拡張機能がインストールされていることを確認したら、Amazon S3 のデータを参照する外部テーブルを作成できます。詳細については、「[外部テーブルの使用](aurora-analytics-foreign-tables.md)」を参照してください。