はじめに
このセクションのトピック
アプリケーションの概要と基本的な作業の流れ。
Calíopeは、macOS、iPad、iPhone、Apple Vision Proで動くMySQL、MariaDB、TiDB、PostgreSQL、Microsoft SQL Server、Oracle Database、ClickHouse、MongoDB、Redis、Valkey、Apache Cassandra、ScyllaDB、Elasticsearch、OpenSearchのネイティブクライアントです。基本的な作業の流れは2つの画面を中心に進みます。サーバのプロファイルを管理する接続マネージャと、接続を確立すると開くワークスペースです。
ワークスペースには、「ツール」サイドバー (スキーマツリーはSQLエディタの中にあります)、複数のツールを同時に開くためのタブバー、使えるすべてのツールへのクイックアクセスツールバーがあります。
キーワード: はじめに、概要、紹介、Calíopeとは、スタートガイド、ようこそ
1つのファイルで、データ投入済みのテストサーバを40台以上起動できます。どれを起動するかは自分で選べます。
手元にサーバがない場合や、自分のサーバに向ける前にCalíopeで何ができるかを見たい場合は、私がアプリの開発に使っているテスト環境そのものを起動できます。ファイルは1つだけ で、必要なのはDockerだけです。
→ caliope-testbed.commandをダウンロード
必要なもの 。Docker Desktop (個人利用は無料、docker.comで入手できます)を入れたMacと、ディスクの空き容量です。すべてを起動すると約45 GBで、そのうち14 GBがOracleのイメージです。負荷ジェネレータが書き込みを続けるため、この容量は時間とともに増えます。メモリーは起動するものによって変わります。すべてを起動するとDocker用に約25 GBが必要で、SQL ServerもOracleも空きが2 GB未満では起動しません。起動する前に、選んだ構成に必要なメモリーとDockerに割り当てられているメモリーを、ランチャー自身が教えてくれます。
起動のしかた 。いちばん確実なのは、次の4行をターミナルに貼り付ける方法です。
cd ~/Downloads
curl -fLO https://caliope.org/caliope-testbed.command
chmod +x caliope-testbed.command
./caliope-testbed.command
ブラウザでダウンロードしたい場合は、さらに2つの手順がこの順序で必要です。実行可能にすること(ダウンロードしたファイルにchmod +x)と、初回はダブルクリックではなく「右クリック 」›「開く 」で開くことです。macOSはブラウザでダウンロードしたものを隔離するからです。curlならどちらも必要ありません。
まず、何を起動するかを尋ねます 。ターミナルで開くと、ランチャーがエンジンを一緒に順に確認していきます。必要なものの番号を入力し、それぞれについて「最小限 」「すべて 」「カスタム 」から選びます。各部分の容量は横に表示されます。依存関係は自動で解決されます。トンネルのノードを選べばSSH踏み台が、ClickHouseの2つ目のシャードを選べばレプリケーションのペアが一緒に付いてきます。続いて、選んだエンジンのサンプルデータセット(MySQLとMariaDBにはSakila 、PostgreSQLにはPagila 、MongoDBにはAtlas のサンプル)を提案します。これらはコンテナの起動中にバックグラウンド でダウンロードされ、ノードが起動ししだい読み込まれます。すでに読み込まれていれば、再びダウンロードすることはありません。完了したものは、ターミナルの1行とmacOSの通知で知らせます。次回は、どの回答も前回の回答がデフォルトになり、Enter キーで前回とまったく同じ起動を繰り返せます。以前から動いていて今回選ばなかったものは、データを残したまま停止します。
作業中は何をしているかを伝え、終わると、アドレス、ポート、資格情報、各レプリケーショングループの状態をまとめたレポートを表示します。
起動できるもの 。40台を超えるサーバで、Calíopeのどのツールにも表示するものがあるように選んであります。
エンジン ノード
MariaDB プライマリ1台とレプリカ4台(うち2台はカスケード 構成で、4台目が3台目から読み込みます)、SSHトンネル経由でのみ 到達できる5台目、スタンドアロン1台
MySQL 最新バージョン、空間データベースを2つ持つMySQL 8、MySQL 8.4 LTSのレプリケーショングループ (プライマリ1台とレプリカ2台)
TiDB 最小構成のクラスタ(PD、TiKV、SQLノード)としてのTiDB 8.5 LTS。データ入りで、SSHトンネル経由でも到達でき、同じクラスタにTLS付き の2つ目のSQLノードがあります
SQL Server データ入りのSQL Server 2025と、復元を試すための空のもの
Oracle DEMOスキーマとRRHHスキーマを持つOracle AI Database 26ai Free(SSHトンネル経由でも到達可能)と、TCPS専用 のもう1台
PostgreSQL PostGIS入りの1台と、ストリーミングのプライマリ・レプリカのペア
ClickHouse データ入りの1台、HTTPS専用 の1台、SSHトンネル経由でのみ到達できる1台、レプリケーションのペア、そのペアと2シャード のクラスタを組む2つ目のシャード
MongoDB 認証付きの1台、TLS専用 の1台、3メンバー のレプリカセット
Redis データ入りの1台、TLS専用 の1台、SSHトンネル経由でのみ到達できる1台、6ノードのクラスタ
Valkey Redisと同じデータを持つValkey 9.1、TLS専用 の1台、6ノードのクラスタ
Cassandra データ入りで、パスワード認証、マテリアライズドビュー、ユーザ定義関数を有効にしたApache Cassandra 5.0(SSHトンネル経由でも到達可能)、TLS専用 のもう1台、3ノード のリング
ScyllaDB Cassandraと同じデータを持ち、パスワード認証とスロークエリーログを有効にしたScyllaDB 2026.3と、TLS専用 のもう1台
Elasticsearch データ入りで、HTTP上のパスワード認証とスナップショット用ディレクトリを備えたElasticsearch 9.5(SSHトンネル経由でも到達可能)、HTTPS専用 のもう1台、3ノード のクラスタ
OpenSearch Elasticsearchと同じデータを持ち、セキュリティプラグインを備えたHTTPS専用 のOpenSearch 3.9と、プラグインなしのもう1台
さらにSSH踏み台と、常に動いている負荷ジェネレータがあるので、ダッシュボード、スロークエリーログ、プロセスリスト、レプリケーションモニタ、トポロジに表示する実際のトラフィックがあります。
プロファイルを手入力する必要はありません 。実行するたびに、起動したノードを1つのグループにまとめたcaliope-testbed-connections.jsonファイルがランチャーの横にできます。Calíopeでは「設定 」›「接続 」›「読み込む 」を使います。読み込みは結合 なので、すでにあるものは何も削除されません。各プロファイルにはユーザとパスワードがすでに入っています。ほとんどはcaliopeとcaliopepassで、ClickHouseはcaliope_admin、SQL ServerはsaとCaliope!pass1、OracleはsystemとCaliope_pass1です。トンネル経由のプロファイル(最大7つ)は、初回にSSHパスワード(tunnel123)を尋ねます。SSHの秘密情報はキーチェーンにしか保存しないからです。
iPadやiPhoneからも使えます 。各プロファイルにはMacのネットワークアドレスが代替ホストとして入っているので、同じファイルが何も編集せずにすべてのデバイスで使えます。Macがスリープしておらず、テストベッドが動いていて、両方が同じネットワークにあることが条件です。
別のマシンで 。--remoteを付けると、同じランチャーがネットワーク上の別のマシン(SSHで入れるLinuxマシン)のDockerでテストベッドを起動し、初回はそのマシンの準備もします。アドレスとユーザを尋ね、SSH鍵をインストールし、なければDockerもインストールします。こうすれば、使うメモリーとCPUはMacのものではなくなります。
コマンド 。
内容 方法
選んで起動 ./caliope-testbed.command
何も尋ねずにすべて起動 ./caliope-testbed.command --all
状態を確認 ./caliope-testbed.command --status
データを残して停止 ./caliope-testbed.command --stop
すべて消去して作り直す ./caliope-testbed.command --fresh
--freshには注意してください。破壊的で、影響はCalíopeの外にも及びます 。そのマシンのすべての Dockerコンテナを停止し、使われていないイメージ、ボリューム、キャッシュを、ほかのプロジェクトのものも含めて削除します。何かに手を付ける前に、そのことを伝えて確認を求めます。
作業用のサーバではありません 。パスワードは公開されていてファイルそのものに書かれており、何も暗号化されておらず、すべてがあなたのマシンで待ち受けます。これはテストベッドです。学ぶため、自分のデータで使う前にツールを試すため、そして不具合の報告を再現できるようにするためのものです。
キーワード: Docker、テスト、テストベッド、サンプル、サーバなし、デモ、練習、sakila、レプリケーション、ウィザード、TiDB、Cassandra、ScyllaDB
実際の商品と画像を収めた約80 MBのSQLiteファイル。SQLiteエディタとファイルプレビューで使えます。
大きくて現実的なファイルでCalíopeがどう動くかを見たい場合や、サーバが手元になくてもSQLiteエディタとファイルプレビューを試したい場合は、データ入りのサンプルデータベースをダウンロードできます。
→ caliope-demo.dbをダウンロード
中身 。関連する2つのテーブルに分かれた約80 MBのデータです。productosには約1,500点の商品(名前、説明、価格、在庫、登録日、カテゴリ、いくつかのJSON属性)が、imagenesには商品ごとに数枚の実際の写真が入っています。どれも本物のPNGで、埋め草ではありません。インデックス、2つのテーブルの間の外部キー、両者を結合するビュー(vista_catalogo)もあります。
カテゴリ、説明、属性のない商品もあります。これは意図的なもので、NULL値がどう見えるかを確認できます。
テキストはすべてスペイン語 で、アクセント記号、ñ、ときどき絵文字も含まれているので、UTF-8が正しく扱われているかをひと目で確認できます。
開きかた 。ダウンロードして、SQLiteエディタの「開く… 」で開きます。ほかの.sqliteや.dbファイルと同じように扱われ、接続は必要ありません。
自動では更新されません 。静的なファイルで、作り直すたびにサイズが少し変わることがあります。
キーワード: SQLite、デモ、サンプル、例、画像、BLOB、テスト、サーバなし、オフライン、UTF-8
プロファイルを作成し、サーバへの最初の接続を確立します。
場所: 接続マネージャ › 「+」ボタン
接続マネージャで、サイドバーの「+ 」ボタンをタップして新しいプロファイルを作成します。ホスト、ポート(フォームが各エンジンのデフォルトを提案します)、ユーザ名、パスワードを入力します。保存する前に「接続をテスト 」をタップして、入力内容を確認します。
確認できたら「接続 」をタップしてワークスペースを開きます。プロファイルは保存され、次回以降の接続のために一覧に残ります。
キーワード: はじめて、新規接続、プロファイル、ホスト、ポート、接続
「ツール」サイドバー、タブ、サーバの切り替え、ステータスバーの使いかた。
ワークスペースには3つの領域があります。左の「「ツール」サイドバー 」、開いているツールが並ぶタブバー 、下部のステータスバー です。
ツールを開くには、サイドバーでその行をクリックします。ツールはそれぞれ専用のタブで開きます。複数を開いたままにして、Macでは⌘} と⌘{ (iPadでは⌘] と⌘[ )で切り替えられます。行はテーマごとにグループにまとめられ、順序とグループはサイドバー自体にある「⋮≡ 」ボタンから調整します(「メインツールバーのカスタマイズ 」を参照)。各グループは見出しをクリックすると折りたたまれ、サイドバー上部のフィールドでツールを名前で絞り込めます(「「ツール」サイドバーの絞り込みと折りたたみ 」を参照)。
サーバの切り替え :アクティブなサーバの名前が付いたメニューは、左上(macOS)またはタブバーの左(iPad)にあります。iPhoneでは「ツール 」リストの一番上にもあります。そこからセッションを切り替えたり、別のサーバを追加したり、接続を解除したりできます。Calíopeは複数の接続を同時にアクティブにできます。
サイドバーを隠す :タイトルバーのボタンでサイドバーを折りたたみ、アクティブなツールに全幅を使わせます。
スキーマツリーはここにはありません :スキーマツリーは、それが役に立つ唯一の場所であるSQLエディタの中にあります。
オフライン :サーバなしのワークスペースには、接続のいらないもの(SQLエディタ、スニペット、SQLiteエディタ、DuckDBエディタ、ファイルプレビュー、エラー、レポート)を並べたクイックアクセスの帯が表示されます。右端のシェブロンで折りたためます。
iPhoneと幅の狭いウインドウでは :ツールは下部のバー に置かれ、並び順の最初の4つと、残りのための「その他 」ボタンが表示されます。どの4つにするかは自分で決められます。サイドバーを並べ替えてください。
Apple Vision Pro :ツールのナビゲータはウインドウの外、その左側に浮かび、その上にタブバーがあります。先頭にはサーバの切り替え、末尾にはアクティビティ、スリープさせない、ヘルプ、設定が並びます。各ツールのヘッダはウインドウの下に浮かびます。サイドバーを隠すタイトルバーのボタンはなく、「表示 」メニューで隠します。「Apple Vision ProのCalíope 」を参照してください。
キーワード: ワークスペース、サイドバー、ツール、タブ、ナビゲーション、サーバの切り替え、ステータスバー、オフライン
ナビゲータに並ぶツールは、変更した設定ではなく接続によって決まります。
ツールのナビゲータに並ぶ一覧は、いつも同じではありません。表示されるのはこのセッション でできることです。接続すると、Calíopeはその接続で何ができるかを判断し、それ以外を非表示にします 。見えないものは壊れているのでも、オフになっているのでもありません。提供されていないだけです。
非表示にするのは意図的です。開いてから「ここにはありません」と言うだけのツールは、すでに手間を無駄にさせています。また、グレイ表示の行があると、それをオンにするスイッチを探したくなりますが、そんなスイッチはありません。
データベースの種類によるもの 。リレーショナルのサーバとドキュメント型のサーバは同じではありません。ドキュメントのセッションにはSQLエディタもER図もなく、リレーショナルのセッションにはコレクションブラウザがありません。これは変わることがなく、どちらの欠点でもありません。
その接続でできることによるもの 。リレーショナルのサーバどうしでも、提供するものがまったく同じわけではありません。エンジンにその概念がない場合は、表示するものがないので、そのサーバではツールが表示されることはありません。Calíopeがそのエンジン向けにまだ作っていない場合は、今後のバージョンで表示されます。どちらの不在も意図的に同じに見せています。いま知る必要があるのは、ツールが使えるかどうかであって、使えない理由ではないからです。
接続のタグによるもの 。接続に読み出し専用の環境タグが付いている場合は、書き込みしかしないツール(テーブルビルダー、ユーザ管理、テーブルメンテナンス、データ移行)も非表示になり、それらを開こうとすると、ステータスバーがセッションは読み出し専用だと伝えます。タグを変更すれば、再接続しなくても元に戻ります。
接続がない場合 、ナビゲータにはサーバなしで使えるものだけが表示されます。SQLエディタ、スニペット、SQLiteエディタ、DuckDBエディタ、ファイルプレビュー、エラー、レポートです。レポートは半分だけで、サーバがないと表示、編集、書き出しはできますが、実行はできません。
ほかに気づく場所 。このヘルプの「移動 」ボタンが、セッションで提供されていないツールを指していることがあります。その場合は何も開かず、ステータスバーがそのツールの名前を挙げて伝えます。これは失敗ではなく、答えです。
そして、このヘルプにはすべての ツールが載っています。目次は接続しているサーバによって変わらないので、現在のセッションに表示されないツールのトピックもここにあります。見当たらないツールがあれば、別のサーバでセッションを開いてみてください。一覧は接続するたびに計算し直されます。
キーワード: ツール、見つからない、表示されない、ナビゲータ、利用可否、エンジン、セッション、非表示、移動
使わないグループを折りたたみ、上部のフィールドに入力して、ツールを名前で探します。
「ツール」サイドバー は、Calíopeのすべてのツールをテーマごとにまとめています。サイドバーを短くする方法は2つあります。
グループを折りたたむ :見出しをクリックします。シェブロンが回転して、グループの行が消えます。名前の横に、隠れているツールの数が表示されるので、跡形もなく見失うことはありません。もう一度クリックすると展開します。折りたたんだ状態はアプリを閉じても記憶され、iCloud同期がオンなら、ほかのMac、iPad、iPhoneにも反映されます。
絞り込む :サイドバー上部のフィールドに入力すると、一致するツールだけが残ります。検索の対象は、ツールの名前、カタログでの正式な名前、何をするツールかを説明する文、そしてグループの名前です。そのため、グループの名前を入力するとそのグループ全体が表示されます。アクセント記号の有無は区別しません。
絞り込んでいる間は、一致するものがあるグループはすべて開いた状態で表示されます 。折りたたんでいたグループも同じです。見つかったものが閉じたグループの中に隠れたままになることはありません。折りたたんだグループの設定は変わりません。フィールドを消去すれば、すべてが元どおりに戻ります。
Esc キーを押すか「× 」をクリックするとフィールドが消去されます。絞り込みはアプリを閉じると記憶されません。覚えていない理由で半分空のサイドバーが開くよりは、3文字を入力し直すほうがましだからです。
キーワード: サイドバー、ツール、フィルタ、検索、グループ、折りたたむ、展開
どのサーバにも接続せずに使えるものと、使えないもの。
Calíopeには、どのサーバにも接続していなくても使えるオフラインのワークスペース があります。接続がなくても、クエリーの下書きやスニペットの整理に役立ちます。
開きかた :
接続マネージャから、どのサーバにも接続せずに開きます。ボタンの場所は画面の広さによって変わります。広い画面(MacとiPad)では、ようこそ画面の「プロファイルを作成」の横にあります。狭い画面(iPhoneと、分割ウインドウのiPad)ではその画面自体が表示されないので、下部のバー にターミナルのアイコンで置かれています。
オフラインモードで使えるツール :
- SQLエディタ :SQLを書いて保存し、履歴とスニペットを使えます。サーバに対してクエリーを実行することはできません。
- スニペット :コードスニペットを作成、編集、コピーします。
- SQLiteエディタ :ディスク上の.sqliteファイルを開いて、そのすべてを扱います。ファイルそのものがデータベースなので、サーバは必要ありません。
- DuckDBエディタ :.duckdbファイル、またはメモリー内データベースに読み込んだCSV、JSON、Parquetファイルを開き、サーバなしでデバイス上でクエリーを実行します。
- ファイルプレビュー :CSV、JSON、Markdownなどを、アプリを離れずに表示します。
- エラー :ログはローカルにあり、接続できないときこそ読める必要があります。
- レポート :すでにある結果を表示、編集、書き出しできます。実行にはサーバが必要で、画面にそのことが表示されます。
オフラインモードの帯 :ワークスペースの上部にある金色の帯が、オフラインモードであることを示します。
オフラインのワークスペースからサーバに接続するには、Macではウインドウのツールバーの「サーバに接続 」をクリックします。接続マネージャが専用のウインドウで開きます。iPad、iPhone、Apple Vision Proでは上部のバーの「接続 」をタップします。接続マネージャがシートで開きます。どちらの場合もエディタの内容は保たれます。オフラインの帯は知らせるだけで、ボタンはありません。
キーワード: オフライン、オフラインモード、サーバなし、オフラインのエディタ、オフラインのワークスペース、接続なしのエディタ、スニペット
実行中の操作の結果、所要時間、進行状況を表示します。
ステータスバーはワークスペースとSQLエディタの下部に表示され、最後に実行した操作の状態を反映します。
表示される情報 :
- 結果メッセージ :最後の操作を説明するテキスト(影響を受けた行数、実行時間、エラー)。
- 進行状況 :クエリーやタスクの実行中に表示されるプログレスバーや読み込みアニメーション。
- パーセント :時間のかかる操作(バックアップや復元など)では、進行状況を数値で表示します。
メッセージをコピーする :
macOS :ステータスバーのテキスト部分をダブルクリック すると、メッセージ全体がクリップボードにコピーされます。エラーメッセージを手作業で選択せずにコピーしたいときに便利です。
iPad :同じようにダブルタップすると、メッセージがコピーされます。
ステータスバーは常に表示され、隠すことはできません。
キーワード: ステータスバー、進行状況、メッセージ、メッセージをコピー、エラー、実行時間、ダブルクリック
エディタのツールバーと結果のツールバーのボタンを並べ替えます。
場所: SQLエディタ › ツールバーをカスタマイズ
SQLエディタ には専用のツールバーが2つあり、それぞれ別々にカスタマイズできます。
- エディタのツールバー :テキスト領域の上にあります。実行、整形、コメント、履歴、スキーマパネル…
- 結果のツールバー :グリッドの上にあります。書き出し、グラフ、列のプロファイラ、フィルタ…
カスタマイズ画面を開く
調整したいツールバーの先頭にある「⋮≡ 」ボタン(slider.horizontal.3アイコン)をクリックします。
できること
- 並べ替え :ボタンの各グループを好きな位置にドラッグするか、コンテキストメニューの「上へ移動 」と「下へ移動 」を使います。
- リセット :そのツールバーを元の配置に戻します。
どちらのツールバーも横にスクロールできるので、ウインドウがどれほど狭くても、手の届かないボタンはありません。
ワークスペースのツールランチャーについては、「メインツールバーのカスタマイズ 」を参照してください。
キーワード: エディタのツールバー、結果のツールバー、カスタマイズ、並べ替え、ボタンを非表示、ドラッグ、SQLエディタ
ワークスペースのメインツールバーのボタンを並べ替えて、よく使うツールを先頭に置きます。
場所: ワークスペース › メインツールバーをカスタマイズ
ナビゲーションサイドバー は、ワークスペースのすべてのツールをテーマごとのグループ (開発とクエリー、設計とスキーマ、診断とパフォーマンス、サーバ管理…)にまとめています。出荷時の配置は出発点にすぎません。グループ、その順序、各グループに入れるものは、ここで変更します。
カスタマイズ画面の開きかた
- ナビゲーションサイドバーの下部、パフォーマンス表示の横に、カスタマイズボタン「⋮≡ 」(slider.horizontal.3アイコン)があります。
- これをクリックすると、カスタマイズ画面が開きます。
できること
カスタマイズ画面には、階層的で自由に変えられる操作が2つのタブに分かれて用意されています。
- 「グループを並べ替え」タブ :セクション全体をドラッグ・アンド・ドロップしてカテゴリの配置を変えたり、名前を変更したり、独自のカスタムグループを追加したりできます。
- 「項目を並べ替え」タブ :各グループの中で個々のツールをドラッグ・アンド・ドロップするか、「移動先… 」をタップして、任意のツールを別のセクションへ移動できます。
- リセット :「リセット 」ボタンで、標準の配置とグループをワンタップで元に戻します。
保存と自動修復
配置はUserDefaults(キーcaliope_sidebar_config_macosまたはcaliope_sidebar_config_ipad)に安全に保存されます。今後のアップデートでCalíopeに新しいツールが加わると、カスタマイズした順序を崩さずに、デフォルトのカテゴリに自動で登録されます。
キーワード: メインツールバー、クイックアクセス、ナビゲーションバー、カスタマイズ、並べ替え、ボタン、ドラッグ、オーバーフロー
それぞれのコンテキストを失わずに、複数のサーバを同時に扱います。
場所: サーバメニュー › サーバを追加
Calíopeは、接続するサーバごとに独立したセッション を保ちます。各セッションには、専用のタブ、アクティブなデータベース、クエリーの履歴があります。
別のセッションを開く
- サーバメニュー (macOSではウインドウのツールバー、iPadではタブバーの左)を開き、「サーバを追加 」を押します。接続マネージャが開くので、プロファイルを選んで「接続 」を押します。すでにあるセッションは開いたままです。
セッションを切り替える
- 同じメニューで、移りたいサーバを押します。各セッションには、プロファイル名と状態を示す色付きの点が表示されます。
- サーバメニューはメニューバーにはありません。ウインドウごとに別のセッションを見ていることがあるので、ウインドウの中にあります。
セッションごとの状態
- 各セッションは、アクティブなデータベース 、開いているタブ 、クエリーの履歴 を記憶します。
- SSHトンネル と暗号化はセッションごとに一度だけ設定されます。セッションを切り替えても再接続はしません。
- ウィジェット は、どのセッションが前面にあっても、「設定 」›「ウィジェット 」で固定したプロファイルに従います。
セッションを閉じる
- サーバメニューまたは「ファイル 」メニューの「接続解除 」(⌘⇧D)で、アクティブなセッションと、あればそのSSHトンネルを閉じます。
- パスワードはキーチェーンに残ります。生体認証をオンにしていなければ、再接続するときにもう一度尋ねられることはありません。
キーワード: セッション、マルチセッション、複数のサーバ、同時、セッションの切り替え、サーバセレクタ、セッションを追加、セッションマネージャ、⌘⌥N、接続解除
各プラットフォームでヘルプの目次全体を開く方法。
場所: ヘルプ › Calíopeヘルプ
Calíopeのヘルプは、目次、検索、セクションのナビゲーションを備えた専用のウインドウまたはパネルとして使えます。開きかたはプラットフォームによって違いますが、内容は同じです。
macOS :「ヘルプ 」›「Calíopeヘルプ 」メニュー、またはショートカット「⌘? 」で開きます。ヘルプウインドウは手前に浮かんだままで、アプリのほかの部分を使っている間も開いておけます。
iPad :「ヘルプ 」›「Calíopeヘルプ 」メニュー、または外部キーボードを接続していればショートカット「⌘? 」で開きます。ヘルプはシートとして表示されます。右上の「閉じる 」ボタンで閉じるか、下にスワイプします。
コンテキストヘルプ(?) :アプリのどの画面にも、上部のバーに「? 」ボタンがあり、関連するトピックを直接開きます。探しているツールがすでにわかっているなら、これがいちばん早い方法です。
Webでは :同じヘルプが<https://caliope.org/help/>で、すべての対応言語で公開されています。そこで「Calíopeをインストール済み」をオンにすると、各トピックにアプリでそのトピックを開く「Calíopeで開く」ボタンが表示されます。トピックのリンクはcaliope://help/<identifier>の形式です。
Apple Vision Pro :ヘルプはiPadと同じシートですが、visionOSのシートは下にスワイプしても閉じません。「閉じる 」(?やエラーから開いた場合は「完了 」)で閉じてください。
キーワード: ヘルプ、ヘルプセンター、目次、トピックを検索、ヘルプメニュー、⌘?、ドキュメント、cmd?
トピックをエンジンで絞り込み、トピックからそのツールへ移動し、SQLの例をエディタへ送ります。
目次のヘッダにある「すべてのエンジン 」メニューで、1つのエンジンのトピックと、すべてのエンジンに当てはまるトピックだけを残せます。エンジンを選ぶと、そのファミリーに属するものも含まれます。Auroraで絞り込むとMySQLのトピックも表示されます。フィルタはヘルプを開き直しても記憶されており、「フィルタを消去 」で解除します。
場所が示されているトピックのヘッダでは、「移動 」でヘルプを閉じて、そのツールまたは設定を開きます。
DBAハンドブックの各SQLブロックでは、「エディタで開く 」で例を開いているセッションのSQLエディタに読み込みます。Mac以外ではヘルプも閉じます。
キーワード: ヘルプ、フィルタ、エンジン、移動、例、SQL、エディタ
ウインドウが狭いと、ツールは下部のバーに入ります:あなたの並び順の最初の4つと、残りは「その他」に。
ウインドウが狭いと、サイドバーは描画されず、ツールは下部のバーに移ります。カスタマイズ画面で選んだ並び順の最初の4つがそこに入り、残りは「その他 」に入ります。カスタマイズ画面で並び順を変えると、見えるツールが変わります。
Macにはこのバーはなく、Apple Vision Proではナビゲータがそのオーナメントに入ります。
キーワード: 下部バー、ツール、その他、狭い画面、カスタマイズ
セッションの接続が切れると「接続が切れました」が表示されます:接続マネージャに戻るか、タブをそのままにしておけます。
セッションの接続が切れると、「接続が切れました 」のアラートが表示されます。
「ホームに戻る 」はセッションの接続を解除して接続マネージャに戻ります。「キャンセル 」はアラートを閉じ、タブをそのままにします。
キーワード: 接続の切断、接続解除、セッション、戻る