Amazon Athena Teradata 連接器

適用於 Teradata 的 Amazon Athena 連接器可讓 Athena 對存放在 Teradata 資料庫中的資料執行 SQL 查詢。

必要條件

• 使用 Athena 主控台或 AWS Serverless Application Repository，將連接器部署到您的 AWS 帳戶 。如需詳細資訊，請參閱 部署資料來源連接器 或 使用 AWS Serverless Application Repository 部署資料來源連接器 。

限制

• 不支援寫入 DDL 操作。

• 在多工器設定中，在所有資料庫執行個體之間共用溢出儲存貯體和字首。

• 任何相關的 Lambda 限制。如需詳細資訊，請參閱《AWS Lambda 開發人員指南》中的 Lambda 配額。

條款

下列術語與 Teradata 連接器相關。

• 資料庫執行個體 - 在內部部署、Amazon EC2 或 Amazon RDS 上部署的任何資料庫執行個體。

• 處理常式 - 存取資料庫執行個體的 Lambda 處理常式。處理常式可以用於中繼資料或資料記錄。

• 中繼資料處理常式 - 從資料庫執行個體中擷取中繼資料的 Lambda 處理常式。

• 記錄處理常式 - 從資料庫執行個體中擷取資料記錄的 Lambda 處理常式。

• 複合處理常式 - 從資料庫執行個體中擷取中繼資料和資料記錄的 Lambda 處理常式。

• 屬性或參數 - 處理常式用來擷取資料庫資訊的資料庫屬性。您可以將這些屬性設定為 Lambda 環境變數。

• 連接字串 - 用來建立資料庫執行個體連線的文字字串。

• 目錄 — 在 Athena 註冊的非AWS Glue 目錄，是connection_string屬性的必要前置詞。

• 多工處理常式 - 可以接受和使用多個資料庫連接的 Lambda 處理常式。

Lambda 層先決條件

若要搭配使用 Teradata 連接器與 Athena，您必須建立包含 Teradata JDBC 驅動程式的 Lambda 層。Lambda 層是包含其他 Lambda 函數的程式碼的 .zip 封存檔。將 Teradata 連接器部署到您的帳戶時，您需要指定層 ARN。這樣一來，會將具有 Tiradata JDBC 驅動程式的 Lambda 層連接到 Tiradata 連接器，以便您可以將其與 Athena 搭配使用。

如需有關 Lambda 層的詳細資訊，請參閱《AWS Lambda 開發人員指南》中的建立和共用 Lambda 層。

建立 Teradata 連接器的 Lambda 層

1. 瀏覽 Teradata JDBC 驅動程式下載頁面：https://downloads.teradata.com/download/connectivity/jdbc-driver。

2. 下載 Teradata JDBC 驅動程式。網站要求您建立一個帳戶並接受授權協議才能下載該檔案。

3. 從下載的封存檔解壓縮出 terajdbc4.jar 檔案。

4. 建立以下資料夾結構，並將 .jar 檔案放在其中。

   java\lib\terajdbc4.jar

5. 建立整個資料夾結構的 .zip 檔案，其中包含 terajdbc4.jar 檔案。

6. 請登入 AWS Management Console 並開啟 AWS Lambda 主控台，網址為 https://console.aws.amazon.com/lambda/。

7. 在導覽窗格中，選擇 Layers (層)，然後選擇 Create layer (建立層)。

8. 在 Name (名稱) 中，輸入層的名稱 (例如 TeradataJava11LambdaLayer)。

9. 確認已選取 Upload a .zip file (上傳 .zip 檔案) 選項。

10. 選擇 Upload (上傳)，然後上傳包含 Teradata JDBC 驅動程式的壓縮檔資料夾。

11. 選擇 Create (建立)。

12. 在層的詳細資訊頁面上，選擇頁面頂部的剪貼簿圖示，複製層 ARN。

13. 儲存 ARN 以供參考。

參數

使用本節中的 Lambda 環境變數來設定 Teradata 連接器。

連接字串

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

teradata://${jdbc_connection_string}

使用多工處理常式

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

處理常式	類別
複合處理常式	TeradataMuxCompositeHandler
中繼資料處理常式	TeradataMuxMetadataHandler
記錄處理常式	TeradataMuxRecordHandler

多工處理常式參數

參數	描述
$catalog_connection_string	必要。資料庫執行個體連接字串。在環境變數前面加上 Athena 中使用的目錄名稱。例如，如果向 Athena 註冊的目錄為 myteradatacatalog，則環境變數名稱為 myteradatacatalog_connection_string。
default	必要。預設的連接字串。目錄為 lambda:${AWS_LAMBDA_FUNCTION_NAME} 時，使用此字串。

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

屬性	Value
default	teradata://jdbc:teradata://teradata2.host/TMODE=ANSI,CHARSET=UTF8,DATABASE=TEST,user=sample2&password=sample2
teradata_catalog1_connection_string	teradata://jdbc:teradata://teradata1.host/TMODE=ANSI,CHARSET=UTF8,DATABASE=TEST,${Test/RDS/Teradata1}
teradata_catalog2_connection_string	teradata://jdbc:teradata://teradata2.host/TMODE=ANSI,CHARSET=UTF8,DATABASE=TEST,user=sample2&password=sample2

