SQLAlchemy 2.1.0 varsayılan pip install sürümü oldu, Python alt sınırı 3.11'e yükseldi

2.1 serisinin ilk kararlı sürümü

SQLAlchemy 2.1.0, 2.1 hattının ilk üretim sürümü olarak yayımlandı ve SQLAlchemy blogundaki duyuruya göre artık pip install sqlalchemy komutunu çalıştırdığınızda gelen sürüm bu. Sürüm notunun tarihi 24 Eylül 2026 ve haber kısa süre sonra Hacker News ana sayfasında da yer buldu.

Geliştiriciler 2.1'i üç yıl önceki 2.0 sürümüne kıyasla çok daha küçük bir adım olarak nitelendiriyor ve yükseltmelerin zor olmasını beklemiyorlar. Yine de duyuru, sert diye adlandırdıkları — mevcut iş akışlarında ayar gerektirebilecek — bir dizi değişikliğe dikkat çekiyor.

Ters tepebilecek üç değişiklik

İlki: greenlet artık varsayılan olarak kurulmuyor. SQLAlchemy'deki her asyncio özelliği greenlet'e bağlı, dolayısıyla async kullanıcılarının bunu çekmek için artık pip install sqlalchemy[asyncio] çalıştırması gerekiyor. Greenlet'in temel paketle birlikte geldiğini varsayan bağımlılık manifestoları eksik kalacak.

İkincisi: PostgreSQL ve Oracle için yeni varsayılan sürücüler. Belirli bir sürücü adı olmadan postgresql:// veya oracle:// biçiminde yazılan URL'ler artık sırasıyla psycopg — yani psycopg3 — ve oracledb sürücülerine çözümleniyor. URL'nin kendisi çalışmaya devam ediyor, ancak altında yatan sürücü, uygulamanın özgün olarak test edildiği sürücü olmayabilir.

Üçüncüsü: Python 3.11 minimum desteklenen sürüm. Duyuru, Python 3.10'un sürümden bir haftadan biraz fazla sonra yaşam döngüsünün sonuna ulaşacağına işaret ediyor ve pip, nox ve GitHub Actions gibi üçüncü taraf araçların eski Python sürümlerini agresif biçimde emekliye ayırmasıyla yıllar içinde EOL yorumlayıcılarını desteklemenin zorlaştığını belirtiyor.

2.1 neler getiriyor

Özellik tarafında duyuru üç eklemeyi öne çıkarıyor. Mevcut text() yapısının bir varyantı olan yeni tstring() yapısı, t-string desteğini getiriyor ve bind parametrelerinin düz string SQL ifadeleri içinde dinamik olarak belirtilmesine izin veriyor. CREATE VIEW ve CREATE TABLE AS artık doğal olarak destekleniyor ve yıllardır proje tariflerinde dolaşan CreateView yapısını sunuyor. SQLAlchemy 2.1 ayrıca Microsoft'un mssql-python sürücüsü için destek getiriyor; proje bunu Microsoft ekibiyle yakın çalışarak geliştirdiklerini söylüyor.

2.1, 2.0'ın üzerinden üç yıl sonra geldiği için genel değişiklik ve iyileştirme listesi uzun ve duyuru, yükseltme yapanları ayrıntılı changelog'un yanı sıra "What's New in SQLAlchemy 2.1?" geçiş kılavuzuna yönlendiriyor.

Neden önemli

SQLAlchemy, Python ekosistemindeki veritabanı çalışmalarının büyük bir bölümünün temelini oluşturuyor ve varsayılan sürüm değişikliği hızla yayılıyor: yeni kurulumlar, sabitlenmemiş CI çalışmaları ve yeni Docker build'leri hemen 2.1.0'ı çekmeye başlıyor.

Sert değişikliklerden ikisi gürültülü değil sessiz biçimde başarısız oluyor. Çıplak bir postgresql:// bağlantı dizisi altta yatan sürücüyü sessizce psycopg3'e değiştiriyor ve bu durum üretimde davranış farkları ortaya çıkarabilir; asyncio extra'sını eklemeden yükselten async uygulamalar ise çalışma zamanında eksik bir greenlet bağımlılığıyla karşılaşacak.

Sürümleri tam olarak sabitleyen ekipler şimdilik etkilenmiyor, ancak kayan sürüm kısıtlamalarıyla çalışan herkes bir sonraki build'lerinden önce geçiş kılavuzunu okumalı — ve CI imajlarının Python 3.11 veya daha yeni bir sürüm çalıştırdığından emin olmalı.