[ja] cakephp#4114

Author: okinaka

ja/console-and-shells/schema-management-and-migrations.rst

@@ -1,7 +1,8 @@
 スキーマの管理とマイグレーション
 ################################
 
-スキーマシェルはスキーマオブジェクト、SQLダンプを作成したり、スナップショットを作成、保存する機能を提供します。
+スキーマシェルはスキーマオブジェクト、SQLダンプを作成したり、スナップショットを作成、
+保存する機能を提供します。
 
 スキーマファイルの作成と使用方法
 ================================
@@ -30,7 +31,8 @@ schema.php の中身に沿ってテーブルが再構成されるはずです。
  $ Console/cake schema dump --write filename.sql
 
 ここで filename.sql には SQL ファイルとして出力したいファイル名を指定します。
-filename.sql を省略すると、SQL のダンプはコンソールへ出力されますが、ファイルへ出力されることはありません。
+filename.sql を省略すると、SQL のダンプはコンソールへ出力されますが、
+ファイルへ出力されることはありません。
 
 CakeSchema のコールバック
 ==========================
@@ -203,6 +205,7 @@ type
 
 テーブルキー `indexes`
 ======================
+
 キー名 `indexes` は、フィールド名の代わりにテーブル配列の中に置きます。
 
 column
@@ -222,9 +225,9 @@ column
  'indexes' => array(
  'AB_KEY' => array(
  'column' => array(
- 'a_id', 
+ 'a_id',
  'b_id'
- ), 
+ ),
  'unique' => 1
  )
  )
@@ -315,18 +318,23 @@ CakePHP のスキーマシェルを使ったマイグレーション
 スキーマシェルは、現状のデータベースと更新元スキーマファイルの差分を表した
 ``ALTER`` 文を実行してもよいかどうか確認を促してくるでしょう。
 
-``--dry`` コマンドを付けることで、実際にファイルを更新することなく実行結果だけを確認することもできます（dry-run）。
+``--dry`` コマンドを付けることで、実際にファイルを更新することなく実行結果だけを
+確認することもできます（dry-run）。
+
+.. note::
+
+ 2.x のスキーマ生成は外部キー制約を処理しないことに注意してください。
 
 ワークフローの例
 ================
 
 スキーマの生成とコミット
 ------------------------
 
-バージョン管理を適用しているプロジェクトでは、Cake スキーマを以下のように使うことになるでしょう。
+バージョン管理を適用しているプロジェクトでは、cake schema を以下のように使うことになるでしょう。
 
 1. データベース内のテーブルを生成あるいは変更
-2. Cake スキーマを実行し、データベースの内容を全てエクスポート
+2. cake schema を実行し、データベースの内容を全てエクスポート
 3. 生成または更新された schema.php のコミット ::
 
  $ # 一度データベースを更新した後で
@@ -346,7 +354,7 @@ CakePHP のスキーマシェルを使ったマイグレーション
 リポジトリの最新の変更を取り入れ、データベース構造の変更点を見つけるには
 以下のようにします。
 
-1. Cake スキーマを実行し、データベースを更新してください ::
+1. cake schema を実行し、データベースを更新してください ::
 
  $ git pull
  $ Console/cake schema create
@@ -357,7 +365,7 @@ CakePHP のスキーマシェルを使ったマイグレーション
 ロールバック
 ------------
 
-現在のところ、Cake スキーマはデータベースの更新の取り消しや復元が必要な操作をサポートしていません。
+現在のところ、cake schema はデータベースの更新の取り消しや復元が必要な操作をサポートしていません。
 
 より具体的には、一度生成したテーブルを自動的に削除することができないようになっています。