Orodja

Strežnik ponuja 77 orodij: pet orodij seje, štiri orodja za branje, 67 orodij za urejanje, po eno za vsako operacijo urejanja, in erd_batch, ki izvede več orodij za urejanje kot eno spremembo.

Vsako orodje razen erd_list_documents sprejme kot prvi argument path, pot do dokumenta, spodnje tabele pa ta argument izpuščajo. Argument, označen z ?, je neobvezen.

Orodja seje

Orodje	Argumenti	Kaj naredi
erd_list_documents		Navede dokumente ERD s polji path, open, active, dirty in readonly: dokumente urejevalnika, ki streže delovni imenik, kar v razvojnem okolju JetBrains zajema vse odprte projekte, sicer pa datoteke ERD v delovnem imeniku.
erd_open_document	create?	Odpre dokument za urejanje, in sicer v urejevalniku ERD Editor znotraj urejevalnika, ki ga streže, če tak urejevalnik obstaja. Z argumentom create najprej ustvari datoteko, če ta ne obstaja, ime brez končnice pa dobi končnico .erd.json.
erd_save		Shrani dokument, ki ga ima urejevalnik. VS Code pusti spremembe agenta neshranjene, dokler se to orodje ne pokliče; aplikacija Obsidian in razvojno okolje JetBrains jih shranjujeta tako kot vaše, to orodje pa jih zapiše takoj. V načinu brez vmesnika je vsaka sprememba že zapisana, kot pove vrednost saved: true v njenem rezultatu, in to orodje ne naredi ničesar.
erd_undo		Razveljavi zadnjo spremembo, ki jo je naredil ta agent, nikoli vaše. Klici, ki niso ustvarili vnosa za razveljavitev, se preskočijo in navedejo.
erd_redo		Znova uveljavi spremembo, ki jo je nazadnje razveljavilo orodje erd_undo.

Za to, kaj v posameznem načinu naredita shranjevanje in razveljavitev, glejte stran V živo in brez vmesnika.

Branje dokumenta

Orodje	Argumenti	Kaj naredi
erd_list	query?, offset?, limit?, namesOnly?	Nastavitve in števila, nato stran tabel z njihovimi indeksi in relacijami, vsaka tabela z identifikatorjem, položajem in velikostjo na platnu, številom stolpcev, logičnim imenom, če ga ima, in skupino tabel, če je v kateri. Razen pri iskanju tabelam sledijo skupine tabel, beležke ter nato domene, izrazi in besede.
erd_get	tableIds?, tableNames?, relationshipIds?, indexIds?, memoIds?, tableGroupIds?, wordIds?, termIds?, domainIds?	Navedene entitete v celoti: tabele z njihovimi stolpci in skupino tabel, relacije z njihovimi stolpci ter vrednostma onDelete in onUpdate, indeksi z njihovimi stolpci, beležke z besedilom, skupine tabel z njihovimi tabelami ter besede, izrazi in domene z vsemi polji.
erd_read	format, vendor?, statements?, header?, logicalNameAsComment?, tableIds?, tableNames?, groupNames?	Celoten dokument naenkrat v enem od štirih formatov ali DDL samo nekaterih tabel ali skupin tabel.
erd_list_checks	level?, tableIds?, tableNames?, offset?, limit?	Težave, ki jih najdejo slovarji besed, izrazov in domen, kakor jih navaja list Checks na zavihku Slovar urejevalnika, po straneh. Ničesar ne spremeni – glejte razdelek Preverjanja slovarjev.

Agent poišče identifikatorje z orodjem erd_list, stolpce, vrstice slovarjev in druge podrobnosti prebere z orodjem erd_get, te identifikatorje pa poda orodjem za urejanje. Velikost tabele v orodju erd_list je okvir, ki ga tabela zaseda na platnu: višina je natančna, širina približna. Skupina tabel se navede s pravokotnikom, ki ga hrani, z imenom, barvo in številom tabel, ki jih vsebuje. Vsaka relacija se navede enkrat, pri eni od svojih dveh tabel. Vrstica slovarja se navede z identifikatorjem, poljem name in tistim, kar da fizičnemu imenu ali stolpcu: poljem dataType pri domeni, poljema physicalName in domainId pri izrazu ter poljem abbreviation pri besedi. Vsak slovar navede svoje vrstice v vrstnem redu, ki ga prikazuje njegov list. Nastavitve, ki jih navajata orodji erd_list in erd_read, so tiste, ki se shranijo v datoteko – glejte razdelek Nastavitve.

V orodju erd_get in formatu snapshot orodja erd_read ima vsaka tabela in vsak stolpec polje logicalName, ki je prazen niz, kadar logičnega imena ni, in polje nameDerived, ki je true, dokler so ime dali slovarji, tako da ga novo logično ime znova izpelje – glejte razdelek Slovarji. Vsak stolpec ima polje domainId, prav tako vsak izraz: prazen niz, kadar domene ni ali kadar gre za domeno, ki je dokument ne navaja več.

Orodje erd_read sprejme enega od štirih formatov:

format	Kaj vrne
snapshot	Kompakten JSON z vsemi entitetami in njihovimi identifikatorji, vključno s skupinami tabel ter vrsticami besed, izrazov in domen, ter nastavitve s skripti Sheme SQL. Izpusti, kar se razlikuje od enega gledalca do drugega: izmerjene širine, vrstni red prekrivanja, pogled, zavihek in prikaz imen. Pri veliki shemi je obsežen.
sql	DDL za eno od osmih zbirk podatkov: Databricks, MariaDB, MSSQL, MySQL, Oracle, PostgreSQL, Snowflake ali SQLite. Privzeta vrednost argumenta vendor je zbirka podatkov, nastavljena v dokumentu. DDL celotnega dokumenta vključuje njegove skripte pred tabelami in za njimi. Z argumenti tableIds, tableNames ali groupNames samo te tabele s tujimi ključi, ki jih vsebujejo, in brez skriptov. Tuji ključi vključujejo svoja dejanja ON DELETE in ON UPDATE, razen tistih, ki jih ciljna zbirka podatkov izpusti – glejte razdelek ON DELETE in ON UPDATE.
json	Celoten dokument natanko tako, kot shranjevanje zapiše datoteko, vključno s spremembami, ki jih urejevalnik še ni shranil – glejte razdelek Oblika za shranjevanje.
scripts	Samo skripta dokumenta pred tabelami in za njimi, v obliki {"before":"…","after":"…"}, vsak prazen, če ni nastavljen, ne glede na to, kako velika je shema.

Argumente vendor, statements, header, logicalNameAsComment, tableIds, tableNames in groupNames sprejme samo format sql, vsak drug format pa jih zavrne.

