🌐 Add Japanese translation for `docs/ja/docs/tutorial/sql-databases.md` #5058

Yoshino-Yukitaro · 2022-06-22T06:52:45Z

Relates to #1572

This PR translates tutorial/sql-databases.md.

I am Japanese and I love FastAPI, so I translated it.
This is my first pull request for this repository, so I apologize if there are any problems. I would appreciate it if you could check it.

codecov · 2022-06-22T06:53:55Z

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (cf73051) 100.00% compared to head (666cdc4) 100.00%.
Report is 1217 commits behind head on master.

❗ Current head 666cdc4 differs from pull request most recent head a8022e6. Consider uploading reports for the commit a8022e6 to get more accurate results

Additional details and impacted files

@@            Coverage Diff             @@
##            master     #5058    +/-   ##
==========================================
  Coverage   100.00%   100.00%            
==========================================
  Files          540       532     -8     
  Lines        13969     13672   -297     
==========================================
- Hits         13969     13672   -297

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

github-actions · 2022-06-22T06:56:56Z

📝 Docs preview for commit 666cdc4 at: https://62b2bd06f8dafd4909da75ef--fastapi.netlify.app

komtaki

I'm appreciate for your tough contribution. 👏
I commented a few suggestion, so please confirm.

docs/ja/docs/tutorial/sql-databases.md

+その後、本番のアプリケーションでは **PostgreSQL** のようなデータベースサーバーを使用したいと思うかもしれません。
+
+!!! Tip "豆知識"
+    **FastAPI** と **PostgreSQL** を使った公式のプロジェクトジェネレータがあります。これはフロントエンドやその他のツールを含んでおり、全て **Docker** を基にしています。 <a href="https://github.com/tiangolo/full-stack-fastapi-postgresql" class="external-link" target="_blank">https://github.com/tiangolo/full-stack-fastapi-postgresql</a>


docs/ja/docs/tutorial/sql-databases.md

+
+この例では **SQLite** を使用します。なぜなら、SQLiteは単一のファイルを使用し、Pythonが完全にサポートしているからです。そのため、この例をコピーして、そのまま実行することができます。
+
+その後、本番のアプリケーションでは **PostgreSQL** のようなデータベースサーバーを使用したいと思うかもしれません。


docs/ja/docs/tutorial/sql-databases.md

+ファイル `__init__.py` はただの空ファイルですが、このファイルは `sql_app` とそのモジュール (Python ファイル) がパッケージであることを Python に知らせます。
+
+では、それぞれのファイル/モジュールが何をするのか見てみましょう。
+


docs/ja/docs/tutorial/sql-databases.md

+
+### `SessionLocal` クラスの作成
+
+SessionLocal` クラスの各インスタンスがデータベースセッションになります。このクラス自身は、まだデータベースセッションではありません。


docs/ja/docs/tutorial/sql-databases.md

+
+では、クラスを返す関数 `declarative_base()` を使ってみましょう。
+
+後で、このクラスを継承して、各データベースモデルやクラス（ORMモデル）を作成します:


docs/ja/docs/tutorial/sql-databases.md

+
+そして、Alembicを「マイグレーション」にも使うことになります（それが主な仕事です）。
+
+マイグレーション "とは、SQLAlchemy のモデルの構造を変更したり、新しい属性を追加した りするたびに、それらの変更をデータベースに再現し、新しいカラムやテーブルを追加する ために必要な一連のステップのことです。


docs/ja/docs/tutorial/sql-databases.md

+
+## すべてのファイルを確認する
+
+ my_super_project`というディレクトリがあり、その中に `sql_app` というサブディレクトリがあることを思い出してください。


docs/ja/docs/tutorial/sql-databases.md

+
+そしたら、ブラウザで <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a> を開けます。
+
+そして、実際のデータベースからデータを読み出しながら、**FastAPI**アプリケーションと対話することができるようになります:


docs/ja/docs/tutorial/sql-databases.md

+
+この場合、すべてのリクエストを通じて単一のデータベースセッションが使用され、その後（ミドルウェアで）クローズされることを保証するのに役立ちます。
+
+### yield` やミドルウェアとの依存関係


