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

使用叢集比較 Aurora Serverless v2和佈建叢集的 Amazon RDS Data API Aurora Serverless v1 行為

Amazon RDS Data APIs 的最新增強功能可讓使用最新版 PostgreSQL 或 MySQL 引擎的叢集使用資料 APIs。這些叢集可設定為使用或Aurora Serverless v2佈建執行個體類別，例如 db.r6g或 db.r6i。

下列各節說明 Aurora Serverless v2和佈建資料庫叢集和 資料庫叢集之間的 Amazon RDS Data API Aurora Serverless v1 差異。 Aurora Serverless v1資料庫叢集使用 serverless 引擎模式。佈建的資料庫叢集使用provisioned引擎模式。Aurora Serverless v2 資料庫叢集也會使用provisioned引擎模式，並包含一或多個具有執行個體類別的Aurora Serverless v2資料庫db.serverless執行個體。

每秒請求數上限

Aurora Serverless v1

資料 APIs 每秒最多可提出 1，000 個請求。

Aurora Serverless v2

資料 APIs 每秒可以提出不限數量的請求。

在現有資料庫上啟用或停用 Amazon RDS Data API

CloudTrail 事件

Aurora Serverless v1

資料 API 呼叫的事件是管理事件。根據預設，這些事件會自動包含在線索中。如需詳細資訊，請參閱從 AWS CloudTrail 追蹤中排除資料 API 事件 (Aurora Serverless v1僅限 )。

Aurora Serverless v2

資料 API 呼叫的事件是資料事件。預設會在線索中自動排除這些事件。如需詳細資訊，請參閱在 AWS CloudTrail 追蹤中包含資料 API 事件。

多陳述式支援

Aurora Serverless v2

不支援多陳述式。嘗試在單一 API 呼叫中執行多個陳述式會傳回 “An error occurred (ValidationException) when calling the ExecuteStatement operation: Multistatements aren't supported.”。若要執行多個陳述式，請分別進行 ExecuteStatement API 呼叫或使用 BatchExecuteStatement進行批次處理。

下列範例顯示嘗試執行多陳述式之 API 呼叫所產生的錯誤訊息。

 aws rds-data execute-statement \    
    --resource-arn "arn:aws:rds:region:account:cluster:cluster-name" \    
    --secret-arn "arn:aws:secretsmanager:region:account:secret:secret-name" \    
    --database "your_database" \
    --sql "SELECT * FROM your_table; Select * FROM next_table;
                                
                                "An error occurred (ValidationException) when calling the ExecuteStatement operation: Multistatements aren't supported.

下列範例會使用不同的 ExecuteStatement API 呼叫執行多個陳述式。

aws rds-data execute-statement \
    --resource-arn "arn:aws:rds:region:account:cluster:cluster-name" \
    --secret-arn "arn:aws:secretsmanager:region:account:secret:secret-name" \
    --database "your_database" \
    --sql "SELECT * FROM your_table;"

aws rds-data execute-statement \
    --resource-arn "arn:aws:rds:region:account:cluster:cluster-name" \
    --secret-arn "arn:aws:secretsmanager:region:account:secret:secret-name" \
    --database "your_database" \
    --sql "SELECT * FROM next_table;"

相同交易 ID 的並行請求

Aurora Serverless v1

後續請求會等到目前的請求完成。如果等待期間過長，您的應用程式需要處理逾時錯誤。

Aurora Serverless v2

當資料 API 收到具有相同交易 ID 的多個請求時，它會立即傳回此錯誤：

DatabaseErrorException: Transaction is still running a query

此錯誤會在兩種情況下發生：

下列範例顯示與 平行執行的所有請求promise.all()。

const api_calls = [];
for (let i = 0; i < 10; i++) {
api_calls.push(
    client.send(
    new ExecuteStatementCommand({
        ...params,
        sql: `insert into table_name values (i);`,
        transactionId
    })
    )
);
}
await Promise.all(api_calls);

若要解決此錯誤，請等待目前的請求完成，再傳送另一個具有相同交易 ID 的請求，或移除交易 ID 以允許平行請求。

下列範例顯示使用具有相同交易 ID 的循序執行的 API 呼叫。

 for (let i = 0; i < 10; i++) {
    await client.send(
    new ExecuteStatementCommand({
        ...params,
        sql: `insert into table_name values (i);`,
        transactionId
    })
    ).promise()
);
}

BatchExecuteStatement 行為

如需 的詳細資訊BatchExecuteStatement，請參閱 BatchExecuteStatement。

Aurora Serverless v1

更新結果中產生的欄位物件包含插入的值。

ExecuteSQL 行為

如需 的詳細資訊ExecuteSQL，請參閱 ExecuteSQL。

Aurora Serverless v1

ExecuteSQL 操作已棄用。

Aurora Serverless v2

不支援 ExecuteSQL操作。

ExecuteStatement 行為

如需 的詳細資訊ExecuteStatement，請參閱 ExecuteStatement。

Aurora Serverless v1

ExecuteStatement 參數支援擷取分段陣列資料欄和所有進階資料類型。

Aurora Serverless v2

ExecuteStatement 參數不支援多維陣列資料欄。它也不支援某些 PostgreSQL 資料類型，包括幾何和貨幣類型。當資料 API 遇到不支援的資料類型時，它會傳回此錯誤 – UnsupportedResultException: The result contains the unsupported data type data_type。

若要解決此問題，請將不支援的資料類型轉換為 TEXT。下列範例會將不支援的資料類型轉換為 TEXT。

SELECT custom_type::TEXT FROM my_table;-- 
ORSELECT CAST(custom_type AS TEXT) FROM my_table;

如需每個 Aurora 資料庫引擎支援的資料類型清單，請參閱資料 API 操作參考。

結構描述參數行為

Aurora Serverless v1

不支援 Schema 參數。當您在 API 呼叫中包含 Schema 參數時，資料 API 會忽略 參數。

Aurora Serverless v2

Schema 參數已棄用。當您在 API 呼叫中包含 Schema 參數時，資料 API 會傳回此錯誤 – ValidationException: The schema parameter isn't supported。下列範例顯示傳回ValidationException錯誤的 Data API 呼叫。

aws rds-data execute-statement \
--resource-arn "arn:aws:rds:region:account:cluster:cluster-name" \
--secret-arn "arn:aws:secretsmanager:region:account:secret:secret-name" \
--database "your_database" \
--schema "your_schema" \
--sql "SELECT * FROM your_table LIMIT 10"
                

若要解決此問題，請從 API 呼叫中移除 Schema 參數。

下列範例顯示已移除 Schema 參數的資料 API 呼叫。

aws rds-data execute-statement \   
--resource-arn "arn:aws:rds:region:account:cluster:cluster-name" \    
--secret-arn "arn:aws:secretsmanager:region:account:secret:secret-name" \    
--database "your_database" \    
--sql "SELECT * FROM your_table LIMIT 10"