diff --git a/3-databases-with-docker-slides.html b/3-databases-with-docker-slides.html index db166ae..6d64d3a 100644 --- a/3-databases-with-docker-slides.html +++ b/3-databases-with-docker-slides.html @@ -1,4 +1,5 @@ -Databases
-

Databases

-
-
-

SQL

-
    -
  • Structured Query Language
    • -
  • A language to organize and manipulate data in a relational database
    • -
  • Originally developed by IBM in the 70s
    • -
  • Quickly became the most popular database language
    • -
-
SELECT id, email
-FROM users
-WHERE first_name = 'Teppo';
-
-
-
-

Relational Database Management Systems

-
    -
  • In relational databases, values are stored in tables -
      -
    • Each table has rows and columns
      • -
    • Data is displayed in a two-dimensional matrix
      • -
    -
    • -
  • Values in a table are related to each other -
      -
    • Values can also be related to values in other tables
      • -
    -
    • -
  • A relational database management system (RDBMS) is a program that executes queries to relational databases
    • -
-
-
-

Relational Database Management Systems

-

-

https://db-engines.com/en/ranking

-
-
-

PostgreSQL

-

A free, open-source, cross-platform relational database management system

-

Emphasizes extensibility and SQL compliance

-

Fully ACID-compliant (atomicity, consistency, isolation and durability)

-
-
-

Running Postgres in Docker

-

Using the official Postgres Docker image , let's create a locally running Postgres instance. You can choose the values for POSTGRES_PASSWORD and POSTGRES_USER freely.

-
docker run --name my-postgres --env POSTGRES_PASSWORD=pgpass 
---env POSTGRES_USER=pguser -p 5432:5432 -d postgres:15.2
-
-

-
-
-

Managing the PostgreSQL database with psql

-

psql is a terminal-based front-end to PostgreSQL. It enables you to type in queries interactively, issue them to PostgreSQL, and see the query results. Alternatively, input can be from a file or from command line arguments. In addition, psql provides a number of meta-commands and various shell-like features to facilitate writing scripts and automating a wide variety of tasks.

-

https://www.postgresql.org/docs/current/app-psql.html

-

You can use psql directly from the container running the database

-
docker exec -it my-postgres psql -U pguser
-
-
-
-

Managing the PostgreSQL database with psql

-
    -
  • If you have connected to the server as user "pguser", you are by default connected to "pguser" database.
    • -
  • This is a database for user information. Do not use it for storing program data!!
    • -
  • All databases can be listed using the list command: \l
    • -
  • PostgreSQL uses a default database named "postgres"
    • -
  • Users can connect to a different database with connect command \c: -
      -
    • \c <database-name>
      • -
    -
    • -
  • A new database is created with CREATE command: -
      -
    • CREATE DATABASE <database-name>; <-- notice the semicolon!
      • -
    • After creating a new database, you still need to connect to it!
      • -
    -
    • -
  • Exit psql with the command exit
    • -
-
-
-

Exercise 1: Postgres Server

