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

# 從 Toolkit for VS 程式碼使用 Amazon Redshift
<a name="redshift-overview"></a>

下列各節說明如何從 開始使用 Amazon Redshift AWS Toolkit for Visual Studio Code。

如需 Amazon Redshift 服務的詳細資訊，請參閱 [Amazon Redshift](https://docs.aws.amazon.com/redshift/) 使用者指南主題。

## 開始使用
<a name="redshift-overview-prereqs"></a>

從 開始使用 Amazon Redshift 之前 AWS Toolkit for Visual Studio Code，必須符合下列要求。

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：//[https://console.aws.amazon.com/redshift/](https://console.aws.amazon.com/redshift/)。

1. 從 Amazon Redshift 主控台中，選擇**佈建叢集儀表板**。

1. 從**佈建叢集儀表板**中，選擇**建立叢集**按鈕以開啟**建立叢集**窗格。

1. 完成**叢集組態**區段中的必要欄位。

1. 在**範例資料**區段中，選取**載入範例資料**方塊，以**Dev**使用**public**結構描述**Tickit**將範例資料集載入預設資料庫。

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 主控台上開啟 Amazon Redshift 主控台，網址為 https：//[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>

有 3 種方法可從 Toolkit 連線至資料庫：
+ **資料庫使用者名稱和密碼**
+ **AWS Secrets Manager**
+ **暫時性憑證**

 若要從 Toolkit 連線至位於現有佈建叢集或無伺服器資料倉儲上的資料庫，請完成下列步驟。

**重要**  
如果您已完成本使用者指南主題*的先決條件*一節中的步驟，且您的資料倉儲在 Toolkit Explorer 中不可見，請確定您是從 Explorer 中的正確 AWS 區域工作。

**使用**資料庫使用者名稱和密碼**方法連線至您的資料倉儲**

1. 從 Toolkit Explorer 中，展開 AWS 區域 資料倉儲所在的 。

1. 展開 **Redshift** 並選擇您的資料倉儲，以在 VS 程式碼中開啟**選取連線類型**對話方塊。

1. 從**選取連線類型**對話方塊中，選擇**資料庫使用者名稱和密碼**，並提供每個提示所需的資訊。

1. 當 Toolkit 連線到您的資料倉儲且程序完成時，您的可用資料庫、資料表和結構描述會顯示在 Toolkit Explorer 中。

**使用 連線至您的資料倉儲 **AWS Secrets Manager****
**注意**  
此程序需要 AWS 秘密管理員資料庫秘密才能完成。如需如何設定資料庫秘密的指示，請參閱《*AWS Secrets Manager* 使用者指南》中的[建立 AWS Secrets Manager 資料庫秘密](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_database_secret.html)。

1. 從 Toolkit Explorer 中，展開 AWS 區域 資料倉儲所在的 。

1. 展開 **Redshift** 並選擇您的資料倉儲，以在 VS 程式碼中開啟**選取連線類型**對話方塊。

1. 從**選取連線類型**對話方塊中，選擇 **Secrets Manager**，並提供每個提示所需的資訊。

1. 當 Toolkit 連線到您的資料倉儲且程序完成時，您的可用資料庫、資料表和結構描述會顯示在 Toolkit Explorer 中。

**使用**暫時登入**資料連線至您的資料倉儲**

1. 從 Toolkit Explorer 中，展開資料倉儲所在的 AWS 區域。

1. 展開 **Redshift** 並選擇您的資料倉儲，以在 VS 程式碼中開啟**選取連線類型**對話方塊。

1. 從**選取連線類型**對話方塊中，選擇**暫時登入**資料，並提供每個提示所需的資訊。

1. 當 Toolkit 連線到您的資料倉儲且程序完成時，您的可用資料庫、資料表和結構描述會顯示在 Toolkit Explorer 中。

**編輯資料倉儲的連線**

您可以編輯資料倉儲的連線，以變更要連線的資料庫。

1. 從 Toolkit Explorer 中，展開 AWS 區域 資料倉儲所在的 。

1. 展開 **Redshift**，在您要連線的資料倉儲上按一下滑鼠右鍵，選擇**編輯連線**，並提供您要連線的資料庫名稱。

1. 當 Toolkit 連線到您的資料倉儲且程序完成時，您的可用資料庫、資料表和結構描述會顯示在 Toolkit Explorer 中。

**刪除資料倉儲的連線**

1. 從 Toolkit Explorer 中，展開 AWS 區域 資料倉儲所在的 。

1. 展開 **Redshift**，在資料倉儲上按一下滑鼠右鍵，並按一下要刪除的連線，然後選擇**刪除連線**。這樣做會從 Toolkit Explorer 中移除可用的資料庫、資料表和結構描述。

1. 若要重新連線至您的資料倉儲，請選擇**按一下以連線**，並提供每個提示所需的資訊。根據預設，重新連線會使用先前的身分驗證方法來連線至資料倉儲。若要使用不同的方法，請選擇對話方塊中的向後箭頭，直到您到達身分驗證提示為止。

## 執行 SQL 陳述式
<a name="redshift-overview-sql"></a>

下列程序說明如何從 在資料庫中建立和執行 SQL 陳述式 AWS Toolkit for Visual Studio Code。

**注意**  
若要完成下列每個程序的步驟，您必須先完成*從 Toolkit 連線至資料倉儲*一節，位於本使用者指南主題中。

1. 從 Toolkit Explorer 展開 **Redshift**，然後展開包含您要查詢之資料庫的資料倉儲。

1. 選擇**建立筆記本**以指定檔案名稱和位置，將筆記本存放在本機，然後選擇**確定**，以在 VS 程式碼編輯器中開啟筆記本。

1. 從 VS 程式碼編輯器中，輸入您想要在此筆記本中存放的 SQL 陳述式。

1. 選擇**全部執行**按鈕來執行您輸入的 SQL 陳述式。

1. SQL 陳述式的輸出會顯示在您輸入的陳述式下方。

**將 Markdown 新增至筆記本**

1. 在 VS 程式碼編輯器的筆記本中，選擇 **Markdown** 按鈕，將 Markdown 儲存格新增至筆記本。

1. 在提供的儲存格中輸入 Markdown。

1. 您可以使用 Markdown 儲存格右上角的編輯器工具來編輯 Markdown 儲存格。

**將程式碼新增至筆記本**

1. 在 VS 程式碼編輯器的筆記本中，選擇**程式碼**按鈕，將程式碼儲存格新增至筆記本。

1. 在提供的儲存格中輸入程式碼。

1. 您可以選擇在程式碼儲存格上方或下方執行程式碼，方法是從程式碼儲存格右上角的儲存格編輯器工具中選取適當的按鈕。