github-actions · 2022-12-05T09:30:20Z

📝 Docs preview for commit e8dee01 at: https://638db9fafc1d98674e565e28--fastapi.netlify.app

github-actions · 2022-12-05T10:03:59Z

📝 Docs preview for commit 1e7df12 at: https://638dc1e264c021747929c4e1--fastapi.netlify.app

Yoshino-Yukitaro · 2022-12-05T10:04:28Z

Thanks for your review @komtaki !
As all the comments make sense, I've fixed them in 1e7df12 .

komtaki

Thanks for your improvement.
LGTM 👍

tokusumi

Thank you for your first contribution!!!
It's really helpful to translate long but important chapter like this.
I would have some proposal to polish this more.

tokusumi · 2022-12-07T14:29:33Z

docs/ja/docs/tutorial/sql-databases.md

@@ -0,0 +1,787 @@
+# SQL (リレーショナル) データベース
+
+**FastAPI** では、SQL（リレーショナル）データベースを使用する必要はありません。


Suggested change

**FastAPI** では、SQL（リレーショナル）データベースを使用する必要はありません。

**FastAPI** では、SQL (リレーショナル) データベースは必須ではありません。

more natural, I guess

tokusumi · 2022-12-07T14:30:47Z

docs/ja/docs/tutorial/sql-databases.md

+
+**FastAPI** では、SQL（リレーショナル）データベースを使用する必要はありません。
+
+しかし、使いたいリレーショナルデータベースを使用することができます。


Suggested change

しかし、使いたいリレーショナルデータベースを使用することができます。

しかし、任意のリレーショナルデータベースを使用できます。

it's easier?

tokusumi · 2022-12-07T14:45:56Z

docs/ja/docs/tutorial/sql-databases.md

+
+ここでは、 <a href="https://www.sqlalchemy.org/" class="external-link" target="_blank">SQLAlchemy</a>を使った例を見てみましょう。
+
+以下のような、SQLAlchemyがサポートするどのようなデータベースにも簡単に適応できます。


Suggested change

以下のような、SQLAlchemyがサポートするどのようなデータベースにも簡単に適応できます。

以下のような、SQLAlchemyがサポートするデータベースを簡単に適応できます。

"you can adapt it" means 「それ (database) をFastAPIに適応させることが可能」here

tokusumi · 2022-12-07T14:51:52Z

docs/ja/docs/tutorial/sql-databases.md

+
+そして、そのクラスの各 *インスタンス* オブジェクトは、データベースの行を表します。
+
+例えば、 `orion_cat` (`Pet` のインスタンス) オブジェクトが `orion_cat.type` という属性を持つなら、そのカラムは `type` であると考えられる。そしてその属性の値は、例えば `"cat"` とすることができる。


Suggested change

例えば、 `orion_cat` (`Pet` のインスタンス) オブジェクトが `orion_cat.type` という属性を持つなら、そのカラムは `type` であると考えられる。そしてその属性の値は、例えば `"cat"` とすることができる。

例えば、 `orion_cat` (`Pet` のインスタンス) オブジェクトが `orion_cat.type` という属性を持つなら、そのカラムは `type` であると考えられます。そしてその属性の値は、例えば `"cat"` とすることができます。

you should unify with ですます調

tokusumi · 2022-12-07T14:52:18Z

docs/ja/docs/tutorial/sql-databases.md

+
+例えば、 `orion_cat` (`Pet` のインスタンス) オブジェクトが `orion_cat.type` という属性を持つなら、そのカラムは `type` であると考えられる。そしてその属性の値は、例えば `"cat"` とすることができる。
+
+これらのORMは、テーブルやエンティティ間の接続やリレーションを作成するツールも備えている。


Suggested change

これらのORMは、テーブルやエンティティ間の接続やリレーションを作成するツールも備えている。

これらのORMは、テーブルやエンティティ間の接続やリレーションを作成するツールも備えています。

same as above

tokusumi · 2022-12-07T15:03:41Z

docs/ja/docs/tutorial/sql-databases.md

+
+    `item.dict()`
+
+    そして、`dict` の key-value ペアを SQLAlchemy の `Item` へのキーワード引数として渡しています。次のように。