+ */div#\:\$p>svg>foreignObject>section,div#\:\$p>svg>foreignObject>section [data-theme=light]{--color-prettylights-syntax-comment:#6e7781;--color-prettylights-syntax-constant:#0550ae;--color-prettylights-syntax-entity:#6639ba;--color-prettylights-syntax-storage-modifier-import:#24292f;--color-prettylights-syntax-entity-tag:#116329;--color-prettylights-syntax-keyword:#cf222e;--color-prettylights-syntax-string:#0a3069;--color-prettylights-syntax-variable:#953800;--color-prettylights-syntax-brackethighlighter-unmatched:#82071e;--color-prettylights-syntax-invalid-illegal-text:#f6f8fa;--color-prettylights-syntax-invalid-illegal-bg:#82071e;--color-prettylights-syntax-carriage-return-text:#f6f8fa;--color-prettylights-syntax-carriage-return-bg:#cf222e;--color-prettylights-syntax-string-regexp:#116329;--color-prettylights-syntax-markup-list:#3b2300;--color-prettylights-syntax-markup-heading:#0550ae;--color-prettylights-syntax-markup-italic:#24292f;--color-prettylights-syntax-markup-bold:#24292f;--color-prettylights-syntax-markup-deleted-text:#82071e;--color-prettylights-syntax-markup-deleted-bg:#ffebe9;--color-prettylights-syntax-markup-inserted-text:#116329;--color-prettylights-syntax-markup-inserted-bg:#dafbe1;--color-prettylights-syntax-markup-changed-text:#953800;--color-prettylights-syntax-markup-changed-bg:#ffd8b5;--color-prettylights-syntax-markup-ignored-text:#eaeef2;--color-prettylights-syntax-markup-ignored-bg:#0550ae;--color-prettylights-syntax-meta-diff-range:#8250df;--color-prettylights-syntax-brackethighlighter-angle:#57606a;--color-prettylights-syntax-sublimelinter-gutter-mark:#8c959f;--color-prettylights-syntax-constant-other-reference-link:#0a3069;--color-fg-default:#1f2328;--color-fg-muted:#656d76;--color-fg-subtle:#6e7781;--color-canvas-default:#fff;--color-canvas-subtle:#f6f8fa;--color-border-default:#d0d7de;--color-border-muted:#d8dee4;--color-neutral-muted:rgba(175,184,193,.2);--color-accent-fg:#0969da;--color-accent-emphasis:#0969da;--color-attention-subtle:#fff8c5;--color-danger-fg:#d1242f;color-scheme:light}div#\:\$p>svg>foreignObject>section [data-theme=dark],div#\:\$p>svg>foreignObject>section:where(.invert){--color-prettylights-syntax-comment:#8b949e;--color-prettylights-syntax-constant:#79c0ff;--color-prettylights-syntax-entity:#d2a8ff;--color-prettylights-syntax-storage-modifier-import:#c9d1d9;--color-prettylights-syntax-entity-tag:#7ee787;--color-prettylights-syntax-keyword:#ff7b72;--color-prettylights-syntax-string:#a5d6ff;--color-prettylights-syntax-variable:#ffa657;--color-prettylights-syntax-brackethighlighter-unmatched:#f85149;--color-prettylights-syntax-invalid-illegal-text:#f0f6fc;--color-prettylights-syntax-invalid-illegal-bg:#8e1519;--color-prettylights-syntax-carriage-return-text:#f0f6fc;--color-prettylights-syntax-carriage-return-bg:#b62324;--color-prettylights-syntax-string-regexp:#7ee787;--color-prettylights-syntax-markup-list:#f2cc60;--color-prettylights-syntax-markup-heading:#1f6feb;--color-prettylights-syntax-markup-italic:#c9d1d9;--color-prettylights-syntax-markup-bold:#c9d1d9;--color-prettylights-syntax-markup-deleted-text:#ffdcd7;--color-prettylights-syntax-markup-deleted-bg:#67060c;--color-prettylights-syntax-markup-inserted-text:#aff5b4;--color-prettylights-syntax-markup-inserted-bg:#033a16;--color-prettylights-syntax-markup-changed-text:#ffdfb6;--color-prettylights-syntax-markup-changed-bg:#5a1e02;--color-prettylights-syntax-markup-ignored-text:#c9d1d9;--color-prettylights-syntax-markup-ignored-bg:#1158c7;--color-prettylights-syntax-meta-diff-range:#d2a8ff;--color-prettylights-syntax-brackethighlighter-angle:#8b949e;--color-prettylights-syntax-sublimelinter-gutter-mark:#484f58;--color-prettylights-syntax-constant-other-reference-link:#a5d6ff;--color-fg-default:#e6edf3;--color-fg-muted:#7d8590;--color-fg-subtle:#6e7681;--color-canvas-default:#0d1117;--color-canvas-subtle:#161b22;--color-border-default:#30363d;--color-border-muted:#21262d;--color-neutral-muted:hsla(215,8%,47%,.4);--color-accent-fg:#2f81f7;--color-accent-emphasis:#1f6feb;--color-attention-subtle:rgba(187,128,9,.15);--color-danger-fg:#f85149;color-scheme:dark}div#\:\$p>svg>foreignObject>section{-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%;word-wrap:break-word;background-color:var(--color-canvas-default);color:var(--color-fg-default);font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Noto Sans,Helvetica,Arial,sans-serif,Apple Color Emoji,Segoe UI Emoji;font-size:16px;line-height:1.5;margin:0}div#\:\$p>svg>foreignObject>section{--marpit-root-font-size:16px}div#\:\$p>svg>foreignObject>section :is(h1,marp-h1):hover .anchor .octicon-link:before,div#\:\$p>svg>foreignObject>section :is(h2,marp-h2):hover .anchor .octicon-link:before,div#\:\$p>svg>foreignObject>section :is(h3,marp-h3):hover .anchor .octicon-link:before,div#\:\$p>svg>foreignObject>section :is(h4,marp-h4):hover .anchor .octicon-link:before,div#\:\$p>svg>foreignObject>section :is(h5,marp-h5):hover .anchor .octicon-link:before,div#\:\$p>svg>foreignObject>section :is(h6,marp-h6):hover .anchor .octicon-link:before{background-color:currentColor;content:" ";display:inline-block;height:16px;-webkit-mask-image:url('data:image/svg+xml;charset=utf-8,');mask-image:url('data:image/svg+xml;charset=utf-8,');width:16px}div#\:\$p>svg>foreignObject>section details,div#\:\$p>svg>foreignObject>section figcaption,div#\:\$p>svg>foreignObject>section figure{display:block}div#\:\$p>svg>foreignObject>section summary{display:list-item}div#\:\$p>svg>foreignObject>section [hidden]{display:none!important}div#\:\$p>svg>foreignObject>section a{background-color:transparent;color:var(--color-accent-fg);text-decoration:none}div#\:\$p>svg>foreignObject>section abbr[title]{border-bottom:none;-webkit-text-decoration:underline dotted;text-decoration:underline dotted}div#\:\$p>svg>foreignObject>section b,div#\:\$p>svg>foreignObject>section strong{font-weight:var(--base-text-weight-semibold,600)}div#\:\$p>svg>foreignObject>section dfn{font-style:italic}div#\:\$p>svg>foreignObject>section :is(h1,marp-h1){border-bottom:1px solid var(--color-border-muted);font-size:2em;font-weight:var(--base-text-weight-semibold,600);margin:.67em 0;padding-bottom:.3em}div#\:\$p>svg>foreignObject>section mark{background-color:var(--color-attention-subtle);color:var(--color-fg-default)}div#\:\$p>svg>foreignObject>section small{font-size:90%}div#\:\$p>svg>foreignObject>section sub,div#\:\$p>svg>foreignObject>section sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}div#\:\$p>svg>foreignObject>section sub{bottom:-.25em}div#\:\$p>svg>foreignObject>section sup{top:-.5em}div#\:\$p>svg>foreignObject>section img{background-color:var(--color-canvas-default);border-style:none;box-sizing:content-box;max-width:100%}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre),div#\:\$p>svg>foreignObject>section code,div#\:\$p>svg>foreignObject>section kbd,div#\:\$p>svg>foreignObject>section samp{font-family:monospace;font-size:1em}div#\:\$p>svg>foreignObject>section figure{margin:1em 40px}div#\:\$p>svg>foreignObject>section hr{background:transparent;background-color:var(--color-border-default);border:0;box-sizing:content-box;height:.25em;margin:24px 0;overflow:hidden;padding:0}div#\:\$p>svg>foreignObject>section input{font:inherit;font-family:inherit;font-size:inherit;line-height:inherit;margin:0;overflow:visible}div#\:\$p>svg>foreignObject>section [type=button],div#\:\$p>svg>foreignObject>section [type=reset],div#\:\$p>svg>foreignObject>section [type=submit]{-webkit-appearance:button}div#\:\$p>svg>foreignObject>section [type=checkbox],div#\:\$p>svg>foreignObject>section [type=radio]{box-sizing:border-box;padding:0}div#\:\$p>svg>foreignObject>section [type=number]::-webkit-inner-spin-button,div#\:\$p>svg>foreignObject>section [type=number]::-webkit-outer-spin-button{height:auto}div#\:\$p>svg>foreignObject>section [type=search]::-webkit-search-cancel-button,div#\:\$p>svg>foreignObject>section [type=search]::-webkit-search-decoration{-webkit-appearance:none}div#\:\$p>svg>foreignObject>section ::-webkit-input-placeholder{color:inherit;opacity:.54}div#\:\$p>svg>foreignObject>section ::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}div#\:\$p>svg>foreignObject>section a:hover{text-decoration:underline}div#\:\$p>svg>foreignObject>section ::-moz-placeholder{color:var(--color-fg-subtle);opacity:1}div#\:\$p>svg>foreignObject>section ::placeholder{color:var(--color-fg-subtle);opacity:1}div#\:\$p>svg>foreignObject>section hr:after,div#\:\$p>svg>foreignObject>section hr:before{content:"";display:table}div#\:\$p>svg>foreignObject>section hr:after{clear:both}div#\:\$p>svg>foreignObject>section table{border-collapse:collapse;border-spacing:0;display:block;max-width:100%;overflow:auto;width:-moz-max-content;width:max-content}div#\:\$p>svg>foreignObject>section td,div#\:\$p>svg>foreignObject>section th{padding:0}div#\:\$p>svg>foreignObject>section details summary{cursor:pointer}div#\:\$p>svg>foreignObject>section details:not([open])>:not(summary){display:none!important}div#\:\$p>svg>foreignObject>section [role=button]:focus,div#\:\$p>svg>foreignObject>section a:focus,div#\:\$p>svg>foreignObject>section input[type=checkbox]:focus,div#\:\$p>svg>foreignObject>section input[type=radio]:focus{box-shadow:none;outline:2px solid var(--color-accent-fg);outline-offset:-2px}div#\:\$p>svg>foreignObject>section [role=button]:focus:not(:focus-visible),div#\:\$p>svg>foreignObject>section a:focus:not(:focus-visible),div#\:\$p>svg>foreignObject>section input[type=checkbox]:focus:not(:focus-visible),div#\:\$p>svg>foreignObject>section input[type=radio]:focus:not(:focus-visible){outline:1px solid transparent}div#\:\$p>svg>foreignObject>section [role=button]:focus-visible,div#\:\$p>svg>foreignObject>section a:focus-visible,div#\:\$p>svg>foreignObject>section input[type=checkbox]:focus-visible,div#\:\$p>svg>foreignObject>section input[type=radio]:focus-visible{box-shadow:none;outline:2px solid var(--color-accent-fg);outline-offset:-2px}div#\:\$p>svg>foreignObject>section a:not([class]):focus,div#\:\$p>svg>foreignObject>section a:not([class]):focus-visible,div#\:\$p>svg>foreignObject>section input[type=checkbox]:focus,div#\:\$p>svg>foreignObject>section input[type=checkbox]:focus-visible,div#\:\$p>svg>foreignObject>section input[type=radio]:focus,div#\:\$p>svg>foreignObject>section input[type=radio]:focus-visible{outline-offset:0}div#\:\$p>svg>foreignObject>section kbd{background-color:var(--color-canvas-subtle);border-bottom-color:var(--color-neutral-muted);border:1px solid var(--color-neutral-muted);border-radius:6px;box-shadow:inset 0 -1px 0 var(--color-neutral-muted);color:var(--color-fg-default);display:inline-block;font:11px ui-monospace,SFMono-Regular,SF Mono,Menlo,Consolas,Liberation Mono,monospace;line-height:10px;padding:3px 5px;vertical-align:middle}div#\:\$p>svg>foreignObject>section :is(h1,marp-h1),div#\:\$p>svg>foreignObject>section :is(h2,marp-h2),div#\:\$p>svg>foreignObject>section :is(h3,marp-h3),div#\:\$p>svg>foreignObject>section :is(h4,marp-h4),div#\:\$p>svg>foreignObject>section :is(h5,marp-h5),div#\:\$p>svg>foreignObject>section :is(h6,marp-h6){font-weight:var(--base-text-weight-semibold,600);line-height:1.25;margin-bottom:16px;margin-top:24px}div#\:\$p>svg>foreignObject>section :is(h2,marp-h2){border-bottom:1px solid var(--color-border-muted);font-size:1.5em;padding-bottom:.3em}div#\:\$p>svg>foreignObject>section :is(h2,marp-h2),div#\:\$p>svg>foreignObject>section :is(h3,marp-h3){font-weight:var(--base-text-weight-semibold,600)}div#\:\$p>svg>foreignObject>section :is(h3,marp-h3){font-size:1.25em}div#\:\$p>svg>foreignObject>section :is(h4,marp-h4){font-size:1em}div#\:\$p>svg>foreignObject>section :is(h4,marp-h4),div#\:\$p>svg>foreignObject>section :is(h5,marp-h5){font-weight:var(--base-text-weight-semibold,600)}div#\:\$p>svg>foreignObject>section :is(h5,marp-h5){font-size:.875em}div#\:\$p>svg>foreignObject>section :is(h6,marp-h6){color:var(--color-fg-muted);font-size:.85em;font-weight:var(--base-text-weight-semibold,600)}div#\:\$p>svg>foreignObject>section p{margin-bottom:10px;margin-top:0}div#\:\$p>svg>foreignObject>section blockquote{border-left:.25em solid var(--color-border-default);color:var(--color-fg-muted);margin:0;padding:0 1em}div#\:\$p>svg>foreignObject>section ol,div#\:\$p>svg>foreignObject>section ul{margin-bottom:0;margin-top:0;padding-left:2em}div#\:\$p>svg>foreignObject>section ol ol,div#\:\$p>svg>foreignObject>section ul ol{list-style-type:lower-roman}div#\:\$p>svg>foreignObject>section ol ol ol,div#\:\$p>svg>foreignObject>section ol ul ol,div#\:\$p>svg>foreignObject>section ul ol ol,div#\:\$p>svg>foreignObject>section ul ul ol{list-style-type:lower-alpha}div#\:\$p>svg>foreignObject>section dd{margin-left:0}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre),div#\:\$p>svg>foreignObject>section code,div#\:\$p>svg>foreignObject>section samp,div#\:\$p>svg>foreignObject>section tt{font-family:ui-monospace,SFMono-Regular,SF Mono,Menlo,Consolas,Liberation Mono,monospace;font-size:12px}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre){word-wrap:normal;margin-bottom:0;margin-top:0}div#\:\$p>svg>foreignObject>section .octicon{fill:currentColor;display:inline-block;overflow:visible!important;vertical-align:text-bottom}div#\:\$p>svg>foreignObject>section input::-webkit-inner-spin-button,div#\:\$p>svg>foreignObject>section input::-webkit-outer-spin-button{-webkit-appearance:none;appearance:none;margin:0}div#\:\$p>svg>foreignObject>section:after,div#\:\$p>svg>foreignObject>section:before{ + /* content:""; */display:table}div#\:\$p>svg>foreignObject>section:after{clear:both}div#\:\$p>svg>foreignObject>section>:first-child{margin-top:0!important}div#\:\$p>svg>foreignObject>section>:last-child{margin-bottom:0!important}div#\:\$p>svg>foreignObject>section a:not([href]){color:inherit;text-decoration:none}div#\:\$p>svg>foreignObject>section .absent{color:var(--color-danger-fg)}div#\:\$p>svg>foreignObject>section .anchor{float:left;line-height:1;margin-left:-20px;padding-right:4px}div#\:\$p>svg>foreignObject>section .anchor:focus{outline:none}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre),div#\:\$p>svg>foreignObject>section blockquote,div#\:\$p>svg>foreignObject>section details,div#\:\$p>svg>foreignObject>section dl,div#\:\$p>svg>foreignObject>section ol,div#\:\$p>svg>foreignObject>section p,div#\:\$p>svg>foreignObject>section table,div#\:\$p>svg>foreignObject>section ul{margin-bottom:16px;margin-top:0}div#\:\$p>svg>foreignObject>section blockquote>:first-child{margin-top:0}div#\:\$p>svg>foreignObject>section blockquote>:last-child{margin-bottom:0}div#\:\$p>svg>foreignObject>section :is(h1,marp-h1) .octicon-link,div#\:\$p>svg>foreignObject>section :is(h2,marp-h2) .octicon-link,div#\:\$p>svg>foreignObject>section :is(h3,marp-h3) .octicon-link,div#\:\$p>svg>foreignObject>section :is(h4,marp-h4) .octicon-link,div#\:\$p>svg>foreignObject>section :is(h5,marp-h5) .octicon-link,div#\:\$p>svg>foreignObject>section :is(h6,marp-h6) .octicon-link{color:var(--color-fg-default);vertical-align:middle;visibility:hidden}div#\:\$p>svg>foreignObject>section :is(h1,marp-h1):hover .anchor,div#\:\$p>svg>foreignObject>section :is(h2,marp-h2):hover .anchor,div#\:\$p>svg>foreignObject>section :is(h3,marp-h3):hover .anchor,div#\:\$p>svg>foreignObject>section :is(h4,marp-h4):hover .anchor,div#\:\$p>svg>foreignObject>section :is(h5,marp-h5):hover .anchor,div#\:\$p>svg>foreignObject>section :is(h6,marp-h6):hover .anchor{text-decoration:none}div#\:\$p>svg>foreignObject>section :is(h1,marp-h1):hover .anchor .octicon-link,div#\:\$p>svg>foreignObject>section :is(h2,marp-h2):hover .anchor .octicon-link,div#\:\$p>svg>foreignObject>section :is(h3,marp-h3):hover .anchor .octicon-link,div#\:\$p>svg>foreignObject>section :is(h4,marp-h4):hover .anchor .octicon-link,div#\:\$p>svg>foreignObject>section :is(h5,marp-h5):hover .anchor .octicon-link,div#\:\$p>svg>foreignObject>section :is(h6,marp-h6):hover .anchor .octicon-link{visibility:visible}div#\:\$p>svg>foreignObject>section :is(h1,marp-h1) code,div#\:\$p>svg>foreignObject>section :is(h1,marp-h1) tt,div#\:\$p>svg>foreignObject>section :is(h2,marp-h2) code,div#\:\$p>svg>foreignObject>section :is(h2,marp-h2) tt,div#\:\$p>svg>foreignObject>section :is(h3,marp-h3) code,div#\:\$p>svg>foreignObject>section :is(h3,marp-h3) tt,div#\:\$p>svg>foreignObject>section :is(h4,marp-h4) code,div#\:\$p>svg>foreignObject>section :is(h4,marp-h4) tt,div#\:\$p>svg>foreignObject>section :is(h5,marp-h5) code,div#\:\$p>svg>foreignObject>section :is(h5,marp-h5) tt,div#\:\$p>svg>foreignObject>section :is(h6,marp-h6) code,div#\:\$p>svg>foreignObject>section :is(h6,marp-h6) tt{font-size:inherit;padding:0 .2em}div#\:\$p>svg>foreignObject>section summary :is(h1,marp-h1),div#\:\$p>svg>foreignObject>section summary :is(h2,marp-h2),div#\:\$p>svg>foreignObject>section summary :is(h3,marp-h3),div#\:\$p>svg>foreignObject>section summary :is(h4,marp-h4),div#\:\$p>svg>foreignObject>section summary :is(h5,marp-h5),div#\:\$p>svg>foreignObject>section summary :is(h6,marp-h6){display:inline-block}div#\:\$p>svg>foreignObject>section summary :is(h1,marp-h1) .anchor,div#\:\$p>svg>foreignObject>section summary :is(h2,marp-h2) .anchor,div#\:\$p>svg>foreignObject>section summary :is(h3,marp-h3) .anchor,div#\:\$p>svg>foreignObject>section summary :is(h4,marp-h4) .anchor,div#\:\$p>svg>foreignObject>section summary :is(h5,marp-h5) .anchor,div#\:\$p>svg>foreignObject>section summary :is(h6,marp-h6) .anchor{margin-left:-40px}div#\:\$p>svg>foreignObject>section summary :is(h1,marp-h1),div#\:\$p>svg>foreignObject>section summary :is(h2,marp-h2){border-bottom:0;padding-bottom:0}div#\:\$p>svg>foreignObject>section ol.no-list,div#\:\$p>svg>foreignObject>section ul.no-list{list-style-type:none;padding:0}div#\:\$p>svg>foreignObject>section ol[type="a s"]{list-style-type:lower-alpha}div#\:\$p>svg>foreignObject>section ol[type="A s"]{list-style-type:upper-alpha}div#\:\$p>svg>foreignObject>section ol[type="i s"]{list-style-type:lower-roman}div#\:\$p>svg>foreignObject>section ol[type="I s"]{list-style-type:upper-roman}div#\:\$p>svg>foreignObject>section div>ol:not([type]),div#\:\$p>svg>foreignObject>section ol[type="1"]{list-style-type:decimal}div#\:\$p>svg>foreignObject>section ol ol,div#\:\$p>svg>foreignObject>section ol ul,div#\:\$p>svg>foreignObject>section ul ol,div#\:\$p>svg>foreignObject>section ul ul{margin-bottom:0;margin-top:0}div#\:\$p>svg>foreignObject>section li>p{margin-top:16px}div#\:\$p>svg>foreignObject>section li+li{margin-top:.25em}div#\:\$p>svg>foreignObject>section dl{padding:0}div#\:\$p>svg>foreignObject>section dl dt{font-size:1em;font-style:italic;font-weight:var(--base-text-weight-semibold,600);margin-top:16px;padding:0}div#\:\$p>svg>foreignObject>section dl dd{margin-bottom:16px;padding:0 16px}div#\:\$p>svg>foreignObject>section table th{font-weight:var(--base-text-weight-semibold,600)}div#\:\$p>svg>foreignObject>section table td,div#\:\$p>svg>foreignObject>section table th{border:1px solid var(--color-border-default);padding:6px 13px}div#\:\$p>svg>foreignObject>section table td>:last-child{margin-bottom:0}div#\:\$p>svg>foreignObject>section table tr{background-color:var(--color-canvas-default);border-top:1px solid var(--color-border-muted)}div#\:\$p>svg>foreignObject>section table tr:nth-child(2n){background-color:var(--color-canvas-subtle)}div#\:\$p>svg>foreignObject>section table img{background-color:transparent}div#\:\$p>svg>foreignObject>section img[align=right]{padding-left:20px}div#\:\$p>svg>foreignObject>section img[align=left]{padding-right:20px}div#\:\$p>svg>foreignObject>section .emoji{background-color:transparent;max-width:none;vertical-align:text-top}div#\:\$p>svg>foreignObject>section :is(span,marp-span).frame,div#\:\$p>svg>foreignObject>section :is(span,marp-span).frame>:is(span,marp-span){display:block;overflow:hidden}div#\:\$p>svg>foreignObject>section :is(span,marp-span).frame>:is(span,marp-span){border:1px solid var(--color-border-default);float:left;margin:13px 0 0;padding:7px;width:auto}div#\:\$p>svg>foreignObject>section :is(span,marp-span).frame :is(span,marp-span) img{display:block;float:left}div#\:\$p>svg>foreignObject>section :is(span,marp-span).frame :is(span,marp-span) :is(span,marp-span){clear:both;color:var(--color-fg-default);display:block;padding:5px 0 0}div#\:\$p>svg>foreignObject>section :is(span,marp-span).align-center{clear:both;display:block;overflow:hidden}div#\:\$p>svg>foreignObject>section :is(span,marp-span).align-center>:is(span,marp-span){display:block;margin:13px auto 0;overflow:hidden;text-align:center}div#\:\$p>svg>foreignObject>section :is(span,marp-span).align-center :is(span,marp-span) img{margin:0 auto;text-align:center}div#\:\$p>svg>foreignObject>section :is(span,marp-span).align-right{clear:both;display:block;overflow:hidden}div#\:\$p>svg>foreignObject>section :is(span,marp-span).align-right>:is(span,marp-span){display:block;margin:13px 0 0;overflow:hidden;text-align:right}div#\:\$p>svg>foreignObject>section :is(span,marp-span).align-right :is(span,marp-span) img{margin:0;text-align:right}div#\:\$p>svg>foreignObject>section :is(span,marp-span).float-left{display:block;float:left;margin-right:13px;overflow:hidden}div#\:\$p>svg>foreignObject>section :is(span,marp-span).float-left :is(span,marp-span){margin:13px 0 0}div#\:\$p>svg>foreignObject>section :is(span,marp-span).float-right{display:block;float:right;margin-left:13px;overflow:hidden}div#\:\$p>svg>foreignObject>section :is(span,marp-span).float-right>:is(span,marp-span){display:block;margin:13px auto 0;overflow:hidden;text-align:right}div#\:\$p>svg>foreignObject>section code,div#\:\$p>svg>foreignObject>section tt{background-color:var(--color-neutral-muted);border-radius:6px;font-size:85%;margin:0;padding:.2em .4em;white-space:break-spaces}div#\:\$p>svg>foreignObject>section code br,div#\:\$p>svg>foreignObject>section tt br{display:none}div#\:\$p>svg>foreignObject>section del code{text-decoration:inherit}div#\:\$p>svg>foreignObject>section samp{font-size:85%}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) code{font-size:100%}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre)>code{background:transparent;border:0;margin:0;padding:0;white-space:pre;word-break:normal}div#\:\$p>svg>foreignObject>section .highlight{margin-bottom:16px}div#\:\$p>svg>foreignObject>section .highlight :is(pre,marp-pre){margin-bottom:0;word-break:normal}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre){background-color:var(--color-canvas-subtle);border-radius:6px;color:var(--color-fg-default);font-size:85%;line-height:1.45;overflow:auto;padding:16px}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) code,div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) tt{word-wrap:normal;background-color:transparent;border:0;display:inline;line-height:inherit;margin:0;max-width:auto;overflow:visible;padding:0}div#\:\$p>svg>foreignObject>section .csv-data td,div#\:\$p>svg>foreignObject>section .csv-data th{font-size:12px;line-height:1;overflow:hidden;padding:5px;text-align:left;white-space:nowrap}div#\:\$p>svg>foreignObject>section .csv-data .blob-num{background:var(--color-canvas-default);border:0;padding:10px 8px 9px;text-align:right}div#\:\$p>svg>foreignObject>section .csv-data tr{border-top:0}div#\:\$p>svg>foreignObject>section .csv-data th{background:var(--color-canvas-subtle);border-top:0;font-weight:var(--base-text-weight-semibold,600)}div#\:\$p>svg>foreignObject>section [data-footnote-ref]:before{content:"["}div#\:\$p>svg>foreignObject>section [data-footnote-ref]:after{content:"]"}div#\:\$p>svg>foreignObject>section .footnotes{border-top:1px solid var(--color-border-default);color:var(--color-fg-muted);font-size:12px}div#\:\$p>svg>foreignObject>section div#\:\$p>svg>foreignObject>section section.footnotes{--marpit-root-font-size:12px}div#\:\$p>svg>foreignObject>section .footnotes ol{padding-left:16px}div#\:\$p>svg>foreignObject>section .footnotes ol ul{display:inline-block;margin-top:16px;padding-left:16px}div#\:\$p>svg>foreignObject>section .footnotes li{position:relative}div#\:\$p>svg>foreignObject>section .footnotes li:target:before{border:2px solid var(--color-accent-emphasis);border-radius:6px;bottom:-8px;content:"";left:-24px;pointer-events:none;position:absolute;right:-8px;top:-8px}div#\:\$p>svg>foreignObject>section .footnotes li:target{color:var(--color-fg-default)}div#\:\$p>svg>foreignObject>section .footnotes .data-footnote-backref g-emoji{font-family:monospace}div#\:\$p>svg>foreignObject>section .pl-c{color:var(--color-prettylights-syntax-comment)}div#\:\$p>svg>foreignObject>section .pl-c1,div#\:\$p>svg>foreignObject>section .pl-s .pl-v{color:var(--color-prettylights-syntax-constant)}div#\:\$p>svg>foreignObject>section .pl-e,div#\:\$p>svg>foreignObject>section .pl-en{color:var(--color-prettylights-syntax-entity)}div#\:\$p>svg>foreignObject>section .pl-s .pl-s1,div#\:\$p>svg>foreignObject>section .pl-smi{color:var(--color-prettylights-syntax-storage-modifier-import)}div#\:\$p>svg>foreignObject>section .pl-ent{color:var(--color-prettylights-syntax-entity-tag)}div#\:\$p>svg>foreignObject>section .pl-k{color:var(--color-prettylights-syntax-keyword)}div#\:\$p>svg>foreignObject>section .pl-pds,div#\:\$p>svg>foreignObject>section .pl-s,div#\:\$p>svg>foreignObject>section .pl-s .pl-pse .pl-s1,div#\:\$p>svg>foreignObject>section .pl-sr,div#\:\$p>svg>foreignObject>section .pl-sr .pl-cce,div#\:\$p>svg>foreignObject>section .pl-sr .pl-sra,div#\:\$p>svg>foreignObject>section .pl-sr .pl-sre{color:var(--color-prettylights-syntax-string)}div#\:\$p>svg>foreignObject>section .pl-smw,div#\:\$p>svg>foreignObject>section .pl-v{color:var(--color-prettylights-syntax-variable)}div#\:\$p>svg>foreignObject>section .pl-bu{color:var(--color-prettylights-syntax-brackethighlighter-unmatched)}div#\:\$p>svg>foreignObject>section .pl-ii{background-color:var(--color-prettylights-syntax-invalid-illegal-bg);color:var(--color-prettylights-syntax-invalid-illegal-text)}div#\:\$p>svg>foreignObject>section .pl-c2{background-color:var(--color-prettylights-syntax-carriage-return-bg);color:var(--color-prettylights-syntax-carriage-return-text)}div#\:\$p>svg>foreignObject>section .pl-sr .pl-cce{color:var(--color-prettylights-syntax-string-regexp);font-weight:700}div#\:\$p>svg>foreignObject>section .pl-ml{color:var(--color-prettylights-syntax-markup-list)}div#\:\$p>svg>foreignObject>section .pl-mh,div#\:\$p>svg>foreignObject>section .pl-mh .pl-en,div#\:\$p>svg>foreignObject>section .pl-ms{color:var(--color-prettylights-syntax-markup-heading);font-weight:700}div#\:\$p>svg>foreignObject>section .pl-mi{color:var(--color-prettylights-syntax-markup-italic);font-style:italic}div#\:\$p>svg>foreignObject>section .pl-mb{color:var(--color-prettylights-syntax-markup-bold);font-weight:700}div#\:\$p>svg>foreignObject>section .pl-md{background-color:var(--color-prettylights-syntax-markup-deleted-bg);color:var(--color-prettylights-syntax-markup-deleted-text)}div#\:\$p>svg>foreignObject>section .pl-mi1{background-color:var(--color-prettylights-syntax-markup-inserted-bg);color:var(--color-prettylights-syntax-markup-inserted-text)}div#\:\$p>svg>foreignObject>section .pl-mc{background-color:var(--color-prettylights-syntax-markup-changed-bg);color:var(--color-prettylights-syntax-markup-changed-text)}div#\:\$p>svg>foreignObject>section .pl-mi2{background-color:var(--color-prettylights-syntax-markup-ignored-bg);color:var(--color-prettylights-syntax-markup-ignored-text)}div#\:\$p>svg>foreignObject>section .pl-mdr{color:var(--color-prettylights-syntax-meta-diff-range);font-weight:700}div#\:\$p>svg>foreignObject>section .pl-ba{color:var(--color-prettylights-syntax-brackethighlighter-angle)}div#\:\$p>svg>foreignObject>section .pl-sg{color:var(--color-prettylights-syntax-sublimelinter-gutter-mark)}div#\:\$p>svg>foreignObject>section .pl-corl{color:var(--color-prettylights-syntax-constant-other-reference-link);text-decoration:underline}div#\:\$p>svg>foreignObject>section g-emoji{display:inline-block;font-family:Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol;font-size:1em;font-style:normal!important;font-weight:var(--base-text-weight-normal,400);line-height:1;min-width:1ch;vertical-align:-.075em}div#\:\$p>svg>foreignObject>section g-emoji img{height:1em;width:1em}div#\:\$p>svg>foreignObject>section .task-list-item{list-style-type:none}div#\:\$p>svg>foreignObject>section .task-list-item label{font-weight:var(--base-text-weight-normal,400)}div#\:\$p>svg>foreignObject>section .task-list-item.enabled label{cursor:pointer}div#\:\$p>svg>foreignObject>section .task-list-item+.task-list-item{margin-top:4px}div#\:\$p>svg>foreignObject>section .task-list-item .handle{display:none}div#\:\$p>svg>foreignObject>section .task-list-item-checkbox{margin:0 .2em .25em -1.4em;vertical-align:middle}div#\:\$p>svg>foreignObject>section .contains-task-list:dir(rtl) .task-list-item-checkbox{margin:0 -1.6em .25em .2em}div#\:\$p>svg>foreignObject>section .contains-task-list{position:relative}div#\:\$p>svg>foreignObject>section .contains-task-list:focus-within .task-list-item-convert-container,div#\:\$p>svg>foreignObject>section .contains-task-list:hover .task-list-item-convert-container{clip:auto;display:block;height:24px;overflow:visible;width:auto}div#\:\$p>svg>foreignObject>section ::-webkit-calendar-picker-indicator{filter:invert(50%)}div#\:\$p>svg>foreignObject>section :is(h1,marp-h1){color:var(--h1-color);font-size:1.6em}div#\:\$p>svg>foreignObject>section :is(h1,marp-h1),div#\:\$p>svg>foreignObject>section :is(h2,marp-h2){border-bottom:none}div#\:\$p>svg>foreignObject>section :is(h2,marp-h2){font-size:1.3em}div#\:\$p>svg>foreignObject>section :is(h3,marp-h3){font-size:1.1em}div#\:\$p>svg>foreignObject>section :is(h4,marp-h4){font-size:1.05em}div#\:\$p>svg>foreignObject>section :is(h5,marp-h5){font-size:1em}div#\:\$p>svg>foreignObject>section :is(h6,marp-h6){font-size:.9em}div#\:\$p>svg>foreignObject>section :is(h1,marp-h1) strong,div#\:\$p>svg>foreignObject>section :is(h2,marp-h2) strong,div#\:\$p>svg>foreignObject>section :is(h3,marp-h3) strong,div#\:\$p>svg>foreignObject>section :is(h4,marp-h4) strong,div#\:\$p>svg>foreignObject>section :is(h5,marp-h5) strong,div#\:\$p>svg>foreignObject>section :is(h6,marp-h6) strong{color:var(--heading-strong-color);font-weight:inherit}div#\:\$p>svg>foreignObject>section :is(h1,marp-h1)::part(auto-scaling),div#\:\$p>svg>foreignObject>section :is(h2,marp-h2)::part(auto-scaling),div#\:\$p>svg>foreignObject>section :is(h3,marp-h3)::part(auto-scaling),div#\:\$p>svg>foreignObject>section :is(h4,marp-h4)::part(auto-scaling),div#\:\$p>svg>foreignObject>section :is(h5,marp-h5)::part(auto-scaling),div#\:\$p>svg>foreignObject>section :is(h6,marp-h6)::part(auto-scaling){max-height:563px}div#\:\$p>svg>foreignObject>section hr{height:0;padding-top:.25em}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre){border:1px solid var(--color-border-default);line-height:1.15;overflow:visible}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre)::part(auto-scaling){max-height:529px}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs){color:var(--color-prettylights-syntax-storage-modifier-import)}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-doctag),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-keyword),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-meta .hljs-keyword),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-template-tag),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-template-variable),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-type),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-variable.language_){color:var(--color-prettylights-syntax-keyword)}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-title),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-title.class_),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-title.class_.inherited__),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-title.function_){color:var(--color-prettylights-syntax-entity)}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-attr),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-attribute),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-literal),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-meta),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-number),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-operator),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-selector-attr),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-selector-class),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-selector-id),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-variable){color:var(--color-prettylights-syntax-constant)}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-meta .hljs-string),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-regexp),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-string){color:var(--color-prettylights-syntax-string)}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-built_in),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-symbol){color:var(--color-prettylights-syntax-variable)}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-code),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-comment),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-formula){color:var(--color-prettylights-syntax-comment)}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-name),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-quote),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-selector-pseudo),div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-selector-tag){color:var(--color-prettylights-syntax-entity-tag)}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-subst){color:var(--color-prettylights-syntax-storage-modifier-import)}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-section){color:var(--color-prettylights-syntax-markup-heading);font-weight:700}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-bullet){color:var(--color-prettylights-syntax-markup-list)}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-emphasis){color:var(--color-prettylights-syntax-markup-italic);font-style:italic}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-strong){color:var(--color-prettylights-syntax-markup-bold);font-weight:700}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-addition){background-color:var(--color-prettylights-syntax-markup-inserted-bg);color:var(--color-prettylights-syntax-markup-inserted-text)}div#\:\$p>svg>foreignObject>section :is(pre,marp-pre) :where(.hljs-deletion){background-color:var(--color-prettylights-syntax-markup-deleted-bg);color:var(--color-prettylights-syntax-markup-deleted-text)}div#\:\$p>svg>foreignObject>section footer,div#\:\$p>svg>foreignObject>section header{color:var(--header-footer-color);font-size:18px;left:30px;margin:0;position:absolute}div#\:\$p>svg>foreignObject>section header{top:21px}div#\:\$p>svg>foreignObject>section footer{bottom:21px}div#\:\$p>svg>foreignObject>section{--h1-color:#246;--header-footer-color:hsla(0,0%,40%,.75);--heading-strong-color:#48c;--paginate-color:#777;align-items:stretch;display:flex;flex-flow:column nowrap;font-size:29px;height:720px;justify-content:center;padding:78.5px;width:1280px}div#\:\$p>svg>foreignObject>section{--marpit-root-font-size:29px}div#\:\$p>svg>foreignObject>section:where(.invert){--h1-color:#cee7ff;--header-footer-color:hsla(0,0%,60%,.75);--heading-strong-color:#7bf;--paginate-color:#999}div#\:\$p>svg>foreignObject>section>:last-child,div#\:\$p>svg>foreignObject>section[data-footer]>:nth-last-child(2){margin-bottom:0}div#\:\$p>svg>foreignObject>section>:first-child,div#\:\$p>svg>foreignObject>section>header:first-child+*{margin-top:0}div#\:\$p>svg>foreignObject>section:after{bottom:21px;color:var(--paginate-color);font-size:24px;padding:0;position:absolute;right:30px}div#\:\$p>svg>foreignObject>section:after{--marpit-root-font-size:24px}div#\:\$p>svg>foreignObject>section[data-color] :is(h1,marp-h1),div#\:\$p>svg>foreignObject>section[data-color] :is(h2,marp-h2),div#\:\$p>svg>foreignObject>section[data-color] :is(h3,marp-h3),div#\:\$p>svg>foreignObject>section[data-color] :is(h4,marp-h4),div#\:\$p>svg>foreignObject>section[data-color] :is(h5,marp-h5),div#\:\$p>svg>foreignObject>section[data-color] :is(h6,marp-h6){color:currentcolor}div#\:\$p>svg>foreignObject>:where(section){container-type:size}div#\:\$p>svg>foreignObject>section mjx-container[jax=SVG]{direction:ltr}div#\:\$p>svg>foreignObject>section mjx-container[jax=SVG]>svg{overflow:visible;min-height:1px;min-width:1px}div#\:\$p>svg>foreignObject>section mjx-container[jax=SVG]>svg a{fill:blue;stroke:blue}div#\:\$p>svg>foreignObject>section mjx-container[jax=SVG][display=true]{display:block;text-align:center;margin:1em 0}div#\:\$p>svg>foreignObject>section mjx-container[jax=SVG][display=true][width=full]{display:flex}div#\:\$p>svg>foreignObject>section mjx-container[jax=SVG][justify=left]{text-align:left}div#\:\$p>svg>foreignObject>section mjx-container[jax=SVG][justify=right]{text-align:right}div#\:\$p>svg>foreignObject>section g[data-mml-node=merror]>g{fill:red;stroke:red}div#\:\$p>svg>foreignObject>section g[data-mml-node=merror]>rect[data-background]{fill:yellow;stroke:none}div#\:\$p>svg>foreignObject>section g[data-mml-node=mtable]>line[data-line],div#\:\$p>svg>foreignObject>section svg[data-table]>g>line[data-line]{stroke-width:70px;fill:none}div#\:\$p>svg>foreignObject>section g[data-mml-node=mtable]>rect[data-frame],div#\:\$p>svg>foreignObject>section svg[data-table]>g>rect[data-frame]{stroke-width:70px;fill:none}div#\:\$p>svg>foreignObject>section g[data-mml-node=mtable]>.mjx-dashed,div#\:\$p>svg>foreignObject>section svg[data-table]>g>.mjx-dashed{stroke-dasharray:140}div#\:\$p>svg>foreignObject>section g[data-mml-node=mtable]>.mjx-dotted,div#\:\$p>svg>foreignObject>section svg[data-table]>g>.mjx-dotted{stroke-linecap:round;stroke-dasharray:0,140}div#\:\$p>svg>foreignObject>section g[data-mml-node=mtable]>g>svg{overflow:visible}div#\:\$p>svg>foreignObject>section [jax=SVG] mjx-tool{display:inline-block;position:relative;width:0;height:0}div#\:\$p>svg>foreignObject>section [jax=SVG] mjx-tool>mjx-tip{position:absolute;top:0;left:0}div#\:\$p>svg>foreignObject>section mjx-tool>mjx-tip{display:inline-block;padding:.2em;border:1px solid #888;font-size:70%;background-color:#F8F8F8;color:black;box-shadow:2px 2px 5px #AAAAAA}div#\:\$p>svg>foreignObject>section g[data-mml-node=maction][data-toggle]{cursor:pointer}div#\:\$p>svg>foreignObject>section mjx-status{display:block;position:fixed;left:1em;bottom:1em;min-width:25%;padding:.2em .4em;border:1px solid #888;font-size:90%;background-color:#F8F8F8;color:black}div#\:\$p>svg>foreignObject>section foreignObject[data-mjx-xml]{font-family:initial;line-height:normal;overflow:visible}div#\:\$p>svg>foreignObject>section mjx-container[jax=SVG] path[data-c],div#\:\$p>svg>foreignObject>section mjx-container[jax=SVG] use[data-c]{stroke-width:3}@media print{div#\:\$p>svg>foreignObject>section mjx-container[jax=SVG] path[data-c],div#\:\$p>svg>foreignObject>section mjx-container[jax=SVG] use[data-c]{stroke-width:0}}div#\:\$p>svg>foreignObject>section img[data-marp-twemoji]{background:transparent;height:1em;margin:0 .05em 0 .1em;vertical-align:-.1em;width:1em} +/* buutti.css */ +/* @theme buutti */div#\:\$p>svg>foreignObject>section .columns{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:calc(var(--marpit-root-font-size, 1rem) * 1)}div#\:\$p>svg>foreignObject>section .columns12{display:grid;grid-template-columns:1fr 2fr;gap:calc(var(--marpit-root-font-size, 1rem) * 1)}div#\:\$p>svg>foreignObject>section .columns21{display:grid;grid-template-columns:2fr 1fr;gap:calc(var(--marpit-root-font-size, 1rem) * 1)}div#\:\$p>svg>foreignObject>section .columns32{display:grid;grid-template-columns:3fr 2fr;gap:calc(var(--marpit-root-font-size, 1rem) * 1)}div#\:\$p>svg>foreignObject>section .columns23{display:grid;grid-template-columns:2fr 3fr;gap:calc(var(--marpit-root-font-size, 1rem) * 1)}div#\:\$p>svg>foreignObject>section .columns111{display:grid;grid-template-columns:1fr 1fr 1fr;gap:calc(var(--marpit-root-font-size, 1rem) * 1)}div#\:\$p>svg>foreignObject>section .centered{display:flex;flex-direction:column;justify-content:center;text-align:center}div#\:\$p>svg>foreignObject>section .tableborderless td,div#\:\$p>svg>foreignObject>section th{border:none!important;border-collapse:collapse}div#\:\$p>svg>foreignObject>section.extra{background-color:#5d275d;background-image:linear-gradient(to bottom,#401a40,#1d0c1d);color:white}div#\:\$p>svg>foreignObject>section.extra a{color:rgb(145,255,209)}div#\:\$p>svg>foreignObject>section.exercise{background-color:#29366f;background-image:linear-gradient(to bottom,#20636a,#173742);color:white}div#\:\$p>svg>foreignObject>section.exercise a{color:rgb(211,173,255)} -