• statements: create, privzeta vrednost; ifNotExists, ki v MySQL, MariaDB, PostgreSQL, SQLite in Databricks zapiše CREATE TABLE IF NOT EXISTS, v drugih pa navaden CREATE TABLE; ali recreate, ki tabele pred ustvarjanjem izbriše, pri čemer Snowflake namesto tega zapiše CREATE OR REPLACE TABLE.
• header: none, privzeta vrednost; use, ki izbere zbirko podatkov ali shemo, ki jo določa ime zbirke podatkov dokumenta; ali createAndUse, ki jo najprej ustvari. Oracle pozna samo use, zato createAndUse tam zapiše use, PostgreSQL pa pozna samo createAndUse, zato use tam ne zapiše glave. SQLite ne zapiše nobene, nobena zbirka podatkov pa je ne zapiše, dokler je ime zbirke podatkov prazno ali ni preprost identifikator.
• logicalNameAsComment: true zapiše logično ime tabele ali stolpca kot komentar, dokler je komentar prazen ali vsebuje samo presledke, in sicer na mestu in v obliki, v kateri posamezna zbirka podatkov zapiše komentar, vsak komentar z besedilom pa ohrani; false, privzeta vrednost, ne zapiše nobenega logičnega imena – glejte razdelek Logična imena kot komentarji.
• groupNames: tabele navedenih skupin tabel, po imenu ne glede na velikost črk, združene s tabelami iz tableIds in tableNames. Ime, ki se ne ujema z nobeno skupino, se zavrne s kodo notFound. Skupina brez tabel ne doda nobene, branje, ki ostane brez vsake tabele, na primer ko so vse navedene skupine prazne in ni navedena nobena tabela, pa se zavrne s kodo invalidArgs.

Argumenti statements, header in logicalNameAsComment veljajo tudi za DDL nekaterih tabel. Delujejo kot možnosti Statements in Header ter stikalo Write logical names into empty comments na zavihku Shema SQL urejevalnika, le da ima zavihek na začetku nastavljeni možnosti If not exists in CREATE + USE. Stikalo je na začetku izklopljeno, tako kot argument logicalNameAsComment. Imena se obdajo z narekovaji vrste, ki jo shranjuje datoteka, dokler je nastavitev Bracket Type zaklenjena, pa z narekovaji zaklenjene vrste – glejte razdelek Zaklepanje.

Velike sheme

Delujejo tudi sheme s stotinami ali tisoči tabel. Branje vrne največ 40.000 znakov, kar je pod mejo, pri kateri Claude Code rezultat orodja odloži v datoteko.

• erd_list privzeto vrne stran s 100 elementi, najprej tabele, nato skupine tabel, beležke, domene, izraze in besede, pri čemer en odmik teče skozi vse, z vrednostma nextOffset in note pa pove, kje se začne naslednja stran. To vrednost nextOffset podajte kot offset, z enakim argumentom query.
• query najde tabele po besedah v imenu, logičnem imenu ali komentarju tabele ali stolpca, ne glede na velikost črk. Tabele, katerih imena ali logična imena vsebujejo več teh besed, se navedejo najprej. Iskanje ne navaja skupin tabel, beležk ali vrstic slovarjev.
• namesOnly navede samo imena tabel, približno 2.000 kratkih imen v enem odgovoru.
• erd_get in erd_read poleg identifikatorjev sprejmeta tudi tableNames, erd_read pa sprejme še groupNames, zato agent, ki ga prosijo za poizvedbo SQL nad veliko shemo, prebere DDL samo tistih tabel, ki jih potrebuje.
• Tudi slovarji pridejo po delih: erd_list po straneh navaja njihove vrstice za tabelami, erd_get pa da vrstice v celoti po domainIds, termIds in wordIds.
• erd_get identifikatorje in imena, ki ne označujejo ničesar, navede pod missing, identifikatorje, za katere v enem odgovoru ni prostora, pa pod notReturned, da jih je mogoče zahtevati znova.
• erd_list_checks na enak način vrne po eno stran naenkrat – glejte razdelek Preverjanja slovarjev.
• Branje, ki je preveliko za en odgovor, se zavrne s kodo tooLarge in navodilom, kako ga zožiti.

Preverjanja slovarjev

erd_list_checks navede preverjanja z lista Preverjanja urejevalnika, v enakem vrstnem redu: najprej preverjanja besed, nato preverjanja izrazov in domen, vsak slovar v vrstnem redu, ki ga prikazuje njegov list, nato pa vsako tabelo, ki ji sledijo njeni stolpci. Tako kot na listu se preverjanje izvede samo, dokler slovar, ki ga bere, vsebuje vsaj eno vrstico. Dokument, katerega slovarji ne vsebujejo nobene besede, izraza ali domene, se sploh ne preveri: total je 0, kar pove tudi note.

• level: error ali warning samo za to raven; privzeto obe.
• tableIds in tableNames: samo preverjanja teh tabel in njihovih stolpcev, imena ne glede na velikost črk, kar izpusti lastne vrstice slovarjev. Identifikator ali ime, ki ne označuje nobene tabele, se zavrne s kodo notFound.
• offset in limit: privzeto stran s 100 preverjanji, ki se konča tudi tam, kjer je en odgovor poln. Dokler sledijo še druga, nextOffset in note povesta, kje se začne naslednja stran; to vrednost podajte kot offset z enakimi filtri. Ko odpravite nekaj preverjanj, jih znova navedite od odmika 0: odpravljeno preverjanje zapusti seznam, zato bi poznejši odmik preskočil preverjanja, ki še niso odpravljena.

Odgovor vsebuje total, število preverjanj, ki jih filtri ohranijo; counts, koliko od njih ima posamezna koda, brez kod, ki nimajo nobenega; ter stran kot checks. Vsako preverjanje navede svoji polji level in code ter polji kind in id svojega predmeta: table, column, word, term ali domain. Preverjanje stolpca doda še polje tableId in ime njegove tabele kot table. name je ime predmeta, pri tabeli ali stolpcu fizično ime, skupaj s poljem logicalName, kadar ima predmet logično ime. field je tisto, kar preverjanje bere: name, logicalName ali domainId. text je tisto, kar je tam našlo, suggestions, kadar slovarji kaj ponujajo, pa tisto, kar je treba uporabiti namesto tega. Tako lahko agent odpravi preverjanje brez klica 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"]}

code	level	Type na listu	Kaj najde
duplicateName	error	Duplicate name	Ime, ki si ga delita dve vrstici istega slovarja. Navede se vsaka od teh vrstic.
unknownDomain	error	Unknown domain	Stolpec ali izraz, povezan z domeno, ki je dokument ne navaja več. text je ime te domene ali njen identifikator, kadar ime ni znano.
forbiddenWord	error	Forbidden word	Beseda, ki jo neka beseda navaja kot prepovedano, v logičnem imenu tabele ali stolpca ali v imenu izraza. suggestions so standardne besede.
unregisteredWord	warning	Unregistered word	Besedilo, ki ga ne navaja nobena beseda, na istih mestih.
synonymWord	warning	Synonym	Sopomenka, uporabljena namesto standardne besede, na istih mestih. suggestions so standardne besede.
physicalNameMismatch	warning	Physical name mismatch	Fizično ime tabele ali stolpca, ki ni tisto, ki ga da izraz, ki ustreza logičnemu imenu. Predlog je fizično ime izraza ali, dokler izraz fizičnega imena nima, ime, ki ga sestavijo njegove besede.
domainTypeMismatch	warning	Domain type mismatch	Stolpec, katerega podatkovni tip ni tip domene, s katero je povezan. text je tip stolpca, predlog pa tip domene.

