blob: a825f6ef05027ec5241f0b117af18d29d337bd42 (plain) (blame)

ofs	hex dump	ascii
0000	2e 68 65 6c 70 20 64 62 6b 69 20 41 75 67 38 35 20 22 44 61 74 61 62 61 73 65 20 4b 65 72 6e 65	.help.dbki.Aug85."Database.Kerne
0020	6c 20 49 6e 74 65 72 66 61 63 65 22 0a 0a 2e 63 65 0a 0a 5c 66 42 44 61 74 61 62 61 73 65 20 4b	l.Interface"...ce..\fBDatabase.K
0040	65 72 6e 65 6c 20 49 6e 74 65 72 66 61 63 65 5c 66 52 0a 0a 2e 73 70 20 33 0a 0a 2e 6e 68 0a 0a	ernel.Interface\fR...sp.3...nh..
0060	4f 76 65 72 76 69 65 77 0a 0a 0a 0a 20 20 20 20 54 68 65 20 44 42 4b 49 20 69 73 20 74 68 65 20	Overview........The.DBKI.is.the.
0080	69 6e 74 65 72 66 61 63 65 20 62 65 74 77 65 65 6e 20 44 42 49 4f 20 61 6e 64 20 74 68 65 20 44	interface.between.DBIO.and.the.D
00a0	42 20 6b 65 72 6e 65 6c 2e 20 20 54 68 65 20 44 42 20 6b 65 72 6e 65 6c 0a 0a 69 73 20 72 65 73	B.kernel...The.DB.kernel..is.res
00c0	70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 61 6c 6c 20 73 74 6f 72 61 67 65 20 6d 61 6e 61 67 65 6d	ponsible.for.all.storage.managem
00e0	65 6e 74 2e 20 20 54 68 65 20 44 42 4b 49 20 69 73 6f 6c 61 74 65 73 20 44 42 49 4f 20 66 72 6f	ent...The.DBKI.isolates.DBIO.fro
0100	6d 20 74 68 65 0a 0a 64 65 74 61 69 6c 73 20 6f 66 20 68 6f 77 20 73 74 6f 72 61 67 65 20 69 73	m.the..details.of.how.storage.is
0120	20 6d 61 6e 61 67 65 64 20 62 79 20 74 68 65 20 44 42 20 6b 65 72 6e 65 6c 2e 20 20 54 68 65 20	.managed.by.the.DB.kernel...The.
0140	44 42 4b 49 20 61 6c 73 6f 20 70 65 72 6d 69 74 73 0a 0a 44 42 49 4f 20 74 6f 20 62 65 20 75 73	DBKI.also.permits..DBIO.to.be.us
0160	65 64 20 74 6f 20 61 63 63 65 73 73 20 61 6e 79 20 73 74 6f 72 61 67 65 20 66 6f 72 6d 61 74 20	ed.to.access.any.storage.format.
0180	6f 72 20 68 6f 73 74 20 64 61 74 61 62 61 73 65 20 73 79 73 74 65 6d 2e 20 20 41 6c 6c 0a 0a 61	or.host.database.system...All..a
01a0	63 63 65 73 73 20 74 6f 20 61 20 64 61 74 61 62 61 73 65 20 69 73 20 76 69 61 20 74 68 65 20 44	ccess.to.a.database.is.via.the.D
01c0	42 4b 49 2c 20 69 2e 65 2e 2c 20 44 42 49 4f 20 61 73 73 75 6d 65 73 20 6e 6f 74 68 69 6e 67 20	BKI,.i.e.,.DBIO.assumes.nothing.
01e0	61 62 6f 75 74 2c 20 66 6f 72 0a 0a 65 78 61 6d 70 6c 65 2c 20 74 68 65 20 61 73 73 6f 63 69 61	about,.for..example,.the.associa
0200	74 69 6f 6e 20 6f 66 20 6c 6f 67 69 63 61 6c 20 64 61 74 61 62 61 73 65 20 6f 62 6a 65 63 74 73	tion.of.logical.database.objects
0220	20 74 6f 20 66 69 6c 65 73 20 6f 72 20 64 69 72 65 63 74 6f 72 69 65 73 2e 0a 0a 0a 0a 54 68 65	.to.files.or.directories.....The
0240	20 44 42 4b 49 20 70 72 6f 76 69 64 65 73 20 61 63 63 65 73 73 20 74 6f 20 61 20 64 61 74 61 62	.DBKI.provides.access.to.a.datab
0260	61 73 65 20 63 6f 6e 73 69 73 74 69 6e 67 20 6f 66 20 61 20 73 65 74 20 6f 66 20 74 61 62 6c 65	ase.consisting.of.a.set.of.table
0280	73 2e 20 20 45 61 63 68 0a 0a 74 61 62 6c 65 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 73 65	s...Each..table.consists.of.a.se
02a0	74 20 6f 66 20 72 65 63 6f 72 64 73 2c 20 61 6c 6c 20 6f 66 20 77 68 69 63 68 20 68 61 76 65 20	t.of.records,.all.of.which.have.
02c0	74 68 65 20 73 61 6d 65 20 73 74 72 75 63 74 75 72 65 2e 20 0a 0a 52 65 63 6f 72 64 73 20 6d 61	the.same.structure....Records.ma
02e0	79 20 62 65 20 61 63 63 65 73 73 65 64 20 65 69 74 68 65 72 20 64 69 72 65 63 74 6c 79 20 76 69	y.be.accessed.either.directly.vi
0300	61 20 61 20 70 6f 69 6e 74 65 72 20 6f 72 20 69 6e 64 65 78 2c 20 6f 72 20 73 65 71 75 65 6e 74	a.a.pointer.or.index,.or.sequent
0320	69 61 6c 6c 79 0a 0a 69 6e 20 65 69 74 68 65 72 20 73 74 6f 72 61 67 65 20 6f 72 64 65 72 20 6f	ially..in.either.storage.order.o
0340	72 20 69 6e 64 65 78 20 6f 72 64 65 72 2e 0a 0a 0a 0a 0a 0a 2e 6b 73 0a 0a 2e 6e 66 0a 0a 09 64	r.index.order........ks...nf...d
0360	69 72 65 63 74 6f 72 79 20 74 61 62 6c 65 0a 0a 09 64 6f 6d 61 69 6e 20 64 65 73 63 72 69 70 74	irectory.table...domain.descript
0380	6f 72 20 74 61 62 6c 65 0a 0a 09 72 65 63 6f 72 64 20 64 65 73 63 72 69 70 74 6f 72 20 74 61 62	or.table...record.descriptor.tab
03a0	6c 65 73 0a 0a 09 69 6e 64 65 78 20 64 65 73 63 72 69 70 74 6f 72 20 74 61 62 6c 65 0a 0a 09 64	les...index.descriptor.table...d
03c0	61 74 61 20 74 61 62 6c 65 73 0a 0a 2e 66 69 0a 0a 2e 73 70 0a 0a 2e 63 65 0a 0a 46 69 67 75 72	ata.tables...fi...sp...ce..Figur
03e0	65 20 31 2e 20 20 4d 61 6a 6f 72 20 43 6f 6d 70 6f 6e 65 6e 74 73 20 6f 66 20 61 20 44 61 74 61	e.1...Major.Components.of.a.Data
0400	62 61 73 65 0a 0a 2e 6b 65 0a 0a 0a 0a 0a 0a 45 61 63 68 20 64 61 74 61 62 61 73 65 20 63 6f 6e	base...ke......Each.database.con
0420	74 61 69 6e 73 20 61 20 73 70 65 63 69 61 6c 20 64 69 72 65 63 74 6f 72 79 20 74 61 62 6c 65 20	tains.a.special.directory.table.
0440	63 6f 6e 74 61 69 6e 69 6e 67 20 61 20 72 65 63 6f 72 64 20 66 6f 72 20 65 61 63 68 0a 0a 74 61	containing.a.record.for.each..ta
0460	62 6c 65 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 20 49 6e 20 61 64 64 69 74 69 6f	ble.in.the.database...In.additio
0480	6e 2c 20 66 6f 72 20 65 61 63 68 20 74 79 70 65 20 6f 66 20 72 65 63 6f 72 64 20 69 6e 20 74 68	n,.for.each.type.of.record.in.th
04a0	65 20 64 61 74 61 62 61 73 65 0a 0a 74 68 65 72 65 20 6d 75 73 74 20 62 65 20 61 20 74 61 62 6c	e.database..there.must.be.a.tabl
04c0	65 20 64 65 66 69 6e 69 6e 67 20 74 68 65 20 72 65 63 6f 72 64 20 74 79 70 65 2e 20 20 54 68 65	e.defining.the.record.type...The
04e0	72 65 20 69 73 20 61 6e 20 65 6e 74 72 79 20 69 6e 20 74 68 65 0a 0a 69 6e 64 65 78 20 74 61 62	re.is.an.entry.in.the..index.tab
0500	6c 65 20 66 6f 72 20 65 61 63 68 20 69 6e 64 65 78 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73	le.for.each.index.in.the.databas
0520	65 2e 20 20 41 20 66 69 6e 61 6c 20 73 79 73 74 65 6d 20 64 65 66 69 6e 65 64 20 74 61 62 6c 65	e...A.final.system.defined.table
0540	20 69 73 0a 0a 74 68 65 20 64 6f 6d 61 69 6e 20 64 65 66 69 6e 69 74 69 6f 6e 20 74 61 62 6c 65	.is..the.domain.definition.table
0560	2c 20 75 73 65 64 20 74 6f 20 64 65 66 69 6e 65 20 74 68 65 20 64 6f 6d 61 69 6e 73 20 75 70 6f	,.used.to.define.the.domains.upo
0580	6e 20 77 68 69 63 68 20 61 74 74 72 69 62 75 74 65 73 0a 0a 61 72 65 20 64 65 66 69 6e 65 64 20	n.which.attributes..are.defined.
05a0	69 6e 20 61 20 72 65 63 6f 72 64 20 74 79 70 65 20 64 65 66 69 6e 69 74 69 6f 6e 2e 0a 0a 0a 0a	in.a.record.type.definition.....
05c0	41 6c 6c 20 61 63 63 65 73 73 20 74 6f 20 74 68 65 20 66 69 65 6c 64 73 20 6f 66 20 61 20 72 65	All.access.to.the.fields.of.a.re
05e0	63 6f 72 64 20 62 79 20 44 42 49 4f 20 69 73 20 6d 65 64 69 61 74 65 64 20 62 79 20 74 68 65 20	cord.by.DBIO.is.mediated.by.the.
0600	44 42 20 6b 65 72 6e 65 6c 2e 20 20 49 6e 0a 0a 70 61 72 74 69 63 75 6c 61 72 2c 20 44 42 49 4f	DB.kernel...In..particular,.DBIO
0620	20 68 61 73 20 6e 6f 20 6b 6e 6f 77 6c 65 64 67 65 20 6f 66 20 74 68 65 20 69 6e 74 65 72 6e 61	.has.no.knowledge.of.the.interna
0640	6c 20 73 74 6f 72 61 67 65 20 66 6f 72 6d 61 74 20 6f 66 20 61 20 66 69 65 6c 64 20 69 6e 0a 0a	l.storage.format.of.a.field.in..
0660	61 20 72 65 63 6f 72 64 2e 20 20 44 42 49 4f 20 6d 61 6e 69 70 75 6c 61 74 65 73 20 74 68 65 20	a.record...DBIO.manipulates.the.
0680	76 61 6c 75 65 73 20 6f 66 20 66 69 65 6c 64 73 20 75 73 69 6e 67 20 74 68 65 20 6d 61 63 68 69	values.of.fields.using.the.machi
06a0	6e 65 20 64 65 70 65 6e 64 65 6e 74 0a 0a 53 50 50 20 64 61 74 61 74 79 70 65 73 20 77 68 69 63	ne.dependent..SPP.datatypes.whic
06c0	68 20 6d 61 79 20 62 65 20 71 75 69 74 65 20 64 69 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 74 68	h.may.be.quite.different.from.th
06e0	65 20 69 6e 74 65 72 6e 61 6c 20 73 74 6f 72 61 67 65 20 66 6f 72 6d 61 74 73 0a 0a 28 65 2e 67	e.internal.storage.formats..(e.g
0700	2e 2c 20 62 69 74 20 66 69 65 6c 64 20 69 6e 74 65 67 65 72 2c 20 62 79 74 65 20 70 61 63 6b 65	.,.bit.field.integer,.byte.packe
0720	64 20 41 53 43 49 49 20 6f 72 20 45 42 43 44 49 43 20 63 68 61 72 61 63 74 65 72 2c 20 49 45 45	d.ASCII.or.EBCDIC.character,.IEE
0740	45 20 66 6c 6f 61 74 69 6e 67 0a 0a 70 6f 69 6e 74 2c 20 46 49 54 53 20 63 61 72 64 69 6d 61 67	E.floating..point,.FITS.cardimag
0760	65 2c 20 65 74 63 2e 29 2e 20 20 54 68 65 20 64 61 74 61 74 79 70 65 20 75 73 65 64 20 62 79 20	e,.etc.)...The.datatype.used.by.
0780	44 42 49 4f 20 74 6f 20 61 63 63 65 73 73 20 61 20 70 61 72 74 69 63 75 6c 61 72 0a 0a 66 69 65	DBIO.to.access.a.particular..fie
07a0	6c 64 20 69 73 20 68 6f 77 65 76 65 72 20 66 69 78 65 64 20 61 74 20 72 65 63 6f 72 64 20 64 65	ld.is.however.fixed.at.record.de
07c0	66 69 6e 69 74 69 6f 6e 20 74 69 6d 65 2c 20 68 65 6e 63 65 20 74 68 65 20 44 42 20 6b 65 72 6e	finition.time,.hence.the.DB.kern
07e0	65 6c 20 6e 65 65 64 20 6e 6f 74 0a 0a 62 65 20 70 72 65 70 61 72 65 64 20 74 6f 20 70 65 72 66	el.need.not..be.prepared.to.perf
0800	6f 72 6d 20 61 72 62 69 74 72 61 72 79 20 72 75 6e 74 69 6d 65 20 64 61 74 61 74 79 70 65 20 63	orm.arbitrary.runtime.datatype.c
0820	6f 6e 76 65 72 73 69 6f 6e 73 2e 0a 0a 0a 0a 2e 6e 68 0a 0a 44 61 74 61 62 61 73 65 20 4d 61 6e	onversions......nh..Database.Man
0840	61 67 65 6d 65 6e 74 20 4f 70 65 72 61 74 6f 72 73 0a 0a 2e 6e 68 20 32 0a 0a 47 65 6e 65 72 61	agement.Operators...nh.2..Genera
0860	6c 0a 0a 0a 0a 20 20 20 20 41 20 64 61 74 61 62 61 73 65 20 6d 75 73 74 20 62 65 20 6f 70 65 6e	l........A.database.must.be.open
0880	65 64 20 6f 72 20 63 72 65 61 74 65 64 20 62 65 66 6f 72 65 20 69 74 20 63 61 6e 20 62 65 20 61	ed.or.created.before.it.can.be.a
08a0	63 63 65 73 73 65 64 2e 20 20 41 6c 6c 0a 0a 61 63 63 65 73 73 20 74 6f 20 61 6e 20 6f 70 65 6e	ccessed...All..access.to.an.open
08c0	20 64 61 74 61 62 61 73 65 20 69 73 20 76 69 61 20 61 20 64 61 74 61 62 61 73 65 20 64 65 73 63	.database.is.via.a.database.desc
08e0	72 69 70 74 6f 72 20 72 65 74 75 72 6e 65 64 20 77 68 65 6e 20 74 68 65 0a 0a 64 61 74 61 62 61	riptor.returned.when.the..databa
0900	73 65 20 69 73 20 6f 70 65 6e 65 64 20 6f 72 20 63 72 65 61 74 65 64 2e 20 20 4d 75 6c 74 69 70	se.is.opened.or.created...Multip
0920	6c 65 20 64 61 74 61 62 61 73 65 73 20 6d 61 79 20 62 65 20 61 63 63 65 73 73 65 64 0a 0a 73 69	le.databases.may.be.accessed..si
0940	6d 75 6c 74 61 6e 65 6f 75 73 6c 79 2e 0a 0a 2e 6c 73 0a 0a 2e 6c 73 20 6f 0a 0a 43 72 65 61 74	multaneously....ls...ls.o..Creat
0960	65 20 61 20 6e 65 77 2c 20 65 6d 70 74 79 20 64 61 74 61 62 61 73 65 2e 0a 0a 2e 6c 65 0a 0a 2e	e.a.new,.empty.database....le...
0980	6c 73 20 6f 0a 0a 4f 70 65 6e 20 61 20 64 61 74 61 62 61 73 65 2e 0a 0a 2e 6c 65 0a 0a 2e 6c 73	ls.o..Open.a.database....le...ls
09a0	20 6f 0a 0a 43 6c 6f 73 65 20 61 20 64 61 74 61 62 61 73 65 2e 0a 0a 2e 6c 65 0a 0a 2e 6c 73 20	.o..Close.a.database....le...ls.
09c0	6f 0a 0a 44 65 6c 65 74 65 20 61 20 64 61 74 61 62 61 73 65 2e 0a 0a 2e 6c 65 0a 0a 2e 6c 73 20	o..Delete.a.database....le...ls.
09e0	6f 0a 0a 53 6f 72 74 20 61 20 74 61 62 6c 65 20 69 6e 20 69 6e 64 65 78 20 6f 72 64 65 72 2e 0a	o..Sort.a.table.in.index.order..
0a00	0a 2e 6c 65 0a 0a 2e 6c 73 20 6f 0a 0a 51 75 65 72 79 20 44 42 20 6b 65 72 6e 65 6c 20 63 61 70	..le...ls.o..Query.DB.kernel.cap
0a20	61 62 69 6c 69 74 69 65 73 2e 0a 0a 2e 6c 65 0a 0a 2e 6c 65 0a 0a 2e 6e 68 20 32 0a 0a 52 65 63	abilities....le...le...nh.2..Rec
0a40	6f 72 64 20 44 65 66 69 6e 69 74 69 6f 6e 0a 0a 0a 0a 20 20 20 20 41 20 6e 65 77 20 72 65 63 6f	ord.Definition........A.new.reco
0a60	72 64 20 74 79 70 65 20 69 73 20 64 65 66 69 6e 65 64 20 62 79 20 63 72 65 61 74 69 6e 67 20 61	rd.type.is.defined.by.creating.a
0a80	20 72 65 63 6f 72 64 20 64 65 66 69 6e 69 74 69 6f 6e 20 74 61 62 6c 65 20 61 6e 64 0a 0a 69 6e	.record.definition.table.and..in
0aa0	73 65 72 74 69 6e 67 20 6f 6e 65 20 72 65 63 6f 72 64 20 69 6e 20 74 68 65 20 74 61 62 6c 65 20	serting.one.record.in.the.table.
0ac0	66 6f 72 20 65 61 63 68 20 66 69 65 6c 64 20 69 6e 20 74 68 65 20 6e 65 77 20 72 65 63 6f 72 64	for.each.field.in.the.new.record
0ae0	20 74 79 70 65 2e 0a 0a 54 68 65 20 72 65 63 6f 72 64 20 74 79 70 65 20 66 6f 72 20 61 20 72 65	.type...The.record.type.for.a.re
0b00	63 6f 72 64 20 64 65 66 69 6e 69 74 69 6f 6e 20 74 61 62 6c 65 20 69 73 20 69 74 73 65 6c 66 20	cord.definition.table.is.itself.
0b20	64 65 66 69 6e 65 64 20 62 79 20 61 20 74 61 62 6c 65 0a 0a 77 68 69 63 68 20 69 73 20 69 6e 69	defined.by.a.table..which.is.ini
0b40	74 69 61 6c 69 7a 65 64 20 62 79 20 44 42 49 4f 20 77 68 65 6e 20 74 68 65 20 64 61 74 61 62 61	tialized.by.DBIO.when.the.databa
0b60	73 65 20 69 73 20 63 72 65 61 74 65 64 2e 20 20 41 20 72 65 63 6f 72 64 0a 0a 64 65 66 69 6e 69	se.is.created...A.record..defini
0b80	74 69 6f 6e 20 74 61 62 6c 65 20 69 73 20 61 63 63 65 73 73 65 64 20 75 73 69 6e 67 20 74 68 65	tion.table.is.accessed.using.the
0ba0	20 73 74 61 6e 64 61 72 64 20 72 65 63 6f 72 64 20 61 63 63 65 73 73 20 65 6e 74 72 79 20 70 6f	.standard.record.access.entry.po
0bc0	69 6e 74 73 2c 0a 0a 6f 75 74 6c 69 6e 65 64 20 62 65 6c 6f 77 2e 0a 0a 2e 6e 68 20 32 0a 0a 54	ints,..outlined.below....nh.2..T
0be0	61 62 6c 65 20 43 72 65 61 74 69 6f 6e 20 61 6e 64 20 44 65 6c 65 74 69 6f 6e 0a 0a 0a 0a 20 20	able.Creation.and.Deletion......
0c00	20 20 41 20 6e 65 77 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 61 20 74 61 62 6c 65 20 69 73 20 63	..A.new.instance.of.a.table.is.c
0c20	72 65 61 74 65 64 20 62 79 20 69 6e 73 65 72 74 69 6f 6e 20 6f 66 20 61 20 72 65 63 6f 72 64 20	reated.by.insertion.of.a.record.
0c40	64 65 66 69 6e 69 6e 67 0a 0a 74 68 65 20 74 61 62 6c 65 20 69 6e 74 6f 20 74 68 65 20 64 61 74	defining..the.table.into.the.dat
0c60	61 62 61 73 65 20 64 69 72 65 63 74 6f 72 79 20 74 61 62 6c 65 2e 20 20 54 68 65 20 72 65 63 6f	abase.directory.table...The.reco
0c80	72 64 20 74 79 70 65 20 6d 75 73 74 20 62 65 20 73 70 65 63 69 66 69 65 64 0a 0a 77 68 65 6e 20	rd.type.must.be.specified..when.
0ca0	74 68 65 20 6e 65 77 20 64 61 74 61 20 74 61 62 6c 65 20 69 73 20 63 72 65 61 74 65 64 2e 20 20	the.new.data.table.is.created...
0cc0	44 65 6c 65 74 69 6f 6e 20 6f 66 20 61 20 72 65 63 6f 72 64 20 66 72 6f 6d 20 74 68 65 20 64 69	Deletion.of.a.record.from.the.di
0ce0	72 65 63 74 6f 72 79 0a 0a 74 61 62 6c 65 20 64 65 6c 65 74 65 73 20 74 68 65 20 61 73 73 6f 63	rectory..table.deletes.the.assoc
0d00	69 61 74 65 64 20 64 61 74 61 20 74 61 62 6c 65 20 61 6e 64 20 61 6e 79 20 61 73 73 6f 63 69 61	iated.data.table.and.any.associa
0d20	74 65 64 20 69 6e 64 65 78 65 73 2e 20 20 54 68 65 0a 0a 64 61 74 61 62 61 73 65 20 64 69 72 65	ted.indexes...The..database.dire
0d40	63 74 6f 72 79 20 74 61 62 6c 65 20 69 73 20 61 63 63 65 73 73 65 64 20 76 69 61 20 74 68 65 20	ctory.table.is.accessed.via.the.
0d60	73 74 61 6e 64 61 72 64 20 72 65 63 6f 72 64 20 61 63 63 65 73 73 20 69 6e 74 65 72 66 61 63 65	standard.record.access.interface
0d80	2c 0a 0a 6f 75 74 6c 69 6e 65 64 20 62 65 6c 6f 77 2e 0a 0a 2e 6e 68 20 32 0a 0a 49 6e 64 65 78	,..outlined.below....nh.2..Index
0da0	65 73 0a 0a 0a 0a 20 20 20 20 49 6e 64 65 78 65 73 20 61 72 65 20 6d 61 69 6e 74 61 69 6e 65 64	es........Indexes.are.maintained
0dc0	20 61 6e 64 20 75 73 65 64 20 62 79 20 74 68 65 20 44 42 20 6b 65 72 6e 65 6c 20 72 61 74 68 65	.and.used.by.the.DB.kernel.rathe
0de0	72 20 74 68 61 6e 20 62 79 20 44 42 49 4f 2e 20 20 41 6e 0a 0a 69 6e 64 65 78 20 69 73 20 63 72	r.than.by.DBIO...An..index.is.cr
0e00	65 61 74 65 64 20 62 79 20 69 6e 73 65 72 74 69 6e 67 20 61 20 72 65 63 6f 72 64 20 64 65 66 69	eated.by.inserting.a.record.defi
0e20	6e 69 6e 67 20 74 68 65 20 69 6e 64 65 78 20 69 6e 74 6f 20 74 68 65 20 69 6e 64 65 78 20 74 61	ning.the.index.into.the.index.ta
0e40	62 6c 65 2e 20 0a 0a 54 68 65 20 70 72 69 6d 61 72 79 20 61 74 74 72 69 62 75 74 65 73 20 6f 66	ble....The.primary.attributes.of
0e60	20 61 6e 20 69 6e 64 65 78 20 61 72 65 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 69 6e	.an.index.are.the.name.of.the.in
0e80	64 65 78 65 64 20 74 61 62 6c 65 20 61 6e 64 20 74 68 65 0a 0a 6e 61 6d 65 73 20 6f 66 20 74 68	dexed.table.and.the..names.of.th
0ea0	65 20 66 69 65 6c 64 73 20 75 73 65 64 20 69 6e 20 74 68 65 20 69 6e 64 65 78 2e 20 20 54 68 65	e.fields.used.in.the.index...The
0ec0	20 69 6e 64 65 78 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 0a 0a 6d 61	.index.will.be.automatically..ma
0ee0	69 6e 74 61 69 6e 65 64 20 62 79 20 74 68 65 20 44 42 20 6b 65 72 6e 65 6c 20 61 73 20 69 6e 73	intained.by.the.DB.kernel.as.ins
0f00	65 72 74 69 6f 6e 73 2c 20 64 65 6c 65 74 69 6f 6e 73 2c 20 61 6e 64 20 75 70 64 61 74 65 73 20	ertions,.deletions,.and.updates.
0f20	61 72 65 20 70 65 72 66 6f 72 6d 65 64 0a 0a 6f 6e 20 74 68 65 20 61 73 73 6f 63 69 61 74 65 64	are.performed..on.the.associated
0f40	20 72 65 6c 61 74 69 6f 6e 2e 20 20 41 6e 20 69 6e 64 65 78 20 69 73 20 64 65 6c 65 74 65 64 20	.relation...An.index.is.deleted.
0f60	62 79 20 64 65 6c 65 74 69 6f 6e 20 6f 66 20 74 68 65 0a 0a 63 6f 72 72 65 73 70 6f 6e 64 69 6e	by.deletion.of.the..correspondin
0f80	67 20 72 65 63 6f 72 64 20 66 72 6f 6d 20 74 68 65 20 69 6e 64 65 78 20 74 61 62 6c 65 2e 0a 0a	g.record.from.the.index.table...
0fa0	0a 0a 2e 6e 68 0a 0a 52 65 63 6f 72 64 20 4c 65 76 65 6c 20 41 63 63 65 73 73 0a 0a 0a 0a 20 20	...nh..Record.Level.Access......
0fc0	20 20 54 77 6f 20 74 79 70 65 73 20 6f 66 20 72 65 63 6f 72 64 20 6c 65 76 65 6c 20 61 63 63 65	..Two.types.of.record.level.acce
0fe0	73 73 20 61 72 65 20 70 72 6f 76 69 64 65 64 20 62 79 20 74 68 65 20 44 42 4b 49 20 69 6e 74 65	ss.are.provided.by.the.DBKI.inte
1000	72 66 61 63 65 2e 0a 0a 54 68 65 20 66 69 72 73 74 20 74 79 70 65 20 6f 66 20 61 63 63 65 73 73	rface...The.first.type.of.access
1020	20 69 73 20 64 69 72 65 63 74 20 61 63 63 65 73 73 2c 20 77 68 65 72 65 69 6e 20 61 20 73 69 6e	.is.direct.access,.wherein.a.sin
1040	67 6c 65 20 72 65 63 6f 72 64 20 69 73 20 61 63 63 65 73 73 65 64 0a 0a 65 69 74 68 65 72 20 62	gle.record.is.accessed..either.b
1060	79 20 61 20 6d 61 67 69 63 20 6b 65 72 6e 65 6c 20 73 75 70 70 6c 69 65 64 20 72 65 63 6f 72 64	y.a.magic.kernel.supplied.record
1080	20 69 64 20 6e 75 6d 62 65 72 2c 20 6f 72 20 76 69 61 20 61 6e 20 69 6e 64 65 78 20 67 69 76 65	.id.number,.or.via.an.index.give
10a0	6e 20 74 68 65 0a 0a 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 69 6e 64 65 78 65 64 20 66 69 65	n.the..values.of.the.indexed.fie
10c0	6c 64 73 2e 20 20 54 68 65 20 73 65 63 6f 6e 64 20 74 79 70 65 20 6f 66 20 61 63 63 65 73 73 20	lds...The.second.type.of.access.
10e0	69 73 20 73 65 71 75 65 6e 74 69 61 6c 20 61 63 63 65 73 73 2c 0a 0a 77 68 65 72 65 69 6e 20 61	is.sequential.access,..wherein.a
1100	20 75 73 65 72 20 64 65 66 69 6e 65 64 20 73 75 62 73 65 74 20 6f 66 20 74 68 65 20 72 65 63 6f	.user.defined.subset.of.the.reco
1120	72 64 73 20 69 6e 20 61 20 74 61 62 6c 65 20 61 72 65 20 61 63 63 65 73 73 65 64 20 65 69 74 68	rds.in.a.table.are.accessed.eith
1140	65 72 20 69 6e 0a 0a 73 74 6f 72 61 67 65 20 6f 72 64 65 72 20 6f 72 20 69 6e 20 74 68 65 20 6f	er.in..storage.order.or.in.the.o
1160	72 64 65 72 20 64 65 66 69 6e 65 64 20 62 79 20 61 6e 20 69 6e 64 65 78 20 6f 6e 20 74 68 65 20	rder.defined.by.an.index.on.the.
1180	74 61 62 6c 65 2e 20 20 54 68 65 20 72 65 63 6f 72 64 20 69 64 0a 0a 6e 75 6d 62 65 72 73 20 75	table...The.record.id..numbers.u
11a0	73 65 64 20 69 6e 20 61 20 64 69 72 65 63 74 20 61 63 63 65 73 73 20 6d 75 73 74 20 62 65 20 6f	sed.in.a.direct.access.must.be.o
11c0	62 74 61 69 6e 65 64 20 62 79 20 61 20 70 72 69 6f 72 20 73 65 71 75 65 6e 74 69 61 6c 20 73 63	btained.by.a.prior.sequential.sc
11e0	61 6e 2e 0a 0a 2e 6e 68 20 32 0a 0a 44 69 72 65 63 74 20 41 63 63 65 73 73 20 46 75 6e 63 74 69	an....nh.2..Direct.Access.Functi
1200	6f 6e 73 0a 0a 2e 6c 73 0a 0a 2e 6c 73 20 66 65 74 63 68 0a 0a 45 78 74 72 61 63 74 20 74 68 65	ons...ls...ls.fetch..Extract.the
1220	20 73 70 65 63 69 66 69 65 64 20 66 69 65 6c 64 73 20 66 72 6f 6d 20 61 20 72 65 63 6f 72 64 20	.specified.fields.from.a.record.
1240	67 69 76 65 6e 0a 0a 74 68 65 20 72 65 63 6f 72 64 20 69 64 20 6f 72 20 6b 65 79 20 76 61 6c 75	given..the.record.id.or.key.valu
1260	65 2e 0a 0a 2e 6c 65 0a 0a 2e 6c 73 20 69 6e 73 65 72 74 0a 0a 49 6e 73 65 72 74 20 61 20 6e 65	e....le...ls.insert..Insert.a.ne
1280	77 20 72 65 63 6f 72 64 20 69 6e 74 6f 20 74 68 65 20 69 6e 64 69 63 61 74 65 64 20 74 61 62 6c	w.record.into.the.indicated.tabl
12a0	65 2e 20 20 41 20 6c 69 73 74 20 6f 66 20 66 69 65 6c 64 20 76 61 6c 75 65 73 20 6d 61 79 0a 0a	e...A.list.of.field.values.may..
12c0	6f 70 74 69 6f 6e 61 6c 6c 79 20 62 65 20 67 69 76 65 6e 2e 20 20 41 6c 6c 20 6f 74 68 65 72 20	optionally.be.given...All.other.
12e0	66 69 65 6c 64 20 76 61 6c 75 65 73 20 61 72 65 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 65 69 74	field.values.are.initialized.eit
1300	68 65 72 20 74 6f 20 74 68 65 69 72 0a 0a 64 65 66 61 75 6c 74 20 76 61 6c 75 65 73 20 6f 72 20	her.to.their..default.values.or.
1320	74 6f 20 74 68 65 20 76 61 6c 75 65 73 20 70 72 65 73 65 6e 74 20 69 6e 20 61 6e 20 65 78 69 73	to.the.values.present.in.an.exis
1340	74 69 6e 67 20 75 73 65 72 20 64 65 66 69 6e 65 64 20 72 65 63 6f 72 64 2e 0a 0a 2e 6c 65 0a 0a	ting.user.defined.record....le..
1360	2e 6c 73 20 64 65 6c 65 74 65 0a 0a 44 65 6c 65 74 65 20 74 68 65 20 73 70 65 63 69 66 69 65 64	.ls.delete..Delete.the.specified
1380	20 72 65 63 6f 72 64 2e 0a 0a 2e 6c 65 0a 0a 2e 6c 73 20 75 70 64 61 74 65 0a 0a 55 70 64 61 74	.record....le...ls.update..Updat
13a0	65 20 28 61 73 73 69 67 6e 20 69 6e 74 6f 29 20 74 68 65 20 69 6e 64 69 63 61 74 65 64 20 66 69	e.(assign.into).the.indicated.fi
13c0	65 6c 64 73 20 6f 66 20 74 68 65 20 69 6e 64 69 63 61 74 65 64 20 72 65 63 6f 72 64 2e 0a 0a 2e	elds.of.the.indicated.record....
13e0	6c 65 0a 0a 2e 6c 65 0a 0a 2e 6e 68 20 32 0a 0a 53 65 71 75 65 6e 74 69 61 6c 20 41 63 63 65 73	le...le...nh.2..Sequential.Acces
1400	73 20 46 75 6e 63 74 69 6f 6e 73 0a 0a 2e 6c 73 0a 0a 2e 6c 73 20 6f 70 65 6e 20 73 63 61 6e 0a	s.Functions...ls...ls.open.scan.
1420	0a 50 6f 73 69 74 69 6f 6e 20 74 6f 20 74 68 65 20 66 69 72 73 74 20 72 65 63 6f 72 64 20 6f 66	.Position.to.the.first.record.of
1440	20 61 20 73 65 71 75 65 6e 74 69 61 6c 20 73 63 61 6e 2c 20 72 65 74 75 72 6e 69 6e 67 20 61 20	.a.sequential.scan,.returning.a.
1460	70 6f 69 6e 74 65 72 20 74 6f 20 61 0a 0a 73 63 61 6e 20 64 65 73 63 72 69 70 74 6f 72 2e 20 20	pointer.to.a..scan.descriptor...
1480	54 68 65 20 73 63 61 6e 20 6d 61 79 20 62 65 20 65 69 74 68 65 72 20 61 6e 20 75 6e 69 6e 64 65	The.scan.may.be.either.an.uninde
14a0	78 65 64 20 73 63 61 6e 20 6f 66 20 74 68 65 20 72 65 63 6f 72 64 73 20 69 6e 20 61 0a 0a 74 61	xed.scan.of.the.records.in.a..ta
14c0	62 6c 65 20 69 6e 20 73 74 6f 72 61 67 65 20 6f 72 64 65 72 20 6f 72 20 61 6e 20 69 6e 64 65 78	ble.in.storage.order.or.an.index
14e0	65 64 20 73 63 61 6e 20 69 6e 20 69 6e 64 65 78 20 6f 72 64 65 72 2e 20 20 49 6e 20 74 68 65 20	ed.scan.in.index.order...In.the.
1500	63 61 73 65 20 6f 66 20 61 6e 0a 0a 69 6e 64 65 78 20 73 63 61 6e 20 61 20 6b 65 79 20 76 61 6c	case.of.an..index.scan.a.key.val
1520	75 65 20 6d 61 79 20 62 65 20 67 69 76 65 6e 20 74 6f 20 64 65 66 69 6e 65 20 74 68 65 20 73 74	ue.may.be.given.to.define.the.st
1540	61 72 74 69 6e 67 20 70 6f 69 6e 74 20 6f 66 20 74 68 65 20 73 63 61 6e 2e 0a 0a 2e 6c 65 0a 0a	arting.point.of.the.scan....le..
1560	2e 6c 73 20 6e 65 78 74 0a 0a 52 65 74 75 72 6e 20 74 68 65 20 72 65 63 6f 72 64 20 69 64 20 6f	.ls.next..Return.the.record.id.o
1580	66 20 74 68 65 20 6e 65 78 74 20 73 63 61 6e 20 72 65 63 6f 72 64 20 73 61 74 69 73 66 79 69 6e	f.the.next.scan.record.satisfyin
15a0	67 20 61 20 62 6f 6f 6c 65 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 0a 0a 64 65 66 69 6e 65 64 20	g.a.boolean.expression..defined.
15c0	6f 6e 20 74 68 65 20 66 69 65 6c 64 73 20 6f 66 20 74 68 65 20 72 65 63 6f 72 64 2e 0a 0a 2e 6c	on.the.fields.of.the.record....l
15e0	65 0a 0a 2e 6c 73 20 63 6c 6f 73 65 20 73 63 61 6e 0a 0a 52 65 74 75 72 6e 20 74 68 65 20 73 63	e...ls.close.scan..Return.the.sc
1600	61 6e 20 64 65 73 63 72 69 70 74 6f 72 2e 0a 0a 2e 6c 65 0a 0a 2e 6c 65 0a 0a 0a 0a 2e 6e 68 20	an.descriptor....le...le.....nh.
1620	0a 0a 45 73 63 61 70 65 20 46 75 6e 63 74 69 6f 6e 0a 0a 0a 0a 20 20 20 20 54 68 65 20 44 42 4b	..Escape.Function........The.DBK
1640	49 20 69 6e 74 65 72 66 61 63 65 20 69 73 20 63 75 74 20 61 74 20 61 20 66 61 69 72 6c 79 20 6c	I.interface.is.cut.at.a.fairly.l
1660	6f 77 20 6c 65 76 65 6c 20 74 6f 20 73 69 6d 70 6c 69 66 79 20 74 68 65 0a 0a 72 65 71 75 69 72	ow.level.to.simplify.the..requir
1680	65 6d 65 6e 74 73 20 66 6f 72 20 61 20 44 42 20 6b 65 72 6e 65 6c 2c 20 74 6f 20 73 69 6d 70 6c	ements.for.a.DB.kernel,.to.simpl
16a0	69 66 79 20 74 68 65 20 44 42 4b 49 20 69 6e 74 65 72 66 61 63 65 20 69 74 73 65 6c 66 2c 20 61	ify.the.DBKI.interface.itself,.a
16c0	6e 64 20 74 6f 0a 0a 65 6e 73 75 72 65 20 63 6f 6e 73 69 73 74 65 6e 74 20 62 65 68 61 76 69 6f	nd.to..ensure.consistent.behavio
16e0	75 72 20 61 74 20 74 68 65 20 75 73 65 72 20 69 6e 74 65 72 66 61 63 65 20 72 65 67 61 72 64 6c	ur.at.the.user.interface.regardl
1700	65 73 73 20 6f 66 20 74 68 65 20 6e 61 74 75 72 65 20 6f 66 0a 0a 74 68 65 20 75 6e 64 65 72 6c	ess.of.the.nature.of..the.underl
1720	79 69 6e 67 20 64 61 74 61 62 61 73 65 20 73 79 73 74 65 6d 2e 20 20 57 68 65 6e 20 74 68 65 20	ying.database.system...When.the.
1740	75 6e 64 65 72 6c 79 69 6e 67 20 64 61 74 61 62 61 73 65 20 73 79 73 74 65 6d 20 69 73 20 6e 6f	underlying.database.system.is.no
1760	74 0a 0a 6a 75 73 74 20 61 20 6b 65 72 6e 65 6c 20 62 75 74 20 72 61 74 68 65 72 20 61 20 66 75	t..just.a.kernel.but.rather.a.fu
1780	6c 6c 20 62 6c 6f 77 6e 20 68 6f 73 74 20 72 65 73 69 64 65 6e 74 20 64 61 74 61 62 61 73 65 20	ll.blown.host.resident.database.
17a0	73 79 73 74 65 6d 2c 20 68 6f 77 65 76 65 72 2c 0a 0a 69 74 20 77 69 6c 6c 20 62 65 20 68 69 67	system,.however,..it.will.be.hig
17c0	68 6c 79 20 64 65 73 69 72 61 62 6c 65 20 74 6f 20 68 61 76 65 20 61 20 6d 65 63 68 61 6e 69 73	hly.desirable.to.have.a.mechanis
17e0	6d 20 66 6f 72 20 70 61 73 73 69 6e 67 20 72 65 6c 61 74 69 6f 6e 61 6c 20 63 6f 6d 6d 61 6e 64	m.for.passing.relational.command
1800	73 0a 0a 70 6f 73 65 64 20 69 6e 20 74 68 65 20 71 75 65 72 79 20 6c 61 6e 67 75 61 67 65 20 6f	s..posed.in.the.query.language.o
1820	66 20 74 68 65 20 68 6f 73 74 20 44 42 4d 53 20 74 6f 20 74 68 65 20 68 6f 73 74 20 73 79 73 74	f.the.host.DBMS.to.the.host.syst
1840	65 6d 2c 20 77 69 74 68 6f 75 74 0a 0a 6c 65 61 76 69 6e 67 20 74 68 65 20 49 52 41 46 20 65 6e	em,.without..leaving.the.IRAF.en
1860	76 69 72 6f 6e 6d 65 6e 74 2e 20 20 54 68 65 20 44 42 4b 49 20 73 68 61 6c 6c 20 70 72 6f 76 69	vironment...The.DBKI.shall.provi
1880	64 65 20 61 6e 20 65 73 63 61 70 65 20 66 75 6e 63 74 69 6f 6e 20 66 6f 72 0a 0a 74 68 69 73 20	de.an.escape.function.for..this.
18a0	70 75 72 70 6f 73 65 2e 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00	purpose.........................
18c0	00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00	................................
18e0	00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00	................................
1900	0a	.