Start a local instance of Postgres in Docker

-

Connect to the server using psql

-

Use command \l to see what databases there are already created on the server.

-

Create a new database called "sqlpractice".

-

Connect to the newly created database.

-
-
-

pgAdmin

-

Administration and development platform for PostgreSQL

-

Cross-platform, features a web interface

-

Basically a control panel application for your PostgreSQL database

-

A graphical alternative to psql

-

Completely separate from PostgreSQL, so pgAdmin is not required for using PostgreSQL. It is only one example of how you can administer the database. Other options include the forementioned psql and a wide variety of other database management tools, like DBeaver.

-
-
-

Running pgAdmin in Docker

-

Using the official pgAdmin image, we'll run pgAdmin alongside Postgres

-
docker run --name my-pgadmin -p 5050:80 
---env PGADMIN_DEFAULT_EMAIL=<your-email-address> 
---env PGADMIN_DEFAULT_PASSWORD=<your-password> 
--d dpage/pgadmin4
-
-

-
-
-

Logging into pgAdmin

-

With pgAdmin running, navigate your web browser to http://localhost:5050 and use the username and password you provided to log in.

-

-
-
-

PostgreSQL internal IP Address

-

Both PostgreSQL and pgAdmin are now running in our local Docker. To connect pgAdmin to PostgreSQL, we need the IP address used inside Docker.

