ASExecuteDDLTask 클래스

참조

정의

네임스페이스:: Microsoft.DataTransformationServices.Tasks.DTSProcessingTask

어셈블리:: Microsoft.SqlServer.ASTasks.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

Microsoft SQL Server Analysis Services 인스턴스에 대해 DDL(데이터 정의 언어) 명령을 실행합니다.

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

상속: 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)	두 개체 인스턴스가 같은지 확인합니다. (다음에서 상속됨 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)

적용 대상

ASExecuteDDLTask 클래스

정의

예제

생성자

필드

속성

메서드

적용 대상

추가 리소스