Instrução CREATE ACTION (MDX)

Artigo
05/07/2013

Cria uma ação que pode ser associada a um cubo, uma dimensão, uma hierarquia ou um objeto subordinado.

Sintaxe

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' ]

Argumentos

Cube_Name
Uma cadeia de caracteres válida que fornece um nome de cubo.
Action_ Name
Uma cadeia de caracteres válida que fornece o nome da ação que está sendo criada.
Hierarchy_ Name
Uma cadeia de caracteres válida que fornece um nome de hierarquia.
Level_ Name
Uma cadeia de caracteres válida que fornece um nome de nível.
Member_ Name
Uma cadeia de caracteres válida que fornece um nome ou chave de membro.
MDX_Expression
Uma expressão MDX válida.
String_Expression
Uma expressão de cadeia de caracteres válida.

Comentários

Os aplicativos cliente podem criar e executar ações que não são seguras, além de usar funções que não são seguras. Para evitar essas situações, use a propriedade Safety Options. Para obter mais informações, consulte as Propriedade de Opções de Segurança.

Observação
Esta instrução é incluída para compatibilidade com versões anteriores. As novas ações para o SQL Server Analysis Services, como Extração de Detalhes ou Relatório, não têm suporte.

Tipos de ação

A tabela a seguir descreve os diferentes tipos de ação disponíveis no Microsoft SQL Server Analysis Services.

URL

A cadeia de caracteres de ação retornada é uma URL que deve ser aberto usando um navegador de Internet.

Observação
Se essa ação não começar com http:// ou https://, a ação não ficará disponível para o navegador, a não ser que SafetyOptions seja definido como DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.

HTML

A cadeia de caracteres de ação retornada é um script HTML. A cadeia de caracteres deve ser salva em um arquivo e o arquivo deve ser processado com um navegador de Internet. Neste caso, um script inteiro pode ser executado como parte do HTML gerado.

STATEMENT

A cadeia de caracteres de ação retornada é uma instrução que precisa ser executada com a configuração do método ICommand::SetText de um objeto de comando para a cadeia de caracteres e a invocação do método ICommand::Execute. Se o comando não tiver êxito, um erro será retornado.

DATASET

A cadeia de caracteres de ação retornada é uma instrução MDX que precisa ser executada com a configuração do método ICommand::SetText de um objeto de comando para a cadeia de caracteres e a invocação do método ICommand::Execute. A ID de interface (IID) solicitada deve ser IDataset. O comando terá êxito se um conjunto de dados tiver sido criado. O aplicativo cliente deve permitir que o usuário navegue pelo conjunto de dados retornado.

ROWSET

Similar a DATASET, mas em vez de solicitar uma IID de IDataset, o aplicativo cliente deve solicitar uma IID de IRowset. O comando terá êxito se um conjunto de linhas tiver sido criado. O aplicativo cliente deve permitir que o usuário navegue pelo conjunto de linhas retornado.

COMMANDLINE

O aplicativo cliente deve executar a cadeia de caracteres de ação. A cadeia de caracteres é uma linha de comando.

PROPRIETARY

O aplicativo cliente não deve exibir nem executar a ação, a não ser que o aplicativo tenha um conhecimento personalizado e não genérico da ação específica. As ações de propriedade não são retornadas para o aplicativo cliente, a não ser que o aplicativo cliente solicite explicitamente essas ações através da configuração da restrição apropriada em APPLICATION_NAME.

Tipos de invocação

A tabela a seguir descreve os diferentes tipos de invocação disponíveis no Analysis Services. O tipo de invocação é usado somente pelo aplicativo cliente para ajudar a determinar quando a ação deve ser invocada. O tipo de invocação não determina realmente o comportamento de invocação da ação.

Tipo de invocação	Descrição
INTERACTIVE	A ação deve ser invocada pelo aplicativo cliente por meio da interação do usuário.
ON_OPEN	A ação deve ser invocada pelo aplicativo cliente quando o objeto de destino é aberto. Esse tipo de invocação não é implementado atualmente.
BATCH	A ação deve ser invocada pelo aplicativo cliente quando o objeto de destino é envolvido em uma operação em lotes, conforme determinado pelo aplicativo cliente. Esse tipo de invocação não é implementado atualmente.

Escopo

Cada ação é definida para um cubo específico e tem um nome exclusivo nesse cubo. Uma ação pode ter um dos escopos listados na tabela a seguir.

Escopo de cubo
Para ações independentes de dimensões, membros ou células específicos; por exemplo, “Lançar emulação terminal para o sistema de produção AS/400”.
Escopo de dimensão
A ação se aplica a uma dimensão específica. Essas ações não dependem da seleção específica de níveis ou membros.
Escopo de nível
A ação se aplica a um nível de dimensão específico. Essas ações não dependem da seleção específica de um membro dessa dimensão.
Escopo de membro
A ação se aplica a membros de nível específicos.
Escopo de célula
A ação se aplica somente a células específicas.
Escopo de conjunto
A ação se aplica somente a um conjunto. O nome, ActionParameterSet, é reservado para ser usado pelo aplicativo dentro da expressão da ação.

Consulte também

Outros recursos

Instruções de definição de dados MDX (MDX)

Compartilhar via