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

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

カタログ

カタログを閲覧

テーブル、ビュー、インデックス、列、ルーチン、トリガー、イベントを閲覧します。

場所: ワークスペース › ツール › カタログ

ワークスペースのナビゲーションバーからカタログを開きます。上部のセレクタでデータベースを選びます。サブタブに、オブジェクトの種類ごとの一覧が表示されます。

ClickHouse

ClickHouseでは「トリガー」と「イベント」のタブはなく、タブの下の注記がその代わりに何があるかを示します。「インデックス」は「キー」という名前になり、テーブルごとにソートキー、パーティションキー、異なる場合は主キー、サンプリングキー、種類と粒度付きのスキップインデックス、そしてプロジェクションを表示します。カーディナリティと「新規インデックス」はありません。「ビュー」と「キー」の間には「マテリアライズドビュー」があります。一覧には、それぞれの書き込み先(サーバが書き込み先を作成した場合は「内部」)と更新のタイミングが表示され、その下に選んだビューのシートが表示されます。どのテーブルから読み込み、どのテーブルに書き込むか、クエリーに使う名前、書き込み先が使う容量と行数、最後に行が書き込まれた日時、そして自動で更新される場合はそのスケジュール、状態、前回と次回の更新が、タイムゾーンを明記して表示されます。「ルーチン」にはユーザの関数が一覧表示されます。それらはラムダ関数で、ここから作成し、編集します。

Oracle

Oracleでは、セレクタにスキーマが一覧表示されます。お使いのアカウントから見えるオブジェクトがあるスキーマと、空でも自分のスキーマ、そしてOracle自身のスキーマ(SYS、MDSYS…)です。「テーブル」にはユーザのテーブルが表示されます。空間インデックスやマテリアライズドビューの内部テーブルは含まれず、行数は最後の統計情報(NUM_ROWS)のもの、型はOracleが書くとおりです(NUMBER(10,0)、VARCHAR2(100 CHAR))。マテリアライズドビューには専用のタブ「マテリアライズドビュー」があります。行を格納するテーブル、読み込むテーブル、リフレッシュのタイミングと方法、最後のリフレッシュ、最新かどうかが表示され、「今すぐリフレッシュ」があります。「ルーチン」にはプロシージャ、関数、パッケージが一覧表示され(パッケージの仕様部と本体はDDLパネルに表示されます)、コンパイルできないものは種類の後にINVALIDと付きます。「トリガー」では、無効になっているものにDISABLEDと付きます。「インデックス」では、ファンクションベースのインデックスはその式を、ドメインインデックスや異常なインデックスはその種類を表示します(DOMAIN · MDSYS.SPATIAL_INDEX_V2、NORMAL · INVISIBLE、UNUSABLE)。タブがもう1つあり、「シーケンス」には最小値、最大値、増分、循環、キャッシュ、そして「ディスク上の次の値」が表示されます。これはサーバが次に書き込む番号で、最後に払い出した番号ではありません。キャッシュがある場合、最大で1ブロック分遅れることがあります。「イベント」にはスキーマのDBMS_SCHEDULERのジョブが一覧表示されます。

SQL Server

SQL Serverでは、「ビュー」と「インデックス」の間に「インデックス付きビュー」があります。行を格納する一意のクラスタ化インデックスを持つビューです。選んだビューのカードには、どのインデックスか、どれだけの容量を取るか、行数、どのテーブルから読み込むかが表示され、そのDDLの後ろにインデックスが続きます。これらは「ビュー」には出なくなりましたが、エディタのツリー、バックアップ、比較ツールでは引き続きビューとして扱われます。「シーケンス」には、スキーマのシーケンスが、最小値、最大値、増分、循環、キャッシュ、「最後に払い出した値」(NEXT VALUE FORが最後に返した番号)とともに一覧表示されます。

キーワード: カタログ、オブジェクト、テーブル、ビュー、インデックス、ルーチン

オブジェクトのDDLを表示・編集

CREATE TABLE、CREATE VIEW、CREATE PROCEDUREを表示し、その場で編集します。

場所: カタログ › コンテキストメニュー › DDLを表示

カタログ一覧の任意のオブジェクトでコンテキストメニューを開き(macOSでは右クリック、iPadでは長押し)、「DDLを表示」を選びます。下部のパネルに、シンタックスハイライト付きでDDL全体が表示されます。どのプラットフォームでもテキストを選択できます。

