データベースの記事を書き直した by chelproc · Pull Request #364 · ut-code/utcode-learn

chelproc · 2023-09-16T00:49:48Z

非同期処理に関する記述を大幅に削減した
記事全体を概念の説明と演習に分けた
ツール類の説明を演習パート冒頭に移動した

cloudflare-workers-and-pages · 2023-09-16T00:50:25Z

Deploying with Cloudflare Pages

Latest commit:	`57cfded`
Status:	✅ Deploy successful!
Preview URL:	https://41e1ac78.utcode-learn.pages.dev
Branch Preview URL:	https://rewrite-database.utcode-learn.pages.dev

View logs

chvmvd · 2023-09-17T10:47:34Z

+これまでの演習では、アプリケーションで扱うデータは全て変数の中に記録してきました。例えば、前頁で作った掲示板アプリケーションでは、クライアントから送られてきた投稿の内容を配列に記録していました。しかし、これではサーバーが終了してしまうと、データがすべて消えてしまいます。

-データベースサーバーは、データを保存したり、参照するための専用のサーバーです。Web の世界では、ブラウザが直接データベースサーバーと通信することはほとんどなく、基本的には Node.js などのウェブサーバーがデータベースサーバーと通信します。リレーショナルデータベースは、データベースの中でも最も多く使われる種類のもので、Excel のような表形式でデータを保持するという特徴があります。
+それでは、送られてきたデータをファイルに記録すれば大丈夫でしょうか。確かに、サーバーが終了してもデータは残りそうです。ところが、もし皆さんが作ったサービスが大きく成長し、一つのサーバーではリクエストを捌ききれなくなったとしましょう。すると、ファイルに保存したデータは複数のサーバーで共有できないことが問題になります。また、記録されているデータが膨大になってくると、ファイルの内容を読み書きするだけでも大変そうです。


ここらへんイメージが湧きにくいので、図がほしいです。

chvmvd · 2023-09-17T10:51:03Z

+これまでの演習では、アプリケーションで扱うデータは全て変数の中に記録してきました。例えば、前頁で作った掲示板アプリケーションでは、クライアントから送られてきた投稿の内容を配列に記録していました。しかし、これではサーバーが終了してしまうと、データがすべて消えてしまいます。

-データベースサーバーは、データを保存したり、参照するための専用のサーバーです。Web の世界では、ブラウザが直接データベースサーバーと通信することはほとんどなく、基本的には Node.js などのウェブサーバーがデータベースサーバーと通信します。リレーショナルデータベースは、データベースの中でも最も多く使われる種類のもので、Excel のような表形式でデータを保持するという特徴があります。
+それでは、送られてきたデータをファイルに記録すれば大丈夫でしょうか。確かに、サーバーが終了してもデータは残りそうです。ところが、もし皆さんが作ったサービスが大きく成長し、一つのサーバーではリクエストを捌ききれなくなったとしましょう。すると、ファイルに保存したデータは複数のサーバーで共有できないことが問題になります。また、記録されているデータが膨大になってくると、ファイルの内容を読み書きするだけでも大変そうです。


「また、記録されている」以降が分かりにくいです。

chvmvd · 2023-09-17T11:55:28Z

 import prismaDbPushVideo from "./prisma-db-push.mp4";
 import createRecordInDatabaseVideo from "./create-record-in-database.mp4";

-## リレーショナルデータベース


右のサイドバーがおかしいので、セクションを作った方が良さそうです。

chvmvd · 2023-09-17T11:58:06Z

+それでは、送られてきたデータをファイルに記録すれば大丈夫でしょうか。確かに、サーバーが終了してもデータは残りそうです。ところが、もし皆さんが作ったサービスが大きく成長し、一つのサーバーではリクエストを捌ききれなくなったとしましょう。すると、ファイルに保存したデータは複数のサーバーで共有できないことが問題になります。また、記録されているデータが膨大になってくると、ファイルの内容を読み書きするだけでも大変そうです。

-次の図は、リレーショナルデータベースの基本的な概念である、**テーブル**、**カラム**、**レコード**について整理した図です。リレーショナルデータベースを用いる一般的なアプリケーションでは、アプリケーション開発時にテーブルとカラムを作成しておき、ユーザーの操作に応じてレコードを追加・編集・削除していきます。
+**データベース**は、このようなデータに関する諸問題を解決するためのシステムです。データベースは、通常サーバーとして動作します。つまり、**データベースサーバー**は、保持しているデータに対する参照や更新のためのリクエスト (**クエリ**) を受け、その結果をレスポンスとしてクライアントに返します。


ユーザーという意味でのクライアントと勘違いしかねない。

chvmvd · 2023-09-18T01:39:55Z

-## ElephantSQL で PostgreSQL を使用する
+リレーショナルデータベースに対するクエリは、通常 **SQL** と呼ばれる言語を用いて記述します。データベースクライアントとして用いるライブラリによっては、SQL を直接用いることなく、そのライブラリが提供する専用の関数等を用いてデータベースに対してクエリを発行できることがあります。
+
+## 演習


演習という概念は初出であるので、どういう構成かわかりにくいかもしれないです。課題との違いがわかりにくそう。
演習と言いつつ、内容もけっこう大事な内容なので、演習という扱いでなく地の文でも良いような気がしています。
逆に、これより上の内容のタイトルを工夫すれば済むような気がします。

