ASExecuteDDLTask Classe
Definição
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 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
- 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) |