DDLの編集:
DDLパネル上部のボタン「ItemEditorで開く」を押すと、DDLが読み込まれた状態でエディタがモーダルシートに開きます。どのプラットフォームでも同じエディタで、シンタックスハイライトが付いています。

必要に応じてDDLを変更し、「適用」を押すとサーバに送信されます。「リセット」ボタンは変更を破棄し、元のDDLに戻します。ALTERやCREATEが失敗すると、下部のバーにサーバのエラーが赤いメッセージで表示されます。

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

Apple Vision Pro:行を見つめてピンチしたまま押さえると、コンテキストメニューが開きます。

Oracle

Oracleでは、サーバがDBMS_METADATA.GET_DDLで書き出すものがパネルに表示されます。引用符付きで修飾された名前、該当する場合はEDITIONABLE、IDENTITYの定義全体、そしてテーブルの場合はそのインデックス、コメント、末尾にALTER TABLEとしての外部キーです。お使いのアカウントが別のスキーマのオブジェクトのDDLを読めない場合(SELECT_CATALOG_ROLEがない場合)は、コメントでそのことが示され、「ItemEditorで開く」は表示されません。シーケンスにも「DDLを表示」があります。

キーワード: DDL、CREATE TABLE、ALTER、定義、構造、スキーマ、編集、ItemEditor、適用

新規テーブルを作成

カタログのツールバーから直接テーブルを作成します。

場所: カタログ › 新規テーブル

カタログのツールバーで「新規テーブル」ボタンを使うと、新しいタブでテーブルビルダーが開きます。既存のテーブルでコンテキストメニューを開き(macOSでは右クリック、iPadでは長押し)、「テーブルを設計」を選んで編集することもできます。

ビルダーは作業をバーのタブに分けています。「列」、「インデックス」、「外部キー」(エンジンにある場合)、「オプション」です。セッションのエンジンでそれぞれのタブに何があるかは、テーブルビルダーのトピックで説明しています。

下部の「SQLプレビュー」セクションには、実行されるDDLがリアルタイムで表示されます。「テーブルを作成」(編集モードでは「変更を適用」)をクリックすると、DDLがサーバに送信されます。

Apple Vision Pro:行を見つめてピンチしたまま押さえると、コンテキストメニューが開きます。

キーワード: 新規テーブル、テーブル作成、作成、DDL、ビルダー、列、インデックス、外部キー

ビュー、インデックス、ルーチン、トリガー、イベントの作成

オブジェクトの種類ごとのビジュアルエディタをツールバーから開きます。

場所: カタログ › 新規ビュー / 新規インデックス / 新規ルーチン / 新規トリガー / 新規イベント

カタログのツールバーには、オブジェクトの種類ごとに作成用のボタンがあります。

- 「新規ビュー」— ビューエディタを開きます
- 「新規インデックス」— インデックスエディタを開きます
- 「新規ルーチン」— 関数とストアドプロシージャのエディタを開きます
- 「新規トリガー」— トリガーエディタを開きます

MySQLMariaDBAurora

- 「新規イベント」— 「イベント」タブで、イベントスケジューラのエディタを開きます

SQL Server

SQL Serverでは、「イベント」は、ステップがこのデータベースで実行されるAgentのジョブで、そのdboの下に一覧表示され、「新規イベント」で作成します。AgentのないExpressでは、タブにそれが空である理由が表示されます。

PostgreSQL

イベントはpg_cron拡張機能のジョブで、そのスキーマcronに一覧表示されます。「新規イベント」でcron.scheduleを使ってスケジュールします。拡張機能がなければ、「イベント」タブに足りないものが表示されます。

どのエディタも、接続しているサーバの方言で対応するDDL(CREATE VIEW、CREATE INDEX、CREATE PROCEDUREなど)を生成し、確認するとサーバで実行します。それぞれのエディタは、そのサーバが書けるものだけを提供します。エンジンによって何が変わるかは、次のトピックで説明します。

ClickHouse

ClickHouseには「新規ビュー」と「新規ルーチン」があります。後者はラムダ関数を作成します。「新規インデックス」はなく(タブは「キー」で、スキップインデックスはテーブルビルダーから追加します)、「新規トリガー」と「イベント」タブもありません。

Oracle

Oracleには「新規ビュー」、「新規インデックス」、「新規ルーチン」(プロシージャまたは関数)、「新規トリガー」、「新規イベント」(DBMS_SCHEDULERのジョブ)があります。パッケージはここで編集できますが、作成はできません。

TiDB

TiDBには「新規ビュー」と「新規インデックス」があります。「新規ルーチン」、「新規トリガー」、「イベント」タブはありません。TiDBにはストアドルーチン、トリガー、イベントスケジューラがなく、カタログは注記でそのことを示します。シーケンスは「シーケンス」タブに、DDLとともに一覧表示されます。

キーワード: ビュー、インデックス、ルーチン、トリガー、イベント、作成、DDL、ストアドプロシージャ

ビュー、ルーチン、トリガー、イベントの編集

既存のオブジェクトを、ビジュアルエディタまたはSQLエディタで直接変更します。

場所: カタログ › コンテキストメニュー › 編集(ビジュアルフォーム) / ItemEditorで開く

カタログの該当するタブで、ビュー、ルーチン、トリガー、イベントのコンテキストメニューを開きます(macOSでは右クリック、iPadでは長押し)。「DDLを表示」のほかに、編集の方法が2つあります。

- 「編集(ビジュアルフォーム)」— 項目が入力済みのグラフィカルなエディタを開きます
- 「ItemEditorで開く」— オブジェクトのDDL全体をSQLエディタで開き、手作業で変更できるようにします

ビジュアルフォームでの変更は、オブジェクトの種類に応じてALTERまたはDROP + CREATEを生成します。

MariaDB

MariaDBでは、ルーチン、トリガー、インデックスは1つの文で置き換えます(CREATE OR REPLACE)。失敗しても、元のオブジェクトはそのまま残ります。

Oracle

Oracleでは、プロシージャ、関数、パッケージ、トリガー、そして「イベント」に並ぶDBMS_SCHEDULERのジョブを編集できます。複数のイベント、UPDATE OFの列、独自のREFERENCING、COMPOUNDを持つトリガーと、フォームがヘッダを書けないルーチンは、シートで開けますが保存はできません。「ItemEditorで開く」でSQLエディタに送ります。

ClickHouse

ClickHouseでは、ユーザ定義関数は「編集(ビジュアルフォーム)」で編集します。パラメータと式を入れたルーチンエディタが開きます。「ItemEditorで開く」でそのDDLをSQLエディタに送ります。

Apple Vision Pro:行を見つめてピンチしたまま押さえると、コンテキストメニューが開きます。

キーワード: ビューの編集、ルーチンの編集、トリガーの編集、イベントの編集、フォーム、ItemEditor

テーブルにダミーデータを投入

テーブルのテスト用の行を自動で生成します。

場所: カタログ › コンテキストメニュー › ダミーデータを投入

カタログの「テーブル」タブでテーブルのコンテキストメニューを開き(macOSでは右クリック、iPadでは長押し)、「ダミーデータを投入」を選びます。テーブルを選んでカタログのツールバーの「テーブルにデータを投入」を押しても開けます。読み出し専用モードでは表示されません。

行数を1から5000までで選ぶと、始める前に各列の型とサンプル値が表示されます。Calíopeはサーバから列とその型を読み取り、エンジンが自動で埋める自動増分の列と計算列は飛ばします。外部キーの値もランダムなので、親テーブルに存在しないことがあります。

50行ずつのバッチで挿入し、進行状況バーを表示します。サーバがバッチを拒否すると投入は止まり、その理由を伝えます。終わると、サーバによれば何行入ったか、エラーなしで何行捨てられたか、値を調整したという警告があったかを伝えます。

MySQLMariaDBAuroraTiDB

ENUMやSETの列には、その列自身のリストから値が入ります。投入の間は外部キーのチェックを無効にするので、存在しない親を指す行が残ることがあります。一致する行のないJOINを試すのに役立ちます。キーが重複する行やCHECKを満たさない行はエラーにならずに捨てられるため、指定した行数より少なくなることがあります。範囲外の値は捨てられず、型の上限に切り詰めて入り(TINYINTの300は127になります)、警告が残ります。

PostgreSQL

投入の間はテーブルのトリガーが動かず、外部キーをチェックするトリガーも動かないので、存在しない親を指す行が残ることがあります。一意キーが重複する行は、エラーにならずに捨てられます。トリガーを止めるにはスーパーユーザーが必要です。そうでなければ外部キーをチェックしたまま投入が続き、最後のメッセージでそれを伝えます。親テーブルにない値を含むバッチは、その警告とともに止まります。

SQL ServerOracle

