翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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/) を開きます。

1. Amazon Redshift コンソールで、[**プロビジョニングされたクラスターダッシュボード**]に移動します。

1. **[プロビジョニングされたクラスター ダッシュボード]** で **[クラスターの作成]** ボタンを選択し、**[クラスターの作成]** ペインを開きます。

1. **[クラスター設定]** セクションの必須フィールドに入力します。

1. **[サンプル データ]** セクションで [**サンプル データをロード**] ボックスを選択して、**public** スキーマを使用してサンプル データセット **Tickit** をデフォルトのデータベース **Dev** にロードします。

1. **[データベース設定]** セクションで、**[管理者ユーザー名]** フィールドと **[管理者ユーザーのパスワード]** フィールドに値を入力します。

1. **[クラスターの作成]** を選択して、プロビジョニングされたデータウェアハウスを作成します。

**サーバーレスデータウェアハウスを作成する**

Amazon Redshift Serverless データウェアハウスの作成に関する詳細については、Amazon Redshift 入門**ユーザーガイドの「[Amazon Redshift サーバーレスによるデータウェアハウスの作成](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 サーバーレスを試す]** ボタンを選択し、[**Amazon Redshift サーバーレスの使用を開始する**] ウィンドウを開きます。

1. **[設定]** セクションで、**[デフォルト設定を使用]** ラジアルを選択します。

1. **[Amazon Redshift サーバーレスの使用を開始する]** ペインの下部で **[設定を保存]** を選択して、デフォルトのワークグループ、名前空間、認証情報、および暗号化設定を使用してサーバーレスデータ ウェアハウスを作成します。

## Toolkit からデータウェアハウスに接続する
<a name="redshift-overview-connect"></a>

Toolkit からデータベースに接続するには、次の 3 つの方法があります。
+ **データベースユーザー名とパスワード**
+ **AWS 秘密マネジャー**
+ **一時的な認証情報**

 Toolkit から既存のプロビジョニング済みクラスターまたはサーバーレスデータウェアハウスにあるデータベースに接続するには、次の手順を実行します。

**重要**  
このユーザーガイドのトピックの「前提条件**」セクションの手順を完了しても、データウェアハウスが Toolkit エクスプローラーに表示されない場合は、エクスプローラーの正しい AWS リージョンから作業していることを確認してください。

****データベースのユーザー名とパスワード** を使用してデータウェアハウスに接続する**

1. Toolkit エクスプローラーから、データウェアハウスがある AWS リージョン を展開します。

1. **[Redshift]** を展開してデータウェアハウスを選択し、VS Code の **[接続タイプの選択]** ダイアログを開きます。

1. **[接続タイプの選択]** ダイアログで **[データベースのユーザー名とパスワード]** を選択し、各プロンプトに必要な情報を入力します。

1. Toolkit がデータウェアハウスに接続して手順が完了すると、使用可能なデータベース、テーブル、スキーマが Toolkit エクスプローラーに表示されます。

****AWS Secrets Manager** を使用してデータウェアハウスに接続する**
**注記**  
この手順を完了するには、AWS シークレットマネージャーのデータベースシークレットが必要です。データベースシークレットの設定方法については、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. **Create-Notebook** を選択してノートブックをローカルに保存するファイル名と場所を指定し、**OK** を選択して VS Code エディタでノートブックを開きます。

1. VS Code エディタから、このノートブックに保存する SQL ステートメントを入力します。

1. 「**すべてを実行**」ボタンを選択して、入力した SQL ステートメントを実行します。

1. SQL ステートメントの出力は、入力したステートメントの下に表示されます。

**ノートブックへの Markdown の追加**

1. VS Code エディタのノートブックから [**Markdown**] ボタンを選択し、ノートブックに Markdown セルを追加します。

1. 表示されたセルにマークダウンを入力します。

1. Markdown セルは Markdown セルの右上隅にあるエディターツールを使用して編集できます。

**ノートブックへのコードの追加**

1. VS Code Editor のノートブックから **[コード]** ボタンを選択し、ノートブックにコードセルを追加します。

1. 表示されたセルにコードを入力します。

1. コードセルの右上隅にあるセルエディターツールから適切なボタンを選択すると、コードセルの上または下でコードを実行できます。