本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Toolkit for VS Code 中的 Amazon Redshift
<a name="redshift"></a>

Amazon Redshift 是云中一种完全托管的 PB 级数据仓库服务。有关 Amazon Redshift 服务的详细信息，请参阅《[Amazon Redshift](https://docs.aws.amazon.com/redshift/) 用户指南》目录。

以下主题介绍了如何通过 AWS Toolkit for Visual Studio Code 使用 Amazon Redshift。

**Topics**
+ [使用 Amazon Redshift](redshift-overview.md)

# 通过 Toolkit for VS Code 使用 Amazon Redshift
<a name="redshift-overview"></a>

以下各节介绍了如何开始通过 AWS Toolkit for Visual Studio Code 使用 Amazon Redshift。

有关 Amazon Redshift 服务的详细信息，请参阅《[Amazon Redshift](https://docs.aws.amazon.com/redshift/) 用户指南》主题。

## 入门
<a name="redshift-overview-prereqs"></a>

要开始通过 AWS Toolkit for Visual Studio Code 使用 Amazon Redshift，必须满足以下要求。

1. 您已通过 Toolkit 连接到您的 AWS 账户。有关通过 Toolkit 连接到 AWS 账户的更多信息，请参阅本用户指南中的[连接到 AWS](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/connect.html) 主题。

1. 您已经创建了预置数据仓库或无服务器数据仓库。

如果您尚未创建 Amazon Redshift Serverless 或 Amazon Redshift 预置集群，以下流程介绍了如何通过 AWS 控制台使用示例数据集创建数据仓库。

**创建预置数据仓库**

有关创建 Amazon Redshift 预置集群数据仓库的更多详细信息，请参阅《Amazon Redshift 入门用户指南》**中的[创建示例 Amazon Redshift 集群](https://docs.aws.amazon.com/redshift/latest/gsg/rs-gsg-sample-data-load-create-cluster.html)主题。

1. 在您的首选互联网浏览器中，登录 AWS 管理控制台，然后打开 Amazon Redshift 控制台，网址为：[https://console.aws.amazon.com/redshift/](https://console.aws.amazon.com/redshift/)。

1. 在 Amazon Redshift 控制台中，选择**预置集群控制面板**。

1. 在**预置集群控制面板**中，选择**创建集群**按钮，以打开**创建集群**窗格。

1. 填写**集群配置**部分中的必填字段。

1. 在**示例数据**部分，选中**加载示例数据**框，以将示例数据集 **Tickit** 加载到包含 **public** 架构的默认数据库 **Dev** 中。

1. 在**数据库配置**部分中，为**管理员用户名**和**管理员用户密码**字段输入值。

1. 选择**创建集群**，以创建您的预置数据仓库。

**创建无服务器数据仓库**

有关创建 Amazon Redshift Serverless 数据仓库的更多详细信息，请参阅《Amazon Redshift 入门用户指南》**中的[使用 Amazon Redshift Serverless 创建数据仓库](https://docs.aws.amazon.com/redshift/latest/gsg/new-user-serverless.html#serverless-console-resource-creation)主题。

1. 在您的首选互联网浏览器中，登录 AWS 管理控制台，然后打开 Amazon Redshift 控制台，网址为：[https://console.aws.amazon.com/redshift/](https://console.aws.amazon.com/redshift/)。

1. 在 Amazon Redshift 控制台中，选择**试用 Amazon Redshift Serverless** 按钮，以打开**开始使用 Amazon Redshift Serverless** 窗格。

1. 在**配置**部分中，选择**使用默认设置**径向。

1. 在 **开始使用 Amazon Redshift Serverless** 窗格的底部，选择**保存配置**，以使用默认工作组、命名空间、凭证和加密设置创建无服务器数据仓库。

## 通过 Toolkit 连接到数据仓库
<a name="redshift-overview-connect"></a>

通过 Toolkit 连接到数据库的方法有 3 种：
+ **数据库用户名和密码**
+ **AWS Secrets Manager**
+ **临时凭证**

 要通过该 Toolkit 连接到位于现有预置集群或无服务器数据仓库中的数据库，请完成以下步骤。

**重要**  
如果您已完成本用户指南主题的“先决条件”**部分中的步骤，并且您的数据仓库在 Toolkit 资源管理器中不可见，请确保在资源管理器中正确的 AWS 区域内工作。

**使用**数据库用户名和密码**方法连接到数据仓库**

1. 在 Toolkit 资源管理器中，展开数据仓库所在的 AWS 区域。

1. 展开 **Redshift** 并选择您的数据仓库，以在 VS Code 中打开**选择连接类型**对话框。

1. 从**选择连接类型**对话框中，选择**数据库用户名和密码**，并提供每个提示所需的信息。

1. 当 Toolkit 连接到您的数据仓库并且该流程完成后，您的可用数据库、表和架构将显示在 Toolkit 资源管理器中。

**使用 **AWS Secrets Manager** 连接到您的数据仓库**
**注意**  
此流程需要 AWS Secrets Manager 数据库密钥才能完成。有关如何设置数据库密钥的说明，请参阅《AWS Secrets Manager** 用户指南》中的[创建 AWS Secrets Manager 数据库密钥](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_database_secret.html)。

1. 在 Toolkit 资源管理器中，展开数据仓库所在的 AWS 区域。

1. 展开 **Redshift** 并选择您的数据仓库，以在 VS Code 中打开**选择连接类型**对话框。

1. 从**选择连接类型**对话框中，选择 **Secrets Manager**，然后提供每个提示所需的信息。

1. 当 Toolkit 连接到您的数据仓库并且该流程完成后，您的可用数据库、表和架构将显示在 Toolkit 资源管理器中。

**使用**临时凭证**连接到您的数据仓库**

1. 在 Toolkit 资源管理器中，展开数据仓库所在的 AWS 区域。

1. 展开 **Redshift** 并选择您的数据仓库，以在 VS Code 中打开**选择连接类型**对话框。

1. 从**选择连接类型**对话框中，选择**临时凭证**，然后提供每个提示所需的信息。

1. 当 Toolkit 连接到您的数据仓库并且该流程完成后，您的可用数据库、表和架构将显示在 Toolkit 资源管理器中。

**编辑与数据仓库的连接**

您可以编辑与数据仓库的连接以更改要连接到的数据库。

1. 在 Toolkit 资源管理器中，展开数据仓库所在的 AWS 区域。

1. 展开 **Redshift**，右键单击您要连接到的数据仓库，选择**编辑连接**，然后提供您要连接到的数据库的名称。

1. 当 Toolkit 连接到您的数据仓库并且该流程完成后，您的可用数据库、表和架构将显示在 Toolkit 资源管理器中。

**删除与数据仓库的连接**

1. 在 Toolkit 资源管理器中，展开数据仓库所在的 AWS 区域。

1. 展开 **Redshift**，右键单击包含要删除的连接的数据仓库，然后选择**删除连接**。这样做会从 Toolkit 资源管理器中移除可用的数据库、表和架构。

1. 要重新连接到您的数据仓库，请选择**单击以连接**，然后提供每个提示所需的信息。默认情况下，重新连接使用以前的身份验证方法来连接到数据仓库。要使用其他方法，请在对话框中选择返回箭头，直到出现身份验证提示为止。

## 运行 SQL 语句
<a name="redshift-overview-sql"></a>

以下流程描述了如何通过 AWS Toolkit for Visual Studio Code 在数据库中创建和运行 SQL 语句。

**注意**  
要完成以下每个流程中的步骤，必须先完成本用户指南主题中的*从 Toolkit 连接到数据仓库*部分。

1. 在 Toolkit 资源管理器中，展开 **Redshift**，然后展开包含要查询的数据库的数据仓库。

1. 选择**创建笔记本**以指定要在本地存储笔记本的文件名和位置，然后选择**确定**以在 VS Code 编辑器中打开笔记本。

1. 在 VS Code 编辑器中，输入要存储在此笔记本中的 SQL 语句。

1. 选择**全部运行**按钮，以运行您输入的 SQL 语句。

1. 您的 SQL 语句的输出显示在您输入的语句下方。

**向笔记本中添加 Markdown**

1. 在 VS Code 编辑器中的笔记本中，选择 **Markdown** 按钮，以向笔记本中添加“Markdown”单元格。

1. 将您的 Markdown 输入到提供的单元格中。

1. Markdown 单元格可以通过使用位于 Markdown 单元格右上角的编辑器工具来编辑。

**向笔记本中添加代码**

1. 在 VS Code 编辑器中的笔记本中，选择**代码** 按钮，以向笔记本中添加“代码”单元格。

1. 将您的代码输入到提供的单元格中。

1. 您可以选择在“代码”单元格的上方或下方运行代码，方法是从位于“代码”单元格右上角的单元格编辑器工具中选择相应的按钮。