共用方式為

  • 發行項

查詢運算式和唯一的資源名稱

SQL Server 管理物件 (SMO) 模型和 SQL Server PowerShell 嵌入式管理單元會使用與 XPath 運算式類似的兩種運算式字串類型。查詢運算式是字串，其中指定一組用來列舉物件模型階層中之一或多個物件的準則。唯一的資源名稱 (URN) 是可唯一識別單一物件的特定查詢運算式字串類型。

語法

Object1[<FilterExpression1>]/ ... /ObjecN[<FilterExpressionN>]

<FilterExpression>::=
<PropertyExpression> [and <PropertyExpression>][...n]

<PropertyExpression>::=
      @BooleanPropertyName=true()
 | @BooleanPropertyName=false()
 | contains(@StringPropertyName, 'PatternString')
  | @StringPropertyName='String'
 | @DatePropertyName=datetime('DateString')
 | is_null(@PropertyName)
 | not(<PropertyExpression>)

引數

  • Object
    指定運算式字串之該節點所代表的物件類型。每個物件都代表這些 SMO 物件模型命名空間的集合類別：

    Microsoft.SqlServer.Management.Smo

    Microsoft.SqlServer.Management.Smo.Agent

    Microsoft.SqlServer.Management.Smo.Broker

    Microsoft.SqlServer.Management.Smo.Mail

    Microsoft.SqlServer.Management.Dmf

    Microsoft.SqlServer.Management.Facets

    Microsoft.SqlServer.Management.RegisteredServers

    Microsoft.SqlServer.Management.Smo.RegSvrEnum

    例如，您可以指定 Server 來代表 ServerCollection 類別，或指定 Database 來代表 DatabaseCollection 類別。

  • @PropertyName
    指定與 Object 中指定之物件相關聯的類別的其中一個屬性名稱。屬性的名稱必須以 @ 字元當做前置詞。例如，您可以指定 @IsAnsiNull 來代表 Database 類別屬性 IsAnsiNull。

  • @BooleanPropertyName=true()
    列舉指定之布林屬性設定為 TRUE 的所有物件。

  • @BooleanPropertyName=false()
    列舉指定之布林屬性設定為 FALSE 的所有物件。

  • contains(@StringPropertyName, 'PatternString')
    列舉指定之字串屬性至少包含一個 'PatternString' 中指定之字元集的所有物件。

  • @StringPropertyName='PatternString'
    列舉指定之字串屬性值與 'PatternString' 中指定之字元模式完全相同的所有物件。

  • @DatePropertyName= datetime('DateString')
    列舉指定之日期屬性值與 'DateString' 中指定之日期相符所有物件。DateString 必須遵循格式 yyyy-mm-dd hh:mi:ss.mmm。

    yyyy

    四位數的年份。

    mm

    兩位數的月份 (01 到 12)。

    dd

    兩位數的日期 (01 到 31)。

    hh

    兩位數的小時，使用 24 小時制 (01 到 23)。

    mi

    兩位數的分鐘 (01 到 59)。

    ss

    兩位數的秒鐘 (01 到 59)。

    mmm

    毫秒數 (001 到 999)。

    您可以針對儲存在 SQL Server 中的任何日期格式評估使用這種格式所指定的日期。

  • is_null(@PropertyName)
    列舉指定之屬性具有 NULL 值的所有物件。

  • not(<PropertyExpression>)
    執行 PropertyExpression 評估值的否定運算，並且列舉不符合 PropertyExpression 中指定之條件的所有物件。例如，not(contains(@Name, 'xyz')) 會列舉名稱中沒有 xyz 字串的所有物件。

備註

查詢運算式是列舉 SMO 模型階層中之節點的字串。每個節點都具有指定準則的篩選運算式，用於決定要列舉位於該節點的哪些物件。查詢運算式是以 XPath 運算式語言建立模型。查詢運算式會實作 XPath 所支援之運算式的小型子集，而且也具有在 XPath 中找不到的某些延伸模組。XPath 運算式是字串，其中指定一組用來列舉 XML 文件之一或多個標記的準則。如需有關 XPath 的詳細資訊，請參閱 W3C。

查詢運算式必須以伺服器物件的絕對參考為開頭。不允許使用含有前置 / 的相對運算式。在查詢運算式中指定之物件的順序必須遵循相關聯物件模型中之集合物件的階層。例如，在 Microsoft.SqlServer.Management.Smo 命名空間中參考物件的查詢運算式必須以伺服器節點為開頭，後面接著資料庫節點等項目。

如果沒有針對物件指定 <FilterExpression>，就會列舉位於該節點的所有物件。

唯一的資源名稱 (URN)

URN 是查詢運算式的子集。每個 URN 都會構成單一物件的完整參考。一般的 URN 會使用 Name 屬性來識別位於每個節點的單一物件。例如，這個 URN 會參考特定資料行：

Server[@Name='MYCOMPUTER']/Database[@Name='AdventureWorks']/Table[@Name='SalesPerson' and @Schema='Sales']/Column[@Name='SalesPersonID']

範例

A. 使用 false() 來列舉物件

這個查詢運算式會列舉在 MyComputer 的預設執行個體中將 AutoClose 屬性設定為 false 的所有資料庫。

Server[@Name='MYCOMPUTER']/Database[@AutoClose=false()]

B. 使用 contains 來列舉物件

這個查詢運算式會列舉不區分大小寫而且名稱具有 'm' 字元的所有資料庫。

Server[@Name='MYCOMPUTER']/Database[@CaseSensitive=false() and contains(@Name, 'm')]

C. 使用 not 來列舉物件

這個查詢運算式會列舉不在 Production 結構描述中而且資料表名稱包含 History 一詞的所有 AdventureWorks 資料表：

Server[@Name='MYCOMPUTER']/Database[@Name='AdventureWorks']/Table[not(@Schema='Production') and contains(@Name, 'History')]

D. 不針對最終節點提供篩選運算式

這個查詢運算式會列舉 AdventureWorks.Sales.SalesPerson 資料表中的所有資料行：

Server[@Name='MYCOMPUTER']/Database[@Name='AdventureWorks"]/Table[@Schema='Sales' and @Name='SalesPerson']/Columns

E. 使用 datetime 來列舉物件

這個查詢運算式會列舉於特定時間在 AdventureWorks 資料庫中建立的所有資料表：

Server[@Name='MYCOMPUTER']/Database[@Name='AdventureWorks"]/Table[@CreateDate=datetime('2008-03-21 19:49:32.647')]

F. 使用 is_null 來列舉物件

這個查詢運算式會列舉 AdventureWorks 資料庫中上次修改日期屬性沒有 NULL 的所有資料表：

Server[@Name='MYCOMPUTER']/Database[@Name='AdventureWorks"]/Table[Not(is_null(@DateLastModified))]