Definição de Dados MDX - CREATE SET

Cria um conjunto nomeado com o âmbito da sessão para o cubo atual.

Syntax

  
CREATE [SESSION] [ STATIC | DYNAMIC ] [HIDDEN] SET   
   CURRENTCUBE | Cube_Name  
      .Set_Name AS 'Set_Expression'  
      [,Property_Name = Property_Value, ...n]  

Arguments

Cube_Name
Uma expressão de cadeia válida que fornece o nome do cubo.

Set_Name
Uma expressão de cadeia válida que fornece o nome para o conjunto nomeado que está a ser criado.

Set_Expression
Uma expressão válida de Expressões Multidimensionais (MDX) que devolve um conjunto.

Property_Name
Uma cadeia válida que fornece o nome de uma propriedade de conjunto.

Property_Value
Uma expressão escalar válida que define o valor da propriedade do conjunto.

Remarks

Um conjunto nomeado é um conjunto de membros de dimensão (ou uma expressão que define um conjunto) que cria para usar novamente. Por exemplo, um conjunto nomeado permite definir um conjunto de membros de dimensão que consiste no conjunto das dez melhores lojas por vendas. Este conjunto pode ser definido estaticamente, ou através de uma função como TopCount. Este conjunto nomeado pode então ser usado onde for necessário o conjunto das 10 lojas principais.

A instrução CREATE SET cria um conjunto nomeado que permanece disponível durante toda a sessão e, por isso, pode ser usado em múltiplas consultas numa mesma sessão. Para mais informações, consulte Criação de Session-Scoped Membros Calculados (MDX).

Também pode definir um conjunto nomeado para ser usado por uma única consulta. Para definir tal conjunto, utiliza-se a cláusula WITH na instrução SELECT. Para mais informações sobre a cláusula WITH, veja Criar Query-Scoped Conjuntos Nomeados (MDX).

A cláusula Set_Expression pode conter qualquer função que suporte a sintaxe MDX. Conjuntos criados com a instrução CREATE SET que não especificam a cláusula SESSION têm âmbito de sessão. Use a cláusula WITH para criar um conjunto com âmbito de consulta.

Especificar um cubo diferente do que está atualmente ligado causa um erro. Por isso, deve usar CURRENTCUBE em vez do nome do cubo para indicar o cubo atual.

Scope

Um conjunto definido pelo utilizador pode ocorrer dentro de um dos escopetos listados na tabela seguinte.

Escopo da consulta
A visibilidade e a duração do conjunto estão limitadas à consulta. O conjunto é definido numa consulta individual. O âmbito da consulta sobrepõe-se ao âmbito da sessão. Para mais informações, consulte Criação de Query-Scoped Conjuntos Nomeados (MDX).

Âmbito da sessão
A visibilidade e a duração do conjunto são limitadas à sessão em que foi criado. (A duração é inferior à duração da sessão se for emitida uma instrução DROP SET no conjunto.) A instrução CREATE SET cria um conjunto com o âmbito da sessão. Use a cláusula WITH para criar um conjunto com âmbito de consulta.

Example

O exemplo seguinte cria um conjunto chamado Core Products. A consulta SELECT demonstra então como chamar o conjunto recém-criado. A instrução CREATE SET deve ser executada antes de a consulta SELECT poder ser executada – não podem ser executadas no mesmo lote.

CREATE SET [Adventure Works].[Core Products] AS '{[Product].[Category].[Bikes]}'  
  
SELECT [Core Products] ON 0  
  FROM [Adventure Works]  

Avaliação de Conjuntos

A avaliação de conjuntos pode ser definida para ocorrer de forma diferente; pode ser definido para ocorrer apenas uma vez na criação do conjunto ou pode ser definido para ocorrer sempre que o conjunto for usado.

ESTÁTICA
Indica que o conjunto é avaliado apenas uma vez no momento em que a instrução CREATE SET é avaliada.

DINÂMICA
Indica que o conjunto deve ser avaliado sempre que é usado numa consulta.

Definir Visibilidade

O conjunto pode ser visível ou não para outros utilizadores que consultem o cubo.

ESCONDIDO
Especifica que o conjunto não é visível para os utilizadores que consultam o cubo.

Propriedades Padrão

Cada conjunto tem um conjunto de propriedades por defeito. Quando uma aplicação cliente está ligada aos Serviços de Análise, as propriedades padrão são suportadas ou disponíveis para suporte, conforme a escolha do administrador.

Ver também

Declaração DROP SET (MDX)
Declarações de Definição de Dados MDX (MDX)