メインコンテンツまでスキップ

ツール

サーバーは 77 個のツールを提供します。5 個のセッションのツール、4 個の読み取りツール、編集操作ごとに 1 つずつある 67 個の編集ツール、そして複数の編集ツールを 1 つの編集として実行する erd_batch です。

erd_list_documents 以外のすべてのツールは、最初の引数としてドキュメントの path を受け取ります。以下の表では省略しています。 ? の付いた引数は省略可能です。

セッションのツール​

ツール引数動作
erd_list_documentsERD ドキュメントを path、open、active、dirty、readonly とともに一覧表示します。作業ディレクトリを扱うエディタがあればそのエディタのドキュメント（JetBrains IDE では開いているすべてのプロジェクトが対象）を、なければ作業ディレクトリ以下の ERD ファイルを表示します。
erd_open_documentcreate?ドキュメントを編集用に開きます。そのドキュメントを扱うエディタがある場合は、そのエディタの ERD Editor で開きます。create を付けると、ファイルがなければ先に作成し、拡張子のない名前には .erd.json が付きます。
erd_saveエディタが保持しているドキュメントを保存します。VS Code はこれが呼び出されるまでエージェントの編集を未保存のままにします。Obsidian と JetBrains IDE はユーザーの編集と同じようにそれらを保存し、これを呼び出すとすぐに書き込まれます。ヘッドレスでは、各編集の結果の saved: true が示すとおり、すべての編集がすでに書き込まれているため、何もしません。
erd_undoこのエージェントが行った最後の編集を元に戻します。ユーザーの編集は元に戻しません。Undo の項目を作らなかった呼び出しは飛ばされ、その名前が示されます。
erd_redoerd_undo が最後に元に戻した編集を、再び適用します。

各モードで保存と Undo がどう動作するかは、ライブとヘッドレスを参照してください。

ドキュメントの読み取り​

ツール引数動作
erd_listquery?、offset?、limit?、namesOnly?設定と件数、続いて 1 ページ分のテーブルを、そのインデックスとリレーションシップとともに返します。各テーブルには ID、キャンバス上の位置とサイズ、カラム数、論理名がある場合はその論理名、そしてテーブルグループに属している場合はそのテーブルグループが付きます。検索でない場合は、テーブルの後にテーブルグループ、メモ、その後にドメイン、用語、単語が続きます。
erd_gettableIds?、tableNames?、relationshipIds?、indexIds?、memoIds?、tableGroupIds?、wordIds?、termIds?、domainIds?指定したエンティティの全体を返します。テーブルはカラムとテーブルグループとともに、リレーションシップはそのカラムと onDelete、onUpdate とともに、インデックスはそのカラムとともに、メモは本文とともに、テーブルグループはそのテーブルとともに、単語、用語、ドメインはすべてのフィールドとともに返します。
erd_readformat、vendor?、statements?、header?、logicalNameAsComment?、tableIds?、tableNames?、groupNames?ドキュメント全体を 4 つの形式のいずれかで一度に返すか、一部のテーブルまたはテーブルグループだけの DDL を返します。
erd_list_checkslevel?、tableIds?、tableNames?、offset?、limit?単語、用語、ドメインの辞書が問題として検出したものを、エディタの辞書タブの Checks シートと同じように、1 ページずつ返します。何も変更しません。辞書のチェックを参照してください。

エージェントは erd_list で ID を見つけ、erd_get でカラム、辞書の行などの詳細を読み取り、それらの ID を編集ツールに渡します。 erd_list のテーブルのサイズは、キャンバス上でテーブルが占める矩形です。高さは正確で、幅は概算です。 テーブルグループは、保存されている矩形と、その名前、色、含むテーブルの数とともに一覧に含まれます。 各リレーションシップは、両端の 2 つのテーブルのどちらか一方とともに、1 回だけ一覧に含まれます。 辞書の行は、その ID、name、そして物理名やカラムに与えるもの、つまりドメインの dataType、用語の physicalName と domainId、単語の abbreviation とともに一覧に含まれます。各辞書は、そのシートに表示される順に行を並べます。 erd_list と erd_read が返す設定は、ファイルに保存されるとおりのものです。設定を参照してください。

erd_get と erd_read の snapshot 形式では、すべてのテーブルとカラムに logicalName（ない場合は空文字列）と nameDerived が付きます。nameDerived は、名前が辞書によって付けられたものである間は true になり、その場合は新しい論理名で名前が再び生成されます。辞書を参照してください。 すべてのカラムとすべての用語には domainId が付きます。ドメインがない場合と、ドキュメントにもう存在しないドメインの場合は空文字列です。

erd_read は次の 4 つの形式のいずれかを受け取ります。

format返す内容
snapshotすべてのエンティティとその ID を含むコンパクトな JSON です。テーブルグループと、単語、用語、ドメインの行も含まれ、設定も Schema SQL のスクリプトとともに含まれます。閲覧者ごとに異なるもの、つまり計測した幅、重なり順、表示、タブ、名前の表示は含まれません。大きなスキーマでは大きくなります。
sql8 つのデータベース Databricks、MariaDB、MSSQL、MySQL、Oracle、PostgreSQL、Snowflake、SQLite のいずれかの DDL です。vendor の既定値は、ドキュメントに設定されているデータベースです。ドキュメント全体の DDL には、その前後のスクリプトが含まれます。tableIds、tableNames、groupNames のいずれかを指定すると、それらのテーブルだけを、それらが持つ外部キーとともに、スクリプトなしで返します。外部キーには ON DELETE と ON UPDATE のアクションが付きますが、対象のデータベースが省くアクションは除きます。ON DELETE と ON UPDATE を参照してください。
json保存でファイルに書き込まれるとおりのドキュメント全体です。エディタがまだ保存していない編集も含まれます。保存形式を参照してください。
scriptsドキュメントの前後のスクリプトだけを、{"before":"…","after":"…"} の形で返します。設定されていないスクリプトは空になり、スキーマがどれほど大きくても返すのはスクリプトだけです。

