ASExecuteDDLTask Classe

Definizione

Spazio dei nomi:

Microsoft.DataTransformationServices.Tasks.DTSProcessingTask

Assembly:

Microsoft.SqlServer.ASTasks.dll

Esegue comandi del Data Definition Language (DDL) su un'istanza di Microsoft SQL Server Analysis Services.

public ref 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

[<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

Ereditarietà

Object

DtsObject

Task

ASTaskBase

ASExecuteDDLTask

Attributi

DtsTaskAttribute GuidAttribute

Implementazioni

IDTSComponentPersist

Esempio

Il seguente esempio di codice crea, configura ed esegue un nuovo ASExecuteDDLTask che carica l'istruzione DDL da eseguire da una connessione a un file.

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  

Costruttori

Nome	Descrizione
ASExecuteDDLTask()	Crea una nuova istanza della classe ASExecuteDDLTask.

Campi

Nome	Descrizione
bExecutionCanceled	L'esecuzione è annullata. (Ereditato da ASTaskBase)
bTraceError	L'errore di traccia. (Ereditato da ASTaskBase)
ddl	Il linguaggio di definizione dei dati. (Ereditato da ASTaskBase)
m_events	Gli eventi. (Ereditato da ASTaskBase)
server	Server. (Ereditato da ASTaskBase)

Proprietà

Nome	Descrizione
ConnectionName	Ottiene o imposta il nome della connessione per il compito di servizi di analisi. (Ereditato da ASTaskBase)
ExecutionValue	Ottiene il risultato del compito Analysis Services Execute DDL.
ProgressEventName	Ottiene il nome dell'evento di progresso per il compito di servizi di analisi. (Ereditato da ASTaskBase)
Source	Ottiene o imposta il nome della sorgente che contiene l'istruzione DDL da inviare al server Analysis Services.
SourceType	Ottiene o imposta un valore dall'enumerazione DDLSourceType che indica il tipo sorgente che contiene le istruzioni DDL.
StatusEventName	Ottiene il nome dell'evento di stato per il compito Analysis Services Execute DDL.
SubComponentName	Ottiene il nome del sottocomponente per il compito Analysis Services Execute DDL.
TargetServerVersion	Esegue comandi del Data Definition Language (DDL) su un'istanza di Microsoft SQL Server Analysis Services. (Ereditato da Task)
TaskDescription	Riceve una descrizione del compito Analysis Services Execute DDL.
TaskDisplayName	Ottiene il nome unico per il compito Analysis Services Execute DDL.
Version	Membro deprecato; vedi Osservazioni. Restituisce la versione del compito. Questa proprietà è di sola lettura. (Ereditato da Task)

Metodi

Nome	Descrizione
CanUpdate(String)	Membro deprecato; vedi Osservazioni. Un Booleano che indica se il nuovo XML del pacchetto può aggiornare il vecchio XML del pacchetto. (Ereditato da Task)
Equals(Object)	Determina se due istanze dell'oggetto sono uguali. (Ereditato da DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Esegue il compito dei servizi di analisi. (Ereditato da ASTaskBase)
ExecuteCommand(String, Connections, IDTSComponentEvents, Object)	Esegue comandi del Data Definition Language (DDL) su un'istanza di Microsoft SQL Server Analysis Services. (Ereditato da ASTaskBase)
FireError(Int32, String, String, String)	Genera un evento quando si verifica un errore. (Ereditato da ASTaskBase)
FireError(String, String)	Genera un evento quando si verifica un errore. (Ereditato da ASTaskBase)
GetConnectionID(Connections, String)	Ottiene una stringa contenente l'ID della connessione. (Ereditato da Task)
GetConnectionName(Connections, String)	Ottiene una stringa che contiene il nome della connessione. (Ereditato da Task)
GetHashCode()	Restituisce il codice hash per questa istanza. (Ereditato da DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)	Inizializza le proprietà associate al compito. Questo metodo è chiamato dal runtime e non viene utilizzato nel codice. (Ereditato da Task)
InternalExecute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Esegue il compito DDL internamente.
InternalValidate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Valida internamente il compito DDL.
LoadFromXML(XmlElement, IDTSInfoEvents)	Questo metodo non è richiamabile dal codice applicativo. Per caricare un pacco salvato come .xml, usa il LoadPackage(String, IDTSEvents) metodo.
SaveToXML(XmlDocument, IDTSInfoEvents)	Questo metodo non è richiamabile dal codice applicativo. Per salvare un pacchetto come .xml, usa il SaveToXml(String, Package, IDTSEvents) metodo.
StopExecution()	Interrompe l'esecuzione del compito di servizio di analisi. (Ereditato da ASTaskBase)
SubscribeToProgressEvent(SessionTrace)	Sottoscrive l'evento di compito per progressare. (Ereditato da ASTaskBase)
UnsubscribeToProgressEvent(SessionTrace)	Disiscrive il compito dall'evento di progresso. (Ereditato da ASTaskBase)
Update(String)	Membro deprecato; vedi Osservazioni. Questo metodo aggiorna il vecchio pacchetto XML con il nuovo pacchetto XML se CanUpdate(String) è impostato su true. (Ereditato da Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Valida il compito di servizio di analisi. (Ereditato da ASTaskBase)
ValidateConnection(Connections)	Valida la connessione al compito. (Ereditato da ASTaskBase)
ValidateDDL(VariableDispenser, Connections, Exception)	Verifica che il task DDL sia configurato correttamente.
WriteLog(IDTSLogging, String)	Scrive un registro per il compito. (Ereditato da ASTaskBase)