SQL Oluşturma

SqlGenerator, bir MergeResult öğesini parametreli SQL ifadelerine dönüştürür. Tüm değerler parametre olarak bağlanır; SQL dizgesine asla eklenmez.

use Merql\Apply\SqlGenerator;

$statements = SqlGenerator::generate($result);

foreach ($statements as $stmt) {
    echo $stmt['sql'] . "\n";
    // INSERT INTO `posts` (`id`, `title`, `status`) VALUES (?, ?, ?)
    print_r($stmt['params']);
    // [42, 'New Title', 'publish']
}

Gözden geçirilmiş bir birleştirme planının yalnızca canlı satırlar beklenen anlık görüntüyle eşleşmeye devam ediyorsa uygulanması gerektiğinde generateGuarded() kullanın.

use Merql\Apply\SqlGenerator;
use Merql\Snapshot\SnapshotStore;

$statements = SqlGenerator::generateGuarded(
    $selectedResult,
    SnapshotStore::load('theirs'),
);

İfade biçimi

Her ifade, iki anahtarı olan ilişkisel bir dizidir:

[
    'sql'    => 'INSERT INTO `posts` (`id`, `title`) VALUES (?, ?)',
    'params' => [42, 'New Title'],
]

Tanımlayıcılar (tablo ve sütun adları), veritabanı sürücüsünün tırnaklama biçimiyle tırnak içine alınır. MySQL ters tırnak, SQLite çift tırnak kullanır. Sürücü belirtilmezse varsayılan olarak ters tırnak kullanılır.

İşlem sıralaması

İşlemler türe göre gruplandırılır ve şu sırayla yürütülür:

1. Önce INSERT işlemleri -- güncellemelerin başvurabilmesi için yeni satırlar önce oluşturulmalıdır.
2. İkinci olarak UPDATE işlemleri.
3. Son olarak DELETE işlemleri -- silinmeden önce satırlara yapılan başvurular kaldırılmalıdır.

$statements = SqlGenerator::generate($result);
// All INSERTs, then all UPDATEs, then all DELETEs.

Yabancı anahtar sıralaması

Yabancı anahtar bağımlılıkları sağlandığında, her grup içindeki işlemler topolojik olarak sıralanır. Ekleme ve güncelleme işlemlerinde üst tablolar alt tablolardan önce işlenir. Silme işlemlerinde alt tablolar üst tablolardan önce işlenir.

$fkDependencies = [
    'comments' => ['posts'],        // comments references posts
    'post_meta' => ['posts'],       // post_meta references posts
];

$statements = SqlGenerator::generate($result, fkDependencies: $fkDependencies);
// INSERTs: posts first, then comments and post_meta
// DELETEs: comments and post_meta first, then posts

ForeignKeyResolver bağımlılık grafiğinde topolojik sıralama yapar. Döngüsel bağımlılıklar algılanır ve sonsuz döngüleri önlemek için kırılır.

Otomatik yabancı anahtar algılama

Applier, yabancı anahtar ilişkilerini veritabanından otomatik olarak okur:

use Merql\Apply\Applier;

$applier = new Applier($connection);
$applied = $applier->apply($result);
// FK dependencies are read from the database via the driver.

Oluşturulan SQL örnekleri

INSERT

INSERT INTO `posts` (`id`, `title`, `content`, `status`) VALUES (?, ?, ?, ?)
-- params: [42, 'New Post', 'Body text', 'draft']

İşlem değerlerindeki tüm sütunlar dahil edilir.

UPDATE

UPDATE `posts` SET `title` = ?, `status` = ? WHERE `id` = ?
-- params: ['New Title', 'publish', 42]

Kimlik sütunları (birincil anahtar) SET ifadesinin dışında bırakılır ve WHERE ifadesinde kullanılır. WHERE ifadesinin değerleri satır anahtarının kodu çözülerek elde edilir.

DELETE

DELETE FROM `posts` WHERE `id` = ?
-- params: [42]

WHERE ifadesinde yalnızca kimlik sütunları yer alır.

Korumalı UPDATE

Korumalı güncellemeler hem kimlik koşullarını hem de beklenen canlı satır koşullarını içerir.

UPDATE `posts` SET `title` = ? WHERE `id` = ? AND `status` = ?
-- params: ['New Title', 42, 'draft']

Satır artık beklenen status değerine sahip değilse, ifade sıfır satırı etkiler ve korumalı uygulama işlemi geri alır.

Korumalı INSERT

Korumalı eklemeler, plan oluşturulduktan sonra ortaya çıkan bir kimliğe ekleme yapılmasını önlemek için NOT EXISTS kullanır.

INSERT INTO `posts` (`id`, `title`) SELECT ?, ? WHERE NOT EXISTS (
  SELECT 1 FROM `posts` WHERE `id` = ?
)
-- params: [42, 'New Post', 42]

NULL işleme

NULL değerler, parametreler dizisinde PHP null olarak iletilir. Bağlamayı bağlantı adaptörü yönetir:

$statements = SqlGenerator::generate($result);
// params might contain: [42, null, 'draft']
// The adapter binds null as SQL NULL

Deneme çalıştırması çıktısında NULL değerler, tırnak işareti olmadan NULL değişmez dizgesi olarak gösterilir.

Kimlik sütununu algılama

SqlGenerator, satır kimliğini oluşturan sütunları temel anlık görüntünün TableSnapshot::identityColumns değerine bakarak belirler. Bu sütunlar UPDATE ve DELETE ifadelerinin WHERE koşullarında kullanılır; UPDATE işlemlerinin SET koşullarından çıkarılır.

Temel anlık görüntü yoksa, değerler dizisindeki ilk sütun yedek olarak kullanılır. Değerler dizisi boşsa id varsayılır.

Sürücü geçirme

Tanımlayıcıların nasıl tırnak içine alınacağını denetlemek için bir Driver örneği geçirin:

use Merql\Driver\SqliteDriver;

$statements = SqlGenerator::generate(
    $result,
    driver: new SqliteDriver(),
);
// Uses double-quote quoting: "posts", "title"