Kako posamezno preverjanje bere ime, je opisano v razdelku Kaj najde posamezno preverjanje.

Orodja za urejanje

Identifikatorji prihajajo iz orodij erd_list in erd_get ali iz polja createdIds klica, ki je entiteto ustvaril. Nov identifikator sestavlja 25 malih črk in števk, kot je 03h17be2plxpj5n59tqag7ogj, identifikator, ki ga dokument že vsebuje, pa ohrani svojo obliko, zato iz oblike identifikatorja ne sklepajte ničesar. x in y sta levi in zgornji rob na platnu v slikovnih pikah, barva pa je šestnajstiška barva CSS, kot je #3b82f6, ali prazen niz, ki barvo odstrani.

Tabele

Orodje	Argumenti	Kaj naredi
erd_add_table		Doda prazno tabelo na prosto mesto in vrne njen identifikator v createdIds.
erd_remove_table	tableId	Odstrani tabelo z njenimi stolpci, indeksi in vsemi relacijami, ki se je dotikajo.
erd_change_table_name	tableId, value	Preimenuje tabelo. Ime je nato vneseno ročno, zato ga poznejše logično ime pusti takšno, kot je, dokler ni prazno – glejte razdelek Slovarji.
erd_change_table_comment	tableId, value	Nastavi komentar tabele. Prazen niz ga počisti.
erd_set_table_logical_name	tableId, value	Nastavi logično ime tabele. Prazen niz ga počisti, ime pa ostane nespremenjeno. Dokler je ime tabele prazno ali je bilo izpeljano, ga slovarji izpeljejo iz logičnega imena – glejte razdelek Slovarji. Izraz tabeli ne da domene.
erd_change_table_color	tableId, color	Nastavi barvo tabele.
erd_move_table	tableId, x, y	Premakne tabelo na položaj na platnu.
erd_move_tables	positions	Premakne več tabel v eni spremembi, ki jo razveljavi en klic erd_undo. positions vsebuje { tableId, x, y } za vsako tabelo, vsako tabelo največ enkrat.
erd_sort_tables		Razporedi vse tabele v vrstice po platnu, najprej tiste z najmanj stolpci, tako kot jih razporedijo erd_import_sql, erd_import_graphql, erd_import_dbml in erd_import_aml. Tabele skupine tabel ostanejo skupaj, okvir vsake skupine pa se prilagodi okoli njih.

Stolpci

Orodje	Argumenti	Kaj naredi
erd_add_column	tableId	Doda prazen stolpec v tabelo in vrne njegov identifikator v createdIds.
erd_remove_columns	tableId, columnIds	Odstrani stolpce iz ene tabele, skupaj z relacijami in vnosi v indeksih, ki jih uporabljajo.
erd_change_column_name	tableId, columnId, value	Preimenuje stolpec. Ime je nato vneseno ročno, tako kot pri tabeli.
erd_change_column_data_type	tableId, columnId, value	Nastavi podatkovni tip, kot je INT ali VARCHAR(255). Ko je sinhronizacija tipa podatkov v relacijah vklopljena, sprememba sledi relacijam v obe smeri, tako kot v urejevalniku: tip serial pride do tujih ključev kot celoštevilski tip, ki ga hrani, tako kot ga kopira erd_add_relationship, ključ serial pa ohrani svoj tip, ko se spremeni eden od njegovih tujih ključev, kar spremembo tam ustavi. Sinhronizacijo vklopi ali izklopi uporabnik, erd_list pa jo navaja kot relationshipDataTypeSync. Stolpcu, povezanemu z domeno, se povezava z domeno prekine, ko se mu nastavi tip, ki ni tip domene, enako pa vsakemu stolpcu, do katerega seže sinhronizacija in katerega novi tip se razlikuje od tipa njegove domene – glejte razdelek Prekinitev povezave z domeno.
erd_change_column_default	tableId, columnId, value	Nastavi privzeto vrednost kot besedilo SQL. Prazen niz jo počisti.
erd_change_column_comment	tableId, columnId, value	Nastavi komentar. Prazen niz ga počisti.
erd_set_column_logical_name	tableId, columnId, value	Nastavi logično ime stolpca. Prazen niz ga počisti, ime pa ostane nespremenjeno. Dokler je ime stolpca prazno ali je bilo izpeljano, ga slovarji izpeljejo, stolpec pa se poveže z domeno izraza in dobi njen podatkovni tip – glejte razdelek Slovarji.
erd_set_column_domain	tableId, columnId, domainId?, domainName?	Poveže stolpec z domeno, ki jo podate bodisi z identifikatorjem bodisi z imenom. Stolpec prevzame podatkovni tip domene, ki sledi relacijam, dokler je vklopljena sinhronizacija tipa podatkov v relacijah, pri čemer se povezave z domeno prekinejo enako kot pri erd_change_column_data_type. domainId z vrednostjo null ali prazen niz ali prazen domainName prekine povezavo stolpca z domeno in ohrani njegov tip.
erd_set_column_primary_key	tableId, columnId, value	true stolpec vključi v primarni ključ, false ga iz njega odstrani.
erd_set_column_unique	tableId, columnId, value	Nastavi, ali je stolpec enoličen.
erd_set_column_not_null	tableId, columnId, value	Nastavi, ali je stolpec NOT NULL.
erd_set_column_auto_increment	tableId, columnId, value	Nastavi, ali se stolpec samodejno povečuje.
erd_move_column	tableId, columnId, targetColumnId	Premakne stolpec znotraj njegove tabele na položaj drugega stolpca.

Relacije

relationshipType je kardinalnost na koncu pri podrejeni tabeli: ZeroOne, ZeroN, OneOnly ali OneN. Začetna tabela je nadrejena tabela, torej ciljna stran, ki vsebuje primarni ključ, končna tabela pa je podrejena. onDelete in onUpdate sta dejanji ON DELETE in ON UPDATE tujega ključa: none, noAction, cascade, setNull, setDefault ali restrict. none ne zapiše določila, zato velja privzeto dejanje zbirke podatkov – glejte razdelek ON DELETE in ON UPDATE. Dejanje, ki je izpuščeno pri erd_add_relationship ali erd_link_columns, je none.

