external:pro_bonus:01_setup:03_database

Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
external:pro_bonus:01_setup:03_database [2022/10/08 13:42] – [Подключение ProBonus к БД] Александр Ильинexternal:pro_bonus:01_setup:03_database [2026/10/22 08:34] (текущий) – Исправлены орфография, пунктуация и оформление; «сервер ПДС» заменён на «сервер ProBonus» Алексей Коробов
Строка 1: Строка 1:
-====== Создание и подключение БД ====== +====== БД. Создание, подключение, заполнение ====== 
-Для работы серверной части ProBonus требуется подключение к БД MS SQL (достаточно бесплатной версии Express). + 
-Сервер ProBonus и MS SQL Server могут работать как на одной машине, так и на разных. Во втором случае подключение к БД прописывается через сетевое имя (или IP адрес) сервера на котором развернут MS SQL. +**Требуется MS SQL Server 2017 и выше!** 
-Чаще всего серверная часть ProBonus устанавливается на тот же компьютер что и сервер справочников (сервер отчетов) r_keeper и база данных создается в том же экземпляре MS SQL.+ 
 +Для работы серверной части ProBonus требуется подключение к БД MS SQL (достаточно бесплатной версии Express). В отдельных случаях, когда БД разрастается больше 10 ГБ, потребуется апгрейд до версии Standard. 
 + 
 +Сервер ProBonus и MS SQL Server могут работать как на одной машине, так и на разных. Во втором случае подключение к БД прописывается через сетевое имя (или IP-адрес) сервера, на котором развёрнут MS SQL. 
 + 
 +Чаще всего серверная часть ProBonus устанавливается на тот же компьютер, что и сервер справочников (сервер отчётов) r_keeper, и база данных создаётся в том же экземпляре MS SQL.
  
 ===== Создание новой БД ===== ===== Создание новой БД =====
-При помощи MSSQL Server Management Studio подключаемся к нужному серверу SQL и создаем новую базу данных с уникальным именем, например "probonus".+ 
 +С помощью MS SQL Server Management Studio подключитесь к нужному серверу SQL и создайте новую базу данных с уникальным именем, например ''probonus''. 
 {{:external:pro_bonus:01_setup:pasted:20221008-130156.png}} {{:external:pro_bonus:01_setup:pasted:20221008-130156.png}}
 +
 {{:external:pro_bonus:01_setup:pasted:20221008-125713.png}} {{:external:pro_bonus:01_setup:pasted:20221008-125713.png}}
 +
 {{:external:pro_bonus:01_setup:pasted:20221008-130304.png}} {{:external:pro_bonus:01_setup:pasted:20221008-130304.png}}
  
 ===== Подключение ProBonus к БД ===== ===== Подключение ProBonus к БД =====
-Открыть web интерфейс ProBonus перейдя по ссылке http://127.0.0.1:11030/ 
-И войти в систему используя следующие данные 
-**Логин:** user 
-**Пароль:** 123 
-{{:external:pro_bonus:01_setup:pasted:20221008-133143.png?800}} 
  
