共用方式為

DISCOVER_CSDL_METADATA 資料列集

  • 發行項

傳回表格式資料模型的資訊，包括使用概念結構描述定義語言 (CSDL) 的模型定義。 CSDL 是實體資料架構所使用的 XML 結構描述，用於 Analysis Services 伺服器與 Power View 用戶端之間的通訊。 如需有關表格式資料模型的詳細資訊，請參閱＜表格式模型的 CSDL 延伸模組簡介＞。

命令的安全性內容會影響傳回的資料列集。 若要從伺服器取得 CSDL 定義，需要 Analysis Services 執行個體的讀取權限。

發出資料列集要求之用戶端的語言識別碼包含在命令的連接字串中，而且會影響傳回為資料列集一部分之數個屬性中顯示的語言。 如需有關可能受到語言識別碼影響之屬性和描述的詳細資訊，請參閱＜備註＞一節。

**適用於：**表格式模型

資料列集資料行

DISCOVER_CSDL_METADATA 資料列集包含下列資料行。

資料行名稱

類型指標

限制

說明

CATALOG_NAME

DBTYPE_WSTR

是

指定要求其 CSDL 描述之資料庫的名稱。 如果省略，就會使用目前的資料庫。

DISCOVER_CSDL_METADATA 資料列集必須使用此資料行加以限制。

PERSPECTIVE_NAME

DBTYPE_WSTR

是

指定已在 CATALOG_NAME 指定的模型上定義之檢視方塊的名稱。

DISCOVER_CSDL_METADATA 資料列集可以選擇性地使用此資料行加以限制。

包含一個以上 Cube 或檢視方塊之多維度資料庫上的 CSDL 查詢需要這項限制。 SQL Server 2012 SP1 中已經引進這項功能。

METADATA

DBTYPE_WSTR

根據 CSDL 結構描述，包含資料來源及其屬性之 XML 定義的字串。

備註

DISCOVER_CSDL_METADATA 具有下列需求：

  • 如果未使用 CATALOG_NAME 限制指定資料庫，DISCOVER 要求將會失敗。

  • 如果檢視方塊當做限制提供，系統會針對模型傳回相同的 CSDL 資料列集。 但是，位於模型中但不包含在指定的檢視方塊中的所有物件會標示為 Hidden = True。

  • 對於資料表和資料行，DISCOVER 資料列集一律從 Cube 維度輸出值。 如果未設定 Cube 維度屬性，要求會從維度傳回值。

  • DISCOVER 要求無法傳回包含語意錯誤的任何量值或導出資料行。

  • 對於沒有屬性值的物件，DISCOVER 要求將不會傳回任何資訊。 對於使用預設值的屬性，DISCOVER 要求也不會傳回任何值。

在資料列集中傳回的 XML 字串可能包含下列語言專屬的屬性或值。 例如，如果您從用戶端發出 LCID 為 0403 (卡達隆尼亞文西班牙文) 的資料列集要求，屬性將會傳回下列值 (如果適合卡達隆尼亞文西班牙文)。 如果伺服器上沒有翻譯，就會傳回伺服器預設語言的字串。

  • 標題

  • 限定詞

  • SortDirection

  • IsRightToLeft

範例

下列 XMLA 查詢會傳回目前連接上之 Model 資料庫的 CSDL 表示。

<Discover xmlns="urn:schemas-microsoft-com:xml-analysis">
<RequestType>DISCOVER_CSDL_METADATA</RequestType>
    <Restrictions>
<RestrictionList>
<CATALOG_NAME>Model</CATALOG_NAME>
</RestrictionList>
</Restrictions>
    <Properties>
<PropertyList>
                 <FORMAT>Tabular</FORMAT>
   </PropertyList>
</Properties>
</Discover>

使用 ADOMD.NET 傳回資料列集

使用 ADOMD.NET 和結構描述資料列集來擷取中繼資料時，您可以使用 GUID 或字串，在 GetSchemaDataSet 方法中參考結構描述資料列集物件。 如需詳細資訊，請參閱＜使用 ADOMD.NET 中的結構描述資料列集＞。

下表將提供可識別此資料列集的 GUID 和字串值。

引數

值

GUID

87B86062-21C3-460F-B4F8-5BE98394F13B

ADOMDNAME

Csdl

請參閱

參考

Analysis Services 結構描述資料列集

概念

表格式模型的 CSDL 延伸模組簡介