Orodje	Argumenti	Kaj naredi
erd_add_relationship	startTableId, endTableId, relationshipType, onDelete?, onUpdate?	Poveže dve tabeli z relacijo. Primarni ključ nadrejene tabele kopira v podrejeno kot stolpce tujega ključa, pri čemer najprej ustvari stolpec primarnega ključa, če ga nadrejena tabela nima. Vsak stolpec tujega ključa dobi ime tako, kot ga poimenuje risanje relacije v urejevalniku: ključ id tabele users da users_id, ključ, kot je member_id, pa ohrani svoje ime – glejte razdelek Imena stolpcev tujega ključa. Vsak kopira podatkovni tip svojega ključa, le da ključ serial da celoštevilski tip, ki ga hrani, npr. integer za serial4, sam serial pa zunaj PostgreSQL, MySQL in MariaDB ostane serial – glejte razdelek Identifikacijske relacije. Vsak prevzame tudi logično ime svojega ključa in se poveže z domeno, s katero je povezan njegov ključ, razen če mu ključ serial da drug tip. createdIds vsebuje novi stolpec ključa, če je bil ustvarjen, stolpce tujega ključa in na koncu identifikator relacije.
erd_link_columns	startTableId, startColumnIds, endTableId, endColumnIds, relationshipType, onDelete?, onUpdate?	Nariše relacijo med obstoječimi stolpci in začetne ter končne stolpce poveže v pare po položaju. Ne preimenuje nobenega stolpca, ne spremeni nobenega podatkovnega tipa in ne kopira nobenega logičnega imena ali domene.
erd_remove_relationship	relationshipId	Odstrani povezovalno črto relacije. Njeni stolpci tujega ključa ostanejo v tabeli.
erd_change_relationship_type	relationshipId, relationshipType	Spremeni kardinalnost relacije.
erd_change_relationship_on_delete	relationshipId, onDelete	Nastavi dejanje ON DELETE relacije: kaj brisanje nadrejene vrstice naredi z njenimi podrejenimi vrsticami.
erd_change_relationship_on_update	relationshipId, onUpdate	Nastavi dejanje ON UPDATE relacije: kaj sprememba nadrejenega ključa naredi z njegovimi podrejenimi vrsticami.

erd_add_relationship stolpce tujega ključa poimenuje in jim kopira logična imena njihovih ključev ob izvedbi. Poznejše preimenovanje ali logično ime ključa jih ne doseže, zato najprej poimenujte nadrejeno tabelo in njen primarni ključ ter ključu dajte logično ime. Imena, ki jih da, štejejo za ročno vnesena, zato jih poznejše logično ime pusti takšna, kot so, erd_derive_physical_names pa jih vrne v upravljanje slovarjem – glejte razdelek Slovarji.

Nobeno orodje ne spremeni stolpcev obstoječe relacije tako kot okno Preslikaj stolpce urejevalnika. Za preslikavo relacije na druge stolpce izvedite erd_remove_relationship, ki njene stolpce tujega ključa pusti v tabeli, in erd_link_columns z želenimi stolpci, oboje v enem klicu erd_batch, ki ga razveljavi en klic erd_undo.

Indeksi

Identifikator stolpca indeksa je vnos na seznamu stolpcev indeksa, ki ga vrne erd_get, in ne identifikator stolpca tabele.

Orodje	Argumenti	Kaj naredi
erd_add_index	tableId	Doda prazen indeks v tabelo in vrne njegov identifikator v createdIds.
erd_remove_index	indexId	Odstrani indeks.
erd_change_index_name	indexId, value	Preimenuje indeks.
erd_set_index_unique	indexId, value	Nastavi, ali je indeks enoličen.
erd_add_index_column	indexId, columnId	Doda stolpec tabele indeksa in vrne identifikator novega stolpca indeksa. Stolpec, ki je že v indeksu, ostane nespremenjen.
erd_remove_index_column	indexId, indexColumnId	Odstrani en stolpec iz indeksa.
erd_move_index_column	indexId, indexColumnId, targetIndexColumnId	Premakne stolpec znotraj indeksa na položaj drugega stolpca tega indeksa.
erd_set_index_column_order	indexId, indexColumnId, orderType	Nastavi vrstni red razvrščanja enega stolpca v indeksu, ASC ali DESC.

Beležke

Orodje	Argumenti	Kaj naredi
erd_add_memo		Doda prazno beležko na prosto mesto in vrne njen identifikator v createdIds.
erd_remove_memo	memoId	Odstrani beležko.
erd_change_memo_value	memoId, value	Zamenja besedilo beležke.
erd_change_memo_color	memoId, color	Nastavi barvo beležke.
erd_move_memo	memoId, x, y	Premakne beležko na položaj na platnu.
erd_resize_memo	memoId, width, height	Spremeni velikost beležke. Širina mora biti vsaj približno 116 slikovnih pik, višina pa vsaj 100. Ne ustvari vnosa za razveljavitev, ker urejevalnik spremembo velikosti beležke zabeleži samo pri vlečenju.

Dokler so beležke skrite z View Option → Memos, erd_add_memo beležko še vedno doda, ta pa ostane skrita, dokler se beležke znova ne prikažejo. erd_list in erd_get navajata tudi skrite beležke.

Skupine tabel

Skupina tabel je poimenovan okvir, narisan za njenimi tabelami, njena barva pa je vidna na okviru in čez glave njenih tabel – glejte stran Skupine tabel. Tabela je v največ eni skupini. erd_move_table, erd_move_tables in erd_move_table_group nikoli ne spremenijo, katere tabele vsebuje skupina, ne glede na to, kam postavijo tabelo, medtem ko se v urejevalniku tabela pridruži skupini ali jo zapusti glede na to, kam jo spustite – glejte razdelek Dodajanje in odstranjevanje tabel. erd_add_table_group in erd_set_table_group dodata tabele v skupino, erd_remove_table_group pa njene tabele pusti brez skupine. Skupina hrani pravokotnik, širok vsaj 160 slikovnih pik in visok vsaj 100, vključno z naslovno vrstico, urejevalnik pa okvir nariše povečan tako, da zajame vsako od njenih tabel.

