Executar Scripts de MDX

Utilize scripts de MDX quando precisar de executar operações para Inserir ou Exportar dados.

Para a análise dos dados da grelha, utilize relatórios de MDX. Consulte Analisar Dados com Relatórios de MDX.

Para utilizar scripts de MDX, selecione um fluxo de trabalho:

Escrever, Carregar e Executar um Script de MDX

Utilize este fluxo de trabalho para escrever scripts de MDX num editor de texto e carregá-los para o Essbase.

  1. Escreva o script de MDX num editor de texto e grave-o com uma extensão .mdx.

  2. Carregue o script de MDX para o diretório da aplicação ou cubo em Ficheiros na interface da Web do Essbase.

  3. Execute o script de MDX a partir de Tarefas ou a partir do Smart View, utilizando Calcular no friso do Essbase.

Escrever um Script de MDX no Editor de Scripts e Executá-lo

Utilize este fluxo de trabalho para escrever scripts de MDX num editor de scripts no cubo e execute-os a partir de Tarefas.

  1. Na página Aplicações, expanda uma aplicação e um cubo.

  2. A partir do menu Ações do cubo, clique em Inspecionar.

  3. Clique em Scripts e, em seguida, clique em Scripts de MDX.

  4. Clique em + para abrir um editor de scripts.

  5. Escreva o script de MDX. Uma árvore de membros e uma lista de funções poderão ajudá-lo.

  6. Valide e grave o script e, em seguida, feche o editor de scripts.

  7. Execute o script de MDX a partir de Tarefas (consulte Executar MDX) ou, se estiver a utilizar o Smart View, utilize Calcular no friso do Essbase.

Criar um Script MDX no Cube Designer e Executá-lo

Utilize este fluxo de trabalho para criar scripts de MDX utilizando um livro da aplicação e execute-os a partir de Tarefas.

  1. Neste livro da aplicação, crie uma folha de cálculo MDX. Consulte Trabalhar com Folhas de Cálculo MDX no Cube Designer.
  2. Acrescente um nome de ficheiro no campo Nome do Ficheiro.
  3. Indique, no campo Executar MDX, se deve ser executado o MDX quando o cubo for criado. As entradas válidas são Sim e Não.
  4. Acrescente o script MDX abaixo da linha Script.
  5. Grave o livro da aplicação.
  6. Crie o cubo. Consulte Criar uma Aplicação e um Cubo no Cube Designer.
  7. Execute o script de MDX a partir de Tarefas ou, se estiver a utilizar o Smart View, utilize Calcular no friso do Essbase.

Diretrizes para Scripts de MDX

Utilize as seguintes diretrizes ao trabalhar com scripts de MDX.

  • Utilize scripts de MDX para efetuar operações para Inserir ou Exportar dados.

  • Para a análise da grelha, utilize relatórios de MDX em vez de scripts de MDX.

  • Opcionalmente, os scripts de MDX podem incluir variáveis de substituição em runtime.

    • Para serem utilizáveis no Smart View, os scripts de MDX com variáveis de substituição em runtime devem utilizar a sintaxe de XML no comando de cálculo SET RUNTIMESUBVARS, incluindo <RTSV_HINT>.

    • Para definir uma variável de substituição em runtime para que calcule apenas o setor visível dos dados no Smart View, defina o valor da variável de substituição em runtime como POV e defina o tipo de dados como membro.

    • Quando são executados a partir da interface da Web do Essbase, os scripts de MDX podem utilizar variáveis de substituição, mas não variáveis de substituição em runtime. Para utilizar variáveis de substituição em runtime nos scripts de MDX, deve executar os scripts a partir do Smart View, utilizando Calcular no friso do Essbase.

Utilizar Variáveis de Substituição

Exemplos de Scripts de MDX

Seguem-se exemplos de scripts de MDX que pode executar no cubo Sample Basic, a partir de Tarefas ou no Smart View.

Inserção de MDX

Pode gravar este script .mdx e executá-lo a partir de Tarefas ou da caixa de diálogo Calcular no Smart View.

INSERT "([Measures].[Payroll])" TO "([Measures].[Revised_Payroll])"
INTO [Sample].[Basic]
FROM (
       SELECT 
            {[Measures].[Payroll]} ON COLUMNS,
                {Crossjoin
                  (Crossjoin(Descendants([Year]), 
                   Crossjoin(Descendants([Scenario]),
                  Descendants([Product]))),
                  Descendants([Market]))} ON ROWS
       FROM [Sample].[Basic]
);

O exemplo acima assume que acrescentou anteriormente uma medida Revised_Payroll a Sample Basic.

Exportação de MDX

Pode gravar este script .mdx e executá-lo a partir de Tarefas ou da caixa de diálogo Calcular no Smart View.

EXPORT INTO FILE "sample01" OVERWRITE
SELECT 
 {[Mar],[Apr]} 
ON COLUMNS,
 Crossjoin({[New York]},
  Crossjoin({[Actual],[Budget]},
     {[Opening Inventory],[Ending Inventory]})) 
ON ROWS
FROM [Sample].[Basic]
WHERE ([100-10])

Depois de executar o script, o ficheiro de exportação seguinte, sample01.txt, é gravado no diretório do cubo do catálogo de ficheiros:

Market,Scenario,Measures,Mar,Apr
New York,Actual,Opening Inventory,2041,2108
New York,Actual,Ending Inventory,2108,2250
New York,Budget,Opening Inventory,1980,2040
New York,Budget,Ending Inventory,2040,2170

Exportação de MDX Utilizando Variáveis de Substituição em Runtime

Pode gravar este script .mdx e executá-lo a partir da caixa de diálogo Calcular no Smart View.

SET RUNTIMESUBVARS
{
 States = "Massachusetts"<RTSV_HINT><svLaunch>
                    <description>US States</description>
                    <type>member</type>
                    <allowMissing>false</allowMissing>
                    <dimension>Market</dimension>
                    <choice>multiple</choice>
                    </svLaunch></RTSV_HINT>;
};
EXPORT INTO FILE "sample002" OVERWRITE
SELECT
 {[Mar],[Apr]}
ON COLUMNS,
 Crossjoin({&States}, Crossjoin({[Actual],[Budget]},
 {[Opening Inventory],[Ending Inventory]}))
ON ROWS
FROM [Sample].[Basic]
WHERE ([100-10])

Depois de executar o script, o ficheiro de exportação seguinte, sample002.txt, é gravado no diretório do cubo do catálogo de ficheiros:

Market,Scenario,Measures,Mar,Apr
Massachusetts,Actual,Opening Inventory,-54,-348
Massachusetts,Actual,Ending Inventory,-348,-663
Massachusetts,Budget,Opening Inventory,-160,-520
Massachusetts,Budget,Ending Inventory,-520,-910