Purge instance records from DB

Обзор

Использование этой функции выгодно, когда архив ежедневно принимает тысячи исследований, что за несколько месяцев приводит к миллионам записей, или если существуют ограничения на размер/скорость базы данных. Для использования этой функции необходимо накапливать метаданные на уровне серии (series), что объединяет метаданные всех экземпляров серии в ZIP-файл, который позже будет использоваться для запроса/извлечения записей экземпляров, подлежащих очистке (purge).

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

С использованием UI архива

Перейдите в Menu->Configuration, затем на странице Devices Edit устройство dcm4chee-arc. Перейдите в Extensions и Edit extension у Device Extension. Снова перейдите в его Extensions и Edit extension у Archive Device.
Введите значения в поля Remove Instance Records Delay, Remove Instance Records Polling Interval, Remove Instance Records Fetch Size, Aggregate Series Metadata Delay, Series Metadata Storage ID, Update Series Metadata Polling Interval и Update Series Metadata Fetch Size согласно потребностям приложения или значениями, как показано ниже, и нажмите Save.
На уровне Archive Device создайте новый Storage Descriptor как Child Object согласно потребностям приложения или со значениями, как показано ниже, и нажмите Save.

С использованием LDAP

Можно либо - создать LDIF-файл (напр.):

    version: 1
    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmPurgeInstanceRecordsDelay
    dcmPurgeInstanceRecordsDelay: PT1M

    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmPurgeInstanceRecordsPollingInterval
    dcmPurgeInstanceRecordsPollingInterval: PT1M

    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmPurgeInstanceRecordsFetchSize
    dcmPurgeInstanceRecordsFetchSize: 10

    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmSeriesMetadataStorageID
    dcmSeriesMetadataStorageID: series-metadata

    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmSeriesMetadataDelay
    dcmSeriesMetadataDelay: PT1M

    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmSeriesMetadataPollingInterval
    dcmSeriesMetadataPollingInterval: PT1M

    dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    changetype: modify
    add: dcmSeriesMetadataFetchSize
    dcmSeriesMetadataFetchSize: 10

    dn: dcmStorageID=series-metadata,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    objectClass: dcmStorage
    dcmStorageID: series-metadata
    dcmURI: ${jboss.server.data.url}/series-metadata/
    dcmProperty: pathFormat={now,date,yyyy/MM/dd}/{0020000D}/{0020000E}/metadata.zip
    dcmProperty: checkMountFile=NO_MOUNT

и импортировать его на LDAP-сервер с помощью утилиты командной строки _ldapmodify_.

либо использовать функцию Add Attribute... и Add Value... в Apache Directory Studio для добавления атрибутов на уровнях Archive device, Application Entity (напр.: dicomDeviceName=dcm4chee-arc, dicomAETitle=DCM4CHEE) в конфигурации архива.
См. Generic Storage для настройки хранилища series-metadata.

Описание атрибутов см. в Archive Device, Archive Network AE и Storage.

Сведения о длительностях см. в формате длительностей ISO-8601.

Перейдите на вкладку Control на странице Configuration в UI архива и перезагрузите конфигурацию.

Тестирование

Протестировать эту функцию можно с помощью UI архива и инструментов dcm4che, как показано ниже:

Отправьте исследования в архив с помощью инструмента storescu
```
storescu -c DCM4CHEE@localhost:11112 <path-to.study>
```
После ожидания в течение настроенных задержек dcmSeriesMetadataDelay и dcmPurgeInstanceRecordsDelay; используя UI архива, можно проверить, что значение приватного атрибута Instance Record Purge State of Series на уровне серии равно PURGED, как показано ниже:

Примечание: Если архив уже содержит миллионы исследований и нужно накопить метаданные и очистить записи экземпляров из БД, то можно установить столбцы таблицы series.metadata_update_time и series.inst_purge_time в текущее время, чтобы эта функция вступила в силу.