vendor、statements、header、logicalNameAsComment、tableIds、tableNames、groupNames を受け取るのは sql 形式だけで、ほかの形式はこれらを拒否します。

  • statements: 既定値の create、MySQL、MariaDB、PostgreSQL、SQLite、Databricks では CREATE TABLE IF NOT EXISTS を、それ以外のデータベースでは通常の CREATE TABLE を書き出す ifNotExists、またはテーブルを作成する前に削除する recreate のいずれかです。recreate では、Snowflake は代わりに CREATE OR REPLACE TABLE を書き出します。
  • header: 既定値の none、ドキュメントのデータベース名が示すデータベースまたはスキーマを選択する use、またはそれを先に作成する createAndUse のいずれかです。Oracle には use しかないため、そこでは createAndUse は use を書き出し、PostgreSQL には createAndUse しかないため、そこでは use はヘッダーを書き出しません。SQLite はヘッダーを書き出さず、データベース名が空か単純な識別子でない間は、どのデータベースもヘッダーを書き出しません。
  • logicalNameAsComment: true は、テーブルやカラムのコメントが空または空白だけの間、その論理名をコメントとして、各データベースがコメントを書き出す場所に、その形式で書き出し、テキストのあるコメントはすべてそのまま保ちます。既定値の false は論理名を書き出しません。コメントとしての論理名を参照してください。
  • groupNames: 指定したテーブルグループのテーブルです。グループは大文字と小文字を区別せずに名前で指定し、そのテーブルは tableIds と tableNames のテーブルに加えられます。どのグループにも一致しない名前は notFound で拒否されます。テーブルを含まないグループは何も加えず、指定したグループがすべて空でテーブルも指定していない場合のように、テーブルが 1 つも残らない読み取りは invalidArgs で拒否されます。

statements、header、logicalNameAsComment は、一部のテーブルの DDL にも適用されます。これらはエディタの Schema SQL タブの Statements と Header のオプション、そして Write logical names into empty comments のスイッチと同じように働きますが、タブのほうは If not exists と CREATE + USE から始まります。スイッチは、logicalNameAsComment と同じくオフから始まります。 名前は、ファイルに保存される括弧の種類で囲まれます。Bracket Type がロックされている間は、ロックされた括弧の種類です。ロックを参照してください。

大きなスキーマ​

数百、数千のテーブルを持つスキーマも扱えます。 1 回の読み取りが返すのは最大 40,000 文字で、Claude Code がツールの結果をファイルに退避させる境目を下回ります。

  • erd_list は既定で 1 ページ 100 件を、テーブル、テーブルグループ、メモ、ドメイン、用語、単語の順に、そのすべてを通した 1 つのオフセットで返し、次のページの開始位置を nextOffset と note で示します。その nextOffset を offset として、同じ query とともに渡します。
  • query は、テーブルやカラムの名前、論理名、またはコメントに含まれる語でテーブルを探し、大文字と小文字を区別しません。名前または論理名に含まれる語が多いテーブルほど先に来ます。検索では、テーブルグループ、メモ、辞書の行は一覧に含まれません。
  • namesOnly はテーブル名だけを一覧表示し、短い名前なら 1 回の応答で約 2,000 件を返します。
  • erd_get と erd_read は ID に加えて tableNames も受け取り、erd_read は groupNames も受け取るため、大きなスキーマで SQL クエリを頼まれたエージェントは、必要なテーブルの DDL だけを読み取れます。
  • 辞書も分けて読み取れます。erd_list はテーブルの後にその行をページ単位で返し、erd_get は domainIds、termIds、wordIds で行の全体を返します。
  • erd_get は、何も指していない ID と名前を missing に、1 回の応答に収まらなかった ID を notReturned に一覧表示するため、後者は改めて要求できます。
  • erd_list_checks も同じように 1 ページずつ返します。辞書のチェックを参照してください。
  • 1 回の応答に収まらない読み取りは tooLarge で拒否され、絞り込み方が示されます。

辞書のチェック​

erd_list_checks は、エディタの Checks シートのチェックを同じ順序で一覧にします。まず単語のチェック、次に用語とドメインのチェックが、それぞれの辞書のシートに表示される順に並び、その後に各テーブルと、それに続くそのカラムのチェックが並びます。 シートと同じく、チェックが行われるのは、そのチェックが読み取る辞書に行がある間だけです。辞書に単語も用語もドメインもないドキュメントは、まったくチェックされません。total は 0 になり、note がそのことを示します。

  • level: error または warning で、そのレベルだけを返します。既定では両方です。
  • tableIds と tableNames: それらのテーブルとそのカラムのチェックだけを返し、辞書自身の行のチェックは含めません。名前は大文字と小文字を区別しません。どのテーブルも指さない ID や名前は notFound で拒否されます。
  • offset と limit: 既定では 1 ページ 100 件のチェックで、1 回の応答がいっぱいになったところでも止まります。続きがある間は、nextOffset と note が次のページの開始位置を示すので、それを offset として同じ絞り込みとともに渡します。いくつかのチェックを修正した後は、オフセット 0 から改めて一覧にしてください。修正したチェックは一覧から消えるため、後ろのオフセットでは、まだ修正していないチェックを飛ばしてしまいます。

応答には、絞り込みで残ったチェックの数である total、そのうち各コードに当たる数である counts（1 件もないコードは含みません）、そして checks としてそのページが入ります。 各チェックは、その level、code、そして対象の kind と id を示します。kind は table、column、word、term、domain のいずれかです。カラムのチェックには、その tableId と、table としてそのテーブルの名前が加わります。 name は対象の名前で、テーブルやカラムでは物理名です。論理名がある場合は logicalName も付きます。field はチェックが読み取るもので、name、logicalName、domainId のいずれかです。text はそこで見つかったもので、suggestions は、辞書が候補を示す場合に、代わりに使うものを示します。そのため、エージェントは erd_get を使わずにチェックを修正できます。

{"level":"warning","code":"physicalNameMismatch","kind":"column","id":"8e1z0q4xk2m7cwd5tfb9h3ynp","tableId":"03h17be2plxpj5n59tqag7ogj","table":"users","name":"id","logicalName":"Member Number","field":"name","text":"id","suggestions":["MBR_NO"]}
codelevelシートの Type検出する内容
duplicateNameerrorDuplicate name1 つの辞書の 2 つの行が共有する名前。それぞれの行が一覧に含まれます。
unknownDomainerrorUnknown domainドキュメントにもう存在しないドメインに紐付いているカラムまたは用語。text はそのドメインの名前で、名前がわからない場合はその ID です。
forbiddenWorderrorForbidden wordテーブルやカラムの論理名、または用語の名前の中にある、いずれかの単語が禁止語としている語。suggestions は標準の単語です。
unregisteredWordwarningUnregistered word同じ場所にある、どの単語にも登録されていないテキスト。
synonymWordwarningSynonym同じ場所で、標準の単語の代わりに使われている同義語。suggestions は標準の単語です。
physicalNameMismatchwarningPhysical name mismatchその論理名の用語が与えるものと異なる、テーブルやカラムの物理名。候補は用語の物理名で、用語が物理名を持たない間は、その単語から組み立てた名前です。
domainTypeMismatchwarningDomain type mismatchデータ型が、紐付けているドメインのデータ型と異なるカラム。text はカラムの型で、候補はドメインの型です。

各チェックが名前をどう読み取るかは、各チェックが検出する内容を参照してください。

編集ツール​

ID は erd_list と erd_get、またはそのエンティティを作った呼び出しの createdIds から得ます。 新しい ID は 03h17be2plxpj5n59tqag7ogj のような 25 文字の小文字の英字と数字ですが、ドキュメントがすでに持っている ID はその形のままです。そのため、ID の形から何かを読み取らないでください。 x と y はキャンバス上の左端と上端の位置をピクセル単位で表し、色は #3b82f6 のような CSS の 16 進カラー、または色を外す空文字列です。

テーブル​

ツール引数動作
erd_add_table空いている場所に空のテーブルを追加し、その ID を createdIds で返します。
erd_remove_tabletableIdテーブルを、そのカラム、インデックス、テーブルに接するすべてのリレーションシップとともに削除します。
erd_change_table_nametableId、valueテーブル名を変更します。名前はその後、手で付けたものになるため、空でない間は、後から論理名を設定してもそのまま残ります。辞書を参照してください。
erd_change_table_commenttableId、valueテーブルのコメントを設定します。空文字列で消去します。
erd_set_table_logical_nametableId、valueテーブルの論理名を設定します。空文字列では論理名を消去し、名前は残します。テーブルの名前が空であるか生成されたものである間は、辞書が論理名から名前を生成します。辞書を参照してください。用語はテーブルにドメインを与えません。
erd_change_table_colortableId、colorテーブルの色を設定します。
erd_move_tabletableId、x、yテーブルをキャンバス上の位置に移動します。
erd_move_tablespositions複数のテーブルを 1 つの編集で移動し、1 回の erd_undo で元に戻せます。positions はテーブルごとに { tableId, x, y } を持ち、各テーブルは 1 回までです。
erd_sort_tableserd_import_sql、erd_import_graphql、erd_import_dbml、erd_import_aml が配置するのと同じように、カラムの少ないテーブルから順に、すべてのテーブルをキャンバス上に行状に並べます。テーブルグループのテーブルはまとまったまま配置され、各グループの枠はそのテーブルを囲むように合わせられます。

カラム​

ツール引数動作
erd_add_columntableIdテーブルに空のカラムを追加し、その ID を createdIds で返します。
erd_remove_columnstableId、columnIds1 つのテーブルからカラムを削除し、それを使うリレーションシップとインデックスの項目も削除します。
erd_change_column_nametableId、columnId、valueカラム名を変更します。名前はその後、テーブルの名前と同じく、手で付けたものになります。
erd_change_column_data_typetableId、columnId、valueINT や VARCHAR(255) などのデータ型を設定します。リレーションシップのデータ型同期がオンの間は、エディタと同じように、変更はリレーションシップを両方向にたどって伝わります。serial 型は、erd_add_relationship がコピーするときと同じく、serial が格納する整数型として外部キーに伝わり、serial のキーは、その外部キーのいずれかが変更されても自身の型を保持して、変更はそこで止まります。この同期をオンまたはオフにするのはユーザーで、erd_list はそれを relationshipDataTypeSync として返します。ドメインに紐付いたカラムは、そのドメインとは別の型を設定すると紐付けが解除されます。同期が伝わった先のカラムのうち、新しい型が自身のドメインの型と異なるものも同様です。紐付けの解除を参照してください。
erd_change_column_defaulttableId、columnId、value既定値を SQL のテキストとして設定します。空文字列で消去します。
erd_change_column_commenttableId、columnId、valueコメントを設定します。空文字列で消去します。
erd_set_column_logical_nametableId、columnId、valueカラムの論理名を設定します。空文字列では論理名を消去し、名前は残します。カラムの名前が空であるか生成されたものである間は、辞書が名前を生成し、用語のドメインがカラムに紐付いて、カラムにそのドメインのデータ型を与えます。辞書を参照してください。
erd_set_column_domaintableId、columnId、domainId?、domainName?カラムを、ID または名前のどちらか一方で指定したドメインに紐付けます。カラムはそのドメインのデータ型になり、その型はリレーションシップのデータ型同期がオンの間はリレーションシップをたどって伝わり、紐付けの解除も erd_change_column_data_type と同じように行われます。domainId が null または空文字列の場合、あるいは domainName が空の場合は、カラムの紐付けを解除し、型はそのまま保ちます。
erd_set_column_primary_keytableId、columnId、valuetrue でカラムを主キーに含め、false で主キーから外します。
erd_set_column_uniquetableId、columnId、valueカラムをユニークにするかどうかを設定します。
erd_set_column_not_nulltableId、columnId、valueカラムを NOT NULL にするかどうかを設定します。
erd_set_column_auto_incrementtableId、columnId、valueカラムを自動インクリメントにするかどうかを設定します。
erd_move_columntableId、columnId、targetColumnIdテーブル内でカラムを、別のカラムの位置へ移動します。

リレーションシップ​

relationshipType は子側の端のカーディナリティで、ZeroOne、ZeroN、OneOnly、OneN のいずれかです。 開始テーブルは親、つまり主キーを持つ参照される側で、終了テーブルは子です。 onDelete と onUpdate は外部キーの ON DELETE と ON UPDATE のアクションで、none、noAction、cascade、setNull、setDefault、restrict のいずれかです。 none は句を書き出さないため、データベースの既定の動作が適用されます。ON DELETE と ON UPDATE を参照してください。 erd_add_relationship または erd_link_columns で省略したアクションは none になります。

