Executar Scripts de MDX

Use scripts MDX quando precisar executar operações de Inserção ou Exportação de dados.

Para análise de dados em grade, use relatórios MDX. Consulte Analisar Dados com Relatórios MDX.

Para usar scripts de MDX, selecione um workflow:

Escrever, Fazer Upload e Executar um Script MDX

Use este workflow para escrever scripts MDX em um editor de texto e fazer o upload deles no Essbase.

  1. Grave o script de MDX em um editor de texto e salve-o com uma extensão .mdx.

  2. Faça upload do script MDX para o diretório do aplicativo ou do cubo em Arquivos na interface web do Essbase.

  3. Execute o script de MDX em Jobs ou no Smart View, usando Calcular na faixa de opções do Essbase.

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

Use este workflow para escrever scripts de MDX em um editor de script no cubo e execute-os em Jobs.

  1. Na página Aplicativos, expanda um aplicativo e um cubo.

  2. No 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 script.

  5. Grave o script de MDX. Uma árvore de membros e lista de funções pode ajudá-lo.

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

  7. Execute o script MDX de Jobs (consulte Executar MDX) ou, se estiver usando o Smart View, use Calcular na faixa do Essbase.

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

Use este fluxo de trabalho para criar scripts de MDX usando uma pasta de trabalho do aplicativo e execute-os em Jobs.

  1. Em uma pasta de trabalho do aplicativo, crie uma planilha de MDX. Consulte Trabalhar com Planilhas de MDX no Cube Designer.
  2. Adicione um nome de arquivo no campo Nome do Arquivo.
  3. Indique, no campo Executar MDX, se é necessário executar o MDX no momento em que o cubo é criado. As entradas válidas são Sim e Não.
  4. Adicione o script MDX abaixo da linha do Script.
  5. Salve a pasta de trabalho do aplicativo.
  6. Crie o cubo. Consulte Criar um Aplicativo e um Cubo no Cube Designer.
  7. Execute o script de MDX de Jobs, ou se estiver usando o Smart View, use Calcular na faixa do Essbase.

Diretrizes para Scripts de MDX

Use as seguintes diretrizes ao trabalhar com scripts de MDX.

  • Use scripts MDX para executar operações de Inserção ou Exportação de dados.

  • Para análise de grade, use relatórios MDX em vez de scripts MDX.

  • Os scripts de MDX podem, como opção, incluir variáveis de substituição de runtime.

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

    • Para definir uma variável de substituição de runtime, de forma que ela calcule somente a fatia de dados no Smart View, defina o valor da variável de substituição de runtime como POV e defina os tipos de dados como membro.

    • Ao executar usando a interface web do Essbase, seus scripts de MDX podem usar variáveis de substituição, mas não variáveis de substituição de runtime. Para usar variáveis de substituição de runtime nos scripts de MDX, é necessário executar os scripts do Smart View, usando Calcular na faixa do Essbase.

Usar Variáveis de Substituição

Exemplos de Scripts de MDX

A seguir estão os exemplos de scripts de MDX que você pode executar no cubo Sample Basic ou nos Jobs ou no Smart View.

Inserção de MDX

Você pode salvar este script de .mdx e executá-lo dos Jobs 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 presume que você tenha adicionado anteriormente uma medida Revised_Payroll a Sample Basic.

Exportação de MDX

Você pode salvar este script de .mdx e executá-lo dos Jobs 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])

Após executar o script, o seguinte arquivo de exportação, sample01.txt, será salvo no diretório do cubo do catálogo de arquivos:

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 Usando Variável de Substituição de Runtime

Você pode salvar este script de .mdx e executá-lo 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])

Após executar o script, o seguinte arquivo de exportação, sample002.txt, será salvo no diretório do cubo do catálogo de arquivos:

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