Compartir a través de

  • Artículo

Clase ASExecuteDDLTask

Executes Data Definition Language (DDL) commands against an instance of Microsoft SQL Server Analysis Services.

Jerarquía de herencia

System. . :: . .Object
  Microsoft.SqlServer.Dts.Runtime. . :: . .DtsObject
    Microsoft.SqlServer.Dts.Runtime. . :: . .Task
      Microsoft.DataTransformationServices.Tasks.DTSProcessingTask. . :: . .ASTaskBase
        Microsoft.DataTransformationServices.Tasks.DTSProcessingTask..::..ASExecuteDDLTask

Espacio de nombres:  Microsoft.DataTransformationServices.Tasks.DTSProcessingTask
Ensamblado:  Microsoft.SqlServer.ASTasks (en Microsoft.SqlServer.ASTasks.dll)

Sintaxis

'Declaración
<GuidAttribute("FC95DF06-8E20-4f90-BFD5-B48AFA59C158")> _
<DtsTaskAttribute(LocalizationType := GetType(ASExecuteDDLTask), UITypeName := "Microsoft.DataTransformationServices.Tasks.DTSProcessingTaskUI.ASExecuteDDLTaskUI, Microsoft.SqlServer.ASTasksUI, Version=10.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91",  _
    IconResource := "ExecuteTaskIcon")> _
Public Class ASExecuteDDLTask _
    Inherits ASTaskBase _
    Implements IDTSComponentPersist
'Uso
Dim instance As ASExecuteDDLTask

[GuidAttribute("FC95DF06-8E20-4f90-BFD5-B48AFA59C158")]
[DtsTaskAttribute(LocalizationType = typeof(ASExecuteDDLTask), UITypeName = "Microsoft.DataTransformationServices.Tasks.DTSProcessingTaskUI.ASExecuteDDLTaskUI, Microsoft.SqlServer.ASTasksUI, Version=10.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91", 
    IconResource = "ExecuteTaskIcon")]
public class ASExecuteDDLTask : ASTaskBase, 
    IDTSComponentPersist

[GuidAttribute(L"FC95DF06-8E20-4f90-BFD5-B48AFA59C158")]
[DtsTaskAttribute(LocalizationType = typeof(ASExecuteDDLTask), UITypeName = L"Microsoft.DataTransformationServices.Tasks.DTSProcessingTaskUI.ASExecuteDDLTaskUI, Microsoft.SqlServer.ASTasksUI, Version=10.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91", 
    IconResource = L"ExecuteTaskIcon")]
public ref class ASExecuteDDLTask : public ASTaskBase, 
    IDTSComponentPersist

[<GuidAttribute("FC95DF06-8E20-4f90-BFD5-B48AFA59C158")>]
[<DtsTaskAttribute(LocalizationType = typeof(ASExecuteDDLTask), UITypeName = "Microsoft.DataTransformationServices.Tasks.DTSProcessingTaskUI.ASExecuteDDLTaskUI, Microsoft.SqlServer.ASTasksUI, Version=10.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91", 
    IconResource = "ExecuteTaskIcon")>]
type ASExecuteDDLTask =  
    class
        inherit ASTaskBase
        interface IDTSComponentPersist
    end

public class ASExecuteDDLTask extends ASTaskBase implements IDTSComponentPersist

El tipo ASExecuteDDLTask expone los siguientes miembros.

Constructores

  Nombre Descripción
Método público ASExecuteDDLTask Initializes a new instance of the ASExecuteDDLTask class.

Arriba

Propiedades

  Nombre Descripción
