MDX 儲存格屬性 - 使用儲存格屬性

發行項
07/05/2024

適用於： SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

多維度表達式中的儲存格屬性（MDX）包含多維度數據源中儲存格內容和格式的相關信息，例如 Cube。

MDX 支援 MDX SELECT 語句中的 CELL PROPERTIES 關鍵詞，以擷取內部單元格屬性。內建單元格屬性最常用來協助可視化呈現數據格數據。

CELL PROPERTIES 關鍵詞語法

針對 MDX SELECT 語句的 CELL PROPERTIES 關鍵詞，請使用下列語法：

SELECT [<axis_specification>  
       [, <axis_specification>...]]  
  FROM [<cube_specification>]  
[WHERE [<slicer_specification>]]  
[<cell_props>]

下列語法顯示 <cell_props> 值的格式，以及此值如何使用 CELL PROPERTIES 關鍵詞以及一或多個內部單元格屬性：

<cell_props> ::= CELL PROPERTIES <property> [, <property>...]

支援的內建單元格屬性

下表列出 <property> 值中使用的支持內建單元格屬性。

財產	描述
ACTION_TYPE	位掩碼，指出儲存格上存在哪些動作類型。這個屬性可以有下列其中一個值： 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 注意：鑽研動作不包含在 where 子句中包含集合的查詢。
BACK_COLOR	顯示 VALUE 或 FORMATTED_VALUE 屬性的背景色彩。如需詳細資訊，請參閱 FORE_COLOR 和 BACK_COLOR 內容（MDX）。
CELL_ORDINAL	數據集中單元格的序號。
FONT_FLAGS	字型上的位掩碼詳細數據效果。值是下列一或多個常數之位 OR 運算的結果： MDFF_BOLD = 1 MDFF_ITALIC = 2 MDFF_UNDERLINE = 4 MDFF_STRIKEOUT = 8 例如，值 5 代表粗體（MDFF_BOLD）和底線（MDFF_UNDERLINE）字型效果的組合。
FONT_NAME	要用來顯示 VALUE 或 FORMATTED_VALUE 屬性的字型。
FONT_SIZE	用來顯示 VALUE 或 FORMATTED_VALUE 屬性的字型大小。
FORE_COLOR	顯示 VALUE 或 FORMATTED_VALUE 屬性的前景色彩。如需詳細資訊，請參閱 FORE_COLOR 和 BACK_COLOR 內容（MDX）。
FORMAT	與 FORMAT_STRING相同。
FORMAT_STRING	用來建立 FORMATTED_VALUE 屬性值的格式字串。如需詳細資訊，請參閱 FORMAT_STRING 內容（MDX）。
FORMATTED_VALUE	字元字串，表示 VALUE 屬性的格式化顯示。
LANGUAGE	將套用 FORMAT_STRING 的地區設定。 LANGUAGE 通常用於貨幣轉換。
UPDATEABLE	值，指出是否可以更新儲存格。這個屬性可以有下列其中一個值：
	MD_MASK_ENABLED （0x00000000）儲存格可以更新。
	MD_MASK_NOT_ENABLED （0x10000000）無法更新儲存格。
	CELL_UPDATE_ENABLED （0x00000001）儲存格可以在數據格集中更新。
	CELL_UPDATE_ENABLED_WITH_UPDATE （0x00000002）儲存格可以使用 update 語句來更新。如果分葉數據格更新未啟用寫入，更新可能會失敗。
	CELL_UPDATE_NOT_ENABLED_FORMULA （0x10000001）單元格無法更新，因為儲存格在其座標中具有匯出成員;在 where 子句中使用集合擷取單元格。即使公式影響或匯出單元格開啟，單元格的值也可以更新（位於匯總路徑的某處）。在此案例中，單元格的最終值可能不是更新的值，因為計算會影響結果
	CELL_UPDATE_NOT_ENABLED_NONSUM_MEASURE （0x10000002）無法更新儲存格，因為無法更新非總和量值（count、min、max、distinct count、semi-additive）。
	CELL_UPDATE_NOT_ENABLED_NACELL_VIRTUALCUBE （0x10000003）儲存格無法更新，因為儲存格不存在，因為它位於量值與量值群組無關的維度成員交集處。
	CELL_UPDATE_NOT_ENABLED_SECURE （0x10000005）無法更新儲存格，因為儲存格已受到保護。
	CELL_UPDATE_NOT_ENABLED_CALCLEVEL （0x10000006）保留供日後使用。
	CELL_UPDATE_NOT_ENABLED_CANNOTUPDATE （0x10000007）因為內部原因而無法更新儲存格。
	CELL_UPDATE_NOT_ENABLED_INVALIDDIMENSIONTYPE （0x10000009）無法更新數據格，因為採礦模型、間接或數據採礦維度不支援更新。
VALUE	單元格的未格式化值。

只需要 CELL_ORDINAL、FORMATTED_VALUE和 VALUE 單元格屬性。所有儲存格屬性內建或提供者特定，都會定義在架構資料列集 PROPERTIES，包括其數據類型和提供者支援。

根據預設，如果未使用 CELL PROPERTIES 關鍵詞，則傳回的儲存格屬性 VALUE、FORMATTED_VALUE和 CELL_ORDINAL （依該順序）。如果使用 CELL PROPERTIES 關鍵詞，只會傳回以關鍵詞明確陳述的單元格屬性。

下列範例示範在 MDX 查詢中使用 CELL PROPERTIES 關鍵詞：

SELECT  
   {[Measures].[Reseller Gross Profit]} ON COLUMNS,  
   {[Reseller].[Reseller Type].[Reseller Name].Members} ON ROWS  
FROM [Adventure Works]  
CELL PROPERTIES VALUE, FORMATTED_VALUE, FORMAT_STRING, FORE_COLOR, BACK_COLOR

針對傳回扁平化數據列集的 MDX 查詢，不會傳回單元格屬性;在此情況下，每個儲存格都會以只傳回 FORMATTED_VALUE 儲存格屬性的方式表示。

設定儲存格屬性

數據格屬性可以在各種位置Microsoft SQL Server SQL Server Analysis Services 中設定。例如，您可以在 SQL Server Data Tools 中 Cube 編輯器的 [Cube 結構] 索引標籤上，針對一般量值設定 Format String 屬性;您可以在 Cube 編輯器的 [計算] 索引標籤上，針對 Cube 上定義的匯出量值設定相同的屬性;查詢 WITH 子句中定義的匯出量值也會定義其格式字串。下列查詢示範如何在匯出量值上設定儲存格屬性：

WITH MEMBER MEASURES.CELLPROPERTYDEMO AS [Measures].[Internet Sales Amount]  
, FORE_COLOR=RGB(0,0,255)  
, BACK_COLOR=IIF([Measures].[Internet Sales Amount]>7000000, RGB(255,0,0), RGB(0,255,0))  
, FONT_SIZE=10  
, FORMAT_STRING='#,#.000'  
SELECT MEASURES.CELLPROPERTYDEMO ON 0,  
[Date].[Calendar Year].[Calendar Year].MEMBERS ON 1  
FROM [Adventure Works]  
CELL PROPERTIES VALUE, FORMATTED_VALUE, FORE_COLOR, BACK_COLOR, FONT_SIZE

另請參閱

MDX 查詢基本概念（Analysis Services）

共用方式為