Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

3x: перенос баз данных и сохранение/восстановление архивных данных

В данном разделе описано:

  • Как перенести базу данных: в пределах одного компьютера или на другой компьютер (в другой экземпляр сервера истории).
  • Как сохранить архивные данные или их часть для последующего восстановления.
  • Как восстановить сохранённые архивные данные для просмотра.

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

Поэтому, чтобы после переноса/восстановления базы данных из неё можно было получить данные, нужно:

  • Сохранить проект Alpha.DevStudio (если конфигурация для Alpha.Server создавалась в нём) обязательно вместе с хранилищем состояния. Расположение хранилища состояния указано в Alpha.DevStudio в окне Параметры в узле Рабочая среда.
  • Или сохранить конфигурацию того экземпляра Alpha.Server (или нескольких экземпляров), который сохранял в неё данные.

После переноса/восстановления базы данных нужно применить сохранённую конфигурацию (в случае с Alpha.DevStudio – построить и применить) к тому экземпляру Alpha.Server, который будет запрашивать сохранённые данные из базы данных.

Файловая структура базы данных

В файловой системе база данных содержит следующие папки и файл:

  • active
  • archive
  • imported
  • stx
  • db.index

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

  • Если для базы данных не указаны основной и архивный каталоги, её папки и файл будут храниться в каталоге по умолчанию (атрибут DefaultPrimaryDir сервера истории).

    Описание базы данных в файле конфигурации:

    <?xml version="1.0" encoding="utf-8"?>
    <Alpha.Historian.Server StatPort="3388" DefaultPrimaryDir="C:\Alpha.Historian\Databases" >
      <Bases>
        <Base Alias="My-DB" />
      </Bases>
    </Alpha.Historian.Server>

    Структура базы данных в файловой системе:

    C:\Alpha.Historian\Databases\My-DB/
    ├── active/
    ├── archive/
    ├── imported/
    ├── stx/
    └── db.index
  • Если для базы данных указан основной каталог, папки и файл будут храниться в нём.

    Описание базы данных в файле конфигурации:

    <?xml version="1.0" encoding="utf-8"?>
    <Alpha.Historian.Server StatPort="3388" DefaultPrimaryDir="C:\Alpha.Historian\Databases" >
      <Bases>
        <Base Alias="My-DB" PrimaryDir="C:\Alpha.Historian\Custom-PrimaryDir" />
      </Bases>
    </Alpha.Historian.Server>

    Структура базы данных в файловой системе:

    C:\Alpha.Historian\Custom-PrimaryDir\My-DB/
    ├── active/
    ├── archive/
    ├── imported/
    ├── stx/
    └── db.index
  • Если для базы данных указаны и основной и архивный каталоги, папки archive и imported будут храниться в архивном каталоге, остальные папки и файл – в основном каталоге.

    Описание базы данных в файле конфигурации:

    <?xml version="1.0" encoding="utf-8"?>
    <Alpha.Historian.Server StatPort="3388" DefaultPrimaryDir="C:\Alpha.Historian\Databases" >
      <Bases>
        <Base Alias="My-DB" PrimaryDir="C:\Alpha.Historian\Custom-PrimaryDir" ArchiveDir="C:\Alpha.Historian\Custom-ArchiveDir" />
      </Bases>
    </Alpha.Historian.Server>

    Структура базы данных в файловой системе:

    C:\Alpha.Historian/
    ├── Custom-ArchiveDir/
    |   └── My-DB/
    |       ├── archive/
    |       └── imported/
    └── Custom-PrimaryDir/
        └── My-DB/
            ├── active/
            ├── stx/
            └── db.index
  • Если для базы данных указан только архивный каталог, папки archive и imported будут храниться в нём, а остальные папки и файл – в каталоге по умолчанию (атрибут DefaultPrimaryDir сервера истории).

    Описание базы данных в файле конфигурации:

    <?xml version="1.0" encoding="utf-8"?>
    <Alpha.Historian.Server StatPort="3388" DefaultPrimaryDir="C:\Alpha.Historian\Databases" >
      <Bases>
        <Base Alias="My-DB" ArchiveDir="C:\Alpha.Historian\Custom-ArchiveDir" />
      </Bases>
    </Alpha.Historian.Server>

    Структура базы данных в файловой системе:

    C:\Alpha.Historian/
    ├── Custom-ArchiveDir/
    |   └── My-DB/
    |       ├── archive/
    |       └── imported/
    └── Databases/
        └── My-DB/
            ├── active/
            ├── stx/
            └── db.index

Перенос базы данных

Перенести базу данных можно как на другой компьютер (в другой сервер истории), так и переместить в рамках одного компьютера: чтобы сменить расположение и/или структуру хранения базы данных в файловой системе.

Чтобы перенести базу данных:

  1. У сервера истории, в который будет перенесена база данных, в файл конфигурации добавьте описание новой базы данных.

    Любые параметры новой базы данных могут отличаться от параметров исходной базы данных.

    Если глубина хранения (атрибут StorageDepth) новой базы данных будет меньше, чем у исходной, то после переноса данные, которые окажутся старше новой глубины хранения, будут удалены.

  2. Перезапустите сервер истории.

    При запуске сервер истории создаст структуру папок и файл новой базы данных.

  3. Остановите сервер истории, чтобы файл базы данных не был заблокирован для замены.

  4. Скопируйте с заменой файл и папки исходной базы данных в новую базу данных в соответствии со структурой новой базы данных.
  5. Если переносили базу данных в рамках одного сервера истории, из файла конфигурации удалите описание исходной базы данных.
  6. Запустите сервер истории.

Сохранение части архива базы данных

Архив или его части можно сохранить в отдельную папку или на внешний носитель информации. Сохранённые таким образом данные впоследствии можно восстановить.

Чтобы создать копию архивных данных:

  1. Создайте папку.
  2. Скопируйте в неё файл db.index из структуры базы данных.
  3. Скопируйте в неё папку archive из структуры базы данных.

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

    После копирования, из папки archive базы данных можно удалить скопированные подпапки, если для текущей работы они не нужны.

    Файл db.index и папку archive базы данных удалять нельзя.

Чтобы дополнить созданную ранее копию архивных данных:

  1. Скопируйте с заменой файл db.index из базы данных в копию архива.
  2. В копию архива скопируйте подпапки с данными от интересующих вас источников и за нужные вам даты.

Восстановление сохранённых архивных данных для просмотра

Чтобы восстановить сохранённые архивные данные для просмотра:

  1. Создайте новую базу данных в сервере истории:

    1. В файл конфигурации сервера истории добавьте новую базу данных.

      Для неё не указывайте глубину хранения (по умолчанию – не ограничена) или укажите неограниченную глубину хранения : StorageDepth="0". В противном случае сервер истории при запуске может удалить данные, имеющие большую глубину относительно текущей даты.

    2. Перезапустите сервер истории.

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

  2. Скопируйте архивные данные в базу данных:

    1. Остановите сервер истории.
    2. Замените в папке базы данных файл db.index одноимённым файлом из сохранённого архива.
    3. Из папки archive сохранённого архива скопируйте папки интересующих вас источников и за нужные для просмотра даты в одноимённую папку базы данных.
    4. Запустите сервер истории.

После этого восстановленные архивные данные можно запрашивать из добавленной базы данных.