Compartir a través de

  • Artículo

Instrucción CREATE SET (MDX)

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 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.

Notas

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 puede definirse de forma estática, o mediante una función como TopCount. Este conjunto con nombre puede entonces utilizarse 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 utilizarse en diversas consultas durante una sesión. Para obtener más información, vea Crear miembros calculados de ámbito de sesión (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 Crear conjuntos con nombre del ámbito de consulta (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 consulta
    La visibilidad y vigencia 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 Crear conjuntos con nombre del ámbito de consulta (MDX).

  • Ámbito de sesión
    La visibilidad y vigencia del conjunto se limita a la sesión en la que se creó. (La vigencia 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.

  • Ámbito global
    Para crear un conjunto con nombre con un ámbito más amplio que el contexto de la sesión del usuario, es decir, un ámbito que represente la duración de la instancia en ejecución, debe utilizar la instrucción CREATE SET dentro del script MDX predeterminado. Para obtener más información, vea Script MDX básico (MDX). Un conjunto con nombre definido utilizando CREATE SET en el script MDX predeterminado está disponible para todos los usuarios en todas sus consultas MDX de cualquier sesión.

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.

Para obtener más información, vea Crear conjuntos con nombre en MDX (MDX).

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 se conecta una aplicación cliente a MicrosoftAnalysis Services, se admiten las propiedades predeterminadas, o bien se ponen a disposición para ser admitidas, según lo que decida 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 clientes proporcionados por Analysis Services, el separador de niveles es la barra diagonal inversa (\). Si va a asignar varias carpetas para mostrar a un conjunto definido, utilice un punto y coma (;) para separar las carpetas.