Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Расширение PostgreSQL для Visual Studio Code (ms-ossdata.vscode-pgsql) предоставляет средства разработки баз данных непосредственно в редактор. Вы можете подключаться к локальным, локальным или облачным серверам PostgreSQL, записывать запросы с помощью IntelliSense, изучать объекты базы данных, визуализировать планы запросов и схемы, а также управлять База данных Azure для PostgreSQL гибкими ресурсами сервера, не оставляя VS Code. Расширение также интегрируется с ИИ-ассистентами для создания запросов с помощью ИИ, анализа и рабочих процессов, управляемых ИИ-агентами.
Замечание
Расширение также выполняется в Cursor. Функции ИИ PostgreSQL поддерживаются в обоих редакторах и соответствуют встроенному ИИ-интерфейсу каждого из них: Visual Studio Code включает участника чата @pgsql наряду с режимом Agent и регистрацией MCP-сервера, а Cursor использует Connect AI (режим Agent) или регистрацию MCP-сервера.
Get started
Если вы не знакомы с расширением, начните с одного из следующих руководств:
| Goal | Guide |
|---|---|
| Запуск первого запроса | Краткое руководство: подключение к PostgreSQL и выполнение запросов |
| Поиск подходящей статьи для задачи | Распространенные рабочие процессы |
| Настроить идентификационные данные, TLS или сохранённые профили | Подключения и идентификация |
Установка расширения
- Откройте код Visual Studio.
- Откройте представление расширений (
Ctrl+Shift+XилиCmd+Shift+Xв macOS). - Найдите postgresql.
- Выберите PostgreSQL, Microsoft и нажмите кнопку "Установить".
Tip
После установки на панели действий появится значок PostgreSQL. Выберите его, чтобы открыть представление PostgreSQL, где вы управляете подключениями и просматриваете объекты базы данных.
Ключевые особенности
В следующих разделах кратко описана каждая основная область функций. Выберите ссылку в конце каждого раздела для полной статьи.
Диалоговое окно подключения
С помощью диалогового окна подключения можно подключаться к локальным, размещённым в локальной инфраструктуре и облачным серверам PostgreSQL со встроенной поддержкой аутентификации через Microsoft Entra ID и AWS IAM (RDS/Aurora). Введите параметры подключения по отдельности, вставьте строка подключения или просмотрите подписки Azure, чтобы обнаружить гибкие серверы База данных Azure для PostgreSQL и кластеры Azure HorizonDB (предварительная версия).
- Три режима ввода: Параметры для отдельных значений, таких как хост, порт, база данных и имя пользователя; Строка подключения для полной строки подключения; или Обзор Azure, чтобы просматривать ресурсы Azure и выбрать ресурс с конечной точкой PostgreSQL.
- Сохраненные и последние подключения: сохраненные профили отображаются в списке подключений для быстрого повторного использования; Недавно используемые подключения всегда доступны.
- Группы серверов: упорядочивание подключений в именованные группы с помощью цветового кода для быстрого определения подключений в дереве подключений .
Дополнительные сведения см. в разделах Подключения и удостоверение подлинности и Дополнительные параметры подключения.
Обозреватель объектов
Обозреватель объектов предоставляет представление дерева навигации подключенных серверов PostgreSQL. Разверните серверы, базы данных и схемы для проверки таблиц, представлений, функций, последовательностей, типов, расширений, ролей, табличных пространств и триггеров событий.
- Поиск: поиск объектов по имени во всех поддерживаемых типах объектов со встроенным поиском.
-
Скрипты: щелкните правой кнопкой мыши любой объект для создания
SELECT,CREATE,ALTERDROPилиEXECUTEскриптов, которые открываются в редакторе запросов. - Глубокое обновление: обновите любой узел, чтобы рекурсивно обновить всех развернутых потомков с учетом изменений схемы без отключения.
Дополнительные сведения см. в обозревателе объектов.
Редактор запросов и IntelliSense
Редактор запросов предоставляет многофункциональную область редактирования для SQL PostgreSQL. IntelliSense предлагает варианты автодополнения с учетом контекста для имен таблиц, имен столбцов, функций, схем, ключевых слов и условий JOIN.
- Запустите запрос и запустите текущую инструкцию: запустите содержимое полного редактора или только инструкцию на курсоре.
-
Фрагменты кода: вставка общих шаблонов SQL, таких как
CREATE TABLE,INSERTиSELECT. - Журнал запросов: доступ к ранее выполняемым запросам из палитры команд для повторного запуска или изменения.
Дополнительные сведения см. в редакторе запросов и IntelliSense.
Результаты запроса
Результаты отображаются на панели результатов запросов PostgreSQL под редактором. Сетка результатов поддерживает сортировку, фильтрацию и изменение размера столбцов.
- Экспорт: сохранение результатов в CSV, JSON или Excel.
- Визуализация диаграммы: визуализация результатов в виде линий, линейчатой диаграммы, круговой диаграммы или точечной диаграммы.
- Представление графа: результаты графовых запросов Apache AGE автоматически переключаются на представление узлов и рёбер.
- Вкладка "Сообщения" — просмотр счетчиков строк, времени выполнения и сообщений сервера.
Дополнительные сведения см. в редакторе запросов и IntelliSense.
Визуализатор плана запросов
Визуализатор плана запросов представляет EXPLAIN выходные данные в нескольких интерактивных форматах, чтобы определить узкие места производительности.
- Четыре представления: представление дерева, представление icicle, представление таблицы и исходное представление.
- Metrics: проверяйте оценки затрат, фактическое количество строк, время выполнения и использование буферов для каждого узла.
- Импорт планов: визуализация сохраненных файлов плана или содержимого редактора без подключения к динамической базе данных.
- Анализ Copilot: выберите «Анализ с помощью Copilot» (или «Анализ с помощью ИИ» в Cursor), чтобы получить созданное ИИ объяснение плана.
Дополнительные сведения см. в разделе визуализатор плана запросов.
Визуализатор схемы
Визуализатор схемы создает интерактивную схему связи сущностей. Таблицы отображаются как узлы, которые можно перетаскивать, со списком столбцов внутри, а связи по внешнему ключу — как соединительные линии.
- Цветокодированные схемы: каждая схема получает отдельный цвет для быстрой идентификации.
- Переключатель условных обозначений: отображение или скрытие условных обозначений схемы для максимального увеличения пространства схемы.
Дополнительные сведения см. в разделе "Визуализатор схемы".
Панель мониторинга сервера
На панели мониторинга сервера отображаются свойства подключения, версия сервера и состояние SSL для любого подключенного сервера. Для гибких серверов База данных Azure для PostgreSQL также отображаются метрики Azure Monitor. Вкладки "Исследование" позволяют детализирует определенные области действия сервера.
- Обзор: мониторинг ЦП, памяти, хранилища, подключений, операций ввода-вывода в секунду и других метрик, сгруппированных по категориям.
- Запросы: просмотр лучших инструкций SQL, ранжированных по времени выполнения, подсчету вызовов или другим метрикам, с детализацией по отдельным сведениям запроса.
- Ожидания: анализ событий ожидания с помощью таблицы с ранжированием и графика во времени.
- Сеансы: проверять активные сеансы, деревья блокировок и активность блокировок.
- Команды панели инструментов: подключиться, отключиться, открыть новый редактор запросов, запустить визуализатор схемы, открыть чат с ИИ или запустить действия управления Azure на панели инструментов панели мониторинга.
Дополнительные сведения см. на панели мониторинга сервера.
управление серверами Azure
Управляйте База данных Azure для PostgreSQL гибкими ресурсами сервера, не покидая VS Code.
- Запуск, остановка и перезапуск: управление жизненным циклом сервера из дерева подключений или панели мониторинга.
- Правила брандмауэра: просмотр и обновление правил доступа к сети.
- Параметры: просмотр и изменение параметров.
- Клонированный сервер: дублирует существующую конфигурацию сервера.
Дополнительные сведения см. в разделе Управление серверами Azure.
Создание сервера
Развертывайте новые серверы PostgreSQL прямо из VS Code.
- Docker: создайте локальный сервер PostgreSQL в контейнере Docker для разработки и тестирования.
- База данных Azure для PostgreSQL гибкий сервер: пошаговое руководство по настройке региона, уровня вычислений, хранилища и проверки подлинности.
- Azure HorizonDB (предварительная версия): подготовьте облачный, высокомасштабируемый кластер PostgreSQL с настраиваемыми виртуальными ядрами и дополнительными возможностями искусственного интеллекта.
Дополнительные сведения см. в разделе "Создание сервера PostgreSQL".
интеграция Copilot
Расширение интегрируется с ИИ-ассистентами в чате, действиях в редакторе и многошаговых рабочих процессах инструментов.
- участник чата @pgsql: задавайте вопросы на естественном языке о ваших базах данных, создавайте запросы или получайте помощь по концепциям PostgreSQL на панели GitHub Copilot Chat. Только Visual Studio Code. Подробнее см. участника чата @pgsql.
- Действия редактора: щелкните правой кнопкой мыши SQL в редакторе, чтобы объяснить запрос, переписать его для оптимизации или проанализировать план выполнения из подменю действий запросов ИИ . Доступно в Visual Studio Code и Cursor.
- Режим агента: агент ИИ вызывает средства PostgreSQL напрямую, объединяя причины ИИ с операциями динамической базы данных. Доступно как в Visual Studio Code, так и в Cursor. Дополнительные сведения см. в режиме агента.
Обзор всех возможностей ИИ см. в разделе Интеграция Copilot.
Сервер MCP
Расширение регистрирует сервер протокола MCP, который предоставляет средства PostgreSQL, включая управление подключениями, изучение схемы, выполнение запросов и визуализацию плана запросов для поддерживаемых узлов с поддержкой ИИ. Внешние средства искусственного интеллекта могут взаимодействовать с подключениями PostgreSQL программным способом с помощью этой регистрации.
Дополнительные сведения см. на сервере MCP.
Использование psql в терминале
Откройте psql сеанс терминала, подключённый к любой базе данных в дереве Connections, или запустите файлы .sql через psql непосредственно из контекстного меню редактора. Это обеспечивает полный доступ к собственным psql функциям, таким как \ метакомандам, COPYи интерактивному скрипту.
Дополнительные сведения см. в разделе "Использование psql" в терминале.
Миграция Oracle в PostgreSQL
Рабочий процесс миграции с поддержкой искусственного интеллекта помогает преобразовать схемы и объекты базы данных Oracle в совместимый с PostgreSQL SQL.
- Интерактивная миграция: подключитесь к источнику Oracle, выберите объекты для миграции и просмотрите преобразованные выходные данные.
- Преобразование с помощью ИИ: модель Microsoft Foundry преобразует синтаксис, типы данных и процедурный код Oracle в эквиваленты PostgreSQL.
Подробнее см. в статье Миграция из Oracle в PostgreSQL.
Поддерживаемые операционные системы
| Операционная система | Architecture | Notes |
|---|---|---|
| Windows | x64, Arm64 | Для Arm64 требуется Windows 11. |
| macOS | x64, Arm64 | - |
| Линукс | x64, Arm64 | Требуется версия glibc 2.35 или более поздняя. |
Отзывы и поддержка
Чтобы сообщить об ошибке или запросить функцию, отправьте проблему в репозиторий vscode-pgsql GitHub.