Identificadores do SQL Server no PowerShell

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)

O provedor SQL Server para Windows PowerShell usa identificadores SQL Server em caminhos do Windows PowerShell. SQL Server Identificadores podem conter caracteres sem suporte pelo Windows PowerShell em caminhos. É necessário substituir esses caracteres ou usar codificação especial quando usar os identificadores em caminhos do Windows PowerShell.

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.

Identificadores do SQL Server em caminhos do Windows PowerShell

Os provedores Windows PowerShell expõem as hierarquias de dados usando uma estrutura de caminho semelhante ao sistema de arquivos do Windows. O provedor do SQL Server Windows PowerShell implementa caminhos para objetos do SQL Server . No Mecanismo de Banco de Dados, a unidade é definida como SQLSERVER:, a primeira pasta é definida como \SQL e os objetos de banco de dados são considerados como contêineres e itens. Este é o caminho para a tabela Vendor no esquema Purchasing do banco de dados AdventureWorks2022 na instância padrão do Mecanismo de Banco de Dados:

SQLSERVER:\SQL\MyComputer\DEFAULT\Databases\AdventureWorks2022\Tables\Purchasing.Vendor  

SQL Server Os identificadores são os nomes de objetos do SQL Server , como nomes de tabela ou coluna. Existem dois tipos de identificadores do SQL Server :

  • Os identificadores regulares estão limitados a um conjunto de caracteres que também são suportados em caminhos do Windows PowerShell. Esses nomes podem ser usados em caminhos do Windows PowerShell sem a necessidade de alterá-los.

  • Os identificadores delimitados podem usar caracteres que não são suportados em nomes de caminho do Windows PowerShell. Identificadores delimitados são chamados de identificadores entre colchetes quando estão entre colchetes, como ([IdentifierName]), e identificadores entre aspas quando estão entre aspas, como ("IdentifierName"). Se um identificador delimitado usa caracteres que não são suportados em caminhos do Windows PowerShell, os caracteres devem ser codificados ou substituídos antes de usar o identificador como um contêiner ou nome de item. A codificação aceita todos os caracteres. Alguns caracteres, como o caractere de dois-pontos (:), não pode ser substituído.

Identificadores do SQL Server em cmdlets

Alguns cmdlets do SQL Server contêm um parâmetro que usa um identificador como entrada. Normalmente, os valores de parâmetro são fornecidos como constantes de cadeia de caracteres entre aspas ou em variáveis da cadeia de caracteres. Quando os identificadores são fornecidos como constantes de cadeia de caracteres ou em variáveis, não há conflitos com o conjunto de caracteres suportado pelo Windows PowerShell.

Tarefas do identificador do SQL Server

Descrição da tarefa Artigo
Descreve como especificar um nome de instância, inclusive o nome do computador no qual a instância está sendo executada. Especificar instâncias no provedor do SQL Server PowerShell
Descreve como especificar a codificação hexadecimal para caracteres em identificadores delimitados sem suporte em caminhos do Windows PowerShell. Também descreve como decodificar os caracteres hexadecimais. Codificar e decodificar identificadores do SQL Server
Descreve como usar o caractere de escape do Windows PowerShell para caracteres sem suporte em caminhos do PowerShell. Escapar identificadores do SQL Server

Consulte Também