SQLite Data Studio: recepti

Nazaj: SQLite Data Studio

Kratki recepti za opravila, ki se vedno znova ponavljajo: ustvarjanje rutine, prijava nabora rutin iz drugega paketa, uporaba zgodovine poizvedb in ustvarjanje skripta za objekt.

[Live] Celotni pogodbi sta opisani na straneh Rutine (API za rutine) in Skrbniški vmesnik.

Pogoj: vsaj ena nastavljena povezava (Povezave); v studiu zmožnost design ali neposreden dostop do mape nabora v datotečnem sistemu.

1. V studiu: območje Rutine → Nova rutina → vnesite ime ([A-Za-z0-9_-]+).
2. V odprtem urejevalniku rutine, zavihek Lastnosti: izberite vrsto rezultata, dodajte parametre (ime, vrsta, potrditveno polje Obvezno) in v spodnje polje vpišite datoteko SQL.
3. Shranite. Urejevalnik manifest in datoteke SQL preveri z istim preverjevalnikom kot zavihek JSON – zavrnjen vnos se znova prikaže s sporočilom o napaki in natanko z vnesenim besedilom (tipkarska napaka ne pomeni izgube podatkov).
4. Preizkus: razdelek Zaženi preizkus pod urejevalnikom – izberite povezavo, izpolnite parametre in kliknite Zaženi preizkus.

Druga pot (datotečni sistem): manifest <ime>.json in datoteko SQL ustvarite neposredno v mapi nabora (shema: Rutine → Manifest) – za rutine, ki se dobavijo kot del namestitve paketa, namesto da bi nastale interaktivno v studiu.

Pogosta napaka: »unknown returns« ob shranjevanju – returns mora biti ena od šestih dovoljenih vrednosti (rows_affected/insert_id/rows/row/scalar/none); tipkarske napake, kot je row_affected, se zavrnejo, ne pa tiho popravijo.

Pogoj: lasten paket z mapo SQL za svoje rutine.

1. V action.php lastnega paketa prijavite kljuko za dogodek (podrobnosti in primer kode: Referenca API → dogodek).
2. Izberite ime nabora, ki ne trči z že prijavljenim (default je rezerviran za lastni nabor studia).
3. Rutine v lastni mapi naslavljajte kot <nabor>:<ime>.

Pogosta napaka: nabora ni v setRegistry()→names() – dogodek se sproži šele ob prvem dostopu do infrastrukture rutin v tej zahtevi (lena inicializacija); koda za dostop, ki se izvede prezgodaj (pred prijavo kljuke), nabora še ne vidi.

Pogoj: zmožnost query v studiu, aktivna povezava.

1. V pomočniku za poizvedbe izvedite poljubno poizvedbo – vsak zagon se samodejno zapiše v krožni medpomnilnik aktivne povezave (samo besedilo SQL, čas, trajanje in število vrstic – nikoli vezane vrednosti).
2. Odprite zgodovino: v raziskovalcu objektov meni Dejanja pri povezavi → Zgodovina poizvedb (ali neposredno s parametrom URL historyopen=1). Zgodovina se odpre v predalu nad pomočnikom za poizvedbe.
3. Pri želenem vnosu izberite Uporabi v urejevalniku – besedilo SQL se prenese v polje konzole in nadomesti trenutni osnutek.
4. Počisti zgodovino v celoti izprazni krožni medpomnilnik aktivne povezave (posameznih vnosov ni mogoče brisati).

Pogoj: zmožnost query ali design; tabela ali pogled je viden v raziskovalcu objektov.

1. V raziskovalcu objektov odprite meni Dejanja vozlišča tabele ali pogleda.
2. Stavek CREATE (tabele in pogledi) da celoten stavek CREATE, rekonstruiran iz kataloga povezane zbirke podatkov; Ustvari skript DROP (samo tabele) da ustrezen stavek DROP. Indeksi teh dejanj nimajo.
3. Stavek se odpre v urejevalniku pomočnika za poizvedbe (v novem zavihku poizvedbe). Nič se ne izvede samodejno – skript je zgolj besedilo za nadaljnjo uporabo (npr. kot predloga za selitev).

Opomba: pri SQLite Stavek CREATE dobesedno ustreza izvirnemu stavku, shranjenemu v sqlite_master (vključno z izvirnim oblikovanjem); pri drugih zaledjih se stavek na novo sestavi iz metapodatkov introspekcije in se lahko v podrobnostih (presledki, vrstni red stavčnih delov) razlikuje od zgodovinskega izvirnika.

• Rutine – shema manifesta v podrobnostih
• Skrbniški vmesnik – celoten pregled vmesnika
• Pravice – katero zmožnost zahteva kateri recept