ExecuteSQLTask クラス

定義

SQL 実行タスクの構成や実行を行うために使用するメンバーが含まれます。 SQL 実行タスクは、リレーショナル データベースのテーブルまたはビューに対して SQL コマンドを実行するために使用されます。

public ref class ExecuteSQLTask : Microsoft::SqlServer::Dts::Runtime::Task, Microsoft::SqlServer::Dts::Runtime::IDTSComponentPersist, Microsoft::SqlServer::Dts::Tasks::ExecuteSQLTask::IDTSExecuteSQL
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL Task; Microsoft Corporation; SQL Server 2016; © 2015 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("EBC1FA93-45A9-444F-BBDC-B4F5265863C3")]
public class ExecuteSQLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.IDTSExecuteSQL
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL Task; Microsoft Corporation; SQL Server 2017; © 2017 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("855117DC-EA42-4532-8D53-8E4FC09662CE")]
public class ExecuteSQLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.IDTSExecuteSQL
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL Task; Microsoft Corporation; SQL Server 2019; © 2019 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("736DDEB9-5DA1-4841-B5A7-F08CC574307F")]
public class ExecuteSQLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.IDTSExecuteSQL
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL Task; Microsoft Corporation; SQL Server 2016; © 2015 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("EBC1FA93-45A9-444F-BBDC-B4F5265863C3")>]
type ExecuteSQLTask = class
    inherit Task
    interface IDTSExecuteSQL
    interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL Task; Microsoft Corporation; SQL Server 2017; © 2017 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("855117DC-EA42-4532-8D53-8E4FC09662CE")>]
type ExecuteSQLTask = class
    inherit Task
    interface IDTSExecuteSQL
    interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.executesqltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.Localized), RequiredProductLevel=Microsoft.SqlServer.Dts.Runtime.DTSProductLevel.None, SamplesTag="SsisExecuteSqlTask", TaskContact="Execute SQL Task; Microsoft Corporation; SQL Server 2019; © 2019 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask.SQLTaskUI, Microsoft.SqlServer.SQLTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("736DDEB9-5DA1-4841-B5A7-F08CC574307F")>]
type ExecuteSQLTask = class
    inherit Task
    interface IDTSExecuteSQL
    interface IDTSComponentPersist
Public Class ExecuteSQLTask
Inherits Task
Implements IDTSComponentPersist, IDTSExecuteSQL
継承
ExecuteSQLTask
派生
属性
実装

注釈

このタスクの機能の詳細については、「 SQL 実行タスク」を参照してください。

コンストラクター

ExecuteSQLTask()

ExecuteSQLTask クラスの新しいインスタンスを初期化します。

プロパティ

BypassPrepare

SQL ステートメントをリレーショナル データベース管理システム (RDBMS) に送信するときに、SQL 実行タスクがステートメントの準備をスキップするかどうかを示すブール値を取得または設定します。

CodePage

Unicode ワイド文字型として格納されている変数値をマルチバイトに変換するときに使用するコード ページを取得します。値の設定も可能です。 変換は、データベースに値を格納するとき、またはデータベースから値を抽出するときに行われます。

Connection

SQL 実行タスクが実行されるリレーショナル データベース管理システム (RDBMS) に接続する接続マネージャーの名前を取得します。値の設定も可能です。

ExecutionValue

1 つまたは複数の SQL ステートメントの影響を受けた行数を返します。

IsStoredProcedure

SQL 実行タスクで指定された SQL ステートメントがストアド プロシージャであるかどうかを示すブール型 (Boolean) の値を取得または設定します。

ParameterBindings

IDTSParameterBindings を実装するオブジェクトを返します。

ResultSetBindings

IDTSParameterBindings を実装するオブジェクトを返します。

ResultSetType

SQL 実行タスクが実行する SQL ステートメントによって返される結果セットの種類を示す値を取得します。値の設定も可能です。

SqlStatementSource

SQL 実行タスクが実行する SQL ステートメントを含むソースの名前を取得します。値の設定も可能です。

SqlStatementSourceType

SQL 実行タスクが実行する SQL ステートメントを含むソースの種類を示す値を取得します。値の設定も可能です。

TargetServerVersion

SQL 実行タスクの構成や実行を行うために使用するメンバーが含まれます。 SQL 実行タスクは、リレーショナル データベースのテーブルまたはビューに対して SQL コマンドを実行するために使用されます。

(継承元 Task)
TimeOut

タスクがタイムアウトするまでに実行可能な最大秒数を示す整数を取得します。値の設定も可能です。

TypeConversionMode

SQL 実行タスクで使用する変換モードを取得します。値の設定も可能です。

Version

*** このメンバーは非推奨です。「解説」を参照してください。 タスクのバージョンを返します。 このプロパティは読み取り専用です。

(継承元 Task)

メソッド

CanUpdate(String)

*** このメンバーは非推奨です。「解説」を参照してください。 新しいパッケージ XML が古いパッケージ XML を更新できるかどうかを示すブール値。

(継承元 Task)
Equals(Object)

2 つのオブジェクト インスタンスが等しいかどうかを判断します。

(継承元 DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)

タスクを実行します。

GetConnectionID(Connections, String)

接続の ID を含む文字列を取得します。

(継承元 Task)
GetConnectionName(Connections, String)

接続の名前を含む文字列を取得します。

(継承元 Task)
GetHashCode()

このインスタンスのハッシュ コードを返します。

(継承元 DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)

SQL 実行タスクに関連付けられたプロパティを初期化します。 このメソッドはランタイムから呼び出されるメソッドであり、コードでは使用されません。

LoadFromXML(XmlElement, IDTSInfoEvents)

このメソッドをアプリケーション コードから呼び出すことはできません。 .xml として保存されたパッケージを読み込むには、LoadPackage(String, IDTSEvents) メソッドを使用します。

SaveToXML(XmlDocument, IDTSInfoEvents)

このメソッドをアプリケーション コードから呼び出すことはできません。 パッケージを .xml として保存するには、SaveToXml(String, Package, IDTSEvents) メソッドを使用します。

Update(String)

*** このメンバーは非推奨です。「解説」を参照してください。 このメソッドは、true に設定されている場合 CanUpdate(String) 、新しいパッケージ XML で古いパッケージ XML を更新します。

(継承元 Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)

タスクが正しく構成されていることを確認します。

適用対象