Propiedades de miembro intrínsecas (MDX)

Analysis Services expone propiedades intrínsecas en miembros de dimensión que se pueden incluir en una consulta para devolver datos adicionales o metadatos para su uso en una aplicación personalizada, o como ayuda para la investigación o la construcción de modelos. Si emplea las herramientas cliente de SQL Server, puede ver las propiedades intrínsecas en SQL Server Management Studio (SSMS).

Entre las propiedades intrínsecas se incluyen ID, KEY, KEYx y NAME, que son propiedades expuestas por todos los miembros en cualquier nivel. También puede devolver información de posición, como LEVEL_NUMBER o PARENT_UNIQUE_NAME, entre otras.

En función de cómo se construya la consulta, y de la aplicación cliente que se emplee para ejecutar las consultas, las propiedades de miembro pueden ser visibles o no en el conjunto de resultados. Si usa SQL Server Management Studio para probar o ejecutar consultas, puede hacer doble clic en un miembro del conjunto de resultados para abrir el cuadro de diálogo Propiedades de miembro y mostrar los valores de cada propiedad de miembro intrínseca.

Para obtener una introducción al uso y la visualización de propiedades de miembro de dimensión, vea Ver propiedades de miembro de SSAS dentro de una ventana de consulta MDX en SSMS.

[!NOTA]

Como proveedor compatible con la sección OLAP de la especificación OLE DB de marzo de 1999 (2.6), Microsoft SQL Server Analysis Services admite las propiedades de miembro intrínsecas que se enumeran en este tema.

Es posible que otros proveedores además de SQL Server Analysis Services admitan propiedades de miembro intrínsecas adicionales. Para obtener más información acerca de las propiedades de miembro intrínsecas compatibles con otros proveedores, vea la documentación que suministra cada uno de ellos.

Tipos de propiedades de miembro

Las propiedades de miembro intrínsecas compatibles con SQL Server Analysis Services son de dos tipos:

• Propiedades de miembro contextuales
  Estas propiedades de miembro se deben usar en el contexto de una jerarquía o un nivel específicos y proporcionan valores para cada miembro de la dimensión o el nivel especificado.

  Observe cómo el ejemplo siguiente incluye la ruta de acceso de la propiedad KEY: MEMBER [Measures].[Parent Member Key] AS [Product].[Product Categories].CurrentMember.Parent.PROPERTIES("KEY").

• Propiedades de miembro no contextuales
  Estas propiedades de miembro no pueden usarse en el contexto de una dimensión o un nivel específicos y devuelven los valores para todos los miembros en un eje.

  Las propiedades que no distinguen el contexto son independientes y no incluyen información de la ruta de acceso. Observe cómo no se especifica ninguna dimensión ni ningún nivel para PARENT_UNIQUE_NAME en el ejemplo siguiente: DIMENSION PROPERTIES PARENT_UNIQUE_NAME ON COLUMNS

Independientemente de si la propiedad de miembro intrínseca es contextual o no, se rige por las siguientes reglas:

• Únicamente se pueden especificar las propiedades de miembro intrínsecas relacionadas con los miembros de dimensión que se proyectan en el eje.

• Se pueden mezclar solicitudes de propiedades de miembro contextuales con propiedades de miembro intrínsecas no contextuales en la misma consulta.

• Se puede utilizar la palabra clave PROPERTIES para realizar consultas sobre las propiedades.

En las siguientes secciones se describen las distintas propiedades de miembro intrínsecas contextuales y no contextuales que ofrece SQL Server Analysis Services y cómo utilizar la palabra clave PROPERTIES con cada tipo de propiedad.

Propiedades de miembro contextuales

Todos los miembros de dimensión y de nivel admiten una lista de propiedades de miembro intrínsecas contextuales. En la siguiente tabla se incluyen estas propiedades contextuales.

Sintaxis de PROPERTIES para las propiedades contextuales

Estas propiedades de miembro se utilizan en el contexto de una dimensión o un nivel específicos y proporcionan valores de cada miembro de la dimensión o el nivel especificados.

En el caso de las propiedades de miembro de dimensión, el nombre de la propiedad debe ir precedido del nombre de la dimensión a la que se aplica la propiedad. En el siguiente ejemplo se muestra la sintaxis adecuada:

DIMENSION PROPERTIES Dimension.Property_name

En el caso de las propiedades de miembro de nivel, el nombre de la propiedad puede ir precedido solamente del nombre de nivel o, si se requieren especificaciones adicionales, del nombre de la dimensión y del nivel. En el siguiente ejemplo se muestra la sintaxis adecuada:

DIMENSION PROPERTIES [Dimension.]Level.Property_name

Para ilustrar lo explicado, suponga que desea devolver todos los nombres de cada uno de los miembros a los que se hace referencia en la dimensión [Sales]. Para devolver estos nombres, es preciso utilizar la siguiente instrucción en una consulta de expresiones multidimensionales (MDX):

DIMENSION PROPERTIES [Sales].Name

Propiedades de miembro no contextuales

Todos los miembros admiten una lista de propiedades de miembro intrínsecas idénticas independientemente del contexto. Estas propiedades proporcionan información adicional que pueden usar las aplicaciones para mejorar la experiencia del usuario.

En la siguiente tabla se incluyen las propiedades intrínsecas no contextuales compatibles con SQL Server Analysis Services.

