SQL

#Ne işe yarar

SQL adımı bir veritabanında sorgu çalıştırır ve süresini ölçer. Desteklenen veritabanları: PostgreSQL, MySQL / MariaDB, SQL Server ve Oracle. Bir adım iki şekilde çalışabilir:

• Tek sorgu: her iterasyonda aynı query (parametreleri değişebilir).
• Query mix: her iterasyonda birkaç query'den biri, ağırlığına göre rastgele seçilir. Böylece tek bir adım üretimdeki sorgu profilini yeniden üretir; sonuçlarda her query'nin gecikmesi ve hataları ayrı görünür.

Query'leri elle yazabilir, bir .sql dosyasından toplu ekleyebilir, üretim istatistiklerinden (pg_stat_statements, MySQL digest'leri) içe aktarabilir ya da veritabanının schema'sından önerilmesini isteyebilirsiniz (SQL: schema'dan query önerileri).

Veri güvenliği için her query bir write guard'dan geçer: okuma olmayan her şey açık onay ister ve PostgreSQL ile MySQL'de okumalar ayrıca read-only transaction içinde çalışır (bkz. Yazma koruması).

#Ne zaman kullanılır

• Veritabanının yük altında hangi query'de yavaşladığını görmek için.
• Bir index, sürüm yükseltmesi ya da parametre değişikliğinin önce/sonra etkisini ölçmek için.
• Uygulamayı hiç ayağa kaldırmadan yalnızca veritabanı katmanını test etmek için.

#Desteklenen veritabanları

#SQL bağlantısı oluşturma

Yeni PostgreSQL bağlantısı

1. Bağlantılar → Bağlantı ekle'ye tıklayın.
2. Tür: PostgreSQL, MySQL / MariaDB, SQL Server ya da Oracle.
3. Ad: ör. orders-db.
4. Sunucu: veritabanının host adı ya da IP'si (zorunlu). SSH tüneli kullanıyorsanız bu ad SSH sunucusu tarafında çözülür.
5. Port: boşsa türün varsayılanı.
6. Veritabanı / servis: veritabanı adı; Oracle'da servis adı (ör. FREEPDB1).
7. Kullanıcı ve Parola (secret). Mümkünse yalnızca gerekli tablolarda SELECT yetkisi olan ayrı bir kullanıcı kullanın.
8. En çok açık bağlantı (runner başına): her runner'ın bu bağlantı için açacağı en çok veritabanı bağlantısı; varsayılan 50. VU sayınız yüksekse ve veritabanının max_connections sınırı düşükse buna göre ayarlayın: toplam bağlantı ≈ runner sayısı × bu değer.
9. Production veritabanı: bağlantı production'a gidiyorsa işaretleyin. Listede kırmızı PRODUCTION etiketi görünür; schema okunurken güçlü bir uyarı ve ek onay istenir.
10. Sürücü parametreleri: sürücüye gidecek anahtar/değer çiftleri. Ekle ile satır ekleyin. Örnekler: PostgreSQL sslmode = require; SQL Server encrypt = true.
11. Veritabanına yalnızca bir bastion üzerinden erişiliyorsa SSH tüneli bölümünü kullanın (yalnızca kurulum yöneticileri; bkz. SQL: SSH tüneli).
12. Kaydet, sonra Test et.

SQL bağlantısını düzenleme

#Tek sorgu adımı