Suggested change

そして、`dict` の key-value ペアを SQLAlchemy の `Item` へのキーワード引数として渡しています。次のように。

そして次のように、`dict` の key-value ペアを SQLAlchemy の `Item` へのキーワード引数として渡しています。

more natural

tokusumi · 2022-12-07T15:04:16Z

docs/ja/docs/tutorial/sql-databases.md

+
+    `Item(**item.dict())`
+
+    さらに、Pydantic *model* が提供しない別のキーワード引数 `owner_id` を、渡します。次のように。


Suggested change

さらに、Pydantic *model* が提供しない別のキーワード引数 `owner_id` を、渡します。次のように。

さらに次のように、Pydantic *model* が提供しない別のキーワード引数 `owner_id` を渡します。

more natural

tokusumi · 2022-12-07T15:07:33Z

docs/ja/docs/tutorial/sql-databases.md

+これによって、*path operation function* の内部から直接 `crud.get_user` を呼び出して、そのセッションを使用することができます。
+
+!!! Tip "豆知識"
+    返す値は、SQLAlchemy のモデル、あるいは SQLAlchemy のモデルのリストである ことに注意してください。


Suggested change

返す値は、SQLAlchemy のモデル、あるいは SQLAlchemy のモデルのリストであることに注意してください。

返す値は、SQLAlchemy のモデル、あるいは SQLAlchemy のモデルのリストであることに注意してください。

typo

tokusumi · 2022-12-07T15:11:12Z

docs/ja/docs/tutorial/sql-databases.md

+
+</div>
+
+そしたら、ブラウザで <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a> を開けます。


Suggested change

そしたら、ブラウザで <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a> を開けます。

そうすると、ブラウザで <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a> を開けます。

too conversational

tokusumi · 2022-12-07T15:14:45Z

docs/ja/docs/tutorial/sql-databases.md

+* より多くのコードを必要とし、少し複雑になっています。
+* ミドルウェアは `async` 関数である必要があります。
+    * その中に、ネットワークを「待つ」必要があるコードがあると、そこでアプリケーションが「ブロック」され、パフォーマンスが少し低下する可能性があります。
+    * もっとも、ここでは `SQLAlchemy` の動作にはあまり問題はないでしょうけど。


Suggested change

* もっとも、ここでは `SQLAlchemy` の動作にはあまり問題はないでしょうけど。

* もっとも、ここでは `SQLAlchemy` の動作にはあまり問題はないでしょう。

too conversational

github-actions · 2022-12-16T21:38:45Z

📝 Docs preview for commit fcf8f60 at: https://639ce54289c20f03eba4cebb--fastapi.netlify.app

tiangolo · 2023-06-26T23:03:56Z

📝 Docs preview for commit a8022e6 at: https://649a1931d1bbbc12fe60f919--fastapi.netlify.app

tiangolo · 2024-01-28T18:33:51Z

As this PR had requested changes to be applied but has been inactive for a while, it's now going to be closed. But if there's anyone interested, feel free to create a new PR.

吉野　敬太郎 added 3 commits June 21, 2022 19:11

add japanese translate into sql-databases.md

14804f6

half of translate is Done

a788335

complete translate sql-database.md into japanese

666cdc4

Yoshino-Yukitaro changed the title ~~Add Japanese translation for - docs/ja/docs/tutorial/sql-databases.md~~ 🌐Add Japanese translation for - docs/ja/docs/tutorial/sql-databases.md Jun 22, 2022

Yoshino-Yukitaro changed the title ~~🌐Add Japanese translation for - docs/ja/docs/tutorial/sql-databases.md~~ 🌐 Add Japanese translation for - docs/ja/docs/tutorial/sql-databases.md Jun 22, 2022

Yoshino-Yukitaro changed the title ~~🌐 Add Japanese translation for - docs/ja/docs/tutorial/sql-databases.md~~ 🌐 Add Japanese translation for docs/ja/docs/tutorial/sql-databases.md Jun 22, 2022

tiangolo changed the title ~~🌐 Add Japanese translation for docs/ja/docs/tutorial/sql-databases.md~~ 🌐 Add Japanese translation for docs/ja/docs/tutorial/sql-databases.md Jul 14, 2022

