Proprietà intrinseche dei membri (MDX)

Articolo
12/15/2008

Data aggiornamento: 12 dicembre 2006

Essendo un provider conforme alla sezione OLAP della specifica OLE DB del mese di marzo 1999 (2.6), Microsoft SQL Server 2005 Analysis Services (SSAS) supporta le proprietà intrinseche dei membri elencate in questo argomento.

[!NOTA] I provider diversi da SQL Server 2005 Analysis Services (SSAS) possono supportare ulteriori proprietà intrinseche dei membri. Per ulteriori informazioni sulle proprietà intrinseche dei membri supportate da altri provider, consultare la documentazione fornita con tali provider.

Tipi di proprietà dei membri

Le proprietà intrinseche dei membri supportate da SQL Server 2005 Analysis Services (SSAS) sono di due tipi:

Proprietà dei membri sensibili al contesto
Queste proprietà dei membri devono essere utilizzate nel contesto di una dimensione o di un livello specifico e definiscono valori per ogni membro della dimensione o del livello specificato.

Proprietà dei membri non sensibili al contesto
Queste proprietà dei membri non possono essere utilizzate nel contesto di una dimensione o di un livello specifico e definiscono i valori di tutti i membri su un asse.

Indipendentemente dal fatto che una proprietà intrinseca di un membro sia sensibile o meno al contesto, valgono le regole di utilizzo seguenti:

È possibile specificare solo le proprietà intrinseche dei membri correlate ai membri delle dimensioni proiettati sull'asse.
In una stessa query è possibile includere sia richieste per proprietà dei membri sensibili al contesto che per proprietà intrinseche dei membri non sensibili al contesto.
Nelle query relative alla proprietà è necessario utilizzare la parola chiave PROPERTIES.

Nelle sezioni seguenti vengono descritte sia le proprietà intrinseche dei membri sensibili al contesto, sia quelle non sensibili al contesto disponibili in SQL Server 2005 Analysis Services (SSAS), nonché l'utilizzo della parola chiave PROPERTIES con ogni tipo di proprietà.

Proprietà dei membri sensibili al contesto

Tutti i membri delle dimensioni e dei livelli supportano un elenco di proprietà intrinseche sensibili al contesto. Nella tabella seguente sono elencate tali proprietà sensibili al contesto.

Proprietà	Descrizione
ID	ID gestito internamente per il membro.
Key	Valore archiviato nella colonna MEMBER_KEY del set di righe dello schema MEMBERS per il membro.
Name	Nome del membro.

Sintassi della parola chiave PROPERTIES per le proprietà sensibili al contesto

Queste proprietà dei membri possono essere utilizzate nel contesto di una dimensione o di un livello specifico e definiscono valori per ogni membro della dimensione o del livello specificato.

Nel caso delle proprietà dei membri di una dimensione, è necessario anteporre al nome della proprietà quello della dimensione a cui si riferisce la proprietà. La sintassi appropriata è illustrata nell'esempio seguente:

DIMENSION PROPERTIES Dimension.Property_name

Nel caso delle proprietà dei membri di un livello, è possibile anteporre al nome della proprietà solo il nome del livello oppure, per maggiore precisione, sia il nome della dimensione che quello del livello. La sintassi appropriata è illustrata nell'esempio seguente:

DIMENSION PROPERTIES [Dimension.]Level.Property_name

Si supponga ad esempio di voler restituire i nomi di tutti i membri a cui viene fatto riferimento nella dimensione [Sales]. Per restituire tali nomi, è necessario utilizzare l'istruzione seguente in una query MDX (Multidimensional Expressions):

DIMENSION PROPERTIES [Sales].Name

Proprietà dei membri non sensibili al contesto

Tutti i membri supportano un elenco di proprietà intrinseche dei membri che rimangono invariate indipendentemente dal contesto. Tali proprietà forniscono ulteriori informazioni che possono essere utilizzate dalle applicazioni per migliorare l'interazione con l'utente.

Nella tabella seguente sono elencate le proprietà intrinseche non sensibili al contesto supportate da SQL Server 2005 Analysis Services (SSAS).

