Sign in Join
Wiki copytemporary

MySQLDatabases/pl: what changed

Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.

Title: MySQLDatabases/pl

OldNewLine
1+## Wprowadzenie
2+
3+Ta strona wyjaśnia, jak połączyć się z serwerem bazy danych [[mysql|MySQL]] przy użyciu komponentów wizualnych.
4+
5+> **Note:** Ta strona została przetłumaczona z wersji angielskiej na język polski w dniu 2021.01.31, ale wersja angielska została napisana dawno temu i może nie być aktualna. Ponadto większość opisanych tutaj koncepcji nie jest specyficznych dla MySQL, ale ma zastosowanie do wszystkich baz danych SQLDB. Dlatego skorzystanie z poniższej serii samouczków SQLdb może być łatwiejsze
6+
7+Uwaga: zapoznaj się również z samouczkami, które uczą obsługi kontrolek związanych z danymi, zapytań parametrycznych, programowania niezależnego od bazy danych itp .:
8+
9+- [[SQLdb Tutorial1|SQLdb Samouczek1]]
10+- [[SQLdb Tutorial2|SQLdb Samouczek2]]
11+- [[SQLdb Tutorial3|SQLdb Samouczek3]]
12+
13+Te samouczki są napisane dla wszystkich baz danych obsługujących sqldb, w tym MySQL.
14+
15+W razie potrzeby zobacz również [[mysql|Samouczki SQLDB i przykładowy kod]], aby uzyskać więcej samouczków (które również zostały napisane dawno temu.
16+
17+## Dostępne komponenty
18+
19+### Komponenty SQLdb
20+
21+W każdej, nawet dość niedawnej wersji Lazarusa, komponenty SQLdb są instalowane domyślnie.
22+
23+<figure>
24+<img src="sqldbcomponents2.png‎" title="sqldbcomponents2.png‎" />
25+<figcaption>sqldbcomponents2.png‎</figcaption>
26+</figure>
27+
28+W zakładce SQLdb znajdziesz:
29+
30+- Różne złącza (connectors), w tym [[TMySQL40Connection]] .. [[TMySQL57Connection]] (a może nawet nowsze wersje) i najbardziej wszechstronne ze wszystkich [[TSQLConnector]], które mogą ładować dowolne ze sterowników baz danych takich jak mysql/oracle/postgres/mssql/interbase/firebird/odbc.
31+- [[TSQLQuery]]
32+
33+Jeśli brakuje karty SQLdb, zajrzyj do [[Install Packages|Instalowanie pakietów]], aby uzyskać instrukcje dotyczące instalacji.
34+
35+## Wyjaśnienie zastosowanych komponentów
36+
37+### TMySQLConnection
38+
39+TMySQLConnection służy do przechowywania parametrów połączenia z serwerem bazy danych. Umożliwia ustawienie hosta, z którym ma się łączyć, oraz identyfikatora użytkownika i hasła, które mają być używane w połączeniu. Inna właściwość TMySQLConnection służy do wskazania bazy danych, której chcesz użyć. „LoginPrompt” jeszcze nie działa, więc upewnij się, że obok właściwości HostName i DatabaseName uzupełnione są również wartości UserName i Password, zanim spróbujesz otworzyć połączenie. Pamiętaj, że aby użyć również TSQLTransaction i połączyć ją z MySQLConnection, ustaw właściwość Transaction, w przeciwnym razie nie będziesz mógł otworzyć zapytania SQLQuery.
40+
41+> **Note:** Jak wskazano powyżej, istnieją różne komponenty MySQLConnection, które różnią się numerem wersji. Numer wersji **musi** odpowiadać numerowi wersji biblioteki klienta, której używasz do łączenia się z serwerem. Jeśli więc używasz serwera MySQL 5.1, ale używasz klienta MySQL 5.0, użyj TMySQL50Connection.
42+
43+Powinieneś sprawdzić dokumentację MySQL, aby upewnić się, że połączenie między wersją klienta i wersją serwera jest obsługiwane - np. możesz mieć problemy z połączeniem się z serwerem 4.0 przy użyciu klienta 5.x.
44+
45+We wszystkich przypadkach należy umieścić kopię biblioteki libmysql.dll *i wszelkich innych wymaganych plików/bibliotek dll*
46+
47+- w twoim katalogu Lazarus i tym samym katalogu co pliki twojego projektu lub
48+- w katalogu systemowym Windows (jeśli nie chcesz dalej kopiować plików). Zauważ, że w 64-bitowym systemie Windows bibliotekę 32-bitową musisz umieścić w katalogu SysWOW64, podczas gdy biblioteki 64-bitowe należy przenieść do System32.
49+
50+### TSQLTransaction
51+
52+[[TSQLTransaction]] jest potrzebne do niektórych wewnętrznych procedur. SQLTransaction jest automatycznie aktywowana po otwarciu zestawu danych przy jej użyciu. Zamknięcie połączenia również dezaktywuje powiązaną transakcję i zamyka wszystkie korzystające z niej zbiory danych.
53+
54+### TSQLQuery
55+
56+[[TSQLQuery]] służy do wykonywania instrukcji SQL na serwerze. Możesz pobrać dane, ustawiając SQL na jakąś instrukcję SELECT i wywołując metodę Open. Możesz też manipulować danymi, wydając instrukcję INSERT, DELETE lub UPDATE. W tym drugim przypadku nie powinieneś używać metody Open, ale metodę ExecSQL.
57+
58+### TDataSource
59+
60+[[TDataSource]] zapewnia połączenie między widocznymi komponentami obsługującymi dane, takimi jak DBEdit, DBGrid i zbiorem danych. Przygotowuje dane do wyświetlania w komponentach obsługujących te dane. DataSource (źródło danych) może być jednocześnie połączone tylko z jednym zestawem danych, ale do niego może być połączonych kilka komponentów obsługujących dane.
61+
62+### TDBGrid
63+
64+[[TDBGrid]] może służyć do przedstawienia danych pobranych przez Dataset (zbiór danych). DBGrid potrzebuje Datasource (źródła danych), aby połączyć się ze zbirem danych. Gdy zbiór danych zostanie otwarty, DBGrid zostanie automatycznie wypełniony danymi.
65+
66+## Nasz program
67+
68+### Podstawy
69+
70+Spróbujemy stworzyć program w oparciu o ten stworzony [[Lazarus Database Tutorial/nl|tutaj (w języku niderlandzkim)]], który jest oparty na [[Lazarus Database Tutorial|oryginale (w języku angielskim)]] autorstwa Chris.
71+
72+### Formularz główny
73+
74+Użyjemy tego samego ekranu głównego i zbudujemy całą funkcjonalność od podstaw :) Jak zobaczysz, jest tu o wiele mniej do zrobienia, ponieważ komponenty naprawdę rozwiązują wszystkie trudne rzeczy! Zacznijmy więc od stworzenia ekranu, który wygląda tak:
75+
76+<figure>
77+<img src="Trymysql_pl.png" title="Trymysql_pl.png" />
78+<figcaption>Trymysql_pl.png</figcaption>
79+</figure>
80+
81+Korzystając z zakładki SQLdb umieść na swojej formatce komponenty [[TMySQL56Connection]] ![](/wiki-images/9/97/Tmysql56connection.png) (lub inną wersję klienta mysql), [[TSQLTransaction]] ![](/wiki-images/b/bd/Tsqltransaction.png) i [[TSQLQuery]] ![](/wiki-images/b/bb/Tsqlquery.png). Nie zmieniaj domyślnych nazw nadanych tym komponentom. Z wyjątkiem komponentu łączącego do bazy. Aby artykuł był taki sam dla wszystkich wersji MySQL, nazwij komponent TMySQL##Connection: `MySQLConnection1`. Musimy te komponenty połączyć razem, aby mogły wykonywać swoją pracę. Dlatego należy ustawić następujące właściwości:
82+
83+| | | |
84+|------------------|----------------|------------------|
85+| **Komponent** | **Właściwość** | **Wartość** |
86+| MySQLConnection1 | Transaction | SQLTransaction1 |
87+| SQLTransaction1 | Database | MySQLConnection1 |
88+| SQLQuery1 | Transaction | SQLTransaction1 |
89+| SQLQuery1 | Database | MySQLConnection1 |
90+
91+Właściwość Transaction komponentu SQLQuery1 zostanie ustawiona automatycznie, jeśli najpierw ustawisz właściwość Transaction dla MySQLConnection1. Gdy to ustawisz, zauważysz, że SQLTransaction1.Database została ustawiona na MySQLConnection1.
92+
93+Jak wspomniano wcześniej: upewnij się, że używasz odpowiedniego komponentu połączenia dla swojej wersji serwera MySQL.
94+
95+### Kod
96+
97+Jak widać na zrzucie ekranu, jedynymi przyciskami dostępnymi po uruchomieniu programu są „Połącz z serwerem” i „Zakończ”. Aby inne przyciski działały, potrzebujemy więcej informacji, więc są one wyłączone. Moglibyśmy również zdecydować o wyłączeniu opcji „Połącz z serwerem” do czasu podania informacji o hoście, nazwie użytkownika i haśle. Zdecydowałem się tego nie robić, ponieważ nasz użytkownik mógłby pomyśleć: „Nic nie wydaje się możliwe, więc przejdźmy do wyjścia”. :)
98+
99+Zanim zacznę podawać jakikolwiek kod, chciałbym podkreślić, że w kodzie powinna być dodana obsługa wyjątków. Sekcje krytyczne należy umieścić w blokach kodu
100+
101+`try ... finally`
102+
103+i / lub
104+
105+`try ... except`
106+
107+#### Połączenie z serwerem
108+
109+Pierwszą rzeczą, którą musimy zrobić, jest połączenie się z naszym serwerem. Ponieważ przy łączeniu nie wiemy, jakie bazy danych są dostępne na serwerze, przy połączeniu poprosimy o listę baz danych. Jest jednak jeden haczyk, aby nawiązać połączenie, musimy wprowadzić poprawną nazwę bazy danych we właściwościach MySQLConnection. W kodzie zobaczysz, że używam bazy danych „mysql”. Ta baza danych jest używana przez mysql do pewnych czynności porządkowych, więc zawsze tam będzie.
110+
111+``` pascal
112+procedure TFormTryMySQL.ConnectButtonClick(Sender: TObject);
113+begin
114+ // Sprawdź, czy mamy aktywne połączenie. Jeśli tak, musimy je zamknąć.
115+ if MySQLConnection1.Connected then CloseConnection(Sender);
116+ // Ustaw parametry połączenia.
117+ MySQLConnection1.HostName := HostEdit.Text;
118+ MySQLConnection1.UserName := UserEdit.Text;
119+ MySQLConnection1.Password := PasswdEdit.Text;
120+ MySQLConnection1.DatabaseName := 'mysql'; // Baza mysql jest zawsze dostępna!
121+ ShowString('Otwarcie połączenia z serwerem: ' + HostEdit.Text);
122+ MySQLConnection1.Open;
123+ // Najpierw pobierzmy listę dostępnych baz danych.
124+ if MySQLConnection1.Connected then begin
125+ ShowString('Połączono z serwerem: ' + HostEdit.Text);
126+ ShowString('Pobieranie listy dostępnych baz danych.');
127+ SQLQuery1.SQL.Text := 'show databases';
128+ SQLQuery1.Open;
129+ while not SQLQuery1.EOF do begin
130+ DatabaseComboBox.Items.Add(SQLQuery1.Fields[0].AsString);
131+ SQLQuery1.Next;
132+ end;
133+ SQLQuery1.Close;
134+ ShowString('Lista otrzymanych baz danych!');
135+ end;
136+end;
137+```
138+
139+Pierwszą rzeczą, jaką robimy, jest sprawdzenie, czy jesteśmy połączeni z serwerem, jeśli tak, wywołujemy prywatną metodę „CloseConnection”. W tej metodzie robi się więcej porządków. jak wyłączanie przycisków i czyszczenie comboboxów i listbox. Następnie ustawiamy niezbędne parametry, aby połączyć się z serwerem.
140+
141+
142+*W całym naszym programie możesz zobaczyć wywołania ShowString. Ta metoda dodaje wiersz do notatki w naszym formularzu, który działa jak rodzaj dziennika.*
143+
144+Po ustawieniu parametrów możemy połączyć się z serwerem. Odbywa się to przez wywołanie
145+
146+``` pascal
147+MySQLConnection1.Open;
148+```
149+
150+W odpowiedniej aplikacji można by to umieścić w konstrukcji obsługi wyjątków, aby przedstawić użytkownikowi przyjazny komunikat w przypadku niepowodzenia połączenia. Kiedy jesteśmy połączeni, chcemy uzyskać listę baz danych z serwera. Aby uzyskać dane z serwera, używane jest zapytanie TSQLQuery. Właściwość SQL służy do przechowywania instrukcji SQL wysyłanej do serwera. MySQL zna polecenie „SHOW DATABASES”, aby uzyskać listę baz danych. Więc po ustawieniu tekstu SQL wywołujemy
151+
152+``` pascal
153+SQLQuery1.Open;
154+```
155+
156+W MySQL5 ustaw to, aby poprawić błąd ze składnią SQL:
157+
158+``` pascal
159+SQLQuery1.ParseSQL := False;
160+SQLQuery1.ReadOnly := True;
161+```
162+
163+Zestaw wyników SQLQuery można sprawdzić za pomocą właściwości fields. Jak widać, przeglądamy wszystkie zapisy, wywołując
164+
165+``` pascal
166+SQLQuery1.Next;
167+```
168+
169+Kiedy dodamy wszystkie dostępne bazy danych do naszego combobox, ponownie zamykamy SQLQuery.
170+
171+#### Wybieranie bazy danych
172+
173+Jeśli użytkownik wybierze bazę danych w DatabaseComboBox, włączamy przycisk „Wybierz bazę danych”. W zdarzeniu OnClick tego przycisku ustawiamy DatabaseName MySQLConnection1 i żądamy listy tabel. Ostatnia instrukcja tej procedury włącza przycisk „Otwórz zapytanie”, dzięki czemu użytkownik może wprowadzić zapytanie w polu edycji „Polecenie” i wysłać je na serwer.
174+
175+``` pascal
176+procedure TFormTryMySQL.SelectDBButtonClick(Sender: TObject);
177+begin
178+ // Baza danych została wybrana, więc pobierzmy z niej tabele.
179+ CloseConnection(Sender);
180+ if DatabaseComboBox.ItemIndex <> -1 then begin
181+ with DatabaseComboBox do
182+ MySQLConnection1.DatabaseName := Items[ItemIndex];
183+ ShowString('Pobieranie listy tabel');
184+ SQLQuery1.SQL.Text := 'SHOW TABLES';
185+ SQLQuery1.Open;
186+ while not SQLQuery1.EOF do begin
187+ TableComboBox.Items.Add(SQLQuery1.Fields[0].AsString);
188+ SQLQuery1.Next;
189+ end;
190+ SQLQuery1.Close;
191+ ShowString('Lista otrzymanych tabel');
192+ end;
193+ OpenQueryButton.Enabled := True;
194+end;
195+```
196+
197+MySQL ma specjalne polecenie do pobierania listy tabel, porównywalne do pobierania listy baz danych, „SHOW TABLES”. Wynik tego zapytania jest obsługiwany w taki sam sposób, jak lista baz danych, a wszystkie tabele są dodawane do TableComboBox. Możesz się zastanawiać, dlaczego nie otwieramy ponownie połączenia przed otwarciem zapytania? Cóż, odbywa się to automatycznie (jeśli to konieczne), gdy aktywujemy SQLQuery.
198+
199+#### Pola w tabeli
200+
201+W MySQL możesz ponownie użyć formy „SHOW”, aby pobrać pola w tabeli. W tym przypadku „SHOW COLUMNS FROM \<nazwa tabeli\>”. Jeśli użytkownik wybierze tabelę z TableComboBox, wyzwalane jest zdarzenie OnChangeEvent tego ComboBox, które wypełnia pole FieldListbox.
202+
203+``` pascal
204+procedure TFormTryMySQL.TableComboBoxChange(Sender: TObject);
205+begin
206+ FieldListBox.Clear;
207+ SQLQuery1.SQL.Text := 'SHOW COLUMNS FROM ' + TableComboBox.Text;
208+ SQLQuery1.Open;
209+ while not SQLQuery1.EOF do begin
210+ FieldListBox.Items.Add(SQLQuery1.Fields[0].AsString);
211+ SQLQuery1.Next;
212+ end;
213+ SQLQuery1.Close;
214+end;
215+```
216+
217+Oprócz nazw pól, zestaw wyników zawiera informacje o typie pola, jeśli pole jest kluczem, czy dozwolone są wartości null i nie tylko.
218+
219+#### Wyświetlanie danych
220+
221+Tak jak powiedzieliśmy, użyjemy komponentów do połączenia się z bazą danych, użyjmy również niektórych komponentów, aby pokazać dane. W drugim formularzu pokażemy siatkę z danymi żądanymi przez użytkownika. Formularz ten zostanie wyświetlony, gdy użytkownik wpisze polecenie SQL w polu edycji „Polecenie”, a następnie kliknie przycisk „Otwórz zapytanie”. To jest zdarzenie OnClick:
222+
223+``` pascal
224+procedure TFormTryMySQL.OpenQueryButtonClick(Sender: TObject);
225+begin
226+ ShowQueryForm := TShowQueryForm.Create(self);
227+ ShowQueryForm.Datasource1.DataSet := SQLQuery1;
228+ SQLQuery1.SQL.Text := CommandEdit.Text;
229+ SQLQuery1.Open;
230+ ShowQueryForm.ShowModal;
231+ ShowQueryForm.Free;
232+ SQLQuery1.Close;
233+end;
234+```
235+
236+ShowQueryForm wygląda następująco:
237+
238+<center>
239+
240+<figure>
241+<img src="Mysqlshow_pl.png" title="Mysqlshow_pl.png" />
242+<figcaption>Mysqlshow_pl.png</figcaption>
243+</figure>
244+
245+</center>
246+
247+i zawiera
248+
249+| | | |
250+|----|----|----|
251+| [[TPanel]] | Align | alBottom |
252+| [[TDataSource]] | | |
253+| [[TDBGrid]] | Align | alClient |
254+| | DataSource | DataSource1 |
255+| [[TButton]] | Caption | Close |
256+
257+Przycisk umieszczony jest na panelu. Kolejność działań w OnClick przycisku „Otwórz zapytanie” jest następująca. Najpierw tworzymy wystąpienie TShowQueryForm. Po drugie ustawiliśmy właściwość DataSet źródła danych na nasz SQLQuery1. Następnie ustawiamy polecenie SQLQuery SQL na to, co użytkownik wpisał w polu edycji „Polecenie” i otwieramy je. Następnie ShowQueryForm jest pokazywany modalnie, co oznacza, że ​​będzie się na nim koncentrował, dopóki nie zostanie zamknięty. Po zamknięciu „zwalniamy” go i ponownie zamykamy SQLQuery1.
258+
259+Formularz można dodatkowo ulepszyć poprzez wstawienie metody modyfikowania zawartości [[TDataSet]] i ostatecznie DataBase. Pełną wersję można pobrać z <http://digitus.itk.ppke.hu/~janma/lazarus/MySql5Test.tar.gz> (dzięki Arwen i JZombi z Lazarus MySQL Forum) ale istotne szczegóły są następujące:
260+
261+Dodaj przycisk u dołu formularza ShowQuery o nazwie AddButton i podpisem „Dodaj”. Utwórz metodę dla AddButtonClick w następujący sposób:
262+
263+``` pascal
264+procedure TShowQueryForm.AddButtonClick(Sender: TObject);
265+begin
266+ DataSource1.DataSet.Append;
267+end;
268+```
269+
270+Zmień kod dla OpenQueryButtonClick, aby umożliwić aktualizacje bazy danych po zakończeniu pracy z formularzem zapytania.
271+
272+``` pascal
273+procedure TFormTryMySQL.OpenQueryButtonClick(Sender: TObject);
274+begin
275+ ShowQueryForm := TShowQueryForm.Create(nil);
276+ try
277+ ShowQueryForm.DataSource1.DataSet := SQLQuery1;
278+ // Będziemy pisać w bazie danych, więc ustawmy ReadOnly na false,
279+ // a do tego musimy ustawić ParseSQL na true
280+ SQLQuery1.ParseSQL:=true;
281+ SQLQuery1.ReadOnly:=false;
282+ SQLQuery1.SQL.Text := CommandEdit.Text;
283+ SQLQuery1.Open;
284+ ShowQueryForm.ShowModal;
285+ finally
286+ // ustaw tryb aktualizacji i zaktualizuj bazę danych
287+ SQLQuery1.UpdateMode:=upWhereChanged;
288+ SQLQuery1.ApplyUpdates;
289+ SQLTransaction1.Commit;
290+ ShowQueryForm.Free;
291+ SQLQuery1.Close;
292+ // ustaw ReadOnly i ParsesSQL z powrotem na domyślne
293+ SQLQuery1.ParseSQL:=false;
294+ SQLQuery1.ReadOnly:=true;
295+ end;
296+end;
297+```
298+
299+Możemy teraz dodawać rekordy do bazy danych. Jeśli dodamy TDBNavigator do formularza ShowQuery, możemy łatwiej poruszać się po siatce danych i edytować rekordy; baza danych jest aktualizowana o nasze zmiany za każdym razem, gdy zamykamy formularz ShowQuery i możemy to przetestować, otwierając go ponownie w celu sprawdzenia bazy danych.
300+
301+Jeśli chcesz mieć możliwość USUWANIA lub w inny sposób modyfikowania rekordów w oryginalnej bazie danych (tj. trzeba upewnić się, że zmiany wprowadzone w lokalnym zestawie danych zostaną zatwierdzone z powrotem w bazie danych), musisz mieć jedną kolumnę w tabeli bazy danych, która jest kluczem podstawowym autoincremented, ponieważ metoda 'delete' wymaga możliwości wygenerowania klauzuli 'where' podczas zapisywania instrukcji z powrotem do bazy danych, aby zidentyfikować rekordy wybrane do usunięcia. Użyj więc następującego kodu w swoim kliencie MySQL (wszystko może być wpisane w jednej linii, ale dla przejrzystości dodano podziały linii):
302+
303+``` sql
304+ALTER TABLE TRESTRIG
305+ADD COLUMN AUTOID INT
306+PRIMARY KEY AUTO_INCREMENT;
307+```
308+
309+a wtedy zauważysz, że przycisk Usuń w nawigatorze działa.
310+
311+## Źródła
312+
313+Oryginalne źródła tego projektu można pobrać [tutaj](http://prdownloads.sourceforge.net/lazarus-ccr/mysql_demo_20050408.tar.gz?download). Aby uzyskać więcej projektów demonstracyjnych, zobacz [sourceforge](http://sourceforge.net/project/showfiles.php?group_id=92177&package_id=148359).
314+
315+> **Note:** Projekty te powstały w latach 2004-2009 i nie były aktualizowane. Bez kilku poprawek mogą nie kompilować się w obecnym Lazarus 2.0.10.
316+
317+## Zobacz także
318+
319+- [[mysql]]
320+
321+---
322+*From the Free Pascal wiki, page "MySQLDatabases/pl", as it stood on 2021-11-12 after a change by Slawek, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).*

Back to history