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

發行項
05/23/2023

適用於：SQL Server Azure SQL Database Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW)

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

注意

有兩個 SQL Server PowerShell 模組：SqlServer 和 SQLPS。

SqlServer 模組是要使用的最新 PowerShell 模組。

SQLPS 模組隨附於 SQL Server 安裝 (用於回溯相容性)，但不再更新。

SqlServer 模組包含 SQLPS 中 Cmdlet 的更新版本，且加入新的 Cmdlet 以支援 SQL 最新功能。

從 PowerShell 資源庫安裝 SqlServer 模組。

如需詳細資訊，請參閱 SQL Server PowerShell。

語法

  
Object1[<FilterExpression1>]/ ... /ObjectN[<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 格式。

DateString 元件	描述
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 XPath Language(W3C XPath 語言)。

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

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

統一資源名稱 (URN)

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

Server[@Name='MYCOMPUTER']/Database[@Name='AdventureWorks2022']/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 列舉物件

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

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

D. 不會為最終節點提供篩選運算式

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

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

E. 使用日期時間列舉物件

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

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

F. 使用 is_null 列舉物件

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

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