Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

2026 年 6 月 30 日之后，Amazon Redshift 不再支持使用 Python UDF。我们将分阶段开始执行。有关 Python 生命周期终止和迁移选项详情的更多信息，请参阅 2025 年 6 月 30 日发布的博客文章。

系统表与 S3 表类数据存储服务集成

使用系统表与 Amazon S3 表类数据存储服务的集成，可将您的 Amazon Redshift 系统表数据保留超过 7 天的集群内保留期。这有助于您满足合规性、审计和可观测性要求。启用此功能后，Redshift 会将系统表日志以 Apache Iceberg 格式写入 S3 表类数据存储服务，并管理分区、压缩和快照维护。您可以根据分析和审计需要，将这些数据保留任意长的时间。由于数据以开放的 Iceberg 格式存储，您可以使用 Redshift、Amazon Athena 或任何其它与 Iceberg 兼容的引擎进行查询。您还可以使用人工智能代理技能进行自然语言查询（请参阅 GitHub 网站上的 System table skills for Amazon Agent Toolkit）。

当您通过控制台、Redshift CLI 或 SDK 启用此功能后，Redshift 很快便会开始以固定频率将您所选系统表中的新行写入 S3 表类数据存储服务。您可以选择要发布哪些系统表；S3 表类数据存储服务将强制执行您所配置的保留期。

这支持以下使用案例：

此功能适用于 Amazon Redshift 预调配 RA3 和 RG 实例以及 Amazon Redshift Serverless，覆盖所有支持 Redshift 和 S3 表类数据存储服务的 Amazon 商业区域。在本主题中，数据仓库指的是预调配集群或 Redshift Serverless 工作组。

工作原理

启用该功能并选择一个或多个受支持的系统表后，Redshift 会将这些系统表中新完成的记录写入 S3 表类数据存储服务。数据按固定频率分批传输。

系统表存在于您的 Amazon 账户中，但由服务管理：Amazon 拥有并运营数据传输和表管理，包括以下各项：

无需构建或维护基础设施，也不会对您的工作负载产生任何影响。

您可以通过 S3 表类数据存储服务记录过期功能配置保留数据的时长。有关更多信息，请参阅 配置保留期。

由于表由 Amazon 管理，因此您无法修改或删除 Redshift 传输的行。传输的数据是不可变的。您只能控制对表的读取权限。有关更多信息，请参阅 数据治理。

只有已完成的活动才会传输到 S3 表类数据存储服务。数据仓库中的系统表可以显示正在进行的活动，但只复制已达到最终状态的记录。例如，将传输已完成、已中止或已取消的查询，但仍在运行的查询要等到达到最终状态后才会传输。

启用系统表与 S3 表类数据存储服务的集成

要启用系统表与 S3 表类数据存储服务的集成，请将现有 Redshift API 与新的日志目标类型 s3table 结合使用。启用后，Redshift 会在您的账户中创建一个名为 aws-redshift 的 S3 表存储桶。您可以使用与用于其它日志目标的相同操作来管理该功能：对于预调配集群，使用 enable-logging、disable-logging 和 describe-logging-status；对于 Redshift Serverless，使用 update-namespace 和 get-namespace。

权限

启用、修改或禁用该功能的主体必须具有以下权限：

创建存储桶后，Redshift 利用 Redshift 与 S3 表类数据存储服务之间的服务信任关系，在该存储桶内创建命名空间和表。启用该功能的主体无需具备创建命名空间或表的权限。

部署选项

您可以通过以下两种模式之一配置传输。给定的数据仓库一次使用一种模式。

部署模型决定了数据在 S3 表类数据存储服务中的组织方式。在按仓库模型中，S3 表类数据存储服务命名空间名称包含数据仓库的唯一标识符，因此，每个仓库的数据在物理上隔离到其自己的命名空间中。在合并模型中，S3 表类数据存储服务命名空间名称包含 Amazon 账号，而该账户和区域中所有仓库的数据统一存储在相同的命名空间和表中。

这两个选项均支持在单个 Amazon 账户和单个 Amazon 区域内使用。要分析跨区域或跨账户的数据，请在查询时合并每个区域或账户的表中的结果。要进行跨账户访问，您可以使用 Amazon Glue 数据目录共享。有关更多信息，请参阅《Amazon Glue 开发人员指南》中的授予跨账户访问权限。

使用 控制台

要停止发布某个系统表，请返回设置并将其移除。已发布的数据将持续保留，直到您通过 S3 表类数据存储服务配置过期。

您可以从集群或命名空间详细信息页面查看集成的状态。展开查看 S3 表映射，以查看每个系统表与其对应的 S3 表名称及命名空间之间的映射关系。您也可以从 S3 表类数据存储服务控制台查看已发布的数据。

使用 Amazon CLI

以下参数用于配置 S3 表类数据存储服务发布：

预置集群

启用传输。--log-exports 接受 all 或以空格分隔的受支持系统表列表，--s3-table-granularity 接受 cluster（按仓库）或 account（已合并）。

aws redshift enable-logging \
    --cluster-identifier my-redshift-cluster \
    --log-destination-type s3table \
    --log-exports all \
    --s3-table-granularity account

要仅为特定系统表启用传输：

aws redshift enable-logging \
    --cluster-identifier my-redshift-cluster \
    --log-destination-type s3table \
    --log-exports sys_query_history sys_query_text sys_userlog \
    --s3-table-granularity cluster

检查传输状态。

aws redshift describe-logging-status \
    --cluster-identifier my-redshift-cluster

