SQLdb Tutorial0/ja: what changed

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

Title: SQLdb Tutorial0/ja

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