使用查询编辑器 v2 计划查询

您可以使用 Amazon Redshift 查询编辑器 v2 创建运行 SQL 语句的计划。您创建一个计划，以便按照与您的业务需求相匹配的时间间隔运行 SQL 语句。当到了运行计划查询的时间时，查询由 Amazon EventBridge 启动并使用 Amazon Redshift Data API。

计划查询 视图列出了您的集群和工作组的所有计划查询。使用此视图，您可以显示计划查询的详细信息、激活或停用计划、编辑计划以及删除计划查询。查看查询详细信息时，还可以查看使用计划运行查询的历史记录。

设置计划查询的权限

要计划查询，定义计划的 Amazon Identity and Access Management（IAM）用户以及与计划关联的 IAM 角色必须配置了使用 Amazon EventBridge 和 Amazon Redshift Data API 的 IAM 权限。要接收来自计划查询的电子邮件，还必须配置可选指定的 Amazon SNS 通知。

以下内容描述了使用 Amazon 托管式策略提供权限的任务，但根据您的环境，您可能需要缩小允许的权限范围。

对于登录到查询编辑器 v2 的 IAM 用户，请使用 IAM 控制台（https://console.aws.amazon.com/iam/）编辑 IAM 用户。

对于您指定为允许运行计划查询的 IAM 角色，请使用 IAM 控制台（https://console.aws.amazon.com/iam/）编辑 IAM 角色。

对计划查询进行身份验证

GRANT all ON TABLE mytable TO "IAMR:MyRedshiftQEv2Scheduler";

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "UseTemporaryCredentialsForAllServerlessWorkgroups",
            "Effect": "Allow",
            "Action": "redshift-serverless:GetCredentials",
            "Resource": [
                "arn:aws:redshift-serverless:*:*:workgroup/*"
            ]
        }
    ]
}

设置查看计划查询历史记录的权限

要允许用户查看计划查询历史记录，请编辑 IAM 角色（随计划指定）信任关系以添加权限。

以下是 IAM 角色中的信任策略示例，该策略允许 IAM 用户 myIAMusername 查看计划查询历史记录。您可以选择允许 IAM 角色拥有 sts:AssumeRole 权限，而不是允许 IAM 用户拥有此权限。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "redshift.amazonaws.com",
                    "redshift-serverless.amazonaws.com"
                ]
            },
            "Action": "sts:AssumeRole"
        },
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "events.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        },
        {
            "Sid": "AssumeRole",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:user/myIAMusername"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

监控计划查询

对于您指定用于发送电子邮件通知的 Amazon SNS 主题，请使用查询编辑器 v2 创建 Amazon SNS 主题，方法是导航到 SNS 通知部分，开启监控，然后使用创建 SNS 主题来创建主题。查询编辑器 v2 创建 Amazon SNS 主题，并将服务主体添加到 Amazon EventBridge 的访问策略中。以下是在 Amazon SNS 主题中创建的示例访问策略。在示例中，使用了 Amazon Web Services 区域 us-west-2、Amazon Web Services 账户 123456789012 以及 Amazon SNS 主题 select-version-pdx-testunload。

{
  "Version": "2008-10-17",
  "Id": "__default_policy_ID",
  "Statement": [
    {
      "Sid": "Allow_Publish_Events",
      "Effect": "Allow",
      "Principal": {
        "Service": "events.amazonaws.com"
      },
      "Action": "sns:Publish",
      "Resource": "arn:aws:sns:us-west-2:123456789012:select-version-pdx-testunload"
    }
  ]
}

计划查询运行时，Amazon SNS 会发送 Amazon 通知电子邮件。以下示例显示了使用 Amazon SNS 通知主题 may25a-SNS，为 Amazon Web Services 账户 123456789012 中在 Amazon Web Services 区域 eu-north-1 上运行的计划查询 QS2-may25a 发送到 myemail@example.com 的电子邮件。

{"version":"0","id":"8e4323ec-5258-7138-181b-91290e30ff9b","detail-type":"Scheduled Event","source":"aws.events","account":"123456789012","time":"2023-05-25T15:22:00Z",
                    "region":"eu-north-1","resources":["arn:aws:events:eu-north-1:123456789012:rule/QS2-may25a"],"detail":{}}

--
If you wish to stop receiving notifications from this topic, please click or visit the link below to unsubscribe:
https://sns.eu-north-1.amazonaws.com/unsubscribe.html?SubscriptionArn=arn:aws:sns:eu-north-1:123456789012:may25a-SNS:0c1a3d05-39c2-4507-bc3d-47250513d7b0&Endpoint=myemail@example.com

Please do not reply directly to this email. If you have any questions or comments regarding this email, please contact us at https://aws.amazon.com/support

计划查询设置故障排除

通过 Amazon CloudShell 查找有关计划查询的详细信息

您可以使用 Amazon CloudShell 查找有关计划查询的详细信息。您必须具有适当的权限才能运行 Amazon CLI 命令，如以下过程所示。

安排查询的演示

有关安排查询的演示，请观看以下视频。