CREATE DATABASE … STORAGE ENGINE <ad> [PARAMETERS '<bağlantı dizgisi>']

9.3.1 Bağlantı dizgisi seçenekleri

PARAMETERS bağlantı dizgisi motorun kendi anahtarlarını (Server Name, User Name, Password, Database Name, CharSet, Port, Vendor Lib) taşır; IVEDI'ye özgü olanlar:

9.3.2 İşletim sistemi oturumuyla kimlik doğrulama

PARAMETERS bağlantı dizgisindeki OS Authentication=Yes seçeneği "kullanıcı adı/parola gönderme, işletim sistemi oturumunun kimliğiyle bağlan" demektir. Bağlantı dizgisinde bir Password dursa bile yok sayılır, yani parolayı betikten ya da yapılandırmadan tamamen kaldırmaya yarar. Seçeneği yalnızca kimlik doğrulayan motorlar tanır:

9.3.3 Oturumun kimliğiyle depo bağlantısı (Session Authentication)

Öndeğerde motor bir veritabanının deposuna her oturum için MASTER kaydındaki User Name/Password ile bağlanır; IVEDI'nin kendi hakları (IVD$OBJECT_PRIVILEGES) bu tek depo kimliğinin üstünde uygulanır. Kayıttaki kimlik motorun servis kullanıcısıdır (aşağıda) ve depoda tam yetkilidir, yani IVEDI'nin hak denetiminden geçen her şey depoda tam yetkiyle koşar.

PARAMETERS bağlantı dizgisine Session Authentication=Yes yazılırsa login'li bir oturumun depo bağlantısı o login'in kimliğiyle kurulur:

• Kullanıcı adı, login'in o veritabanındaki kullanıcısının adıdır (CREATE USER u FOR LOGIN l ile eşlenen u; eşleme yoksa login adı); depoya GRANT'ın yazdığı biçimde gider: PostgreSQL'de büyük harfli ad küçük harfe katlanır (SESSU → sessu), karışık harfli ad olduğu gibi; Firebird'de büyük harfli ad olduğu gibi.
• Parola, oturumu açarken verilen login parolasıdır. Depoda aynı adlı ve aynı parolalı bir kullanıcı/rol bulunmalıdır; kullanıcıyı depoda kuran işletmecidir — motor depoya kullanıcı yaratmaz. Login'in parolası ALTER USER <login> PASSWORD '…' ile değiştirildiğinde motor, bu seçenekle kayıtlı her veritabanında eşlenen kullanıcı depoda varsa onun parolasını da kayıttaki kimlikle yazar; kullanıcısı depoda olmayan ya da yazılamayan veritabanı uyarı olarak bildirilir.
• Depo kimliği oturumun başlangıç login'ininkidir: CONNECT IVEDI kimliğini değiştirir, açık depo bağlantısını değiştirmez.
• Kayıttaki kimlik motorun kendi bağlantılarında kalır: kimliksiz iç bağlantılar (tembel katalog yükleme, zamanlayıcı işleri, yardımcı bağlantılar), önyükleme login'i SYSDBA ile açılan oturumlar ve dil sunucusu bağlantıları (GUEST, yalnız çevirir).
• Depo kendi haklarını uygular: IVEDI'de SYSADMIN olan bir login bile depoda hakkı olmayan bir tabloyu okuyamaz (deponun hatası iletilir). Tablo ve görünüm hakları, yordamların EXECUTE'u ve dizilerin USAGE'ı için GRANT/REVOKE zaten depoya yansıtılır; PostgreSQL'de bir nesne hakkıyla birlikte nesnenin şemasının USAGE'ı da verilir (PostgreSQL'de şemaya ulaşmak ayrı bir haktır, IVEDI'de değildir). Katalog tabloları (IVD$*) depoda PUBLIC'e okunabilir; DDL yapacak kullanıcının depoda buna yetecek hakkı olmalıdır.
• Her depo kimliği bağlantı havuzunda kendi anahtarını alır (parametrelerin özeti); aynı login'in oturumları bağlantıyı paylaşır, farklı login'ler paylaşmaz.

create database satis storage engine postgresql
  parameters 'Server Name=localhost; Database Name=satis; User Name=postgres; Password=***;
              Catalog Schema=netsim; Session Authentication=Yes';

9.3.4 Motorun servis kullanıcısı (IVD$ENGINE)

