Calíopeのサポートセンターへようこそ。私は、ネイティブの性能で動く、強力で反応のよいデータベース管理ツールを作っています。問題が起きているときや質問があるときは、下のよくある質問を見るか、直接ご連絡ください。
✉️ 直接のサポート
Calíopeのヘルプの全体(アプリに組み込まれているのと同じもの)を、ヘルプに、すべてのトピックと検索ボックスとともに公開しています。メールを書く前に見てみる価値があります:ほとんどの質問には、すでにそこで答えています。
キーボードショートカットは、コードから生成した一覧として、macOS用と外部キーボードを使うiPad用を公開しています。
問題が起きている、または購入について助けが必要ですか?メールを送ってください。たいてい1〜3営業日以内に返信します。機能のアイデアについては、下の機能を提案するをご覧ください。
メール:support@caliope.org- お使いのOSとそのバージョン(例:macOS 26.1 Tahoe、iPadOS 26.1)
- お使いのCalíopeのバージョン(Calíope → Calíopeについてで確認できます)
- 問題の簡単な説明と、再現する手順
- 表示されたエラーメッセージ、または問題がわかるスクリーンショット
💡 機能を提案する
Calíopeは、使っている人が求めるものから育っています。見てみたいものがあれば(新しいデータベースエンジン、時間の節約になるワークフロー、足りない言語、連携など)、教えてください。リクエストはすべて公開のロードマップに記録し、いちばん多く声が集まったものから次に取り組みます。
- 件名の最初をFeature request:にしてください。ロードマップの待ち行列に回せます。
- 思い描いている解決策だけでなく、解決したい問題を書いてください。
- どのくらいの頻度で、どのデバイスで使うかを書いてください。
- ほかのツールでその機能を見て、実装が気に入ったなら、そのリンクを付けてください。
📊 透明な診断とエラー報告
Calíopeでは、プライバシーが基本です。バックグラウンドで動く受け身のトラッカーも、第三者のウェブ解析も使っていません。その代わり、使用状況レポートをオンにすると、Calíopeはツールを開いた回数と実行時のエラーを、オープンで人が読めるJSONのログとして、あなたのデバイスに直接保存します。初期設定ではオフで、自動で送られるものは何もありません。このレポートを私に共有するのは100%任意で、それが不具合の修正やコミュニティの優先順位の理解に直接役立ちます。
- メインのメニューバーからCalíope → 設定を開きます。
- 一般を開いて、プライバシーと診断のセクションまでスクロールします。
- このデバイスに使用状況レポートを保存をオンにします。初期設定ではオフなので、オンにするまでレポートは空です。それは不具合ではありません。
- ツールを開いた回数とイベントのログを含む、JSONのレポートのプレビュー全体を確認します。
- 共有をクリックするか、JSONの中身をコピーして、support@caliope.org宛てのメールに添付します。
よくある質問
新しいデータベース接続を作るには?
サイドバーかメインのメニューバーから接続マネージャを開き、+ボタンをクリックします。サーバのホスト、ポート、ユーザ名、パスワードを入力します。
認証情報はネイティブのキーチェーン(macOSのSecurityフレームワーク)で安全に保存され、第三者のサーバにも開発者のサーバにも送信されることはありません。
SSHトンネルで接続するには?
接続マネージャでSSHトンネルのスイッチをオンにします。SSHのホスト、ポート、ユーザ名を入力します。
Calíopeは、パスワード認証と鍵による認証(Ed25519とECDSA P-256/384/521)に対応しています。実装にはネイティブのSwiftNIO-SSHを使っているので、外部のSSHクライアントは要らず、復号した鍵がディスクに書き込まれることもありません。
SSL接続が失敗します。何が変わったのですか?
2026年7月のセキュリティ強化から、Calíopeは初期設定で、サーバのTLS証明書をシステムの信頼されたルートと照らし合わせて検証しています。自己署名の証明書を使うサーバに接続していて、CAを指定していない場合、接続は失敗します。
方法は2つあります:
- 推奨:プロファイルのSSLのセクションでCA証明書のファイルを指定します。
- 開発用に限って:「信頼されていない証明書を受け入れる(安全ではありません)」のチェックボックスにチェックを付けます。接続は暗号化されたままですが、中間者攻撃に対して無防備になります。
アプリがデータベースに接続できません。何を確認すればいいですか?
次の簡単な診断を試してください:
- 接続のホスト、ポート、ユーザ名、パスワードが正しいことを確かめます。
- MariaDB/MySQLサーバが、あなたのIPアドレスからのリモート接続を受け入れるように設定されていることを確かめます(
my.cnfのbind-addressの設定を見てください)。 - SSLを使っている場合は、証明書を確かめ、正しいSSLモードを選んでいることを確認します。
- ファイアウォールやVPNの内側にいる場合は、ポート3306(または独自のデータベースのポート)が完全に開いていることを確かめます。
- ターミナルからコマンドラインのクライアント
mysql -u [user] -h [host] -pで接続を試して、問題を切り分けます。 - PostgreSQL:
postgresql.confのlisten_addressesと、pg_hba.confにあなたのIPアドレスを許可する行があることを確かめます。デフォルトのポートは5432です。ターミナルからpsql -h [host] -U [user] -d [db]で試してください。 - SQL Server:デフォルトのポートは1433で、SQL Server構成マネージャーでTCP/IPを有効にする必要があります。Calíopeは常に暗号化するので、TLSを受け付けないサーバとは、平文で話すのではなく接続を拒否します。ターミナルから
sqlcmd -S [host],1433 -U [user]で試してください。 - MongoDB:デフォルトのポートは27017で、どのアドレスで待ち受けるかは
mongod.confのbindIpで決まります。ターミナルからmongosh "mongodb://[user]@[host]:27017"で試してください。 - Oracle Database:デフォルトのポートは1521(TCPSでは2484)で、リスナーが、プロファイルのデータベースの欄に書いたサービス名を提供している必要があります。ターミナルから
sqlplus [user]@//[host]:1521/[service]で試してください。 - ClickHouse:CalíopeはそのHTTPインターフェイスを、ポート8123(HTTPSでは8443)で使います。ネイティブの9000ではありません。ターミナルから
curl http://[host]:8123/pingで試すと、Ok.と答えます。 - Redis:デフォルトのポートは6379で、誰が接続できるかは
redis.confのbindとprotected-modeで決まります。クラスタはSSHトンネルでは開きません。ターミナルからredis-cli -h [host] -p 6379 PINGで試してください。 - TiDB:MySQLのプロトコルを話し、デフォルトのポートは4000です。ターミナルから
mysql -h [host] -P 4000 -u [user] -pで試してください。 - Valkey:Redisと同じで、
redis.confの代わりにvalkey.confです。ターミナルからvalkey-cli -h [host] -p 6379 PINGで試してください。 - Apache CassandraとScyllaDB:ネイティブプロトコルはポート9042で待ち受け、どのアドレスで待ち受けるかは
cassandra.yaml(ScyllaDBではscylla.yaml)のrpc_addressで決まります。ターミナルからcqlsh [host] 9042 -u [user]で試してください。
クエリーの履歴はどこに保存されますか?
クエリーの履歴は、デバイス上の非公開のSQLiteデータベースにローカルに保存されます。初期設定では完全にオフラインで、アップロードされることはありません。SQLエディタの中の履歴パネルで、実行のログを見たり、検索したり、絞り込んだり、完全に削除したりできます。
クエリーログのiCloud同期を選んだ場合は、クエリーの文がそのままあなたの非公開のiCloudに送られます。Calíopeは、それを有効にする前に警告を表示します。
データベースの自動バックアップをスケジュールするには?
サイドバーからバックアップを開きます。目的のデータベースとテーブルを選び、バックアップのスケジュール(毎日、毎週、平日、毎月、またはN時間ごと)を決め、保存先のローカルのフォルダを選びます。バックアップの処理は、ブロックしない非同期のストリーミングエンジンでローカルに実行されます。
Calíopeはデバイス間でデータを同期しますか?
はい、オンにすれば同期します。Calíopeは、接続プロファイル(パスワードは含みません)、スニペット、レポート、SQLアラート、監視の設定、エディタを、あなたのiCloud DriveとiCloudのキー値ストアで同期します。クエリーログ、AIアシスタントの会話、アプリケーションのエラーログ、システムメッセージは、それぞれ専用のスイッチで、CloudKitのプライベートデータベースを通ります。レポートとバックアップの実行履歴は、それを実行したデバイスにとどまります。スケジュールしたバックアップは同期されません:それぞれが実行するデバイス上のフォルダを指しているからです。
安全のため、データベースのパスワードは初期設定では同期されません。iCloudキーチェーンの同期をはっきり有効にしない限り、キーチェーンの項目はデバイスにとどまります。iCloud同期は設定 › 一般 › iCloudで管理できます。
自分のデータをすべて削除するには?
設定 › 一般 → 自分のデータをすべて削除を開きます。1つのボタンで、Calíopeが保存しているものを6つの場所すべてから削除します:このデバイス(接続プロファイル、クエリーの履歴、エラーログ、AIアシスタントの履歴、テレメトリ、スキーマのキャッシュ、最近使ったSQLファイル、スニペット、モニタの項目)、キーチェーン(パスワード、SSHのパスフレーズ、APIキー)、iCloud Drive、iCloudのキー値ストア、CloudKitのレコード、そしてウィジェットのデータです。すべてのデバイスに届き、先にパスワードを含まないローカルの復元ポイントを保存し、それぞれの場所で何を削除したかを報告します。これはGDPR第17条に沿ったものです。
なぜCalíopeは有料なのですか?
Calíopeを、使う人たちの手で形作られるものにしたいからです。それは、向こう側に耳を傾ける時間のある誰かがいて初めて成り立ちます。Calíopeは1人で作っています:メールはすべて私が自分で読んで返信し、機能のリクエストは本当に作業の一覧に入ります。
この価格があるから、ほかのことをしないでいられる、ということでもあります。Calíopeには広告もトラッカーも第三者の解析もなく、誰のデータも売りません。使用状況レポートは、全部を読めるローカルのJSONファイルで、あなたが送ることを選んだ場合にだけ共有されます。このやり方を続けるにはお金がかかり、それを払うのは広告主よりもあなたであってほしいのです。
足りないものがあれば、リクエストしてください。それが、何を作るかに影響を与えるいちばん直接の方法です。すでに進めているものは公開のロードマップにあります。
そして、そう、一部はコーヒーに消えます。私はそれを重要なインフラだと考えています。
AI SQLアシスタントを使うには?
文脈を理解するAIアシスタントは任意です。プロバイダを選ぶには、設定 → AIアシスタントに移動します。Apple Intelligence(デバイス上)やOllama(あなた自身のマシン上のモデル)なら、キーなしで動きます。クラウドのプロバイダ(OpenAI、Google Gemini、Anthropic Claude)を使いたい場合は、自分のAPIキーを指定します。キーはキーチェーンに保存され、そのプロバイダにだけ送られます。
AIのAPIに送られるのは、データベースのメタデータ(テーブル名と列名、外部キー)と、あなたが入力したプロンプトだけです。行の内容と認証情報が送信されることはありません。
購入はApple IDに結び付いていますか?
はい。CalíopeはStoreKit 2とApp Storeが扱う買い切りの購入です:あなたのApple IDに結び付き、そのApple IDでサインインしているすべてのデバイスで使えるようになります。60日間のお試しは価格0の別の項目なので、手に入れるのに費用はかからず、カードも求めません。そして60日間はCalíope自身が数えます。始めた日からです。終わっても何も更新されず、何も請求されないので、管理したり解約したりするものはありません。お試しはApple IDごとに1回だけ始められます。
再インストールしたあとに購入を復元するには?
Calíopeを開いて、購入の画面で購入を復元をタップまたはクリックします。アプリがApp Storeに問い合わせて、購入を自動で確認します。
アプリがクラッシュする、または予期しない動きをします。どうすればいいですか?
ご不便をおかけして申し訳ありません。次の手順を試してください:
- Calíopeを完全に再起動します。
- OSとCalíopeが最新の状態になっていることを確かめます。
- それでも問題が続く場合は、support@caliope.orgまでご連絡ください。できれば、Console.app(macOS)や設定 → プライバシーとセキュリティ → 解析および改善(iPhone、iPad、Apple Vision Pro)の診断ログやクラッシュレポートを添付してください。
💾 対応しているデータベース
- MariaDB 10.2.3+, 11.x
- MySQL 5.7.5+, 8.0, 8.4 LTS
- Amazon Aurora(MySQLとPostgreSQL)
- PostgreSQL 13+
- Microsoft SQL Server 2022+
- ClickHouse 25.3+
- Oracle Database 26ai+
- TiDB 8.5+
- SQLite 3とDuckDB 1.5.5(ローカルのファイル、サーバ不要、組み込み)
- MongoDB 6+
- Redis(RESP2とRESP3。ACLのあるユーザにはRedis 6+が必要)
- Valkey 8.0+
- Apache Cassandra 4.1+
- ScyllaDB 2025.1+
- 互換性のあるローカルとクラウドの環境
💻 システム要件
- macOS:macOS 26 Tahoe以降
- iPad:iPadOS 26以降
- iPhone:iOS 26以降
- Apple Watch:watchOS 26以降
- Apple TV:tvOS 26以降
- Apple Vision Pro:1.6からネイティブのvisionOSアプリ。それより前はiPadのアプリ
- クラウドやリモートのサーバには、インターネット接続が必要です
- この要件の理由