Orodje	Argumenti	Kaj naredi
erd_add_table_group	name, color?, x?, y?, width?, height?, tableIds?	Doda skupino in vrne njen identifikator v createdIds. Podajte bodisi tableIds bodisi pravokotnik: x, y, width in height skupaj. Z argumentom tableIds vsaka tabela zapusti skupino, v kateri je bila, pravokotnik pa se prilagodi okoli tabel tako, kot ga prilagodi združevanje izbranih tabel v skupino. Pravokotnik zajame vse tabele brez skupine, katerih središče leži v njem, tako kot risanje skupine. Prazen argument name pusti skupino brez imena. En klic erd_undo odstrani skupino in vsako tabelo vrne v skupino, v kateri je bila.
erd_remove_table_group	groupId	Odstrani skupino. Njene tabele ostanejo, kjer so, brez skupine.
erd_change_table_group_name	groupId, value	Preimenuje skupino. Prazen niz jo pusti brez imena.
erd_change_table_group_color	groupId, color	Nastavi barvo skupine.
erd_move_table_group	groupId, x, y	Premakne skupino tako, da se njen pravokotnik začne v tej točki, njene tabele pa se premaknejo za enako razdaljo, tako kot pri vlečenju njene naslovne vrstice. Premik pod 20 slikovnih pik, vodoravno in navpično skupaj, ne ustvari vnosa za razveljavitev. Od strežnika različice 1.2.0 premik v urejevalnik pride kot točke, v katerih se skupina in njene tabele končajo, zato se z razširitvijo za VS Code različice 4.3.0 ali novejše ali vtičnikom za Obsidian ali JetBrains različice 1.3.0 ali novejše premik skupine ali ene od njenih tabel, narejen tam v istem trenutku, konča na enem od obeh položajev, nikoli pri njuni vsoti – glejte razdelek Spremembe, narejene v istem trenutku.
erd_resize_table_group	groupId, x?, y?, width, height	Nastavi pravokotnik skupine, njene tabele pa ostanejo, kjer so. Če sta x in y izpuščena, njen kot ostane nespremenjen. Pravokotnik, ki ne bi zajel tabel skupine z njihovim notranjim odmikom, se zavrne s sporočilom, ki navede okvir, ki ga mora zajeti.
erd_set_table_group	tableIds, groupId	Doda tabele v skupino, pri čemer vsaka zapusti skupino, v kateri je bila. groupId z vrednostjo null ali prazen niz jih odstrani iz vseh skupin.

Dokler so skupine skrite z View Option → Table Groups, ta orodja še vedno dodajajo in spreminjajo skupine, ki ostanejo skrite, dokler se skupine ne prikažejo – glejte razdelek Skrivanje skupin. erd_sort_tables ohrani tabele vsake skupine skupaj, erd_import_dbml in erd_import_json prineseta skupine – glejte razdelek Uvoz – erd_read pa z argumentom groupNames zapiše DDL izbranih skupin. Izdaja ERD Editor, ki še ne pozna skupin tabel, ob shranjevanju datoteke zavrže njene skupine, kot to storijo razširitev za VS Code pred različico 4.0.0 ter vtičnika za Obsidian in JetBrains pred različico 1.0.0 – glejte razdelek Posodabljanje.

Slovarji

Ta orodja urejajo tri slovarje na zavihku Slovar urejevalnika, iz katerih logično ime tabele ali stolpca izpelje fizično ime:

• Beseda je standardna beseda, iz kakršnih so sestavljena logična imena, skupaj z okrajšavo, ki jo zapiše v fizično ime, na primer Member in MBR.
• Izraz je celotno logično ime s fizičnim imenom, ki ga da, in pri stolpcu z domeno, s katero poveže stolpec, na primer Member Number z MBR_NO in Identifier.
• Domena je podatkovni tip z imenom, s katerim so povezani stolpci, na primer Identifier za INT.

Orodje	Argumenti	Kaj naredi
erd_add_word	name, abbreviation, englishName?, description?, synonyms?, forbiddenWords?	Doda besedo na konec slovarja besed in vrne njen identifikator v createdIds. synonyms in forbiddenWords sta ločena z vejicami: drugi zapisi besede in besede, ki se ne smejo uporabiti namesto nje.
erd_update_word	wordId, name?, abbreviation?, englishName?, description?, synonyms?, forbiddenWords?	Spremeni podana polja, preostala pa pusti.
erd_remove_word	wordId	Odstrani besedo.
erd_add_term	name, physicalName?, domainId?, domainName?, description?, synonyms?	Doda izraz na konec slovarja izrazov in vrne njegov identifikator v createdIds. Brez argumenta physicalName fizično ime sestavijo besede, če ga lahko, na primer MBR_NO za Member Number.
erd_update_term	termId, name?, physicalName?, domainId?, domainName?, description?, synonyms?	Spremeni podana polja, preostala pa pusti. Argument name, podan, ko izraz nima fizičnega imena, ali s praznim argumentom physicalName, zapiše tudi fizično ime, ki ga sestavijo njegove besede, če ga sestavijo.
erd_remove_term	termId	Odstrani izraz.
erd_add_domain	name, category?, dataType, description?	Doda domeno na konec slovarja domen in vrne njen identifikator v createdIds. category združuje domene v skupine, na primer Number ali Text.
erd_update_domain	domainId, name?, category?, dataType?, description?	Spremeni podana polja, preostala pa pusti. Nov dataType doseže vsak stolpec, povezan z domeno, in sledi relacijam, dokler je vklopljena sinhronizacija tipa podatkov v relacijah, pri čemer se povezave z domeno prekinejo enako kot pri erd_change_column_data_type.
erd_remove_domain	domainId	Odstrani domeno. Stolpci, povezani z njo, ohranijo svoj podatkovni tip, oni in izrazi, povezani z njo, pa ne prikazujejo nobene domene: njihov domainId se prebere kot prazen niz. erd_undo povezave z domeno vrne, shranjevanje pa jih v datoteko ne zapiše.
erd_derive_physical_names	scope, tableId?, columnId?	Znova izpelje fizična imena iz logičnih imen, tako kot ukaz Znova izpelji fizična imena urejevalnika, za en stolpec, eno tabelo ali celoten dokument.

• Slovar vsebuje vsako ime enkrat, zato se ime, ki ga vsebuje druga vrstica istega slovarja, zavrne s kodo invalidArgs. Imena se primerjajo brez presledkov na začetku in koncu, velikost črk pa se upošteva, zato sta Member in member dve imeni.
• Posodobitev vrstico navede z identifikatorjem in poda vsaj eno polje. Vrednosti, ki jih vrstica že vsebuje, ne spremenijo ničesar in ne ustvarijo vnosa za razveljavitev; dodajanje ali odstranitev ga ustvari vedno.
• Domena izraza se poda bodisi z argumentom domainId, pri čemer null ali prazen niz pomeni brez domene, bodisi z argumentom domainName, pri čemer prazen niz pomeni brez domene. domainName izbere prvo domeno s tem imenom v vrstnem redu slovarja, pri čemer se primerja tako kot imena. Podajanje obeh ali argumenta domainName, ki ga nima nobena domena, se zavrne. erd_set_column_domain sprejme domeno na enak način.
• Sprememba ali odstranitev besede ali izraza ničesar ne preimenuje in ne prekine nobene povezave z domeno: imena in domene, ki izhajajo iz njih, ostanejo nespremenjeni. erd_derive_physical_names imena znova izpelje in stolpec poveže z domeno, ki jo izraz daje zdaj, stolpec, ki se zdaj ne ujema z nobenim izrazom ali katerega izraz ne daje domene, pa ohrani domeno, s katero je povezan. erd_set_column_domain s praznim argumentom domainId prekine njegovo povezavo z domeno.
• Nobeno orodje ne uvozi ali izvozi slovarja v obliki CSV, ne razvrsti slovarja in ne vstavi vrstic na določen položaj, kot to počne zavihek Slovar.