-

Using Docker's inspect, we'll get Docker's internal IP for my-postgres -container. Since the command produces quite a lot of information, we pipe the result to grep (Linux) or findstr (Windows), to see only the rows that contain the word "IPAddress"

-
docker inspect <container-name> | grep IPAddress
-docker inspect <container-name> | findstr IPAddress
-
-

In the example output, the IP Address is 172.17.0.2

-

-
-
-

Connecting PgAdmin to our DB

-

Now we have all that we need for a connection. In pgAdmin, select "Object" > "Register" > "Server".

-

In the "General" tab, give the server a name that identifies the connection.

-

-
-
-

If Object menu is greyed out, click on Servers.

-

-
-
-
    -
  • In the "Connection" tab, enter
    • -
  • Host name/address: -
      -
    • the PostgreSQL internal Docker address
      • -
    -
    • -
  • Port, Username, Password -
      -
    • the values defined when running the PostgreSQL container
      • -
    -
    • -
  • Then click Save. You should now see all the databases available on this server.
    • -
-
-
-

-
-
-

-
-
-

Exercise 2: pgAdmin

- -

Start a local instance of pgAdmin in Docker

-

Following lecture instructions, connect the pgAdmin to your already running PostgreSQL server.

-

Verify that you can see the database created in the previous assignment.

