[Pamoka]MySQL pagrindai

[bebras]

Sena pamokos versija: 

Kadangi pastebėjau jog vis daugiau žmonių nori naudoti MySQL, bet ne visi žino nuo ko pradėti, todėl trumpai parodysiu.

Pavyzdžiuose bus naudojamas BlueG R7 pluginas.

Šiek tiek teorijos, tikriausiai ne karta girdėjote (bent iš manęs) kad R7 yra daug greitesnis, tai žinoma yra tiesa. Greičio palyginimu su kitomis versijomis galite rasti čia.
Kodėl jis toks greitas? O todėl kad dabar kol pluginas ką nors daro su duomenų baze, serveri tuo metu gali užsimti kitais dalykais. Gal to ir nepastebėjote, bet su senesnėmis versijomis jis to negalėjo.

Jeigu iš mano kalbų niekas nepaiškėjo, nesirūpinkite, viskas tuoj paaiškės ,nes keliaujame prie praktikos.

Prieš pradėdami, prisijunkime į duomenų bazę:

new DB;

public OnGameModeInit()
{
    mysql_log(); // Arba mysql_debug(1); senesnėse versijoje. Tai nebūtina bet tai padeda rasti klaidas, tai sukuria mysql_log.txt (arba debug.txt)
    DB=mysql_connect("Duombazės adresas","Vartotojas","Duombaze","slaptazodis");
    return 1;
}

Įsivaizduokime kad duomenų bazėje turime tokia lentele:



Pradžiai išmokime įrašyti į duomenų bazę. Dalykas kurį siunčiame į duomenų bazę vadinamas "Query", todėl įprasta šį pavadinimą ir naudoti.

new query[128],Name[MAX_PLAYER_NAME],Float:X,Float:Y,Float:Z;
GetPlayerName(playerid,Name,sizeof(Name));
GetPlayerPos(playerid,X,Y,Z);


format(query,sizeof(query),"INSERT INTO `lentelesPavadinimas` (Username,Password,PosX,PosY,PosZ) VALUES ('%s',%s','%f','%f','%f')",Name,slaptazodis,X,Y,Z);

Ši query viršuje įrašys naują eilutę(tačiau ji dar neišsiusta,apie tai žemiau). Jeigu eilutė jau egzistuoja, reikės siųsti kitokia query.

Jeigu norime atnaujinti informaciją reikėtu kurti tokį query:

new query[128],name[MAX_PLAYER_NAME];

format(query,sizeof(query),"UPDATE `lenteles_pavadinimas` SET Pinigai ='%d' WHERE Username='%s'",GetPlayerMoney(playerid),name);

Ši query viršuje atnaujins lentelę(bet ji neišsiųsta todėl nieko nepadarys,apie tai žemiau), ir nustatys pinigus į tiek kiek žaidėjas jų turi, TEN kur Username yra lygus žaidėjo vardui.


Kaip minėjau nei viena iš tu query(užklausų) neišsiųsta,kaip tą padaryti?

mysql_function_query(DB,query,false,"SendQuery","");

Dabar, query jau išsiųsta.
"DB", kas tai? Prisiminkime prisijungima prie duomenų bazės, tai reiškia kad query bus nusiųsta į tą duomenų bazę. (galima dirbti su keliomis duombazėmis)
"False", kodėl? Šis parametras rodo ar naudojame "caching" funckcija. Siųsdami duomenis į bazę, jos niekada nenaudojame.
"SendQuery", tai tėra funkcija kuri siunčiant ką nors į duomenų bazę visada bus vienoda ir atrodys taip:

forward SendQuery();
public SendQuery()
{
return 1;
}

Jeigu viska perskaitet dabar jau turetumet moket irasinet duomenis...


Ką gi, nemalonioji dalis, parsisiuntimas iš duomenų bazės...Čia viskas kiek pasunkėja, bet reikia tik suprasti ir tai jums atrodys lengva.

Prisiminę lentelės struktūra iš viršaus pradėkime. Dėl aiškumo aš naudosiu playerDB kad turėčiau kur visa gautą informacija sudėt.

Pradėkime nuo query.

