ASExecuteDDLTask Clase

Referencia

Definición

Espacio de nombres:: Microsoft.DataTransformationServices.Tasks.DTSProcessingTask

Ensamblado:: Microsoft.SqlServer.ASTasks.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Ejecuta comandos del lenguaje de definición de datos (DDL) en una instancia de Microsoft SQL Server Analysis Services.

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

Herencia: Object

DtsObject

Task

ASTaskBase
ASExecuteDDLTask

Atributos: DtsTaskAttribute GuidAttribute

Implementaciones: IDTSComponentPersist

Ejemplos

El ejemplo de código siguiente crea, configura y ejecuta un nuevo ASExecuteDDLTask objeto que carga la instrucción DDL para que se ejecute desde una conexión de archivo.

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

Constructores

ASExecuteDDLTask()

Crea una nueva instancia de la clase ASExecuteDDLTask.

Campos

bExecutionCanceled	La ejecución se cancela. (Heredado de ASTaskBase)
bTraceError	El error de seguimiento. (Heredado de ASTaskBase)
ddl	El lenguaje de definición de datos. (Heredado de ASTaskBase)
m_events	Eventos. (Heredado de ASTaskBase)
server	El servidor. (Heredado de ASTaskBase)

Propiedades

ConnectionName	Obtiene o establece el nombre de la conexión para la tarea de Analysis Services. (Heredado de ASTaskBase)
ExecutionValue	Obtiene el resultado de la tarea Ejecutar DDL de Analysis Services.
ProgressEventName	Obtiene el nombre del evento de progreso de la tarea de Analysis Services. (Heredado de ASTaskBase)
Source	Obtiene o establece el nombre del origen que contiene la instrucción DDL que se va a enviar al servidor de Analysis Services.
SourceType	Obtiene o establece un valor de la enumeración DDLSourceType que indica el tipo de origen que contiene las instrucciones DDL.
StatusEventName	Obtiene el nombre del evento de estado para la tarea Ejecutar DDL de Analysis Services.
SubComponentName	Obtiene el nombre del subcomponente para la tarea Ejecutar DDL de Analysis Services.
TargetServerVersion	Ejecuta comandos del lenguaje de definición de datos (DDL) en una instancia de Microsoft SQL Server Analysis Services. (Heredado de Task)
TaskDescription	Obtiene una descripción de la tarea Ejecutar DDL de Analysis Services.
TaskDisplayName	Obtiene el nombre único de la tarea Ejecutar DDL de Analysis Services.
Version	* Miembro desusado; ver Comentarios. * Devuelve la versión de la tarea. Esta propiedad es de sólo lectura. (Heredado de Task)

Métodos

CanUpdate(String)	*** Miembro desusado; ver Comentarios. Valor booleano que indica si el nuevo paquete XML puede actualizar el XML del paquete anterior. (Heredado de Task)
Equals(Object)	Determina si dos instancias de objeto son iguales. (Heredado de DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Ejecuta la tarea de Analysis Services (Heredado de ASTaskBase)
ExecuteCommand(String, Connections, IDTSComponentEvents, Object)	Ejecuta comandos del lenguaje de definición de datos (DDL) en una instancia de Microsoft SQL Server Analysis Services. (Heredado de ASTaskBase)
FireError(Int32, String, String, String)	Activa un evento cuando se produce un error. (Heredado de ASTaskBase)
FireError(String, String)	Activa un evento cuando se produce un error. (Heredado de ASTaskBase)
GetConnectionID(Connections, String)	Obtiene una cadena que contiene el identificador de la conexión. (Heredado de Task)
GetConnectionName(Connections, String)	Obtiene una cadena que contiene el nombre de la conexión. (Heredado de Task)
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)	Inicializa las propiedades asociadas a la tarea. El motor en tiempo de ejecución llama a este método, que no se usa en el código. (Heredado de Task)
InternalExecute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Ejecuta la tarea DDL internamente.
InternalValidate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Valida la tarea DDL internamente.
LoadFromXML(XmlElement, IDTSInfoEvents)	No se pueden realizar llamadas a este método desde el código de la aplicación. Para cargar un paquete guardado como .xml, utilice el método LoadPackage(String, IDTSEvents).
SaveToXML(XmlDocument, IDTSInfoEvents)	No se pueden realizar llamadas a este método desde el código de la aplicación. Para guardar un paquete como .xml, utilice el método SaveToXml(String, Package, IDTSEvents).
StopExecution()	Detiene la ejecución de la tarea de Analysis Services. (Heredado de ASTaskBase)
SubscribeToProgressEvent(SessionTrace)	Suscribe la tarea al evento de progreso. (Heredado de ASTaskBase)
UnsubscribeToProgressEvent(SessionTrace)	Cancela la suscripción la tarea del evento de progreso. (Heredado de ASTaskBase)
Update(String)	*** Miembro desusado; ver Comentarios. Este método actualiza el XML del paquete antiguo con el nuevo XML de paquete si CanUpdate(String) se establece en true. (Heredado de Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Valida la tarea de Analysis Services. (Heredado de ASTaskBase)
ValidateConnection(Connections)	Valida la conexión de tarea. (Heredado de ASTaskBase)
ValidateDDL(VariableDispenser, Connections, Exception)	Comprueba si la tarea DDL está correctamente configurada.
WriteLog(IDTSLogging, String)	Escribe un registro para la tarea. (Heredado de ASTaskBase)

Se aplica a