-
-
-

PostgreSQL: Querying

-

With psql: After connecting to a database, just type a query and hit enter.

-

With pgAdmin:

-

Right-click a database > Query tool

-

Insert a query into the Query Editor and hit Execute (F5)

-

-
-
-

-
-
-

Editing Data with pgAdmin

-
    -
  • Tables of Data in a DataBase are found under -
      -
    • Database > Schemas > Tables
      • -
    -
    • -
  • Inspect and edit data in pgAdmin by right-clicking a table and selecting View/Edit Data
    • -
-
-
-

-
-
-

-

Individual values in the table can be directly modified by double clicking the value and then editing the value in the visual user interface

-

Save the changes with the Save Data Changes button

-

-
-
-

Exercise 3: Preparing the Database

- -

Using either PgAdmin or PSQL

-

Insert the provided query to the database you created previously.

-

Verify that the query has created new tables to your database.

-
-
-

Types of queries

-
    -
  • Select
    • -
  • Insert
    • -
  • Delete
    • -
  • Update
    • -
  • Create & Drop
    • -
-
-
-

Querying data with SELECT

-

Syntax:

-
SELECT column1, column2, column3 FROM table_name;
-
-

Examples:

-
    -
  • SELECT full_name, email FROM users;
    • -
  • SELECT full_name AS name, email FROM users;
    • -
  • SELECT * FROM users;
    • -
-
-
-

Filtering data with WHERE

-

Syntax:

-
SELECT column1, column2 FROM table_name WHERE condition;
-
-

Text is captured in single quotes. In a LIKE condition, % sign acts as a wildcard. IS and IS NOT are also valid comparison operators.

-

Example:

-
    -
  • SELECT full_name FROM users;
    • -
  • WHERE full_name = 'Teppo Testaaja';
    • -
  • SELECT * FROM books WHERE name LIKE '%rr%';
    • -
  • SELECT * FROM books WHERE author IS NOT null;
    • -
-
-
-

Ordering data with ORDER BY

-

Syntax:

-
SELECT column1 FROM table_name ORDER BY column1 ASC;
-
-

Examples:

-
    -
  • SELECT full_name FROM users ORDER BY full_name ASC;
    • -
  • SELECT full_name FROM users ORDER BY full_name DESC
    • -
-
-
-

Combining with JOIN

-

Also known as INNER JOIN

-

Corresponds to intersection from set theory

-

-
-
-

JOIN examples

-
SELECT users.id, users.full_name, borrows.id, borrows.user_id,
-borrows.due_date, borrows.returned_at
-FROM users JOIN borrows ON users.id = borrows.user_id;
-
-
SELECT U.full_name AS name, B.due_date AS due_date, B.returned_at AS returned_at
-FROM users AS U JOIN borrows AS B ON U.id = B.user_id;
-
-
-
-

Exercise 4: Querying the Library

- -

Using SQL queries, get

-
    -
  1. All columns from loans that are loaned before 1.3.2000
    2. -
  2. All columns of loans that are returned
    3. -
  3. Columns user.full_name and borrows.borrowed_at of the user with an id of 1
    4. -
  4. Columns book.name, book.release_year and language.name of all books that are released after 1960
    5. -
-
-
-

INSERT

-

Syntax

-
INSERT INTO table_name (column1, column2, column3) VALUES (value1, value2, value3);
-
-

Example

-
    -
  • INSERT INTO users (full_name, email, created_at) VALUES ('Pekka Poistuja', 'pekka.poistuja@buutti.com', NOW());
    • -
-

Since id is not provided, it will be automatically generated.

-
-
-

UPDATE

-

Syntax

-
UPDATE table_nameSET column1 = value1, column2 = value2 WHERE condition;
-
-

Notice: if a condition is not provided, all rows will be updated! If updating only one row, it is usually best to use id.

-

Example

-
    -
  • UPDATE usersSET email = 'taija.testaaja@gmail.com' WHERE id = 2;
    • -
+/* @theme ygw6410gw2b9ab9z234e3tkm8fko5doymheqlutm14r */div#\:\$p>svg>foreignObject>section[data-marpit-advanced-background=background]{columns:initial!important;display:block!important;padding:0!important}div#\:\$p>svg>foreignObject>section[data-marpit-advanced-background=background]:after,div#\:\$p>svg>foreignObject>section[data-marpit-advanced-background=background]:before,div#\:\$p>svg>foreignObject>section[data-marpit-advanced-background=content]:after,div#\:\$p>svg>foreignObject>section[data-marpit-advanced-background=content]:before{display:none!important}div#\:\$p>svg>foreignObject>section[data-marpit-advanced-background=background]>div[data-marpit-advanced-background-container]{all:initial;display:flex;flex-direction:row;height:100%;overflow:hidden;width:100%}div#\:\$p>svg>foreignObject>section[data-marpit-advanced-background=background]>div[data-marpit-advanced-background-container][data-marpit-advanced-background-direction=vertical]{flex-direction:column}div#\:\$p>svg>foreignObject>section[data-marpit-advanced-background=background][data-marpit-advanced-background-split]>div[data-marpit-advanced-background-container]{width:var(--marpit-advanced-background-split,50%)}div#\:\$p>svg>foreignObject>section[data-marpit-advanced-background=background][data-marpit-advanced-background-split=right]>div[data-marpit-advanced-background-container]{margin-left:calc(100% - var(--marpit-advanced-background-split, 50%))}div#\:\$p>svg>foreignObject>section[data-marpit-advanced-background=background]>div[data-marpit-advanced-background-container]>figure{all:initial;background-position:center;background-repeat:no-repeat;background-size:cover;flex:auto;margin:0}div#\:\$p>svg>foreignObject>section[data-marpit-advanced-background=background]>div[data-marpit-advanced-background-container]>figure>figcaption{position:absolute;border:0;clip:rect(0,0,0,0);height:1px;margin:-1px;overflow:hidden;padding:0;white-space:nowrap;width:1px}div#\:\$p>svg>foreignObject>section[data-marpit-advanced-background=content],div#\:\$p>svg>foreignObject>section[data-marpit-advanced-background=pseudo]{background:transparent!important}div#\:\$p>svg>foreignObject>section[data-marpit-advanced-background=pseudo],div#\:\$p>svg[data-marpit-svg]>foreignObject[data-marpit-advanced-background=pseudo]{pointer-events:none!important}div#\:\$p>svg>foreignObject>section[data-marpit-advanced-background-split]{width:100%;height:100%}
+

PostgreSQL with Node

-
-

REMOVE

-

Syntax

-
DELETE FROM table_name WHERE condition;
-
-

Again, if the condition is not provided, DELETE affects all rows. Before deleting, it is a good practice to execute an equivalent SELECT query to make sure that only the proper rows will be affected.

-

Example:

+
+

Setting up a Dockerized Postgres environment

    -
  • SELECT * FROM users WHERE id = 5; +
  • These lectures assume you have a Dockerized Postgres instance set up
    • -
  • DELETE FROM users WHERE id = 5; +
  • Done? Great!
    • +
  • Using our previously created, Dockerized Postgres instance, we'll create a Node application to connect to our database.
      -
    • Then delete the data
      • +
    • If you have deleted your postgres container, just create a new one with the same command.
    • -
-
-
-

Exercise 5: Editing Data

- -

Postpone the due date of the loan with an id of 2 by two days in the borrows table

-

Add a couple of new books to the books table

-

Delete one of the loans.

-
-
-

CREATE TABLE

-

Before data can be manipulated, a database and its tables need to be initialized.

-

Syntax

-
CREATE TABLE table_name (
-  column1 datatype,	
-  column2 datatype,	
-  …
-);
+
  • If your container has shut down (after a reboot for example), you can start it with
    docker start my-postgres
 
    
-
    Example:
    
-
    CREATE TABLE "users" (
-  "id" SERIAL PRIMARY KEY,
-  "full_name" varchar NOT NULL,
-  "email" varchar UNIQUE NOT NULL,
-  "created_at" timestamp NOT NULL
-);
-
    
-
    • -
    -

    DROP

    -

    In order to remove tables or databases, we use a DROP statement. Syntax:

    -
    DROP TABLE table_name;
