DB accessable external objects. More...

Inheritance diagram for ExternalStoreDB:

Collaboration diagram for ExternalStoreDB:

Public Member Functions
	batchFetchBlobs ( $cluster, array $ids)
	Fetch multiple blob items out of the database.

	batchFetchFromURLs (array $urls)
	Fetch data from given external store URLs.

	fetchBlob ( $cluster, $id, $itemID)
	Fetch a blob item out of the database; a cache of the last-loaded blob will be kept so that multiple loads out of a multi-item blob can avoid redundant database access and decompression.

	fetchFromURL ( $url)
	The provided URL is in the form of DB://cluster/id or DB://cluster/id/itemid for concatened storage.

	getLoadBalancer ( $cluster)
	Get a LoadBalancer for the specified cluster.

	getMaster ( $cluster)
	Get a master database connection for the specified cluster.

	getSlave ( $cluster)
	Get a replica DB connection for the specified cluster.

	getTable ( $db)
	Get the 'blobs' table name for this database.

	store ( $location, $data)
	Insert a data item into a given location.

Public Member Functions inherited from ExternalStoreMedium
	__construct (array $params=[])

Protected Member Functions
	parseURL ( $url)

Private Member Functions
	mergeBatchResult (array &$ret, array &$ids, $res)
	Helper function for self::batchFetchBlobs for merging master/replica DB results.

Additional Inherited Members
Protected Attributes inherited from ExternalStoreMedium
array	$params = []

Detailed Description

DB accessable external objects.

In this system, each store "location" maps to a database "cluster". The clusters must be defined in the normal LBFactory configuration.

Definition at line 31 of file ExternalStoreDB.php.

Member Function Documentation

◆ batchFetchBlobs()

ExternalStoreDB::batchFetchBlobs	(		$cluster,
		array	$ids
	)

Fetch multiple blob items out of the database.

Parameters

string	$cluster	A cluster name valid for use with LBFactory
array	$ids	A map from the blob_id's to look for to the requested itemIDs in the blobs

Returns: array A map from the blob_id's requested to their content. Unlocated ids are not represented

Definition at line 233 of file ExternalStoreDB.php.

References $dbr, $res, $ret, getMaster(), getSlave(), getTable(), mergeBatchResult(), and wfDebugLog().

Referenced by batchFetchFromURLs().

◆ batchFetchFromURLs()

ExternalStoreDB::batchFetchFromURLs ( array $urls )

Fetch data from given external store URLs.

The provided URLs are in the form of DB://cluster/id or DB://cluster/id/itemid for concatened storage.

Parameters

array $urls An array of external store URLs

Returns: array A map from url to stored content. Failed results are not represented.

Reimplemented from ExternalStoreMedium.

Definition at line 60 of file ExternalStoreDB.php.

References $blob, $res, $ret, $urls, as, batchFetchBlobs(), list, and parseURL().

◆ fetchBlob()

ExternalStoreDB::fetchBlob	(	$cluster,
		$id,
		$itemID
	)

Fetch a blob item out of the database; a cache of the last-loaded blob will be kept so that multiple loads out of a multi-item blob can avoid redundant database access and decompression.

Parameters