外部キーのチェックは有効なままです。親テーブルにない値を含むバッチは、その警告とともに止まります。重複したキーを含むバッチも同じです。

Apple Vision Pro:行を見つめてピンチしたまま保持すると、コンテキストメニューが開きます。

キーワード: ダミーデータ、シード、テストデータ、データを投入、偽データ

読み出し専用モード

カタログのオブジェクトがうっかり変更されるのを防ぎます。

場所: カタログ › 読み出し専用

カタログは読み出し専用で開きます。ツールバーのスイッチがオンになり、作成と削除のボタンは使えない状態です。オブジェクトを作成または削除するときはオフにし、本番環境のデータベースを閲覧するときはオンに戻してください。接続に読み出し専用の環境タグが付いている場合は、スイッチも作成と削除のボタンも表示されません。そのセッションは書き込めないので、解除するものがないからです。

キーワード: 読み出し専用、読み取り専用、保護、本番環境

ビューエディタ

ビューを作成または変更します。使えるオプションはエンジンによって異なります。

場所: カタログ › 新規ビュー / ビューを編集

ビューエディタは、「新規ビュー」を押したとき、または既存のビューのコンテキストメニュー(macOSでは右クリック、iPadでは長押し)で「編集(ビジュアルフォーム)」を選んだときに開きます。CREATE VIEWのDDLを自動で生成します。

使える項目:

- 名前 — 選んだデータベースでのビューの名前。
- 置換のスイッチ — オンにすると、生成されるDDLは、ビューがすでにあれば先に削除せずに置き換えます。スイッチの名前は、それが書く句の名前です。

MySQLMariaDBAuroraPostgreSQLOracleTiDB

OR REPLACE — CREATE OR REPLACE VIEW。

SQL Server

OR ALTER — CREATE OR ALTER VIEW。

MySQLMariaDBAurora

- アルゴリズム — サーバがビューをどう処理するかを決めます。
- UNDEFINED(デフォルト)— サーバが最適なアルゴリズムを選びます。
- MERGE — ビューのクエリーを外側のクエリーと統合します。より効率的です。
- TEMPTABLE — 外側のフィルタを適用する前に、ビューを一時テーブルに実体化します。
- SQL SECURITY — ビューがどの権限で実行されるかを決めます。
- DEFINER(デフォルト)— ビューを作成したユーザの権限で実行します。
- INVOKER — ビューをクエリーするユーザの権限で実行します。

TiDB

TiDBは「アルゴリズム」と「SQL SECURITY」を受け付け、SHOW CREATE VIEWに残します。TiDBのビューにはどれも書き込めません(IS_UPDATABLEはNO)。行はビューのテーブルで変更します。

- CHECK OPTION — ビューを通して変更した行が、引き続きビューに表示されることを検証します。
- LOCAL — このビューの条件だけを確認します。
- CASCADED — 元になるビューの条件も確認します。
- SELECTクエリー — ビューの内容を定義するSELECTクエリーを書くテキストエディタ。

「適用」を押すと、DDLがサーバで実行されます。

SQL ServerPostgreSQLOracle

「アルゴリズム」と「SQL SECURITY」はありません。シートには表示されません。

SQL ServerOracle

WITH CHECK OPTIONの形は1つだけで、CASCADEDが表すものです。LOCALを選んでもその形で書かれ、シートにもそう表示されます。

Apple Vision Pro:行を見つめてピンチしたまま押さえると、コンテキストメニューが開きます。

キーワード: ビュー、CREATE VIEW、OR REPLACE、アルゴリズム、MERGE、TEMPTABLE、SQL SECURITY、DEFINER、INVOKER、CHECK OPTION、ビューエディタ

ルーチンと関数のエディタ

ストアドプロシージャと関数を、ビジュアルなインターフェイスで作成または変更します。

場所: カタログ › 新規ルーチン / ルーチンを編集

ルーチンエディタは、「新規ルーチン」を押したとき、またはカタログの「ルーチン」タブで既存のルーチンを編集するときに開きます。プロシージャや関数を作成するDDL、または同じ名前のものを置き換えるDDLを生成します。

TiDB

TiDBではこのエディタは開きません。TiDBにはストアドルーチンがなく(CREATE PROCEDUREとCREATE FUNCTIONを拒否します)、カタログに「ルーチン」タブもありません。

MySQLAurora

