Pgadmin 4, как использовать окна

Обновлено: 21.11.2024

Для тех, кто понимает язык интерфейса "Командной строки".

PostgreSQL, также известная как Postgres, – это бесплатная система управления реляционными базами данных с открытым исходным кодом, в которой особое внимание уделяется расширяемости и совместимости с SQL.

pgAdmin — это инструмент администрирования и управления с открытым исходным кодом для базы данных PostgreSQL. Он включает в себя графический интерфейс администрирования, инструмент запросов SQL, отладчик процедурного кода и многое другое. Этот инструмент предназначен для удовлетворения потребностей как разработчиков, администраторов баз данных, так и системных администраторов.

В этом руководстве описаны шаги по установке PostgreSQL выпуска 13 и pgAdmin4.28 в Windows 10. Эти инструкции также можно применять, если в вашей среде используется Windows 8, Windows Server 2016 или Windows Server 2019.< /p>

Предпосылки

Вам потребуется одна (физическая или виртуальная) машина с установленной Windows 10.

Загрузить PostgreSQL

Мы загрузим упакованный файл версии 13.1 из официального источника загрузки.

Установите PostgreSQL

После завершения загрузки дважды щелкните загруженный файл, чтобы начать установку.

Нажмите "Далее"

Мне не нужен компонент Stack Builder, поэтому я сниму с него флажок.

Укажите пароль и нажмите "Далее"

На этом этапе установка PostgreSQL версии 13 и pgAdmin4.28 завершена.

Запустить сервер pgAdmin

Откройте приложение pgAdmin из меню "Пуск", как показано на изображении ниже.

Подождите, пока сервер pgAdmin4 запустит свои службы.

Это автоматически откроет веб-интерфейс pgAdmin, и вам нужно будет установить мастер-пароль, как показано на рисунке ниже.

Например, если веб-интерфейс pgAdmin завис на экране (Загрузка pgAdmin), вам необходимо сначала исправить реестр Windows и перезагрузить pgAdmin.

Поскольку вы установили PostgreSQL и pgAdmin на одном компьютере, ваш PostgreSQL будет автоматически добавлен в консоль управления pgAdmin.

Вам необходимо ввести пароль суперпользователя PostgreSQL, который вы создали в процессе установки, и нажать OK.

Это соединит вас с вашим PostgreSQL, как показано на изображении ниже.

Подведение итогов

Теперь, когда вы успешно установили PostgreSQL 13 и pgAdmin4.28 в Windows 10, вы можете приступить к созданию баз данных и управлению ими.

pgAdmin — это самая популярная и многофункциональная платформа администрирования и разработки с открытым исходным кодом для PostgreSQL, самой передовой базы данных с открытым исходным кодом в мире.

pgAdmin можно использовать в Linux, Unix, macOS и Windows для управления PostgreSQL и EDB Advanced Server 10 и выше.

Быстрые ссылки

Автоматизация тестирования функций в pgAdmin 4

Автор: Йогеш Махаджан, дата: 23 февраля 2022 г.

pgAdmin следует процессу разработки Agile с итеративным и поэтапным подходом к разработке. Тестирование является важной частью процесса разработки. pgAdmin регулярно тестируется с набором доступных версий, что гарантирует высокое качество продукта. Набор тестов включает в себя тестирование API, тестирование пользовательского интерфейса (называемое тестированием функций), модульное тестирование и тестирование «resql» — специфичную для pgAdmin тестовую среду для тестирования обратного проектирования SQL.

Чтобы добиться лучшего качества в коротких циклах выпуска, требуется автоматизация тестирования. Selenium WebDriver с Python используется для автоматизации тестирования функций. Среды тестирования функций в настоящее время поддерживают параллельное тестирование / кросс-браузерное тестирование. Новая эра непрерывного тестирования требует более быстрого выполнения тестов. Параллельное тестирование включает в себя параллельный запуск независимых тестов для сокращения общего времени выполнения теста за счет одновременного тестирования нескольких комбинаций ОС/браузера. Расширенное тестовое покрытие минимизирует риски и снижает вероятность выпуска продукта с регрессиями или дефектами.