1. Test editöründe Adım ekle → Protokol: SQL.
2. Bağlantı: ör. orders-db. Bağlantının türü placeholder biçimini belirler.
3. Sorgu türü düğmelerinden Tek sorgu seçili olsun.
4. Sorgu alanına query'yi yazın. Değerleri query'nin içine yazmayın, parametre kullanın (Değerleri sorguya yazmayın; parametre kullanın ($1).).
5. Parametreler altında Parametre ekle ile her placeholder için bir değer girin (#1, #2…). Değerler şablon olabilir: {{customerId}}, bir CSV veri sütunu {{musteriler.id}}, fake veri {{fake.firstName}}, rastgele sayı {{$randInt 1 100000}}.
6. Saklanacak en çok satır (varsayılan 100): check'lerin ve değişken çıkarmanın gördüğü satır sayısı. Fazlası sayılır ama okunmaz.
7. Sorgu okuma ise formun altında yeşil Salt okunur: sorgu read-only transaction içinde çalışır; yazma girişimi veritabanında reddedilir. yazar (PostgreSQL ve MySQL).
8. Check sekmesinde örneğin Satır sayısı = 1 ekleyin. Satırlar JSON dizisi olarak döner; Değişken çıkar'da $[0].status gibi bir JSONPath ile sütun değerini alabilirsiniz.
9. Dene ile tek iterasyon çalıştırıp dönen satırları görün, sonra Kaydet.

Deneme sonucu

{"id": "order", "name": "Sipariş getir", "protocol": "sql", "connection": "orders-db",
 "sql": {"query": "SELECT id, status, total FROM orders WHERE id = $1", "params": ["{{$randInt 1 100000}}"]},
 "extract": [{"var": "status", "from": "jsonpath", "expr": "$[0].status"}],
 "checks": [{"type": "rowCount", "op": "eq", "value": 1}]}

Diğer veritabanlarında yalnızca placeholder değişir:

[
  {"id": "my", "name": "MySQL", "protocol": "sql", "connection": "mysql-db",
   "sql": {"query": "SELECT * FROM customers WHERE email = ?", "params": ["user{{__VU}}@example.com"]}},
  {"id": "ms", "name": "SQL Server", "protocol": "sql", "connection": "mssql-db",
   "sql": {"query": "SELECT TOP 10 * FROM Orders WHERE CustomerId = @p1", "params": ["{{__VU}}"]}}
]

#Query mix

Query mix adımı

1. SQL adımında Sorgu türü olarak Query mix'i seçin. Yazılı bir query varsa query_1 adıyla ve 1 ağırlığıyla mix'in ilk elemanı olur.
2. Sorgu ekle ile her query için bir satır ekleyin ya da Toplu ekle / içe aktar ile doldurun.
3. Her satıra:
   • Ad: benzersiz, en çok 80 karakter, şablon içermeyen kısa bir ad (ör. byId, search). Sonuç tablolarında ve eşik filtrelerinde bu ad kullanılır.
   • Ağırlık: pozitif tam sayı. Ağırlıklar görelidir; satırın yanında pay %… olarak gösterilir. pg_stat_statements'tan gelen çağrı sayıları olduğu gibi kullanılabilir.
   • Sorgu ve parametreleri.
4. Bir mix'te en çok 200 query olabilir.
5. Mix'teki bir query veri değiştiriyorsa satırında Bu sorgu veriyi değiştirir yazar ve adımın altında Bu query mix'te veriyi değiştiren sorgular var, onaylıyorum kutusu çıkar. Bu tek onay mix'teki tüm yazmaları kapsar.

{"id": "catalog", "name": "Katalog sorguları", "protocol": "sql", "connection": "orders-db",
 "sql": {"mix": [
   {"name": "byId",   "query": "SELECT * FROM products WHERE id = $1", "params": ["{{$randInt 1 5000}}"], "weight": 120000},
   {"name": "search", "query": "SELECT * FROM products WHERE name ILIKE $1 LIMIT 20", "params": ["%{{fake.firstName}}%"], "weight": 30000}
 ]}}

Bu örnekte iterasyonların yaklaşık %80'i byId, %20'si search çalıştırır.

#Toplu ekleme

Toplu ekle / içe aktar düğmesi SQL toplu ekle penceresini açar. İlk sekme Sorgular / .sql dosyası:

SQL toplu ekle penceresi

1. Veritabanı listesinden dili seçin (PostgreSQL, MySQL / MariaDB, SQL Server, Oracle). Ayırma kuralları buna göre değişir.
2. Query'leri metin alanına yapıştırın ya da .sql dosyası alanından bir dosya seçin.
3. Ayrıştır'a tıklayın. Hiçbir query çalıştırılmaz; controller yalnızca metni ifadelere ayırır:
   • tırnak ve yorum dışındaki ;,
   • PostgreSQL dollar quote ($ … $) ve iç içe yorumlar,
   • MySQL # yorumları ve DELIMITER,
   • SQL Server GO satırları,
   • Oracle / satırları ve PL/SQL blokları.
4. Gözden geçirme tablosu her farklı ifadeyi bir kez gösterir: Satır (dosyadaki satır), Ad, İfade, Tekrar (aynı ifade kaç kez geçti; ağırlık olur), Tür ve Parametre değerleri. Üstteki özet N sorgu: X okuma, Y yazma biçimindedir.
5. Tür sütunu: okuma, yazma, kilit (SELECT … FOR UPDATE gibi), INTO (SELECT … INTO tablo oluşturur), prosedür (CALL/EXEC; yan etkisi bilinmez), çoklu ifade.
6. Okumalar işaretli, diğerleri işaretsiz gelir. Seçimi Yalnız okumalar, Tümü, Hiçbiri düğmeleriyle ya da satır satır değiştirin. Okuma olmayan bir ifadeyi seçerseniz altta kırmızı Seçilen N ifade veriyi değiştirir ya da kilitler; step'te "veri değiştirir" onayı gerekecek. uyarısı çıkar.
7. Sonuç seçin: Tek query mix step'i ya da Her ifade ayrı step.
8. Ekle (N)'e tıklayın.

Toplu ekleme gözden geçirme tablosu

#Üretim istatistiklerinden içe aktarma

Aynı penceredeki Üretim istatistikleri sekmesi, veritabanınızın gerçekte en çok çalıştırdığı query'leri ve çağrı sayılarını alır:

Üretim istatistikleri sekmesi

Yöntem A — CSV/TSV yapıştırma (her kullanıcı):

1. Dışa aktarma sorgusu satırını açın; PostgreSQL (psql) ve MySQL / MariaDB için hazır sorgu görünür:
   • PostgreSQL: pg_stat_statements'tan query, calls, total_exec_time, rows sütunlarını mevcut veritabanı için, çağrı sayısına göre ilk 200 satır olarak stats.csv'ye yazan bir \copy komutu. pg_stat_statements eklentisinin kurulu ve yüklü olması gerekir.
   • MySQL: performance_schema.events_statements_summary_by_digest'ten DIGEST_TEXT, COUNT_STAR, SUM_TIMER_WAIT.
2. Sorguyu kendi istemcinizde çalıştırın; çıktıyı başlık satırıyla birlikte metin alanına yapıştırın.
3. En çok çağrılan alanında kaç query alınacağını seçin (varsayılan 50, en çok 200).
4. İçe aktar'a tıklayın.

Yöntem B — bağlantıdan doğrudan okuma (yalnızca yöneticiler, PostgreSQL ve MySQL):

1. Adımın bağlantısı PostgreSQL veya MySQL ise Bağlantıdan oku: orders-db düğmesi görünür.
2. Tıklayın. Controller bağlantıyı açar ve yalnızca istatistik sorgusunu, çağrı sayısına göre ilk N satırı, read-only transaction içinde ve zaman aşımıyla çalıştırır.

Her iki yöntemde:

• Çağrı sayıları ağırlık olur.
• Transaction ve oturum command'ları (BEGIN, COMMIT, SET…) ve istatistik sorgusunun kendisi atlanır; atlananlar Atlanan: … satırında sayılır.
• Yazmalar işaretsiz gelir.
• Normalleştirilmiş query'lerde sabitlerin yerinde placeholder ($1, ?) vardır. Parametre değerleri sütununda her birini bir veri sütununa ({{ad.sütun}}) ya da fake değere bağlayın; alan önerileri listeler.
• MySQL'in daraltılmış listeleri (IN (...)) Değer listesi daraltılmış (IN (...)): ekledikten sonra sorguyu elle düzenleyin., kesilmiş metinler Sorgu metni istatistikte kesilmiş: ekledikten sonra tamamlayın. notuyla işaretlenir.

#Sorgu başına sonuçlar

Her SQL adımı adım düzeyinde şu metrikleri üretir:

Query mix'te ayrıca her query kendi serisini üretir; query'nin adı serinin check etiketidir:

Koşu sayfasındaki SQL query mix kartı her query'nin Çağrı, Pay ve Hata oranı değerlerini listeler; adımın toplamı yukarıdaki adım tablosundadır. Aynı bilgiler HTML/PDF raporda ve CLI özetinde de vardır. Tek bir query'ye eşik koymak için:

[
  {"metric": "sql_query_duration", "filter": {"check": "search"}, "expr": "p(95)<200"},
  {"metric": "sql_query_failed", "expr": "rate<0.01"}
]

#Yazma koruması

#Ne yazma sayılır

Write guard her query'yi veritabanının sözdizimine göre token'lara ayırır (yorumlar, tırnaklar, ayırıcılar) ve anahtar kelimeleri yalnızca bir ifadenin başladığı yerde sayar: ifadenin başı, bir CTE gövdesi, CTE listesinden ya da EXPLAIN'den sonraki ifade, bir alt sorgu. Bu yüzden replace() fonksiyonu ya da update adlı bir sütun bir okumayı yazma yapmaz.

Sınıflandırma ihtiyatlıdır: okuma olarak tanınmayan her şey yazma sayılır.

#Onay adımları

1. Adımda onay. Okuma olmayan bir query'de adımın altında Bu sorgu veriyi değiştirir, onaylıyorum (mix'te Bu query mix'te veriyi değiştiren sorgular var, onaylıyorum) kutusu çıkar. İşaretlemeden test kaydedilemez; hata şöyledir: bu sorgu veriyi değiştirir (UPDATE); izin vermek için "veri değiştirir" onayını işaretleyin. Editörde ayrıca her iterasyonda veritabanına yazar (INSERT), satır kilitler (FOR UPDATE); eşzamanlı VU'lar birbirini bekler gibi uyarılar listelenir.
2. Denemede onay. Dene'ye bastığınızda Veri değiştiren deneme penceresi değiştirecek işlemleri listeler; Anladım, dene ile devam edersiniz.
3. Her koşuda onay. Koşu penceresinde Bu testin gerçek veriyi değiştireceğini biliyorum, başlat kutusunu işaretlemeden koşu başlamaz (ya da onay telefondan verilir). Zamanlanmış koşularda ve karşılaştırmalı koşularda da ayrı onay kutuları vardır.

{"id": "audit", "name": "Denetim satırı yaz", "protocol": "sql", "connection": "orders-db",
 "sql": {"query": "INSERT INTO audit_log (vu, at) VALUES ($1, now())", "params": ["{{__VU}}"], "allowWrite": true}}

#Read-only transaction

Write guard ilk savunma hattıdır. PostgreSQL ve MySQL / MariaDB'de okuma olarak sınıflanan her query ayrıca read-only transaction içinde çalışır; gözden kaçan bir yan etki (ör. veri değiştiren bir fonksiyon) veritabanının kendisi tarafından reddedilir.

#Sık karşılaşılan sorunlar

Belirti: Test et: connection refused ya da zaman aşımı. Neden: Host/port yanlış, veritabanı yalnızca iç ağdan erişilebilir ya da firewall engelliyor. Çözüm: Port ve host'u kontrol edin; controller ve runner IP'lerine izin verin; bastion arkasındaysa SSH tüneli kullanın.

Belirti: password authentication failed for user … (PostgreSQL), Access denied for user … (MySQL), Login failed for user … (SQL Server), ORA-01017 (Oracle). Neden: Kullanıcı/parola yanlış ya da kullanıcının o veritabanına erişimi yok. Çözüm: Parolayı yeniden yazıp kaydedin; Veritabanı / servis alanını kontrol edin. PostgreSQL'de pg_hba.conf'un controller/runner IP'sine izin verdiğinden emin olun.

Belirti: no pg_hba.conf entry … SSL off ya da SQL Server TLS hatası. Neden: Sunucu şifreli bağlantı istiyor. Çözüm: Sürücü parametreleri'ne sslmode = require (PostgreSQL) ya da encrypt = true (SQL Server) ekleyin.

Belirti: ORA-12514: listener does not currently know of service. Neden: Oracle servis adı yanlış. Çözüm: Veritabanı / servis alanına SID değil servis adını yazın (ör. FREEPDB1).

Belirti: Kayıtta bu sorgu veriyi değiştirir (…); izin vermek için "veri değiştirir" onayını işaretleyin. Neden: Query okuma olarak tanınmadı (yazma, kilit, INTO, prosedür ya da çoklu ifade). Çözüm: Gerçekten yazacaksanız onay kutusunu işaretleyin. Okuma olması gerekiyorsa query'yi sadeleştirin: FOR UPDATE'i kaldırın, prosedür yerine doğrudan SELECT kullanın, birden çok ifadeyi ayrı adımlara bölün.

Belirti: Koşu sırasında cannot execute … in a read-only transaction (PostgreSQL) ya da Cannot execute statement in a READ ONLY transaction (MySQL). Neden: Okuma gibi görünen query veri değiştirmeye çalıştı (ör. yan etkili bir fonksiyon). Çözüm: Bu koruma bilerek çalışıyor. Yazma gerçekten amaçlanıyorsa query'yi yazma olarak işaretleyip onaylayın; değilse fonksiyonu değiştirin.

Belirti: Koşu başlatılamıyor: Bu test veriyi değiştiriyor; devam etmek için onaylayın. Neden: Testte onaylı bir yazma var. Çözüm: Koşu penceresindeki Bu testin gerçek veriyi değiştireceğini biliyorum, başlat kutusunu işaretleyin.

Belirti: too many connections / remaining connection slots are reserved. Neden: Runner sayısı × En çok açık bağlantı (runner başına) veritabanının sınırını aşıyor. Çözüm: En çok açık bağlantı (runner başına)'yı düşürün ya da veritabanının bağlantı sınırını artırın.

Belirti: Kayıtta query mix'teki search sorgusu veriyi değiştirir… ya da ağırlık pozitif bir tam sayı olmalı. Neden: Mix'te onaysız bir yazma ya da geçersiz ağırlık. Çözüm: Mix onayını işaretleyin ya da yazmayı çıkarın; ağırlıkları 1 veya daha büyük tam sayı yapın.

Belirti: Bağlantıdan oku düğmesi görünmüyor. Neden: Bağlantı SQL Server/Oracle ya da hesabınız yönetici değil. Çözüm: Yöntem A'yı (CSV yapıştırma) kullanın.

#İlgili sayfalar

• SQL: schema'dan query önerileri
• SQL: SSH tüneli
• Protokoller ve bağlantılar
• Redis ve MongoDB