Tüm Ürünler
Search
Belge Merkezi

PolarDB:Envanter İpucu

Son Güncelleme:Oct 07, 2026

Envanter ipuçları, işlemi işleme veya geri alma mantığını doğrudan SQL deyimlerine gömerek bir SQL deyiminin sonucuna göre hareket etmenizi sağlar. Flash satışlar ve stok düşümü gibi yüksek eşzamanlı yazma senaryolarında, birden çok işlem aynı satırı aynı anda güncellemeye çalışarak aktarım hızını düşüren kilit çekişmesine neden olur. Envanter ipuçları, her bir rekabetçi yazmayı tek bir gidiş-dönüşte çözerek uygulama düzeyinde yeniden deneme mantığına duyulan ihtiyacı ortadan kaldırır. Bunları, çatışan yazmaları paketlere seri hale getirmek ve aktarım hızını en üst düzeye çıkarmak için statement queue özelliğiyle birlikte kullanın.

Desteklenen sürümler

Envanter ipuçları aşağıdaki PolarDB for MySQL sürümlerinde kullanılabilir:

Sürüm Minimum çekirdek alt sürümü
PolarDB for MySQL 8,0 8,0.1.1.1
PolarDB for MySQL 5,7 5,7.1.0.17
PolarDB for MySQL 5,6 Tüm alt sürümler

Kümenizin çekirdek alt sürümünü kontrol etmek için bkz. Altyapı sürümünü sorgulama.

Çalışma prensibi

Envanter ipuçları SELECT, UPDATE, INSERT ve DELETE deyimlerini destekler. Üç ipucu mevcuttur:

İpucu Etkisi Ne zaman tetiklenir
COMMIT_ON_SUCCESS Geçerli işlemi işler Deyim başarıyla yürütülür
ROLLBACK_ON_FAIL Geçerli işlemi geri alır Deyim başarısız olur
TARGET_AFFECT_ROW(n) Etkilenen satır sayısı n değerine eşit değilse deyimi başarısız olarak işaretler Deyim yürütme sırasında

İpuçları, hem DML işlemini hem de işlem sonucunu tek bir deyimde yönlendirmek için birlikte çalışır:

  • COMMIT_ON_SUCCESS deyimin başarılı olması durumunda işlemi hemen işler.

  • ROLLBACK_ON_FAIL deyimin başarısız olması durumunda işlemi hemen geri alır.

  • TARGET_AFFECT_ROW(n) satır sayısı uyuşmazlığını (örneğin, stoku tükenmiş bir ürünün güncellenmesi) bir deyim hatasına dönüştürür; bu hata daha sonra ROLLBACK_ON_FAIL tarafından yakalanır.

Üç ipucunun tamamını statement queue ile birleştirdiğinizde, çatışan yazmalar paketlere seri hale getirilir ve her işlem tek bir gidiş-dönüşte çözülür.

Sözdizimi

Sözdizimi, PolarDB for MySQL 5,6 ile PolarDB for MySQL 5,7/8,0 arasında farklılık gösterir.

COMMIT_ON_SUCCESS

Deyim başarılı olduğunda işlemi işler.

PolarDB for MySQL 5,6

UPDATE COMMIT_ON_SUCCESS t
SET c = c - 1
WHERE id = 1;

PolarDB for MySQL 5,7 ve 8,0

UPDATE /*+ COMMIT_ON_SUCCESS */ t
SET c = c - 1
WHERE id = 1;

ROLLBACK_ON_FAIL

Deyim başarısız olduğunda işlemi geri alır.

PolarDB for MySQL 5,6

UPDATE ROLLBACK_ON_FAIL t
SET c = c - 1
WHERE id = 1;

PolarDB for MySQL 5,7 ve 8,0

UPDATE /*+ ROLLBACK_ON_FAIL */ t
SET c = c - 1
WHERE id = 1;

TARGET_AFFECT_ROW

Etkilenen satır sayısı belirtilen değerle eşleşmezse deyimi başarısız olarak işaretler. Değer 1 olarak ayarlandığında, en az bir kayıt güncellenirse deyim başarılı olur. WHERE yan tümcesiyle eşleşen satır yoksa deyim başarısız olur ve bir hata döndürür.

PolarDB for MySQL 5,6

UPDATE TARGET_AFFECT_ROW 1 t
SET c = c - 1
WHERE id = 1;
-- ERROR HY000: The affected row number does not match that of user specified.

PolarDB for MySQL 5,7 ve 8,0

UPDATE /*+ TARGET_AFFECT_ROW(1) */ t
SET c = c - 1
WHERE id = 1;
-- ERROR HY000: The affected row number does not match that of user specified.

Statement Queue ile Kullanım

Çatışan yazmaları aynı pakete sıraya almak ve her işlemi tek geçişte çözmek için COMMIT_ON_SUCCESS, ROLLBACK_ON_FAIL ve TARGET_AFFECT_ROW ipuçlarını statement queue ile birleştirin.

PolarDB for MySQL 5,6 — bir anahtar ifadesi veya sabit değerle POLARDB_STATEMENT_CONCURRENT_QUEUE kullanır:

UPDATE COMMIT_ON_SUCCESS POLARDB_STATEMENT_CONCURRENT_QUEUE id ROLLBACK_ON_FAIL TARGET_AFFECT_ROW 1 t
SET col1 = col1 + 1
WHERE id = 1;
-- Query OK, 1 row affected (0.00 sec)
-- Rows matched: 1  Changed: 1  Warnings: 0

UPDATE COMMIT_ON_SUCCESS POLARDB_STATEMENT_CONCURRENT_QUEUE 1 ROLLBACK_ON_FAIL TARGET_AFFECT_ROW 1 t
SET col1 = col1 + 1
WHERE id = 1;
-- Query OK, 1 row affected (0.00 sec)
-- Rows matched: 1  Changed: 1  Warnings: 0

PolarDB for MySQL 5,7 ve 8,0 — /*+ ... */ ipucu bloğu içinde CCL_QUEUE_VALUE kullanır:

UPDATE /*+ COMMIT_ON_SUCCESS ROLLBACK_ON_FAIL TARGET_AFFECT_ROW(1) CCL_QUEUE_VALUE('id') */ t
SET col1 = col1 + 1
WHERE id = 1;
-- Query OK, 1 row affected (0.00 sec)
-- Rows matched: 1  Changed: 1  Warnings: 0

UPDATE /*+ COMMIT_ON_SUCCESS ROLLBACK_ON_FAIL TARGET_AFFECT_ROW(1) CCL_QUEUE_VALUE(1) */ t
SET col1 = col1 + 1
WHERE id = 1;
-- Query OK, 1 row affected (0.00 sec)
-- Rows matched: 1  Changed: 1  Warnings: 0

Kısıtlamalar

Kısıtlama Kapsam Ayrıntılar
autocommit modu Yalnızca PolarDB for MySQL 8,0 COMMIT_ON_SUCCESS ve ROLLBACK_ON_FAIL ipuçları, autocommit etkinleştirildiğinde çalıştırılamaz. Bu ipuçlarını kullanmadan önce autocommit özelliğini devre dışı bırakın veya deyimi açık bir işlem içine alın.

autocommit modunda COMMIT_ON_SUCCESS veya ROLLBACK_ON_FAIL çalıştırıldığında aşağıdaki hata döndürülür:

UPDATE /*+ ROLLBACK_ON_FAIL */ t
SET c = c - 1
WHERE id = 1;
-- ERROR 7531 (HY000): Inventory transactinal hints didn't allowed in autocommit mode