ASExecuteDDLTask Klasse

Referenz

Definition

Namespace:: Microsoft.DataTransformationServices.Tasks.DTSProcessingTask

Assembly:: Microsoft.SqlServer.ASTasks.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Führt DDL-Befehle (Data Definition Language) für eine Instanz von Microsoft SQL Server Analysis Services aus.

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

Vererbung: Object

DtsObject

Task

ASTaskBase
ASExecuteDDLTask

Attribute: DtsTaskAttribute GuidAttribute

Implementiert: IDTSComponentPersist

Beispiele

Im folgenden Codebeispiel wird eine neue ASExecuteDDLTask erstellt, konfiguriert und ausgeführt, die die DDL-Anweisung lädt, um sie aus einer Dateiverbindung auszuführen.

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

Konstruktoren

ASExecuteDDLTask()

Erstellt eine neue Instanz der ASExecuteDDLTask-Klasse.

Felder

bExecutionCanceled	Die Ausführung wird abgebrochen. (Geerbt von ASTaskBase)
bTraceError	Der Ablaufverfolgungsfehler. (Geerbt von ASTaskBase)
ddl	Die Datendefinitionssprache. (Geerbt von ASTaskBase)
m_events	Die Ereignisse. (Geerbt von ASTaskBase)
server	Der Server. (Geerbt von ASTaskBase)

Eigenschaften

ConnectionName	Ruft den Namen der Verbindung für den Analysis Services-Task ab oder legt ihn fest. (Geerbt von ASTaskBase)
ExecutionValue	Ruft das Ergebnis des Analysis Services-Tasks DDL ausführen ab.
ProgressEventName	Ruft den Namen des Verlaufsereignisses für den Analysis Services-Task ab. (Geerbt von ASTaskBase)
Source	Ruft den Namen der Quelle ab, die die DDL-Anweisung enthält, die an den Analysis Services-Server gesendet werden soll, oder legt diesen fest.
SourceType	Ruft einen Wert aus der DDLSourceType-Enumeration ab, der den Quelltyp mit den DDL-Anweisungen angibt, oder legt ihn fest.
StatusEventName	Ruft den Namen des Statusereignisses für den Task "DDL ausführen" von Analysis Services ab.
SubComponentName	Ruft den Namen der Unterkomponente für den Task "DDL ausführen" von Analysis Services ab.
TargetServerVersion	Führt DDL-Befehle (Data Definition Language) für eine Instanz von Microsoft SQL Server Analysis Services aus. (Geerbt von Task)
TaskDescription	Ruft eine Beschreibung des Analysis Services-Tasks DDL ausführen ab.
TaskDisplayName	Ruft den eindeutigen Namen für den Task "DDL ausführen" von Analysis Services ab.
Version	Mitglied veraltet; siehe Hinweise. *** Gibt die Version des Tasks zurück. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Task)

Methoden

CanUpdate(String)	Mitglied veraltet; siehe Hinweise. Ein boolescher Wert, der angibt, ob die neue Paket-XML die alte Paket-XML aktualisieren kann. (Geerbt von Task)
Equals(Object)	Stellt fest, ob zwei Objektinstanzen gleich sind. (Geerbt von DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Führt den Analysis Services-Task aus. (Geerbt von ASTaskBase)
ExecuteCommand(String, Connections, IDTSComponentEvents, Object)	Führt DDL-Befehle (Data Definition Language) für eine Instanz von Microsoft SQL Server Analysis Services aus. (Geerbt von ASTaskBase)
FireError(Int32, String, String, String)	Löst ein Ereignis aus, wenn ein Fehler auftritt. (Geerbt von ASTaskBase)
FireError(String, String)	Löst ein Ereignis aus, wenn ein Fehler auftritt. (Geerbt von ASTaskBase)
GetConnectionID(Connections, String)	Ruft eine Zeichenfolge ab, die die ID der Verbindung enthält. (Geerbt von Task)
GetConnectionName(Connections, String)	Ruft eine Zeichenfolge ab, die den Namen der Verbindung enthält. (Geerbt von Task)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)	Initialisiert die dem Task zugeordneten Eigenschaften. Diese Methode wird von der Laufzeit aufgerufen und wird nicht in Code verwendet. (Geerbt von Task)
InternalExecute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Führt den DDL-Task intern aus.
InternalValidate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Überprüft den DDL-Task intern.
LoadFromXML(XmlElement, IDTSInfoEvents)	Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein im XML-Format gespeichertes Paket zu laden, verwenden Sie die LoadPackage(String, IDTSEvents)-Methode.
SaveToXML(XmlDocument, IDTSInfoEvents)	Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein Paket als XML-Datei zu speichern, verwenden Sie die SaveToXml(String, Package, IDTSEvents)-Methode.
StopExecution()	Beendet die Ausführung des Analysis Service-Tasks. (Geerbt von ASTaskBase)
SubscribeToProgressEvent(SessionTrace)	Abonniert den Task zum Verlaufsereignis. (Geerbt von ASTaskBase)
UnsubscribeToProgressEvent(SessionTrace)	Bestellt den Task vom Verlaufsereignis ab. (Geerbt von ASTaskBase)
Update(String)	Mitglied veraltet; siehe Hinweise. Diese Methode aktualisiert die alte Paket-XML mit der neuen Paket-XML, wenn CanUpdate(String) auf true festgelegt ist. (Geerbt von Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Überprüft den Analysis Service-Task. (Geerbt von ASTaskBase)
ValidateConnection(Connections)	Überprüft die Taskverbindung. (Geerbt von ASTaskBase)
ValidateDDL(VariableDispenser, Connections, Exception)	Überprüft, ob der DDL-Task ordnungsgemäß konfiguriert ist.
WriteLog(IDTSLogging, String)	Schreibt ein Protokoll für den Task. (Geerbt von ASTaskBase)

Gilt für: