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_SUCCESSdeyimin başarılı olması durumunda işlemi hemen işler.ROLLBACK_ON_FAILdeyimin 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 sonraROLLBACK_ON_FAILtarafı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