Mercurial > hg > orthanc-book

comparison Sphinx/source/faq/orthanc-storage.rst @ 409:0d02abd26842

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
note
author Sebastien Jodogne <s.jodogne@gmail.com>
date Tue, 05 May 2020 06:58:18 +0200
parents 0fb9369e893e
children c95817c254fe
comparison
equal deleted inserted replaced
408:f97e9c9bb173 409:0d02abd26842
66 66
67 Direct access 67 Direct access
68 ------------- 68 -------------
69 69
70 Directly accessing the content of the ``OrthancStorage`` folder and 70 Directly accessing the content of the ``OrthancStorage`` folder and
71 the content of the SQLite database is strongly discouraged for several 71 the content of the SQLite/MySQL/PostgreSQL database is strongly
72 reasons: 72 discouraged for several reasons:
73 73
74 * This internal organization is only true when no database plugin is 74 * The internal organization outlined above is only true when no
75 used (e.g. the :ref:`PostgreSQL <postgresql>` and :ref:`MySQL 75 database plugin is used (e.g. the :ref:`PostgreSQL <postgresql>` and
76 <mysql>` plugins can be configured to store the attachments inside a 76 :ref:`MySQL <mysql>` plugins can be configured to store the
77 database). 77 attachments inside a database).
78 * Orthanc can be configured to compress the attachments before writing 78 * Orthanc can be configured to compress the attachments before writing
79 them on the disk (cf. the ``StorageCompression`` option). 79 them on the disk (cf. the ``StorageCompression`` option).
80 * By directly reading the content of ``OrthancStorage``, you bypass 80 * By directly reading the content of ``OrthancStorage``, you bypass
81 all the locking mechanisms used by Orthanc, which might result in 81 all the locking mechanisms used by Orthanc, which might result in
82 data corruption. 82 data corruption.
85 that are `explained in the SQLite FAQ 85 that are `explained in the SQLite FAQ
86 <https://www.sqlite.org/faq.html#q5>`__. Orthanc will stop if it 86 <https://www.sqlite.org/faq.html#q5>`__. Orthanc will stop if it
87 receives the ``SQLITE_BUSY`` status. 87 receives the ``SQLITE_BUSY`` status.
88 88
89 As a consequence, it is **HIGHLY recommended NOT to directly access** 89 As a consequence, it is **HIGHLY recommended NOT to directly access**
90 the ``OrthancStorage`` folder and the SQLite database. Use the 90 the ``OrthancStorage`` folder and the SQLite/MySQL/PostgreSQL
91 :ref:`REST API <rest>` instead, which contains primitives to access 91 database. Use the :ref:`REST API <rest>` instead, which contains
92 the attachments (cf. the ``.../attachments/...`` URIs). 92 primitives to access the attachments (cf. the ``.../attachments/...``
93 URIs).
93 94
94 The only exception to this rule is for **read-only access when Orthanc 95 The only exception to this rule is for **read-only access when Orthanc
95 is stopped**, e.g. as a part of a :ref:`backup <backup>` or 96 is stopped**, e.g. as a part of a :ref:`backup <backup>` or
96 :ref:`upgrade/replication <replication>` process. 97 :ref:`upgrade/replication <replication>` process.