ASExecuteDDLTask Classe

Referência

Definição

Namespace:: Microsoft.DataTransformationServices.Tasks.DTSProcessingTask

Assembly:: Microsoft.SqlServer.ASTasks.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Executa comandos DDL (Linguagem de Definição de Dados) em uma instância do 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

Herança: Object

DtsObject

Task

ASTaskBase
ASExecuteDDLTask

Atributos: DtsTaskAttribute GuidAttribute

Implementações: IDTSComponentPersist

Exemplos

O exemplo de código a seguir cria, configura e executa um novo ASExecuteDDLTask que carrega a instrução DDL a ser executada de uma conexão de arquivo.

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

Construtores

ASExecuteDDLTask()

Cria uma nova instância da classe ASExecuteDDLTask.

Campos

bExecutionCanceled	A execução está cancelada. (Herdado de ASTaskBase)
bTraceError	O erro de rastreamento. (Herdado de ASTaskBase)
ddl	A linguagem de definição de dados. (Herdado de ASTaskBase)
m_events	Os eventos. (Herdado de ASTaskBase)
server	O servidor. (Herdado de ASTaskBase)

Propriedades

ConnectionName	Obtém ou define o nome da conexão com a tarefa do Analysis Services. (Herdado de ASTaskBase)
ExecutionValue	Obtém o resultado da tarefa Executar DDL do Analysis Services.
ProgressEventName	Obtém o nome do evento de progresso com a tarefa do Analysis Services. (Herdado de ASTaskBase)
Source	Obtém ou define o nome da origem que contém a instrução DDL a ser enviada ao servidor do Analysis Services.
SourceType	Obtém ou define um valor da enumeração DDLSourceType que indica o tipo de origem que contém as instruções DDL.
StatusEventName	Obtém o nome do evento de status para a tarefa Executar DDL do Analysis Services.
SubComponentName	Obtém o nome do subcomponentes para a tarefa Executar DDL do Analysis Services.
TargetServerVersion	Executa comandos DDL (Linguagem de Definição de Dados) em uma instância do Microsoft SQL Server Analysis Services. (Herdado de Task)
TaskDescription	Obtém uma descrição da tarefa Executar DDL do Analysis Services.
TaskDisplayName	Obtém o nome exclusivo para a tarefa Executar DDL do Analysis Services.
Version	Membro preterido; consulte Comentários. *** Retorna a versão da tarefa. Esta propriedade é somente para leitura. (Herdado de Task)

Métodos

CanUpdate(String)	Membro preterido; consulte Comentários. Um booliano que indica se o novo XML do pacote pode atualizar o XML do pacote antigo. (Herdado de Task)
Equals(Object)	Determina se duas instâncias de objeto são iguais. (Herdado de DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Executa a tarefa do Analysis Services. (Herdado de ASTaskBase)
ExecuteCommand(String, Connections, IDTSComponentEvents, Object)	Executa comandos DDL (Linguagem de Definição de Dados) em uma instância do Microsoft SQL Server Analysis Services. (Herdado de ASTaskBase)
FireError(Int32, String, String, String)	Gera um evento quando ocorre um erro. (Herdado de ASTaskBase)
FireError(String, String)	Gera um evento quando ocorre um erro. (Herdado de ASTaskBase)
GetConnectionID(Connections, String)	Obtém uma cadeia de caracteres que contém a ID da conexão. (Herdado de Task)
GetConnectionName(Connections, String)	Obtém uma Cadeia de Caracteres que contém o nome da conexão. (Herdado de Task)
GetHashCode()	Retorna o código hash para a instância. (Herdado de DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)	Inicializa as propriedades associadas à tarefa. Esse método é chamado pelo runtime e não é usado em código. (Herdado de Task)
InternalExecute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Executa a tarefa de DDL internamente.
InternalValidate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Valida a tarefa DDL internamente.
LoadFromXML(XmlElement, IDTSInfoEvents)	Esse método não pode ser chamado por seu código de aplicativo. Para carregar um pacote salvo como .xml, use o método LoadPackage(String, IDTSEvents).
SaveToXML(XmlDocument, IDTSInfoEvents)	Esse método não pode ser chamado por seu código de aplicativo. Para salvar um pacote como .xml, use o método SaveToXml(String, Package, IDTSEvents).
StopExecution()	Para a execução da tarefa do Analysis Services. (Herdado de ASTaskBase)
SubscribeToProgressEvent(SessionTrace)	Assina a tarefa para o evento de progresso. (Herdado de ASTaskBase)
UnsubscribeToProgressEvent(SessionTrace)	Cancela a assinatura da tarefa do evento de progresso. (Herdado de ASTaskBase)
Update(String)	Membro preterido; consulte Comentários. Esse método atualiza o XML do pacote antigo com o novo XML do pacote se CanUpdate(String) estiver definido como true. (Herdado de Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Valida a tarefa do Analysis Services. (Herdado de ASTaskBase)
ValidateConnection(Connections)	Valida a conexão da tarefa. (Herdado de ASTaskBase)
ValidateDDL(VariableDispenser, Connections, Exception)	Verifica se a tarefa DDL está configurada corretamente.
WriteLog(IDTSLogging, String)	Grava um log para a tarefa. (Herdado de ASTaskBase)

Aplica-se a

Compartilhar via