Информационные панели в pgAdmin 4

Автор: Нихил Мохитей, дата: 3 февраля 2022 г.

Вкладка панели управления в pgAdmin показывает анализ статистики действий для выбранного сервера или базы данных.

Также отображаются быстрые ссылки на разделы "Добавить новый сервер", "Настроить pgAdmin" и "Документация", если в дереве браузера выбран узел "Группа серверов".

Туннелирование SSH в pgAdmin 4

Автор: Рахул Ширсат, дата: 6 января 2022 г.

Туннелирование SSH – это метод передачи произвольных сетевых данных по зашифрованному соединению SSH. Его можно использовать для добавления шифрования в устаревшие приложения или реализации VPN (виртуальных частных сетей). Это способ защитить трафик данных любого приложения с помощью переадресации портов, то есть туннелирования любого порта TCP/IP через SSH.

pgAdmin можно развернуть как настольное приложение, настроив приложение для работы в режиме рабочего стола, а затем используя среду выполнения рабочего стола для размещения программы в поддерживаемой установке Windows, Mac OS X или Linux.

Среда выполнения рабочего стола — это автономное приложение, которое при запуске запускает сервер pgAdmin и открывает окно для отображения пользовательского интерфейса.

Предварительно скомпилированные и настроенные установочные пакеты доступны для ряда платформ. Эти пакеты должны использоваться конечными пользователями везде, где это возможно. Следующая информация будет полезна для сопровождающих этих пакетов и пользователей, заинтересованных в понимании того, как работает pgAdmin.

Подробные инструкции по сборке и настройке pgAdmin с нуля см. в файле README в каталоге верхнего уровня исходного кода. Для удобства вы можете найти последнюю версию файла здесь, но имейте в виду, что она может отличаться от версии, включенной в исходный код для конкретной версии pgAdmin.

Конфигурация¶

Начиная с pgAdmin 4 v2 режимом конфигурации по умолчанию является сервер, однако он переопределяется средой выполнения рабочего стола при запуске. В большинстве сред настройка Python не требуется, если только вы не хотите переопределить другие настройки по умолчанию.

Дополнительную информацию о параметрах конфигурации см. в файле config.py.

Автономное приложение для рабочего стола¶

Среда выполнения рабочего стола основана на NWjs, который объединяет браузер и сервер Python, создавая отдельное приложение.

Меню выполнения¶

Используйте Меню "Файл" для доступа к Меню выполнения:

Нажмите, чтобы открыть диалоговое окно конфигурации, чтобы настроить фиксированный порт, номер порта и время ожидания соединения.

Нажмите, чтобы открыть диалоговое окно просмотра журнала для просмотра журналов pgAdmin 4.

Перейти в полноэкранный режим

Нажмите, чтобы войти/выйти из полноэкранного режима. Сочетания клавиш: OSX (Cmd + Ctrl + F), другие ОС (F10).

Нажмите, чтобы изменить размер окна на исходный. Сочетания клавиш: OSX (Cmd + 0), другие ОС (Ctrl + 0).

Нажмите, чтобы увеличить масштаб. Сочетания клавиш: OSX (Cmd + +), другие ОС (Ctrl + +).

Нажмите, чтобы уменьшить масштаб. Сочетания клавиш: OSX (Cmd + -), другие ОС (Ctrl + -).

Диалоговое окно настройки¶

Используйте Меню среды выполнения, чтобы получить доступ к диалоговому окну Конфигурация:

Ниже приведены сведения об Фиксированный номер порта?, Номер порта, Время ожидания подключения и "Открыть документацию в браузере по умолчанию?" параметры конфигурации:

Используйте фиксированный номер сетевого порта, а не случайный.

Номер порта, если используется фиксированный порт.

Количество секунд ожидания запуска сервера приложений.

Открыть документацию в браузере по умолчанию