-Во вкладке "**Соединение с БД**" задать строку подключения к базе данных MS SQL Server в формате драйвера SQL Python - pyodbc. +Откройте веб-интерфейс ProBonus, перейдя по ссылке [[http://127.0.0.1:11030/|http://127.0.0.1:11030/]], и войдите в систему, используя следующие данные:
-Для удобства настройки есть помощник (рекомендуемый способ подключения) для генерации строки подключения и проверки соединения. +
-Строка подключения формируется внизу окна, по мере заполнения полей. +
-{{:external:pro_bonus:01_setup:pasted:20221008-133302.png?800}}+
  
-  - Выбрать драйвер MS ODBC для SQL Server (из доступных в списке). +  * **Логин:** ''user'' 
-  - Указать имя (ip адрес) и порт сервера MS SQL. +  * **Пароль:** ''123''
-  - Ввести имя пользователя и пароль. +
-  - Нажать кнопку "Обновить список БД". +
-  - Если все верно, то произойдет подключение к указанному серверу MS SQL и будет доступен список баз на этом сервере, из которого надо выбрать нашу базу (probonus), созданную на прошлом шаге. +
-  - Нажать кнопку "Использовать строку".+
  
-=== Драйвер Microsoft ODBC для SQL Server === +{{:external:pro_bonus:01_setup:pasted:20230530-142537.png}} 
-В ниспадающем списке отображаются драйвера установленные в системе на которой запущен сервер ПДС. Выбираем SQL Server Native Client 11.0. + 
-**Важно!** Лучше всего устанавливать сервер ProBonus на той же машине что и MS SQL Srever. В противном случае для подключения ProBonus к серверу MS SQL дополнительно придется установить SQL Client.+На вкладке **Соединение с БД** задайте строку подключения к базе данных MS SQL Server в формате драйвера SQL Python — pyodbc. 
 + 
 +Для удобства настройки есть помощник (рекомендуемый способ подключения) для генерации строки подключения и проверки соединения. Строка подключения формируется внизу окна по мере заполнения полей. 
 + 
 +{{:external:pro_bonus:01_setup:pasted:20230530-083130.png}} 
 + 
 +  - Выберите драйвер MS ODBC для SQL Server (из доступных в списке). 
 +  - Укажите имя (IP-адрес) и порт сервера MS SQL. 
 +  - Введите имя пользователя и пароль. 
 +  - Нажмите кнопку **Обновить список БД**. 
 +  - Если всё верно, то произойдёт подключение к указанному серверу MS SQL и будет доступен список баз на этом сервере, из которого надо выбрать нашу базу (''probonus''), созданную на прошлом шаге. 
 +  - Нажмите кнопку **Использовать строку**. 
 + 
 +==== Драйвер Microsoft ODBC для SQL Server ==== 
 + 
 +В ниспадающем списке отображаются драйверы, установленные в системе, на которой запущен сервер ProBonus. Выберите SQL Server Native Client 11.0. 
 + 
 +**Важно!** Лучше всего устанавливать сервер ProBonus на той же машине, что и MS SQL Server. В противном случае для подключения ProBonus к серверу MS SQL дополнительно придётся установить SQL Client. 
 + 
 +==== Имя сервера MS SQL Server ==== 
 + 
 +Если в качестве имени сервера используется сетевой адрес, то номер порта отделяется запятой, а не двоеточием!
  
-=== Имя сервера MS SQL Server === 
-Если в качестве имени сервера используется сетевой адрес, то номер порта отделяется запятой а не двоеточием! 
 Примеры: Примеры:
-  * SQLSERVER-TEST 
-  * localhost 
-  * localhost, 1433 
-  * 127.0.0.1, 1433 
  
-=== Встроенная проверка подлинности Windows ===+  * ''SQLSERVER-TEST'' 
 +  * ''localhost'' 
 +  * ''localhost, 1433'' 
 +  * ''127.0.0.1, 1433'' 
 + 
 +==== Встроенная проверка подлинности Windows ==== 
 + 
 +**Не рекомендуется к использованию без особой необходимости. Имеется специфика в настройке прав доступа к SQL (у учётной записи, от которой запускается служба ProBonus, должны быть права).** 
 + 
 +Про режимы проверки можно почитать [[https://docs.microsoft.com/ru-ru/sql/relational-databases/security/choose-an-authentication-mode?view=sql-server-ver15|здесь]]. 
 + 
 +Если сервер ProBonus развёрнут на машине с MS SQL Server и он позволяет авторизовать пользователя Windows, проще поставить эту галочку. Тогда имя пользователя и пароль вводить не надо. 
 + 
 +Если сервер удалённый, при подключении по сети проще задать имя пользователя и пароль. 
 + 
 +{{:external:pro_bonus:01_setup:pasted:20230530-083457.png}} 
 + 
 +Для окончания настройки соединения и сохранения данных подключения нажмите кнопку **Проверить и сохранить**, после чего заново войдите в веб-интерфейс. 
 + 
 +{{:external:pro_bonus:01_setup:pasted:20230530-083609.png}}
  
-**Не рекомендуется к использованию без особой необходимости. Имеется специфика в настройке прав доступа к SQL (у учетной записи, от которой запускается служба ProBonus, должны быть права).**+===== Заполнение структуры БД =====
  
-Про режимы проверки можно почитать тут: https://docs.microsoft.com/ru-ru/sql/relational-databases/security/choose-an-authentication-mode?view=sql-server-ver15 +После успешного сохранения подключения и повторного входа в веб-интерфейс перейдите в раздел **Соединение с БД** и нажмите кнопку **Создать структуру в пустой базе данных**.
-Если сервер ProBonus развернут на машине с MS SQL Server и он позволяет авторизовать пользователя Windows проще поставить эту галку. Тогда имя пользователя и пароль вводить не надо. +
-Если сервер удалённый, при подключении по сети, то проще задать имя пользователя и пароль.+
  
 +Эта операция приведёт к тому, что в ранее созданной БД в MS SQL (''probonus'') будут автоматически созданы необходимые таблицы и заполнены первичные данные, необходимые для работы системы.
  
-{{:external:pro_bonus:01_setup:pasted:20221008-133405.png?800}}+Строка соединения с БД в интерфейсе при этом не будет заполнена — это не является проблемой или ошибкой.
  
-Для окончания настройки соединения и сохранения данных подключения нажать кнопку "Проверить и сохранить", после чего заново войти в web интерфейс. +{{:external:pro_bonus:01_setup:pasted:20230530-085601.png}}
-{{:external:pro_bonus:01_setup:pasted:20221008-133541.png?800}} +
-{{:external:pro_bonus:01_setup:pasted:20221008-133717.png?800}}+
  
 +Признак того, что база данных заполнена успешно, — заполненная информация «Текущая версия» в информации о базе данных.
  
 +{{:external:pro_bonus:01_setup:pasted:20230530-142244.png}}
  
  • external/pro_bonus/01_setup/03_database.1665225744.txt.gz
  • Последнее изменение: 2022/10/08 13:42
  • — Александр Ильин