本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 開始使用
<a name="aurora-analytics-getting-started"></a>

Aurora PostgreSQL 預設會在支援的引擎版本上包含分析功能。若要使用此功能，您可以透過資料庫叢集參數群組設定啟用此功能，然後在您要使用它的每個資料庫中安裝`aurora_analytics`擴充功能。

延伸項目會建立外部資料包裝函式和名為 的外部伺服器`aurora_analytics_server`。然後，您可以建立連結至此伺服器的 PostgreSQL 外部資料表，以指向 Amazon S3 或 Amazon S3 資料表中的資料。

**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 資料庫叢集。

   ```
   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';
```
如需詳細資訊，請參閱[使用 PostgreSQL 的 Amazon Relational Database Service 委派延伸支援](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)。