classInsertMutation

packages/ztd-query-core/src/Shadow/Mutation/Row/InsertMutation.php:21

final class InsertMutation
    implements DataMutation

Applies INSERT result rows to the shadow store.

Type Aliases§

Row = import from TableDefinition

Methods§

public function __construct(
    string $tableName,
    array<int, string> $primaryKeys = [],
    bool $ignore = false,
    TableDefinition|null $tableDefinition = null,
    string $sql = '',
    bool $validateConstraints = false,
    CandidateKeySet|null $candidateKeys = null,
    UpsertExpression|null $conflictPredicate = null,
)

source §

Parameters

`$tableName`	`string`	Target table.
`$primaryKeys`	`array<int, string>`	Primary key columns.
`$ignore`	`bool`	Whether to ignore duplicates (INSERT IGNORE).
`$tableDefinition`	`TableDefinition\|null`	Table definition for constraint validation.
`$sql`	`string`	Original SQL statement for exception messages.
`$validateConstraints`	`bool`	Whether to validate constraints.
`$candidateKeys`	`CandidateKeySet\|null`	Candidate keys used for duplicate detection.
`$conflictPredicate`	`UpsertExpression\|null`	Condition that controls candidate-key eligibility.

Calls 3

static-call CandidateKeySet::fromSchema() line 91
new RowConstraints line 93
new ConflictSearch line 94

public function apply(ShadowStore $store, array $rows): void

source §

{@inheritDoc}

Parameters

`$store`	`ShadowStore`
`$rows`	`array`

Throws

DuplicateKeyException When a row would collide with one already there on a candidate key

Test cases 22

Calls 6

method-call ShadowStore::get() line 104
method-call RowConstraints::assertNoNullWhereNoneIsAllowed() line 109
method-call ConflictSearch::of() line 112
new DuplicateKeyException line 119
method-call RowConstraints::assertNoDuplicateUniqueKey() line 129
method-call ShadowStore::insert() line 136

public function tableName(): string

source §

{@inheritDoc}

Returns

string

Test cases 3

Private surface 9§

Implementation details, listed for orientation only.

private string $tableName

private bool $ignore

private TableDefinition|null $tableDefinition

private string $sql

private bool $validateConstraints

private CandidateKeySet $candidateKeys

private ?UpsertExpression $conflictPredicate

private RowConstraints $constraints

private ConflictSearch $conflicts

Test cases 99§

Test cases that cover or call this symbol, from the coverage report and from the analyzed test sources.

Dedicated tests 12

Other tests reaching this symbol 87

Relations§

Instantiated in 5

Type checks 1

instanceof ZtdQuery\Shadow\Mutation\MutationImpact::isInsertLike() packages/ztd-query-core/src/Shadow/Mutation/MutationImpact.php:103