ツール引数動作
erd_add_relationshipstartTableId、endTableId、relationshipType、onDelete?、onUpdate?2 つのテーブルをリレーションシップでつなぎます。親の主キーを外部キーカラムとして子にコピーし、親に主キーがない場合は先に主キーカラムを作成します。各外部キーカラムには、エディタでリレーションシップを描いたときと同じように名前が付けられます。キーが id の users からは users_id ができ、member_id のようなキーは名前がそのまま使われます。外部キーカラムの名前を参照してください。各外部キーカラムはそのキーのデータ型をコピーします。ただし、serial のキーからは serial4 に対する integer のように serial が格納する整数型ができ、単独の serial は PostgreSQL、MySQL、MariaDB 以外では serial のままです。識別リレーションシップを参照してください。各外部キーカラムはキーの論理名も受け取り、serial のキーが別の型を与える場合を除き、キーが紐付けているドメインに紐付きます。createdIds には、作成された場合はその新しいキーカラム、外部キーカラム、そして最後にリレーションシップの ID が入ります。
erd_link_columnsstartTableId、startColumnIds、endTableId、endColumnIds、relationshipType、onDelete?、onUpdate?すでにあるカラムの間にリレーションシップを描き、開始側と終了側のカラムを位置の順に対応付けます。カラムの名前もデータ型も変更せず、論理名もドメインもコピーしません。
erd_remove_relationshiprelationshipIdリレーションシップの線を削除します。その外部キーカラムはテーブルに残ります。
erd_change_relationship_typerelationshipId、relationshipTypeリレーションシップのカーディナリティを変更します。
erd_change_relationship_on_deleterelationshipId、onDeleteリレーションシップの ON DELETE のアクション、つまり親の行を削除したときにその子の行がどうなるかを設定します。
erd_change_relationship_on_updaterelationshipId、onUpdateリレーションシップの ON UPDATE のアクション、つまり親のキーを変更したときにその子の行がどうなるかを設定します。

erd_add_relationship は、実行した時点で外部キーカラムの名前を決め、そのキーの論理名をコピーします。後からキーの名前や論理名を変えても外部キーカラムには伝わらないため、親テーブルとその主キーには先に名前を付け、キーには先に論理名を付けてください。 これが付ける名前は手で付けたものとして扱われるため、後から論理名を設定してもそのまま残りますが、erd_derive_physical_names はそれらを辞書による生成の対象に戻します。辞書を参照してください。

エディタの Map Columns のように、既存のリレーションシップのカラムを変更するツールはありません。 リレーションシップを別のカラムに対応付けるには、外部キーカラムをテーブルに残す erd_remove_relationship と、目的のカラムを指定した erd_link_columns を、1 回の erd_undo で元に戻せる 1 つの erd_batch の中で実行します。

インデックス​

インデックスのカラム ID は、erd_get が返すインデックスのカラム一覧の項目の ID であり、テーブルのカラムの ID ではありません。

ツール引数動作
erd_add_indextableIdテーブルに空のインデックスを追加し、その ID を createdIds で返します。
erd_remove_indexindexIdインデックスを削除します。
erd_change_index_nameindexId、valueインデックス名を変更します。
erd_set_index_uniqueindexId、valueインデックスをユニークにするかどうかを設定します。
erd_add_index_columnindexId、columnIdインデックスのテーブルのカラムを追加し、新しいインデックスのカラム ID を返します。すでにインデックスにあるカラムはそのままです。
erd_remove_index_columnindexId、indexColumnIdインデックスからカラムを 1 つ削除します。
erd_move_index_columnindexId、indexColumnId、targetIndexColumnIdインデックス内でカラムを、そのインデックスの別のカラムの位置へ移動します。
erd_set_index_column_orderindexId、indexColumnId、orderTypeインデックス内の 1 つのカラムの並び順を ASC または DESC に設定します。

メモ​

ツール引数動作
erd_add_memo空いている場所に空のメモを追加し、その ID を createdIds で返します。
erd_remove_memomemoIdメモを削除します。
erd_change_memo_valuememoId、valueメモの本文を置き換えます。
erd_change_memo_colormemoId、colorメモの色を設定します。
erd_move_memomemoId、x、yメモをキャンバス上の位置に移動します。
erd_resize_memomemoId、width、heightメモのサイズを変更します。幅は約 116 ピクセル以上、高さは 100 ピクセル以上である必要があります。エディタはメモのサイズ変更をドラッグによるものしか記録しないため、Undo の項目は作りません。

メモを View Option → Memos で非表示にしている間も、erd_add_memo はメモを追加し、そのメモはメモが再び表示されるまで非表示のままです。 erd_list と erd_get は、非表示のメモも一覧に含めます。

テーブルグループ​

テーブルグループは、そのテーブルの背後に描かれる名前付きの枠で、グループの色は枠と、そのテーブルのヘッダー全体に表示されます。テーブルグループを参照してください。 テーブルが属するグループは最大 1 つです。erd_move_table、erd_move_tables、erd_move_table_group は、テーブルをどこに置いても、グループがどのテーブルを含むかを変えません。一方、エディタでは、テーブルはドロップした位置によってグループに加わったりグループから外れたりします。テーブルの追加と削除を参照してください。テーブルをグループに入れるのは erd_add_table_group と erd_set_table_group で、erd_remove_table_group はそのテーブルをどのグループにも属さない状態にします。 グループは、タイトルバーを含めて幅 160 ピクセル以上、高さ 100 ピクセル以上の矩形を保存し、エディタは各テーブルを収めるように広げた枠を描きます。

ツール引数動作
erd_add_table_groupname、color?、x?、y?、width?、height?、tableIds?グループを追加し、その ID を createdIds で返します。tableIds か、x、y、width、height をそろえた矩形のどちらかを渡します。tableIds を渡すと、各テーブルはそれまで属していたグループを離れ、矩形は選択したテーブルのグループ化と同じようにそれらのテーブルを囲むように合わせられます。矩形を渡すと、グループの描画と同じように、どのグループにも属しておらず、中心が矩形の内側にあるすべてのテーブルがグループに加わります。name が空の場合、グループは名前のないままです。1 回の erd_undo でグループが削除され、各テーブルは元のグループに戻ります。
erd_remove_table_groupgroupIdグループを削除します。そのテーブルはその場に残り、どのグループにも属さなくなります。
erd_change_table_group_namegroupId、valueグループ名を変更します。空文字列では名前のないグループになります。
erd_change_table_group_colorgroupId、colorグループの色を設定します。
erd_move_table_groupgroupId、x、yタイトルバーをドラッグしたときと同じように、矩形がその位置から始まるようにグループを移動し、そのテーブルも同じだけ移動します。横方向と縦方向の移動量の合計が 20 ピクセル未満の移動は、Undo の項目を作りません。1.2.0 以降のサーバーでは、移動はグループとそのテーブルが終わる位置の点としてエディタに届くため、VS Code の拡張機能 4.3.0 以降または Obsidian か JetBrains のプラグイン 1.3.0 以降では、そこで同時に行ったグループまたはそのテーブルの 1 つの移動は、2 つの位置のどちらか一方で終わり、合計になることはありません。同時に行われた編集を参照してください。
erd_resize_table_groupgroupId、x?、y?、width、heightグループの矩形を設定します。そのテーブルはその場に残ります。x と y を省略すると、矩形の角はそのままです。グループのテーブルを余白とともに収められない矩形は拒否され、収める必要のある範囲がメッセージに示されます。
erd_set_table_grouptableIds、groupIdテーブルをグループに入れます。各テーブルは、それまで属していたグループを離れます。groupId が null または空文字列の場合は、テーブルをすべてのグループから外します。

