ER図

データベースのテーブル同士の関係を視覚化します。

場所： ワークスペース › ツール › ER図

ワークスペースのナビゲーションバーから「ER図」を開きます。上部のセレクタでデータベースを選ぶと、Calíopeがテーブルを列と既存の外部キーの関係とともに読み込みます。

図では、テーブルが列とデータ型を持つノードとして表示されます。テーブル間の線は、サーバで検出された外部キーを表します。

キーワード： ER、実体関連、図、FK、外部キー、関係、ERD

図の表示を拡大、縮小、スクロールします。

場所： ER図 › キャンバス

拡大と縮小 — macOSでは、マウスホイール、トラックパッドでの2本指のピンチ、またはツールバーのボタン。iPadでは、ピンチか同じボタンです。ツールバーの−と+のあいだにあるパーセントが現在の倍率を示し、ショートカットは⌘−、⌘+、⌘0です。範囲はどこでも同じで18%から400%まで、どちらかの端に達するとボタンが淡色表示になります。

キャンバスのスクロール — どこでも、何もない場所をドラッグします。ノードの上でドラッグすると、代わりにテーブルが移動します。

図全体に戻す — 「ウインドウに合わせる」ボタン（⌘0）ですべてのテーブルが収まります。図は、開いたときとウインドウのサイズを変えたときにも自動で収まり直します。

「自動レイアウト」ボタンは、重なりが最小になるようにノードを並べ替えます。

Apple Vision Pro：iPadと同じで、独自のジェスチャがあります。スクロールやテーブルの移動はピンチして動かす、拡大縮小は両手でピンチです。ボタンとショートカットは同じです。

キーワード： 拡大縮小、パン、スクロール、拡大、縮小、キャンバス、移動

2つのテーブルのあいだに外部キーの関係を新しく描きます。

場所： ER図 › 右クリック › 外部キーの関係を作成

テーブルのコンテキストメニューを開き（macOSでは右クリック、iPadでは長押し）、「新しい外部キーのリレーション…」を選びます。ダイアログが開き、参照元のテーブルと列、参照先のテーブルと列を選びます。確定すると、CalíopeがサーバでALTER TABLE … ADD FOREIGN KEYを実行します。

macOSのみ、さらに次の方法もあります：「⌃（Control）」を押したまま、テーブルから参照先のテーブルへドラッグします。ジェスチャに合わせて線が伸び、指を離すと同じダイアログが開きます。iPadにはこのジェスチャがなく、外部キーはコンテキストメニューから作成します。

Apple Vision Pro：iPadで長押しするのと同じように、テーブルを見てピンチしたまま押さえます。Controlキーを押しながらのドラッグはMacのみです。

キーワード： FK、外部キー、関係を作成、ALTER TABLE、参照整合性

図に付けた配置を、データベースごとに1つずつ保持します。

場所： ER図 › レイアウトを保存

ER図のツールバーで「レイアウトを保存」をクリックします。各テーブルをドラッグした位置はデータベースごとに保存されるので、図はそれぞれ自分の配置を保ちます。

次にそのデータベースの図を開くと、テーブルは置いた場所に戻ります。保存された位置のないテーブル（「+ DB」で追加したばかりの2つ目のデータベースのテーブルや、その後に作成したテーブル）は、ほかのテーブルの横にグリッド状に配置され、上に重なることはありません。

キーワード： レイアウト、位置、保存、永続化、ノード、配置、UserDefaults

図をPNG画像またはPDFとして保存します。

場所： ER図 › 書き出す

ER図のツールバーの「書き出す」ボタンには2つの形式があります：PNG（画像。書類やチャットにそのまま貼り付けられます）とPDF（プリントやプレゼンテーション向け）。それぞれ3つのサイズがあります。Macではシステムのダイアログでファイルの保存先を選びます。それ以外では「共有」シートが開き、そこから「ファイル」に保存したり送信したりします。

Macでは、同じ形式がキャンバスのコンテキストメニューにもあり、⌘Pで図をプリントできます。

キーワード： 書き出し、PNG、PDF、画像、保存、プリント、図

テーブルの構造全体を、図から直接確認します。

場所： ER図 › 右クリック › テーブルの構造を編集

図のテーブルノードでコンテキストメニューを開き（macOSでは右クリック、iPadでは長押し）、「テーブルの構造を編集」を選びます。選んだテーブルの完全なCREATE TABLE文を表示するパネルが開きます。

キーワード： DDL、CREATE TABLE、構造、テーブルを表示、SHOW CREATE、テーブル定義

キャンバスは絵です。VoiceOverはこれを、列・型・キーを持つテーブルの一覧と、関係の一覧として読み上げます。

場所： ワークスペース › ツール › ER図

図のキャンバスはVoiceOverが読めない絵なので、Calíopeはそれを一覧として提供します。「テーブル」セクションにはテーブルごとに1行があり、列、その型、そして各列が主キー（PK）や宣言された外部キー（FK）に属するかどうかを示します。リレーションがある場合、「リレーション」セクションはそれぞれを「参照元 → 参照先」として、データベース、テーブル、列とともに読み上げます。

どのプラットフォームでも同じように動作します。

キーワード： VoiceOver、アクセシビリティ、ER図、テーブル、関係

ER図のキャンバスに2つ目のデータベースを追加して、データベースをまたぐ関係を視覚化します。

場所： ER図 › + DB

ER図では、2つのデータベースのテーブルを同じキャンバスに同時に表示でき、一方のデータベースからもう一方へまたがる外部キーも表示できます。

2つ目のデータベースを追加するには：
1. ER図を開いた状態で、ツールバーの左側のセレクタで主データベースを選びます。
2. ツールバーの「+ DB」ボタンをクリックして、2つ目のデータベースを追加します。
3. 新しく表示されたセレクタで2つ目のデータベースを選びます。
4. キャンバスが自動で更新され、両方のデータベースのテーブルが表示されます。

色分け：
- 青いヘッダ — 主データベースのテーブル。
- ティールのヘッダ — 2つ目のデータベースのテーブル。
- オレンジの矢印 — 一方のデータベースからもう一方へまたがる外部キーの関係。
- 通常の矢印 — 同じデータベース内の関係。

データベースをまたぐ関係の条件：
外部キーはサーバで宣言されている必要があります。図はエンジンのカタログから外部キーを読み取ります。データベースをまたぐ関係が表示されない場合は、外部キーが命名規則だけでなく正式に存在するかを確認してください。

移動と書き出し：
通常のER図の機能は、複数データベースのキャンバスでもすべて使えます：拡大縮小、スクロール、自動レイアウト、レイアウトの保存、PNG/PDFへの書き出し、テーブルのDDLの表示。詳しくは「ER図」のトピックを参照してください。

macOS、iPad、iPhone、Apple Vision Proで使えます。

キーワード： ERD、複数データベース、データベース間、関係、2つ目のデータベース、外部キー、図、マルチDB、青いヘッダ、ティールのヘッダ、オレンジの矢印