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 do SSMS abre o SQL Server Management Studio. Se especificado, Ssms também estabelecerá uma conexão com um servidor e abrirá 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 arquivos abrem uma janela do Editor de Consultas SQL no SQL Server Management Studio e os arquivos .mdx abrem uma janela do Editor de Consultas MDX no SQL Server Management Studio. Soluções e Projetos do SQL Server 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.
especifica uma solução a ser aberta. O parâmetro deve conter o caminho completo para o arquivo de solução.
[-Sservername] Nome do servidor
[-ddatabasename] 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
Active Directory – Universal com suporte de MFA não tem suporte no momento.
[-Unome de usuário] Nome de usuário ao se conectar à 'Autenticação SQL'
Nota
-P foi removido no SSMS versão 18.0.
Solução alternativa: tente se conectar ao servidor uma vez usando a interface do usuário e salve sua senha.
[-E] Conectar-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 por meio dos Serviços de Terminal em uma conexão com uma largura de banda limitada. Esse argumento não diferencia 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 nenhuma opção, ssms abrirá o SQL Server Management Studio, conforme especificado nas configurações opções do no menu ferramentas do. Por exemplo, se a página Ambiente/ Geral na opção de inicialização especificar Abrir nova janela de consulta, Ssms será aberta com um Editor de Consultas em branco.
A opção -log deve aparecer no final da linha de comando, depois de todas as outras opções. 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, devido ao acesso de gravação insuficiente, o log será gravado no local APPDATA não localizado (consulte abaixo). Se o argumento nome do arquivo 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 está disponível na variável de ambiente APPDATA. Por exemplo, para o SQL Server 2012, a pasta é <unidade do sistema>:\Users\<nome de usuário>\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: Clique em Iniciar e, em seguida, clique em Executar...", digite "<unidade do sistema>:\Users\<nome de usuário>\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 arquivos abrem uma janela do Editor de Consultas SQL no SQL Server Management Studio e os arquivos .mdx abrem uma janela do Editor de Consultas MDX no SQL Server Management Studio. As soluções e projetos do SQL Server abrem 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
Os scripts a seguir abrem o SQL Server Management Studio de um prompt de comando usando Active Directory –Integrado:
Ssms.exe -S servername.database.windows.net -G
O script a seguir abre o SQL Server Management Studio de um prompt de comando, com a Autenticação do Windows, com o Editor de Código configurado para se conectar ao servidor ACCTG e ao banco de dados AdventureWorks2022, 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"