グループを View Option → Table Groups で非表示にしている間も、これらのツールはグループを追加、変更し、それらのグループはグループが表示されるまで非表示のままです。グループの非表示を参照してください。 erd_sort_tables は各グループのテーブルをまとめたまま配置し、erd_import_dbml と erd_import_json はグループを取り込み（読み込みを参照）、erd_read は groupNames で選んだグループの DDL を書き出します。 テーブルグループが導入される前のリリースの ERD Editor でファイルを保存すると、そのファイルのグループが失われます。4.0.0 より前の VS Code の拡張機能や、1.0.0 より前の Obsidian と JetBrains のプラグインがこれに当たります。アップデートを参照してください。

辞書​

これらのツールは、エディタの辞書タブにある次の 3 つの辞書を編集します。テーブルやカラムの論理名は、これらの辞書から物理名を生成します。

  • 単語は、論理名を構成する標準の単語で、Member と MBR のように、物理名でその単語に使う英略語を持ちます。
  • 用語は論理名全体で、Member Number と MBR_NO、Identifier のように、その用語が与える物理名と、カラムの場合は紐付けるドメインを持ちます。
  • ドメインは、カラムが紐付く名前の付いたデータ型で、例えば INT に対する Identifier です。
ツール引数動作
erd_add_wordname、abbreviation、englishName?、description?、synonyms?、forbiddenWords?単語の辞書の末尾に単語を追加し、その ID を createdIds で返します。synonyms と forbiddenWords はカンマ区切りで、それぞれその単語の別の綴りと、その単語の代わりに使ってはならない語です。
erd_update_wordwordId、name?、abbreviation?、englishName?、description?、synonyms?、forbiddenWords?渡したフィールドを変更し、それ以外はそのまま残します。
erd_remove_wordwordId単語を削除します。
erd_add_termname、physicalName?、domainId?、domainName?、description?、synonyms?用語の辞書の末尾に用語を追加し、その ID を createdIds で返します。physicalName がない場合は、可能であれば単語から物理名を組み立てます。例えば Member Number からは MBR_NO を組み立てます。
erd_update_termtermId、name?、physicalName?、domainId?、domainName?、description?、synonyms?渡したフィールドを変更し、それ以外はそのまま残します。用語が物理名を持たない間に name を渡すか、空の physicalName とともに name を渡すと、単語から物理名を組み立てられる場合は、その物理名も書き込みます。
erd_remove_termtermId用語を削除します。
erd_add_domainname、category?、dataType、description?ドメインの辞書の末尾にドメインを追加し、その ID を createdIds で返します。category は、Number や Text のようにドメインを分類します。
erd_update_domaindomainId、name?、category?、dataType?、description?渡したフィールドを変更し、それ以外はそのまま残します。新しい dataType は、そのドメインに紐付いたすべてのカラムに伝わり、リレーションシップのデータ型同期がオンの間はリレーションシップをたどって伝わり、紐付けの解除も erd_change_column_data_type と同じように行われます。
erd_remove_domaindomainIdドメインを削除します。そのドメインに紐付いていたカラムはデータ型を保ち、それらのカラムと、そのドメインに紐付いていた用語には、ドメインが表示されなくなります。その domainId は空文字列として読み取られます。erd_undo で紐付けは戻り、保存するとファイルからは紐付けが除かれます。
erd_derive_physical_namesscope、tableId?、columnId?エディタの物理名の再生成と同じように、1 つのカラム、1 つのテーブル、またはドキュメント全体について、論理名から物理名を再生成します。
  • 辞書は各名前を 1 つしか持たないため、同じ辞書の別の行が持つ名前は invalidArgs で拒否されます。名前は前後の空白を除いて、大文字と小文字を区別して比較されるため、Member と member は 2 つの名前です。
  • 更新では、行を ID で指定し、少なくとも 1 つのフィールドを渡します。行がすでに持っている値は何も変えず、Undo の項目も作りません。追加と削除は常に Undo の項目を作ります。
  • 用語のドメインは、domainId（なしは null または空文字列）か、domainName（なしは空文字列）のどちらかで指定します。domainName は、辞書の順でその名前を持つ最初のドメインを取り、名前と同じように比較されます。両方を渡した場合や、どのドメインも持たない domainName を渡した場合は拒否されます。erd_set_column_domain も同じようにドメインを受け取ります。
  • 単語や用語を変更または削除しても、名前は変わらず、紐付けも解除されません。それが与えた名前とドメインはそのまま残ります。erd_derive_physical_names は名前を再生成し、用語が現在与えるドメインを紐付けますが、現在どの用語にも一致しないカラムや、用語がドメインを与えないカラムは、紐付けているドメインを保ちます。紐付けを解除するには、空の domainId で erd_set_column_domain を呼び出します。
  • 辞書タブのように、辞書を CSV として読み込んだり書き出したり、辞書を並べ替えたり、位置を指定して行を挿入したりするツールはありません。

erd_list は行を一覧にし、erd_get はすべてのフィールドを返し、erd_read の snapshot 形式はそのすべてを含み、erd_list_checks は辞書が問題として検出したものを一覧にします。ドキュメントの読み取りを参照してください。

erd_set_table_logical_name と erd_set_column_logical_name は、エディタで論理名を入力したときと同じように、次のとおり物理名を生成します。物理名の生成を参照してください。

  • 名前が生成されるのは、名前が空であるか、それ自体が生成されたものである間だけで、読み取りではこれが nameDerived: true として示されます。空でなく手で付けた名前はそのまま残り、論理名だけが書き込まれます。erd_change_table_name、erd_change_column_name、SQL、GraphQL、DBML、AML の読み込み、そして erd_add_relationship が名前を付ける外部キーカラムは、どれも手で付けた名前になります。空文字列に変更した名前は、次の論理名で再び生成されます。
  • 名前が論理名と一致する用語が優先され、辞書の名前と同じように比較されます。その用語は自身の物理名を、物理名を持たない間はその単語から組み立てた名前を与えます。カラムの場合は、名前が生成されないときでも用語のドメインを紐付け、カラムはそのドメインのデータ型になり、その型はリレーションシップのデータ型同期がオンの間はリレーションシップをたどって伝わります。
  • そのような用語がない場合は、単語の英略語をアンダースコアでつないで名前を組み立てます。Member Number からは MBR_NO ができます。組み立ては、すべて成功するか、何も組み立てないかのどちらかです。同義語、禁止語、どの単語にも登録されていないテキスト、英略語のない単語があると何も組み立てず、名前は元のままです。単語はドメインを紐付けず、ドメインを持たない用語も紐付けないため、カラムは紐付けているドメインを保ちます。
  • 生成された名前を、大文字と小文字を区別せずに比べて、同じテーブルの別のカラムがすでに持っている場合、そのカラムは名前、nameDerived、ドメインを保ちます。
  • 論理名を消去しても、物理名はそのまま残ります。論理名とそこから生成されるものがすでにそのとおりになっている呼び出しは、何も変えず、Undo の項目も作りません。