new query[128],name[MAX_PLAYER_NAME];
GetPlayerName(playerid,name,sizeof(name));


format(query,sizeof(query),"SELECT * FROM `lenteles_pavadinimas` WHERE Useraname='%s'",name);

SELECT *,reiškia kad renkamės VISKĄ. Galima rinktis ir neviską: pvz ("SELECT `Pinigai` FROM...");

Query turime, siųskime ją.

mysql_function_query(DB,query,true,"OnInfoLoad","d",playerid);

DB - mūsų duomenų bazė.
"True", gaunant informaciją mes norime naudoti "caching" funkcija (ji ir suteikia greitį)
"OnInfoLoad", tai nurodo kur vyks visas "veiksmas", tai yra funkcija kurioje mes gautą informaciją panaudosime. Pavadinti galit kaip tik norit. Kad ir "nuciatipogaunukazka".
"d", tai reiskia kad pridėsime papildomą integer tipo parametrą.
"playerid", tai yra tas parametras kuri pridedame.
 

forward OnInfoLoad(playerid);
public OnInfoLoad(playerid)
{
new rows,fields;
cache_get_data(rows,fields);
if(rows>0)
{
new tmp[16];
cache_get_row(0,0,tmp,DB); playerDB[playerid][id]=strval(tmp);
cache_get_row(0,1,tmp,DB); format(playerDB[playerid][Username],sizeof(tmp),tmp);
cache_get_row(0,2,tmp,DB); format(playerDB[playerid][Password],sizeof(tmp),tmp);
cache_get_row(0,3,tmp,DB); playerDB[playerid][X]=floatstr(tmp);
cache_get_row(0,4,tmp,DB); playerDB[playerid][Y]=floatstr(tmp);
cache_get_row(0,5,tmp,DB); playerDB[playerid][Z]=floatstr(tmp);
cache_get_row(0,6,tmp,DB); playerDB[playerid][XP]=strval(tmp);
cache_get_row(0,7,tmp,DB); playerDB[playerid][Pinigai]=strval(tmp);
}
return 1; //Butinas!!
}

Kosmosas? Aiškinamės po truputį:
"cache_get_data", tai tėra viena iš "caching" funkciju kuri suskaičiuos kiek yra eilučių ir stulpelių. Mums rūpi tik eilutės,tačiau turimi imti abu
"cache_get_row(0,0,tmp,DB); tai reiškia kad norime išgauti informacija iš eilutės 0(pirmas skaičius) ir 0 stulpelio(antras skaičius). Pastaba stulpeliai skaičiuojami nuo nulio. Tie skaičiai vadinami indeksais. (Pavizdinėje lentelėje juos sužymėjau).
"strval(tmp)", kadangi galime išgauti informaciją tik string tipu (kaip ir matote tmp yra stringas) todėl ją paverčiame į skaičių. Tai padaro funkcija strval();
"format...", nors išgauname string formatu, iš patirties turiu pasakyt kad vistiek reikia daryti tai dviem etapais. (priežasties nežinau bet taip yra)
"floatstr(tmp)", kadangime norime koordinačių o jos būna su skaičiumi po kablelio(Float tipo) turime naudoti floatstr(); Galima sakyt tai yra taspats kas strval, tik kad naudojama Float tipui


Ir viskas! Tiek užtenka kad galėtumėte pakeisti savo senas sistemas!

Tačiau MySQL gali DAUG daugiau. Kelias smulkmenas dar paminėsiu:
Kartais norisi ir ištrint duomenis, tokio tipo query atrodytu taip:

format(query,sizeof(query),"DELETE FROM `lentele_pavadinimas` WHERE kasnors='%'"); tai ištrins visą eilutę

MySQL turi tokį dalyką kaip "deffault values". Pavyzdžiui turite tokią lentelę kaip pavyzdinė viršuje, įrašote tik žaidėjo vardą bei slaptažodį, ir galite padaryti jog pas jį iškarto atsirastų kasnors. Tai galite padaryti nuėję į savo duomenų bazę, paspaudę ant lentelės,tada viršuje "structure", susiraskite norima laukelį ir spauskite change, atsidarys stulpelio nustatymai, ten kur "deffault" pasirinkite "as defined" ir įrašykite norimą vertę.

