Definición de Datos MDX - CREATE SET

Crea un conjunto nombrado con el alcance de sesión del cubo actual.

Syntax

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

Arguments

Cube_Name
Una expresión de cadena válida que proporciona el nombre del cubo.

Set_Name
Una expresión de cadena válida que proporciona el nombre del conjunto nombrado que se está creando.

Set_Expression
Una expresión válida de Expresiones Multidimensionales (MDX) que devuelve un conjunto.

Property_Name
Una cadena válida que proporciona el nombre de una propiedad de conjunto.

Property_Value
Una expresión escalar válida que define el valor de la propiedad del conjunto.

Remarks

Un conjunto nombrado es un conjunto de miembros dimensionales (o una expresión que define un conjunto) que creas para volver a utilizarlos. Por ejemplo, un conjunto nombrado permite definir un conjunto de miembros dimensionales que consiste en el conjunto de las diez tiendas principales por ventas de la empresa. Este conjunto puede definirse de forma estática o mediante una función como TopCount. Este conjunto con nombre puede usarse donde se necesite el conjunto de las 10 tiendas principales.

La instrucción CREATE SET crea un conjunto nombrado que permanece disponible durante toda la sesión y, por tanto, puede usarse en múltiples consultas dentro de una sesión. Para más información, véase Creación de Session-Scoped Miembros Calculados (MDX).

También puedes definir un conjunto con nombre para que lo use una sola consulta. Para definir tal conjunto, se utiliza la cláusula WITH en la sentencia SELECT. Para más información sobre la cláusula WITH, véase Creación de Query-Scoped Conjuntos Nombrados (MDX).

La cláusula Set_Expression puede contener cualquier función que soporte la sintaxis MDX. Los conjuntos creados con la sentencia CREATE SET que no especifican la cláusula SESSION tienen alcance de sesión. Usa la cláusula WITH para crear un conjunto con alcance de consulta.

Especificar un cubo distinto al que está conectado actualmente provoca un error. Por lo tanto, deberías usar CURRENTCUBE en lugar del nombre de un cubo para indicar el cubo actual.

Ámbito

Un conjunto definido por el usuario puede aparecer dentro de uno de los ámbitos listados en la siguiente tabla.

Ámbito de la consulta
La visibilidad y la vida útil del conjunto se limitan a la consulta. El conjunto se define en una consulta individual. El alcance de la consulta anula el alcance de sesión. Para más información, consulte Creación de Query-Scoped Conjuntos Nombrados (MDX).

Alcance de la sesión
La visibilidad y la vida útil del conjunto están limitadas a la sesión en la que se crea. (La vida útil es menor que la duración de la sesión si se emite una instrucción DROP SET en el set.) La sentencia CREATE SET crea un conjunto con el alcance de la sesión. Usa la cláusula WITH para crear un conjunto con alcance de consulta.

Example

El siguiente ejemplo crea un conjunto llamado Productos Núcleo. La consulta SELECT demuestra entonces cómo llamar al conjunto recién creado. La sentencia CREATE SET debe ejecutarse antes de que se pueda ejecutar la consulta SELECT; no pueden ejecutarse en el mismo lote.

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

Evaluación de conjuntos

La evaluación de conjuntos puede definirse de forma diferente; puede definirse para que ocurra solo una vez en la creación del conjunto o puede definirse para que ocurra cada vez que se usa el conjunto.

ESTÁTICA
Indica que el conjunto se evalúa solo una vez en el momento en que se evalúa la sentencia CREATE SET .

DYNAMIC
Indica que el conjunto debe evaluarse cada vez que se utiliza en una consulta.

Establecer visibilidad

El conjunto puede ser visible o no para otros usuarios que consulten el cubo.

OCULTO
Especifica que el conjunto no es visible para los usuarios que consultan el cubo.

Propiedades estándar

Cada conjunto tiene un conjunto de propiedades predeterminadas. Cuando una aplicación cliente está conectada a Analysis Services, las propiedades predeterminadas están soportadas o disponibles para ser soportadas, según lo que elija el administrador.

Identificador de propiedad Meaning
PIE DE FOTO Una cadena que la aplicación cliente utiliza como pie de foto para el conjunto.
DISPLAY_FOLDER Una cadena que identifica el camino de la carpeta de visualización que la aplicación cliente utiliza para mostrar el conjunto. El separador a nivel de carpeta está definido por la aplicación cliente. Para las herramientas y clientes suministrados por Analysis Services, la barra inversa (\) es el separador de niveles. Para proporcionar múltiples carpetas de visualización para un conjunto definido, se utiliza un punto y coma (;) para separar las carpetas.

Véase también

Declaración DROP SET (MDX)
Declaraciones de definición de datos MDX (MDX)

  • Last updated on