2つの文を順に実行します。DROP PROCEDURE IF EXISTSとCREATE PROCEDURE(またはDROP FUNCTION IF EXISTSとCREATE FUNCTION)です。MySQLにはルーチン用のCREATE OR REPLACEがないため、既存のルーチンを先に削除します。作成に失敗すると、元のルーチンはもうありません。

MariaDB

1つの文です:CREATE OR REPLACE PROCEDUREまたはCREATE OR REPLACE FUNCTION。失敗しても、元のルーチンはそのまま残ります。

PostgreSQL

CREATE OR REPLACE PROCEDUREまたはCREATE OR REPLACE FUNCTION。

SQL Server

CREATE OR ALTER PROCEDUREまたはCREATE OR ALTER FUNCTION。

使える項目:

- 名前 — プロシージャまたは関数の名前。
- 種類 — PROCEDURE(プロシージャ)かFUNCTION(関数)を選びます。
- パラメータ — 「+」ボタンでパラメータを追加します。各パラメータには次のものがあります。
- モード:IN(入力)、OUT(出力)、INOUT(入力と出力)。プロシージャでのみ使えます。
- パラメータの名前。
- データ型(例:INT、VARCHAR(100)、DATETIME)。
- 戻り値の型(関数のみ)— 関数が返すデータ型(例:INT、VARCHAR(255))。
- 本体 — ルーチンのコードを書くテキストエディタ。最初は中身が空のBEGIN … ENDブロックになっています。

「オプション」セクションには、サーバが書けるものだけが表示されます。

MySQLMariaDBAurora

- 決定的 — 同じ入力パラメータに対してルーチンが常に同じ結果を返す場合に、DETERMINISTICを書きます。レプリケーションで重要です。
- データアクセス — データベースに対するルーチンの動作を宣言します。
- CONTAINS SQL — SQLを含むことがありますが、データの読み書きはしません。
- NO SQL — SQL文を含みません。
- READS SQL DATA — データを読みますが、変更はしません。
- MODIFIES SQL DATA — データを挿入、更新、削除することがあります。

PostgreSQL

「決定的」だけで、関数の場合のみです。IMMUTABLEを書きます(関数は同じ引数に対して常に同じ結果を返し、データベースを読みません)。プロシージャにはこのオプションはなく、「データアクセス」もありません。PostgreSQLにはその句がないためです。「言語」は、サーバにある言語から本体の言語を選びます。デフォルトはplpgsqlで、sqlやインストールされたほかの言語も選べます。ルーチンを編集するときは、そのルーチンの言語を保ちます。同じ名前で引数の違う2つの関数(オーバーロード)は、一覧にそれぞれのシグネチャ付きで表示され(precio(integer)とprecio(text))、別々に編集し、削除します。

SQL Server

「オプション」セクションはありません。SQL Serverは関数が決定的かどうかを自分で判断し、データアクセスの句もありません。IN以外のパラメータは@名前 型 OUTPUTと書かれ、@を省くと自動で付けられます。

「適用」を押すと、DDLがサーバで実行されます。

Oracle

Oracleでは、エディタはCREATE OR REPLACE PROCEDUREまたはFUNCTIONを書きます。パラメータは書かれたとおり(DEFAULTと%TYPE付き)で、RETURNとDETERMINISTICも書き、ヘッダにあってフォームが表示しないもの(AUTHID、RESULT_CACHE…)は保ちます。本体はASのあとに続くもの、つまり宣言とブロックです。パッケージは丸ごと編集します。仕様部と本体を、/だけの行で区切ります。サーバがコンパイルエラー付きで格納した場合、シートはALL_ERRORSの各行を表示し、作成したとは報告しません。

ClickHouse

ClickHouseでは、ルーチンはラムダ関数です。エディタが提供するのはFUNCTIONだけで、パラメータには名前があって型はなく、戻り値の型も「オプション」もなく、本体はパラメータを使う式です(k * x + b)。CREATE OR REPLACE FUNCTION name AS (x, k, b) -> k * x + bを書きます。関数はデータベースではなくサーバに属するので、名前の前にデータベースは付きません。編集するとき、本体はサーバが格納しているとおりの式で、かっこも付きます。

キーワード: ルーチン、プロシージャ、関数、PROCEDURE、FUNCTION、パラメータ、IN、OUT、INOUT、決定的、CONTAINS SQL、CREATE PROCEDURE、CREATE FUNCTION

トリガーエディタ

テーブルのトリガーを作成または変更します。