-DROP DATABASE database_name;
-
    -

    These statements do not ask for confirmation and there is no undo feature. Take care when using a drop statement.

    -
    -
    -

    NoSQL

    -
      -
    • In addition to SQL databases, there are also NoSQL databases
      • -
    • Many differing definitions, but... -
        -
      • most agree that NoSQL databases store data in a format other than tables
        • -
      • They can still store relational data - just differently
        • -
      -
      • -
    • Four different database types: -
        -
      • Document databases
        • -
      • Key-value databases
        • -
      • Wide-column stores
        • -
      • Graph databases
        • -
      • -
    • Example database engines include MongoDB, Redis and Cassandra
    -
    -

    Document databases store data in documents similar to JSON (JavaScript Object Notation) objects. Each document contains pairs of fields and values. The values can typically be a variety of types including things like strings, numbers, booleans, arrays, or objects, and their structures typically align with objects developers are working with in code. Because of their variety of field value types and powerful query languages, document databases are great for a wide variety of use cases and can be used as a general purpose database. They can horizontally scale-out to accomodate large data volumes. MongoDB is consistently ranked as the world's most popular NoSQL database according to DB-engines and is an example of a document database. For more on document databases, visit What is a Document Database?.

    -
    -
    -

    Key-value databases are a simpler type of database where each item contains keys and values. A value can typically only be retrieved by referencing its value, so learning how to query for a specific key-value pair is typically simple. Key-value databases are great for use cases where you need to store large amounts of data but you don't need to perform complex queries to retrieve it. Common use cases include storing user preferences or caching. Redis and DynanoDB are popular key-value databases.

    -
    -
    -

    Wide-column stores store data in tables, rows, and dynamic columns. Wide-column stores provide a lot of flexibility over relational databases because each row is not required to have the same columns. Many consider wide-column stores to be two-dimensional key-value databases. Wide-column stores are great for when you need to store large amounts of data and you can predict what your query patterns will be. Wide-column stores are commonly used for storing Internet of Things data and user profile data. Cassandra and HBase are two of the most popular wide-column stores.

    -
    -
    -

    Graph databases store data in nodes and edges. Nodes typically store information about people, places, and things while edges store information about the relationships between the nodes. Graph databases excel in use cases where you need to traverse relationships to look for patterns such as social networks, fraud detection, and recommendation engines. Neo4j and JanusGraph are examples of graph databases.

    -
    -
    -

    Object-Relational Mappers

    -
      -
    • ORMs allow developers to manipulate databases with code instead of SQL queries -
        -
      • For example, for performing CRUD operations on their database
        • -
      -
      • -
    • Some popular ORMs:
      • -
    • Hibernate (Java)
      • -
    • EFCore (.NET)
      • -
    • Sequelize (Node.js)
      • -
    • TypeORM (TypeScript) - documentation
      • -
    -
    -
    -

    PostgreSQL with Node

    -
    -
    -

    Local environment

    -

    Using our previously created, Dockerized Postgres instance, we'll create a Node application to connect to our database.

    -

    If you have deleted your postgres container, just create a new one with the same command.

    -

    If your container has shut down (after a reboot for example), you can start it with

    -
    docker start my-postgres
-
    -
    -
    -

    Preparing our Node application

    +
    +

    Preparing our Node application

    Initialize a new TypeScript application.

    Install express and PostgreSQL client for Node.JS, and their respective TypeScript types

    Install dotenv, nodemon and ts-node development dependencies

    -
    -

    Dotenv

    +
    +

    Dotenv

    Example of .env file:

    -
    PORT=3000
+
    PORT=3000
 PG_HOST=localhost
 PG_PORT=5432
 PG_USERNAME=pguser
@@ -437,9 +55,9 @@ PG_DATABASE=postgres
 
    The database must exist as well.
    
 
    Note that the example uses the default "postgres" database, but you can use any database you want.
    -
    -

    Dotenv (continued)

    -
    {
+
    
+
    Dotenv (continued)
    
+
    {
   "name": "products_api",
   "version": "1.0.0",
   "scripts": {
@@ -460,29 +78,29 @@ PG_DATABASE=postgres
 }
 
    
 
    
-
    
+
    
 
    Dotenv is usually only used in development, not in production. In professional setting the dotenv config is often preloaded in the development startup script
    
-
    You can require dotenv when running npm run dev_
    
-
    -r is short for --require
    
+
    You can require dotenv when running npm run dev
    
+
    -r is short for --require
    
 
    
-
    
-
    Dotenv and Git
    
+
    
+
    Dotenv and Git
    
 
      
-
    • .env files usually contain sensitive data that we do not want to store in Git repositories.
      • 
-
    • Thus, usually .env file is excluded from the Git repository
+
    • .env files usually contain sensitive data that we do not want to store in Git repositories.
      • 
+
    • Thus, usually .env file is excluded from the Git repository
 
        
-
      • Add .env to _.gitignore
        • 
-
      • If you have auto-generated .gitignore with npx gitignore Node, environment files are excluded automatically
        • 
+
      • Add .env to .gitignore
        • 
+
      • If you have auto-generated .gitignore with npx gitignore Node, environment files are excluded automatically
        
+
        • 
 
      
 
      • 
 
    
-
    
 
    
-
    
-
    Connecting to PostgreSQL
    
+
    
+
    Connecting to PostgreSQL
    
 
    Our database file contains functions and configuration for initializing the Postgres pool, creating tables and running queries.
    
 
    At the moment, we have only one query. It is a single-use query that creates a products table to the database if such table does not yet exist.
    
-
    // db.ts
+
    // db.ts
 import pg from "pg";
 const { PG_HOST, PG_PORT, PG_USERNAME, PG_PASSWORD, PG_DATABASE } = process.env;
 
@@ -494,7 +112,7 @@ PG_DATABASE=postgres
   database: PG_DATABASE,
 });
 
