Udostępnij przez


Klasa ASExecuteDDLTask

Executes Data Definition Language (DDL) commands against an instance of Microsoft SQL Server Usługi Analysis Services.

Hierarchia dziedziczenia

System.Object
  Microsoft.SqlServer.Dts.Runtime.DtsObject
    Microsoft.SqlServer.Dts.Runtime.Task
      Microsoft.DataTransformationServices.Tasks.DTSProcessingTask.ASTaskBase
        Microsoft.DataTransformationServices.Tasks.DTSProcessingTask.ASExecuteDDLTask

Przestrzeń nazw:  Microsoft.DataTransformationServices.Tasks.DTSProcessingTask
Zestaw:  Microsoft.SqlServer.ASTasks (w Microsoft.SqlServer.ASTasks.dll)

Składnia

'Deklaracja
<GuidAttribute("FC95DF06-8E20-4f90-BFD5-B48AFA59C158")> _
<DtsTaskAttribute(LocalizationType := GetType(ASExecuteDDLTask), UITypeName := "Microsoft.DataTransformationServices.Tasks.DTSProcessingTaskUI.ASExecuteDDLTaskUI, Microsoft.SqlServer.ASTasksUI, Version=10.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91",  _
    IconResource := "ExecuteTaskIcon")> _
Public Class ASExecuteDDLTask _
    Inherits ASTaskBase _
    Implements IDTSComponentPersist
'Użycie
Dim instance As ASExecuteDDLTask
[GuidAttribute("FC95DF06-8E20-4f90-BFD5-B48AFA59C158")]
[DtsTaskAttribute(LocalizationType = typeof(ASExecuteDDLTask), UITypeName = "Microsoft.DataTransformationServices.Tasks.DTSProcessingTaskUI.ASExecuteDDLTaskUI, Microsoft.SqlServer.ASTasksUI, Version=10.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91", 
    IconResource = "ExecuteTaskIcon")]
public class ASExecuteDDLTask : ASTaskBase, 
    IDTSComponentPersist
[GuidAttribute(L"FC95DF06-8E20-4f90-BFD5-B48AFA59C158")]
[DtsTaskAttribute(LocalizationType = typeof(ASExecuteDDLTask), UITypeName = L"Microsoft.DataTransformationServices.Tasks.DTSProcessingTaskUI.ASExecuteDDLTaskUI, Microsoft.SqlServer.ASTasksUI, Version=10.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91", 
    IconResource = L"ExecuteTaskIcon")]
public ref class ASExecuteDDLTask : public ASTaskBase, 
    IDTSComponentPersist
[<GuidAttribute("FC95DF06-8E20-4f90-BFD5-B48AFA59C158")>]
[<DtsTaskAttribute(LocalizationType = typeof(ASExecuteDDLTask), UITypeName = "Microsoft.DataTransformationServices.Tasks.DTSProcessingTaskUI.ASExecuteDDLTaskUI, Microsoft.SqlServer.ASTasksUI, Version=10.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91", 
    IconResource = "ExecuteTaskIcon")>]
type ASExecuteDDLTask =  
    class
        inherit ASTaskBase
        interface IDTSComponentPersist
    end
public class ASExecuteDDLTask extends ASTaskBase implements IDTSComponentPersist

Typ ASExecuteDDLTask uwidacznia następujące elementy członkowskie.

Konstruktorzy

  Nazwa Opis
Metoda publiczna ASExecuteDDLTask Inicjuje nowe wystąpienie ASExecuteDDLTask klasy

Do góry

Właściwości

  Nazwa Opis
Właściwość publiczna ConnectionName Infrastruktura. (Dziedziczony z ASTaskBase).
Właściwość publiczna ExecutionValue Zwraca wynik wykonania zadania. (Zastępuje Task.ExecutionValue).
Właściwość chroniona ProgressEventName Infrastruktura. (Dziedziczony z ASTaskBase).
Właściwość publiczna Source Pobiera lub ustawia tekst instrukcja DDL, które zostanie wysłane do Usługi Analysis Services serwera.
Właściwość publiczna SourceType Pobiera lub ustawia wartość z DDLSourceType wyliczenia wskazująca typ źródło, zawierający instrukcje DDL.
Właściwość chroniona StatusEventName Infrastruktura. (Zastępuje ASTaskBase.StatusEventName).
Właściwość chroniona SubComponentName Infrastruktura. (Zastępuje ASTaskBase.SubComponentName).
Właściwość publicznaStatyczny element członkowski TaskDescription Zwraca opis Usługi Analysis Services DDL na wykonanie zadania.
Właściwość publicznaStatyczny element członkowski TaskDisplayName Zwraca nazwę DDL na wykonanie zadania.
Właściwość publiczna Version *** Członkowskich zaniechane; Zobacz uwagi. *** Zwraca wersja zadania.Ta właściwość jest tylko do odczytu. (Dziedziczony z Task).