場所: カタログ › 新規トリガー / トリガーを編集

トリガーエディタは、カタログのツールバーで「新規トリガー」を押したとき、または既存のトリガーのコンテキストメニュー(macOSでは右クリック、iPadでは長押し)で「編集(ビジュアルフォーム)」を選んだときに開きます。スキーマツリーからは開きません。スキーマツリーのコンテキストメニューは、カタログのエディタをどれも開かないからです。

TiDB

TiDBではこのエディタは開きません。TiDBにはトリガーがなく(CREATE TRIGGERを拒否します)、カタログに「トリガー」タブもありません。

使える項目:

- 名前 — トリガーの名前。
- タイミング — 操作に対してトリガーがいつ起動するか。

MySQLMariaDBAuroraPostgreSQL

- BEFORE — 操作の前に実行します。NEWの値を書き込まれる前に変更できます。
- AFTER — 操作の後に実行します。

SQL Server

- AFTER — 操作の後に実行します。
- INSTEAD OF — 操作をトリガーのコードで置き換えます。
BEFOREはありません。

- イベント — トリガーを起動する操作。
- INSERT — 行が挿入されたとき。
- UPDATE — 行が更新されたとき。
- DELETE — 行が削除されたとき。
- 本体 — トリガーのコードを書くテキストエディタ。最初の本体には、新しい行と以前の行がどこにあるかがコメントで書かれています。

「適用」を押すと、DDLがサーバで実行されます。

MySQLMariaDBAuroraPostgreSQL

トリガーは行ごとに1回起動します。NEW.列名は新しい値(INSERTとUPDATE)、OLD.列名は以前の値(UPDATEとDELETE)です。

PostgreSQL

トリガーのコードは関数の中にあります。Calíopeは、本体を持つ関数<名前>_fnと、それを呼び出すトリガーをFOR EACH ROWで作成します。本体はRETURNで終わります。BEFOREトリガーでは返した行が書き込まれ、NULLを返すとその行は飛ばされます。最初の本体はCOALESCE(NEW, OLD)を返し、3つのイベントのどれでも正しく動きます。名前を変えずにトリガーを編集すると、PostgreSQL 14からは1つの文CREATE OR REPLACE TRIGGERで置き換えます。それより前は、削除してから作成し直します。

SQL Server

トリガーは行ごとではなく文ごとに1回起動し、新しい行と以前の行はNEWとOLDではなくinsertedテーブルとdeletedテーブルにあります。最初の本体にもそう書かれています。名前を変えずにトリガーを編集すると、SQL Server 2016 SP1からは1つの文CREATE OR ALTER TRIGGERで置き換えます。トリガーのない瞬間はなく、新しい本体がコンパイルできなければ前のものが残ります。それより前は、削除してから作成し直します。

Apple Vision Pro:行を見つめてピンチしたまま押さえると、コンテキストメニューが開きます。

Oracle

Oracleでは、タイミングはBEFORE、AFTER、INSTEAD OF(最後のものはビューで)で、スイッチがさらに2つあります:「行ごと(FOR EACH ROW)」と「有効」(ENABLEまたはDISABLE)。保存はCREATE OR REPLACE TRIGGERで、WHEN条件があればそれを保ちます。複数のイベント、UPDATE OFの列、独自のREFERENCING、COMPOUNDを持つものは、開けますがここからは保存できません。サーバがコンパイルエラー付きで格納した場合、シートはALL_ERRORSの各行を表示します。

キーワード: トリガー、BEFORE、AFTER、INSERT、UPDATE、DELETE、NEW、OLD、CREATE TRIGGER、トリガーエディタ

イベントスケジューラのエディタ

MySQLのイベントスケジューラのイベントを作成または変更します。

場所: カタログ › 新規イベント / イベントを編集

イベントエディタは、カタログのツールバーで「新規イベント」を押したとき、または既存のイベントを編集するときに開きます。MySQLのイベントスケジューラが有効になっている必要があります(SET GLOBAL event_scheduler = ON)。

使える項目:

- 名前 — イベントの名前。
- 状態 — イベントが有効かどうかを決めます。
- ENABLE — スケジュールに従ってイベントを実行します。
- DISABLE — イベントを一時停止します。
- SLAVESIDE_DISABLED — レプリケーションのレプリカで無効になっています。
- スケジュールの種類:
- 1回のみ(AT) — 指定した日時に実行します。日時ピッカーで時点を設定します。
- 繰り返し(EVERY) — N単位時間ごとに繰り返します。数と単位(SECOND、MINUTE、HOUR、DAY、WEEK、MONTH、YEAR)を設定します。
- 開始(繰り返し)— 繰り返しのイベントが実行を始める時点。
- 日時はサーバの時刻で、タイムゾーンはありません。ピッカーに表示されるのはサーバに保存されている値で、お使いのデバイスの時計ではありません。
- 終了日(繰り返し、任意)— スイッチをオンにすると、実行を止める時点を指定できます。
- 本体 — イベントが実行するSQLコード。複数の文を含むBEGIN … ENDブロックにすることもできます。

「適用」を押すと、DDLがサーバで実行されます。

PostgreSQL

PostgreSQLでは、イベントはpg_cronのジョブです。エディタはcron.schedule(name, expression, body)を書き、同じ名前のジョブがあれば置き換えます。DISABLEはcron.alter_jobでジョブを非アクティブにします。あるのは繰り返しだけです:N秒ごと(59まで)、1時間と1日を割り切る分または時間、そして毎日・毎週・毎月・毎年で、開始時刻はUTCです。1回だけの実行と終了日はpg_cronになく、SQLのプレビューがそう伝えます。ほかの定期実行の式を持つジョブは、DDLには表示されますがエディタは開きません。

SQL Server

SQL Serverでは、イベントは、このデータベースで実行されるT-SQLのステップを1つ持つAgentのジョブです。エディタはsp_add_job、sp_add_jobstep、sp_add_jobschedule、sp_add_jobserverを書き、編集では履歴を保つsp_update_job、sp_update_jobstep、sp_update_scheduleを書きます。ジョブはスキーマではなくサーバに属し、ステップが実行されるデータベースのdboに一覧表示されます。ほかのスキーマでは、タブがジョブのある場所を伝えます。複数のステップを持つジョブや、エディタが書けないスケジュールのジョブは、DDLには表示されますがエディタは開きません。ExpressとAzure SQL DatabaseにはAgentがなく、そこではタブは表示されません。

Oracle

Oracleでは、イベントはスキーマのDBMS_SCHEDULERのジョブで、PL/SQLブロックです。エディタはjob_type => 'PLSQL_BLOCK'付きのDBMS_SCHEDULER.CREATE_JOBを書き、編集では履歴を保つSET_ATTRIBUTE、ENABLE、DISABLEを書きます。新しい名前にすると、ジョブを削除して作成し直します。スケジュールはFREQ=…;INTERVAL=nで、時刻はUTCです。別のカレンダーやプログラムを持つジョブ、ブロックでないジョブは、DDLには表示されますがエディタは開きません。作成にはCREATE JOB権限が必要です。

キーワード: イベント、イベントスケジューラ、CREATE EVENT、ENABLE、DISABLE、AT、EVERY、繰り返し、スケジューラ、定期実行、スケジュール

インデックスエディタ

種類、方式、列を設定して、テーブルにインデックスを作成します。

場所: カタログ › 新規インデックス / インデックスを作成

インデックスエディタは、カタログの「インデックス」タブから開きます。テーブルを選んだ状態でツールバーの「新規インデックス」ボタンを押すか、既存のインデックスのコンテキストメニュー(macOSでは右クリック、iPadでは長押し)で「編集(ビジュアルフォーム)」を選びます。スキーマツリーからは開きません。

使える項目:

- 名前 — テーブルでのインデックスの名前。
- 種類:
- INDEX — 標準のインデックスで、重複を許します。
- UNIQUE — 一意インデックスで、インデックスを付けた列や列の組み合わせで重複する値を拒否します。

MySQLMariaDBAurora

- FULLTEXT — 全文検索。CHAR、VARCHAR、TEXTの列と、MyISAM/InnoDBエンジンでのみ使えます(MySQL 5.6以降)。
- SPATIAL — 地理空間データ。空間型の列で、MyISAMかInnoDBの場合のみ使えます(MySQL 5.7以降、MariaDB 10.2以降)。

SQL Server

- SPATIAL:地理空間データ用で、主キーのあるテーブルのgeometry列またはgeography列に作成します。geometryではデータを囲む「ボックス」(xmin, ymin, xmax, ymax)を書き、geographyでは空にします。

MySQLMariaDBAuroraPostgreSQL