erd_derive_physical_names は scope を受け取ります。そのカラムを対象とする column（tableId と columnId を指定）、テーブルの名前とそのすべてのカラムを対象とする table（tableId を指定）、またはすべてのテーブルとそのカラムを対象とする document（ID は指定しない）のいずれかです。必要な ID がない scope や、受け取らない ID を渡した scope は拒否されます。 対象となる名前のうち論理名を持つものは、手で付けた名前も含めて辞書による生成の対象に戻り、辞書が現在与えるものになります。つまり、用語の物理名と、カラムの場合はそのドメインと型、あるいは単語から組み立てた名前で、後者ではカラムのドメインはそのまま残ります。何も生成しない論理名では名前はそのまま残り、nameDerived は true になります。論理名のない名前はそのまま残り、1 つのテーブルへの 2 つ目の外部キーのように、新しい名前を同じテーブルの別のカラムが持っているカラムもそのまま残って、nameDerived も保ちます。1 回の erd_undo で呼び出し全体が元に戻ります。 読み込んだスキーマの名前は手で付けたものになるため、辞書から名前を付けるには、論理名を設定してから erd_derive_physical_names を呼び出します。この呼び出しは用語自身の物理名を与え、用語の単語を変更してもその物理名が組み立て直されることはありません。そのため、用語の単語を変更した後は、先に用語を更新してください。単語から組み立て直すには空の physicalName とともにその name を渡し、そうでなければ新しい physicalName を渡します。

辞書タブが導入される前のリリースの ERD Editor でファイルを保存すると、そのファイルの論理名、ドメインの紐付け、辞書の行が失われます。4.2.0 より前の VS Code の拡張機能や、1.2.0 より前の Obsidian と JetBrains のプラグインがこれに当たります。そのうち、拡張機能の 4.0.0 または 4.1.0 と、プラグインの 1.0.0 または 1.1.0 は引き続きサーバーとライブで編集できますが、エージェントが書き込んだ論理名、ドメインの紐付け、辞書の行を表示も保持もしません。アップデートを参照してください。

設定​

エージェントが設定するのは、スキーマそのものの設定、つまりデータベース、データベース名、Schema SQL のスクリプトです。 ドキュメントが保存するそれ以外の設定は、ユーザーがエディタで設定するものです。名前の表示、View Option の切り替え、設定タブのオプション、Code Generator の言語と名前のケース、括弧の種類、そしてロックです。 replace モードの読み込みを除き、これらを変更するツールはありません。erd_import_json は読み込むドキュメントの設定とロックを持ち込み、ほかの 4 つは表示をキャンバスの開始位置に戻します。読み込みを参照してください。 サーバー 1.0.0 では、これらを設定するツールが削除されました。erd_set_language、erd_set_table_name_case、erd_set_column_name_case、erd_set_bracket_type、erd_set_relationship_data_type_sync、erd_set_relationship_optimization、erd_set_column_order、erd_set_max_width_comment、erd_set_ignore_save_settings、erd_set_show です。

erd_list と erd_read の snapshot 形式は、設定をファイルに保存されるとおりに返します。lockSettings には、ロックごとに 1 つずつ、viewport、canvasType、language、tableNameCase、columnNameCase、bracketType、unlockNameViewMode のフラグが入ります。 最後のフラグはほかとは逆の意味になります。Name View のロックがオンの間は false で、新しいドキュメントや、このロックができる前に保存したファイルではそうなっています。ユーザーがロックをオフにすると true になります。 ロックされた言語、名前のケース、括弧の種類は、エディタの画面に何が表示されていても、ロックされた値、つまりファイルが保持し、どのエディタも開くときに使う値として返されます。表示、タブ、名前の表示は返されません。エージェントは、名前の表示が何を表示していても、論理名を読み書きします。

erd_set_ddl_script は Undo の項目を作ります。erd_set_database と erd_set_database_name は作らないため、erd_undo では元に戻せません。

ツール引数動作
erd_set_databasevalueデータベースを MariaDB、MSSQL、MySQL、Oracle、PostgreSQL、SQLite、Databricks、Snowflake のいずれかに設定します。そのデータベースのデータ型と、vendor を指定しないときに erd_read が出力する DDL を決めます。
erd_set_database_namevalueデータベース名を設定します。erd_read の use と createAndUse のヘッダーは、この名前を使います。
erd_set_ddl_scriptposition、sqlテーブルの前後に書き出される 2 つのスクリプトのうちの 1 つを設定します。前後のスクリプトを参照してください。position は、CREATE EXTENSION や CREATE SCHEMA のようにテーブルの前に書き出される before、または GRANT や CREATE VIEW のようにテーブルの後に書き出される after です。sql はスクリプト全体を置き換え、最大 10,000 文字で、空文字列ではスクリプトが削除されます。現在のスクリプトは、先に erd_read の scripts 形式で読み取ってください。

スクリプトはどのデータベースの DDL にもそのまま書き出されるため、ドキュメントのデータベース向けに書いてください。MSSQL では、最後の行が GO ではないスクリプトの後に GO の行が追加されます。 これらのスクリプトが導入される前のリリースの ERD Editor でファイルを保存すると、そのファイルのスクリプトが失われます。4.0.0 より前の VS Code の拡張機能や、1.0.0 より前の Obsidian と JetBrains のプラグインがこれに当たります。アップデートを参照してください。

読み込み​

これらのツールは、エディタの Import メニューと同じ方法でスキーマを読み込みます。ファイルの読み込みと書き出しを参照してください。 どれもテキストを value として受け取り、mode として既定値の replace か、append を受け取ります。

