7.2.3. Объект sqldmo.SqlServer2

Это объект, представляющий сервер SQL Server. В SQL-DMO он называется SQLServer2. Чаще всего логика скрипта SQL-DMO выглядит так:

1. Создаем объект SQLServer2 и используем его для подключения к серверу,

2. Затем через объект SQLServer2 получаем доступ к подчиненным объектам (базам данных, учетным записям, заданиям и т.п.)

3. Выполняем с ними определенные операции,

4. Затем через SQLServer2 разрываем соединение.

Пример. Получение информации о размере свободного пространства во всех базах данных:

Set oServer = CreateObject("SQLDmo.SqlServer2")

'используем аутентификацию Windows

oServer.LoginSecure = True

oServer.Connect "Server1\Instance2"

For Each oDatabase In oServer.Databases

WScript.Echo oDatabase.Name & " " & oDatabase.SpaceAvailableInMB

Next

oServer.Disconnect

Set oServer = Nothing

Основные свойства объекта SQLServer2:

• CodePage — кодировка, установленная для всего SQL Server;

• LoginSecure — если для этого свойства используется значение False (по умолчанию), то, значит, мы подключаемся от имени учетной записи SQL Server и в методе Connect() нужно дополнительно указывать имя учетной записи и пароль. Если настроить для этого свойства значение True, будет использоваться аутентификация Windows;

• Name — имя SQL Server (которое использовалось в методе Connect()). Может быть и псевдонимом;

• NetName — реальное сетевое имя SQL Server (обычно используется тогда, когда при подключении к серверу мог быть использован псевдоним);

• RegionalSettings — региональные установки, настроенные для драйвера ODBC. Эти настройки можно изменить в ходе выполнения скрипта;

• SaLogin — это свойство дает возможность проверить, обладаем ли мы правами системного администратора на сервере. Обычно используется для проверок перед выполнением какой-либо операции;

• Status — возможность проверить текущее состояние SQL Server. Для этого свойства предусмотрено восемь значений:

  • 0 — состояние получить не удалось;

  • 1 — нормальное рабочее состояние;

  • 2 — работа службы приостановлена;

  • 3 — служба SQL Server остановлена;

  • 4 — происходит переход от состояния "остановлено" в состояние "запущено";

  • 5 — происходит обратный переход: от "запущено" к "остановлено";

  • 6 — сервер запускается после приостановки работы;

  • 7 — обратный переход: работа сервера приостанавливается;

Основные методы объекта SQLServer2:

• AddStartParameter() — этот метод позволяет добавить параметр запуска для SQL Server (например, для перевода в однопользовательский или минимальный режим, для запуска с базой данных master на другом диске);

• Connect()/Disconnect() — эти методы позволяют, соответственно, подключиться или отключиться от сервера SQL Server;

• ExecuteImmediate() — этот метод аналогичен методу ExecuteNonQuery() в SMO. Он позволяет запустить на выполнение команду или запрос на SQL Server, когда мы не собираемся принимать от нее никаких наборов записей;

• ExecuteWithResults() — этот метод позволяет выполнить команду Transact-SQL на сервере и получить возвращаемый ней табличный набор записей. Прием возвращаемых результатов производится при помощи объекта QueryResults;

• ExecuteWithResultsAndMessages() — этот метод расширяет возможности метода ExecuteWithResults(). Помимо результатов выполнения запроса он позволяет принять в строковую переменную сообщения SQL Server, которыми сопровождается выполнение этого запроса;

• IsPackage() — возможность проверить редакцию SQL Server. Этот метод может возвращать 5 значений:

  • 0 — возникла ошибка, значение получить не удалось;

  • 1 — Desktop Edition

  • 2 — Standard Edition

  • 3 — Enterprise или Developer Edition

  • 4 — SQL Server Express Edition (MSDE)

• Start()/Shutdown()/Pause()/Continue() — возможность, соответственно, запустить, остановить, перевести в режим паузы или продолжить работу SQL Server;

• ReadErrorLog() — возможность получить все содержимое журнала SQL Server в виде объекта QueryResult.

Объекты, доступ к которым можно получить при помощи свойств объекта SQLServer:

• BackupDevices — эта коллекция предназначена для работы с логическими устройствами резервного копирования;

• Configuration — это свойство дает возможность настроить через скрипт все параметры сервера, доступные средствами хранимой процедуры sp_configure;

• Databases — это возможность получить доступ к базам данных и их многочисленным объектам;

• FullTextService — работа из скрипта с полнотекстовыми каталогами;

• IntegratedSecurity — при помощи этого свойства можно получить доступ к одноименному объекту, при помощи которого настраиваются параметры безопасности (в Management Studio они доступны при помощи вкладки Security (Безопасность) свойств сервера);

• JobServer — как и в SMO, этот объект открывает возможность доступа к элементам автоматизации SQL Server Agent, таким, как задания, предупреждения и операторы;

• Languages — возможность получения информации об языковых модулях, установленных с SQL Server;

• LinkedServers — этот объект предназначен для работы с подключенными серверами (объектами LinkedServer);

• Logins — свойство для доступа к коллекции учетных записей SQL Server;

• Registry — возможность считать или изменять любые параметры реестра, относящиеся к данному экземпляру SQL Server;

• Replication — это свойство возвращает объект Replication, который можно использовать для настройки репликации средствами SQL-DMO;

• ServerRoles — этот объект открывает возможность работы со встроенными серверными ролями.