Definición de datos de MDX: CREATE SET

Crea un conjunto con nombre con ámbito de sesión para el cubo actual.

Sintaxis

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

Argumentos

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

Set_Name
Expresión de cadena válida que proporciona el nombre del conjunto con nombre que se va a crear.

Set_Expression
Expresión MDX (Expresiones multidimensionales) válida que devuelve un conjunto.

Property_Name
Cadena válida que proporciona el nombre de una propiedad del conjunto.

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

Comentarios

Un conjunto con nombre es un conjunto de miembros de dimensión (o una expresión que define un conjunto) que se crea para utilizarse varias veces. Por ejemplo, un conjunto con nombre posibilita la definición de un conjunto de miembros de dimensión compuesto por el conjunto de los diez establecimientos con más ventas. Este conjunto se puede definir estáticamente o mediante una función como TopCount. Este conjunto con nombre puede usarse cuando se necesite el conjunto de los diez mejores establecimientos.

La instrucción CREATE SET crea un conjunto con nombre que permanece disponible durante toda la sesión, y por lo tanto, puede usarse en diversas consultas durante una sesión. Para obtener más información, vea Crear Session-Scoped miembros calculados (MDX).

También puede definir un conjunto con nombre para que lo use una sola consulta. Para definir un conjunto de este tipo, utilice la cláusula WITH en la instrucción SELECT. Para obtener más información sobre la cláusula WITH, vea Creating Query-Scoped Named Sets (MDX) (Crear conjuntos con nombre [MDX]).

La cláusula Set_Expression puede contener cualquier función que admita la sintaxis MDX. Los conjuntos creados con la instrucción CREATE SET que no especifiquen la cláusula SESSION tienen ámbito de sesión. Utilice la cláusula WITH para crear un conjunto con ámbito de consulta.

Si especifica un cubo distinto del que está conectado actualmente, se genera un error. Por lo tanto, debe utilizar CURRENTCUBE en lugar de un nombre de cubo para indicar el cubo actual.

Ámbito

Un conjunto definido pro el usuario puede producirse en uno de los ámbitos enumerados en la tabla siguiente.

Ámbito de la consulta
La visibilidad y duración del conjunto se limita a la consulta. El conjunto se define en una consulta individual. El ámbito de consulta prevalece sobre el ámbito de sesión. Para obtener más información, vea Creating Query-Scoped Named Sets (MDX) (Crear conjuntos con nombre [MDX]).

Ámbito de sesión
La visibilidad y duración del conjunto se limita a la sesión en la que se creó. (La duración es menor que la duración de la sesión si se emite una instrucción DROP SET en el conjunto). La instrucción CREATE SET crea un conjunto con ámbito de sesión. Utilice la cláusula WITH para crear un conjunto con ámbito de consulta.

Ejemplo

El siguiente ejemplo crea un conjunto denominado Core Products. A continuación, la consulta SELECT llama al conjunto recién creado. La instrucción CREATE SET debe ejecutarse antes de que se pueda ejecutar la consulta SELECT (no se pueden ejecutar en el mismo lote).

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

Evaluación del conjunto

La evaluación del conjunto se puede programar para producirse de manera diferente; se puede definir para que se produzca solo una vez cuando se crea el conjunto o cada vez que se utilice el conjunto.

STATIC
Indica que el conjunto solo se evalúa una vez cuando se evalúa la instrucción CREATE SET.

DYNAMIC
Indica que el conjunto se evaluará cada vez que se use en una consulta.

Visibilidad del conjunto

El conjunto puede estar o visible o no para otros usuarios que consultan el cubo.

HIDDEN
Especifica que el conjunto no está visible para los usuarios que consultan el cubo.

Propiedades estándar

Cada conjunto tiene una serie de propiedades predeterminadas. Cuando una aplicación cliente está conectada a Analysis Services, se admiten las propiedades predeterminadas o están disponibles para ser compatibles, como elige el administrador.

Identificador de la propiedad	Significado
CAPTION	Cadena que utiliza la aplicación cliente como título para el conjunto.
DISPLAY_FOLDER	Cadena que identifica la ruta de la carpeta que usa la aplicación cliente para mostrar el conjunto. La aplicación cliente define el separador de niveles de carpetas. Para las herramientas y los clientes proporcionados por Analysis Services, la barra diagonal inversa (\) es el separador de nivel. Si va a asignar varias carpetas para mostrar a un conjunto definido, utilice un punto y coma (;) para separar las carpetas.

Consulte también

DROP SET (Instrucción, MDX)
Instrucciones de definición de datos de MDX (MDX)