Do góry

Metody

  Nazwa Opis
Metoda publiczna CanUpdate *** Członkowskich zaniechane; Zobacz uwagi. *** a wartość logiczna , wskazuje, czy nowy pakiet XML można aktualizować stare pakiet XML. (Dziedziczony z Task).
Metoda publiczna Equals Określa, czy dwa wystąpienia obiektu są równe. (Dziedziczony z DtsObject).
Metoda publiczna Execute Infrastruktura. (Dziedziczony z ASTaskBase).
Metoda chroniona Finalize (Dziedziczony z Object).
Metoda chroniona FireError(String, String) Infrastruktura. (Dziedziczony z ASTaskBase).
Metoda chroniona FireError(Int32, String, String, String) Infrastruktura. (Dziedziczony z ASTaskBase).
Metoda publiczna GetConnectionID Pobiera ciąg zawierający identyfikator połączenia. (Dziedziczony z Task).
Metoda publiczna GetConnectionName Pobiera ciąg zawierające nazwę połączenia. (Dziedziczony z Task).
Metoda publiczna GetHashCode Zwraca kod skrótu dla tego wystąpienie. (Dziedziczony z DtsObject).
Metoda publiczna GetType (Dziedziczony z Object).
Metoda publiczna InitializeTask Inicjuje właściwości skojarzonych z zadaniem.Ta metoda jest wywoływana w czasie wykonywania i nie jest używany w kodzie. (Dziedziczony z Task).
Metoda chroniona InternalExecute Infrastruktura. (Zastępuje ASTaskBase.InternalExecute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)).
Metoda chroniona InternalValidate Infrastruktura. (Zastępuje ASTaskBase.InternalValidate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)).
Metoda publiczna LoadFromXML Ta metoda nie jest wpłacone przez kod aplikacji.Aby załadować pakiet zapisany jako XML, należy użyć Application.LoadPackage metoda.
Metoda chroniona MemberwiseClone (Dziedziczony z Object).
Metoda publiczna SaveToXML Ta metoda nie jest wpłacone przez kod aplikacji.Aby zapisać pakiet jako XML, użyj Application.SaveToXml metoda.
Metoda chroniona StopExecution Infrastruktura. (Dziedziczony z ASTaskBase).
Metoda chroniona SubscribeToProgressEvent Infrastruktura. (Dziedziczony z ASTaskBase).
Metoda publiczna ToString (Dziedziczony z Object).
Metoda chroniona UnsubscribeToProgressEvent Infrastruktura. (Dziedziczony z ASTaskBase).
Metoda publiczna Update *** Członkowskich zaniechane; Zobacz uwagi. *** Ta metoda aktualizuje stare pakiet XML z nowego pakietu XML, jeśli CanUpdate jest zestaw do true. (Dziedziczony z Task).
Metoda publiczna Validate Infrastruktura. (Dziedziczony z ASTaskBase).
Metoda chroniona ValidateConnection Infrastruktura. (Dziedziczony z ASTaskBase).
Metoda chroniona ValidateDDL Infrastruktura. (Zastępuje ASTaskBase.ValidateDDL(VariableDispenser, Connections, Exception%)).
Metoda chroniona WriteLog Infrastruktura. (Dziedziczony z ASTaskBase).

Do góry

Pola

  Nazwa Opis
Pole chronione bExecutionCanceled Infrastruktura. (Dziedziczony z ASTaskBase).
Pole chronione bTraceError Infrastruktura. (Dziedziczony z ASTaskBase).
Pole chronione ddl Infrastruktura. (Dziedziczony z ASTaskBase).
Pole chronione m_events Infrastruktura. (Dziedziczony z ASTaskBase).
Pole chronione server Infrastruktura. (Dziedziczony z ASTaskBase).

Do góry

Przykłady

Poniższy przykładowy kod tworzy, konfiguruje, i wykonaćs nowy ASExecuteDDLTask , ładuje instrukcja DDL na wykonać z pliku połączenia.

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

Bezpieczeństwo wątków

Wszystkie publiczne statyczny (Shared w języku Visual Basic) elementy członkowskie tego typu są bezpieczne dla wątków. Nie ma gwarancji, że elementy członkowskie wystąpień będą bezpieczne dla wątków.