ツール引数動作
erd_import_sqlvalue、mode?CREATE TABLE 文などの SQL DDL を読み込みます。
erd_import_graphqlvalue、mode?GraphQL SDL を読み込みます。
erd_import_dbmlvalue、mode?DBML を読み込みます。各 TableGroup は、それが挙げるテーブルを含むテーブルグループになります。DBML を参照してください。
erd_import_amlvalue、mode?AML を読み込みます。
erd_import_jsonvalue、mode?別の .erd.json ファイルなど、erd-editor の JSON ドキュメントを読み込みます。

replace はドキュメントを置き換え、erd_undo で前のドキュメントに戻せます。

  • erd_import_sql、erd_import_graphql、erd_import_dbml、erd_import_aml は、すべてのテーブル、リレーションシップ、インデックス、メモ、テーブルグループを置き換えます。ドキュメントの設定はロックも含めて維持しますが、表示だけはキャンバスの開始位置に 100% で戻ります。単語、用語、ドメインの辞書も維持します。これらが持ち込むテーブルは論理名を持たず、どのドメインにも紐付きません。
  • erd_import_json は、設定と辞書も含めてドキュメント全体を置き換えます。JSON の設定、ロック、単語、用語、ドメインがこのドキュメントのものに代わり、ロックを記録していない JSON では、すべてのロックがオンになり、表示がキャンバスの開始位置に移ります。各閲覧者は自分の名前の表示を保ちますが、JSON の Name View のロックがオフの場合は、その名前の表示が持ち込まれます。このドキュメントの設定を保つには、erd_read の json 形式が返すテキストから始めてください。空のテキストでは、erd_open_document が create で作成するものと同じ、新しいドキュメントになります。

VS Code の拡張機能 4.3.0 以降または Obsidian か JetBrains のプラグイン 1.3.0 以降のエディタでは、replace とその erd_undo または erd_redo も、描画中のリレーションシップを終了します。ライブを参照してください。

append は、エディタの Import and Add と同じように、読み込んだものをドキュメントに追加し、1 回の erd_undo で追加全体を取り消せます。

  • テキストにあるものは、新しい ID を持つ新しいエンティティとして、1 つのまとまりで入ります。まとまりは、非表示のメモやテーブルグループも含めてドキュメントにあるすべてのものの下に、その左端にそろえて置かれます。すでにあるテーブルと設定はすべてそのまま残り、同じ名前のテーブルも残ります。名前による統合は行われません。
  • リレーションシップとインデックスは、読み込みが持ち込むテーブルの間にだけ作られるため、テキストで宣言されていないテーブルへの外部キーは破棄されます。
  • erd_import_sql、erd_import_graphql、erd_import_aml はテーブルをそのリレーションシップとインデックスとともに追加し、erd_import_dbml はテーブルグループも追加します。erd_import_json はテーブル、リレーションシップ、インデックス、メモ、テーブルグループを追加しますが、設定は追加せず、空のテキストは拒否します。そのテーブルとカラムは論理名を持ち込みますが、どのカラムもドメインに紐付かず、JSON の単語、用語、ドメインは何も入りません。

JSON ドキュメントは、テーブルグループも含めて自身の配置を保ちます。replace ではテーブルを置く位置として、append では追加したまとまりの中での位置として保ちます。 SQL、GraphQL、DBML、AML のテーブルは、erd_sort_tables が配置するのと同じように、カラムの少ないテーブルから順に、各グループのテーブルをまとめて行状に並べられます。エディタ自身の Import が可能な場合に使う Flow で配置されることはありません。これら 4 つのツールは、どちらのモードでも空のテキストを拒否します。

erd_batch​

erd_batch は複数の編集ツールを順に、1 つの編集として実行します。すべて適用されるか、何も適用されないかのどちらかです。

  • operations には最大 100 件の項目を指定し、各項目は { tool, as?, args? } の形です。tool は編集ツールで、args は path を除いた、そのツールの引数です。erd_list_checks のような読み取りツールは拒否されます。
  • 操作はまずドキュメントのコピーで試されます。拒否された操作は operations[1] erd_remove_table: … のように示され、何も適用されません。
  • 1 回の erd_undo でバッチ全体が元に戻ります。ただし、元に戻せない操作は除き、結果の undoNote がそれらを示します。erd_set_database のように Undo の項目を作らないツールの操作と、短い距離の erd_move_table_group のように項目を作らずにドキュメントを変更した操作です。Undo の項目をまったく作らなかったバッチは、erd_undo に飛ばされます。結果の historyEntries はバッチ内のエディタの履歴の件数で、erd_undo の呼び出し回数ではありません。
  • ライブのセッションでは、エディタはバッチ全体を受け入れるか、まったく受け入れないかのどちらかです。

エージェントは、バッチが作成する ID を呼び出す前に知ることができません。そこで as で名前を付けた操作の ID は、後の操作から参照できます。最初に作成された ID は $name または $name.0、2 番目は $name.1、最後は $name.last です。 名前に使えるのは ASCII の英字、数字、アンダースコアで、数字で始めることはできず、1 つの名前は 1 つの操作にしか付けられません。 参照が解決されるのは、wordId、termId、domainId を含め、エンティティの ID を受け取る引数だけなので、$x と書かれた名前やコメントはテキストのままです。 domainName もテキストですが、その操作の実行時に読み取られるため、バッチの前の操作で追加したドメインを指定できます。

テーブルとそのカラム、リレーションシップを 1 回の呼び出しで作成する例です。

{
  "path": "shop.erd.json",
  "operations": [
    { "tool": "erd_add_table", "as": "users" },
    { "tool": "erd_change_table_name", "args": { "tableId": "$users", "value": "users" } },
    { "tool": "erd_add_column", "as": "uid", "args": { "tableId": "$users" } },
    { "tool": "erd_change_column_name", "args": { "tableId": "$users", "columnId": "$uid", "value": "id" } },
    { "tool": "erd_change_column_data_type", "args": { "tableId": "$users", "columnId": "$uid", "value": "BIGINT" } },
    { "tool": "erd_set_column_primary_key", "args": { "tableId": "$users", "columnId": "$uid", "value": true } },
    { "tool": "erd_add_table", "as": "orders" },
    { "tool": "erd_change_table_name", "args": { "tableId": "$orders", "value": "orders" } },
    { "tool": "erd_add_relationship", "args": { "startTableId": "$users", "endTableId": "$orders", "relationshipType": "ZeroN", "onDelete": "cascade" } }
  ]
}

users とそのキー id にはリレーションシップより前に名前が付いているため、リレーションシップが orders に追加する外部キーカラムは users_id になります。

