2026.10.0 — Log Tablosu ALTER Scriptleri

Bu sayfa listelenmemiştir (unlisted) — sidebar'da ve arama sonuçlarında görünmez, yalnızca 2026.10.0 sürüm notlarındaki ve AI yönlendirme sayfasındaki doğrudan bağlantı üzerinden erişilmek üzere tasarlanmıştır.

Kimler ihtiyaç duyar

Bu script yalnızca API proxy trafik loglarını SQL/JDBC trafik-log connector'ı üzerinden ilişkisel bir veritabanına (Oracle, MySQL, PostgreSQL veya SQL Server) yazan Apinizer kurulumlarını ilgilendirir.

Elasticsearch veya MongoDB connector'ı kullanıyorsanız bu sayfayı tamamen atlayın — o hedefler yeni veriyi elle bir adım gerektirmeden taşır. Elasticsearch tarafında indeks şablonu yükseltme sırasında güncellenir ve indeks otomatik olarak rollover edilir.

Ne değişti

Apinizer 2026.10.0, AI yönlendirmesine LLM rota sınıflandırıcısını ekler. Trafik logu, sınıflandırıcı rotası değerlendiren her istek için sınıflandırıcı kararını kaydeder. LLM sınıflandırıcıyı kullanmasanız da bu script gereklidir. Gateway INSERT ifadesi tablonun tüm kolonlarını adıyla listeler; bu yüzden sınıflandırıcıyı kullansanız da kullanmasanız da kolonlar bulunmalıdır.

log_ApiProxyTraffic altı yeni kolon alır:

• ai_route_cls_label — sınıflandırıcının seçtiği etiket.
• ai_route_cls_outcome — sınıflandırıcı kararının sonucu.
• ai_route_cls_latency_ms — sınıflandırıcı karar süresi (milisaniye).
• ai_route_cls_token_in — sınıflandırıcının kullandığı girdi token sayısı.
• ai_route_cls_token_out — sınıflandırıcının kullandığı çıktı token sayısı.
• ai_route_cls_cost_micro — sınıflandırıcı maliyeti (mikro-USD).

Altı kolon da nullable ve seyrektir (sparse). Sınıflandırıcı rotası değerlendirmeyen trafikte NULL kalır. Mevcut satırlar NULL kalır.

Script'i gateway'i yükseltmeden ÖNCE çalıştırın

Gateway INSERT ifadesi log_ApiProxyTraffic tablosunun tüm kolonlarını adıyla listeler. Bu altı kolon eksikse bu veritabanına yapılan her trafik logu insert işlemi başarısız olur ve trafik kayıtları kaybolur. Script'i gateway'i 2026.10.0 sürümüne yükseltmeden önce çalıştırın.

Ne zaman çalıştırılmalı

Bu script'i yapılandırılmış her SQL/JDBC trafik-log veritabanına karşı gateway'i 2026.10.0 sürümüne yükseltmeden önce bir kez çalıştırın; bakım penceresi gerektirmez. Kolonlar nullable olduğu için yükseltme öncesi log satırlarını yazmaya devam eden eski gateway worker'ları etkilenmez. DDL için bir değişiklik yönetimi süreciniz varsa önce production dışı bir ortamda deneyin.

Bu script önceki ALTER scriptlerinden bağımsızdır. Eski bir sürümden yükseltiyorsanız başlangıç sürümünüzün önceki scriptlerini de çalıştırın (Apinizer Log Tabloları Oluşturma Komutları sayfasındaki kolon sayısı tablosuna bakın).

Bu script'i iki kez çalıştırmayın

2026.09.8 sürümü bu altı kolon için INSERT ifadesini zaten içerir. Kurulumunuz 2026.09.8 sürümünde çalışıyorsa ve tabloda zaten 140 kolon varsa bu script'i yeniden çalıştırmayın. Var olan bir kolonu eklemek hata verir.

Tabloyu 2026.10.0 sürümünün Apinizer Log Tabloları Oluşturma Komutları sayfasındaki CREATE TABLE komutlarıyla oluşturduysanız tabloda bu kolonlar zaten vardır; bu script'i çalıştırmanız gerekmez.

Oracle

ALTER TABLE log_ApiProxyTraffic ADD (
    ai_route_cls_label VARCHAR2(64),
    ai_route_cls_outcome VARCHAR2(16),
    ai_route_cls_latency_ms NUMBER(19),
    ai_route_cls_token_in NUMBER(19),
    ai_route_cls_token_out NUMBER(19),
    ai_route_cls_cost_micro NUMBER(19)
);

PostgreSQL

ALTER TABLE log_ApiProxyTraffic
    ADD COLUMN ai_route_cls_label VARCHAR(64),
    ADD COLUMN ai_route_cls_outcome VARCHAR(16),
    ADD COLUMN ai_route_cls_latency_ms BIGINT,
    ADD COLUMN ai_route_cls_token_in BIGINT,
    ADD COLUMN ai_route_cls_token_out BIGINT,
    ADD COLUMN ai_route_cls_cost_micro BIGINT;

MySQL

ALTER TABLE log_ApiProxyTraffic
    ADD COLUMN ai_route_cls_label VARCHAR(64),
    ADD COLUMN ai_route_cls_outcome VARCHAR(16),
    ADD COLUMN ai_route_cls_latency_ms BIGINT,
    ADD COLUMN ai_route_cls_token_in BIGINT,
    ADD COLUMN ai_route_cls_token_out BIGINT,
    ADD COLUMN ai_route_cls_cost_micro BIGINT;

SQL Server

ALTER TABLE log_ApiProxyTraffic ADD
    ai_route_cls_label NVARCHAR(64),
    ai_route_cls_outcome NVARCHAR(16),
    ai_route_cls_latency_ms BIGINT,
    ai_route_cls_token_in BIGINT,
    ai_route_cls_token_out BIGINT,
    ai_route_cls_cost_micro BIGINT;

Doğrulama

Script'i çalıştırdıktan sonra log_ApiProxyTraffic tablosundaki kolon sayısının 6 arttığını doğrulayın. Örneğin PostgreSQL, MySQL veya SQL Server üzerinde:

SELECT COUNT(*) FROM information_schema.columns WHERE LOWER(table_name) = 'log_apiproxytraffic';

Oracle'da USER_TAB_COLUMNS içinde LOG_APIPROXYTRAFFIC tablosunun kolonlarını sayın. Ardından sınıflandırıcı rotası olan bir AI API Proxy üzerinden bir istek gönderin ve yeni kolonları kontrol edin:

SELECT correlation_id, ai_route_cls_label, ai_route_cls_outcome, ai_route_cls_latency_ms
FROM log_ApiProxyTraffic
WHERE ai_route_cls_label IS NOT NULL
ORDER BY log_timestamp DESC;