ASExecuteDDLTask Classe

Definizione

Spazio dei nomi:

Microsoft.DataTransformationServices.Tasks.DTSProcessingTask

Assembly:

Microsoft.SqlServer.ASTasks.dll

Esegue i comandi DDL (Data Definition Language) 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

L'esempio di codice seguente crea, configura ed esegue un nuovo ASExecuteDDLTask che carica l'istruzione DDL da eseguire da una connessione 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

ASExecuteDDLTask()

Crea una nuova istanza della classe ASExecuteDDLTask.

Campi

bExecutionCanceled	L'esecuzione viene annullata. (Ereditato da ASTaskBase)
bTraceError	Errore di traccia. (Ereditato da ASTaskBase)
ddl	Data Definition Language. (Ereditato da ASTaskBase)
m_events	Eventi. (Ereditato da ASTaskBase)
server	Server. (Ereditato da ASTaskBase)

Proprietà

ConnectionName	Ottiene o imposta il nome della connessione per l'attività di Analysis Services. (Ereditato da ASTaskBase)
ExecutionValue	Ottiene il risultato dell'attività Esegui DDL di Analysis Services.
ProgressEventName	Ottiene il nome dell'evento di stato per l'attività di Analysis Services. (Ereditato da ASTaskBase)
Source	Ottiene o imposta il nome dell'origine contenente l'istruzione DDL da inviare al server Analysis Services.
SourceType	Ottiene o imposta un valore dell'enumerazione DDLSourceType che indica il tipo di origine contenente l'istruzione DDL.
StatusEventName	Ottiene il nome dell'evento di stato per l'attività Esegui DDL di Analysis Services.
SubComponentName	Ottiene il nome del componente secondario per l'attività Esegui DDL di Analysis Services.
TargetServerVersion	Esegue i comandi DDL (Data Definition Language) su un'istanza di Microsoft SQL Server Analysis Services. (Ereditato da Task)
TaskDescription	Ottiene una descrizione dell'attività Esegui DDL di Analysis Services.
TaskDisplayName	Ottiene il nome univoco per l'attività Esegui DDL di Analysis Services.
Version	*** Membro deprecato; vedere la sezione Osservazioni. Restituisce la versione dell'attività. Questa proprietà è di sola lettura. (Ereditato da Task)

Metodi

CanUpdate(String)	*** Membro deprecato; vedere la sezione Osservazioni. Valore booleano che indica se il nuovo xml del pacchetto può aggiornare il codice XML del pacchetto precedente. (Ereditato da Task)
Equals(Object)	Determina se due istanze di un oggetto sono uguali. (Ereditato da DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Esegue l'attività di Analysis Services. (Ereditato da ASTaskBase)
ExecuteCommand(String, Connections, IDTSComponentEvents, Object)	Esegue i comandi DDL (Data Definition Language) 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 contenente il nome della connessione. (Ereditato da Task)
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)	Inizializza le proprietà associate all'attività. Questo metodo viene chiamato dal runtime e non è utilizzato nel codice. (Ereditato da Task)
InternalExecute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Esegue l'attività DDL internamente.
InternalValidate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Convalida l'attività DDL internamente.
LoadFromXML(XmlElement, IDTSInfoEvents)	Non è possibile chiamare questo metodo dal codice dell'applicazione. Per caricare un pacchetto salvato come file con estensione xml, utilizzare il metodo LoadPackage(String, IDTSEvents).
SaveToXML(XmlDocument, IDTSInfoEvents)	Non è possibile chiamare questo metodo dal codice dell'applicazione. Per salvare un pacchetto come file con estensione xml, utilizzare il metodo SaveToXml(String, Package, IDTSEvents).
StopExecution()	Arresta l'esecuzione dell'attività di Analysis Services. (Ereditato da ASTaskBase)
SubscribeToProgressEvent(SessionTrace)	Sottoscrive l'attività nell'evento di stato. (Ereditato da ASTaskBase)
UnsubscribeToProgressEvent(SessionTrace)	Annulla la sottoscrizione dell'attività dall'evento di stato. (Ereditato da ASTaskBase)
Update(String)	*** Membro deprecato; vedere la sezione Osservazioni. Questo metodo aggiorna il codice XML del pacchetto precedente con il nuovo codice XML del pacchetto se CanUpdate(String) è impostato su true. (Ereditato da Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Convalida l'attività di Analysis Services. (Ereditato da ASTaskBase)
ValidateConnection(Connections)	Convalida la connessione dell'attività. (Ereditato da ASTaskBase)
ValidateDDL(VariableDispenser, Connections, Exception)	Verifica che l'attività DDL sia configurata correttamente.
WriteLog(IDTSLogging, String)	Scrive un log per l'attività. (Ereditato da ASTaskBase)