适用于 Aurora 的 Amazon RDS 代理

每个 Amazon Web Services 账户 ID 限制为 20 个代理。如果您的应用程序需要更多代理，请通过 Amazon Web Services Management Console中的服务配额页面申请增加代理。在服务配额页面中，选择 Amazon Relational Database Service（Amazon RDS），然后找到代理以申请增加配额。Amazon 可以自动增加您的配额，或者等待 Amazon Web Services 支持 审核您的申请。

每个代理最多可拥有 200 个关联的 Secrets Manager 密钥。因此，每个代理可以在任何给定时间连接多达 200 个不同的用户账户。

每个代理都具有一个默认端点。您还可以为每个代理添加最多 20 个代理端点。您可以创建、查看、修改和删除这些端点。

在 Aurora 集群中，使用默认代理端点的所有连接都由 Aurora 写入器实例处理。要对读取密集型工作负载执行负载均衡，您可以为代理创建只读端点。该端点会将连接传递到集群的读取器端点。这样，您的代理连接就可以利用 Aurora 读取可扩展性。有关更多信息，请参阅“代理终端节点概述”。

您可以将 RDS 代理用于 Aurora Serverless v2 集群，但不能用于 Aurora Serverless v1 集群。

您的 RDS 代理必须与数据库位于同一 Virtual Private Cloud (VPC) 中。代理无法公开访问，但数据库可以。例如，如果在本地主机上进行数据库原型设计，则无法连接到代理，除非设置必要的网络要求来允许连接到代理。这是因为您的本地主机不在代理的 VPC 范围内。

您不能将 RDS 代理用于其租户设置为 dedicated 的 VPC。

如果您将 RDS 代理与启用了 IAM 身份验证的 Aurora 数据库集群结合使用，请检查用户身份验证。通过代理连接的用户必须通过登录凭证进行身份验证。有关 RDS 代理中 Secrets Manager 和 IAM 支持的详细信息，请参阅在 Amazon Secrets Manager 中设置 RDS 代理的数据库凭证和为 RDS 代理配置 IAM 身份验证。

使用 SSL 主机名验证时，不能将 RDS 代理与自定义 DNS 一起使用。

每个代理都可以与单个目标数据库集群相关联。不过，您可以将多个代理与同一个数据库集群关联。

文本大小大于 16 KB 的任何语句都会导致代理将会话固定到当前连接。

某些区域在创建代理时需要考虑可用区（AZ）限制。美国东部（弗吉尼亚州北部）区域在 use1-az3 可用区中不支持 RDS 代理。美国西部（加利福尼亚北部）区域在 usw1-az2 可用区中不支持 RDS 代理。如果在创建代理时选择子网，请确保不要在上述可用区中选择子网。

目前，RDS 代理不支持任何全局条件上下文键。

有关全局条件上下文键的更多信息，请参阅《IAM 用户指南》中的 Amazon 全局条件上下文键。

不能将 RDS 代理与 RDS Custom for SQL Server 一起使用。

要将任何数据库参数组修改反映到您的代理，需要重启实例，即使您选择立即应用更改也不例外。对于集群级参数，需要在集群范围内重启。

当注册代理目标时，您的代理会自动创建 rdsproxyadmin 数据库用户。这是受保护的用户，对于代理功能至关重要。您应该避免以任何身份篡改 rdsproxyadmin 用户。删除或修改 rdsproxyadmin 用户或其权限可能导致应用程序完全无法使用代理。

Aurora MySQL 的额外限制

Aurora PostgreSQL 的额外限制

RDS 代理对 caching_sha2_password 身份验证的支持需要安全（TLS）连接。

对 caching_sha2_password 的 RDS 代理支持已知与某些 go-sql 驱动程序版本存在兼容性问题。

使用 MySQL 8.4 C 驱动程序时，如果预编译语句中的参数计数超过占位符计数，mysql_stmt_bind_named_param API 可能会形成格式错误的数据包。这会导致错误的响应。有关更多信息，请参阅 MySQL 错误报告。

目前，所有代理均在端口 3306 上侦听 MySQL。代理仍使用您在数据库设置中指定的端口连接到您的数据库。

不能将 RDS 代理与 EC2 实例中自管理的 MySQL 数据库一起使用。

您不能将 RDS 代理与数据库参数组中的 read_only 参数设置为 1 的 RDS for MySQL 数据库实例一起使用。

RDS 代理不支持 MySQL 压缩模式。例如，它不支持 mysql 命令的 --compress 或 -C 选项使用的压缩。

当 RDS 代理重用相同的数据库连接运行其他查询时，处理 GET DIAGNOSTIC 命令的数据库连接可能会返回不准确的信息。当 RDS 代理多路复用数据库连接时，可能会发生这种情况。

某些 SQL 语句和函数（如 SET LOCAL）可以更改连接状态而不会引起固定。有关最新的固定行为，请参阅 避免固定 RDS 代理。

不支持在多语句查询中使用 ROW_COUNT() 函数。

RDS 代理不支持无法在一个 TLS 记录中处理多条响应消息的客户端应用程序。

RDS 代理不支持 PostgreSQL 的会话固定筛选条件。

目前，所有代理均在端口 5432 上侦听 PostgreSQL。

对于 PostgreSQL，RDS 代理目前不支持通过发出 CancelRequest 来取消来自客户端的查询。例如，使用 Ctrl+C 取消交互式 psql 会话中长时间运行的查询时，就会出现这种情况。

PostgreSQL 函数 lastval 的结果并不总是准确的。作为解决方法，请将 INSERT 语句与 RETURNING 子句一起使用。

RDS 代理目前不支持流式复制模式。

default 数据库必须存在。

如果您使用 ALTER ROLE 通过 SET ROLE 更改用户角色，但后续以该用户身份连接到代理时若遇到固定问题，则这些后续连接可能不会使用此角色设置。为防止出现这种情况，在使用代理时，请在代理的初始化查询中使用 SET ROLE。有关更多信息，请参阅 为 Amazon Aurora 创建代理中的初始化查询。