SQLdb Tutorial0/ja: 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		この記事は、SQLdb Tutorial 1, 2 と 3 で使うためのサンプルデータとサンプルテーブルを、データベース環境と同時に設定するためのものです。
4	4
5	5		このページはとても長い文章からなっていますが、異なるデータベースシステムにおける説明を含んでいますので、必要な個所のみ読んでください。
6	6
7	7		もしもあなたがすぐにでもチュートリアルを実行したいのなら、Firebird サーバーと下記のサンプルデータベースをインストールすることをお勧めします。
8	8
9	9		## 必要条件
10	10
11	11		このチュートリアルは、最近の Lazarus のバージョンを用いることを基本に記述されています(Laz 1.0)。; より古いバージョンの Lazarus 0.9.30. でも動くはずです。
12	12
13	13		さらに、FirebirdなどのSQL / リレーショナルデータベースが必要です（可能であればバージョン2.0以降）。標準設定（例えば、ユーザー名がSYSDBAでパスワードがmasterkey）を使用し、employeeサンプルデータベースがインストールされていることが望ましいです。
14	14
15	15		別のデータベース（たとえばMicrosoft SQL Server、MySQL、PostgreSQL、Oracle、SQLite、Sybase ASE、またはODBCを使用した他のデータベース）を使用することもできます。必要なデータベースクライアントライブラリがインストールされていることを確認してください（データベースに関するさまざまなウィキ記事を参照してください）。Firebirdまたはemployee.fdbがインストールされていない場合は、以下のセクション「Firebirdやemployee.fdbがインストールされていない場合」を参照してください。
16	16
17	17		## Firebird のインストール
18	18
19	19		まだFirebirdやチュートリアルで使用されるサンプルデータベースをインストールしていない場合は、以下の手順を参照してください。
20	20
21	21		### Firebird client/server のインストール
22	22
23	23		何もインストールしていない場合は、www.firebirdsql.orgからインストーラーをダウンロードして実行し、サーバーをインストールします（たとえば、「32-bit Classic、Superclassic＆Superserver」）。
24	24
25	25		### WindowsでのFirebird database ライブラリ
26	26
27	27		インストール後、WindowsではFirebirdクライアントDLLが存在している必要があります:
28	28
29	29		- システムディレクトリにある可能性があります（すべてのプログラムで利用可能）。
30	30		- Lazarusディレクトリにもある可能性があります（IDE内でのデザイン時サポートのため）し、実行可能ファイルがある出力ディレクトリにもある可能性があります（コンパイルされたプログラムを実行するため）。
31	31
32	32		Firebirdサーバーをインストールしていない場合、クライアントDLLを手に入れる簡単な方法は次のとおりです：Firebird Embedded 2.5を以下からダウンロードしてください [1](http://www.firebirdsql.org/en/firebird-2-5/) アプリケーションディレクトリへこれらのファイルを伸長してください:
33	33
34	34		``` bash
35	35		fbclient.dll #サーバを使うときのみ
36	36		#もしくは
37	37		fbembed.dll #組み込み用途のみ
38	38		firebird.msg
39	39		ib_util.dll
40	40		icudt30.dll
41	41		icuin30.dll
42	42		icuuc30.dll
43	43		Microsoft.VC80.CRT.manifest
44	44		msvcp80.dll
45	45		msvcr80.dll
46	46		```
47	47
48	48		Rename fbembed.dllを to fbclient.dll にリネームしてください(このファイル名は通常のクライアントサーバの Firebird クライアントです - 古いLazarus/FPCで用いる際の助けとなります)。組み込みのFirebird DLLは通常のFirebirdクライアントとしても機能することができます。
49	49
50	50		プロジェクトディレクトリにemployee.fdbデータベースがあることを確認してください。それをfirebird 2.5サーバーのexamples/empbuild/ディレクトリからコピーすることができます。
51	51
52	52		最後に、プロジェクトを1度コンパイルして（たとえ空であっても）出力ディレクトリを作成し、そのディレクトリにdllファイルとemployee.fdbデータベースをコピーしてください。
53	53
54	54		### 他のシステムにおける Firebird データベースライブラリ
55	55
56	56		Linux/OSXでは、Firebirdクライアント共有ライブラリも必要です。 Linuxでは、Firebirdクライアントパッケージを取得するためにディストリビューションのプログラムを使用できます。たとえば、Debianでは以下のようにします：
57	57
58	58		``` bash
59	59		aptitude install libfbclient2 firebird-dev #FPC 2.6とそれ以下はlibfbclient.soを探しに行くので、devバージョンが必要ですlibfbclient.so
60	60		```
61	61
62	62		## Firebird または employee.fdb がインストールされていない?
63	63
64	64		もしも employee サンプルデータベースがインストールされていなかったり、Firebird以外のデータベースを用いる場合、以下にチュートリアルに用いる最小限のテーブルを示します。(注: いくつかのデータベースについての方法を以下に示しています)。
65	65
66	66		### 自動生成
67	67
68	68		これを設定する最も簡単な方法は、システム上に新しい空のデータベースを作成し、次にTSQLScriptSampleサンプル/ユーティリティプログラムでそれに接続することです。このプログラムは、現在のLazarus開発リリースには`./examples/database/tsqlscript`ディレクトリに含まれていますが、以下からダウンロードすることもできます。
69	69
70	70
71	71		<http://svn.freepascal.org/svn/lazarus/trunk/examples/database/tsqlscript/>
72	72
73	73		コンパイルし、プログラムを実行、データソースに接続します:
74	74
75		-	~~<figure>~~
76		-	~~<img src="tsqlscriptsample_connect.png" title="tsqlscriptsample_connect.png" />~~
77		-	~~<figcaption>tsqlscriptsample_connect.png</figcaption>~~
78		-	~~</figure>~~
	75	+	![](/wiki-images/6/6e/Tsqlscriptsample_connect.png)
79	76
80	77		そしてボタン、Copy table creation script をクリックし、Run scriptを実行します:
81	78
82		-	~~<figure>~~
83		-	~~<img src="tsqlscriptsample_runfirstscript.png" title="tsqlscriptsample_runfirstscript.png" />~~
84		-	~~<figcaption>tsqlscriptsample_runfirstscript.png</figcaption>~~
85		-	~~</figure>~~
	79	+	![](/wiki-images/a/ab/Tsqlscriptsample_runfirstscript.png)
86	80
87	81		プログラムは成功したことを示すはずです。同様に Copy sample data script と Run script
88	82
89	83		問題が起こった場合には、以下の手動的方法をとることができます。
90	84
91	85		### 手動による生成
92	86
93	87		今後のチュートリアルで用いるために、 CUSTOMER と EMPLOYEE のテーブルを作成します。
94	88
95	89		用いるデータベースのエディタやツールから、以下の SQL コマンドを実行してください。:
96	90
97	91		``` sql
98	92		CREATE TABLE CUSTOMER
99	93		(
100	94		CUST_NO INTEGER NOT NULL,
101	95		CUSTOMER VARCHAR(25) NOT NULL,
102	96		CITY VARCHAR(25),
103	97		COUNTRY VARCHAR(15),
104	98		CONSTRAINT CT_CUSTOMER_PK PRIMARY KEY (CUST_NO)
105	99		);
106	100		```
107	101
108	102		``` sql
109	103		CREATE TABLE EMPLOYEE
110	104		(
111	105		EMP_NO INTEGER NOT NULL,
112	106		FIRST_NAME VARCHAR(15) NOT NULL,
113	107		LAST_NAME VARCHAR(20) NOT NULL,
114	108		PHONE_EXT VARCHAR(4),
115	109		JOB_CODE VARCHAR(5) NOT NULL,
116	110		JOB_GRADE INTEGER NOT NULL,
117	111		JOB_COUNTRY VARCHAR(15) NOT NULL,
118	112		SALARY NUMERIC(10,2) NOT NULL,
119	113		CONSTRAINT CT_EMPLOYEE_PK PRIMARY KEY (EMP_NO)
120	114		);
121	115		```
122	116
123	117		データベース上で確認できるように、いくつかのデータを入れておきます。まずは、クライアントのデータです。:
124	118
125	119		``` sql
126	120		INSERT INTO CUSTOMER (CUST_NO, CUSTOMER, CITY, COUNTRY) VALUES (1, 'Michael Design', 'San Diego', 'USA');
127	121		INSERT INTO CUSTOMER (CUST_NO, CUSTOMER, CITY, COUNTRY) VALUES (2, 'VC Technologies', 'Dallas', 'USA');
128	122		INSERT INTO CUSTOMER (CUST_NO, CUSTOMER, CITY, COUNTRY) VALUES (3, 'Klämpfl, Van Canneyt', 'Boston', 'USA');
129	123		INSERT INTO CUSTOMER (CUST_NO, CUSTOMER, CITY, COUNTRY) VALUES (4, 'Felipe Bank', 'Manchester', 'England');
130	124		INSERT INTO CUSTOMER (CUST_NO, CUSTOMER, CITY, COUNTRY) VALUES (5, 'Joost Systems, LTD.', 'Central Hong Kong', 'Hong Kong');
131	125		INSERT INTO CUSTOMER (CUST_NO, CUSTOMER, CITY, COUNTRY) VALUES (6, 'Van der Voort Int.', 'Ottawa', 'Canada');
132	126		INSERT INTO CUSTOMER (CUST_NO, CUSTOMER, CITY, COUNTRY) VALUES (7, 'Mrs. Mauvais', 'Pebble Beach', 'USA');
133	127		INSERT INTO CUSTOMER (CUST_NO, CUSTOMER, CITY, COUNTRY) VALUES (8, 'Asinine Vacation Rentals', 'Lihue', 'USA');
134	128		INSERT INTO CUSTOMER (CUST_NO, CUSTOMER, CITY, COUNTRY) VALUES (9, 'Fax', 'Turtle Island', 'Fiji');
135	129		INSERT INTO CUSTOMER (CUST_NO, CUSTOMER, CITY, COUNTRY) VALUES (10, 'FPC Corporation', 'Tokyo', 'Japan');
136	130		INSERT INTO CUSTOMER (CUST_NO, CUSTOMER, CITY, COUNTRY) VALUES (11, 'Dynamic Intelligence Corp', 'Zurich', 'Switzerland');
137	131		INSERT INTO CUSTOMER (CUST_NO, CUSTOMER, CITY, COUNTRY) VALUES (12, '3D-Pad Corp.', 'Paris', 'France');
138	132		INSERT INTO CUSTOMER (CUST_NO, CUSTOMER, CITY, COUNTRY) VALUES (13, 'Swen Export, Ltd.', 'Milan', 'Italy');
139	133		INSERT INTO CUSTOMER (CUST_NO, CUSTOMER, CITY, COUNTRY) VALUES (14, 'Graeme Consulting', 'Brussels', 'Belgium');
140	134		INSERT INTO CUSTOMER (CUST_NO, CUSTOMER, CITY, COUNTRY) VALUES (15, 'Klenin Inc.', 'Den Haag', 'Netherlands');
141	135		```
142	136
143	137		つぎに、被雇用者のデータです。:
144	138
145	139		``` sql
146	140		INSERT INTO EMPLOYEE (emp_no, first_name, last_name, phone_ext, job_code, job_grade,
147	141		job_country, salary)
148	142		VALUES (1,'William','Shatner','1702','CEO',1,'USA',48000);
149	143		INSERT INTO EMPLOYEE (emp_no, first_name, last_name, phone_ext, job_code, job_grade,
150	144		job_country, salary)
151	145		VALUES (2,'Ivan','Rzeszow','9802','Eng',2,'Russia',38000);
152	146		INSERT INTO EMPLOYEE (emp_no, first_name, last_name, phone_ext, job_code, job_grade,
153	147		job_country, salary)
154	148		VALUES (3,'Erin','Powell','1703','Admin',2,'USA',45368);
155	149		```
156	150
157	151		データベースを生成し、テーブルを生成し、データをあなたのデータベース環境に入力してください。
158	152
159	153		### SQLite
160	154
161	155		SQLite を使う場合、sqlite の executable を実行することで、上記のデータベースをあなたのプロジェクトディレクトリに作成できます。:
162	156
163	157		``` bash
164	158		sqlite employee.sqlite
165	159		```
166	160
167	161		次に、上記 CREATE TABLE と INSERT 宣言をコピー＆ペーストしてください。
168	162
169	163		正しいデータが入っているかどうかをテストするには、以下のクエリを入力します。:
170	164
171	165		``` SQL
172	166		select * from customer;
173	167		```
174	168
175	169		セッションは以下のコマンドで終了できます。
176	170
177	171		``` SQL
178	172		.quit
179	173		```
180	174
181	175		以上より、プロジェクトのディレクトリに、 employee.sqlite というファイルが作られているはずです。
182	176
183	177		必要とされる sqlite の dll/so がインストールされていることを確認しておいてください。 - 例えば、Windows であれば sqlite3.dll が以下のディレクトリにあるはずです。
184	178
185	179		- あなたの Lazarus とプロジェクト出力フォルダまたは、
186	180		- あなたの system ディレクトリ
187	181
188	182		また、あなたが 32-bit sqlite dll を使っている場合、 32-bit の lazarus を使う必要があります。
189	183
190	184		あなたのプロジェクトファイルをコンパイル(それが空のプロジェクトでも)して、一旦出力ディレクトリを作ります。そして、(Windows 上で) employee.sqlite データベースと dll をコピーして、そのディレクトリに入れます。
191	185
192	186		### PostgreSQL
193	187
194	188		この節では、Linuxサーバとシェルが使われていると仮定します; 例えばpgadminといったGUI ツールとWindowsでも似たような手順でできるでしょう。
195	189
196	190		サーバにログインし、postgresアカウントに切り替えます
197	191
198	192		``` bash
199	193		su - postgres -c psql # 直ちにpsql SQLインタープリタを起動します
200	194		```
201	195
202	196		データベースとテーブルのためにユーザーを作ります
203	197
204	198		``` SQL
205	199		CREATE USER employee WITH PASSWORD 'hellopassword'; -- of course, adjust password to taste
206	200		-- 'CREATE ROLE'といったようなメッセージが現れ成功したことがわかります。
207	201		-- 後にパスワードを変更するには、以下のようなコマンドで行えます。
208	202		-- ユーザーemployeeにパスワード '<newpasswordhere>' を与えます;
209	203
210	204		-- パスワードを期限切れにしないため。もしよりセキュリティを望むのであれば、ここは飛ばしてください:
211	205		ALTER USER employee VALID UNTIL 'infinity'; --パスワードは期限切れにならなりません
212	206
213	207		-- ここで、少し、セキュリティを厳しくする
214	208		-- ユーザーにデータベースや他のユーザーを作ることを許しません:
215	209		ALTER USER employee NOCREATEDB NOCREATEUSER; --オブジェクト作成を制限します
216	210		-- 'ALTER ROLE'のように、成功するはずです
217	211
218	212		-- employeeデータベースを作る:
219	213		CREATE DATABASE employee;
220	214		-- CREATE DATABASE のように、成功するはずです
221	215
222	216		-- データベース管理者とユーザーにすべての特権を割り当てます:
223	217		GRANT ALL PRIVILEGES ON DATABASE employee; -- TOに対して employeeデータベースの全権限を与えます
224	218		-- GRANTのように成功するはずです
225	219
226	220		-- シリアルデータタイプ-またの名を、autonumber/autoincrementを作ります
227	221		CREATE TABLE customer
228	222		(
229	223		cust_no serial NOT NULL,
230	224		customer character varying(25) NOT NULL,
231	225		city character varying(25),
232	226		country character varying(15),
233	227		CONSTRAINT integ_60 PRIMARY KEY (cust_no )
234	228		);
235	229
236	230		-- 従業員テーブルを作ります:
237	231		CREATE TABLE EMPLOYEE
238	232		(
239	233		EMP_NO SERIAL NOT NULL,
240	234		FIRST_NAME VARCHAR(15) NOT NULL,
241	235		LAST_NAME VARCHAR(20) NOT NULL,
242	236		PHONE_EXT VARCHAR(4),
243	237		JOB_CODE VARCHAR(5) NOT NULL,
244	238		JOB_GRADE INTEGER NOT NULL,
245	239		JOB_COUNTRY VARCHAR(15) NOT NULL,
246	240		SALARY NUMERIC(10,2) NOT NULL,
247	241		CONSTRAINT CT_EMPLOYEE_PK PRIMARY KEY (EMP_NO)
248	242		);
249	243
250	244		-- これで、データを挿入するためINSERTステートメントを、上記の節からコピーアンドペーストします
251	245
252	246		-- 正しいデータが存在するかこのクエリで試験します
253	247		SELECT * FROM customer;
254	248		-- いくつかの顧客データを見ることができます
255	249
256	250		-- psqlから抜けます
257	251		\q
258	252		```
259	253
260	254		これで、postgresにpostgresユーザーとしてシェルログインできます
261	255
262	256		もし、サーバが、開発機ではなく他の機器ならばデータベースにネットワークアクセスできるか確かめてください。postgresドキュメンテーションを参照してください。しかし、このコマンドが動くはずです。
263	257
264	258		``` bash
265	259		# nano (例えば、vim、emacs、joe...)を設定し、状況によりpostgresのバージョンナンバーによりますが、
266	260		nano /etc/postgresql/8.4/main/pg_hba.conf
267	261		```
268	262
269	263		このような行があること、注意:192.168.0.1は実際のLANアドレスに読み替えてください、を確かめて
270	264
271	265		\#md5ハッシュパスワードを用いてローカルネットワークからアクセスを許可するには: host all all 192.168.0.1/24 md5
272	266
273	267		またはより厳しく:
274	268
275	269		\# employeeユーザーによってのみemployeeデータベースにアクセスすることを許すには host employee employee 192.168.0.1/24 md5
276	270
277	271		もしこのような行がなければ最後に加え、エディタを終了します詳細はPostgreSQLに譲ります
278	272
279	273		PostgreSQL設定を読み込みます:
280	274
281	275		``` bash
282	276
283	277		psql
284	278		```
285	279
286	280		then
287	281
288	282		``` SQL
289	283
290	284		SELECT pg_reload_conf(); --設定を読み込み...
291	285		-- ...抜けてシェルに戻ります:
292	286		\q
293	287		```
294	288
295	289		PostgreSQLにログインテストします
296	290
297	291		Note: デフォルトではPostgreSQLはパスワードを許さない、ident/unixドメインソケットでのログインを試みますなので、ホストに対してTCP/IPを強制する:
298	292
299	293		``` bash
300	294		psql -h 127.0.0.1 -d employee -U employee -W # tcp/ip経由でログインします db パスワードを入力してください
301	295		```
302	296
303	297		必要とされるPostgreSQLのdll/so、そして他のライブラリがインストールされていることを確認してください例えば、Windowsではそれらは
304	298
305	299		- Lazarus + project 出力ディレクトリおよび
306	300		- システムディレクトリ
307	301
308	302		の双方にある必要があります。もし、何もなくともprojectを1度出力ディレクトリにコンパイルし、Windowsでは dlls をそのディレクトリにコピーしてください。
309	303
310	304		## 終わりに
311	305
312	306		これで、あなたのデータベースが設定できました。[[SQLdb Tutorial1/ja\|初めての "本当の" チュートリアル]] に進みましょう。
313	307
314	308		## 関連情報
315	309
316	310		- [[SQLdb Tutorial1/ja]]: DB チュートリアルの第一の部分。データベースのデータを、どのように grid に表示させるかを学びます。
317	311		- [[SQLdb Tutorial2/ja]]: DB チュートリアルの第二の部分。データベースのデータの挿入や編集について学びます。
318	312		- [[SQLdb Tutorial3/ja]]: DB チュートリアルの第三の部分。複数のデータベースについてのプログラムやログインフォームの使い方を学びます。
319	313		- [[SQLdb Tutorial4/ja]]: DB チュートリアルの第四の部分。どのようにデータモジュールを用いるかを学びます。
320	314		- [[Lazarus Database Overview/ja]]: Lazarus がサポートしているデータベースについての情報。データベースごとの記述へのリンクを含みます。
321	315		- [[SQLdb Package/ja]]: SQLdb パッケージについての情報
322	316		- [[SQLdb Programming Reference/ja]]: SQLdb データベースコンポーネントの入出力の概要
323	317		- [[SqlDBHowto/ja]]: SQLdb パッケージを用いることについての情報
324	318		- [[Working With TSQLQuery/ja]]: TSQLQuery についての情報
325		-
326		-	\
327	319
328	320		---
329	321		From the Free Pascal wiki, page "SQLdb Tutorial0/ja", as it stood on 2024-03-30 after a change by Ariben, 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