ASExecuteDDLTask Classe

Definizione

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
[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
Ereditarietà
ASExecuteDDLTask
Attributi
Implementazioni

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)

Si applica a