ASExecuteDDLTask Classe

Definição

Executa comandos da Linguagem de Definição de Dados (DDL) 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
ASExecuteDDLTask
Atributos
Implementações

Exemplos

O exemplo de código a seguir cria, configura e executa um novo ASExecuteDDLTask que carrega a instrução DDL para ser executada a partir 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

Nome Description
ASExecuteDDLTask()

Cria uma nova instância da classe ASExecuteDDLTask.

Campos

Nome Description
bExecutionCanceled

A execução é 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

Nome Description
ConnectionName

Obtém ou define o nome da conexão para a tarefa de serviços de análise.

(Herdado de ASTaskBase)
ExecutionValue

Obtém o resultado da tarefa Analysis Services Execute DDL.

ProgressEventName

Recebe o nome do evento de progresso para a tarefa de serviços de análise.

(Herdado de ASTaskBase)
Source

Obtém ou define o nome da fonte que contém a instrução DDL a ser enviada ao servidor de Serviços de Análise.

SourceType

Obtém ou define um valor da DDLSourceType enumeração indicando o tipo de origem que contém as instruções DDL.

StatusEventName

Recebe o nome do evento de status para a tarefa Analysis Services Execute DDL.

SubComponentName

Obtém o nome do subcomponente para a tarefa Analysis Services Execute DDL.

TargetServerVersion

Executa comandos da Linguagem de Definição de Dados (DDL) em uma instância do Microsoft SQL Server Analysis Services.

(Herdado de Task)
TaskDescription

Recebe uma descrição da tarefa Serviços de Análise Executar DDL.

TaskDisplayName

Recebe o nome único para a tarefa Serviços de Análise Executar DDL.

Version

Membro descontinuado; veja Observações. Retorna a versão da tarefa. Esta propriedade é somente para leitura.

(Herdado de Task)

Métodos

Nome Description
CanUpdate(String)

Membro descontinuado; veja Observações. Um Booleano 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 de serviços de análise.

(Herdado de ASTaskBase)
ExecuteCommand(String, Connections, IDTSComponentEvents, Object)

Executa comandos da Linguagem de Definição de Dados (DDL) em uma instância do Microsoft SQL Server Analysis Services.

(Herdado de ASTaskBase)
FireError(Int32, String, String, String)

Levanta um evento quando ocorre um erro.

(Herdado de ASTaskBase)
FireError(String, String)

Levanta um evento quando ocorre um erro.

(Herdado de ASTaskBase)
GetConnectionID(Connections, String)

Recebe uma String contendo o ID da conexão.

(Herdado de Task)
GetConnectionName(Connections, String)

Recebe uma String contendo o nome da conexão.

(Herdado de Task)
GetHashCode()

Retorna o código hash dessa 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 no código.

(Herdado de Task)
InternalExecute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)

Executa a tarefa DDL internamente.

InternalValidate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)

Valida a tarefa DDL internamente.

LoadFromXML(XmlElement, IDTSInfoEvents)

Esse método não pode ser chamado pelo seu código de aplicação. Para carregar um pacote salvo como .xml, use o LoadPackage(String, IDTSEvents) método.

SaveToXML(XmlDocument, IDTSInfoEvents)

Esse método não pode ser chamado pelo seu código de aplicação. Para salvar um pacote como .xml, use o SaveToXml(String, Package, IDTSEvents) método.

StopExecution()

Para a execução da tarefa do serviço de análise.

(Herdado de ASTaskBase)
SubscribeToProgressEvent(SessionTrace)

Assina o evento de tarefa para progresso.

(Herdado de ASTaskBase)
UnsubscribeToProgressEvent(SessionTrace)

Desinscrição da tarefa do evento de progresso.

(Herdado de ASTaskBase)
Update(String)

Membro descontinuado; veja Observações. Esse método atualiza o pacote antigo XML com o novo pacote XML se CanUpdate(String) for definido como verdadeiro.

(Herdado de Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)

Valida a tarefa do serviço de análise.

(Herdado de ASTaskBase)
ValidateConnection(Connections)

Valida a conexão da tarefa.

(Herdado de ASTaskBase)
ValidateDDL(VariableDispenser, Connections, Exception)

Verifica se a tarefa DDL está devidamente configurada.

WriteLog(IDTSLogging, String)

Escreve um log para a tarefa.

(Herdado de ASTaskBase)

Aplica-se a