Если установить этот флажок, все ссылки на документацию будут открываться в браузере по умолчанию, а не в новом окне.

Диалог журнала¶

Используйте Меню среды выполнения для доступа к диалоговому окну Журнал:

Нажмите кнопку Обновить внизу, чтобы просмотреть последние журналы сервера pgAdmin 4.

При выполнении среда выполнения автоматически попытается выполнить приложение pgAdmin Python. Если выполнение завершится ошибкой, появится сообщение об ошибке с кнопкой Настроить внизу. Вы можете настроить фиксированный номер порта, чтобы избежать конфликтов со случайным номером порта по умолчанию с другими приложениями и тайм-аутом соединения, если это необходимо.

pgAdmin — это инструмент управления для PostgreSQL и производных реляционных баз данных, таких как EDB Advanced Server от EnterpriseDB. Его можно запустить как веб-приложение или настольное приложение. Дополнительные сведения о предлагаемых функциях см. на страницах «Функции» и «Снимки экрана».

Какие браузеры поддерживает pgAdmin?

Следующие браузеры поддерживаются pgAdmin при работе в Linux, macOS или Windows. Мы регулярно тестируем подмножество доступных версий и стремимся исправить проблемы, обнаруженные в любой из них.

  • Chrome 72+
  • Firefox 65+
  • Граница 44+
  • Сафари 12+

В настоящее время поддерживаются следующие браузеры, но эта поддержка прекратится в будущем выпуске pgAdmin. Вместо этого настоятельно рекомендуется использовать поддерживаемый браузер:

Другие браузеры могут работать, но не тестировались, и проблемы, о которых сообщалось при их использовании с pgAdmin, могут не быть устранены.

Почему pgAdmin не использует собственные диалоги управления файлами?

В основном это происходит по нескольким причинам:

  • Поскольку pgAdmin — это веб-приложение, оно может взаимодействовать с локальной файловой системой только способами, разрешенными современными веб-браузерами. Это ограничивает возможности безопасности; по сути, файлы можно только «скачать» или «выгрузить» (через форму). Невозможно просто сохранить обновление в файл, нажав кнопку «Сохранить», и невозможно, например, сохранить рабочий каталог.
  • При работе в режиме сервера файлы считываются с сервера и сохраняются на нем, чтобы пользователи могли работать с одними и теми же данными на любом компьютере. «Нативных диалогов» для работы с файлами, хранящимися на веб-сервере таким образом, нет, поэтому приходится реализовывать свои.

Мы тщательно оценили и протестировали различные способы управления файлами в pgAdmin 4 и постоянно обнаруживали, что использование наших собственных диалогов обеспечивает наилучший опыт (который мы продолжаем улучшать и улучшать с учетом отзывов пользователей).

Что такое мастер-пароль и как его использовать или удалить?

Мастер-пароль используется для надежного шифрования любых учетных данных, которые вы хотите сохранить при использовании pgAdmin. Без мастер-пароля (или чего-то подобного, предоставляемого пользователем) ключи шифрования должны генерироваться из данных, хранящихся на диске в месте, известном pgAdmin.Изучив исходный код, другой пользователь, имеющий доступ к зашифрованным паролям и данным, используемым для создания ключей, сможет расшифровать сохраненные пароли.

К сожалению, эта возможность не ограничивается административными пользователями компьютеров, содержащих сохраненные пароли и ключевые данные, как вы можете сразу подумать. Вредоносное ПО, которое могло быть установлено непреднамеренно, может передать злоумышленнику сохраненную базу данных паролей и ключевые данные. Такое вредоносное ПО может быть частью другого программного обеспечения или чего-либо, установленного с использованием, например, уязвимости браузера.

Мастер-пароль устраняет эту проблему, гарантируя, что данные ключа никогда не сохраняются на диске.

Я знаю, что моя система защищена и не может быть заражена вредоносными программами. Могу ли я отключить мастер-пароль? Да, хотя мы настоятельно не рекомендуем этого делать! Для этого найдите файл config.py, который является частью вашей установки pgAdmin. Обычно это каталог верхнего уровня с именем web. В том же каталоге создайте файл с именем config_local.py и добавьте строку следующего содержания:

Если файл уже существует, отредактируйте его и добавьте строку. Когда вы перезапустите pgAdmin, мастер-пароль будет отключен, а пароли будут зашифрованы небезопасным способом, что защитит их от «серфинга через плечо», но не помешает кому-либо довольно легко их расшифровать.

Но почему я не могу отключить мастер-пароль из графического интерфейса? Требуя изменения основной конфигурации для pgAdmin, мы позволяем системным администраторам применять политику безопасности, которая часто является требованием в корпоративные или другие безопасные среды. В настоящее время в pgAdmin нет общих механизмов, позволяющих администраторам контролировать, какие пользовательские настройки (те параметры, которые можно настроить через графический интерфейс) можно или нельзя изменять.

Конфигурация

Что такое режим сервера и режим рабочего стола?

При развертывании pgAdmin на веб-сервере для нескольких пользователей он запускается в режиме сервера (SERVER_MODE = True). Этот режим требует, чтобы у каждого пользователя была учетная запись в pgAdmin со своим паролем. Пользователи должны войти в pgAdmin, чтобы использовать его. Один или несколько пользователей могут быть настроены как администраторы и смогут добавлять или удалять других пользователей. Дополнительные сведения см. в документации по развертыванию сервера и управлению пользователями.

Чтобы разрешить работу в режиме рабочего стола (SERVER_MODE = False), предоставляется приложение среды выполнения для размещения и отображения кода pgAdmin (иногда называемое сервером приложений). В этом режиме каждый пользователь запускает свой собственный экземпляр pgAdmin, поэтому аутентификация или управление пользователями не требуются. Дополнительные сведения см. в документации по развертыванию на рабочем столе.

Что мне следует установить для параметра конфигурации Binary Path, чтобы я мог создавать и восстанавливать резервные копии?

pgAdmin может использовать утилиты PostgreSQL, такие как pg_dump, pg_restore, чтобы пользователи могли делать резервные копии и восстанавливать их, а также выполнять другие операции обслуживания. Путь к каталогу, в котором можно найти эти утилиты, должен быть предоставлен pgAdmin для включения этих функций — см. Файл -> Настройки -> Пути -> Двоичные пути. Вы можете указать отдельные пути для двоичных файлов PostgreSQL и EDB Advanced Server. В режиме сервера двоичные файлы должны быть установлены на сервере, на котором размещен pgAdmin, а в режиме рабочего стола они должны быть на локальном компьютере (на котором работает pgAdmin).

Двоичные утилиты обычно поставляются с пакетами сервера баз данных для вашей платформы. Будущие версии pgAdmin могут включать их в некоторые настольные пакеты.

Устранение неполадок

Как включить регистрацию в pgAdmin 4?

Настройки журнала по умолчанию для pgAdmin будут записывать предупреждения и ошибки в файл журнала, расположение которого зависит от платформы:

  • Linux/MacOS: ~/.pgadmin/pgadmin4.log
  • Windows: %APPDATA%\pgAdmin\pgadmin4.log

Чтобы переопределить настройки журнала, создайте файл с именем config_local.py в каталоге web/ установки вместе с существующим файлом config.py. Этот файл можно использовать для переопределения любых настроек в config.py (которые не следует редактировать). Чтобы изменить параметры ведения журнала, создайте файл, подобный следующему:

После изменения конфигурации необходимо перезапустить pgAdmin.

Когда я открываю Инструмент запросов или (другие инструменты) на новой вкладке, я получаю сообщение «Соединение с сервером потеряно» или «Токены CSRF не совпадают» в версиях Safari >= 12

В основном это наблюдается в версиях браузера Safari >= 12, хотя это может происходить и в других браузерах с нестандартными конфигурациями. Сообщается, что начиная с версии 12 CFNetwork/Webkit, используемые Safari, ошибочно трактуют «SameSite=none» как эквивалент «Samesite=strict». По сути, хотя Safari распознает атрибут cookie SameSite, начиная с версии 12, в их реализации есть ошибка.Для получения дополнительной информации см. этот пост на форумах Apple и эту ошибку WebKit.

