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 |