Storage Properties

Обзор
Конфигурация свойств хранилища в зависимости от типа хранилища
Файловое хранилище
Облачное хранилище
S3 Storage
EMC-ECS S3 Storage
Amazon S3 Storage

Обзор

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

Конфигурация свойств хранилища в зависимости от типа хранилища

Файловое хранилище

Примечание: эти свойства файлового хранилища доступны только до версии архива 5.30.0. Начиная с версии 5.31.0, свойства хранилища заменены отдельными полями в дескрипторе хранилища.

Это наиболее часто используемый тип системы хранения в конфигурации архива по умолчанию, применяемый для хранения DICOM-объектов.

Свойства	По умолчанию	Возможные значения	Примечания
`pathFormat`	`{now,date,yyyy/MM/dd}` `/{0020000D,hash}` `/{0020000E,hash}` `/{00080018,hash}`		DICOM-файлы сохраняются в расположение текущей даты, сгруппированные по исследованию / серии. Хэшированные значения UID исследования / серии / SOP используются для папок / DICOM-объектов.
`checkMountFile`	`NO_MOUNT`		Применимо в основном для NFS / внешних файловых систем, где пользователю необходимо сначала создать файл с указанным именем (`NO_MOUNT`) на NFS / внешней файловой системе перед монтированием файловой системы. `NO_MOUNT` — это просто преднастроенное значение, можно использовать любое другое, но необходимо следить, чтобы настроенное значение совпадало с именем файла, созданного на точке монтирования. Используется архивом для каждой операции сохранения DICOM-объекта (операции записи), чтобы проверить существование монтирования перед записью.
`fileOpenOption`	`CREATE_NEW`	Standard Open Options	Указанное по умолчанию значение применяется при отсутствии конфигурации.
`altCreateDirectories`		`true`	По умолчанию создаёт каталог, предварительно создавая все несуществующие родительские каталоги. Если установлено `true`, создаёт новый каталог, проверяя существование файла. При необходимости использует список атрибутов файла для атомарной установки при создании нового каталога.
`retryCreateDirectories`	`0`		Количество повторных попыток создания каталогов.
`onFileExists`		`NOOP` `FAILURE`	`NOOP`: не сохраняет объект в Storage, но добавляет ссылку на существующий файл для инстанса в базе данных. `FAILURE`: сохранение завершается сбоем с `FileAlreadyExistsException` При отсутствии конфигурации свойства `onFileExists` создаётся случайное имя файла из 8 шестнадцатеричных цифр, сохраняя прежнее поведение. Доступно с 5.29.3

Примечания по альтернативам pathFormat

Файловое хранилище также может использоваться: - Для хранения метаданных инстансов, используемых сторонними системами в рабочих процессах постобработки. pathFormat={0020000D}-{0020000E}.json - Для предварительной выборки WADO-объектов на промежуточном кэш-сервере для использования рабочими станциями. pathFormat={0020000D}/{0020000E}/{00080018}/{00081160}.jpeg

Облачное хранилище

Storage URI: jclouds:<endpoint>

Замените <endpoint> выше на URL, соответствующий настройкам вашего облачного хранилища.

Свойства	Настраиваемые значения	Примечания
`identity`	Укажите `access-key` вашего S3-хранилища
`credential`	Укажите `secret-key` вашего S3-хранилища
`container`	Укажите `bucket-name` вашего S3-хранилища
`containerExists`	`true` `false`	необязательно, по умолчанию: `false`
`jclouds.trust-all-certs`	`true` `false`	необязательно, протестировано: `true`
`jclouds.relax-hostname`	`true` `false`	необязательно, протестировано: `true`
`jclouds.strip-expect-header`	`true` `false`	необязательно, протестировано: `true`
`streamingUpload`	`true` `false`	необязательно, по умолчанию: `false` указывает, поддерживает ли бэкенд облачного хранилища потоковую передачу и следует ли её использовать.
`maxPartSize`		по умолчанию: `5G`. Если `streamingUpload` не поддерживается, максимальный размер объекта (`Content-Length`), загружаемого в одночастевой / многочастевой полезной нагрузке.
`synchronizeUpload`	`true` `false`	необязательно, по умолчанию: `false` Синхронизирует загрузки в S3.

S3 Storage

Storage URI: jclouds:s3:<endpoint>

Замените <endpoint> выше на URL, соответствующий настройкам вашего S3-хранилища.

Свойства	Настраиваемые значения	Примечания
`identity`	Укажите `access-key` вашего S3-хранилища
`credential`	Укажите `secret-key` вашего S3-хранилища
`container`	Укажите `bucket-name` вашего S3-хранилища
`containerExists`	`true` `false`	необязательно, по умолчанию: `false`
`jclouds.trust-all-certs`	`true` `false`	необязательно, протестировано: `true`
`jclouds.relax-hostname`	`true` `false`	необязательно, протестировано: `true`
`jclouds.s3.virtual-host-buckets`	`true` `false`	необязательно, протестировано: `false`
`jclouds.strip-expect-header`	`true` `false`	необязательно, протестировано: `true`
`streamingUpload`	`true` `false`	необязательно, по умолчанию: `false` указывает, поддерживает ли бэкенд облачного хранилища потоковую передачу и следует ли её использовать.
`synchronizeUpload`	`true` `false`	необязательно, по умолчанию: `false` Синхронизирует загрузки в S3.

EMC-ECS S3 Storage

Storage URI: emc-ecs-s3:<endpoint>

Замените <endpoint> выше на URL, соответствующий настройкам вашего EMC-ECS S3-хранилища.

Свойства	Настраиваемые значения	Примечания
`identity`	Укажите `access-key` вашего EMC-ECS S3-хранилища
`credential`	Укажите `secret-key` вашего EMC-ECS S3-хранилища
`container`	Укажите `bucket-name` вашего EMC-ECS S3-хранилища
`containerExists`	`true` `false`	необязательно, по умолчанию: `false`
`streamingUpload`	`true` `false`	необязательно, по умолчанию: `false` указывает, поддерживает ли бэкенд облачного хранилища потоковую передачу и следует ли её использовать.
`emc-ecs-s3.URLConnectionClientHandler`	`true` `false`	необязательно, по умолчанию: `false`

Amazon S3 Storage

Storage URI: jclouds:aws-s3:https://<bucket-name>.s3.<aws-s3-bucket-location>.amazonaws.com

Замените <bucket-name> и <aws-s3-bucket-location> в указанном URL на значения, соответствующие настройкам вашего Amazon S3-хранилища.

Свойства	Настраиваемые значения	Примечания
`identity`	Укажите `access-key` вашего Amazon AWS S3-хранилища
`credential`	Укажите `secret-key` вашего Amazon AWS S3-хранилища
`container`	Укажите `bucket-name` вашего Amazon AWS S3-хранилища
`containerExists`	`true` `false`	необязательно, по умолчанию: `false`, протестировано: `true`
`jclouds.s3.virtual-host-buckets`	`true` `false`	необязательно, протестировано: `true`
`jclouds.trust-all-certs`	`true` `false`	необязательно, протестировано: `true`
`jclouds.relax-hostname`	`true` `false`	необязательно, протестировано: `true`
`jclouds.s3.virtual-host-buckets`	`true` `false`	необязательно, протестировано: `true`
`jclouds.strip-expect-header`	`true` `false`	необязательно, протестировано: `true`
`streamingUpload`	`true` `false`	необязательно, по умолчанию: `false` указывает, поддерживает ли бэкенд облачного хранилища потоковую передачу и следует ли её использовать.