- 方式(INDEXとUNIQUEの場合):
- BTREE — Bツリー。最も一般的な方式です。範囲の比較、LIKE 'abc%'、ORDER BYに対応します。
- HASH — ハッシュテーブル。完全一致の比較にしか対応しません。

MySQLMariaDBAurora

HASHを実際に使うのはMEMORYエンジンだけです。

PostgreSQL

UNIQUEインデックスはHASHにできないため、UNIQUEでは方式はBTREEになります。BTREEとHASHのほかに、GIN(jsonb、配列、フルテキスト用)、GISTとSPGIST(ジオメトリと範囲用)、そして挿入順に並んだ非常に大きなテーブル用のBRINを提供します。インデックスを編集するときは、そのインデックスの方式を保ちます。「書き込みをブロックせずに作成(CONCURRENTLY)」のチェックボックスは、時間はかかりますが、テーブルを書き込みに対して閉じずにインデックスを作成します。

SQL ServerOracle

「方式」はありません。CREATE INDEXにUSING句がないためです。

- 列 — インデックスを構成する列を、名前の欄と、必要に応じてプレフィックスの長さ(インデックスを付ける文字数。長いTEXTやVARCHARの列で便利です)で追加します。

SQL ServerPostgreSQLOracle

インデックスのプレフィックスはありません。列全体にインデックスが付けられ、生成されるDDLにもコメントでそう書かれます。

主キーは、このエディタではなく、テーブルビルダーの「列」タブで管理します。

「適用」を押すと、サーバでCREATE INDEXが実行されます。

ClickHouse

ClickHouseではこのエディタは開きません。タブは「キー」で、「新規インデックス」はありません。スキップインデックスは、テーブルビルダーの「インデックス」タブで追加または削除します。

Apple Vision Pro:行を見つめてピンチしたまま押さえると、コンテキストメニューが開きます。

Oracle

Oracleでは、種類はINDEX、UNIQUE、FULLTEXT(Oracle Textのインデックス、INDEXTYPE IS CTXSYS.CONTEXT)、SPATIAL(MDSYS.SPATIAL_INDEX_V2。USER_SDO_GEOM_METADATAの行がなければ、既存のジオメトリのSRID、空のテーブルなら4326で先に登録します)です。後の2つは1つの列を対象にし、サーバにOracle TextとSpatialがある場合だけ表示されます。インデックスはそのテーブルのスキーマに作成されます。UNIQUE制約を支えるインデックスを削除すると、その制約も一緒に削除されます。

TiDB

TiDBでは、種類はINDEXとUNIQUE、方式はBTREEです。TiDBはFULLTEXTを警告付きで受け付けますが、インデックスは作成しません。また、インデックスを付ける空間型がありません。

キーワード: インデックス、CREATE INDEX、UNIQUE、FULLTEXT、SPATIAL、BTREE、HASH、列、プレフィックス、ALTER TABLE、インデックスエディタ

カタログでの検索と更新

検索フィールドは、開いているタブの一覧を名前で絞り込み、タブを切り替えると空になります。更新するとデータベースを読み直し、Calíopeのほかのツールが一覧を変更したときは自動で再読み込みされます。

場所: ワークスペース › ツール › カタログ

カタログのバーにある検索フィールドは、開いているタブ(テーブル、ビュー、インデックス、ルーチンなど)の一覧を名前で絞り込み、タブを切り替えると自動で空になります。

「更新」ボタンは、データベースを読み直します。これが必要になることはほとんどありません。Calíopeのほかのツールがそのデータベースでオブジェクトを作成または削除すると、一覧は自動で再読み込みされます。Calíopeの外から行った変更は、更新すると表示されます。

キーワード: 検索、フィルタ、更新、再読み込み、カタログ

カタログからオブジェクトを削除

テーブル、インデックス、ルーチン、イベントのコンテキストメニューから削除できます。確認画面には、エンジンが実行するDROPが表示されます。

場所: ワークスペース › ツール › カタログ

テーブル、インデックス、ルーチン、イベントのコンテキストメニューから削除できます。Calíopeは実行する前に、エンジンが実行するDROP文を表示して確認を求めます。接続に確認を求める環境タグが付いている場合は、ダイアログにそのタグの名前が表示されます。

ビュー、トリガー、シーケンスはカタログからは削除できません。SQLエディタから削除してください。

鍵がかかっている場合、このオプションは使えない状態で表示されます。読み込みしかできないセッションでは、表示自体されません。

キーワード: 削除、DROP、テーブル、インデックス、ルーチン、イベント