erd_list navede vrstice, erd_get da vsa polja, format snapshot orodja erd_read vsebuje vse, erd_list_checks pa navede težave, ki jih najdejo slovarji – glejte razdelek Branje dokumenta.

erd_set_table_logical_name in erd_set_column_logical_name izpeljeta fizično ime tako kot urejevalnik, ko se vnese logično ime – glejte razdelek Izpeljava fizičnih imen:

• Ime se izpelje samo, dokler je prazno ali je bilo že izpeljano, kar branja prikažejo kot nameDerived: true. Ime, ki ni prazno in je bilo vneseno ročno, ostane, zapiše se samo logično ime. Imena kot ročno vnesena zapišejo erd_change_table_name, erd_change_column_name, uvozi SQL, GraphQL, DBML in AML ter orodje erd_add_relationship pri stolpcih tujega ključa, ki jih poimenuje. Ime, preimenovano v prazen niz, naslednje logično ime znova izpelje.
• Prednost ima izraz, katerega ime je enako logičnemu imenu, pri čemer se primerja tako kot imena v slovarjih. Da svoje fizično ime ali, dokler tega nima, ime, ki ga sestavijo njegove besede. Stolpec poveže tudi z domeno izraza, celo kadar se ne izpelje nobeno ime, stolpec pa prevzame podatkovni tip domene, ki sledi relacijam, dokler je vklopljena sinhronizacija tipa podatkov v relacijah.
• Brez takšnega izraza ime sestavijo besede, pri čemer se njihove okrajšave združijo s podčrtaji: Member Number da MBR_NO. Velja vse ali nič: sopomenka, prepovedana beseda, besedilo, ki ga ne navaja nobena beseda, ali beseda brez okrajšave ne sestavi ničesar in ime ostane takšno, kot je bilo. Besede stolpca ne povežejo z nobeno domeno, prav tako ne izraz brez domene, zato stolpec ohrani domeno, s katero je povezan.
• Stolpec, katerega izpeljano ime že ima drug stolpec iste tabele, ne glede na velikost črk, ohrani svoje ime, polje nameDerived in domeno.
• Brisanje logičnega imena pusti fizično ime takšno, kot je. Klic, katerega logično ime in tisto, kar iz njega izpelje, sta že na mestu, ne spremeni ničesar in ne ustvari vnosa za razveljavitev.

erd_derive_physical_names sprejme argument scope: column z argumentoma tableId in columnId za ta stolpec; table z argumentom tableId za ime tabele in vse njene stolpce; ali document brez identifikatorja za vse tabele in njihove stolpce. Obseg, ki mu manjka potreben identifikator ali je dobil takšnega, ki ga ne sprejme, se zavrne. Vsako zajeto ime tabele ali stolpca z logičnim imenom se vrne v upravljanje slovarjem, vključno z ročno vnesenim imenom, in prevzame, kar slovarji dajo zdaj: fizično ime izraza in pri stolpcu še njegovo domeno in tip ali sicer ime, ki ga sestavijo besede, kar domeno stolpca pusti nespremenjeno. Logično ime, ki ne izpelje ničesar, pusti ime takšno, kot je, pri čemer je nameDerived zdaj true. Ime brez logičnega imena ostane takšno, kot je, prav tako stolpec, katerega novo ime ima drug stolpec iste tabele, na primer drugi tuji ključ do iste tabele, ki ohrani tudi polje nameDerived. En klic erd_undo razveljavi celoten klic. Imena uvožene sheme so vnesena ročno, zato jo poimenujte iz slovarjev tako, da nastavite logična imena in nato pokličete erd_derive_physical_names. Ta klic da lastno fizično ime izraza, ki ga sprememba besed izraza ne sestavi znova. Ko torej spremenite besede izraza, najprej posodobite izraz: podajte njegovo ime v argumentu name s praznim argumentom physicalName, da ga besede sestavijo na novo, ali podajte novo vrednost physicalName.

Izdaja ERD Editor, ki še nima zavihka Slovar, ob shranjevanju datoteke zavrže njena logična imena, povezave z domenami in vrstice slovarjev, kot to storijo razširitev za VS Code pred različico 4.2.0 ter vtičnika za Obsidian in JetBrains pred različico 1.2.0. Med njimi razširitev različice 4.0.0 ali 4.1.0 ter vtičnika različice 1.0.0 ali 1.1.0 s strežnikom še vedno urejajo v živo, vendar logičnih imen, povezav z domenami in vrstic slovarjev, ki jih zapiše agent, ne prikazujejo in ne ohranijo – glejte razdelek Posodabljanje.

Nastavitve

Agent nastavlja nastavitve same sheme: zbirko podatkov, njeno ime in skripte Sheme SQL. Vse druge nastavitve, ki jih hrani dokument, nastavlja uporabnik v urejevalniku: prikaz imen, stikala možnosti pogleda, možnosti zavihka Nastavitve, jezik in zapis imen generatorja kode, vrsto narekovajev in zaklepe. Nobeno orodje jih ne spremeni, razen uvozov v načinu replace: erd_import_json prinese nastavitve in zaklepe dokumenta, ki ga naloži, preostali štirje pa pogled vrnejo na začetek platna – glejte razdelek Uvoz. Strežnik različice 1.0.0 je odstranil orodja, ki so jih nastavljala: 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 in erd_set_show.

erd_list in format snapshot orodja erd_read navajata nastavitve tako, kot jih shrani datoteka, pri čemer lockSettings vsebuje eno zastavico za vsak zaklep: viewport, canvasType, language, tableNameCase, columnNameCase, bracketType in unlockNameViewMode. Zadnja se bere obratno: je false, dokler je zaklep Name View vklopljen, kot je v novem dokumentu in v datoteki, shranjeni, preden je ta zaklep obstajal, in true, ko uporabnik zaklep izklopi. Zaklenjen jezik, zapis imen ali vrsta narekovajev se navede z zaklenjeno vrednostjo, tisto, ki jo hrani datoteka in s katero se odpre vsak urejevalnik, ne glede na to, kaj kaže zaslon urejevalnika. Pogled, zavihek in prikaz imen se ne navajajo. Agent bere in zapisuje logična imena ne glede na to, kaj prikazuje prikaz imen.

erd_set_ddl_script ustvari vnos za razveljavitev. erd_set_database in erd_set_database_name ga ne ustvarita, zato ju erd_undo ne more razveljaviti.