[!NOTA] Le colonne nel set di righe dello schema MEMBERS supportano le proprietà intrinseche dei membri elencate nella tabella seguente. Per ulteriori informazioni sul set di righe dello schema MEMBERS, vedere MDSCHEMA_MEMBERS Rowset.

Proprietà	Descrizione
ACTION_TYPE	Maschera di bit che indica i tipi di azioni sul membro. I possibili valori della proprietà sono i seguenti: MDACTION_TYPE_URL MDACTION_TYPE_HTML MDACTION_TYPE_STATEMENT MDACTION_TYPE_DATASET MDACTION_TYPE_ROWSET MDACTION_TYPE_COMMANDLINE MDACTION_TYPE_PROPRIETARY MDACTION_TYPE_REPORT MDACTION_TYPE_DRILLTHROUGH
CAPTION	Come per MEMBER_CAPTION.
CHILDREN_CARDINALITY	Numero di elementi figlio del membro. Poiché può trattarsi di una stima, il conteggio potrebbe non essere esatto. I provider restituiscono la miglior stima possibile.
CUBE_NAME	Nome del cubo a cui appartiene il membro.
CUSTOM_ROLLUP	Espressione personalizzata per il membro.
CUSTOM_ROLLUP_PROPERTIES	Proprietà personalizzate del membro.
DESCRIPTION	Descrizione discorsiva del membro.
DIMENSION_UNIQUE_NAME	Nome univoco della dimensione a cui appartiene il membro. Per i provider che generano nomi univoci tramite qualificazione, i singoli componenti di tale nome sono delimitati.
HIERARCHY_UNIQUE_NAME	Nome univoco della gerarchia. Se il membro appartiene a più di una gerarchia, sarà presente una riga per ogni gerarchia a cui appartiene il membro. Per i provider che generano nomi univoci tramite qualificazione, i singoli componenti di tale nome sono delimitati.
IS_DATAMEMBER	Valore booleano che indica se il membro è un membro di dati.
KEYx	Chiave del membro, in cui x è il numero ordinale in base zero della chiave. KEY0 è disponibile per chiavi composte e non composte, mentre KEY1, KEY2 e così via sono disponibili solo per chiavi composte. Key0, Key1, Key2 e così via formano la chiave composta.
LCIDx	Conversione della didascalia del membro del valore esadecimale dell'ID delle impostazioni internazionali, dove x è il valore decimale dell'ID delle impostazioni internazionali, ad esempio LCID1009 per Inglese-Canada. È disponibile solo se nella conversione la colonna della didascalia è associata all'origine dei dati.
LEVEL_NUMBER	Distanza del membro dal livello principale della gerarchia. Per il livello principale è zero.
LEVEL_UNIQUE_NAME	Nome univoco del livello a cui appartiene il membro. Per i provider che generano nomi univoci tramite qualificazione, i singoli componenti di tale nome sono delimitati.
MEMBER_CAPTION	Etichetta o didascalia associata al membro. La didascalia viene utilizzata soprattutto a scopo di visualizzazione. Se non esiste una didascalia, la query restituirà MEMBER_NAME.
MEMBER_KEY	Valore della chiave del membro nel tipo di dati originale. MEMBER_KEY è disponibile per compatibilità con le versioni precedenti. MEMBER_KEY ha lo stesso valore di KEY0 per le chiavi non composte e la proprietà MEMBER_KEY è Null per le chiavi composte.
MEMBER_NAME	Nome del membro.
MEMBER_TYPE	Tipo del membro. I possibili valori della proprietà sono i seguenti: MDMEMBER_TYPE_REGULAR MDMEMBER_TYPE_ALL MDMEMBER_TYPE_FORMULA MDMEMBER_TYPE_MEASURE MDMEMBER_TYPE_UNKNOWN MDMEMBER_TYPE_FORMULA ha la precedenza rispetto a MDMEMBER_TYPE_MEASURE. Di conseguenza, se nella dimensione Measures esiste un membro di tipo formula (calcolato), la proprietà MEMBER_TYPE del membro calcolato sarà MDMEMBER_TYPE_FORMULA.
MEMBER_UNIQUE_NAME	Nome univoco del membro. Per i provider che generano nomi univoci tramite qualificazione, i singoli componenti di tale nome sono delimitati.
MEMBER_VALUE	Valore del membro nel tipo originale.
PARENT_COUNT	Numero di elementi padre del membro.
PARENT_LEVEL	Distanza dell'elemento padre del membro dal livello principale della gerarchia. Per il livello principale è zero.
PARENT_UNIQUE_NAME	Nome univoco dell'elemento padre del membro. Per tutti i membri al livello principale viene restituito NULL. Per i provider che generano nomi univoci tramite qualificazione, i singoli componenti di tale nome sono delimitati.
UNARY_OPERATOR	Operatore unario per il membro.