Dar vienas naudingas privalumas tai yra ryšiai. Kalbu apie ryšius tarp lentelių. Pavyzdžiui galima susieti mašina su žaidėjo, kad ištrynus žaidėja, dingtų ir mašina. Bet čia jau atskiros temos vertas dalykas.


Šįkartą tiek. Radę klaidų ar jei turit pasiūlymų, rašykit!

 

 

Daug serverių šeimininkų nori arba net naudoja MySQL, bet nelabai žino kaip naudoti, t.y. turi vieną pavyzdį ir  bando pagal jį daryti

 

 

Pamokos kodo pavyzdžiuose naudosiu BlueG kurto MySQL plugin versijos R38 funkcijas. Kai kurie principai galioja visoms versijoms.

 

Įvadas

 

Pirmiausia norėčiau pasakyti kad tai labai skiriasi nuo dokumentinių saugojimo būdų kaip Jūsų pamėgtas dini ar y_ini.Tai reiškia jog su MySQL išsaugotos informacijos nerasite scriptfiles direktorijoje. Ji "gyvens" duomenų bazėje kurią taip pat reikia paruošti.Tam paruošimui yra pilną pamokų, todėl to aš nerodysiu. Paruošus papildomas programas(pasirenkamas) jums reikės prisijungti į phpMyAdmin(kaip tai padaryti turėtumėte rasti paleidimo pamokose). Ten, mums reikės sukurti duomenų bazę, pavadinimas priklauso vien nuo Jūsų noro. Ir dar net ne viskas, nors jau artėjame skripto! Tada, reikės susikurti lenteles laikyti duomenims, apie jų kūrimą esu parašęs kitą pamoką: čia Kai paruošite lentelę, tada jau galėsim pereiti prie Pawn...

 

Pasiruošimas

 

Tikiuosi Pawn darbui su MySQL jau paruošėte: kalbu apie plugin ir include įsikėlimą.

 

Pirmiausia skripte, mums reikia prisijungti prie savo duomenų bazės ir išsaugoti nuorodą į tą prisijungimą. Žinoma tai galite daryti bet kada, nes tai yra tik funkcija, bet logiškai norėsite tai daryti paleidus serverį. 

new Db; // Pats paprasčiausias kintamasis kuriame laikysime prisijungimą. Vadinkite jį kaip norite.
 
public OnGameModeInit()
{
   mysql_log(); //Tai pradės problemų loginimą ir labai palengvins klaidų paiešką.
   Db = mysql_connect("localhost","root","duombaze","slaptazodis"); // Prisijungėme! Gal...
   return;
}

 

Aptarkime mysql_connect funkcijos parametrus:

"localhost" - tai yra duomenų bazės IP adresas, o žodis "localhost" rodo į tą patį kompiuterį kuris yra naudojamas

"root" - tai yra vartotojo vardas, o pats "root" tai tiesiog pradinis vartotojas kuris būna sukurtas paruošus MySQL

"duombaze" - tai yra duomenų bazės pavadinimas, apie kurį kalbėjau pačioje pradžioje.

"slaptazdosi" - tikiuosi šito aiškinti nereikia... 

Be šių parametrų yra papildomų: port'as, auto-prisijungimas praradus ryšį, MySQL prisijungimų skaičius.. Bet jie skirti labiau pažengusiems,  todėl šioje pamokoje nebus aptarti.

 

 

Užklausos

 

Dabar pagaliau galime pereiti prie Jūsų taip lauktos dalies: užklausų. Taigi, duomenų bazė yra visiškai kitas dalykas nei Jūsų serveris, tai kaip jie "bendrauja" ? Užklausomis(angl. queries). Iš serverio siunčiame užklausas, jų yra keli pagrindiniai tipai: įrašymo, atnaujinimo, ištrynimo, pasirinkimo(jų galima labai įvarių pridaryti, jei to norite mokykitės MySQL kalbą). Dabar ir aptarsime šių užklausų tipus ir kaip jos formatuojamos ir siunčiamos Pawn kode.

 

