Shopify API Limitleri: Büyük Katalog Aktarımı Nasıl Planlanır?

İstek sayısı yerine yapılan işi ölçün

GraphQL Admin API için kapasite değerlendirmesinde sorgu maliyeti önemlidir. Her istek aynı yükü oluşturmaz; çok sayıda ilişkili alanı isteyen bir sorgu ile yalnızca ürün kimliğini isteyen sorgu farklı maliyet taşır. Kullanılan API, mağaza planı ve sürümün güncel sınırları resmî dokümantasyondan kontrol edilmelidir. [1]

Bu nedenle aktarım teklifinde yalnızca “dakikada kaç istek” sorusu sormayın. Bir ürünün varyantları, görselleri ve özel alanları için hangi verilerin okunacağı belirlenmelidir. Kullanılmayan alanları sürekli çekmek hem işlem süresini hem hata analizini büyütür. İlk prova gerçek kataloğun temsilî bir örneğiyle yapılmalıdır.

Tam aktarım ile artımlı eşitlemeyi ayırın

İlk geçişte bütün kataloğun okunması gerekebilir. Sonraki çalışmalarda ise değişen kayıtların aktarılması yeterli olabilir. Bu iki işlemi aynı mekanizma altında sürekli tam tarama yaparak çözmek yerine farklı iş akışları olarak planlayın. Silinen ürün, yeniden açılan varyant ve güncellenen fiyat için kaynak işaretlerinin nasıl tutulacağını belirleyin.

Artımlı aktarımda son kontrol zamanını kaydetmek tek başına yeterli olmayabilir. Saat farkları, geciken güncellemeler ve aynı anda değişen kayıtlar için örtüşen bir okuma aralığı ile kimlik bazlı tekrar önleme tasarlanabilir. Bu, önerilen bir çözüm örneğidir; uygulanacak yöntem kaynağın değişiklik takibi yeteneklerine bağlıdır.

Toplu işlemi doğru yerde kullanın

Shopify GraphQL Admin API toplu sorguları, büyük veri kümelerini eşzamansız olarak almak için sunar. Sonuçların indirilmesi ve işlenmesi, işi başlatan istekten ayrıdır. İşin başlatıldığını görmek aktarımın tamamlandığı anlamına gelmez; durum ve sonuç dosyası ayrıca takip edilir. [2]

Toplu iş seçildiğinde uygulamanın sorumluluğu ortadan kalkmaz. Sonuç dosyasını doğrulamak, ilişkileri yeniden kurmak, eksik alanları ayırmak ve hedef sisteme güvenli şekilde yazmak gerekir. Birden fazla çalışma başlatıldığında aynı kaynağın iki kez işlenmesini önleyecek iş kimliği de tutulmalıdır.

Örnek: gece yarıda kalan katalog geçişi

Varsayımsal bir mağazada aktarım dosyasının bir kısmı işlendikten sonra çalışan süreç kapanıyor. Baştan başlamak yerine doğrulanmış kontrol noktasından devam etmek isteyebilirsiniz. Bunun için son okunan satır numarasının yanında hedefe kalıcı yazıldığı bilinen kayıt kimlikleri ve kaynak dosyanın özeti de tutulmalıdır.

Dosya aynı isimle yenilenmişse eski satır numarası artık başka ürünü gösterebilir. Bu yüzden devam işlemi kaynak sürümüne bağlanmalıdır. Tek ürün hatası bütün kataloğun sessizce atlanmasına neden olmamalı; hatalı satır ayrı raporlanırken bağımsız kayıtların ilerlemesi mümkün olmalıdır.

Hata türüne göre tekrar politikası seçin

Kapasite sınırı veya geçici ağ sorunu için bekleyerek yeniden deneme uygun olabilir. Geçersiz seçenek adı ya da bulunmayan referans ise verinin düzeltilmesini gerektirir. Bu ayrımı yapmayan sistem aynı hatayı tekrar ederek kaynak tüketir. Deneme sayısı, bekleme politikası ve operatör müdahalesi açık olsun.

Aktarım sırasında mağazada ürün değiştiriliyorsa hangi tarafın değerinin korunacağını da belirleyin. Eski dosyadaki fiyatı yeni canlı fiyatın üstüne yazmak teknik olarak başarılı fakat ticari açıdan yanlış bir işlem olabilir. Kaynak sahipliği alan bazında tanımlanmalıdır; bütün ürün için tek bir öncelik her zaman yeterli değildir.

Sayı eşitliği dışında doğrulama yapın

Kaynakta ve hedefte aynı sayıda ürün olması bütün kayıtların doğru olduğunu kanıtlamaz. Ürün-varyant bağlarını, para birimini, fiyatları, yayın durumunu ve görsel referanslarını örnekleyerek karşılaştırın. Hatalı satırların toplamı, başarılı sayılarla birlikte görünmelidir. Başarı yüzdesi verilecekse pay ve payda açıkça tanımlansın.

Teslimde çalıştırılabilir aktarım yönergesi, hata raporu, yeniden başlatma denemesi ve geri dönüş planı isteyin. Tamamlanma süresi tahmini ancak temsilî prova sonrasında anlamlı hale gelir; katalog hacminden tek başına kesin süre çıkarılmamalıdır.

Sık sorulan sorular

### Daha çok eşzamanlı istek her zaman daha hızlı mı? Hayır. Kapasite sınırlarına yaklaşırken bekleme ve yeniden denemeler artabilir. Uygulama, sunucunun geri bildirimine göre iş yükünü ayarlamalıdır.

Toplu sorgu sonuçlarını doğrudan canlıya yazabilir miyim?

Önce şema, kaynak sürümü ve örnek kayıtları doğrulayın. Özellikle fiyat ve yayın durumunda, önizleme veya kontrollü küçük bir partiyle başlamak daha güvenli bir çalışma yöntemidir.