IDatabase.php

Go to the documentation of this file.

<?php
namespace Wikimedia\Rdbms;
 
use Exception;
use Wikimedia\ScopedCallback;
 
// Very long type annotations :(
// phpcs:disable Generic.Files.LineLength
 
interface IDatabase extends IReadableDatabase {
    public const TRIGGER_IDLE = 1;
    public const TRIGGER_COMMIT = 2;
    public const TRIGGER_ROLLBACK = 3;
    public const TRIGGER_CANCEL = 4;
 
    public const TRANSACTION_EXPLICIT = '';
    public const TRANSACTION_INTERNAL = 'implicit';
 
    public const ATOMIC_NOT_CANCELABLE = '';
    public const ATOMIC_CANCELABLE = 'cancelable';
 
    public const FLUSHING_ONE = '';
    public const FLUSHING_ALL_PEERS = 'flush';
    public const FLUSHING_INTERNAL = 'flush-internal';
 
    public const ESTIMATE_TOTAL = 'total';
    public const ESTIMATE_DB_APPLY = 'apply';
 
    public const LOCK_TIMESTAMP = 1;
 
    public const LB_TRX_ROUND_ID = 'trxRoundId';
    public const LB_READ_ONLY_REASON = 'readOnlyReason';
 
    public const ROLE_STREAMING_MASTER = 'streaming-master';
    public const ROLE_STREAMING_REPLICA = 'streaming-replica';
    public const ROLE_STATIC_CLONE = 'static-clone';
    public const ROLE_UNKNOWN = 'unknown';
 
    public function trxLevel();
 
    public function trxTimestamp();
 
    public function explicitTrxActive();
 
    public function getLBInfo( $name = null );
 
    public function insertId();
 
    public function affectedRows();
 
    public function query( $sql, $fname = __METHOD__, $flags = 0 );
 
    public function newUpdateQueryBuilder(): UpdateQueryBuilder;
 
    public function newDeleteQueryBuilder(): DeleteQueryBuilder;
 
    public function newInsertQueryBuilder(): InsertQueryBuilder;
 
    public function newReplaceQueryBuilder(): ReplaceQueryBuilder;
 
    public function lockForUpdate(
        $table, $conds = '', $fname = __METHOD__, $options = [], $join_conds = []
    );
 
    public function insert( $table, $rows, $fname = __METHOD__, $options = [] );
 
    public function update( $table, $set, $conds, $fname = __METHOD__, $options = [] );
 
    public function replace( $table, $uniqueKeys, $rows, $fname = __METHOD__ );
 
    public function upsert(
        $table, array $rows, $uniqueKeys, array $set, $fname = __METHOD__
    );
 
    public function deleteJoin(
        $delTable,
        $joinTable,
        $delVar,
        $joinVar,
        $conds,
        $fname = __METHOD__
    );
 
    public function delete( $table, $conds, $fname = __METHOD__ );
 
    public function insertSelect(
        $destTable,
        $srcTable,
        $varMap,
        $conds,
        $fname = __METHOD__,
        $insertOptions = [],
        $selectOptions = [],
        $selectJoinConds = []
    );
 
    public function onTransactionResolution( callable $callback, $fname = __METHOD__ );
 
    public function onTransactionCommitOrIdle( callable $callback, $fname = __METHOD__ );
 
    public function onTransactionPreCommitOrIdle( callable $callback, $fname = __METHOD__ );
 
    public function onAtomicSectionCancel( callable $callback, $fname = __METHOD__ );
 
    public function startAtomic( $fname = __METHOD__, $cancelable = self::ATOMIC_NOT_CANCELABLE );
 
    public function endAtomic( $fname = __METHOD__ );
 
    public function cancelAtomic( $fname = __METHOD__, AtomicSectionIdentifier $sectionId = null );
 
    public function doAtomicSection(
        $fname, callable $callback, $cancelable = self::ATOMIC_NOT_CANCELABLE
    );
 
    public function begin( $fname = __METHOD__, $mode = self::TRANSACTION_EXPLICIT );
 
    public function commit( $fname = __METHOD__, $flush = self::FLUSHING_ONE );
 
    public function rollback( $fname = __METHOD__, $flush = self::FLUSHING_ONE );
 
    public function flushSnapshot( $fname = __METHOD__, $flush = self::FLUSHING_ONE );
 
    public function setSessionOptions( array $options );
 
    public function lockIsFree( $lockName, $method );
 
    public function lock( $lockName, $method, $timeout = 5, $flags = 0 );
 
    public function unlock( $lockName, $method );
 
    public function getScopedLockAndFlush( $lockKey, $fname, $timeout );
 
    public function isReadOnly();
}