Visuose pavyzdžiuose bus naudojama mysql_format funkcija, kurią norėčiau aptarti prieš pradedant. Ji beveik tokia pati kaip įprasta "format", tačiau turi papildomą parametrą(pirmąjį) tai yra prisijungimas, kurį gražino mysql_connect. Šią funkciją naudojame vien dėl %e, kuris yra toks pat kaip %s, tik automatiškai "escape'ina" string tipo kintamuosius.

 

 

Pradėsime nuo jų formatavimo, kadangi siuntimo būdai irgi yra keli.

 

INSERT INTO - Įrašymo užklausos. Jos skirtos sukurti naują eilutę lentelėje.

 

Šitam pavyzdyje įsivaizduokime kad norime įrašyti naują eilutę su  trejais kintamaisiais: String, float ir int.

new query[140]; // String tipo kintamasis laikyti užklausai
mysql_format(Db,query,sizeof(query),"INSERT INTO lenteles_pavadinimas (stulpelis_1,stulpelis_2,stulpelis_3)VALUES('%e',%f,%d)",kintamasis_1,kintamasis_2,kintamasis_3); 

 

UPDATE - Atnaujinimo užklausos. Jas siunčiame kai norime atnaujinti duomenis egzistuojančioje lentelėje.

 

Imant pavyzdį iš INSERT užklausos, atnaujinsime tuos pačius stulpelius:

new query[140]; // String tipo kintamasis laikyti užklausai
mysql_format(Db,query,sizeof(query),"UPDATE lenteles_pavadinimas SET stulpelis_1 = '%e', stulpelis_2 = %f, stulpelis_3 = %d",kintamasis_1,kintamasis_2,kintamasis_3);

 

Pastaba. Realiai tokia užklausa atnaujintų VISAS eilutes esančias lentelėje, kad to išvengti pridedamas WHERE sakinys jos gale, kuris nurodo būtent kurią ar kurias eilutes atnauinsime, jį simbolizuos "kintamasis_4":

mysql_format(Db,query,sizeof(query),"UPDATE lenteles_pavadinimas SET stulpelis_1 = '%e', stulpelis_2 = %f, stulpelis_3 = %d WHERE kazkoks_stulpelis = %tipas",kintamasis_1,kintamasis_2,kintamasis_3,kintamasis_4);

 

DELETE - Ištrynimo užklausos. Ko gero, lengviausios užklausos. Jos ištrina egzistuojančią eilutę.

 

new query[140]; // String tipo kintamasis laikyti užklausai
mysql_format(Db,query,sizeof(query),"DELETE FROM lenteles_pavadinimas");

 

Pastaba. Ši užklausa ištrintų VISAS eilutes lentelėje, kad to išvengti pridėsim WHERE sakinį, kuris nurodys kurias eilutes reikia trinti:

new query[140]; // String tipo kintamasis laikyti užklausai
mysql_format(Db,query,sizeof(query),"DELETE FROM lenteles_pavadinimas WHERE kazkoks_stulpelis = %tipas",kintamasis);

 

 

SELECT - Pasirinkimo užklausos. Jos "parneša" pasirinktus duomenis iš duomenų bazės. 

 

new query[140]; // String tipo kintamasis laikyti užklausai
mysql_format(Db,query,sizeof(query),"SELECT * FROM lenteles_pavadinimas");

 

Pastaba. * reiškia jog norime pasirinkti VISUS stulpelius esančius lentelėje, norint pasirinkti kelis vietoj jos galima rašyti jų pavadinimus

Pastaba. Tai parinks VISUS duomenis esančius lentelėje, ko mums dažnai nereikia, kad to išvengtume pridėkime WHERE sakinį:

new query[140]; // String tipo kintamasis laikyti užklausai
mysql_format(Db,query,sizeof(query),"SELECT * FROM lenteles_pavadinimas WHERE kazkoks_stulpelis = %tipas",kintamasis);

 

Pastaba. Duomenys dar reikia apdoroti kad juos galima būtų naudoti, kaip tai atlikti žiūrėkite "Duomenų apdorojimas" žemiau.

 

 

Užklausų išsiuntimas

 

 

