Expressões de consultas e nomes de recursos uniformes
Aplica-se a:
SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)
Os modelos SMO ( SQL Server Management Object) e os snap-ins do SQL Server PowerShell utilizam dois tipos de cadeia de caracteres de expressão semelhantes às expressões XPath. As expressões de consulta são cadeias de caracteres que especificam um conjunto de critérios para enumerar um ou mais objetos em uma hierarquia de modelo de objetos. Um URN (Uniform Resource Name) é um tipo específico de cadeia de caracteres de expressão de consulta que identifica exclusivamente um único objeto.
Observação
Há dois módulos do SQL Server PowerShell; SqlServer e SQLPS.
O módulo SqlServer é o módulo atual do PowerShell a ser usado.
O módulo SQLPS está incluído na instalação do SQL Server (para compatibilidade com versões anteriores), mas não está mais sendo atualizado.
O módulo do SqlServer contém versões atualizadas dos cmdlets no SQLPS e inclui novos cmdlets para dar suporte aos recursos mais recentes do SQL.
Instale o módulo SqlServer da Galeria do PowerShell.
Para obter mais informações, confira SQL Server PowerShell.
Sintaxe
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>)
Argumentos
Objeto
Especifica o tipo de objeto que é representado no nó da cadeia de caracteres de expressão. Cada objeto representa uma classe de coleção desses namespaces de modelos de objetos 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
Por exemplo, especifique o Servidor para a classe ServerCollection , o Banco de dados para a classe DatabaseCollection .
@PropertyName
Especifica o nome de uma das propriedades da classe associada ao objeto especificado em Objeto. O nome da propriedade deve ser prefixado com o caractere @. Por exemplo, especifique @ IsAnsiNull para a propriedade da classe DatabaseIsAnsiNull.
@BooleanPropertyName=true()
Enumera todos os objetos em que a propriedade booliana especificada está definida como TRUE.
@BooleanPropertyName=false()
Enumera todos os objetos em que a propriedade booliana especificada está definida como FALSE.
contains(@StringPropertyName, 'PatternString')
Enumera todos os objetos em que a propriedade da cadeia de caracteres especificada contém pelo menos uma ocorrência do conjunto de caracteres especificado em “PatternString”.
@StringPropertyName='PatternString'
Enumera todos os objetos em que o valor da propriedade da cadeia de caracteres especificada é exatamente igual ao padrão de caractere especificado em “PatternString”.
@DatePropertyName= datetime('DateString')
Enumera todos os objetos em que o valor da propriedade de data especificada corresponde à data especificada em “DateString”. DateString deve seguir o formato aaaa-mm-dd hh:min:ss.mmm.
| Componente DateString | Descrição |
|---|---|
| yyyy | Ano com quatro dígitos. |
| MM | Mês com dois dígitos (01 a 12). |
| dd | Dia com dois dígitos (01 a 31). |
| hh | Hora com dois dígitos usando o formato de 24 horas (01 a 23). |
| min | Minutos com dois dígitos (01 a 59). |
| ss | Segundos com dois dígitos (01 a 59). |
| mmm | Número de milissegundos (001 a 999). |
As datas especificadas nesse formato podem ser avaliadas em relação a qualquer formato de data armazenado no SQL Server.
is_null(@PropertyName)
Enumera todos os objetos em que a propriedade especificada tenha um valor NULL.
not(<PropertyExpression>)
Nega o valor de avaliação de PropertyExpression, enumerando todos os objetos que não correspondem à condição especificada em PropertyExpression. Por exemplo, not(contains(@Name, 'xyz')) enumera todos os objetos que não têm a cadeia de caracteres xyz em seus nomes.
Comentários
Expressões de consulta são cadeias de caracteres que enumeram os nós em uma hierarquia de modelos SMO. Cada nó tem uma expressão de filtro que especifica os critérios de determinação dos objetos desse nó que são enumerados. As expressões de consultas são modeladas na linguagem de expressão XPath. As expressões de consulta implementam um pequeno subconjunto de expressões com suporte em XPath e também possuem algumas expressões que não são encontradas em XPath. As expressões Xpath são cadeias de caracteres que especificam um conjunto de critérios usados para enumerar uma ou mais marcas em um documento XML. Para obter mais informações sobre XPath, consulte W3C XPath Language.
As expressões de consulta devem iniciar com uma referência absoluta ao objeto Servidor. Não são permitidas expressões relativas com uma / à esquerda. A sequência de objetos especificados em uma expressão de consulta deve seguir a hierarquia dos objetos de coleção do modelo de objetos associado. Por exemplo, uma expressão de consulta que faz referência a objetos no namespace Microsoft.SqlServer.Management.Smo deve começar com um nó Servidor, seguido por um nó Banco de Dados e assim por diante.
Se uma <FilterExpression> não for especificada para um objeto, todos os objetos desse nó serão enumerados.
URN (Uniform Resource Names)
URNs são um subconjunto de expressões de consulta. Cada URN forma uma referência totalmente qualificada a um único objeto. Um URN típico usa a propriedade Nome para identificar um único objeto em cada nó. Por exemplo, este URN faz referência a uma coluna específica:
Server[@Name='MYCOMPUTER']/Database[@Name='AdventureWorks2022']/Table[@Name='SalesPerson' and @Schema='Sales']/Column[@Name='SalesPersonID']
Exemplos
a. Enumerando objetos usando false()
Esta expressão de consulta enumera todos os bancos de dados que têm o atributo AutoClose definido como false na instância padrão em MyComputer.
Server[@Name='MYCOMPUTER']/Database[@AutoClose=false()]
B. Enumerando objetos usando contains
Esta expressão de consulta enumera todos os bancos de dados que não diferenciam maiúsculas de minúsculas e têm o caractere 'm' no nome.
Server[@Name='MYCOMPUTER']/Database[@CaseSensitive=false() and contains(@Name, 'm')]
C. Enumerando objetos usando not
Esta expressão de consulta enumera todas as tabelas AdventureWorks2022 que não estão no esquema de Produção e que contêm a palavra Histórico no nome da tabela:
Server[@Name='MYCOMPUTER']/Database[@Name='AdventureWorks2022']/Table[not(@Schema='Production') and contains(@Name, 'History')]
D. Não fornecendo uma expressão de filtro para o nó final
Esta expressão de consulta enumera todas as colunas na tabela AdventureWorks2022.Sales.SalesPerson:
Server[@Name='MYCOMPUTER']/Database[@Name='AdventureWorks2022"]/Table[@Schema='Sales' and @Name='SalesPerson']/Columns
E. Enumerando objetos usando datetime
Esta expressão de consulta enumera todas as tabelas que são criadas no banco de dados AdventureWorks2022 em um momento específico:
Server[@Name='MYCOMPUTER']/Database[@Name='AdventureWorks2022"]/Table[@CreateDate=datetime('2008-03-21 19:49:32.647')]
F. Enumerando objetos usando is_null
Esta expressão de consulta enumera todas as tabelas do banco de dados AdventureWorks2022 que não têm o NULL para a última propriedade modificada:
Server[@Name='MYCOMPUTER']/Database[@Name='AdventureWorks2022"]/Table[Not(is_null(@DateLastModified))]
Consulte Também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de