ASExecuteDDLTask Classe

Définition

Espace de noms:

Microsoft.DataTransformationServices.Tasks.DTSProcessingTask

Assembly:

Microsoft.SqlServer.ASTasks.dll

Exécute des commandes DDL (Data Definition Language) sur une instance de 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

Héritage

Object

DtsObject

Task

ASTaskBase

ASExecuteDDLTask

Attributs

DtsTaskAttribute GuidAttribute

Implémente

IDTSComponentPersist

Exemples

L’exemple de code suivant crée, configure et exécute un nouveau ASExecuteDDLTask qui charge l’instruction DDL à exécuter à partir d’une connexion de fichier.

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  

Constructeurs

ASExecuteDDLTask()

Crée une instance de la classe ASExecuteDDLTask.

Champs

bExecutionCanceled	L'exécution est annulée. (Hérité de ASTaskBase)
bTraceError	Erreur de trace. (Hérité de ASTaskBase)
ddl	Langage de définition de données (DDL). (Hérité de ASTaskBase)
m_events	Événements. (Hérité de ASTaskBase)
server	Le serveur. (Hérité de ASTaskBase)

Propriétés

ConnectionName	Obtient ou définit le nom de la connexion pour la tâche Analysis Services. (Hérité de ASTaskBase)
ExecutionValue	Obtient le résultat de la tâche DDL d’exécution Analysis Services.
ProgressEventName	Obtient le nom de l'événement de progression de la tâche Analysis Services. (Hérité de ASTaskBase)
Source	Obtient ou définit le nom de la source qui contient l’instruction DDL à envoyer au serveur Analysis Services.
SourceType	Obtient ou définit une valeur de l'énumération DDLSourceType indiquant le type de source qui contient les instructions DDL.
StatusEventName	Obtient le nom de l’événement d’état pour la tâche DDL d’exécution Analysis Services.
SubComponentName	Obtient le nom du sous-composant pour la tâche DDL d’exécution Analysis Services.
TargetServerVersion	Exécute des commandes DDL (Data Definition Language) sur une instance de Microsoft SQL Server Analysis Services. (Hérité de Task)
TaskDescription	Obtient une description de la tâche DDL d’exécution Analysis Services.
TaskDisplayName	Obtient le nom unique de la tâche d’exécution DDL Analysis Services.
Version	*** Membre déconseillé ; consultez les Remarques. *** Retourne la version de la tâche. Cette propriété est en lecture seule. (Hérité de Task)

Méthodes

CanUpdate(String)	*** Membre déconseillé ; consultez les Remarques. Boolean qui indique si le nouveau code XML de package peut mettre à jour l’ancien fichier XML de package. (Hérité de Task)
Equals(Object)	Détermine si les deux instances d'objet sont égales. (Hérité de DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Exécute la tâche Analysis Services. (Hérité de ASTaskBase)
ExecuteCommand(String, Connections, IDTSComponentEvents, Object)	Exécute des commandes DDL (Data Definition Language) sur une instance de Microsoft SQL Server Analysis Services. (Hérité de ASTaskBase)
FireError(Int32, String, String, String)	Déclenche un événement lorsqu'une erreur se produit. (Hérité de ASTaskBase)
FireError(String, String)	Déclenche un événement lorsqu'une erreur se produit. (Hérité de ASTaskBase)
GetConnectionID(Connections, String)	Obtient une chaîne contenant l’ID de la connexion. (Hérité de Task)
GetConnectionName(Connections, String)	Obtient une chaîne contenant le nom de la connexion. (Hérité de Task)
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)	Initialise les propriétés associées à la tâche. Cette méthode est appelée par le runtime et n'est pas utilisée dans le code. (Hérité de Task)
InternalExecute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Exécute la tâche DDL en interne.
InternalValidate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Valide la tâche DDL en interne.
LoadFromXML(XmlElement, IDTSInfoEvents)	Cette méthode ne peut pas être appelée par votre code d'application. Pour charger un package enregistré en tant que .xml, utilisez la méthode LoadPackage(String, IDTSEvents).
SaveToXML(XmlDocument, IDTSInfoEvents)	Cette méthode ne peut pas être appelée par votre code d'application. Pour enregistrer un package en tant que .xml, utilisez la méthode SaveToXml(String, Package, IDTSEvents).
StopExecution()	Arrête l'exécution de la tâche Analysis Services. (Hérité de ASTaskBase)
SubscribeToProgressEvent(SessionTrace)	Abonne la tâche à l'événement de progression. (Hérité de ASTaskBase)
UnsubscribeToProgressEvent(SessionTrace)	Annule l'abonnement de la tâche à l'événement de progression. (Hérité de ASTaskBase)
Update(String)	*** Membre déconseillé ; consultez les Remarques. Cette méthode met à jour l’ancien xml de package avec le nouveau xml de package si CanUpdate(String) est défini sur true. (Hérité de Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Valide la tâche Analysis Services. (Hérité de ASTaskBase)
ValidateConnection(Connections)	Valide la connexion de tâche. (Hérité de ASTaskBase)
ValidateDDL(VariableDispenser, Connections, Exception)	Vérifie que la tâche DDL est configurée correctement.
WriteLog(IDTSLogging, String)	Écrit un enregistrement pour la tâche. (Hérité de ASTaskBase)