Naujausiose šio plugin versijose yra keli būdai siųsti užklausas. Mes aptarsime tris, naudojant: mysql_query, mysql_pquery ir mysql_tquery funkcijas.

 

mysql_query - unthreaded užklausa. Tai yra lėčiausio tipo užklausa.. Ji vykdoma ant tos pačios gijos(angl. thread).

Ji turi du privalomus parametrus:

connection_handle - tai yra mūsų prisijungimo kintamasis, kuris gauna vertę iš mysql_connect

query[] - tai užklausa String tipu.

Ir vieną neprivalomą parametrą:

bool:use_cache - ar naudoti cache. Nustačius į false nebus saugomas rezultatas

Ji gražina skaičių su "Cache" tag'u. Tai yra užklausos rezultatas, kad neprarastume atminties baigus darbą su užklausa reikia jį ištrinti naudojant cache_delete funkciją ir jai perleidžiant gražintą kintamąjį.

 

 

mysql_tquery - Užklausa ant atskiros gijos(angl. thread). 

Ji turi du PRIVALOMUS parametrus:

connection_handle - tai yra mūsų prisijungimo kintamasis, kuris gauna vertę iš mysql_connect

query[] - tai yra užklausa string tipu

Bei 3 papildomus parametrus:

callback[] - funkcijos pavadinimas kurią užklausa iškvies baigus darbą

format[] - papildomų kintamųjų, kuriuos norite perduoti funkcijai, tipai.

{Float,_}:... - papildomi kintamieji

Ji gražina 1 pavykus, ir 0 priešingu atveju

 

mysql_pquery - Paralelinė užklausa, ji yra reičiausia. Jos problema ta, jog nežinome kokia tvarka grįš išsiųstos užklausos, bet tai problema tik su pasirinkimo užklausomis.

Jos parametrai yra vienodi su mysql_tquery.

 

 

 

 

Duomenų apdorojimas(pasirinkimo užklausos)

 

Pasirinkimo užklausos gražina tai ką pasirinkote, tačiau iš jų reikia tai pasiimti naudojant pateiktas funkcijas.

 

 
//Įsivaizduojama užklausa pavyzdžiams atrodo taip:
// SELECT * FROM lentele
// Įsivaizduokime kad ją sudaro 3 stulpeliai:
// Vardas - String
// Gyvybės - Float
// Pinigai - Int
 
// Dar įsivaizduokime, kad užklausa suformatuota kintamajame "query"
// O "Db" tai yra mūsų prisijungimo kintamasis nuo pamokos pradžios
// Funkcijų paaiškinimai bus po kodu
 
 
//Naudojant mysql_query
 
new Cache:rezultatas = mysql_query(Db, query);
if(cache_get_row_count())
{
    new vardas[MAX_PLAYER_NAME],pinigai,Float:hp;
    cache_get_row(0,0, vardas);
    pinigai = cache_get_row_int(0,1);
    hp = cache_get_field_content_float(0,"Pinigai"));
}
cache_delete(rezultatas); // Labai svarbu, kitaip pagadinsime atminties.
 
// Naudojant mysql_pquery arba mysql_tquery
 
mysql_tquery(Db, query, "Funkcija");
 
// Ši funkcija PRIVALO būti public.
forward Funkcija();
public Funkcija()
{
    if(cache_get_row_count())
    {
        new vardas[MAX_PLAYER_NAME],pinigai,Float:hp;
        cache_get_row(0,0, vardas);
        pinigai = cache_get_field_content_int(0,"Pinigai");
       hp = cache_get_row_float(0,2);
    }
    return 1;
} 

 

 

Pastaba. Naudotos įvairios funkcijos tik dėl mokymo tikslų. Galite naudoti ir vieno tipo.

 

cache_get_row - paiima string vertę iš užklausos rezultato, jos parametrai:

row - eilutės indeksas

field_idx - stulpelio indeksas

destination[] - kintamasis į kurį bus įrašyta vertė

cache_get_row_int - paiima int vertę iš užklausos rezultato. Jos parametrai:

row - eilutės indeksas

field_idx - stulpelio indeksas

cache_get_row_float - paiima float vertę iš užklausos rezultato. Jos parametrai lygūs cache_get_row_int funkcijai.

 

