mirror of
https://github.com/silverstripe/silverstripe-mssql
synced 2024-10-22 08:05:53 +02:00
9309cf3a50
API Update to support customtable names Update to support new namespaced orm Cleanup PHPDoc
115 lines
3.4 KiB
PHP
115 lines
3.4 KiB
PHP
<?php
|
|
|
|
namespace SilverStripe\MSSQL;
|
|
|
|
/**
|
|
* Specific support for SQL Azure databases running on Windows Azure.
|
|
* Currently only supports the SQLSRV driver from Microsoft.
|
|
*
|
|
* Some important things about SQL Azure:
|
|
*
|
|
* Selecting a database is not supported.
|
|
* In order to change the database currently in use, you need to connect to
|
|
* the database using the "Database" parameter with sqlsrv_connect()
|
|
*
|
|
* Multiple active result sets are not supported. This means you can't
|
|
* have two query results open at once.
|
|
*
|
|
* Fulltext indexes are not supported.
|
|
*
|
|
* @author Sean Harvey <sean at silverstripe dot com>
|
|
* @package mssql
|
|
*/
|
|
class MSSQLAzureDatabase extends MSSQLDatabase
|
|
{
|
|
|
|
/**
|
|
* List of parameters used to create new Azure connections between databases
|
|
*
|
|
* @var array
|
|
*/
|
|
protected $parameters = array();
|
|
|
|
public function fullTextEnabled()
|
|
{
|
|
return false;
|
|
}
|
|
|
|
public function __construct($parameters)
|
|
{
|
|
$this->connectDatabase($parameters);
|
|
}
|
|
|
|
/**
|
|
* Connect to a SQL Azure database with the given parameters.
|
|
* @param array $parameters Connection parameters set by environment
|
|
* - server: The server, eg, localhost
|
|
* - username: The username to log on with
|
|
* - password: The password to log on with
|
|
* - database: The database to connect to
|
|
* - windowsauthentication: Not supported for Azure
|
|
*/
|
|
public function connect($parameters)
|
|
{
|
|
$this->parameters = $parameters;
|
|
$this->connectDatabase($parameters['database']);
|
|
}
|
|
|
|
/**
|
|
* Connect to a database using the provided parameters
|
|
*
|
|
* @param string $database
|
|
*/
|
|
protected function connectDatabase($database)
|
|
{
|
|
$parameters = $this->parameters;
|
|
$parameters['database'] = $database;
|
|
$parameters['multipleactiveresultsets'] = 0;
|
|
|
|
// Ensure that driver is available (required by PDO)
|
|
if (empty($parameters['driver'])) {
|
|
$parameters['driver'] = $this->getDatabaseServer();
|
|
}
|
|
|
|
// Notify connector of parameters, instructing the connector
|
|
// to connect immediately to the Azure database
|
|
$this->connector->connect($parameters, true);
|
|
|
|
// Configure the connection
|
|
$this->query('SET QUOTED_IDENTIFIER ON');
|
|
$this->query('SET TEXTSIZE 2147483647');
|
|
}
|
|
|
|
/**
|
|
* Switches to the given database.
|
|
*
|
|
* IMPORTANT: SQL Azure doesn't support "USE", so we need
|
|
* to reinitialize the database connection with the requested
|
|
* database name.
|
|
* @see http://msdn.microsoft.com/en-us/library/windowsazure/ee336288.aspx
|
|
*
|
|
* @param string $name The database name to switch to
|
|
* @param bool $create
|
|
* @param bool|int $errorLevel
|
|
* @return bool
|
|
*/
|
|
public function selectDatabase($name, $create = false, $errorLevel = E_USER_ERROR)
|
|
{
|
|
$this->fullTextEnabled = null;
|
|
if (!$this->schemaManager->databaseExists($name)) {
|
|
// Check DB creation permisson
|
|
if (!$create) {
|
|
if ($errorLevel !== false) {
|
|
user_error("Attempted to connect to non-existing database \"$name\"", $errorLevel);
|
|
}
|
|
// Unselect database
|
|
$this->connector->unloadDatabase();
|
|
return false;
|
|
}
|
|
$this->schemaManager->createDatabase($name);
|
|
}
|
|
$this->connectDatabase($name);
|
|
return true;
|
|
}
|
|
}
|