Definição de Dados MDX - CREATE SET

Cria um conjunto nomeado com escopo de 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 string válida que fornece o nome do cubo.

Set_Name
Uma expressão de string válida que fornece o nome para o conjunto nomeado que está sendo criado.

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

Property_Name
Uma string 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 você cria para usar novamente. Por exemplo, um conjunto nomeado possibilita definir um conjunto de membros de dimensão que consiste no conjunto das dez lojas mais populares por vendas. Esse conjunto pode ser definido estaticamente, ou por meio de uma função como TopCount. Esse 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, portanto, pode ser usado em múltiplas consultas em uma mesma sessão. Para mais informações, veja Criação de Membros Calculados Session-Scoped (MDX).

Você também pode definir um conjunto nomeado para uso por uma única consulta. Para definir tal conjunto, você usa a cláusula WITH na instrução SELECT. Para mais informações sobre a cláusula WITH, veja Criando 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 escopo de sessão. Use a cláusula WITH para criar um conjunto com escopo de consulta.

Especificar um cubo diferente do que está conectado atualmente causa um erro. Portanto, você deve usar CURRENTCUBE no lugar do nome do cubo para indicar o cubo atual.

Scope

Um conjunto definido pelo usuário pode ocorrer dentro de um dos escopos listados na tabela a seguir.

Escopo da consulta
A visibilidade e a vida útil do conjunto são limitadas à consulta. O conjunto é definido em uma consulta individual. O escopo da consulta sobrepõe o escopo da sessão. Para mais informações, veja Criando Query-Scoped Conjuntos Nomeados (MDX).

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

Example

O exemplo a seguir cria um conjunto chamado Core Products. A consulta SELECT então demonstra a chamada do conjunto recém-criado. A instrução CREATE SET deve ser executada antes que a consulta SELECT possa ser executada – elas 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 toda vez que o conjunto for usado.

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

DYNAMIC
Indica que o conjunto deve ser avaliado toda vez que for usado em uma consulta.

Definir visibilidade

O conjunto pode ser visível ou não para outros usuários que consultam o cubo.

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

Propriedades Padrão

Cada conjunto possui um conjunto de propriedades padrão. Quando uma aplicação cliente está conectada aos Serviços de Análise, as propriedades padrão são suportadas ou disponíveis para suporte, conforme o administrador desejar.

Identificador de propriedade Meaning
LEGENDA Uma string que o aplicativo cliente usa como legenda para o conjunto.
DISPLAY_FOLDER Uma string que identifica o caminho da pasta de exibição que o aplicativo cliente usa para mostrar o conjunto. O separador em nível de pasta é definido pela aplicação cliente. Para as ferramentas e clientes fornecidos pela Analysis Services, a barra inversa (\) é o separador de nível. Para fornecer múltiplas pastas de exibição para um conjunto definido, use um ponto e vírgula (;) para separar as pastas.

Consulte Também

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

  • Last updated on