Utilitário SSMS

aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsAnalytics Platform System (PDW)

O utilitário ssms abre o SQL Server Management Studio. Se especificado, o ssms também estabelece uma conexão com um servidor e abre consultas, scripts, arquivos, projetos e soluções.

Você pode especificar arquivos que contêm consultas, projetos ou soluções. Os arquivos que contêm consultas são conectados automaticamente a um servidor se as informações de conexão forem fornecidas e o tipo de arquivo estiver associado a esse tipo de servidor. Por exemplo, .sql os arquivos abrem uma janela do Editor de Consultas SQL no SQL Server Management Studio e .mdx os arquivos abrem uma janela do Editor de Consultas MDX no SQL Server Management Studio. Soluções e projetos do SQL Server são abertos no SQL Server Management Studio.

Nota

O utilitário SSMS não executa consultas. Para executar consultas na linha de comando, use o utilitário sqlcmd.

Sintaxe

ssms
[ scriptfile ] [ projectfile ] [ solutionfile ]
[ -S servername ] [ -d databasename ] [ -G ] [ -U username ] [ -E ] [ -nosplash ] [ -log [ filename ] ? ] [ -? ]

Argumentos

scriptfile

Especifica um ou mais arquivos de script a serem abertos. O parâmetro deve conter o caminho completo para os arquivos.

projectfile

Especifica um projeto de script a ser aberto. O parâmetro deve conter o caminho completo para o arquivo de projeto de script.

arquivo de solução

Especifica uma solução a ser aberta. O parâmetro deve conter o caminho completo para o arquivo de solução.

[ -S nome do servidor ]

Nome do servidor

[ -d nome do banco de dados ]

Nome do banco de dados

[ -G ]

Conecte-se usando a autenticação do Active Directory. O tipo de conexão é determinado se -U está incluído.

Nota

No momento, não há suporte para o Active Directory – Universal com suporte de MFA.

[ -U nome de usuário ]

Nome de usuário ao se conectar à Autenticação SQL.

Nota

-P foi removido no SSMS versão 18.0. Tente se conectar ao servidor uma vez usando a interface do usuário e salve sua senha.

[ -E ]

Conecte-se usando a Autenticação do Windows.

[ -nosplash ]

Impede que o SQL Server Management Studio exiba o elemento gráfico de tela inicial durante a abertura. Use essa opção ao se conectar ao computador que executa o SQL Server Management Studio nos Serviços de Terminal, em uma conexão com uma largura de banda limitada. Este argumento não distingue maiúsculas de minúsculas e pode aparecer antes ou depois de outros argumentos

[ -log* [ nome do arquivo ] ?* ]

Registra a atividade do SQL Server Management Studio no arquivo especificado para solução de problemas

[ -? ]

Exibe a ajuda da linha de comando

Observações

Todas as opções são opcionais e separadas por um espaço, exceto arquivos, que são separados por vírgulas. Se você não especificar nenhum parâmetro, o ssms abrirá o SQL Server Management Studio conforme as configurações especificadas no menu Ferramentas em Opções. Por exemplo, se a página Ambiente/Geral na opção de inicialização especificar Abrir nova janela de consulta, o ssms será aberto com um Editor de Consultas em branco.

O -log comutador deve aparecer no final da linha de comando, após todos os outros comutadores. O argumento filename é opcional. Se um nome de arquivo for especificado e o arquivo não existir, o arquivo será criado. Se o arquivo não puder ser criado – por exemplo, por causa de acesso de gravação insuficiente, o log será gravado no local não localizável APPDATA (consulte o exemplo a seguir). Se o argumento filename não for especificado, dois arquivos serão gravados na pasta de dados do aplicativo não localizado do usuário atual.

A pasta de dados de aplicativo não localizada para SQL Server pode ser encontrada na APPDATA variável de ambiente. Por exemplo, para o SQL Server 2012, a pasta é <system drive>:\Users\<username\>\AppData\Roaming\Microsoft\AppEnv\10.0\. Os dois arquivos são, por padrão, nomeados ActivityLog.xml e ActivityLog.xsl. O primeiro contém os dados do log de atividades e este último é uma folha de estilos XML, que fornece uma maneira mais conveniente de exibir o arquivo XML.

Use as etapas a seguir para exibir o arquivo de log no visualizador XML padrão, como o Internet Explorer: Selecione Iniciar, selecione Executar..., digite <system drive>:\Users\<username\>\AppData\Roaming\Microsoft\AppEnv\10.0\ActivityLog.xml no campo fornecido e pressione Enter.

Arquivos que contêm consultas solicitam que sejam conectados a um servidor se as informações de conexão forem fornecidas e o tipo de arquivo estiver associado a esse tipo de servidor. Por exemplo, .sql os arquivos abrem uma janela do Editor de Consultas SQL no SQL Server Management Studio e .mdx os arquivos abrem uma janela do Editor de Consultas MDX no SQL Server Management Studio. Soluções e projetos do SQL Server são abertos no SQL Server Management Studio.

A tabela a seguir mapeia os tipos de servidor para extensões de arquivo.

Tipo de servidor	Extensão
SQL Server	.sql
SQL Server Analysis Services	.mdx, .xmla

Exemplos

O script a seguir abre o SQL Server Management Studio de um prompt de comando com as configurações padrão:

ssms

O script a seguir abre o SQL Server Management Studio de um prompt de comando usando o Active Directory – Integrado:

ssms.exe -S servername.database.windows.net -G

O script a seguir abre o SQL Server Management Studio com um prompt de comando, com a Autenticação do Windows, com o Editor de Código definido como o servidor ACCTG e o banco de dados AdventureWorks2025, sem mostrar a tela inicial:

ssms -E -S ACCTG -d AdventureWorks2022 -nosplash

O script a seguir abre o SQL Server Management Studio de um prompt de comando e abre o script MonthEndQuery.

ssms "C:\Documents and Settings\username\My Documents\SQL Server Management Studio Projects\FinanceScripts\FinanceScripts\MonthEndQuery.sql"

O script a seguir abre o SQL Server Management Studio de um prompt de comando e abre o projeto NewReportsProject no computador chamado developer:

ssms "\\developer\fin\ReportProj\ReportProj\NewReportProj.ssmssqlproj"

O script a seguir abre o SQL Server Management Studio de um prompt de comando e abre a solução MonthlyReports:

ssms "C:\solutionsfolder\ReportProj\MonthlyReports.ssmssln"

Conteúdo relacionado

• O que é o SSMS (SQL Server Management Studio)?