chvmvd · 2023-09-18T01:43:13Z

+- [**`Prisma` 拡張機能**](https://marketplace.visualstudio.com/items?itemName=Prisma.prisma): VS Code の拡張機能。`.prisma` ファイルに対する補完やフォーマットの機能を提供する。
+- [**`.prisma` ファイル**](https://www.prisma.io/docs/concepts/components/prisma-schema): データベースのテーブル構造を記述するファイル。`prisma` パッケージのコマンドを用いて実際のデータベースサーバーに反映させる。


ここ2つの説明が前後しています。先に、.prismaファイルを説明した方が良さそう。

chvmvd · 2023-09-18T01:52:46Z

+:::caution 非同期処理

-:::tip (発展) Promise
+上記の 3 つのメソッドは、<Term type="asynchronousProcess">**非同期処理**</Term>を行います。JavaScript における非同期処理とは、ファイルの入出力やネットワーク通信など、JavaScript の外側の時間のかかる処理の完了を待つ間、ほかの処理を実行できるようにする仕組みです。非同期処理を行う関数を使用するためには、次の 2 つを行います。


「JavaScriptの外側」という表現が伝わりにくい気がします。しばらくどういう意味かわからなかったです。

kazukinumazato · 2023-09-18T08:48:08Z

+それでは、送られてきたデータをファイルに記録すれば大丈夫でしょうか。確かに、サーバーが終了してもデータは残りそうです。ところが、もし皆さんが作ったサービスが大きく成長し、一つのサーバーではリクエストを捌ききれなくなったとしましょう。すると、ファイルに保存したデータは複数のサーバーで共有できないことが問題になります。また、記録されているデータが膨大になってくると、ファイルの内容を読み書きするだけでも大変そうです。

-次の図は、リレーショナルデータベースの基本的な概念である、**テーブル**、**カラム**、**レコード**について整理した図です。リレーショナルデータベースを用いる一般的なアプリケーションでは、アプリケーション開発時にテーブルとカラムを作成しておき、ユーザーの操作に応じてレコードを追加・編集・削除していきます。
+**データベース**は、このようなデータに関する諸問題を解決するためのシステムです。データベースは、通常サーバーとして動作します。つまり、**データベースサーバー**は、保持しているデータに対する参照や更新のためのリクエスト (**クエリ**) を受け、その結果をレスポンスとしてクライアントに返します。


ここら辺は概念が複雑なので「リクエスト」「レスポンス」「クライアント」にホバーすると用語解説が出るようにしたほうがいい気がします。あと、Expressの章へのバックリンクも置いておいたほうがいい気がします

たしかに。

kazukinumazato · 2023-09-18T08:51:07Z

+#### [DBeaver](https://dbeaver.io/)

-[PostgreSQL](https://www.postgresql.org) は、代表的なリレーショナルデータベースです。[ElephantSQL](https://www.elephantsql.com) を利用すると、無料のアカウント登録のみで、PostgreSQL サーバーが利用できます。
+多くのデータベースをグラフィカルに操作できるソフトウェアです。PostgreSQL にも対応しています。


「グラフィカルに」よりも「マウスで視覚的に」とかのほうがわかりやすい気がします

この表現は迷ったのですが「グラフィカルに」「視覚的に」はほぼ同義ですし、「マウスで...」はあまり正確ではないので避けた方がいいと思います。
本当は「GUIで」としたかったのですが教材上では他に使っている部分がないので用語を知らなくてもある程度雰囲気を理解できる「グラフィカルに」という言葉の選択をしています

kazukinumazato · 2023-09-18T08:52:49Z

- Data center: `AP-NorthEast-1 (Tokyo)`
+主にリレーショナルデータベースを操作するための Node.js の<Term type="library">ライブラリ</Term>です。複数の構成要素からなります。
+
+- [**`@prisma/client` パッケージ**](https://www.npmjs.com/package/@prisma/client): 実行時に用いる npm のパッケージ。JavaScript プログラムから使用する。


なんの「実行時」かはっきりしておいたほうがいい気がします

ですね。

データベースの記事を書き直した

0d1fac6

課題の説明を追加

c06fb0f

chvmvd reviewed Sep 18, 2023

View reviewed changes

kazukinumazato reviewed Sep 18, 2023

View reviewed changes

Merge branch 'master' into rewrite-database

57cfded

chelproc merged commit 88fb8bb into master Sep 26, 2023

chelproc deleted the rewrite-database branch September 26, 2023 02:37

chvmvd mentioned this pull request Oct 1, 2023

レビュー反映 #412

Closed

3 tasks

		- [`Prisma` 拡張機能](https://marketplace.visualstudio.com/items?itemName=Prisma.prisma): VS Code の拡張機能。`.prisma` ファイルに対する補完やフォーマットの機能を提供する。
		- [`.prisma` ファイル](https://www.prisma.io/docs/concepts/components/prisma-schema): データベースのテーブル構造を記述するファイル。`prisma` パッケージのコマンドを用いて実際のデータベースサーバーに反映させる。

Conversation

chelproc commented Sep 16, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cloudflare-workers-and-pages Bot commented Sep 16, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying with Cloudflare Pages

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

chelproc commented Sep 16, 2023 •

edited

Loading

cloudflare-workers-and-pages Bot commented Sep 16, 2023 •

edited

Loading