Sintassi della parola chiave PROPERTIES per le proprietà non sensibili al contesto

Utilizzare la sintassi seguente per specificare una proprietà intrinseca di un membro non sensibile al contesto, tramite la parola chiave PROPERTIES:

DIMENSION PROPERTIES Property

Si noti che questa sintassi non consente di qualificare la proprietà con una dimensione o un livello. La proprietà non può essere qualificata perché le proprietà intrinseche dei membri che non sono sensibili al contesto vengono applicate a tutti i membri di un asse.

Ad esempio, la sintassi dell'istruzione MDX che specifica la proprietà intrinseca dei membri DESCRIPTION è la seguente:

DIMENSION PROPERTIES DESCRIPTION

Questa istruzione restituisce la descrizione di ogni membro nella dimensione dell'asse. Se si tenta di qualificare la proprietà con una dimensione o un livello, ad esempio Dimension.DESCRIPTION o Level.DESCRIPTION, l'istruzione non verrà convalidata.

Esempi

Nell'esempio seguente viene restituito il numero dei rivenditori le cui vendite sono diminuite nel periodo di tempo precedente, in base ai valori del membro State-Province selezionati dall'utente valutati tramite la funzione Aggregate. Le funzioni Hierarchize (MDX) e DrilldownLevel (MDX) vengono utilizzate per restituire i valori relativi alla diminuzione delle vendite per le categorie di prodotti nella dimensione Product. La funzione Properties (MDX) viene utilizzata per restituire il nome univoco dei membri padre restituito sull'asse delle colonne.

WITH MEMBER Measures.[Declining Reseller Sales] AS 
   Count
      (Filter
         (Existing
            (Reseller.Reseller.Reseller)
            , [Measures].[Reseller Sales Amount] < 
            (
               [Measures].[Reseller Sales Amount]
                  ,[Date].Calendar.PrevMember
             )
          )
       )
MEMBER [Geography].[State-Province].x AS 
   Aggregate 
      ( 
         {[Geography].[State-Province].&[WA]&[US]
         , [Geography].[State-Province].&[OR]&[US] 
         } 
      )
SELECT NON EMPTY HIERARCHIZE 
   (AddCalculatedMembers 
      (
         {DrillDownLevel
            ({[Product].[All Products]})
         }
      )
   ) DIMENSION PROPERTIES PARENT_UNIQUE_NAME ON COLUMNS 
FROM [Adventure Works]
WHERE 
   (
      [Geography].[State-Province].x
      , [Date].[Calendar].[Calendar Quarter].&[2003]&[4]
      ,[Measures].[Declining Reseller Sales]
   )

Nell'esempio seguente viene restituita la didascalia tradotta del membro della categoria di prodotto della dimensione Product nel cubo Adventure Works per impostazioni internazionali specifiche.

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]

Vedere anche

Cronologia modifiche

Versione	Cronologia
12 dicembre 2006	Contenuto modificato: Aggiunta di un nuovo esempio per la proprietà LCID.
17 luglio 2006	Contenuto modificato: Aggiornamento della sintassi e degli argomenti per maggiore chiarezza. Aggiunta di esempi aggiornati.

Condividi tramite

Proprietà intrinseche dei membri (MDX)

Tipi di proprietà dei membri

Proprietà dei membri sensibili al contesto

Sintassi della parola chiave PROPERTIES per le proprietà sensibili al contesto

Proprietà dei membri non sensibili al contesto

Sintassi della parola chiave PROPERTIES per le proprietà non sensibili al contesto

Esempi

Vedere anche

Riferimento

Concetti

Guida in linea e informazioni

Cronologia modifiche

Risorse aggiuntive