Чтобы обойти эту проблему, создайте config_system.py, как показано в документации, и добавьте следующие параметры:

Примечание. Эти изменения отключат параметры безопасности в pgAdmin. Это следует использовать в крайнем случае, если и только если у вас есть клиенты, использующие Safari и затронутые этой проблемой, и которые не могут использовать альтернативный браузер.

Как мне запустить pgAdmin, чтобы он выводил журнал на консоль?

Если вы работаете в режиме сервера или напрямую используете Python, журналы консоли будут отправляться непосредственно на tty, под которым запущено приложение.

В настольном режиме процесс зависит от платформы:

  • Linux: запустите среду выполнения рабочего стола из командной строки, например /usr/local/pgadmin4/bin/pgadmin4, при необходимости изменив путь.
  • MacOS: запустите среду выполнения рабочего стола из командной строки, например /Applications/pgAdmin\ 4.app/Contents/MacOS/pgAdmin4, при необходимости изменив путь.
  • Windows: журналы консоли можно записывать в файл из командной строки в Windows, например "C:\Program Files\pgAdmin 4\v2\runtime\pgAdmin4.exe" > %TEMP%\pgadmin-console.log запишет журнал в %TEMP%\pgadmin-console.log.

Обратите внимание, что вам может потребоваться настроить параметр CONSOLE_LOG_LEVEL в config_local.py, чтобы увидеть полезную информацию в журнале. Дополнительные сведения см. в этом разделе часто задаваемых вопросов.

Почему pgAdmin использует много циклов процессора?

Архитектура pgAdmin 4, естественно, потребует больше ЦП и памяти, чем традиционное родное настольное приложение, однако pgAdmin 4 также включает в себя постоянно обновляемые информационные панели, которых не было в pgAdmin III. Панели мониторинга обновляют каждую диаграмму по умолчанию каждую секунду, даже если они не видны (во избежание пробелов в данных). Загрузка ЦП может быть заметно снижена путем настройки скорости обновления графиков на более длительный период, например десять секунд. Это можно сделать в разделе Файл -> Настройки -> Пути -> Панели мониторинга -> Графики. После внесения изменений может потребоваться перейти к другому экземпляру панели мониторинга, чтобы изменения вступили в силу.

Когда pgAdmin запускается в режиме рабочего стола на моем ПК с Windows, я просто вижу неформатированный текст в левой части окна. Почему?

Такое поведение было замечено многими пользователями Windows. По сути, происходит то, что браузер игнорирует таблицы стилей, которые должным образом форматируют отображение. Во всех замеченных случаях это происходило из-за того, что для параметра реестра на машине было установлено неправильное значение, возможно, из-за установки определенного редактора. Чтобы решить эту проблему, используйте редактор реестра Windows, чтобы сбросить значение "HKEY_CLASSES_ROOT\.css\Content Type" на "text/css" (без кавычек), а затем перезапустите pgAdmin.

В macOS я получаю сообщение об ошибке типа "pgAdmin 4 поврежден и не может быть открыт"

В основном это наблюдалось в более старых версиях macOS (например, 10.10). К сожалению, сообщение об ошибке обычно вводит в заблуждение, и цифровая подпись приложения будет правильно проверена. Настоящая проблема обычно заключается в том, что операционная система настроена так, чтобы разрешать запуск приложений только из магазина Apple App Store.

Чтобы изменить этот параметр, откройте Панель настроек и перейдите к разделу Безопасность и конфиденциальность. Оттуда измените параметр Разрешить загрузку приложений из на App Store и идентифицированных разработчиков (более безопасно) или откуда (менее безопасно).

Обратите внимание, что доступные параметры и их метки различаются от версии к версии macOS и могут отличаться от описанных выше.

Читайте также: