MDX 데이터 정의-작업 만들기MDX Data Definition - CREATE ACTION

이 항목은 다음에 적용됩니다.예SQL Server(2008부터)아니요Azure SQL Database아니요Azure SQL Data Warehouse 아니요병렬 데이터 웨어하우스 THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

큐브, 차원, 계층 또는 종속 개체와 연관될 수 있는 동작을 만듭니다.Creates an action that can be associated with a cube, dimension, hierarchy, or subordinate object.

구문Syntax


CREATE ACTION CURRENTCUBE | Cube_Name  
   .Action_Name <action body>  
<action body> ::=   
FOR   
        CUBE   
    | Hierarchy_Name [MEMBERS]   
    | Level_Name [MEMBERS]   
    | CELLS   
    | SET }   
      AS 'MDX_Expression'   
        [, TYPE = '  
              { URL   
            | HTML   
            | STATEMENT   
               | DATASET   
            | ROWSET   
            | COMMANDLINE   
               | PROPRIETARY }   
         ']  
   [ , INVOCATION = 'INTERACTIVE | ON_OPEN | BATCH ' ]  
   [ , APPLICATION = String_Expression ]  
   [ , DESCRIPTION = String_Expression ]  
   [ , CAPTION = 'MDX_Expression' ]  

인수Arguments

Cube_NameCube_Name
큐브 이름을 지정하는 유효한 문자열입니다.A valid string that provides a cube name.

Action_ 이름Action_ Name
만들 동작의 이름을 지정하는 유효한 문자열입니다.A valid string that provides the name of the action being created.

Hierarchy_ 이름Hierarchy_ Name
계층 이름을 지정하는 유효한 문자열입니다.A valid string that provides a hierarchy name.

Level_ 이름Level_ Name
수준 이름을 지정하는 유효한 문자열입니다.A valid string that provides a level name.

Member_ 이름Member_ Name
멤버 이름이나 멤버 키를 지정하는 유효한 문자열입니다.A valid string that provides a member name or member key.

MDX_ExpressionMDX_Expression
유효한 MDX 식입니다.A valid MDX expression.

String_ExpressionString_Expression
유효한 문자열 식입니다.A valid string expression.

주의Remarks

클라이언트 응용 프로그램에서 안전하지 않은 동작을 만들고 실행하거나 안전하지 않은 기능을 사용할 수도 있습니다.It is possible for client applications to create and run actions that are unsafe; it is also possible for client applications to use unsafe functions. 이러한 경우를 방지 하려면 사용 된 Safety Options 속성입니다.To avoid these situations, use the Safety Options property. 자세한 내용은 보안 옵션 속성을 참조하십시오.For more information, see Safety Options Property.

참고

이 문은 이전 버전과의 호환성을 위해 포함되었습니다.This statement is included for backwards compatibility. 새로운 동작은 SQL ServerSQL Server Analysis ServicesAnalysis Services, 드릴스루 또는 보고서 동작과 같은 지원 되지 않습니다.Actions new to SQL ServerSQL Server Analysis ServicesAnalysis Services, such as Drillthrough or Report actions, are not supported.

동작 유형Action Types

다음 표에서 작업에서 사용할 수 있는 다양 한 유형의 MicrosoftMicrosoft SQL ServerSQL Server Analysis ServicesAnalysis Services합니다.The following table describes the different types of actions available in MicrosoftMicrosoft SQL ServerSQL Server Analysis ServicesAnalysis Services.

동작 유형Action type DescriptionDescription
URLURL 인터넷 브라우저를 사용하여 열 수 있는 URL이 동작 문자열로 반환됩니다.The returned action string is a URL that should be opened using an Internet browser.

참고:이 작업으로 시작 되지 않으면 http:// 또는 https://, 작업을 브라우저에 사용할 수 없게 됩니다 하지 않는 한 SafetyOptions 로 설정 된 dbpropval_msmd_safety_options_allow_all과합니다.Note: If this action does not start with http:// or https://, the action will be unavailable to the browser unless SafetyOptions is set to DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.
HTMLHTML HTML 스크립트가 동작 문자열로 반환됩니다.The returned action string is an HTML script. 이 문자열은 파일로 저장되며, 인터넷 브라우저를 사용하여 파일을 렌더링해야 합니다.The string should be saved to a file and the file should be rendered using an Internet browser. 이 경우 생성된 HTML의 일부로 전체 스크립트가 실행될 수 있습니다.In this case, a whole script may be run as part of the generated HTML.
STATEMENT 동작 문자열로 반환된은 설정 하 여 실행 해야 하는 문에 ICommand::SetText 명령 개체를 문자열로 호출의 메서드는 icommand:: Execute메서드.The returned action string is a statement that needs to be executed by setting the ICommand::SetText method of a command object to the string and calling the ICommand::Executemethod. 명령이 성공하지 않으면 오류가 반환됩니다.If the command does not succeed, an error is returned.
데이터 집합DATASET 동작 문자열로 반환된은 설정 하 여 실행 해야 하는 MDX 문의 ICommand::SetText 명령 개체를 문자열로 호출의 메서드는 icommand:: Execute 메서드.The returned action string is an MDX statement that needs to be run by setting the ICommand::SetText method of a command object to the string and calling the ICommand::Execute method. 요청된 된 인터페이스 ID (IID) 해야 i d a합니다.The requested interface ID (IID) should be IDataset. 데이터 집합이 생성된 경우 명령이 성공한 것입니다.The command succeeds if a data set has been created. 클라이언트 응용 프로그램에서는 사용자가 반환된 데이터 집합을 검색할 수 있어야 합니다.The client application should allow the user to browse the returned data set.
행 집합ROWSET 비슷한 DATASET의 IID를 요청 하지 않고 i d a, 클라이언트 응용 프로그램의 IID를 요청 해야 IRowset합니다.Similar to DATASET, but instead of requesting an IID of IDataset, the client application should ask for an IID of IRowset. 행 집합이 생성된 경우 명령이 성공한 것입니다.The command succeeds if a rowset has been created. 클라이언트 응용 프로그램에서는 사용자가 반환된 행 집합을 검색할 수 있어야 합니다.The client application should allow the user to browse the returned rowset.
명령줄COMMANDLINE 클라이언트 응용 프로그램에서 동작 문자열을 실행합니다.The client application should execute the action string. 이 문자열은 명령 줄입니다.The string is a command line.
소유PROPRIETARY 응용 프로그램에 특정 동작에 대한 특수한 사용자 지정 지식이 없으면 클라이언트 응용 프로그램에서 동작이 표시되거나 실행되지 않습니다.A client application should not display, nor execute the action unless the application has a custom, nongeneric knowledge of the specific action. 클라이언트 응용 프로그램에 적절 한 제한을 설정 하 여이 명시적으로 요청 하지 않으면 소유 동작이 클라이언트 응용 프로그램에 반환 되지 않습니다는 i o n _합니다.Proprietary actions are not returned to the client application unless the client application explicitly asks for these by setting the appropriate restriction on the APPLICATION_NAME.

호출 유형Invocation Types

다음 표에서는 Analysis ServicesAnalysis Services에서 사용할 수 있는 여러 유형의 호출에 대해 설명합니다.The following table describes the different types of invocations available in Analysis ServicesAnalysis Services. 호출 유형은 클라이언트 응용 프로그램에서 동작 호출 시기를 결정하기 위해서만 사용됩니다.The invocation type is used only by the client application to help determine when to invoke the action. 호출 유형은 작업의 호출 동작을 결정하지 않습니다.The invocation type does not actually determine the invocation behavior of the action.

호출 유형Invocation type DescriptionDescription
대화형INTERACTIVE 클라이언트 응용 프로그램에서 사용자 상호 작용을 통해 동작이 호출됩니다.The action should be invoked by the client application through user interaction.
ON_OPENON_OPEN 대상 개체가 열려 있을 때 클라이언트 응용 프로그램에서 동작이 호출됩니다.The action should be invoked by the client application when the target object is opened. 이 호출 유형은 현재 구현되어 있지 않습니다.This invocation type is not currently implemented.
일괄 처리BATCH 클라이언트 응용 프로그램의 결정에 따라 대상 작업이 일괄 처리 작업에 포함된 경우 클라이언트 응용 프로그램에서 동작이 호출됩니다.The action should be invoked by the client application when the target object is involved in a batch operation, as determined by the client application. 이 호출 유형은 현재 구현되어 있지 않습니다.This invocation type is not currently implemented.

범위Scope

각 동작은 특정 큐브에 대해 정의되며 해당 큐브에서 고유한 이름을 가집니다.Each action is defined for a specific cube and has a unique name in that cube. 동작은 다음 표에 나열된 범위 중 하나를 포함할 수 있습니다.An action can have one of the scopes listed in the following table.

큐브 범위Cube scope
특정 차원, 멤버 또는 셀;의 독립적인 동작을 위한 예: "AS에 대 한 터미널 에뮬레이션 실행 / 400 프로덕션 시스템"입니다.For actions independent of specific dimensions, members, or cells; for example: "Launch terminal emulation for AS/400 production system".

차원 범위Dimension scope
특정 차원에 적용되는 동작을 위한 범위입니다.The action applies to a specific dimension. 이러한 동작은 특정 수준 또는 멤버 선택에 종속되지 않습니다.These actions are not dependent on specific selection of levels or members.

수준 범위Level scope
특정 차원 수준에 적용되는 동작을 위한 범위입니다.The action applies to a specific dimension level. 이러한 동작은 해당 차원의 특정 멤버 선택에 종속되지 않습니다.These actions are not dependent on specific selection of a member in that dimension.

멤버 범위Member scope
특정 멤버에 적용되는 동작을 위한 범위입니다.The action applies to specific level members.

셀 범위Cell scope
특정 셀에만 적용되는 동작을 위한 범위입니다.The action applies to specific cells only.

집합 범위Set scope
집합에만 적용되는 동작을 위한 범위입니다.The action applies to a set only. 이름, 이름은, 동작의 식 내에서 응용 프로그램 사용 되도록 예약 되어 있습니다.The name, ActionParameterSet, is reserved for use by the application inside the expression of the action.

관련 항목:See Also

MDX 데이터 정의 문 ( Mdx)MDX Data Definition Statements (MDX)