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

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

学習内容

  • 接続ダイアログを開き、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 つの行が表示されます。

結果を確認する

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

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

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

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

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

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

関連するコンテンツ

  • Last updated on