[RDBMS] Complete database documentation part (#186)

[RDBMS] Complete database documentation part

Author: shorodilov

poetry.lock

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "python-course"
-version = "2023.11.dev"
+version = "2024.02.dev"
 description = "Python training course materials"
 license = "MIT"
 authors = [

pyproject.toml

@@ -1,17 +1,17 @@
-alabaster==0.7.13 ; python_version >= "3.9" and python_version < "4.0"
+alabaster==0.7.16 ; python_version >= "3.9" and python_version < "4.0"
 babel==2.14.0 ; python_version >= "3.9" and python_version < "4.0"
-certifi==2023.11.17 ; python_version >= "3.9" and python_version < "4.0"
+certifi==2024.2.2 ; python_version >= "3.9" and python_version < "4.0"
 charset-normalizer==3.3.2 ; python_version >= "3.9" and python_version < "4.0"
 click==8.1.7 ; python_version >= "3.9" and python_version < "4.0"
 colorama==0.4.6 ; python_version >= "3.9" and python_version < "4.0" and sys_platform == "win32" or python_version >= "3.9" and python_version < "4.0" and platform_system == "Windows"
 docutils==0.18.1 ; python_version >= "3.9" and python_version < "4.0"
 idna==3.6 ; python_version >= "3.9" and python_version < "4.0"
 imagesize==1.4.1 ; python_version >= "3.9" and python_version < "4.0"
 importlib-metadata==7.0.1 ; python_version >= "3.9" and python_version < "3.10"
-jinja2==3.1.2 ; python_version >= "3.9" and python_version < "4.0"
+jinja2==3.1.3 ; python_version >= "3.9" and python_version < "4.0"
 latexcodec==2.0.1 ; python_version >= "3.9" and python_version < "4.0"
 markdown-it-py==2.2.0 ; python_version >= "3.9" and python_version < "4.0"
-markupsafe==2.1.3 ; python_version >= "3.9" and python_version < "4.0"
+markupsafe==2.1.5 ; python_version >= "3.9" and python_version < "4.0"
 mdit-py-plugins==0.3.5 ; python_version >= "3.9" and python_version < "4.0"
 mdurl==0.1.2 ; python_version >= "3.9" and python_version < "4.0"
 myst-parser==1.0.0 ; python_version >= "3.9" and python_version < "4.0"
@@ -21,24 +21,24 @@ pybtex==0.24.0 ; python_version >= "3.9" and python_version < "4.0"
 pygments==2.17.2 ; python_version >= "3.9" and python_version < "4.0"
 pyyaml==6.0.1 ; python_version >= "3.9" and python_version < "4.0"
 requests==2.31.0 ; python_version >= "3.9" and python_version < "4.0"
-setuptools==69.0.3 ; python_version >= "3.9" and python_version < "4.0"
+setuptools==69.1.0 ; python_version >= "3.9" and python_version < "4.0"
 six==1.16.0 ; python_version >= "3.9" and python_version < "4.0"
 snowballstemmer==2.2.0 ; python_version >= "3.9" and python_version < "4.0"
 sphinx-copybutton==0.5.2 ; python_version >= "3.9" and python_version < "4.0"
 sphinx-intl==2.1.0 ; python_version >= "3.9" and python_version < "4.0"
 sphinx-reredirects==0.1.3 ; python_version >= "3.9" and python_version < "4.0"
 sphinx-rtd-theme==1.3.0 ; python_version >= "3.9" and python_version < "4.0"
 sphinx==6.2.1 ; python_version >= "3.9" and python_version < "4.0"
-sphinxcontrib-applehelp==1.0.7 ; python_version >= "3.9" and python_version < "4.0"
+sphinxcontrib-applehelp==1.0.8 ; python_version >= "3.9" and python_version < "4.0"
 sphinxcontrib-bibtex==2.5.0 ; python_version >= "3.9" and python_version < "4.0"
-sphinxcontrib-devhelp==1.0.5 ; python_version >= "3.9" and python_version < "4.0"
-sphinxcontrib-htmlhelp==2.0.4 ; python_version >= "3.9" and python_version < "4.0"
+sphinxcontrib-devhelp==1.0.6 ; python_version >= "3.9" and python_version < "4.0"
+sphinxcontrib-htmlhelp==2.0.5 ; python_version >= "3.9" and python_version < "4.0"
 sphinxcontrib-jquery==4.1 ; python_version >= "3.9" and python_version < "4.0"
 sphinxcontrib-jsmath==1.0.1 ; python_version >= "3.9" and python_version < "4.0"
 sphinxcontrib-mermaid==0.8.1 ; python_version >= "3.9" and python_version < "4.0"
-sphinxcontrib-qthelp==1.0.6 ; python_version >= "3.9" and python_version < "4.0"
-sphinxcontrib-serializinghtml==1.1.9 ; python_version >= "3.9" and python_version < "4.0"
+sphinxcontrib-qthelp==1.0.7 ; python_version >= "3.9" and python_version < "4.0"
+sphinxcontrib-serializinghtml==1.1.10 ; python_version >= "3.9" and python_version < "4.0"
 sphinxcontrib-svg2pdfconverter==1.2.2 ; python_version >= "3.9" and python_version < "4.0"
 toml==0.10.2 ; python_version >= "3.9" and python_version < "4.0"
-urllib3==2.1.0 ; python_version >= "3.9" and python_version < "4.0"
+urllib3==2.2.1 ; python_version >= "3.9" and python_version < "4.0"
 zipp==3.17.0 ; python_version >= "3.9" and python_version < "3.10"

requirements.txt

@@ -0,0 +1,239 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2024, Python training course authors and contributors
+# This file is distributed under the same license as the Python Training
+# Course package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: Python Training Course 2024.02.dev\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2024-02-18 16:48+0200\n"
+"PO-Revision-Date: 2024-02-18 16:59+0200\n"
+"Last-Translator: Serhii Horodilov <sgorodil@gmail.com>\n"
+"Language-Team: uk <LL@li.org>\n"
+"Language: uk\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && "
+"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n"
+"Generated-By: Babel 2.14.0\n"
+"X-Generator: Poedit 3.4.2\n"
+
+#: ../../src/rdbms/acid.txt:-1
+msgid "Database normalization"
+msgstr "Нормалізація бази даних"
+
+#: ../../src/rdbms/acid.txt:-1
+msgid "Serhii Horodilov"
+msgstr "Serhii Horodilov"
+
+#: ../../src/rdbms/acid.txt:-1
+msgid "sql, db, database, acid, atomic, consistent, isolated, durable"
+msgstr "sql, db, database, acid, atomic, consistent, isolated, durable"
+
+#: ../../src/rdbms/acid.txt:8
+msgid "ACID"
+msgstr "ACID"
+
+#: ../../src/rdbms/acid.txt:10
+msgid ""
+":abbr:`ACID (Atomicity, Consistency, Isolation, Durability)` is a set of "
+"properties of database transactions intended to guarantee data validity "
+"despite errors, power failures, and other mishaps. In the context of "
+"databases, a sequence of database operations that satisfies the ACID "
+"properties is called a transaction."
+msgstr ""
+":abbr:`ACID (Atomicity, Consistency, Isolation, Durability - атомарність, "
+"узгодженість, ізоляція, довговічність)` - це набір властивостей транзакцій "
+"бази даних, призначених для гарантування дійсності даних, незважаючи на "
+"помилки, збої в електропостачанні та інші непередбачувані ситуації. У "
+"контексті баз даних послідовність операцій з базою даних, яка задовольняє "
+"властивості ACID, називається транзакцією."
+
+#: ../../src/rdbms/acid.txt:17
+msgid "Atomicity"
+msgstr "Атомарність"
+
+#: ../../src/rdbms/acid.txt:19
+msgid ""
+"Transactions are often composed of multiple statements. Atomicity guarantees "
+"that each transaction is treated as a single \"unit\", which either succeeds "
+"completely, or fails completely: if any of the statements constituting a "
+"transaction fails to complete, the entire transaction fails and the database "
+"left unchanged. A guarantee of atomicity prevents updates to the database "
+"from occurring only partially, which can cause greater problems, than "
+"rejecting the whole series outright."
+msgstr ""
+"Транзакції часто складаються з декількох операцій. Атомарність гарантує, що "
+"кожна транзакція розглядається як одна \"одиниця\", яка або повністю "
+"завершується успішно, або повністю провалюється: якщо будь-який з "
+"операторів, що складають транзакцію, не завершується, вся транзакція "
+"провалюється, а база даних залишається незмінною. Гарантія атомарності "
+"запобігає частковому оновленню бази даних, що може спричинити більші "
+"проблеми, ніж повна відмова від усієї серії оновлень даних."
+
+#: ../../src/rdbms/acid.txt:27
+msgid "As an example, there are few rows in an accounting table:"
+msgstr "Наприклад, в бухгалтерській таблиці є кілька рядків:"
+
+#: ../../src/rdbms/acid.txt:29
+msgid "accounting"
+msgstr "accounting"
+
+#: ../../src/rdbms/acid.txt:32
+msgid "person_id"
+msgstr "person_id"
+
+#: ../../src/rdbms/acid.txt:32
+msgid "name"
+msgstr "name"
+
+#: ../../src/rdbms/acid.txt:32
+msgid "balance"
+msgstr "balance"
+
+#: ../../src/rdbms/acid.txt:34 ../../src/rdbms/acid.txt:40
+msgid "..."
+msgstr "..."
+
+#: ../../src/rdbms/acid.txt:36 ../../src/rdbms/acid.txt:53
+msgid "529"
+msgstr "529"
+
+#: ../../src/rdbms/acid.txt:36 ../../src/rdbms/acid.txt:53
+msgid "Dora Headstrong"
+msgstr "Dora Headstrong"
+
+#: ../../src/rdbms/acid.txt:36
+msgid "$1,000"
+msgstr "$1,000"
+
+#: ../../src/rdbms/acid.txt:38 ../../src/rdbms/acid.txt:55
+msgid "402"
+msgstr "402"
+
+#: ../../src/rdbms/acid.txt:38 ../../src/rdbms/acid.txt:55
+msgid "Toby Mugwort"
+msgstr "Toby Mugwort"
+
+#: ../../src/rdbms/acid.txt:38 ../../src/rdbms/acid.txt:55
+msgid "$100"
+msgstr "$100"
+
+#: ../../src/rdbms/acid.txt:43
+msgid ""
+"In case, Dora wants to transfer $100 to Toby, this can be split into 3 "
+"statements:"
+msgstr "Якщо Дора хоче переказати $100 Тобі, це можна розбити на 3 операції:"
+
+#: ../../src/rdbms/acid.txt:46
+msgid "Check if $100 is available"
+msgstr "Перевірити, чи доступні $100"
+
+#: ../../src/rdbms/acid.txt:47
+msgid "Deduct $100 from Dora's balance"
+msgstr "Відняти $100 з балансу Дори"
+
+#: ../../src/rdbms/acid.txt:48
+msgid "Add $100 to Toby's balance"
+msgstr "Додати $100 на баланс Тобі"
+
+#: ../../src/rdbms/acid.txt:50
+msgid "In case the 3rd statement fails, the data may stay as:"
+msgstr "Якщо 3-й оператор не спрацює, дані можуть залишитися у вигляді:"
+
+#: ../../src/rdbms/acid.txt:53
+msgid "$900"
+msgstr "$900"
+
+#: ../../src/rdbms/acid.txt:58
+msgid ""
+"Atomicity guarantee reverting database to an old state, in case any "
+"statement fails."
+msgstr ""
+"Атомарність гарантує повернення бази даних до старого стану, якщо якийсь "
+"оператор зазнає невдачі."
+
+#: ../../src/rdbms/acid.txt:62
+msgid "Consistency"
+msgstr "Узгодженість"
+
+#: ../../src/rdbms/acid.txt:64
+msgid ""
+"You can think \"consistency\" as \"correctness\". It ensures that a "
+"transaction can only bring the database from one consistent state to "
+"another, preserving database invariants: any data written to the database "
+"must be valid according to all defined rules, including constraints, "
+"cascades, triggers, and any combination of thereof. This prevents database "
+"corruption by an illegal transaction. As example, referential integrity "
+"guarantees the primary key -- foreign key relationship."
+msgstr ""
+"Ви можете думати про \"узгодженість\" як про \"правильність\". Вона "
+"гарантує, що транзакція може лише переводити базу даних з одного узгодженого "
+"стану в інший: будь-які дані, записані в базу даних, повинні бути дійсними "
+"згідно з усіма визначеними правилами, включаючи обмеження, каскади, тригери "
+"та будь-яку їх комбінацію. Це запобігає пошкодженню бази даних неправильною "
+"транзакцією. Наприклад, цілісність посилань гарантує зв'язок між первинним і "
+"зовнішнім ключами."
+
+#: ../../src/rdbms/acid.txt:73
+msgid "Isolation"
+msgstr "Ізоляція"
+
+#: ../../src/rdbms/acid.txt:75
+msgid ""
+"Transactions are often executed concurrently (e.g. multiple transactions "
+"reading and writing to a table at the same time). Isolation ensures that "
+"concurrent execution of transactions leaves the database in the state that "
+"would have been obtained if the transactions were executed sequentially. "
+"Isolation is the main goal of concurrency control; depending on the "
+"isolation level used, the effects of an incomplete transaction might not be "
+"visible to other transaction."
+msgstr ""
+"Транзакції часто виконуються паралельно (наприклад, декілька транзакцій "
+"одночасно читають і записують дані в таблицю). Ізоляція гарантує, що "
+"одночасне виконання транзакцій залишає базу даних у стані, який був би "
+"отриманий, якби транзакції виконувалися послідовно. Ізоляція є основною "
+"метою контролю паралелізму; залежно від рівня ізоляції, що використовується, "
+"наслідки незавершеної транзакції можуть бути невидимими для інших транзакцій."
+
+#: ../../src/rdbms/acid.txt:83
+msgid ""
+"For example, two persons have access to the same account having $1,000 on "
+"it, and both persons tries to get the money out of this account. Dora tries "
+"to get $1,000, and Toby tries to get $100."
+msgstr ""
+"Наприклад, дві особи мають доступ до одного рахунку, на якому є $1,000, і "
+"обидві особи намагаються зняти гроші з цього рахунку. Дора намагається зняти "
+"$1,000, а Тобі - $100."
+
+#: ../../src/rdbms/acid.txt:87
+msgid ""
+"The sum of the money to get out of the account is $1,100, which cause an "
+"issue of leaving negative amount of money. So, one of these transactions "
+"fails."
+msgstr ""
+"Сума грошей, яку потрібно зняти з рахунку, становить $1,100, що призводить "
+"до проблеми від'ємної суми. Отже, одна з цих транзакцій не вдається."
+
+#: ../../src/rdbms/acid.txt:90
+msgid "Isolation ensures the concurrent executions are safe."
+msgstr "Ізоляція забезпечує безпеку конкурентного виконання."
+
+#: ../../src/rdbms/acid.txt:93
+msgid "Durability"
+msgstr "Довговічність"
+
+#: ../../src/rdbms/acid.txt:95
+msgid ""
+"The durability means once the transaction has been committed, the data must "
+"be writen to non-volatile memory. So, even if a crash happens, or something "
+"wrong with the database, the data must be where, and must not be corrupted."
+msgstr ""
+"Довговічність означає, що як тільки транзакція була здійснена, дані повинні "
+"бути записані в енергонезалежну пам'ять. Таким чином, навіть якщо трапиться "
+"збій або щось не так з базою даних, дані повинні бути на місці і не повинні "
+"бути пошкоджені."