Kayıttaki kimlik deponun süper kullanıcısı değildir. CREATE DATABASE / OPEN DATABASE'in PARAMETERS'ında verilen User Name/Password (SYSDBA, postgres) yalnız kurulum içindir: motor onunla bağlanıp depoda kendi servis kullanıcısını kurar (ajan ayarı engineUser, öndeğer IVD$ENGINE; PostgreSQL'de CREATE ROLE … LOGIN SUPERUSER, Firebird'de CREATE OR ALTER USER … GRANT ADMIN ROLE + GRANT CREATE DATABASE + hedef veritabanında GRANT DEFAULT RDB$ADMIN) ve parolasını rastgele üretir. Süper kullanıcının parolası hiçbir yere yazılmaz. Depo sunucusu başına bir servis kullanıcısı vardır (sunucu adı + port; Firebird'de Database Name'in sunucu:yol / sunucu/port:yol öneki ya da Server Name'deki sunucu/port da sunucu adıdır, öneksiz yol yerel sunucudur) ve kimliği MASTER'da o sunucunun credential'ında durur:

-- motorun kendi kurduğu nesne (MASTER, SYS şeması)
CREATE CREDENTIAL SYS.IVD$ENGINE_POSTGRESQL_LOCALHOST_5432 TYPE DBLINK
  IDENTITY 'ivd$engine' PASSWORD '…' TAGS (Engine = 'POSTGRESQL', Server = 'LOCALHOST', Port = '5432');

-- kayıt satırının parametreleri: kimlik yok, credential'a başvuru var
Server Name=localhost; Database Name=satis; Credential=SYS.IVD$ENGINE_POSTGRESQL_LOCALHOST_5432

Ajan kaydı açarken kullanıcı adını ve parolayı credential'dan alır. Aynı sunucunun ikinci kaydı aynı credential'ı kullanır; sunucunun son kaydı kapatılsa da credential kalır. ALTER DATABASE … SET PARAMETERS'ta maskesiz bir parola verilirse o kayıt credential'dan çıkar ve kendi mühürlü parolasını taşır. CREATE / ALTER CREDENTIAL … PASSWORD deyimlerinin parolası SQL izinde PASSWORD <password> olarak görünür. Kullanıcı adı depoya GRANT'ın yazdığı katlamayla gider (PostgreSQL'de ivd$engine, Firebird'de IVD$ENGINE). ODBC kaydı PostgreSQL lehçesinde olduğu için PostgreSQL'in rolünü kurar; aynı sunucudaki PostgreSQL ve ODBC kayıtları tek sunucu sayılır (port verilmemişse 5432) ve aynı rolü, aynı parolayla kullanır.

• Kimlik doğrulamayan motorlarda (sqlite, bellek) ve OS Authentication=Yes kayıtlarda yapılmaz; User Name zaten servis kullanıcısıysa olduğu gibi alınır.
• Kurulum başarısız olursa (verilen kimlik süper kullanıcı değil, bağlanılamadı) kayıt verilen kimliği taşır ve uyarı yazılır; ALTER DATABASE … SET ENGINE USER yineler.
• Aynı depo sunucusunu paylaşan iki ajan farklı engineUser adı kullanmalıdır: ikisi aynı kullanıcının parolasını ezer, birinin bağlantıları düşer.

Var olan kaydı dönüştürmek:

set storage credentials user 'postgres' password '***';
set catalog satis;
alter database satis set engine user;                        -- parolayı motor üretir
alter database satis set engine user password 'Seçilen***'; -- ya da işletmeci belirler
commit;

PASSWORD verilirse servis kullanıcısının parolası o olur; verilmezse sunucunun credential'ındaki parola, o da yoksa rastgele bir parola kullanılır. Parola credential'a hemen yazılır (deyimin işleminden bağımsız: depodaki parola değişikliği geri alınmaz). Kayıt credential'a başvurur hâle gelir; aynı depo sunucusunda parolayı hâlâ satırında taşıyan servis kullanıcılı öteki kayıtlar da credential'a bağlanır; açık motorların bağlantıları yeni kimlikle yeniden açılır.

9.3.5 Bakım deponun süper kullanıcısıyla: SET STORAGE CREDENTIALS

ALTER DATABASE … UPGRADE, UPGRADE LEVEL, ADOPT LEVEL, DROP LEVEL ve ADOPT … LEVEL 3 Firebird / PostgreSQL / ODBC depolarında yedeği ve bütün yazımları ayrı bir bakım bağlantısında yapar (önce açık işlemi onaylar). Seviye 4'teki tek nesne benimsemesi (ADOPT TABLE …) bakım kimliği yoksa oturumun bağlantısında kalır. Bağlantının kimliği:

set storage credentials user 'SYSDBA' password '***';   -- oturumun depo süper kullanıcısı
alter database satis upgrade level 3 from 'server:C:\paket\satis_3.db';
set storage credentials none;                            -- siler

• Oturumda SET STORAGE CREDENTIALS verilmişse o kimlik; yanlış parola yükseltmeyi hiçbir şey yazmadan reddeder (the storage credentials were refused).
• Verilmemişse: SYSDBA oturumu ve kimliksiz bağlantılar kayıttaki (servis) kimliği kullanır; başka bir login yükseltmeyi başlatamaz (requires its superuser for maintenance).
• Parola bağlantıda bellekte tutulur; üretilen metinde ve SQL izinde PASSWORD <password> olarak maskelenir (CONNECT gibi). Yalnız üst düzey deyimdir; yordam gövdesinde yazılamaz. Önizleme (PREVIEW) kimlik istemez.
• Yönetim arayüzünün Yükseltme sayfası kimliği ilk çalıştırmada sorar ve her yükseltmeden önce bu deyimle verir, sonra siler.