禁用传输（适用于所有系统表），或对于特定表使用 --log-exports：

aws redshift disable-logging \
    --cluster-identifier my-redshift-cluster \
    --log-destination-type s3table \
    --log-exports sys_stream_scan_states

Redshift Serverless

在 Redshift Serverless 中，您可以使用 update-namespace 为每个命名空间配置该功能。系统表名称通过 --s3-table-names（而非 --log-exports）传递。

启用传输。

aws redshift-serverless update-namespace \
    --namespace-name my-namespace \
    --log-destination-type s3table \
    --s3-table-action Enable \
    --s3-table-names all \
    --s3-table-granularity namespace

对特定的系统表禁用传输（或 all）：

aws redshift-serverless update-namespace \
    --namespace-name my-namespace \
    --log-destination-type s3table \
    --s3-table-action Disable \
    --s3-table-names sys_stream_scan_states

检查传输状态。

aws redshift-serverless get-namespace \
    --namespace-name my-namespace

要在删除 S3 表存储桶或表后恢复传输，请再次运行 enable 命令。

向 Amazon Glue Data Catalog 注册

在使用 Redshift、Athena 或其它分析服务查询保留的数据之前，服务托管的 S3 表存储桶必须先与 Amazon Glue Data Catalog 集成。每个账户和区域只需执行此步骤一次。如果您已将 S3 表类数据存储服务与 Amazon Glue Data Catalog 集成，则无需执行任何其它操作。

有关集成说明，请参阅《Amazon Glue 开发人员指南》中的将 Amazon S3 表类数据存储服务与 Amazon Glue Data Catalog 集成。

配置加密

默认情况下，传输到 S3 表类数据存储服务的数据使用 Amazon S3 托管式密钥（SSE-S3）进行加密。要改用 Amazon KMS 客户自主管理型密钥，请在启用传输时使用 --s3-table-kms-key-id 指定其 ARN：

aws redshift enable-logging \
    --cluster-identifier my-redshift-cluster \
    --log-destination-type s3table \
    --log-exports all \
    --s3-table-granularity account \
    --s3-table-kms-key-id arn:aws:kms:us-west-2:111122223333:key/key-id

如果您使用客户自主管理型密钥，则其密钥策略必须支持 Redshift 系统表集成服务主体在写入您的系统表时生成数据密钥，并可让 S3 表类数据存储服务维护服务主体在表维护（例如压缩）期间使用该密钥。将以下语句添加到密钥策略中，用您自己的值替换 REGION、ACCOUNT 和 KEY_ID。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "EnableRedshiftSystemTableKeyUsage",
      "Effect": "Allow",
      "Principal": {
        "Service": "systemtables.redshift.amazonaws.com"
      },
      "Action": [
        "kms:DescribeKey",
        "kms:GenerateDataKey",
        "kms:Decrypt"
      ],
      "Resource": "arn:aws:kms:REGION:ACCOUNT:key/KEY_ID",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "ACCOUNT"
        }
      }
    },
    {
      "Sid": "EnableS3TableMaintenanceKeyUsage",
      "Effect": "Allow",
      "Principal": {
        "Service": "maintenance.s3tables.amazonaws.com"
      },
      "Action": [
        "kms:GenerateDataKey",
        "kms:Decrypt"
      ],
      "Resource": "arn:aws:kms:REGION:ACCOUNT:key/KEY_ID",
      "Condition": {
        "StringLike": {
          "kms:EncryptionContext:aws:s3:arn": "arn:aws:s3tables:REGION:ACCOUNT:bucket/aws-redshift/*"
        }
      }
    }
  ]
}

如果密钥策略未授予这些权限，则 Redshift 无法写入加密的 S3 表类数据存储服务，传输将失败。

支持的系统表

您可以选择以下任一 SYS_* 监控视图来与 S3 表类数据存储服务集成。要了解每个视图中各列的描述，请选择视图名称。

向每个表中添加的元数据列

每个 S3 表都包含源 SYS_* 视图中的所有列，以及 Redshift 添加的以下五个元数据列，用于标识每行的来源及其传输时间。

配置保留期

Redshift 不会为其传输到 S3 表类数据存储服务的数据定义保留策略。您可以通过 S3 表类数据存储服务设置记录过期策略，来配置保留数据的时长。您可以指定天数（例如 5 天、100 天或 365 天），S3 表类数据存储服务将自动移除超过所配置的保留时长的数据。

如果您未配置过期策略，数据将无限期保留。

当您禁用集成或移除系统表时，Redshift 会停止写入新数据，但之前传输的数据仍保留在 S3 表类数据存储服务中，并且继续受您配置的任何过期策略约束。

有关更多信息，请参阅《Amazon S3 用户指南》中的为 S3 表存储桶配置记录过期。

数据治理

您可以控制对保留的系统表数据的访问权限；Redshift 不会代表您应用读取权限，也不会屏蔽数据。

传输和生命周期行为

检查传输状态

您可以随时查看每个系统表的当前配置和最近的传输时间：

Redshift Serverless

传输操作不会使工作组保持唤醒状态，也不会消耗您的计算资源。在工作组暂停之前，Redshift 会确保所有待处理的批次均已传输完毕。

最佳实践

计费

将系统表数据写入 S3 表类数据存储服务是免费的。您需要按照所用查询引擎的定价，为保留的数据支付标准 S3 表类数据存储服务的存储和维护费用，以及读取数据所用查询引擎的费用。有关更多信息，请参阅 Amazon S3 表类数据存储服务定价。

注意事项和限制