SqlDBHowto/zh CN: what changed

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

Old	New		Line
1	1		## 介绍
2	2
3	3		本页面翻译自 [[SqlDBHowto/nl]]，最初荷兰语领先，不过，现在两篇文章已经同步。
4	4
5	5		本文选择从'如何'做为开始。我想通过，一个问题一个答案的方式来解释如何使用不同类。像这样，一个接一个，形成教程以介绍如何使用它。
6	6
7	7		我会尽力阐明它，以便清楚的说明如何在 Lazarus 和 FreePascal 中使用。但这些例子是 FreePascal 中的（即控制台应用程序）。
8	8
9	9		## 在哪里可以找到官方文档
10	10
11	11		请参阅官方 [SQLDB 文档](http://www.freepascal.org/docs-html/fcl/sqldb/index.html)。
12	12
13	13		## 如何连接到数据库服务器
14	14
15	15		SqlDB 无法直接连接到数据库服务器，但可以使用数据库服务器客户端连接。SqlDB 发送命令到客户端；客户端连接到数据库并传输命令。这意味着电脑上必须安装数据库客户端才能与数据库连接。Windows 通常是 .dll文件，Linux 下是 .so文件，OS/X中为 .dylib的文件。
16	16
17	17		当客户端库已经正确安装，你便可以使用 TSQLConnection 组件连接到数据库服务器。各种 TSQLConnection 组件可连接到不同的数据库服务器。(查看 [[SQLdb Package\|SQLdb 包]]):
18	18
19	19		- Firebird/Interbase: TIBConnection (查看 [[Firebird\|Firebird#Connection]])
20	20		- MS SQL Server: TMSSQLConnection (自 FPC 2.6.1, 查看 [[Lazarus Database Overview\|Lazarus_Database_Overview#Lazarus_and_MSSQL.2FSybase]])
21	21		- MySQL v4.0: TMySQL40Connection (查看 [[mysql\|mysql#SQLDB]])
22	22		- MySQL v4.1: TMySQL41Connection (查看 [[mysql\|mysql#SQLDB]])
23	23		- MySQL v5.0: TMySQL50Connection (查看 [[mysql\|mysql#SQLDB]])
24	24		- MySQL v5.1: TMySQL51Connection (自 FPC 2.5.1, 查看 [[mysql\|mysql#SQLDB]])
25	25		- MySQL v5.5: TMySQL55Connection (自 Lazarus 1.0.8/FPC 2.6.2, 查看 [[mysql\|mysql#SQLDB]])
26	26		- MySQL v5.6: TMySQL56Connection (自 Lazarus 1.2.4/FPC 2.6.4, 查看 [[mysql\|mysql#SQLDB]])
27	27		- ODBC: TODBCConnection (查看 [[ODBCConn\|ODBCConn#TODBCConnection]])
28	28		- Oracle: TOracleConnection (查看 [[Oracle]])
29	29		- PostgreSQL: TPQConnection (查看[[postgresql\|postgresql#SQLDB]])
30	30		- Sqlite3: TSQLite3Connection (自 FPC 2.2.2, 查看[[SQLite\|SQLite#Built-in_SQLDB]])
31	31		- Sybase ASE: TSybaseConnection (自 FPC 2.6.1, 查看 [[Lazarus Database Overview\|Lazarus_Database_Overview#Lazarus_and_MSSQL.2FSybase]])
32	32
33	33		MySQL留意 - 在某种程度上客户端版本之间的差异使得客户端和连接不能互换。如 MySQL 客户端版本为4.1，你必须使用 TMySQL41Connection 连接。它与 MySQL 服务器端无关；也许你可以使用 4.1 的客户端，连接到 MySQL 5.0 的服务器（请参见 MySQL文档关于支持哪些组合）
34	34
35	35		虽然各数据库的细节不同，不过，一般只需要设置四个属性就可以连接到数据库服务器：
36	36
37	37		- 服务器名或 IP 地址
38	38		- 数据库名称
39	39		- 用户名
40	40		- 密码
41	41
42	42		设置好这些属性，使用 'open' 方法打开连接。如果连接失败，你可以使用 EDatabaseError 抛出异常。使用 'connected' 属性来确定是否建立与数据库服务器的连接。使用 'close' 方法来关闭与服务器的连接。
43	43
44	44		``` pascal
45	45		Program ConnectDB
46	46
47	47		var AConnection : TIBConnection;
48	48
49	49		Procedure CreateConnection;
50	50		begin
51	51		AConnection := TIBConnection.Create(nil);
52	52		AConnection.Hostname := 'localhost';
53	53		AConnection.DatabaseName := '/opt/firebird/examples/employee.fdb';
54	54		AConnection.UserName := 'sysdba';
55	55		AConnection.Password := 'masterkey';
56	56		end;
57	57
58	58		begin
59	59		CreateConnection;
60	60		AConnection.Open;
61	61		if Aconnection.Connected then
62	62		writeln('Successful connect!')
63	63		else
64	64		writeln('This is not possible, because if the connection failed, ' +
65	65		'an exception should be raised, so this code would not ' +
66	66		'be executed');
67	67		AConnection.Close;
68	68		AConnection.Free;
69	69		end.
70	70		```
71	71
72	72		如果抛出异常，仔细阅读错误消息。可能是数据库服务器没有运行，用户名、密码不正确，也可能是数据库名称或IP地址输入错误。如果消息提示客户端库无法找到，你需要检查客户端库是否安装正确。Often the error message states literally the name of the file looked for. （~~通常按错误消息上的名称查找。~~）
73	73
74	74		## 如何执行查询/创建表
75	75
76	76		SqlDB - 见名知意 - 适用于使用 SQL 的数据库服务器。SQL代表 '结构化查询语言'，它工作在关系型数据库上。事实上，每个数据库系统都有自己的方言，不过，大多 SQL 语句通用于所有数据库系统。
77	77
78	78		在 FPC 中，期间有些区别：
79	79
80	80		- SQL 语句返回的信息（数据集）。对于这一点，你需要使用 TSQLQuery 组件；查看#如何读取表中数据。
81	81		- 语句不返回信息，但在做其他事，例如更新数据，为此，你可以使用 TSQLConnection 的 'ExecuteDirect' 方法。You can also use this if you get a dataset back but are not interested in the results, e.g. in a selectable stored procedure.
82	82
83	83		Most database system execute SQL statements within a transaction. If you want changes made within a transaction available in other transactions, or have those changes available even after closing the transaction(!), then you have to 'commit' the transaction.
84	84
85	85		支持事务的 Sqldb 包含 TSQLTransaction 组件。由 Sqldb 执行的 SQL 语句必须在事务内执行，即使数据库系统不支持事务。此外，there are database systems that do support transaction for which TSQLConnection does not (yet) support transaction（~~使用 TSQLConnection 操作支持事务的数据库系统~~），即使这样，你也必须使用 TSQLTransaction 组件。
86	86
87	87		使用 `TSQLConnection.ExecuteDirect` 执行SQL语句你必须指定 'Transaction'；反过来，使用 TSQLTransaction 你也必须指定使用哪个 TSQLConnection 组件。
88	88
89	89		下面的示例将创建 'TBLNAMES' 表，包含字段有 'NAME' 和 'ID'，并插入2条记录。不解释所使用的 SQL 语句。 SQL 语句相关用途和语法，请参阅数据库系统文档。程序中定义的 'CreateConnection'，代码示例在#如何连接到数据库服务器上。
90	90
91	91		``` pascal
92	92		program CreateTable;
93	93
94	94		var
95	95		AConnection : TSQLConnection;
96	96		ATransaction : TSQLTransaction;
97	97
98	98		procedure CreateTransaction;
99	99		begin
100	100		ATransaction := TSQLTransaction.Create;
101	101		ATransaction.Database := AConnection;
102	102		end;
103	103
104	104		begin
105	105		CreateConnection;
106	106		CreateTransaction;
107	107		AConnection.Transaction := ATransaction;
108	108		AConnection.Open;
109	109		ATransaction.StartTransaction;
110	110		AConnection.ExecuteDirect('create table TBLNAMES (ID integer, NAME varchar(40));');
111	111
112	112		// Some database-server types need a commit before you can use a newly created table. (Firebird)
113	113		// With .Commit you also close the transaction
114	114		ATransaction.Commit;
115	115
116	116		ATransaction.StartTransaction;
117	117		AConnection.ExecuteDirect('insert into TBLNAMES (ID,NAME) values (1,'Name1');');
118	118		AConnection.ExecuteDirect('insert into TBLNAMES (ID,NAME) values (2,'Name2');');
119	119		ATransaction.Commit;
120	120		AConnection.Close;
121	121		AConnection.Free;
122	122		ATransaction.Free;
123	123		end.
124	124		```
125	125
126	126		## 如何读取表中数据
127	127
128	128		使用 TSQLQuery 组件从表中读取数据。它必须连接到 TSQLConnection 和 TSQLTransaction 组件才能正常工作。设置 TSQLConnection 和 TSQLTransaction 讨论在 #如何连接到数据库服务器和#如何执行查询/创建表。
129	129
130	130		当使用 TSQLConnection、 TSQLTransaction 和 TSQLQuery 连接时，TSQLQuery 需要进行些配置，'SQL' 属性包含要执行的 SQL 语句。如只读取表，那么将其属性设置为：
131	131
132	132		``` sql
133	133		'SELECT * FROM tablename;'
134	134		```
135	135
136	136		使用 'open' 从服务器中读取表并将数据放在 TSQLQuery 数据集中。可以通过 TSQLQuery 访问数据，直到使用 'close' 关闭查询。
137	137
138	138		TSQLQuery 是 TDataSet 的一个子类。TDataset 是 'Fields' 集合，包含表中的所有列。TDataset 可以定位当前记录，使用 'First'、 'Next'、 'Prior' 和 'Last' 分别改变到 '第一条'、'下一条'、'上一条'和'最后一条'记录。当在第一条记录时，Bof 为真；为最后一条记录时 Eof 为真。读取当前记录某字段的值，先找到合适的 'TField' 对象，之后使用 'AsString'、 'AsInteger' 等等。
139	139
140	140		### 示例:从表中读取数据
141	141
142	142		下面的示例将显示表中的所有数据，表来自 #如何执行查询/创建表。
143	143
144	144		``` pascal
145	145		Program ShowData;
146	146
147	147		var
148	148		AConnection : TSQLConnection;
149	149		ATransaction : TSQLTransaction;
150	150
151	151		function GetQuery : TSQLQuery;
152	152		var AQuery : TSQLQuery;
153	153		begin
154	154		AQuery := TSQLQuery.Create;
155	155		AQuery.Database := FConnection;
156	156		AQuery.Transaction := FTransaction;
157	157		Result := AQuery;
158	158		end;
159	159
160	160		var
161	161		Query : TSQLQuery;
162	162
163	163		begin
164	164		CreateConnection;
165	165		CreateTransaction;
166	166		Query := GetQuery;
167	167		Query.SQL.Text := 'select * from tblNames';
168	168		AConnection.Open;
169	169		Query.Open;
170	170		while not Query.Eof do
171	171		begin
172	172		Writeln('ID: ', Query.FieldByName('Name').AsInteger, 'Name: ' +
173	173		Query.FieldByName('Name').AsString);
174	174		Query.Next;
175	175		end;
176	176		Query.Close;
177	177		AConnection.Close;
178	178		Query.Free;
179	179		ATransaction.Free;
180	180		AConnection.Free;
181	181		end.
182	182		```
183	183
184	184		（上面的代码不是很完善，因为忽略了 'try...finally' 块；旨在演示显示数据，因此'美化'工作被忽略。） Please note that 'TSQLTransaction.StartTransaction' is not used. This is not necessary. When TSQLQuery is opened, the SQL statement is executed and if no transaction is available then a transaction is automatically started. The programmer does not need to start the transaction explicitly.(~~请注意，未使用 'TSQLTransaction.StartTransaction' 。似乎没有这个必要。当 TSQLQuery 被打开时，SQL语句被执行，如果没有事务可用，那么事务将自动启动。程序员并不需要明确的开始事务。~~)
185	185
186	186		The same applies for the connection maintained by TSQLConnection. The connection is opened as needed, the line 'Aconnection.Open' is not really required. If a TSQLTransaction is destroyed, an automatic 'rollback' will be executed. Possible changes to data contained in the transaction will be lost. (~~这同样适用 TSQLConnection 连接。根据需要打开连接，Aconnection.Open 是否真的需要。如果 TSQLTransaction 被销毁，将会 'rollback'（回退）刚才执行的。包含在事务中的数据，可能会丢失。~~)
187	187
188	188		### 为什么 TSQLQuery.RecordCount 总返回 10
189	189
190	190		使用 '.RecordCount' 统计数据集记录数。需要注意的是，'.RecordCount' 表示的是已经从服务器加载的记录数。出于性能考虑，SqlDB 默认情况下只读取 TSQLQuery 的前 10 条记录。只有当访问第 11 条记录时，下一组的 10 条记录才被加载。使用 '.Last'，将载入所有记录。
191	191
192	192		如果你想知道服务器真正的记录数，先调用 '.Last' 再调用 '.RecordCount'。
193	193
194	194		另一种方法更实用，服务器返回记录数是由 '.PacketRecords' 控制，默认值时 10，你可以设置为 -1，那么所有记录都将被加载。
195	195
196	196		In current stable FPC, '.RecordCount' does not take filters into account, i.e. it shows the unfiltered total. (~~当前稳定的 FPC，'.RecordCount' 不会考虑筛选器，既便它显示了过滤。~~)
197	197
198	198		If you need the exact number of records, it often is a better idea to directly query the number of records in a query using another SQL query, but you would have to do that in the same transaction, as other transactions may have changed the number of records in the meanwhile.（~~如果你需要确切记录数量，在同一个事务中使用 SQL 查询记录数。否则，其他事务或许会改变记录数。~~）
199	199
200	200		### Lazarus
201	201
202	202		Lazarus 有各种组件在窗体上显示 TDataset 数据。而不是使用 While-loop 或 Writeln 语句在上面显示，你可以使用组件显示表中的数据。
203	203
204	204		请正确在窗体上放置 TSQLConnection、TSQLTransaction 和 TSQLQuery 组件，此外还需要一个 TDatasource 组件，设置 'TDatasource.Dataset' 使用 TSQLQuery 组件。（注意，不要设置 'TSQLQuery.Datasource' 的属性为 TDatasource 组件。'TSQLQuery.Datasource' 使用[[MasterDetail\|主从]]表）之后，你可以把 TDBGrid 的属性 'Datasource' 设置为 TDatasource 。看下能否工作，设置 TSQLConnection 的 'Connected' 属性为真，IDE 将尝试立刻连接到数据库服务器。如果正常，设置 'TSQLQuery.Active'属性为真。如果一切顺利，你将在屏幕上看到所有表数据。
205	205
206	206		译者注：
207	207
208	208		在测试使用时，设置 'TSQLQuery.Active'属性或 TSQLConnection 的 'Connected' 为真，（因为我使用的是 MySQL）因此提示：
209	209
210		-	~~`Can not load default MySQL library libmysql.dll ......`~~
	210	+	```text
	211	+	Can not load default MySQL library libmysql.dll ......
	212	+	```
211	213
212	214		完全可以不用理会，你在程序中手动连接数据库服务器就行了。
213	215
214	216		## 如何修改表中数据
215	217
216	218		要更改记录中的数据，TDataset （由 TSQLQuery 派生）必须设置为编辑模式。进入编辑模式可以调用 '.Edit'、 '.Insert' 或 '.Append' 方法。使用 '.Edit' 方法用来修改当前记录。'.Insert' 方法，在当前记录前插入新记录。'.Append' 方法，在表尾插入新记录。在编辑模式中，你可以通过 'Fields' 属性更改字段值。使用 'Post' 以验证新的数据，如果数据有效将离开编辑模式。If you move to another record - for example by using '.Next' - and the dataset is in edit mode, then first '.Post' is called. （~~如果你移动到另一条记录 - 像通过使用 '.Next' - 而数据集处于编辑模式，那么 '.Post' 将被调用。~~）使用 '.Cancel' 放弃自上次 '.Post' 的所有更改并退出编辑模式。
217	219
218	220		``` pascal
219	221		Query.Edit;
220	222		Query.FieldByName('NAME').AsString := 'Edited name';
221	223		Query.Post;
222	224		```
223	225
224	226		上述还不完整。TSQLQuery is derived from TBufDataset which makes use of buffered updates. Buffered update means that after you called 'Post' the changes in the dataset are visible immediately,（~~TSQLQuery 派生自 TBufDataset 利用缓冲更新。缓冲更新意味着，调用 'Post' 更新数据集是即刻生效。~~）但它们还没被发送到数据库服务器。 What does happen is that the changes are maintained in a change log. （~~所发生的是，改变在更新日志中。~~）当调用 '.ApplyUpdates' 方法时，所做的更改都将发送到数据库。只有这样，数据库服务器才知道所做的更改。所做的更改发送到 TSQLTransaction 事务内部服务器。 Make sure to properly set the transaction before 'ApplyUpdates'. After applying the updates, a commit must be executed to save the changes on the database server. （~~在事务开始之前正确设置 'ApplyUpdates'。应用更新后，必须执行提交，将更改保存在数据库服务器上。~~）
225	227
226	228		下面是更改表中数据的示例，sending the changes to the server and comitting the transaction.（~~发送变更到服务器。~~）
227	229
228	230		``` pascal
229	231		Program EditData;
230	232
231	233		var
232	234		AConnection : TSQLConnection;
233	235		ATransaction : TSQLTransaction;
234	236		Query : TSQLQuery;
235	237
236	238		begin
237	239		CreateConnection;
238	240		CreateTransaction;
239	241		AConnection.Transaction := ATransaction;
240	242		Query := GetQuery;
241	243		Query.SQL.Text := 'select * from tblNames';
242	244		Query.Open;
243	245		Query.Edit;
244	246		Query.FieldByName('NAME').AsString := 'Edited name';
245	247		Query.Post;
246	248		Query.UpdateMode := upWhereAll;
247	249		Query.ApplyUpdates;
248	250		AConnection.Transaction.Commit;
249	251		Query.Free;
250	252		ATransaction.Free;
251	253		AConnection.Free;
252	254		end.
253	255		```
254	256
255	257		探讨 'UpdateMode' 请继续阅读。
256	258
257	259		## 如何将SqlDB更改发送到服务器
258	260
259	261		In the code example in #How to change data in a table?, you will find the line
260	262
261	263		``` pascal
262	264		Query.UpdateMode := upWhereAll;
263	265		```
264	266
265	267		without explanation of what it does. The best way to find out what that line does is to leave it out. If you leave out the statement and the followed this howto precisely, then you will receive the following error message:
266	268
267		-	~~`No update query specified and failed to generate one. (No fields for inclusion in where statement found)`~~
	269	+	```text
	270	+	No update query specified and failed to generate one. (No fields for inclusion in where statement found)
	271	+	```
268	272
269	273		To understand what went wrong, you must understand how changes are sent to the database server. The only way to get data in a SQL server is by executing SQL queries. SQL has three types of queries for three different ways of manupulating a record. To create a new record, change or delete a record insert, update and delete statements are executed respectively. An update statement may be as follows:
270	274
271	275		``` sql
272	276		update TBLNAMES set NAME='Edited name' where ID=1;
273	277		```
274	278
275	279		To send a change to the database server, Sqldb must assemble an update query. To assemble the query, three things are needed:
276	280
277	281		The name of the table
278	282		The table name is retrieved from parsing the select query, although this doesn't always work.
279	283
280	284		`UPDATE` or `INSERT` clause
281	285		These contain the fields that must be changed.
282	286
283	287		`WHERE` clause
284	288		This contains the fields that determine which records should be changed.
285	289
286	290		Every field (each TField in Fields) has a ProviderFlags property. Only fields with pfInUpdate in ProviderFlags will be used in the update or insert cluase of a query. By default all fields have pfInUpdate set in their ProviderFlags property.
287	291
288	292		Which fields are used in the `WHERE` clause depends on the UpdateMode property of the query and the ProviderFlags property of the fields. Fields with pfInkey in their ProviderFlags are always used in the `WHERE` clause. A field will have the pfInKey flag set automatically if the field is part of the primary key of the table and 'TSQLQuery.UsePrimaryKeyAsKey' returns 'True'.
289	293
290	294		The default value for UpdateMode of the query is upWhereKeyOnly. In this update mode only fields with pfInkey in their ProviderFlags property are used in the `WHERE` clause. If none of the fields have their pfInKey flag set, then no fields are available for the `WHERE` clause and the error message from the beginning of this section will be returned. You can solve the issue by:
291	295
292	296		- Adding a primary key to the table and set TSQLQuery.UsePrimaryKeyAsKey to 'True', or
293	297		- Setting the pfInkey flag for one or more fields in code.
294	298
295	299		The UpdateMode property knows two more possible values. 'upWhereAll' can be used to add all fields with the 'pfInWhere' flag set to the `WHERE` clause. By default all fields have this flag set. 'upWhereChanged' can be used to add only those fields that have the 'pfInWhere' flag set and that are changed in the current record.
296	300
297	301		## 如何使用 TSQLQuery 执行查询
298	302
299	303		下一个语句返回数据集(查看 #如何读取表中数据) SQL中有不返回数据的语句。如 `INSERT`, `UPDATE` 和 `DELETE` 语句没有返回数据。这些语句可以使用 TSQLConnection.ExecuteDirect，但 TSQLQuery 也可以使用。如果你不希望返回数据，则需要使用 TSQLQuery.ExecSQL，而不是使用 TSQLQuery.Open。正如前面提到的，TSQLQuery.Open 打开 SQL 语句并返回数据集。
300	304
301	305		下面的程序将创建一个表，并使用 TSQLQuery 插入两条记录。
302	306
303	307		``` pascal
304	308		procedure CreateTable;
305	309
306	310		var
307	311		Query : TSQLQuery;
308	312
309	313		begin
310	314		Query := GetQuery;
311	315		Query.SQL.Text := 'create table TBLNAMES (ID integer, NAME varchar(40));';
312	316		Query.ExecSQL;
313	317
314	318		Query.SQL.Text := 'insert into TBLNAMES (ID,NAME) values (1,''Name1'');';
315	319		Query.ExecSQL;
316	320
317	321		Query.SQL.Text := 'insert into TBLNAMES (ID,NAME) values (2,''Name2'');';
318	322		Query.ExecSQL;
319	323
320	324		Query.Close;
321	325		Query.Free;
322	326		end;
323	327		```
324	328
325	329		## 如何在查询中使用参数
326	330
327	331		在#如何使用 TSQLQuery 执行查询中，相同的查询被使用两次，不过是插入的值不同，一个更好的方法是，在查询中使用参数。
328	332
329	333		查询参数语法在各数据库系统中不同，但不同处由 TSQLQuery 处理，在冒号后面使用参数名称，以替换查询词。如：
330	334
331	335		``` pascal
332	336		Query.SQL.Text := 'insert into TBLNAMES (ID,NAME) values (:ID,:NAME);';
333	337		```
334	338
335	339		查询将创建2个参数，'ID' 和 'NAME'。确定参数，查询被解析为TSQLQuery.SQL分配或修改。所有现有的参数都将被删除，并且新的参数将被添加到 'TSQLQuery.Params' 属性。赋值给参数，类似于赋值给数据集中的一个字段：
336	340
337	341		``` pascal
338	342		Query.Params.ParamByName('Name').AsString := 'Name1'
339	343		```
340	344
341	345		;
342	346
343	347		You can't tell from the query what kind of data must be stored in the parameter. (~~你不能告诉查询什么类型的数据必须存储什么的参数。~~)通过分配使用 '.AsString'，则该参数指定数据类型为 'ftString'。你可以直接通过设置 'DataType' 属性来确定数据类型。不正确的数据类型分配给参数，将在打开或执行查询时引发异常。查看 [[Database field type/zh CN\|数据库字段类型]] 的详细信息。
344	348
345	349		### Select 查询
346	350
347	351		带查询参数会是这样：
348	352
349	353		``` pascal
350	354		Query.SQL.Text := 'select ID,NAME from TBLNAMES where NAME = '''+Edit1.Text+''' ORDER BY NAME ';
351	355		```
352	356
353	357		要像这样：
354	358
355	359		``` pascal
356	360		Query.SQL.Text := 'select ID,NAME from TBLNAMES where NAME = :NAMEPARAM ORDER BY NAME ';
357	361		Query.Params.ParamByName('NAMEPARAM').AsString := Edit1.Text;
358	362		```
359	363
360	364		### 示例
361	365
362	366		下面的示例用于创建相同的表，现在使用查询参数：
363	367
364	368		``` pascal
365	369		procedure CreateTableUsingParameters;
366	370
367	371		var
368	372		Query : TSQLQuery;
369	373
370	374		begin
371	375		Query := GetQuery;
372	376		Query.SQL.Text := 'create table TBLNAMES (ID integer, NAME varchar(40));';
373	377		Query.ExecSQL;
374	378
375	379		Query.SQL.Text := 'insert into TBLNAMES (ID,NAME) values (:ID,:NAME);';
376	380
377	381		Query.Params.ParamByName('ID').AsInteger := 1;
378	382		Query.Params.ParamByName('NAME').AsString := 'Name1';
379	383		Query.ExecSQL;
380	384
381	385		Query.Params.ParamByName('ID').AsInteger := 2;
382	386		Query.Params.ParamByName('NAME').AsString := 'Name2';
383	387		Query.ExecSQL;
384	388
385	389		Query.Close;
386	390		Query.Free;
387	391		end;
388	392		```
389	393
390	394		Notice that this example requires more code than the example without the parameters. Then what is the use of using parameters? Speed is one of the reasons. The example with parameters is faster because the query is parsed only once. TSQLQuery only parses the query once, but also the database server parses the query only once. Most database systems support parameters. Whenever a query is used more than once with different values for the parameter each time, then the database server only parses the query and plans the query only once making execution considerably faster.
391	395
392	396		Use 'TSQLQuery.Prepare' to determine the moment the query is parsed and planned by the database server. Use 'TSQLQuery.UnPrepare' to make sure the query is parsed and planned every time by the data server.
393	397
394	398		使用预处理语句的另一个原因是预防[SQL注入](http://zh.wikipedia.org/wiki/SQL_Injection) （参见 [[Secure programming\|安全编程]]）。
395	399
396	400		最后，在某些情况下它只是简化了代码。
397	401
398	402		## 故障排除:TSQLConnection日志
399	403
400	404		You can let a TSQLConnection log what it is doing. This can be handy to see what your Lazarus program sends to the database exactly, to debug the database components themselves and perhaps to optimize your queries. NB: if you use prepared statements/parametrized queries (see section above), the parameters are often sent in binary by the TSQLConnection descendent (e.g. TIBConnection), so you can't just copy/paste the logged SQL into a database query tool.
401	405
402	406		不管怎么说，连接日志在程序设计时会对你有很大的帮助。
403	407
404	408		替代方案：
405	409
406	410		1. FPC (和 Lazarus)调试已启用的话，你可使用调试器来逐步分析数据库代码。
407	411		2. 如果你使用 ODBC （至少在 Windows 上），你可以在 ODBC 控制面板中启用tracelog 输出。
408	412		3. 大多数据库允许你监视从某个 IP 地址/连接发送的所有语句。
409	413
410	414		如果你使用 TSQLConnection 日志，有2件事需要注意：
411	415
412	416		1. 哪些事件类型应该作为 TSQLConnection 日志
413	417		2. point TSQLConnection at a function that receives the events and processes them (logs them to file, prints them to screen, etc.).(~~TSQLConnection 在函数中接收事件并处理它们（记录到文件或在屏幕上显示等等）~~)
414	418
415	419		函数类型必须是 TDBLogNotifyEvent（见 sqldb.pp），所以它需要这样的签名：
416	420
417	421		``` pascal
418	422		TDBLogNotifyEvent = Procedure (Sender : TSQLConnection; EventType : TDBEventType; Const Msg : String) of object;
419	423		```
420	424
421	425		### FPC (或:手动方式)
422	426
423	427		下面的代码可以说明这个问题：
424	428
425	429		``` pascal
426	430		uses
427	431		...
428	432		TSQLConnection, //或子对象，像 TIBConnection, TMSSQLConnection
429	433		...
430	434		var
431	435		type
432	436		TMyApplication = class(TCustomApplication); // 这是我们的应用程序，使用连接
433	437		...
434	438		private
435	439		// 这个例子事件都保存在这个 stringlist 里:
436	440		FConnectionLog: TStringList;
437	441		...
438	442		protected
439	443		// 这个过程将接收连接记录事件:
440	444		procedure GetLogEvent(Sender: TSQLConnection; EventType: TDBEventType; Const Msg : String);
441	445		...
442	446		procedure TMyApplication.GetLogEvent(Sender: TSQLConnection;
443	447		EventType: TDBEventType; const Msg: String);
444	448		// 这个过程用于为 TSQLConnection 保存收到的日志信息
445	449		// FConnectionLog 是 stringlist 类型
446	450		var
447	451		Source: string;
448	452		begin
449	453		// 正确的对齐...
450	454		case EventType of
451	455		detCustom: Source:='Custom: ';
452	456		detPrepare: Source:='Prepare: ';
453	457		detExecute: Source:='Execute: ';
454	458		detFetch: Source:='Fetch: ';
455	459		detCommit: Source:='Commit: ';
456	460		detRollBack: Source:='Rollback:';
457	461		else Source:='Unknown event. Please fix program code.';
458	462		end;
459	463		FConnectionLog.Add(Source + ' ' + Msg);
460	464		end;
461	465
462	466		...
463	467		// 需要告诉我们 TSQLConnection 日志:
464	468		FConnection.LogEvents:=LogAllEvents; //= [detCustom, detPrepare, detExecute, detFetch, detCommit, detRollBack]
465	469		// ... 并且该程序应发送的事件
466	470		FConnection.OnLog:=@Self.GetLogEvent;
467	471		...
468	472		// 现在我们的 FConnectionLog 会存满了日志信息。
469	473		```
470	474
471	475		You can also use TSQLConnection's GlobalDBLogHook instead to log everything from multiple connections.(~~你还可以使用 TSQLConnection 的 GlobalDBLogHook，而不是从多个连接记录所有。~~)
472	476
473	477		### Lazarus (或:快捷方式)
474	478
475	479		最后，上述是 FPC 的处理方式；如果使用 Lazarus，更便捷的方式是指定 TSQLConnection 的 OnLog 事件处理程序。
476	480
477	481		## 参见
478	482
479	483		- [[Working With TSQLQuery]]
480	484
481	485		---
482	486		From the Free Pascal wiki, page "SqlDBHowto/zh CN", as it stood on 2020-02-27 after a change by Trev, 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