tiangolo added lang-all Translations lang-ja Japanese translations awaiting-review labels Jul 14, 2022

github-actions bot mentioned this pull request Jul 14, 2022

Japanese Translation #1572

Closed

komtaki reviewed Nov 7, 2022

View reviewed changes

Merge branch 'master' into add-sql-databases-ja-translate

e8dee01

fix: apply the suggested changes in review.

1e7df12

komtaki approved these changes Dec 6, 2022

View reviewed changes

tokusumi suggested changes Dec 7, 2022

View reviewed changes

Merge branch 'master' into add-sql-databases-ja-translate

fcf8f60

Merge branch 'master' into add-sql-databases-ja-translate

a8022e6

tiangolo added awaiting-review and removed awaiting-review labels Jun 26, 2023

tiangolo added approved-1 and removed awaiting-review labels Jan 22, 2024

alejsdev added the changes-requested label Jan 28, 2024

tiangolo closed this Jan 28, 2024

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

🌐 Add Japanese translation for `docs/ja/docs/tutorial/sql-databases.md` #5058

🌐 Add Japanese translation for `docs/ja/docs/tutorial/sql-databases.md` #5058

Yoshino-Yukitaro commented Jun 22, 2022

codecov bot commented Jun 22, 2022 •

edited

github-actions bot commented Jun 22, 2022

komtaki left a comment

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as resolved.

This comment was marked as outdated.

This comment was marked as resolved.

This comment was marked as resolved.

github-actions bot commented Dec 5, 2022

github-actions bot commented Dec 5, 2022

Yoshino-Yukitaro commented Dec 5, 2022 •

edited

komtaki left a comment

tokusumi left a comment

tokusumi Dec 7, 2022

tokusumi Dec 7, 2022

tokusumi Dec 7, 2022

tokusumi Dec 7, 2022

tokusumi Dec 7, 2022

tokusumi Dec 7, 2022

tokusumi Dec 7, 2022

tokusumi Dec 7, 2022

tokusumi Dec 7, 2022

tokusumi Dec 7, 2022

github-actions bot commented Dec 16, 2022

tiangolo commented Jun 26, 2023