Orodje	Argumenti	Kaj naredi
erd_set_database	value	Nastavi zbirko podatkov: MariaDB, MSSQL, MySQL, Oracle, PostgreSQL, SQLite, Databricks ali Snowflake. Določi podatkovne tipe zbirke podatkov in DDL, ki jo erd_read zapiše, ko argument vendor ni podan.
erd_set_database_name	value	Nastavi ime zbirke podatkov, ki ga navajata glavi use in createAndUse orodja erd_read.
erd_set_ddl_script	position, sql	Nastavi enega od dveh skriptov, zapisanih okoli tabel – glejte razdelek Skripti pred tabelami in za njimi. position je before, zapisan pred tabelami, npr. CREATE EXTENSION ali CREATE SCHEMA, ali after, zapisan za njimi, npr. GRANT ali CREATE VIEW. sql zamenja celoten skript, največ 10.000 znakov, prazen niz pa ga odstrani. Trenutnega najprej preberite s formatom scripts orodja erd_read.

Skript gre v DDL vsake zbirke podatkov nespremenjen, zato ga napišite za zbirko podatkov dokumenta. Pri MSSQL se za skript, katerega zadnja vrstica ni GO, doda vrstica GO. Izdaja ERD Editor, ki še ne pozna teh skriptov, ob shranjevanju datoteke zavrže njene skripte, kot to storijo razširitev za VS Code pred različico 4.0.0 ter vtičnika za Obsidian in JetBrains pred različico 1.0.0 – glejte razdelek Posodabljanje.

Uvoz

Ta orodja preberejo shemo tako kot meni Uvozi v urejevalniku – glejte stran Uvoz in izvoz datotek. Vsako sprejme besedilo kot value in mode: replace, privzeto vrednost, ali append.

Orodje	Argumenti	Kaj naredi
erd_import_sql	value, mode?	Naloži SQL DDL, stavke CREATE TABLE in podobno.
erd_import_graphql	value, mode?	Naloži GraphQL SDL.
erd_import_dbml	value, mode?	Naloži DBML. Vsak TableGroup postane skupina tabel s tabelami, ki jih navaja – glejte razdelek DBML.
erd_import_aml	value, mode?	Naloži AML.
erd_import_json	value, mode?	Naloži dokument JSON erd-editor, npr. drugo datoteko .erd.json.

replace nadomesti dokument, erd_undo pa obnovi prejšnjega:

• erd_import_sql, erd_import_graphql, erd_import_dbml in erd_import_aml zamenjajo vse tabele, relacije, indekse, beležke in skupine tabel. Ohranijo nastavitve dokumenta, vključno z zaklepi, razen pogleda, ki se vrne na začetek platna pri 100 %, ohranijo pa tudi njegove slovarje besed, izrazov in domen. Tabele, ki jih prinesejo, nimajo logičnih imen in niso povezane z nobeno domeno.
• erd_import_json zamenja celoten dokument, vključno z nastavitvami in slovarji: nastavitve, zaklepi, besede, izrazi in domene iz besedila JSON nadomestijo tiste v tem dokumentu, besedilo JSON, ki ne beleži zaklepov, pa vklopi vse zaklepe in postavi pogled na začetek platna. Vsak gledalec ohrani svoj prikaz imen, razen če ima besedilo JSON izklopljen zaklep Name View in tako prinese svoj prikaz imen. Če želite ohraniti nastavitve tega dokumenta, začnite z besedilom, ki ga vrne format json orodja erd_read. Prazno besedilo da nov dokument, kakršnega ustvari erd_open_document z argumentom create.

V urejevalniku z razširitvijo za VS Code različice 4.3.0 ali novejše ali vtičnikom za Obsidian ali JetBrains različice 1.3.0 ali novejše uvoz v načinu replace ter njegov erd_undo ali erd_redo končajo tudi risanje relacije, ki jo rišete – glejte razdelek V živo.

append uvoz doda v dokument, tako kot ukaz Uvozi in dodaj urejevalnika, en klic erd_undo pa odstrani celoten dodatek:

• Vsebina besedila pride v dokument kot nove entitete z novimi identifikatorji, v blok pod vsem, kar dokument vsebuje, vključno s skritimi beležkami in skupinami tabel, blok pa je poravnan z levim robom dokumenta. Vse obstoječe tabele in nastavitve ostanejo, vključno s tabelo z enakim imenom: nič se ne združi po imenu.
• Relacije in indeksi se ustvarijo samo med tabelami, ki jih prinese uvoz, zato se tuji ključ do tabele, ki je besedilo ne deklarira, zavrže.
• erd_import_sql, erd_import_graphql in erd_import_aml dodajo tabele z njihovimi relacijami in indeksi, erd_import_dbml pa tudi skupine tabel. erd_import_json doda tabele, relacije, indekse, beležke in skupine tabel, nikoli pa njegovih nastavitev, in zavrne prazno besedilo. Njegove tabele in stolpci prinesejo svoja logična imena, vendar noben stolpec ni povezan z domeno in nobena od besed, izrazov ali domen iz besedila JSON ne pride v dokument.

Dokument JSON ohrani svojo razporeditev, vključno s skupinami tabel: z replace tam, kamor postavi svoje tabele, z append pa znotraj dodanega bloka. Tabele iz SQL, GraphQL, DBML in AML se razporedijo v vrstice, najprej tiste z najmanj stolpci in s tabelami vsake skupine skupaj, tako kot jih razporedi erd_sort_tables, nikoli s postavitvijo Flow, kot jih razporedi ukaz Uvozi v urejevalniku, kadar je to mogoče. Ta štiri orodja v obeh načinih zavrnejo prazno besedilo.

erd_batch

erd_batch izvede več orodij za urejanje po vrsti kot eno spremembo, vse ali nič.

• operations vsebuje do 100 vnosov, vsak v obliki { tool, as?, args? }, pri čemer je tool orodje za urejanje, args pa argumenti orodja brez path. Orodje za branje, kot je erd_list_checks, se zavrne.
• Operacije se najprej preizkusijo na kopiji dokumenta. Zavrnjena operacija se navede, na primer operations[1] erd_remove_table: …, in nobena operacija se ne izvede.
• En klic erd_undo razveljavi celoten paket, razen operacij, ki jih ne more razveljaviti in jih navede undoNote v rezultatu: operacij orodja, ki ne ustvari vnosa za razveljavitev, kot je erd_set_database, in operacij, ki so spremenile dokument, ne da bi ustvarile tak vnos, kot je kratek klic erd_move_table_group. Paket, ki ni ustvaril nobenega vnosa za razveljavitev, erd_undo preskoči. historyEntries v rezultatu šteje vnose v zgodovini urejevalnika znotraj paketa, ne klicev erd_undo.
• V seji v živo urejevalnik sprejme ves paket ali nič od njega.

