クイック スタート: PostgreSQL に接続してクエリを実行する

このクイック スタートでは、postgreSQL 拡張機能を使用して、Visual Studio Codeを使用して PostgreSQL サーバーに接続し、テーブルを作成し、行を挿入し、クエリを実行します。そのすべてが VS Code 内から実行されます。

学習内容

• 接続ダイアログを開き、PostgreSQL サーバーに接続する
• クエリ エディターを使用してデータベースとテーブルを作成する
• データの挿入とクエリ
• 結果パネルで 結果 を表示する

前提条件

作業を開始する前に、次の準備ができていることを確認します。

• Visual Studio Codeがインストールされています。
• Visual Studio Code 用 PostgreSQL 拡張機能（Extensions Marketplace からインストールされたもの）。
• 実行中の PostgreSQL サーバーへのアクセス。 ローカル インストール、 Docker コンテナー、またはオンプレミスまたはクラウド提供の PostgreSQL インスタンスを使用できます。

サーバーに接続する

1. Ctrl + Alt + D (Windows/Linux) キーまたは Cmd + Alt + D (macOS) キーを押して PostgreSQL ビューを開くか、アクティビティ バーの PostgreSQL アイコンを選択します。

2. [接続] セクションのヘッダーにカーソルを合わせ、[新しい接続の追加] (+ アイコン) を選択します。 接続ダイアログが開き、[ パラメーター] タブが選択されています。

   

3. PostgreSQL サーバーの接続情報の各項目に入力してください:

   フィールド	値の例	説明
   サーバー名	localhost	サーバーのホスト名または IP アドレス。
   認証の種類	パスワード	[パスワード]、[Entra Auth]、[AWS IAM (RDS/Aurora)]、または [なし] を選択します。
   ユーザー名	postgres	PostgreSQL ログイン。
   パスワード	(パスワード)	アカウントのパスワード。
   データベース名	postgres	接続先のデータベース。
   接続名	Local dev server	この接続のオプションの表示名。

   Tip

   [ パスワードの保存] を選択すると、VS Code 資格情報ストアにパスワードが安全に保存されるため、すべての接続でメッセージが表示されることはありません。 Microsoft Entra ID認証、AWS IAM 認証、またはその他の ID の設定については、「接続と ID」を参照してください。

4. [保存] と [接続] の順に選択します。

   接続が成功 すると、サーバー は緑色の状態インジケーターで接続ツリーに表示されます。

データベースの作成

1. [接続] ツリーでサーバー ノードを右クリックし、[新しいクエリ] を選択します。 サーバーに接続されているクエリ エディターが開きます。

2. 次のステートメントを貼り付けて、Ctrl + Shift + E (Windows/Linux) または Cmd + Shift + E (macOS) キーを押して実行します。

   CREATE DATABASE tutorialdb;
   

3. [接続] ツリーでサーバー ノードを右クリックし、[最新の情報に更新] を選択して、新しい tutorialdb データベースをツリーに表示します。

テーブルの作成

1. データベース コンテキストを tutorialdb に変更します。 クエリ エディターのツール バーのデータベース ドロップダウン リストを使用するか、コマンド パレットから pgsql.changeDatabase を実行し (PostgreSQL データベースの変更)、 tutorialdb を選択します。

2. 次のステートメントをクエリ エディターに貼り付け、 Ctrl + Shift + E / Cmd + Shift + E で実行します。

   CREATE TABLE customers (
       id SERIAL PRIMARY KEY,
       name VARCHAR(50) NOT NULL,
       email VARCHAR(50) NOT NULL,
       city VARCHAR(50)
   );
   

   [メッセージ] パネルで、ステートメントが正常に完了したことを確認します。

データの挿入

クエリ エディターの内容を次のステートメントに置き換えて実行します。

INSERT INTO customers (name, email, city)
VALUES
    ('Alice Johnson', 'alice@example.com', 'Seattle'),
    ('Bob Smith', 'bob@example.com', 'Portland'),
    ('Carol Williams', 'carol@example.com', 'San Francisco');

[メッセージ] パネルは、3 行が挿入されたことを確認します。

データのクエリを実行する

クエリ エディターの内容を次のステートメントに置き換えて実行します。

SELECT * FROM customers;

[ 結果 ] パネルには、挿入した 3 つの行が表示されます。

Visual Studio Code

カーソル

結果を確認する

データが永続化されていることを確認するには、フィルター処理されたクエリを実行します。

SELECT name, city
FROM customers
WHERE city = 'Seattle';

結果パネルは、シアトルの Alice Johnson に対して 1 行を返します。

接続の問題のトラブルシューティング

サーバーに接続できない場合は、次の一般的な原因を確認してください。

• 接続が拒否されました: PostgreSQL が実行され、想定されるホストとポートでリッスンしていることを確認します。 ローカル サーバーの場合は、サービスが開始されていることを確認します。
• パスワード認証に失敗しました: ユーザー名 と パスワード の値を再確認します。 サーバーの pg_hba.conf ファイルを確認して、認証方法で接続が許可されたことを確認します。
• SSL エラー: 高度な接続オプションで SSL 設定を構成します。 詳細については、「 接続と ID: SSL と TLS」を参照してください。

関連するコンテンツ

• 接続と ID
• クエリ エディターと IntelliSense
• オブジェクト エクスプローラー