Teknik Kılavuzlar > IVEDI SQL Kullanıcı Kılavuzu > 1. Giriş

Bir SQL betiğini çalıştırmanın en kısa yolu, onu çalışan bir Netsim System Agent'a msql komut satırı istemcisiyle vermektir. msql ajanın yanında dağıtılır ve içinde motor yoktur: ajanın /ivedi oturum protokolüne WebSocket ile bağlanır, betiğin metnini gönderir; sonuçları, Console.PrintF yazılarını ve hataları aynı bağlantıdan geri alır. Ajanın MASTER'ında SYSADMIN rolünde bir login (ya da SYSDBA) gerekir.

msql -U SYSDBA -W masterkey -f betik.sql -o sonuc.txt
msql -U SYSDBA -W masterkey -c "select current_user from dual"
msql -U SYSDBA NETSIM

Seçenek	Anlamı
`-f <dosya>`	Çalıştırılacak betik (tekrarlanabilir); standart giriş borulanmışsa betik oradan okunur.
`-c <sql>`	Deyim ya da betik metni (tekrarlanabilir).
`-o <dosya>`	Normal çıktı (sorgu sonuçları, `Console.PrintF` metni). Hata metinleri buraya yazılmaz.
`-U <login>` / `-W <parola>`	MASTER login'i ve parolası (öndeğer `IVD_USER` / `IVD_PASSWORD` ortam değişkenleri; etkileşimde parola sorulur).
`-d <ad>` ya da konumsal ad	Oturumun açılacağı kayıtlı veritabanı.
`--max-errors <n>`	Betiğin kaç hatadan sonra duracağı. Öndeğer `0`: ilk yakalanmamış hatada akış durur.
`-D <ad[=değer]>`	Önişlemci sembolü tanımlar; bkz. bölüm 10.

Girdi verilmezse msql etkileşimli bir oturum açar: deyimler ; ile gönderilir, satır başındaki \ad … satırları motorun meta-komutlarıdır (\help listeler). Seçeneklerin tamamı, çıktı biçimleri, etkileşimli kip ve istemci komutları Netsim System Agent Kurulum ve Yönetim Kılavuzu belgesinin “msql — komut satırı istemcisi” bölümündedir.

Dikkat

Çalışma zamanı hataları yalnızca stderr'e yazılır; -o dosyasına düşmez. Bir koşumun temiz olduğuna yalnızca çıktı dosyasına bakarak karar vermek yanıltıcıdır. Süreç çıkış kodu da bunu yansıtır: 0 temiz, 1 en az bir deyim başarısız, 2 bağlantı kurulamadı, dosya yok ya da geçersiz parametre.

Not

msql betiğin metnini gönderir; betikteki #include dosyaları istemcinin dosya sisteminden okunur, sunucudaki bir dosya 'server:<yol>' önekiyle seçilir (bkz. bölüm 10, “Dosya dahil etme”). Seviye paketleri 'client:<yol>' ile istemciden okunabilir (UPGRADE LEVEL … FROM) ve istemciye yazılabilir (EXPORT LEVEL … TO). Öteki çalışma zamanı dosyalarında (BACKUP TO, CREATE EXTERNAL TABLE) yol her zaman sunucunun yoludur.

Motor ayrıca uzun süreli bir servis olarak çalışır ve aynı lehçeyi REST, WebSocket ve MCP arayüzleri üzerinden de kabul eder. Bu kılavuz dilin kendisini anlatır; bağlantı yüzeyleri ayrı belgelerin konusudur.

1.2 Bir betiği çalıştırmak

1.2 Bir betiği çalıştırmak