ASExecuteDDLTask Класс

Определение

Пространство имен:

Microsoft.DataTransformationServices.Tasks.DTSProcessingTask

Сборка:

Microsoft.SqlServer.ASTasks.dll

Выполняет команды языка определения данных (DDL) для экземпляра Microsoft SQL Server Analysis Services.

public ref class ASExecuteDDLTask : Microsoft::DataTransformationServices::Tasks::DTSProcessingTask::ASTaskBase, Microsoft::SqlServer::Dts::Runtime::IDTSComponentPersist

[System.Runtime.InteropServices.Guid("B8A6644B-E7A4-4409-8B78-59572781BD15")]
[Microsoft.SqlServer.Dts.Runtime.DtsTask(IconResource="ExecuteTaskIcon", LocalizationType=typeof(Microsoft.DataTransformationServices.Tasks.DTSProcessingTask.ASExecuteDDLTask), UITypeName="Microsoft.DataTransformationServices.Tasks.DTSProcessingTaskUI.ASExecuteDDLTaskUI, Microsoft.SqlServer.ASTasksUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
public class ASExecuteDDLTask : Microsoft.DataTransformationServices.Tasks.DTSProcessingTask.ASTaskBase, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist

[<System.Runtime.InteropServices.Guid("B8A6644B-E7A4-4409-8B78-59572781BD15")>]
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(IconResource="ExecuteTaskIcon", LocalizationType=typeof(Microsoft.DataTransformationServices.Tasks.DTSProcessingTask.ASExecuteDDLTask), UITypeName="Microsoft.DataTransformationServices.Tasks.DTSProcessingTaskUI.ASExecuteDDLTaskUI, Microsoft.SqlServer.ASTasksUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
type ASExecuteDDLTask = class
    inherit ASTaskBase
    interface IDTSComponentPersist

Public Class ASExecuteDDLTask
Inherits ASTaskBase
Implements IDTSComponentPersist

Наследование

Object

DtsObject

Task

ASTaskBase

ASExecuteDDLTask

Атрибуты

DtsTaskAttribute GuidAttribute

Реализации

IDTSComponentPersist

Примеры

В следующем примере кода создается, настраивается и выполняется новый ASExecuteDDLTask объект , который загружает инструкцию DDL для выполнения из подключения к файлу.

using Microsoft.SqlServer.Dts.Runtime;  
using Microsoft.DataTransformationServices.Tasks.DTSProcessingTask;  

class Module1  
{  

  public static void Main()  
  {  

    Package pkg = new Package();  

    ConnectionManager asCM;  
    asCM = pkg.Connections.Add("MSOLAP100");  
    asCM.Name = "Analysis Services Connection Manager";  
    asCM.ConnectionString = "Data Source=<servername>;" +  
      "Initial Catalog=Adventure Works DW;Provider=MSOLAP;" +  
      "Integrated Security=SSPI;Impersonation Level=Impersonate;";  

    ConnectionManager cmdCM;  
    cmdCM = pkg.Connections.Add("FILE");  
    cmdCM.Name = "Command Source Connection Manager";  
    cmdCM.ConnectionString = "C:\\ddltest.txt";  

    Executable exe = pkg.Executables.Add("Microsoft.DataTransformationServices.Tasks.DTSProcessingTask.ASExecuteDDLTask, " +  
      "Microsoft.SqlServer.ASTasks, Version=10.0.0.0, " +  
      "Culture=neutral, PublicKeyToken=89845dcd8080cc91");  
    TaskHost thTask = (TaskHost) exe;  
    {  
      thTask.Properties("ConnectionName").SetValue(thTask, "Analysis Services Connection Manager");  
      thTask.Properties("SourceType").SetValue(thTask, DDLSourceType.FileConnection);  
      thTask.Properties("Source").SetValue(thTask, "Command Source Connection Manager");  
    }  

    DTSExecResult valResults = pkg.Validate(pkg.Connections, pkg.Variables, null, null);  

    if (valResults==DTSExecResult.Success)  
    {  
      pkg.Execute();  
    }  

  }  

}  

Imports Microsoft.SqlServer.Dts.Runtime  
Imports Microsoft.DataTransformationServices.Tasks.DTSProcessingTask  

Module Module1  

  Sub Main()  

    Dim pkg As New Package  

    Dim asCM As ConnectionManager  
    asCM = pkg.Connections.Add("MSOLAP100")  
    asCM.Name = "Analysis Services Connection Manager"  
    asCM.ConnectionString = "Data Source=<servername>;" & _  
      "Initial Catalog=Adventure Works DW;Provider=MSOLAP;" & _  
      "Integrated Security=SSPI;Impersonation Level=Impersonate;"  

    Dim cmdCM As ConnectionManager  
    cmdCM = pkg.Connections.Add("FILE")  
    cmdCM.Name = "Command Source Connection Manager"  
    cmdCM.ConnectionString = "C:\ddltest.txt"  

    Dim exe As Executable = pkg.Executables.Add( _  
      "Microsoft.DataTransformationServices.Tasks.DTSProcessingTask.ASExecuteDDLTask, " & _  
      "Microsoft.SqlServer.ASTasks, Version=10.0.0.0, " & _  
      "Culture=neutral, PublicKeyToken=89845dcd8080cc91")  
    Dim thTask As TaskHost = CType(exe, TaskHost)  
    With thTask  
      .Properties("ConnectionName").SetValue(thTask, _  
        "Analysis Services Connection Manager")  
      .Properties("SourceType").SetValue(thTask, DDLSourceType.FileConnection)  
      .Properties("Source").SetValue(thTask, "Command Source Connection Manager")  
    End With  

    Dim valResults As DTSExecResult = pkg.Validate( _  
      pkg.Connections, pkg.Variables, Nothing, Nothing)  

    If valResults = DTSExecResult.Success Then  
      pkg.Execute()  
    End If  

  End Sub  

End Module  

Конструкторы

ASExecuteDDLTask()

Создает новый экземпляр класса ASExecuteDDLTask.

Поля

bExecutionCanceled	Выполнение отменено. (Унаследовано от ASTaskBase)
bTraceError	Ошибка трассировки. (Унаследовано от ASTaskBase)
ddl	Язык описания данных DDL. (Унаследовано от ASTaskBase)
m_events	События. (Унаследовано от ASTaskBase)
server	Сервер. (Унаследовано от ASTaskBase)

Свойства

ConnectionName	Возвращает или задает имя соединения для задачи служб Analysis Services. (Унаследовано от ASTaskBase)
ExecutionValue	Возвращает результат задачи выполнения DDL служб Analysis Services.
ProgressEventName	Возвращает имя события хода выполнения для задачи служб Analysis Services. (Унаследовано от ASTaskBase)
Source	Возвращает или задает имя источника, содержащего инструкцию DDL для отправки на сервер служб Analysis Services.
SourceType	Возвращает или задает значение из перечисления DDLSourceType, показывающее тип источника, содержащего инструкцию DDL.
StatusEventName	Возвращает имя события состояния для задачи "Выполнение DDL служб Analysis Services".
SubComponentName	Возвращает имя подкомпонента для задачи "Выполнение DDL служб Analysis Services".
TargetServerVersion	Выполняет команды языка определения данных (DDL) для экземпляра Microsoft SQL Server Analysis Services. (Унаследовано от Task)
TaskDescription	Возвращает описание задачи выполнения DDL служб Analysis Services.
TaskDisplayName	Возвращает уникальное имя задачи выполнения DDL служб Analysis Services.
Version	*** Элемент устарел; см. примечания. *** Возвращает версию задания. Это свойство доступно только для чтения. (Унаследовано от Task)

Методы

CanUpdate(String)	*** Элемент устарел; см. примечания. Логическое значение, указывающее, может ли новый XML-код пакета обновить старый XML-код пакета. (Унаследовано от Task)
Equals(Object)	Определяет, равны ли два экземпляра объекта. (Унаследовано от DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Выполняет задачу служб Analysis Services. (Унаследовано от ASTaskBase)
ExecuteCommand(String, Connections, IDTSComponentEvents, Object)	Выполняет команды языка определения данных (DDL) для экземпляра Microsoft SQL Server Analysis Services. (Унаследовано от ASTaskBase)
FireError(Int32, String, String, String)	Формирует событие, возникающее в случае ошибки. (Унаследовано от ASTaskBase)
FireError(String, String)	Формирует событие, возникающее в случае ошибки. (Унаследовано от ASTaskBase)
GetConnectionID(Connections, String)	Возвращает строку, содержащую идентификатор соединения. (Унаследовано от Task)
GetConnectionName(Connections, String)	Возвращает строку, содержащую имя соединения. (Унаследовано от Task)
GetHashCode()	Возвращает хэш-код данного экземпляра. (Унаследовано от DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)	Инициализирует свойства, связанные с задачей. Этот метод вызывается средой выполнения и не используется в коде. (Унаследовано от Task)
InternalExecute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Выполняет задачу DDL внутренним образом.
InternalValidate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Проверяет задачу DDL внутренним образом.
LoadFromXML(XmlElement, IDTSInfoEvents)	Вызов этого метода кодом вашего приложения невозможен. Для загрузки пакета, сохраненного в виде XML-файла, используйте метод LoadPackage(String, IDTSEvents).
SaveToXML(XmlDocument, IDTSInfoEvents)	Вызов этого метода кодом вашего приложения невозможен. Для сохранения пакета в виде XML-файла используйте метод SaveToXml(String, Package, IDTSEvents).
StopExecution()	Останавливает выполнение задачи служб Analysis Services. (Унаследовано от ASTaskBase)
SubscribeToProgressEvent(SessionTrace)	Оформляет подписку задачи на событие хода выполнения. (Унаследовано от ASTaskBase)
UnsubscribeToProgressEvent(SessionTrace)	Отменяет подписку задачи на событие хода выполнения. (Унаследовано от ASTaskBase)
Update(String)	*** Элемент устарел; см. примечания. Этот метод обновляет старый XML-код пакета новым, если CanUpdate(String) имеет значение true. (Унаследовано от Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Проверяет задачу служб Analysis Services. (Унаследовано от ASTaskBase)
ValidateConnection(Connections)	Проверяет соединение задачи. (Унаследовано от ASTaskBase)
ValidateDDL(VariableDispenser, Connections, Exception)	Проверяет, правильно ли настроена задача DDL.
WriteLog(IDTSLogging, String)	Записывает журнал для задачи. (Унаследовано от ASTaskBase)