[!NOTA]

Las columnas del conjunto de filas del esquema MEMBERS admiten las propiedades de miembro intrínsecas incluidas en la siguiente tabla. Para obtener más información acerca del conjunto de filas del esquema MEMBERS, vea Conjunto de filas MDSCHEMA_MEMBERS.

Sintaxis de PROPERTIES para las propiedades no contextuales

Use la siguiente sintaxis para especificar una propiedad de miembro intrínseca no contextual mediante la palabra clave PROPERTIES:

DIMENSION PROPERTIES Property

Tenga en cuenta que esta sintaxis no permite calificar la propiedad con una dimensión o un nivel. La propiedad no puede calificarse porque las propiedades de miembro intrínsecas no contextuales se aplican a todos los miembros de un eje.

Por ejemplo, una instrucción MDX que especifique la propiedad de miembro intrínseca DESCRIPTION debería tener la siguiente sintaxis:

DIMENSION PROPERTIES DESCRIPTION

Esta instrucción devuelve la descripción de cada miembro de la dimensión del eje. Si intenta calificar la propiedad con una dimensión o un nivel, como en Dimension.DESCRIPTION o en Level.DESCRIPTION, no se validará la instrucción.

Ejemplo

Los ejemplos siguientes muestran consultas MDX que devuelven propiedades intrínsecas.

Ejemplo 1: usar propiedades intrínsecas contextuales en una consulta

El ejemplo siguiente devuelve el identificador principal, la clave y el nombre de cada categoría de producto. Observe cómo las propiedades se exponen como medidas. Esto permite ver las propiedades de un conjunto de celdas al ejecutar la consulta, en lugar del cuadro de diálogo Propiedades del miembro en SSMS. Puede que desee ejecutar una consulta como esta para recuperar metadatos de miembro de un cubo implementado previamente.

WITH
MEMBER [Measures].[Parent Member ID] AS
 [Product].[Product Categories].CurrentMember.Parent.PROPERTIES("ID")
MEMBER [Measures].[Parent Member Key] AS
 [Product].[Product Categories].CurrentMember.Parent.PROPERTIES("KEY")
MEMBER [Measures].[Parent Member Name] AS
 [Product].[Product Categories].CurrentMember.Parent.PROPERTIES("Name")
SELECT
 {[Measures].[Parent Member ID], [Measures].[Parent Member Key], [Measures].[Parent Member Name] } on COLUMNS, 
 [Product].[Product Categories].AllMembers on ROWS
FROM [Adventure Works]

Ejemplo 2: usar propiedades intrínsecas no contextuales

El ejemplo siguiente es la lista completa de propiedades intrínsecas no contextuales. Después de ejecutar la consulta en SSMS, haga clic en los miembros individuales para ver las propiedades en el cuadro de diálogo Propiedades del miembro.

SELECT [Measures].[Sales Amount Quota] on COLUMNS,
[Employee].[Employees].members
DIMENSION PROPERTIES
 CATALOG_NAME , 
 CHILDREN_CARDINALITY ,
 CUSTOM_ROLLUP , 
 CUSTOM_ROLLUP_PROPERTIES , 
 DESCRIPTION , 
 DIMENSION_UNIQUE_NAME , 
 HIERARCHY_UNIQUE_NAME ,
 IS_DATAMEMBER , 
 IS_PLACEHOLDERMEMBER , 
 KEY0 ,
 LCID ,
 LEVEL_NUMBER ,
 LEVEL_UNIQUE_NAME ,
 MEMBER_CAPTION , 
 MEMBER_KEY , 
 MEMBER_NAME , 
 MEMBER_TYPE ,
 MEMBER_UNIQUE_NAME , 
 MEMBER_VALUE , 
 PARENT_COUNT , 
 PARENT_LEVEL , 
 PARENT_UNIQUE_NAME ,
 SKIPPED_LEVELS , 
 UNARY_OPERATOR , 
 UNIQUE_NAME  
 ON ROWS
FROM [Adventure Works]
WHERE [Employee].[Employee Department].[Department].&[Sales]

Ejemplo 3: devolver propiedades de miembro como datos de un conjunto de resultados

El siguiente ejemplo devuelve el título traducido del miembro de la categoría de producto en la dimensión Product del cubo de Adventure Works para las configuraciones regionales especificadas.

WITH 
MEMBER Measures.CategoryCaption AS Product.Category.CurrentMember.MEMBER_CAPTION
MEMBER Measures.SpanishCategoryCaption AS Product.Category.CurrentMember.Properties("LCID3082")
MEMBER Measures.FrenchCategoryCaption AS Product.Category.CurrentMember.Properties("LCID1036")
SELECT 
{ Measures.CategoryCaption, Measures.SpanishCategoryCaption, Measures.FrenchCategoryCaption } ON 0
,[Product].[Category].MEMBERS ON 1
FROM [Adventure Works]

Vea también

Referencia

PeriodsToDate (MDX)

Children (MDX)

Hierarchize (MDX)

Count (Set) (MDX)

Filter (MDX)

AddCalculatedMembers (MDX)

DrilldownLevel (MDX)

Properties (MDX)

PrevMember (MDX)

Referencia de funciones MDX (MDX)

Conceptos

Usar las propiedades de miembro (MDX)