単語、ドメイン、用語を作成し、続いてその論理名によってそれらから名前を付けるテーブルを作成する例です。

{
  "path": "shop.erd.json",
  "operations": [
    { "tool": "erd_add_word", "args": { "name": "Member", "abbreviation": "MBR" } },
    { "tool": "erd_add_word", "args": { "name": "Number", "abbreviation": "NO" } },
    { "tool": "erd_add_word", "args": { "name": "Name", "abbreviation": "NM" } },
    { "tool": "erd_add_domain", "as": "identifier", "args": { "name": "Identifier", "dataType": "INT" } },
    { "tool": "erd_add_term", "args": { "name": "Member Number", "domainId": "$identifier" } },
    { "tool": "erd_add_table", "as": "members" },
    { "tool": "erd_set_table_logical_name", "args": { "tableId": "$members", "value": "Member" } },
    { "tool": "erd_add_column", "as": "no", "args": { "tableId": "$members" } },
    { "tool": "erd_set_column_logical_name", "args": { "tableId": "$members", "columnId": "$no", "value": "Member Number" } },
    { "tool": "erd_add_column", "as": "nm", "args": { "tableId": "$members" } },
    { "tool": "erd_set_column_logical_name", "args": { "tableId": "$members", "columnId": "$nm", "value": "Member Name" } }
  ]
}

用語は単語から MBR_NO を組み立て、テーブルには MBR という名前が付きます。カラム Member Number は用語の MBR_NO とそのドメインを受け取るため、Identifier に紐付いて型が INT になり、どの用語にもない Member Name は MBR_NM として組み立てられます。

結果​

編集は 1 行の JSON を返します。

{"tool":"erd_add_table","mode":"live","createdIds":["03h17be2plxpj5n59tqag7ogj"],"batches":1,"historyEntries":1}
フィールド意味
modelive または headless。ライブとヘッドレスを参照してください。
savedヘッドレスでのすべての編集、erd_batch、erd_undo、erd_redo の結果で true になります。呼び出しが応答する時点でファイルには変更が入っているため、保存するものは残りません。ライブの結果には saved がありません。変更を保持しているのはエディタだからです。保存を参照してください。
createdIds呼び出しが作成したものの ID を、作成した順に並べたもの。
batches、historyEntries呼び出しが送った変更のバッチの数と、作成したエディタの履歴の件数。
undoable、undoNoteerd_undo がその呼び出しを飛ばす場合は undoable が false になり、undoNote がその理由を示します。理由は、そのツールが Undo の項目を作らないこと、20 ピクセル未満の erd_move_table_group のように呼び出しが項目を作らずにドキュメントを変更したこと、またはドキュメントがすでにその値を持っていたことです。erd_batch の結果には常に undoNote が付きます。バッチが Undo の項目を作った場合、その注記は 1 回の erd_undo でバッチが元に戻ることを示し、元に戻らずに残る操作があればその名前を示します。項目を作らなかった場合、結果には undoable: false が付き、注記は erd_undo がそのバッチを飛ばすことを示します。
mismatch呼び出しが作成したバッチまたは履歴の件数が、ツールが宣言する数と異なる場合に含まれます。
notesエディタが終了したかドキュメントを扱うのをやめた場合や、ディスク上のファイルが変更された場合など、セッションについて何かが変わったときに含まれます。

拒否は、コードと、どうすればよいかを示すメッセージを含むエラーの結果です。

{"error":{"code":"notFound","message":"tableId nope names no live table; read the document for current ids"}}
code理由
notFoundID が指すものが存在しないか、ファイルが存在しません。
invalidArgs引数がないか、値が正しくありません。
invalidPathパスが ERD ドキュメントではありません。Windows では、Windows が指定どおりに保存しない名前を含むパスや、エディタが別のパスで保持しているドキュメントを指すパスも該当し、その別のパスはメッセージに示されます。
invalidDocumentファイルが、エディタで読めるドキュメントではありません。
tooLarge読み取りが 1 回の応答に収まりません。
blockedハブがオフのエディタが、ドキュメントを保持しています。メッセージにはハブをオンにする方法が示されます。VS Code ではワークスペースを信頼して dineug.erd-editor.agentHub.enabled をオンにするか、ウィンドウを再読み込みします。Obsidian では Coding agents をオンにするか、Obsidian を再読み込みします。JetBrains IDE では Coding agents をオンにするか、オンなら IDE を再起動します。
hubDisabledJetBrains IDE が、信頼していないプロジェクトでだけドキュメントを保持しています。読み取りは引き続き行えます。エージェントに編集させるには、プロジェクトを信頼してください。
conflict呼び出しの間にディスク上のファイルが変更されました。何も書き込まれていません。
hubAppeared、hubGoneエージェントがディスク上で編集していたドキュメントをエディタが扱い始めたか、ドキュメントを扱っていたエディタが動作しているものの、そのロックファイルと接続がなくなりました。何も書き込まれていません。
notSavederd_save がエディタのドキュメントを保存できませんでした。
readonlyエディタがドキュメントを読み取り専用で保持しています。例えば、書き込めないファイルや、ダイアグラムとして読めないファイルです。エディタがない場合は、ファイル自体が読み取り専用です。例えば、チェックアウトしていない Perforce や TFVC のファイルです。何も書き込まれていません。
protocolMismatchエディタの ERD Editor 拡張機能またはプラグインと、サーバーのプロトコルのバージョンが異なります。例えば、サーバー 1.0.0 以降と、VS Code の拡張機能 3.x の組み合わせです。読み取りも拒否され、メッセージには更新が必要な側が示されます。アップデートを参照してください。
hubUnreachable、timeout、disconnectedエディタのハブが接続を受け付けなかったか、30 秒以内に応答しなかったか、呼び出しの途中で接続を切りました。Windows では、hubUnreachable は Windows がエージェントをハブに接続させなかったことも意味します。エディタがエージェントより高い権限で動作している場合で、例えばエディタを管理者として起動しエージェントはそうしなかった場合や、エージェントがサンドボックス内で動作している場合です。

ほかのコードはまれにしか発生しません。どの拒否にも、何が起きたかを示すメッセージが含まれます。

編集ツール、erd_batch、4 つの読み取りツールは、宣言していない引数や型の誤った引数を、ドキュメントに触れる前に JSON-RPC の invalid params エラー（-32602）で拒否するため、綴りを誤った引数が黙って無視されることはありません。 5 個のセッションのツールは、知らない引数を無視します。