Hitri začetek: prva povezava, prva poizvedba

Najkrajša pot od »vtičnik je nameščen« do »poimenovana povezava obstaja in poizvedba nad njo vrne vrstice«. Štirje koraki, približno deset minut.

• wksqliteds in wkcore sta nameščena in vklopljena.
• Prijavljeni ste kot skrbnik (superuser).
• Gonilnik PDO za želeno podatkovno zbirko je v PHP na voljo. Za SQLite zadošča pdo_sqlite.
• Podatkovna zbirka. Za SQLite zadošča pot do datoteke; datoteka še ne rabi obstajati.

Skrbništvo → Splošne nastavitve, razdelek wksqliteds:

enable_dbadmin = 1

Od 2026-08-25 je privzeto 1 – področje je običajno že tam, zato je ta korak preverjanje in ne nastavljanje. Če kljub temu manjka, ga je izklopila instanca: poglejte v conf/local.protected.php, ki se naloži za conf/local.php in zato zmaga. Sama 1 v local.php ne pove ničesar.

Ko ste že tam, razmislite o nastavitvi dbadmin_readonly. Vklopljen pomočnik brska in sprašuje, a ne piše – razumno trajno stanje za namestitev, v kateri studio služi gledanju in ne spreminjanju.

Skrbništvo → SQLite Data Studio, neposredno /doku.php?do=admin&page=wksqliteds. Območje Povezave.

Dodajte povezavo z ukazom Nova povezava. Povezava dobi ime – od zdaj se vse sklicuje nanj; po tem koraku nič več ne naslavlja zbirke podatkov po poti ali gostitelju.

• SQLite: zadošča pot do datoteke.
• Strežniške podatkovne zbirke (MSSQL, MySQL, PostgreSQL, ODBC): gostitelj, zbirka, uporabnik in geslo.

Ime nato vpišite v default_connection, da imajo klici brez lastne navedbe povezave privzeti cilj.

Izberite Preizkusi povezavo.

Preizkus loči tri vzroke, ki sicer pozneje pridejo kot eno samo neuporabno sporočilo: manjkajoč gonilnik, zavrnjeni dostopni podatki, nedosegljiva zbirka.

Nadaljujte šele, ko preizkus uspe.

Preidite v območje Pomočnik za poizvedbe, zgoraj pod Povezava izberite svojo povezavo in vpišite poizvedbo – za novo datoteko SQLite denimo:

SELECT name, TYPE FROM sqlite_master ORDER BY name

Izberite Zaženi.

• Mreža rezultatov prikaže vrstice – za prazno novo datoteko torej nobene, a glavi stolpcev name in type sta tam. Prav to dokazuje, da je poizvedba stekla in da povezava drži.
• Raziskovalec objektov na levi našteje objekte povezave.
• Zgodovina poizvedb (meni Dejanja pri povezavi v raziskovalcu objektov) ima izvedbo zapisano s časom in trajanjem.
• Kontrolni preizkus zgornje meje: izvedite SELECT brez WHERE nad veliko razpredelnico. Dobite prvih dbadmin_max_result_rows vrstic in opozorilo, da je bil rezultat skrajšan. Za resnično delo z velikimi rezultati listajte, namesto da mejo dvigujete.

• Rutine – poizvedbo shranite kot poimenovan par datotek (.sql in manifest), s poimenovanimi parametri namesto vstavljenih vrednosti. Pomočnik za to ponudi Shrani kot rutino.
• Povezave – vsi gonilniki in njihova polja.
• Pravice – kdo sme poizvedovati, pisati, oblikovati strukturo in izvažati.
• wksqliteds – pregled paketa.