tiangolo commented Jan 28, 2024


		この例では SQLite を使用します。なぜなら、SQLiteは単一のファイルを使用し、Pythonが完全にサポートしているからです。そのため、この例をコピーして、そのまま実行することができます。

		その後、本番のアプリケーションでは PostgreSQL のようなデータベースサーバーを使用したいと思うかもしれません。

		ファイル `__init__.py` はただの空ファイルですが、このファイルは `sql_app` とそのモジュール (Python ファイル) がパッケージであることを Python に知らせます。

		では、それぞれのファイル/モジュールが何をするのか見てみましょう。


		### `SessionLocal` クラスの作成

		SessionLocal` クラスの各インスタンスがデータベースセッションになります。このクラス自身は、まだデータベースセッションではありません。


		では、クラスを返す関数 `declarative_base()` を使ってみましょう。

		後で、このクラスを継承して、各データベースモデルやクラス（ORMモデル）を作成します:


		そして、Alembicを「マイグレーション」にも使うことになります（それが主な仕事です）。

		マイグレーション "とは、SQLAlchemy のモデルの構造を変更したり、新しい属性を追加したりするたびに、それらの変更をデータベースに再現し、新しいカラムやテーブルを追加するために必要な一連のステップのことです。


		## すべてのファイルを確認する

		my_super_project`というディレクトリがあり、その中に `sql_app` というサブディレクトリがあることを思い出してください。


		そしたら、ブラウザで <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a> を開けます。

		そして、実際のデータベースからデータを読み出しながら、FastAPIアプリケーションと対話することができるようになります:


		この場合、すべてのリクエストを通じて単一のデータベースセッションが使用され、その後（ミドルウェアで）クローズされることを保証するのに役立ちます。

		### yield` やミドルウェアとの依存関係

		@@ -0,0 +1,787 @@
		# SQL (リレーショナル) データベース

		FastAPI では、SQL（リレーショナル）データベースを使用する必要はありません。

	FastAPI では、SQL（リレーショナル）データベースを使用する必要はありません。
	FastAPI では、SQL (リレーショナル) データベースは必須ではありません。


		FastAPI では、SQL（リレーショナル）データベースを使用する必要はありません。

		しかし、使いたいリレーショナルデータベースを使用することができます。

	しかし、使いたいリレーショナルデータベースを使用することができます。
	しかし、任意のリレーショナルデータベースを使用できます。


		ここでは、 <a href="https://www.sqlalchemy.org/" class="external-link" target="_blank">SQLAlchemy</a>を使った例を見てみましょう。

		以下のような、SQLAlchemyがサポートするどのようなデータベースにも簡単に適応できます。

	以下のような、SQLAlchemyがサポートするどのようなデータベースにも簡単に適応できます。
	以下のような、SQLAlchemyがサポートするデータベースを簡単に適応できます。


		そして、そのクラスの各インスタンスオブジェクトは、データベースの行を表します。

		例えば、 `orion_cat` (`Pet` のインスタンス) オブジェクトが `orion_cat.type` という属性を持つなら、そのカラムは `type` であると考えられる。そしてその属性の値は、例えば `"cat"` とすることができる。


		例えば、 `orion_cat` (`Pet` のインスタンス) オブジェクトが `orion_cat.type` という属性を持つなら、そのカラムは `type` であると考えられる。そしてその属性の値は、例えば `"cat"` とすることができる。

		これらのORMは、テーブルやエンティティ間の接続やリレーションを作成するツールも備えている。


		`item.dict()`

		そして、`dict` の key-value ペアを SQLAlchemy の `Item` へのキーワード引数として渡しています。次のように。

	そして、`dict` の key-value ペアを SQLAlchemy の `Item` へのキーワード引数として渡しています。次のように。
	そして次のように、`dict` の key-value ペアを SQLAlchemy の `Item` へのキーワード引数として渡しています。


		`Item(**item.dict())`

		さらに、Pydantic model が提供しない別のキーワード引数 `owner_id` を、渡します。次のように。

	さらに、Pydantic model が提供しない別のキーワード引数 `owner_id` を、渡します。次のように。
	さらに次のように、Pydantic model が提供しない別のキーワード引数 `owner_id` を渡します。

🌐 Add Japanese translation for docs/ja/docs/tutorial/sql-databases.md #5058

🌐 Add Japanese translation for docs/ja/docs/tutorial/sql-databases.md #5058

Conversation

Yoshino-Yukitaro commented Jun 22, 2022

codecov bot commented Jun 22, 2022 • edited

Codecov Report

github-actions bot commented Jun 22, 2022

komtaki left a comment

Choose a reason for hiding this comment

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as outdated.

This comment was marked as resolved.

This comment was marked as outdated.

This comment was marked as resolved.

This comment was marked as resolved.

github-actions bot commented Dec 5, 2022

github-actions bot commented Dec 5, 2022

Yoshino-Yukitaro commented Dec 5, 2022 • edited

komtaki left a comment

Choose a reason for hiding this comment

tokusumi left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

github-actions bot commented Dec 16, 2022

tiangolo commented Jun 26, 2023

tiangolo commented Jan 28, 2024

🌐 Add Japanese translation for `docs/ja/docs/tutorial/sql-databases.md` #5058

🌐 Add Japanese translation for `docs/ja/docs/tutorial/sql-databases.md` #5058

codecov bot commented Jun 22, 2022 •

edited

Yoshino-Yukitaro commented Dec 5, 2022 •

edited

	返す値は、SQLAlchemy のモデル、あるいは SQLAlchemy のモデルのリストであることに注意してください。
	返す値は、SQLAlchemy のモデル、あるいは SQLAlchemy のモデルのリストであることに注意してください。


		</div>

		そしたら、ブラウザで <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a> を開けます。

	そしたら、ブラウザで <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a> を開けます。
	そうすると、ブラウザで <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a> を開けます。

	* もっとも、ここでは `SQLAlchemy` の動作にはあまり問題はないでしょうけど。
	* もっとも、ここでは `SQLAlchemy` の動作にはあまり問題はないでしょう。