cache_get_field_content - paiima string vertę iš užklausos rezultato, jos parametrai:

row - eilutės indeksas

const field_name[] - stulpelio pavadinimas

destination[] - kintamasis į kurį bus įrašyta vertė.

cache_get_field_content_int - paiima int vertę iš užklausos rezultato, jos parametrai:

row - eilutės indeksas

const field_name[] - stulpelio pavadinimas

cache_get_field_content_float - paiima float vertę iš užklausos rezultato. Jos parametrai lygūs cache_get_row_int

 

Pastaba. Funkcijos turi ir daugiau parametrų, čia parodyti tik privalomi.

 

Pastaba! Eilučių ir stulpelių indeksai prasideda nuo 0. Todėl pirma eilutė/stulpelis bus 0, antra eilutė/stulpelis - 1.

 

 

 

Gavosi didesnė pamoka nei planavau

 

Jei radai klaidų ar turi pasiūlymų, rašyk.

Redaguota Gegužės 1, 2014, nario Justas Š.

[Swedbank]

Gera pamoka .rep .

[LaGGeR]

Ripinta.

[sancio]

public naudojimas krovimui / saugojimui, pfff.

Pamoką nelabai ko verta. Ta pati galima rasti ir wikipeadijoje, apie mySQL

[bebras]

Erk, gali pasakyt is kur?

Nes ja rasiau kitam puslapyje (ir ikeliau ne vienam ir ne dvejuose). Kitur jeigu ir rasi ja tai autorius bus "Bebras" kas as ir esu. Deja cia buvo uzimtas nickas toks. Jei nori ten is kur tu manai kad "ripinau" parasyk i PM. Ir cia tik i pm parasyk apie kuria svetaine tu kalbi

[Arunce]

NOT BAD.

[Kesa]

Kažką supratau. Nors pats naudoju y_ini noriu išmokt mysql (niekada nei nebandžiau), gal gali kokį link kur daugiau galima sužinot? (Tingiu ieškot)

[bebras]

Na butent apie R7 plugino naudojima pasiulyciau nebent cia (angliskai)

O bendrai apie MySQL cia (angliskai, wiki)

[Alter]

Tikrai gera pamoka, net atrodo, kad lengviau nei y_ini ar dini. +rep

[Expert*]

Įspėju nenaudoti BlueG R7 versijos jai esat visiški n00bai mysql sistemoje. Pradėkit nuo R5 ar R6...

Tikrai gera pamoka, net atrodo, kad lengviau nei y_ini ar dini. +rep

Iš dalies tu teisus, bet mysql momentalei reikalauja daugiau resursų, nes turi palaikyti netik serverį bet ir mysql db...

Jai nežadi kurti VVP kogero mysql naudoti neverta. O jai labai plačiai naudoji YSI biblioteką naudok y_ini...

[bebras]

Įspėju nenaudoti BlueG R7 versijos jai esat visiški n00bai mysql sistemoje. Pradėkit nuo R5 ar R6...

Iš dalies tu teisus, bet mysql momentalei reikalauja daugiau resursų, nes turi palaikyti netik serverį bet ir mysql db...

Jai nežadi kurti VVP kogero mysql naudoti neverta. O jai labai plačiai naudoji YSI biblioteką naudok y_ini...

Nemanau kad jeigu nemoki išvis MySQL verta mokytis R5-6 ir tada iš naujo R7+... Geriau iškarto griebti R7

[Yoong]

Gera pamoka. + REP

[bebras]

Pamoka perrašyta!

[Kesa]

mysql_query 3 paramertrai.

[bebras]

mysql_query 3 paramertrai.

Ačiū už pastabą. Pataisyta

[Kesa]

Klausimas ką geriau nudoti cache ar omr?

[bebras]

Klausimas ką geriau nudoti cache ar omr?

Jei moki MySQL - cache.

 

Pagal greičio bandymus, ORM yra greitesnis(šaltinis), BET su ORM tu visada pasirinksi/atnaujinsi VISUS kintamuosius. Juk ne visada reikia atnaujinti viską, tokie dalykai kaip lytis juk niekada nesikeičia.