ASExecuteDDLTask クラス

定義

名前空間:

Microsoft.DataTransformationServices.Tasks.DTSProcessingTask

アセンブリ:

Microsoft.SqlServer.ASTasks.dll

Microsoft SQL Server Analysis Services のインスタンスに対してデータ定義言語 (DDL) コマンドを実行します。

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

継承

Object

DtsObject

Task

ASTaskBase

ASExecuteDDLTask

属性

DtsTaskAttribute GuidAttribute

実装

IDTSComponentPersist

例

次のコード サンプルでは、実行する DDL ステートメントをファイル接続から読み込む新しい ASExecuteDDLTask を作成し、構成して実行します。

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  

コンストラクター

ASExecuteDDLTask()

ASExecuteDDLTask クラスの新しいインスタンスを作成します。

フィールド

bExecutionCanceled	実行が取り消されました。 (継承元 ASTaskBase)
bTraceError	トレース エラーです。 (継承元 ASTaskBase)
ddl	データ定義言語です。 (継承元 ASTaskBase)
m_events	イベントです。 (継承元 ASTaskBase)
server	サーバー。 (継承元 ASTaskBase)

プロパティ

ConnectionName	Analysis Services タスクが使用する接続の名前を取得または設定します。 (継承元 ASTaskBase)
ExecutionValue	Analysis Services の DDL 実行タスクの結果を取得します。
ProgressEventName	Analysis Services タスクの進行状況イベントの名前を取得します。 (継承元 ASTaskBase)
Source	Analysis Services サーバーに送信する DDL ステートメントを含むソースの名前を取得または設定します。
SourceType	DDL ステートメントを含むソースの種類を示す値を DDLSourceType 列挙から取得します。値の設定も可能です。
StatusEventName	Analysis Services の DDL 実行タスクの状態イベント名を取得します。
SubComponentName	Analysis Services の DDL 実行タスクのサブ コンポーネント名を取得します。
TargetServerVersion	Microsoft SQL Server Analysis Services のインスタンスに対してデータ定義言語 (DDL) コマンドを実行します。 (継承元 Task)
TaskDescription	Analysis Services の DDL 実行タスクの説明を取得します。
TaskDisplayName	Analysis Services の DDL 実行タスクの一意の名前を取得します。
Version	*** このメンバーは非推奨です。「解説」を参照してください。 タスクのバージョンを返します。 このプロパティは読み取り専用です。 (継承元 Task)

メソッド

CanUpdate(String)	*** このメンバーは非推奨です。「解説」を参照してください。 新しいパッケージ XML が古いパッケージ XML を更新できるかどうかを示すブール値。 (継承元 Task)
Equals(Object)	2 つのオブジェクト インスタンスが等しいかどうかを判断します。 (継承元 DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Analysis Services タスクを実行します。 (継承元 ASTaskBase)
ExecuteCommand(String, Connections, IDTSComponentEvents, Object)	Microsoft SQL Server Analysis Services のインスタンスに対してデータ定義言語 (DDL) コマンドを実行します。 (継承元 ASTaskBase)
FireError(Int32, String, String, String)	エラーが発生したときにイベントを発生させます。 (継承元 ASTaskBase)
FireError(String, String)	エラーが発生したときにイベントを発生させます。 (継承元 ASTaskBase)
GetConnectionID(Connections, String)	接続の ID を含む文字列型 (String) の値を取得します。 (継承元 Task)
GetConnectionName(Connections, String)	接続の名前を含む文字列型 (String) の値を取得します。 (継承元 Task)
GetHashCode()	このインスタンスのハッシュ コードを返します。 (継承元 DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)	タスクに関連付けられたプロパティを初期化します。 このメソッドはランタイムから呼び出されるメソッドであり、コードでは使用されません。 (継承元 Task)
InternalExecute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	DDL タスクを内部で実行します。
InternalValidate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	DDL タスクを内部で検証します。
LoadFromXML(XmlElement, IDTSInfoEvents)	このメソッドをアプリケーション コードから呼び出すことはできません。 .xml として保存されたパッケージを読み込むには、LoadPackage(String, IDTSEvents) メソッドを使用します。
SaveToXML(XmlDocument, IDTSInfoEvents)	このメソッドをアプリケーション コードから呼び出すことはできません。 パッケージを .xml として保存するには、SaveToXml(String, Package, IDTSEvents) メソッドを使用します。
StopExecution()	Analysis Services タスクの実行を停止します。 (継承元 ASTaskBase)
SubscribeToProgressEvent(SessionTrace)	進行状況イベントにタスクをサブスクライブします。 (継承元 ASTaskBase)
UnsubscribeToProgressEvent(SessionTrace)	進行状況イベントからタスクをアンサブスクライブします。 (継承元 ASTaskBase)
Update(String)	*** このメンバーは非推奨です。「解説」を参照してください。 が true に設定されている場合 CanUpdate(String) 、このメソッドは新しいパッケージ XML で古いパッケージ XML を更新します。 (継承元 Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Analysis Services タスクを検証します。 (継承元 ASTaskBase)
ValidateConnection(Connections)	タスク接続を検証します。 (継承元 ASTaskBase)
ValidateDDL(VariableDispenser, Connections, Exception)	DDL タスクが正しく構成されていることを確認します。
WriteLog(IDTSLogging, String)	タスクのログを書き込みます。 (継承元 ASTaskBase)