ASExecuteDDLTask 类

定义

命名空间:: Microsoft.DataTransformationServices.Tasks.DTSProcessingTask

程序集:: Microsoft.SqlServer.ASTasks.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

对Microsoft SQL Server Analysis Services实例执行数据定义语言（DDL）命令。

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

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

[<Microsoft.SqlServer.Dts.Runtime.DtsTask(IconResource="ExecuteTaskIcon", LocalizationType=typeof(Microsoft.DataTransformationServices.Tasks.DTSProcessingTask.ASExecuteDDLTask), UITypeName="Microsoft.DataTransformationServices.Tasks.DTSProcessingTaskUI.ASExecuteDDLTaskUI, Microsoft.SqlServer.ASTasksUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("B8A6644B-E7A4-4409-8B78-59572781BD15")>]
type ASExecuteDDLTask = class
    inherit ASTaskBase
    interface 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=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
type ASExecuteDDLTask = class
    inherit ASTaskBase
    interface 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	数据定义语言。 (继承自 ASTaskBase)
m_events	事件。 (继承自 ASTaskBase)
server	服务器。 (继承自 ASTaskBase)

属性

名称	说明
ConnectionName	获取或设置分析服务任务连接的名称。 (继承自 ASTaskBase)
ExecutionValue	获取分析服务执行DDL任务的结果。
ProgressEventName	获取分析服务任务的进度事件名称。 (继承自 ASTaskBase)
Source	获取或设置包含DDL语句的源名称，发送给分析服务服务器。
SourceType	从枚举中获取或设置 DDLSourceType 一个值，指示包含DDL语句的源类型。
StatusEventName	获取分析服务执行DDL任务的状态事件名称。
SubComponentName	获取分析服务执行DDL任务的子组件名称。
TargetServerVersion	对Microsoft SQL Server Analysis Services实例执行数据定义语言（DDL）命令。 (继承自 Task)
TaskDescription	获得分析服务执行DDL任务的描述。
TaskDisplayName	获得分析服务执行DDL任务的唯一名称。
Version	成员被淘汰;参见备注。返回任务版本。此属性为只读。 (继承自 Task)

方法

名称	说明
CanUpdate(String)	成员被淘汰;参见备注。一个布尔值，表示新包的 XML 是否可以更新旧包的 XML。 (继承自 Task)
Equals(Object)	确定两个对象实例是否相等。 (继承自 DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	执行分析服务任务。 (继承自 ASTaskBase)
ExecuteCommand(String, Connections, IDTSComponentEvents, Object)	对Microsoft SQL Server Analysis Services实例执行数据定义语言（DDL）命令。 (继承自 ASTaskBase)
FireError(Int32, String, String, String)	当发生错误时，会触发事件。 (继承自 ASTaskBase)
FireError(String, String)	当发生错误时，会触发事件。 (继承自 ASTaskBase)
GetConnectionID(Connections, String)	获得包含连接ID的字符串。 (继承自 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()	停止分析服务任务的执行。 (继承自 ASTaskBase)
SubscribeToProgressEvent(SessionTrace)	订阅“任务推进”活动。 (继承自 ASTaskBase)
UnsubscribeToProgressEvent(SessionTrace)	取消了进度事件中的任务订阅。 (继承自 ASTaskBase)
Update(String)	成员被淘汰;参见备注。如果 CanUpdate(String) 将设置为 true，该方法将旧包 XML 更新为新的包 XML。 (继承自 Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	验证分析服务任务。 (继承自 ASTaskBase)
ValidateConnection(Connections)	验证任务关联。 (继承自 ASTaskBase)
ValidateDDL(VariableDispenser, Connections, Exception)	验证DDL任务是否正确配置。
WriteLog(IDTSLogging, String)	为任务写日志。 (继承自 ASTaskBase)

适用于