Propiedad pública ConnectionName Infraestructura. (Se hereda de ASTaskBase.)
Propiedad pública ExecutionValue Returns the result of the task execution. (Invalida Task. . :: . .ExecutionValue.)
Propiedad protegida ProgressEventName Infraestructura. (Se hereda de ASTaskBase.)
Propiedad pública Source Gets or sets the text of the DDL statement to be sent to the Analysis Services server.
Propiedad pública SourceType Gets or sets a value from the DDLSourceType enumeration indicating the source type that contains the DDL statements.
Propiedad protegida StatusEventName Infraestructura. (Invalida ASTaskBase. . :: . .StatusEventName.)
Propiedad protegida SubComponentName Infraestructura. (Invalida ASTaskBase. . :: . .SubComponentName.)
Propiedad públicaMiembro estático TaskDescription Returns a description of the Analysis Services Execute DDL task.
Propiedad públicaMiembro estático TaskDisplayName Returns the name of the Execute DDL task.
Propiedad pública Version *** Member deprecated; see Remarks. ***    Returns the version of the task. This property is read-only. (Se hereda de Task.)

Arriba

Métodos

  Nombre Descripción
Método público CanUpdate *** Member deprecated; see Remarks. ***    A Boolean that indicates whether the new package XML can update the old package XML. (Se hereda de Task.)
Método público Equals Determines whether two object instances are equal. (Se hereda de DtsObject.)
Método público Execute Infraestructura. (Se hereda de ASTaskBase.)
Método protegido Finalize (Se hereda de Object.)
Método protegido FireError(String, String) Infraestructura. (Se hereda de ASTaskBase.)
Método protegido FireError(Int32, String, String, String) Infraestructura. (Se hereda de ASTaskBase.)
Método público GetConnectionID Gets a String containing the ID of the connection. (Se hereda de Task.)
Método público GetConnectionName Gets a String containing the name of the connection. (Se hereda de Task.)
Método público GetHashCode Returns the hash code for this instance. (Se hereda de DtsObject.)
Método público GetType (Se hereda de Object.)
Método público InitializeTask Initializes the properties associated with the task. This method is called by the runtime and is not used in code. (Se hereda de Task.)
Método protegido InternalExecute Infraestructura. (Invalida ASTaskBase. . :: . .InternalExecute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object).)
Método protegido InternalValidate Infraestructura. (Invalida ASTaskBase. . :: . .InternalValidate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging).)
Método público LoadFromXML This method is not callable by your application code. To load a package saved as .xml, use the Application..::..LoadPackage method.
Método protegido MemberwiseClone (Se hereda de Object.)
Método público SaveToXML This method is not callable by your application code. To save a package as .xml, use the Application..::..SaveToXml method.
Método protegido StopExecution Infraestructura. (Se hereda de ASTaskBase.)
Método protegido SubscribeToProgressEvent Infraestructura. (Se hereda de ASTaskBase.)
Método público ToString (Se hereda de Object.)
Método protegido UnsubscribeToProgressEvent Infraestructura. (Se hereda de ASTaskBase.)
Método público Update *** Member deprecated; see Remarks. ***    This method updates the old package XML with the new package XML if CanUpdate is set to true. (Se hereda de Task.)
Método público Validate Infraestructura. (Se hereda de ASTaskBase.)
Método protegido ValidateConnection Infraestructura. (Se hereda de ASTaskBase.)
Método protegido ValidateDDL Infraestructura. (Invalida ASTaskBase. . :: . .ValidateDDL(VariableDispenser, Connections, Exception%).)
Método protegido WriteLog Infraestructura. (Se hereda de ASTaskBase.)

Arriba

Campos

  Nombre Descripción
Campo protegido bExecutionCanceled Infraestructura. (Se hereda de ASTaskBase.)
Campo protegido bTraceError Infraestructura. (Se hereda de ASTaskBase.)
Campo protegido ddl Infraestructura. (Se hereda de ASTaskBase.)
Campo protegido m_events Infraestructura. (Se hereda de ASTaskBase.)
Campo protegido server Infraestructura. (Se hereda de ASTaskBase.)

Arriba

Ejemplos

The following code sample creates, configures, and executes a new ASExecuteDDLTask that loads the DDL statement to execute from a file connection.

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

Seguridad para subprocesos

Cualquier miembro público static (Shared en Visual Basic) de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.