Другие классы и методы объектов AMO

Объекты Assembly

Объект Assembly создается путем добавления его в коллекцию сборок сервера и обновления объекта Assembly на сервере при помощи метода Update.

Чтобы удалить объект Assembly, к нему необходимо применить метод Drop объекта Assembly. При удалении объекта Assembly из коллекции сборок базы данных сама сборка не удаляется, она просто будет недоступна в приложении до следующего запуска.

Дополнительные сведения о доступных методах и свойствах см. в описании класса Microsoft.AnalysisServices..::..Assembly из пространства имен Microsoft.AnalysisServices.

Примечание по безопасности
Использование сборок COM может представлять угрозу безопасности. По этой причине, а также по ряду других сборки COM в службах Службы SQL Server 2008 Analysis Services (SSAS) являются устаревшими. Поддержка сборок COM в последующих версиях может быть прекращена.

Методы Backup и Restore

Методы Backup и Restore предназначены для создания резервной копии базы данных и восстановления служб Службы Analysis Services. Метод Backup принадлежит к объекту Database, а метод Restore — к объекту Server.

Резервное копирование базы данных могут выполнять только администраторы сервера и базы данных. Восстановить базу данных на сервере, отличном от того, с которого была создана ее резервная копия, могут только администраторы сервера. Администратор баз данных может восстановить базу данных путем перезаписи существующей базы данных только в том случае, если он является ее владельцем. Администратор баз данных может потерять доступ к восстановленной базе данных после ее восстановления, если она восстановлена с первоначальными определениями безопасности.

Файлы резервных копий баз данных должны иметь расширение ABF.

Метод Backup

Метод Restore

Общие параметры и свойства методов Backup и Restore

Объекты Trace

Трассировка — это платформа, предназначенная для наблюдения, воспроизведения и управления экземпляром служб Службы Analysis Services. Клиентское приложение, например Приложение SQL Server Profiler, подписывается на трассировку, после чего сервер в соответствии с ее определением будет отправлять ему определения трассировки.

Каждое событие описывается классом событий. Класс событий описывает тип сформированного события. Внутри класса событий более глубокое разделение событий на категории обеспечивают подклассы. Каждое событие описывается несколькими столбцами. Столбцы, описывающие событие трассировки, согласованы для всех событий, которые соответствуют структуре SQL-трассировки. Записываемые в каждый из столбцов сведения могут различаться в зависимости от класса события. Другими словами, стандартный набор столбцов определен для каждой трассировки, но их значения могут различаться в зависимости от классов событий. Например, столбец TextData используется для записи исходного языка ASSL для всех событий инструкций.

В определении трассировки может содержаться один или несколько классов событий, трассировка которых выполняется параллельно. В определение трассировки можно добавить один или несколько столбцов данных для каждого класса событий, при этом использовать все столбцы трассировки необязательно. Администратор базы данных может решить, какие столбцы из имеющихся должны быть включены в трассировку. Далее можно выполнять выборочную трассировку классов событий согласно условиям фильтра, наложенного на любой из столбцов трассировки.

Трассировки можно запускать и удалять. Несколько трассировок можно запустить одновременно. События трассировки могут захватываться в реальном времени или направляться в файл для анализа или воспроизведения в будущем. Средство Приложение SQL Server Profiler предназначено для анализа и воспроизведения событий трассировки служб Службы Analysis Services. Несколько соединений могут получать события из одной трассировки.

Трассировки можно разделить на две группы: трассировки сервера и трассировки сеанса. Трассировки сервера сообщают обо всех событиях на этом сервере, а трассировки сеанса сообщают только о событиях, происходящих в рамках текущего сеанса.

Трассировки из коллекции трассировок сервера определяются следующим образом.

1. Создайте объект Trace и заполните его основные данные. Помимо прочего укажите идентификатор трассировки, имя, имя файла журнала, режим добавления-перезаписи и др.

2. В коллекцию событий объекта трассировки добавьте события для наблюдения. Для каждого из событий будут добавлены столбцы данных.

3. Задайте фильтры для исключения ненужных строк данных путем добавления их в коллекцию фильтров.

4. Запустите трассировку. После создания трассировки сбор данных начинается не сразу.

5. Остановите трассировку.

6. Просмотрите файл трассировки с помощью средства Приложение SQL Server Profiler.

Трассировки из объекта сеанса создаются следующим образом.

1. Определите функции для обработки событий трассировки, формируемых в приложении объектом SessionTrace. Возможны следующие события: OnEvent и Stopped.

2. Добавьте определенные функции в обработчик события.

3. Запустите трассировку сеанса.

4. Выполните необходимые действия, при этом обработчики функций должны выполнить регистрацию событий.

5. Остановите трассировку сеанса.

6. Продолжите работу с приложением.

Класс CaptureLog и атрибут CaptureXML

Все действия, которые должны выполняться объектами AMO, отправляются на сервер в виде сообщений XML для аналитики. Объекты AMO предоставляют средства захвата всех этих событий без заголовков SOAP. Дополнительные сведения см. в разделе Знакомство с классами объектов AMO. CaptureLog — это реализованный в объектах AMO механизм для включения объектов и операций в сценарии. Объекты и операции будут включены в сценарии в XML для аналитики.

Чтобы начать захват XML, свойству CaptureXML серверного объекта необходимо присвоить значение true. После этого все действия, которые должны отправляться на сервер, будут захватываться классом CaptureLog. CaptureLog считается классом, поскольку у него есть метод Clear, предназначенный для очистки журнала захвата.

Чтобы прочитать журнал, необходимо получить коллекцию строк и выполнить ее перебор. Кроме того, можно объединить все журналы в строку при помощи метода ConcatenateCaptureLog объекта сервера. Метод ConcatenateCaptureLog принимает три параметра, два из которых являются обязательными. Обязательные параметры: transactional и parallel (оба логического типа). Если в качестве параметра transactional передано значение true, то это свидетельствует о том, что пакетный XML-файл будет создан в рамках одной транзакции. В противном случае каждая команда будет выполняться как отдельная транзакция. Если в качестве параметра parallel передано значение true, то это говорит о том, что все команды в пакетном файле будут записаны для параллельного выполнения. В противном случае они будут выполняться последовательно по мере регистрации.

Класс исключений AMOException

Класс исключения AMOException позволяет приложению легко перехватывать исключения, создаваемые объектами AMO.

При возникновении различных проблем объекты AMO формируют исключения. В следующей таблице приведены типы исключений, обрабатываемые объектами AMO. Исключения наследуются от класса AmoException.

См. также

Справочник

Основные понятия