Agent pred klicem ne more poznati identifikatorjev, ki jih bo paket ustvaril, zato operacija, poimenovana z as, omogoči poznejši operaciji, da se sklicuje nanje: $name ali $name.0 za njen prvi ustvarjeni identifikator, $name.1 za drugega in $name.last za zadnjega. Ime vsebuje črke ASCII, števke in podčrtaje, se ne začne s števko in poimenuje samo eno operacijo. Sklic se razreši samo tam, kjer argument sprejme identifikator entitete, vključno z argumenti wordId, termId in domainId, zato ime ali komentar z besedilom $x ostane besedilo. Tudi argument domainName je besedilo, vendar se prebere ob izvedbi svoje operacije, zato lahko poimenuje domeno, ki jo je dodala prejšnja operacija paketa.

Tabela s stolpci in relacijo v enem klicu:

{
  "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" } }
  ]
}

Tabela users in njen ključ id dobita imeni pred relacijo, zato je stolpec tujega ključa, ki ga relacija doda v tabelo orders, users_id.

Besede, domena in izraz, nato tabela, poimenovana iz njih po svojih logičnih imenih:

{
  "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" } }
  ]
}

Izraz iz svojih besed sestavi MBR_NO, tabela pa dobi ime MBR. Stolpec Member Number prevzame ime MBR_NO iz izraza in njegovo domeno, zato je povezan z domeno Identifier in ima tip INT, stolpec Member Name, ki ga ne vsebuje noben izraz, pa dobi sestavljeno ime MBR_NM.

Rezultati

Urejanje vrne eno vrstico JSON:

{"tool":"erd_add_table","mode":"live","createdIds":["03h17be2plxpj5n59tqag7ogj"],"batches":1,"historyEntries":1}

Polje	Pomen
mode	live ali headless – glejte stran V živo in brez vmesnika.
saved	true v rezultatu vsake spremembe ter vsakega klica erd_batch, erd_undo in erd_redo v načinu brez vmesnika: datoteka vsebuje spremembo, ko klic odgovori, zato ni ničesar več za shranjevanje. Rezultat v živo nima polja saved, ker spremembo hrani urejevalnik – glejte razdelek Shranjevanje.
createdIds	Identifikatorji tega, kar je klic ustvaril, po vrsti.
batches, historyEntries	Koliko paketov sprememb je klic poslal in koliko vnosov v zgodovini urejevalnika je ustvaril.
undoable, undoNote	undoable je false, ko bo erd_undo klic preskočil, undoNote pa pove, zakaj: orodje ne ustvari vnosa za razveljavitev, klic je spremenil dokument, ne da bi ustvaril tak vnos, kot to stori erd_move_table_group za manj kot 20 slikovnih pik, ali pa je dokument vrednost že vseboval. Rezultat erd_batch vedno vsebuje undoNote. Če je paket ustvaril vnos za razveljavitev, opomba pove, da en klic erd_undo razveljavi paket, in navede vsako operacijo, ki jo pusti nerazveljavljeno; če ga ni ustvaril, rezultat vsebuje undoable: false, opomba pa pove, da ga erd_undo preskoči.
mismatch	Prisotno, ko je klic ustvaril drugačno število paketov ali vnosov v zgodovini, kot ga orodje deklarira.
notes	Prisotno, ko se je pri seji kaj spremenilo, npr. urejevalnik, ki se je zaprl ali prenehal streči dokument, ali datoteka, ki se je spremenila na disku.

Zavrnitev je rezultat napake s kodo in sporočilom, ki pove, kaj storiti:

{"error":{"code":"notFound","message":"tableId nope names no live table; read the document for current ids"}}

code	Zakaj
notFound	Identifikator ne označuje ničesar, kar trenutno obstaja, ali pa datoteka ne obstaja.
invalidArgs	Argument manjka ali ima napačno vrednost.
invalidPath	Pot ni dokument ERD. V sistemu Windows tudi pot z imenom, ki ga Windows ne shrani tako, kot je zapisano, ali pot, ki pripelje do dokumenta, ki ga ima urejevalnik pod drugo potjo, sporočilo pa jo navede.
invalidDocument	Datoteka ni dokument, ki ga urejevalnik lahko prebere.
tooLarge	Branje ne gre v en odgovor.
blocked	Urejevalnik z izklopljenim središčem ima dokument. Sporočilo pove, kako ga vklopiti: v VS Code zaupajte delovnemu prostoru in vklopite dineug.erd-editor.agentHub.enabled ali znova naložite okno; v aplikaciji Obsidian vklopite Coding agents ali znova naložite aplikacijo Obsidian; v razvojnem okolju JetBrains vklopite Coding agents ali, če je ta nastavitev že vklopljena, znova zaženite razvojno okolje.
hubDisabled	Razvojno okolje JetBrains ima dokument samo v projektu, ki mu ne zaupa. Branje še vedno deluje; zaupajte projektu, da bo agent lahko urejal.
conflict	Datoteka se je med klicem spremenila na disku. Nič ni bilo zapisano.
hubAppeared, hubGone	Urejevalnik je začel streči dokument, ki ga je agent urejal na disku, ali pa urejevalnik, ki ga je stregel, še vedno teče, vendar njegove zaklepne datoteke in povezave ni več. Nič ni bilo zapisano.
notSaved	Orodje erd_save ni moglo shraniti dokumenta urejevalnika.
readonly	Urejevalnik ima dokument samo za branje, npr. datoteko, v katero ne more pisati ali je ne more prebrati kot diagram. Brez urejevalnika je samo za branje datoteka sama, npr. datoteka v sistemu Perforce ali TFVC, ki ni izvlečena za urejanje. Nič ni bilo zapisano.
protocolMismatch	Razširitev ali vtičnik ERD Editor v urejevalniku in strežnik uporabljata vsak svojo različico protokola, npr. strežnik različice 1.0.0 ali novejše z razširitvijo za VS Code različice 3.x. Zavrne se tudi branje, sporočilo pa navede stran, ki jo je treba posodobiti – glejte razdelek Posodabljanje.
hubUnreachable, timeout, disconnected	Središče urejevalnika ni sprejelo povezave, ni odgovorilo v 30 sekundah ali je med klicem prekinilo povezavo. V sistemu Windows hubUnreachable pomeni tudi, da je Windows agentu preprečil dostop do središča: urejevalnik teče z več pravicami kot agent, na primer ko je bil zagnan kot skrbnik, agent pa ne, ali pa agent teče v peskovniku.

Druge kode so redkejše, vsaka zavrnitev pa vsebuje sporočilo, ki pove, kaj se je zgodilo.

Orodja za urejanje, erd_batch in štiri orodja za branje zavrnejo argument, ki ga ne deklarirajo, ali argument napačnega tipa, z napako JSON-RPC zaradi neveljavnih parametrov (-32602), še preden se dotaknejo dokumenta, zato se napačno zapisan argument nikoli tiho ne izpusti. Pet orodij seje prezre argumente, ki jih ne poznajo.