-const executeQuery = async (query: string, parameters?: Array<any>) => {
+const executeQuery = async (query: string, parameters?: Array<any>) => {
   const client = await pool.connect();
   try {
     const result = await client.query(query, parameters);
@@ -519,11 +137,10 @@ PG_DATABASE=postgres
 };
 
    
 
    
-
    
+
    
 
    At the moment our index.ts does nothing but creates a single table for our database and launches express server.
    
 
    It doesn't even have any endpoints, so it's not much of a server yet.
    
-
    
-import express from "express";
+
    import express from "express";
 import { createProductsTable } from "./db";
 
 const server = express();
@@ -536,23 +153,24 @@ server.listen(
    
-
    Launching the application
    
+
    
+
    Launching the application
    
 
    Let's use our predefined npm run dev
    
 
    
 
    
-
    
+
    
 
    …And check with psql that our application succeeds in connecting to the database and creating the table.
    
 
    Epic success!
    
-
    
+

    
+b
    
 
    
-
    
-
    Exercise 6: Node & PostgreSQL
    
+
    
+
    Exercise 1: Node & PostgreSQL
    
 
 
    Following the lecture example, create an Express server that connects to your local PostgreSQL instance. The database information should be stored in environment variables. When the server starts, it should create a product table with three columns: id (serial, primary key), name (varchar) and price (real).
    
 
    
-
    
-
    Creating Queries
    
+
    
+
    Creating Queries
    
 
      
 
    • Next, we will create an actual CRUD API for communicating with the database.
      • 
 
    • For that we need endpoints for creating, reading, updating and deleting products.
@@ -562,8 +180,8 @@ server.listen(
      
-
      Using queries
      
+
      
+
      Using queries
      
 
        
 
      • We'll use the pre-made executeQuery() function for querying the database from a few slides back
        • 
 
      • It takes in two arguments:
@@ -579,27 +197,27 @@ server.listen(
        
-
        Parameterized queries example
        
+
        
+
        Parameterized queries example
        
 
        
-
        When running  executeQuery(query, parameters) with above values defined, the query would be parsed as
        
-
        SELECT * FROM cats WHERE color = 'yellow' and age > 10;
+
        When running executeQuery(query, parameters) with the above values defined, the query would be parsed as
        
+
        SELECT * FROM cats WHERE color = 'yellow' and age > 10;
 
        
 
        
-
        
-
        Why not just use String templating?
        
+
        
+
        Why not just use String templating?
        
 
        …Because of  SQL injections . Always use database library's built-in parameterization!
        
 
        NEVER DO THIS!!!
        
 
        
 
        
 
        
-
        
-
        Creating queries
        
+
        
+
        Creating queries
        
 
        We will create a Data Access Object, dao.ts that will handle interacting with our database.
        
 
        The idea is that we want to just tell our DAO what we want done (e.g. "add this customer to the database") and the DAO will handle the details of that action.
        
 
        The DAO will also return possible additional information that was created during the action.
        
 
        
-
        
+
        
 
        Our insertProduct function
        
 
        generates a new, unique ID for the product using  uuid
        
 
        constructs a parameters array containing said id, the name of the product and the price of the product
        
@@ -607,7 +225,7 @@ server.listen(
        
 
        
-
        
+
        
 
        
 
        
 
        
@@ -617,12 +235,12 @@ server.listen(
        
+
        
 
        The rest of the DAO operations work in similar fashion.
        
 
        The router that declares the endpoints, uses the DAO to interact with the database.
        
 
        
-
        
-
        Testing the API
        
+
        
+
        Testing the API
        
 
        
 
        
 
        Now we can use Insomnia to verify that all the endpoints work as expected.
        
@@ -634,8 +252,8 @@ server.listen(
        
-
        Exercise 7: Creating Queries
        
+
        
+
        Exercise 2: Creating Queries
        
 
 
        Continue following the lecture example. Create a router and a database access object to handle
        
 
          
@@ -646,19 +264,19 @@ server.listen(
          
-
          Dockerized PostgreSQL App
          
+
          
+
          Dockerized PostgreSQL App
          
 
          
-
          
-
          Setting Environment Variables
          
+
          
+
          Setting Environment Variables
          
 
          Docker has two kinds of environment variables: run-time and build-time.
          
 
          In this scenario we want to set our environment variables at build time. This means that the Docker image will contain all the environment variable information, including sensitive things like passwords. This might be an issue in some scenarios. In those cases the environment variables need to be set at run time.
          
 
          In the Dockerfile we set the build-time values by setting ARG parameters. Then we use these values to set the run-time environment variables by setting ENV parameters.
          
 
          More information:  https://vsupalov.com/docker-arg-env-variable-guide/
          
 
          
-
          
+
          
 
          When the ARGs and ENVs have been set in the Dockerfile, we provide the ARG values when building the Docker image by using_--build-arg =_ flags. To build an image with these parameters, we'd use something like
          
-
          docker build 
+
          docker build 
 --build-arg PORT=3000 
 --build-arg PG_HOST=https://my.postgres.server 
 --build-arg PG_PORT=5432 
@@ -668,9 +286,9 @@ server.listen(
          
+
          
 
          And include the build-arg parameters in our Dockerfile with them mapped to environment variables.
          
-
          ARG PORT
+
          ARG PORT
 ARG PG_HOST
 ARG PG_PORT
 ARG PG_USERNAME
@@ -686,12 +304,12 @@ ENV PG_DATABASE=${PG_DATABASE}
 
          
 
          Docker documentation here!
          
 
          
-
          
-
          Exercise 8: Dockerized PG App
          
+
          
+
          Exercise 3: Dockerized PG App
          
 
 
          Dockerize the application you have built. Build the docker image, run the app and test that it works using insomnia/postman.
          
 
          Remember that when you run the application on your local Docker, both the app and the database are in the same Docker network, so you have to check the database IP address just like when running pgAdmin.
          
 
          
-          
\ No newline at end of file
+
\ No newline at end of file
diff --git a/3-databases-with-docker.md b/3-databases-with-docker.md
index a5d182c..1013c4c 100644
--- a/3-databases-with-docker.md
+++ b/3-databases-with-docker.md
@@ -2,505 +2,28 @@
 marp: true
 paginate: true
 math: mathjax
-theme: default
 theme: buutti
-title: Databases
+title: PostgreSQL with Node
 ---
 
-# Databases
+# PostgreSQL with Node
 
 
 
 
+## Setting up a Dockerized Postgres environment
 
+* These lectures assume you have a Dockerized Postgres instance set up
+  * Follow the [Webdev basics: SQL Databases](https://gitea.buutti.com/education/webdev-basics/src/branch/main/sql-databases.md) lectures first.
+* Done? Great!
+* Using our previously created, Dockerized Postgres instance, we'll create a Node application to connect to our database.
+  * If you have deleted your postgres container, just create a new one with the same command.
+* If your container has shut down (after a reboot for example), you can start it with
+  ```
+  docker start my-postgres
+  ```
 
-# SQL
-
-- Structured Query Language
-- A language to organize and manipulate data in a relational database
-- Originally developed by IBM in the 70s
-- Quickly became the most popular database language
-
-```
-SELECT id, email
-FROM users
-WHERE first_name = 'Teppo';
-```
-
-
-
-# Relational Database Management Systems
-
-* In relational databases, values are stored in  **tables**
-  * Each table has **rows** and **columns**
-  * Data is displayed in a two-dimensional matrix
-* Values in a table are related to each other
-  * Values can also be related to values in other tables
-* A relational database management system (RDBMS) is a program that executes queries to relational databases
-
-
-
-# Relational Database Management Systems
-
-![](imgs/3-databases-with-docker_0.png)
-
-[https://db-engines.com/en/ranking](https://db-engines.com/en/ranking)
-
-
-
-# PostgreSQL
-
-A free, open-source, cross-platform relational database management system
-
-Emphasizes extensibility and SQL compliance
-
-Fully [ACID](https://en.wikipedia.org/wiki/ACID)-compliant (atomicity, consistency, isolation and durability)
-
-
-
-# Running Postgres in Docker
-
-Using the official  [Postgres Docker image](https://hub.docker.com/_/postgres) , let's create a locally running Postgres instance. You can choose the values for POSTGRES_PASSWORD and POSTGRES_USER freely.
-```
-docker run --name my-postgres --env POSTGRES_PASSWORD=pgpass 
---env POSTGRES_USER=pguser -p 5432:5432 -d postgres:15.2
-```
-
-![](imgs/3-databases-with-docker_1.png)
-
-
-
-# Managing the PostgreSQL database with psql
-
-*psql is a terminal-based front-end to PostgreSQL. It enables you to type in queries interactively, issue them to PostgreSQL, and see the query results. Alternatively, input can be from a file or from command line arguments. In addition, psql provides a number of meta-commands and various shell-like features to facilitate writing scripts and automating a wide variety of tasks.*
-
-https://www.postgresql.org/docs/current/app-psql.html
-
-You can use psql directly from the container running the database	
-```
-docker exec -it my-postgres psql -U pguser
-```
-
-# Managing the PostgreSQL database with psql
-
-* If you have connected to the server as user "pguser", you are by default connected to "pguser" database.
-* This is a database for user information. Do not use it for storing program data!!
-* All databases can be listed using the *list* command: `\l`
-* PostgreSQL uses a default database named "postgres"
-* Users can connect to a different database with *connect* command `\c`:
-  * `\c `
-* A new database is created with CREATE command:
-  * `CREATE DATABASE ;` <-- notice the semicolon!
-  * After creating a new database, you still need to connect to it!
-* Exit psql with the command `exit`
-
-
-
-# Exercise 1: Postgres Server
-
-
-Start a local instance of Postgres in Docker
-
-Connect to the server using psql
-
-Use command `\l` to see what databases there are already created on the server.
-
-Create a new database called "sqlpractice".
-
-Connect to the newly created database.
-
-
-
-# pgAdmin
-
-Administration and development platform for PostgreSQL
-
-Cross-platform, features a web interface
-
-Basically a control panel application for your PostgreSQL database
-
-A graphical alternative to psql
-
-Completely separate from PostgreSQL, so pgAdmin is not required for using PostgreSQL. It is only one example of how you can administer the database. Other options include the forementioned psql and a wide variety of other database management tools, like [DBeaver](https://dbeaver.io/). 
-
-
-
-# Running pgAdmin in Docker
-
-Using the official [pgAdmin](https://hub.docker.com/r/dpage/pgadmin4) image, we'll run pgAdmin alongside Postgres
-```
-docker run --name my-pgadmin -p 5050:80 
---env PGADMIN_DEFAULT_EMAIL= 
---env PGADMIN_DEFAULT_PASSWORD= 
--d dpage/pgadmin4
-```
-
-![](imgs/3-databases-with-docker_2.png)
-
-
-
-# Logging into pgAdmin
-
-With pgAdmin running, navigate your web browser to http://localhost:5050 and use the username and password you provided to log in.
-
-![](imgs/3-databases-with-docker_3.png)
-
-
-
-# PostgreSQL internal IP Address
-
-Both **PostgreSQL** and **pgAdmin** are now running in our *local* Docker. To connect pgAdmin to PostgreSQL, we need the IP address used inside Docker.
-
-Using Docker's inspect, we'll get Docker's internal IP for my-postgres -container. Since the command produces quite a lot of information, we pipe the result to grep (Linux) or findstr (Windows), to see only the rows that contain the word "IPAddress"
-
-```
-docker inspect  | grep IPAddress
-docker inspect  | findstr IPAddress
-```
-
-In the example output, the IP Address is 172.17.0.2
-
-![](imgs/3-databases-with-docker_4.png)
-
-
-
-# Connecting PgAdmin to our DB
-
-Now we have all that we need for a connection. In pgAdmin, select "Object" > "Register" > "Server".
-
-In the "General" tab, give the server a name that identifies the connection.
-
-![](imgs/3-databases-with-docker_5.png)
-
----
-
-If Object menu is greyed out, click on Servers.
-
-![](imgs/3-databases-with-docker_6.png)
-
----
-
-* In the "Connection" tab, enter
-* Host name/address:
-  * the PostgreSQL internal Docker address
-* Port, Username, Password
-  * the values defined when running the PostgreSQL container
-* Then click Save. You should now see all the databases available on this server.
-
----
-
-![](imgs/3-databases-with-docker_7.png)
-
----
-
-![](imgs/3-databases-with-docker_8.png)
-
-
-
-# Exercise 2: pgAdmin
-
-
-Start a local instance of pgAdmin in Docker
-
-Following lecture instructions, connect the pgAdmin to your already running PostgreSQL server.
-
-Verify that you can see the database created in the previous assignment.
-
-
-
-# PostgreSQL: Querying
-
-With psql: After connecting to a database, just type a query and hit enter.
-
-With pgAdmin:
-
-Right-click a database > Query tool
-
-Insert a query into the Query Editor and hit Execute (F5)
-
-![](imgs/3-databases-with-docker_9.png)
-
----
-
-![](imgs/3-databases-with-docker_10.png)
-
-
-
-
-
-# Editing Data with pgAdmin
-
-* Tables of Data in a DataBase are found under
-  * Database > Schemas > Tables
-* Inspect and edit data in pgAdmin by right-clicking a table and selecting View/Edit Data
-
----
-
-![](imgs/3-databases-with-docker_11.png)
-
----
-
-![](imgs/3-databases-with-docker_12.png)
-
-Individual values in the table can be directly modified by double clicking the value and then editing the value in the visual user interface
-
-Save the changes with the Save Data Changes button
-
-![](imgs/3-databases-with-docker_13.png)
-
-
-
-# Exercise 3: Preparing the Database
-
-
-Using either PgAdmin or PSQL
-
-Insert the  [provided query](https://gitea.buutti.com/education/academy-assignments/src/branch/master/Databases/initdb.txt)  to the database you created previously.
-
-Verify that the query has created new tables to your database.
-
-# Types of queries
-
-- Select
-- Insert
-- Delete
-- Update
-- Create & Drop
-
-
-
-# Querying data with SELECT
-
-Syntax:
-
-```
-SELECT column1, column2, column3 FROM table_name;
-```
-
-Examples:
-- `SELECT full_name, email FROM users;`
-- `SELECT full_name AS name, email FROM users;`
-- `SELECT * FROM users;`
-
-
-
-# Filtering data with WHERE
-
-Syntax:
-
-```
-SELECT column1, column2 FROM table_name WHERE condition;
-```
-
-Text is captured in **single** quotes. In a LIKE condition, % sign acts as a wildcard. IS and IS NOT are also valid comparison operators.
-
-Example:
-- `SELECT full_name FROM users;`
-- `WHERE full_name = 'Teppo Testaaja';`
-- `SELECT * FROM books WHERE name LIKE '%rr%';`
-- `SELECT * FROM books WHERE author IS NOT null;`
-
-
-
-# Ordering data with ORDER BY
-
-Syntax:
-```
-SELECT column1 FROM table_name ORDER BY column1 ASC;
-```
-
-Examples:
-- `SELECT full_name FROM users ORDER BY full_name ASC;`
-- `SELECT full_name FROM users ORDER BY full_name DESC`
-
-
-
-# Combining with JOIN
-
-Also known as INNER JOIN
-
-Corresponds to intersection from set theory
-
-![](imgs/3-databases-with-docker_14.png)
-
-
-
-# JOIN examples
-
-```
-SELECT users.id, users.full_name, borrows.id, borrows.user_id,
-borrows.due_date, borrows.returned_at
-FROM users JOIN borrows ON users.id = borrows.user_id;
-```
-```
-SELECT U.full_name AS name, B.due_date AS due_date, B.returned_at AS returned_at
-FROM users AS U JOIN borrows AS B ON U.id = B.user_id;
-```
-
-
-
-# Exercise 4: Querying the Library
-
-
-Using SQL queries, get
-
-1) All columns from loans that are loaned before 1.3.2000
-2) All columns of loans that are returned
-3) Columns user.full_name and borrows.borrowed_at of the user with an id of 1
-4) Columns book.name, book.release_year and language.name of all books that are released after 1960
-
-
-
-# INSERT
-
-Syntax
-```
-INSERT INTO table_name (column1, column2, column3) VALUES (value1, value2, value3);
-```
-Example
-- `INSERT INTO users (full_name, email, created_at) VALUES ('Pekka Poistuja', 'pekka.poistuja@buutti.com', NOW());`
-
-Since id is not provided, it will be automatically generated.
-
-
-
-# UPDATE
-
-Syntax
-```
-UPDATE table_nameSET column1 = value1, column2 = value2 WHERE condition;
-```
-Notice: if a condition is not provided, all rows will be updated! If updating only one row, it is usually best to use id.
-
-Example
-- `UPDATE usersSET email = 'taija.testaaja@gmail.com' WHERE id = 2;`
-
-
-
-# REMOVE
-
-Syntax
-```
-DELETE FROM table_name WHERE condition;
-```
-Again, if the condition is not provided, DELETE affects all rows. Before deleting, it is a good practice to execute an equivalent SELECT query to make sure that only the proper rows will be affected.
-
-Example:
-- `SELECT * FROM users WHERE id = 5;` 
-  - First use SELECT to confirm the data you're about to delete
-- `DELETE FROM users WHERE id = 5;` 
-  - Then delete the data
-
-
-
-# Exercise 5: Editing Data
-
-
-Postpone the due date of the loan with an id of 2 by two days in the borrows table
-
-Add a couple of new books to the books table
-
-Delete one of the loans.
-
-
-
-# CREATE TABLE
-
-Before data can be manipulated, a database and its tables need to be initialized.
-
-Syntax
-```
-CREATE TABLE table_name (
-  column1 datatype,	
-  column2 datatype,	
-  …
-);
-```
-
-Example:
-```
-CREATE TABLE "users" (
-  "id" SERIAL PRIMARY KEY,
-  "full_name" varchar NOT NULL,
-  "email" varchar UNIQUE NOT NULL,
-  "created_at" timestamp NOT NULL
-);
-```
-
-
-
-# DROP
-
-In order to remove tables or databases, we use a DROP statement. Syntax:
-```
-DROP TABLE table_name;
-DROP DATABASE database_name;
-```
-
-These statements do not ask for confirmation and there is no undo feature. Take care when using a drop statement.
-
-
-
-# NoSQL
-
-* In addition to SQL databases, there are also NoSQL databases
-* Many differing definitions, but...
-  * most agree that NoSQL databases store data in a format other than tables
-  * They can still store relational data - just differently
-* Four different database types:
-  * Document databases
-  * Key-value databases
-  * Wide-column stores
-  * Graph databases
-* Example database engines include MongoDB, Redis and Cassandra
----
-
-Document databases store data in documents similar to JSON (JavaScript Object Notation) objects. Each document contains pairs of fields and values. The values can typically be a variety of types including things like strings, numbers, booleans, arrays, or objects, and their structures typically align with objects developers are working with in code. Because of their variety of field value types and powerful query languages, document databases are great for a wide variety of use cases and can be used as a general purpose database. They can horizontally scale-out to accomodate large data volumes. MongoDB is consistently ranked as the world's most popular NoSQL database according to DB-engines and is an example of a document database. For more on document databases, visit What is a Document Database?.
-
---- 
-
-Key-value databases are a simpler type of database where each item contains keys and values. A value can typically only be retrieved by referencing its value, so learning how to query for a specific key-value pair is typically simple. Key-value databases are great for use cases where you need to store large amounts of data but you don't need to perform complex queries to retrieve it. Common use cases include storing user preferences or caching. Redis and DynanoDB are popular key-value databases.
-
----
-
-Wide-column stores store data in tables, rows, and dynamic columns. Wide-column stores provide a lot of flexibility over relational databases because each row is not required to have the same columns. Many consider wide-column stores to be two-dimensional key-value databases. Wide-column stores are great for when you need to store large amounts of data and you can predict what your query patterns will be. Wide-column stores are commonly used for storing Internet of Things data and user profile data. Cassandra and HBase are two of the most popular wide-column stores.
-
----
-
-Graph databases store data in nodes and edges. Nodes typically store information about people, places, and things while edges store information about the relationships between the nodes. Graph databases excel in use cases where you need to traverse relationships to look for patterns such as social networks, fraud detection, and recommendation engines. Neo4j and JanusGraph are examples of graph databases.
-
-
-
-# Object-Relational Mappers
-
-* ORMs allow developers to manipulate databases with code instead of SQL queries
-  * For example, for performing CRUD operations on their database
-* Some popular ORMs:
-* Hibernate (Java)
-* EFCore (.NET)
-* Sequelize (Node.js)
-* TypeORM (TypeScript) - [documentation](https://typeorm.io/#installation)
-
-
-
-# PostgreSQL with Node
-
-
-
-# Local environment
-
-Using our previously created, Dockerized Postgres instance, we'll create a Node application to connect to our database.
-
-If you have deleted your postgres container, just create a new one with the same command.
-
-If your container has shut down (after a reboot for example), you can start it with
-```
-docker start my-postgres
-```
-
-
-
-# Preparing our Node application
+## Preparing our Node application
 
 Initialize a new TypeScript application.
 
@@ -508,9 +31,7 @@ Install [express](https://www.npmjs.com/package/express) and [PostgreSQL client
 
 Install [dotenv](https://www.npmjs.com/package/dotenv), nodemon and ts-node development dependencies
 
-
-
-# Dotenv
+## Dotenv
 
 Example of `.env` file:
 ```
@@ -530,7 +51,7 @@ Note that the example uses the default "postgres" database, but you can use any
 
 
 
-# Dotenv (continued)
+## Dotenv (continued)
 
 ```json
 {
@@ -558,24 +79,21 @@ Note that the example uses the default "postgres" database, but you can use any
 
 Dotenv is usually only used in development, not in production. In professional setting the dotenv config is often preloaded in the development startup script
 
-You can require dotenv when running npm run dev_
+You can require dotenv when running `npm run dev`
 
--r is short for --require
+`-r` is short for `--require`
 
 
 
-# Dotenv and Git
+## Dotenv and Git
 
-* .env files usually contain sensitive data that we do _not_ want to store in Git repositories.
-* Thus, usually _.env_ file is excluded from the Git repository
-  * Add _.env_ to _.gitignore
+* `.env` files usually contain sensitive data that we do _not_ want to store in Git repositories.
+* Thus, usually `.env` file is excluded from the Git repository
+  * Add `.env` to `.gitignore`
   * If you have auto-generated .gitignore with `npx gitignore Node`, environment files are excluded automatically
+  ![](imgs/3-databases-with-docker_16.png)
 
-![](imgs/3-databases-with-docker_16.png)
-
-
-
-# Connecting to PostgreSQL
+## Connecting to PostgreSQL
 
 Our database file contains functions and configuration for initializing the Postgres pool, creating tables and running queries.
 
@@ -626,7 +144,6 @@ At the moment our `index.ts` does nothing but creates a single table for our dat
 It doesn't even have any endpoints, so it's not much of a server yet.
 
 ```ts
-
 import express from "express";
 import { createProductsTable } from "./db";
 
@@ -642,7 +159,7 @@ server.listen(PORT, () => {
 
 
 
-# Launching the application
+## Launching the application
 
 Let's use our predefined `npm run dev`
 
@@ -655,17 +172,17 @@ Let's use our predefined `npm run dev`
 Epic success!
 
 ![](imgs/3-databases-with-docker_18.png)
+b
 
 
-
-# Exercise 6: Node & PostgreSQL
+## Exercise 1: Node & PostgreSQL
 
 
 Following the lecture example, create an Express server that connects to your local PostgreSQL instance. The database information should be stored in environment variables. When the server starts, it should create a product table with three columns: id (serial, primary key), name (varchar) and price (real).
 
 
 
-# Creating Queries
+## Creating Queries
 
 * Next, we will create an actual CRUD API for communicating with the database.
 * For that we need endpoints for creating, reading, updating and deleting products.
@@ -673,7 +190,7 @@ Following the lecture example, create an Express server that connects to your lo
 
 
 
-# Using queries
+## Using queries
 
 * We'll use the pre-made executeQuery() function for querying the database from a few slides back
 * It takes in two arguments:
@@ -684,17 +201,17 @@ Following the lecture example, create an Express server that connects to your lo
 
 
 
-# Parameterized queries example
+## Parameterized queries example
 
 ![](imgs/3-databases-with-docker_19.png)
 
-When running  executeQuery(query, parameters) with above values defined, the query would be parsed as
+When running `executeQuery(query, parameters)` with the above values defined, the query would be parsed as
 
-```
+```sql
 SELECT * FROM cats WHERE color = 'yellow' and age > 10;
 ```
 
-# Why not just use String templating?
+## Why not just use String templating?
 
 …Because of  [SQL injections](https://fi.wikipedia.org/wiki/SQL-injektio) . Always use database library's built-in parameterization!
 
@@ -706,7 +223,7 @@ _NEVER DO THIS!!!_
 
 
 
-# Creating queries
+## Creating queries
 
 We will create a Data Access Object, `dao.ts` that will handle interacting with our database.
 
@@ -751,7 +268,7 @@ The router that declares the endpoints, uses the DAO to interact with the databa
 
 
 
-# Testing the API
+## Testing the API
 
 
          
 
          
@@ -774,7 +291,7 @@ We can also use psql to observe the changes in the database
 
 
 
-# Exercise 7: Creating Queries
+## Exercise 2: Creating Queries
 
 
 Continue following the lecture example. Create a router and a database access object to handle
@@ -786,9 +303,9 @@ Continue following the lecture example. Create a router and a database access ob
 
 
 
-# Dockerized PostgreSQL App
+## Dockerized PostgreSQL App
 
-# Setting Environment Variables
+## Setting Environment Variables
 
 Docker has two kinds of environment variables: run-time and build-time.
 
@@ -834,7 +351,7 @@ ENV PG_DATABASE=${PG_DATABASE}
 
 [Docker documentation here!](https://www.docker.com/blog/how-to-use-the-postgres-docker-official-image/)
 
-# Exercise 8: Dockerized PG App
+## Exercise 3: Dockerized PG App
 
 
 Dockerize the application you have built. Build the docker image, run the app and test that it works using insomnia/postman.
diff --git a/imgs/3-databases-with-docker_0.png b/imgs/3-databases-with-docker_0.png
deleted file mode 100644
index 3fb3c4a..0000000
Binary files a/imgs/3-databases-with-docker_0.png and /dev/null differ
diff --git a/imgs/3-databases-with-docker_1.png b/imgs/3-databases-with-docker_1.png
deleted file mode 100644
index fcb3736..0000000
Binary files a/imgs/3-databases-with-docker_1.png and /dev/null differ
diff --git a/imgs/3-databases-with-docker_10.png b/imgs/3-databases-with-docker_10.png
deleted file mode 100644
index e60521c..0000000
Binary files a/imgs/3-databases-with-docker_10.png and /dev/null differ
diff --git a/imgs/3-databases-with-docker_11.png b/imgs/3-databases-with-docker_11.png
deleted file mode 100644
index 03a1e2f..0000000
Binary files a/imgs/3-databases-with-docker_11.png and /dev/null differ
diff --git a/imgs/3-databases-with-docker_12.png b/imgs/3-databases-with-docker_12.png
deleted file mode 100644
index 2d57d7c..0000000
Binary files a/imgs/3-databases-with-docker_12.png and /dev/null differ
diff --git a/imgs/3-databases-with-docker_13.png b/imgs/3-databases-with-docker_13.png
deleted file mode 100644
index 23fd825..0000000
Binary files a/imgs/3-databases-with-docker_13.png and /dev/null differ
diff --git a/imgs/3-databases-with-docker_14.png b/imgs/3-databases-with-docker_14.png
deleted file mode 100644
index 4df2e42..0000000
Binary files a/imgs/3-databases-with-docker_14.png and /dev/null differ
diff --git a/imgs/3-databases-with-docker_15.png b/imgs/3-databases-with-docker_15.png
deleted file mode 100644
index 4190de0..0000000
Binary files a/imgs/3-databases-with-docker_15.png and /dev/null differ
diff --git a/imgs/3-databases-with-docker_2.png b/imgs/3-databases-with-docker_2.png
deleted file mode 100644
index 1872b7b..0000000
Binary files a/imgs/3-databases-with-docker_2.png and /dev/null differ
diff --git a/imgs/3-databases-with-docker_3.png b/imgs/3-databases-with-docker_3.png
deleted file mode 100644
index 6ffb1fb..0000000
Binary files a/imgs/3-databases-with-docker_3.png and /dev/null differ
diff --git a/imgs/3-databases-with-docker_4.png b/imgs/3-databases-with-docker_4.png
deleted file mode 100644
index b71d5fa..0000000
Binary files a/imgs/3-databases-with-docker_4.png and /dev/null differ
diff --git a/imgs/3-databases-with-docker_5.png b/imgs/3-databases-with-docker_5.png
deleted file mode 100644
index db7b5f4..0000000
Binary files a/imgs/3-databases-with-docker_5.png and /dev/null differ
diff --git a/imgs/3-databases-with-docker_6.png b/imgs/3-databases-with-docker_6.png
deleted file mode 100644
index ff11198..0000000
Binary files a/imgs/3-databases-with-docker_6.png and /dev/null differ
diff --git a/imgs/3-databases-with-docker_7.png b/imgs/3-databases-with-docker_7.png
deleted file mode 100644
index 40550a2..0000000
Binary files a/imgs/3-databases-with-docker_7.png and /dev/null differ
diff --git a/imgs/3-databases-with-docker_8.png b/imgs/3-databases-with-docker_8.png
deleted file mode 100644
index 4a45325..0000000
Binary files a/imgs/3-databases-with-docker_8.png and /dev/null differ
diff --git a/imgs/3-databases-with-docker_9.png b/imgs/3-databases-with-docker_9.png
deleted file mode 100644
index 2c8f562..0000000
Binary files a/imgs/3-databases-with-docker_9.png and /dev/null differ