このページはCalíope 1.8を紹介しています。私がいま作っているバージョンです。1.7は、Mac、iPad、iPhone、Apple Watch、Apple TV、Apple Vision Pro向けにApp Storeで公開中です。それぞれの機能がどのバージョンで入ったかは変更履歴に書いてあります。

すべてのトピックに「Calíopeで開く」ボタンを追加します。アプリがインストールされている場合にのみ機能します。

ER図

ER図を生成

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

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

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

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

Apple Vision Proでは、ツールバーに「空間で開く」もあり、まわりの部屋に図を広げます。

SQL Server

SQL Serverでは、スキーマごとにセレクタの項目が1つずつあります(demo.dbo、demo.rrhh)。スキーマをまたぐ外部キーを見るには、もう一方を「+ DB」で追加します。2つのあいだの線は、2つのデータベースのあいだと同じく琥珀色で描かれます。

キーワード: 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つ目のデータベースのテーブルや、その後に作成したテーブル)は、ほかのテーブルの横にグリッド状に配置され、上に重なることはありません。

Apple Vision Pro:空間の図は独自の配置を持ちます。空間のパネルの「レイアウトを保存」はその配置を、同じくデータベースごとに、このデバイスだけに保存します。ツールバーのボタンはこちらの配置を保存します。

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

ER図を書き出す

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

場所: ER図 › 書き出す

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

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

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

図からDDLを表示

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

場所: ER図 › コンテキストメニュー › テーブルの構造を編集

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

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

VoiceOverで使うER図

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

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

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

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

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

空間に広がるER図

Apple Vision Proでは、テーブルがまわりに並ぶカードになり、外部キーがその間の線になります。

場所: ER図 › 空間で開く

Apple Vision Proでは、ER図のツールバーの「空間で開く」で、Calíopeのウインドウを見たまま、まわりの部屋に図を広げられます。テーブルはそれぞれ、名前、データベース、列(キーと型付き)を載せたカードになり、外部キーは一方のカードの列からもう一方のカードの列への線になります。空間が開いている間、同じボタンは「空間を閉じる」になります。

層:データベース(スキーマ)ごとに、まわりに専用の弧があり、その上に名前が表示されます。「+ DB」で加えたデータベースは最初の弧の後ろにある2つ目の弧になり、2つの間の線は一方からもう一方へ渡ります。

手で:カードをピンチして動かすと、弧に沿って滑ります。線もついてきます。カードをタップすると選択され、その線が琥珀色になり、ほかの線は薄くなり、横のパネルにリレーションシップの一覧と「DDLを表示」が出ます。これはCREATE TABLEを読み出し専用で表示します。「閉じる」を押すか、もう一度カードをタップすると、選択が解けます。

ジェスチャなしで:目の高さより下、目の前にあるパネルで、手でできることがすべてできます。「空間を閉じる」。「整列」は、すべてのカードをタブの図での位置に戻します(保存していない移動があれば先に確認します)。「レイアウトを保存」。「層」の下には層ごとのスイッチがあり、その層のカードと線を隠します。そしてフィルタ付きの「テーブル」の一覧。行をタップするのはカードをタップするのと同じで、行のメニューには「前面に移動」(カードを目の前に持ってきます)と「層に移動…」(立っている弧を変えます。データベースは変わりません)があります。

保存:このパネルの「レイアウトを保存」は3Dの配置を保存します。データベースごとに1つで、このデバイスだけです。同期はされません。次回、空間はその配置で開き、保存された位置のないテーブルはタブの図での位置から始まります。

空間は読むだけです。空間での操作がサーバを変えることはありません。外部キーは引き続き、タブで「新しい外部キーのリレーション…」から作成します。

空間はそのセッションに属します。セッションの接続が切れるか閉じると、空間も閉じ、タブにそう表示されます。空間は一度に1つです。別のセッションから開くと、最初の空間が閉じます。

VoiceOverでは、各カードはテーブル、データベース、列とリレーションシップの数を読み上げ、続いてリレーションシップを1つずつ読み上げます。カードを選択しているときは、関連するカードがそう伝えます。各列は型をすべて含めて、キーとともに読み上げられます。カードとパネルは文字サイズに合わせて大きくなります。

キーワード: Apple Vision Pro、visionOS、空間、イマーシブ、3D、カード、層、ER図、空間コンピューティング

空間に広がるER図の制限

空間が線付きで表示するテーブルの数、かかる時間、入るデータベースの数。

場所: ER図 › 空間で開く

線:テーブルが200個を超えると、空間はすべてのカードを線なしで開きます。読みやすく、すばやく組み立てられるようにするためです。手かパネルの一覧でカードを選ぶと、その線が表示されます。この状態の間、パネルにそう表示されます。

多数のテーブル:層のカードは、大きな文字サイズでも互いに重ならないよう、行に積み重ねられます。空間を組み立てている間、タブとパネルに、読み込み中のテーブルの数と経過時間が表示されます。

かかる時間:120個のテーブルと160個の外部キーで測りました。カードと線はおよそ3秒でそろい、アプリのメモリー使用量は約150 MB増えます。

データベースは2つまでです。タブと同じく、メインのデータベースと「+ DB」で加えたデータベースで、それぞれ専用の層に置かれます。

キーワード: Apple Vision Pro、空間、制限、テーブル、線、パフォーマンス、メモリー、2つのデータベース

複数データベースの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、青いヘッダ、ティールのヘッダ、オレンジの矢印