提供憑證

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

• 連接字串 - 可以將使用者名稱和密碼指定為 JDBC 連接字串中的屬性。

  重要

  作為安全最佳實務，請勿在您的環境變數或連線字串中使用硬式編碼憑證。如需有關將硬式編碼密碼移至的資訊 AWS Secrets Manager，請參閱《AWS Secrets Manager 使用者指南》 AWS Secrets Manager中的「將硬式編碼密碼移至」。

• AWS Secrets Manager— 若要搭配使用 Athena 聯合查詢功能 AWS Secrets Manager，連線至 Lambda 函數的虛擬私人雲端應具有網際網路存取權限，或具有連線至 Secrets Manager 的 VPC 端點。

  您可以在 JDBC 連接字符串 AWS Secrets Manager 中輸入密碼的名稱。連接器將秘密名稱取代為 Secrets Manager 中的 username 和 password 值。

  對於 Amazon RDS 資料庫執行個體，已緊密整合此支援。如果您使用 Amazon RDS，我們強烈建議您使用 AWS Secrets Manager 和登入資料輪替。如果您的資料庫不使用 Amazon RDS，請以下列格式將憑證儲存為 JSON：

  {"username": "${username}", "password": "${password}"}

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

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

teradata://jdbc:teradata1.host/TMODE=ANSI,CHARSET=UTF8,DATABASE=TEST,${Test/RDS/Teradata1}&...

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

teradata://jdbc:teradata://teradata1.host/TMODE=ANSI,CHARSET=UTF8,DATABASE=TEST,...&user=sample2&password=sample2&...

目前，Teradata 可辨識 user 和 password JDBC 屬性。它也接受格式為 username/password 的使用者名稱和密碼，而不使用金鑰 user 或 password。

使用單一連接處理常式

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

處理常式類型	類別
複合處理常式	TeradataCompositeHandler
中繼資料處理常式	TeradataMetadataHandler
記錄處理常式	TeradataRecordHandler

單一連接處理常式參數

參數	描述
default	必要。預設的連接字串。

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

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

屬性	Value
default	teradata://jdbc:teradata://teradata1.host/TMODE=ANSI,CHARSET=UTF8,DATABASE=TEST,secret=Test/RDS/Teradata1

溢出參數

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

參數	描述
spill_bucket	必要。溢出儲存貯體名稱。
spill_prefix	必要。溢出儲存貯體金鑰字首。
spill_put_request_headers	(選用) 用於溢出的 Amazon S3 putObject 請求的請求標頭和值的 JSON 編碼映射 (例如，{"x-amz-server-side-encryption" : "AES256"})。如需其他可能的標頭，請參閱 Amazon 簡單儲存服務 API 參考PutObject中的。

支援的資料類型

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

JDBC	Arrow
Boolean	位元
Integer	Tiny
Short	Smallint
Integer	Int
Long	Bigint
float	Float4
Double	Float8
日期	DateDay
時間戳記	DateMilli
字串	Varchar
位元組	Varbinary
BigDecimal	Decimal (小數)
ARRAY	清單

分割區和分隔

分割區由 Integer 類型的單一分割區資料欄表示。此資料欄包含 Teradata 資料表中所定義之分割區的分割區名稱。對於沒有分割區名稱的資料表，會傳回 *，這相當於一個單一的分割區。分割區等同於分隔。

名稱	Type	描述
分割區	Integer	Teradata 中的已命名分割區。

效能

Teradata 支援原生分割區。Athena Teradata 連接器可以平行地從這些分割區中擷取資料。如果您想要查詢具有統一分割區分佈的非常大的資料集，強烈建議使用原生分割。選取資料欄子集會大幅拖慢查詢執行時間。連接器會顯示因為並行而導致的部分限流。

Athena Teradata 連接器執行述詞下推，以減少查詢掃描的資料。簡單述詞和複雜表達式會下推至連接器，以減少掃描的資料量並減少查詢執行時間。

述詞

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

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

• 布林值：AND、OR、NOT

• 等式：EQUAL、NOT_EQUAL、LESS_THAN、LESS_THAN_OR_EQUAL、GREATER_THAN、GREATER_THAN_OR_EQUAL、NULL_IF、IS_NULL

• 算術：ADD、SUBTRACT、MULTIPLY、DIVIDE、MODULUS、NEGATE

• 其他：LIKE_PATTERN、IN

合併下推範例

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

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%');

直通查詢

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

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

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

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

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

授權資訊

使用此連接器即表示您確認已包含協力廠商元件，其清單可在此連接器的 pom.xml 檔案中找到，並同意 GitHub .com 上 LICENSE.txt 檔案中提供的個別協力廠商授權中的條款。

其他資源

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

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