Amazon Athena PostgreSQL 連接器

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

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

Amazon Athena PostgreSQL 連接器讓 Athena 能夠存取您的 PostgreSQL 資料庫。

此連接器可以向 Glue Data Catalog 註冊為聯合型目錄。它支援 Lake Formation 中在目錄、資料庫、資料表、資料欄、資料列和標籤層級定義的資料存取控制。此連接器使用 Glue Connections 來集中 Glue 中的組態屬性。

先決條件

限制

條款

參數

使用本節中的參數來設定 PostgreSQL 連接器。

Glue 連線 （建議）

建議您使用 Glue 連線物件來設定 PostgreSQL 連接器。

若要執行此操作，請將 PostgreSQL 連接器 Lambda glue_connection的環境變數設定為要使用的 Glue 連線名稱。

使用以下命令取得 Glue 連線物件的結構描述。此結構描述包含可用於控制連線的所有參數。

aws glue describe-connection-type --connection-type POSTGRESQL

舊版連線

下列參數名稱和定義適用於在沒有相關聯 Glue 連線的情況下建立的 Athena 資料來源連接器。只有在您手動部署舊版的 Athena 資料來源連接器或未指定glue_connection環境屬性時，才能使用下列參數。

連接字串

使用下列格式的 JDBC 連接字串來連接資料庫執行個體。

postgres://${jdbc_connection_string}

使用多工處理常式

您可以使用多工器透過單一 Lambda 函數連接到多個資料庫執行個體。按目錄名稱路由請求。在 Lambda 中使用下列類別。

多工處理常式參數

下列範例屬性適用於支援兩個資料庫執行個體的 PostGreSql MUX Lambda 函數：postgres1 (預設) 和 postgres2。

提供憑證

要在 JDBC 連接字串中提供資料庫的使用者名稱和密碼，可以使用連接字串屬性或 AWS Secrets Manager。

帶有秘密名稱的連接字串範例

以下字串具有秘密名稱 ${Test/RDS/PostGres1}。

postgres://jdbc:postgresql://postgres1.host:5432/default?...&${Test/RDS/PostGres1}&...

連接器會使用秘密名稱來擷取秘密並提供使用者名稱和密碼，如下列範例所示。

postgres://jdbc:postgresql://postgres1.host:5432/default?...&user=sample2&password=sample2&...

目前，PostgreSQL 連接器可辨識 user 和 password JDBC 屬性。

正在啟用 SSL

若要在 PostgreSQL 連線中支援 SSL，請將下列內容附加到您的連線字串中：

&sslmode=verify-ca&sslfactory=org.postgresql.ssl.DefaultJavaSSLFactory

範例

下列範例連線字串並未使用 SSL。

postgres://jdbc:postgresql://example-asdf-aurora-postgres-endpoint:5432/asdf?user=someuser&password=somepassword

若要啟用 SSL，請依照下列方式修改字串。

postgres://jdbc:postgresql://example-asdf-aurora-postgres-endpoint:5432/asdf?user=someuser&password=somepassword&sslmode=verify-ca&sslfactory=org.postgresql.ssl.DefaultJavaSSLFactory

使用單一連接處理常式

您可以使用下列單一連接中繼資料和記錄處理常式來連接至單一 PostgreSQL 執行個體。

單一連接處理常式參數

單一連接處理常式支援一個資料庫執行個體，並且必須提供 default 連接字串參數。忽略所有其他連接字串。

下列範例屬性適用於 Lambda 函數所支援的單一 PostgreSQL 執行個體。

溢出參數

Lambda SDK 可能會將資料溢出至 Amazon S3。由相同 Lambda 函數存取的所有資料庫執行個體溢出到相同的位置。

支援的資料類型

下表顯示 JDBC、PostGreSQL 和 Arrow 的相應資料類型。

分割區和分隔

分割區用於決定如何產生連接器的分割。Athena 建構了類型 varchar 的合成資料欄，表示資料表的分割結構，以幫助連接器產生分割。連接器不會修改實際的資料表定義。

效能

PostgreSQL 支援原生分割區。Athena PostgreSQL 連接器可以平行地從這些分割區中擷取資料。如果您想要查詢具有統一分割區分佈的非常大的資料集，強烈建議使用原生分割。

Athena PostgreSQL 連接器執行述詞下推，以減少查詢掃描的資料。LIMIT 子句、簡單述詞和複雜的表達式會下推至連接器，以減少掃描的資料量並縮短查詢執行時間。不過，選取資料欄子集有時會導致查詢執行期更長。

LIMIT 子句

LIMIT N 陳述句可減少查詢掃描的資料。透過 LIMIT N 下推，連接器只會向 Athena 傳回 N 個資料列。

述詞

述詞是 SQL 查詢的 WHERE 子句中的一種表達式，它會評估為布林值，並根據多個條件篩選資料列。Athena PostgreSQL 連接器可以合併這些表達式，並將其直接推送至 PostgreSQL，以增強功能並減少掃描的資料量。

下列 Athena PostgreSQL 連接器運算子支援述詞下推：

合併下推範例

如需增強的查詢功能，請合併下推類型，如以下範例所示：

SELECT * 
FROM my_table 
WHERE col_a > 10 
    AND ((col_a + col_b) > (col_c % col_d))
    AND (col_e IN ('val1', 'val2', 'val3') OR col_f LIKE '%pattern%') 
LIMIT 10;

傳遞查詢

PostgreSQL 連接器支援傳遞查詢。傳遞查詢使用資料表函數，將您的完整查詢向下推送至資料來源以進行執行。

若要搭配 PostgreSQL 使用傳遞查詢，您可以使用下列語法：

SELECT * FROM TABLE(
        system.query(
            query => 'query string'
        ))

下列範例查詢會將查詢向下推送至 PostgreSQL 中的資料來源。查詢會選取customer資料表中的所有資料欄，將結果限制為 10。

SELECT * FROM TABLE(
        system.query(
            query => 'SELECT * FROM customer LIMIT 10'
        ))

其他資源

如需最新的 JDBC 驅動程式版本資訊，請參閱 GitHub.com 上 PostgreSQL 連接器的 pom.xml 檔案。

如需此連接器的其他資訊，請造訪 GitHub.com 上的相應網站。