Utilitário Profiler

Aplica-se a: SQL Server

O utilitário profiler inicia a ferramenta SQL Server Profiler . Os argumentos opcionais listados posteriormente neste tópico permitem controlar como o aplicativo é iniciado.

Observação

O utilitário profiler não foi criado para ser usado para rastreamentos de script. Para saber mais, confira SQL Server Profiler.

Sintaxe

  
profiler  
    [ /? ] |  
[  
{  
{ /U login_id [ /P password ] }  
| /E  
}  
{[ /S sql_server_name ] | [ /A analysis_services_server_name ] }  
[ /D database ]  
[ /T "template_name" ]  
[ /B { "trace_table_name" } ]  
{ [/F "filename" ] | [ /O "filename" ] }  
[ /L locale_ID ]  
[ /M "MM-DD-YY hh:mm:ss" ]  
[ /R ]  
[ /Z file_size ]  
]  

Argumentos

/?
Exibe o resumo da sintaxe dos argumentos de profiler .

/U id_de_login
ID de logon do usuário para autenticação do SQL Server . IDs de logon diferenciam maiúsculas de minúsculas.

Observação

Quando possível, use a autenticação do Windows..

/P senha
Especifica uma senha especificada pelo usuário para a autenticação do SQL Server .

/E
Especifica a conexão com a autenticação do Windows com as credenciais do usuário atual.

/S nome_servidor_sql
Especifica uma instância do SQL Server. O Profiler vai se conectar automaticamente ao servidor especificado usando as informações de autenticação especificadas nas opções /U e /P ou na opção /E . Para se conectar a uma instância nomeada do SQL Server, use /S nome_do_servidor_sql\nome_da_instância.

/A nome_do_servidor_de_analysis_services
Especifica uma instância do Analysis Services. O Profiler vai se conectar automaticamente ao servidor especificado usando as informações de autenticação especificadas nas opções /U e /P ou na opção /E . Para se conectar a uma instância nomeada do SQL Server, use /A nome_do_servidor_do_analysis_services\nome_da_instância.

/D banco_de_dados
Especifica o nome do banco de dados a ser usado com a conexão. Essa opção selecionará o banco de dados padrão para o usuário especificado se nenhum banco de dados for especificado.

/B " nome_da_tabela_de_rastreamento "
Especifica uma tabela de rastreamento a ser carregada quando o profiler for iniciado. Você deve especificar o banco de dados, o usuário ou esquema e a tabela.

/T " nome_do_modelo "
Especifica o modelo que será carregado para configurar o rastreamento. O nome do modelo deve estar entre aspas. O nome do modelo deve estar no diretório de modelos de sistema ou no diretório de modelos de usuário. Se existirem dois modelos com mesmo nome em ambos os diretórios, o modelo do diretório do sistema será carregado. Se nenhum modelo com o nome especificado existir, o modelo padrão será carregado. Observe que a extensão de arquivo do modelo (.tdf) não deve ser especificada como parte do template_name. Por exemplo:

/T "standard"  

/F" nome_do_arquivo "
Especifica o caminho e o nome de um arquivo de rastreamento a ser carregado quando o profiler for iniciado. O caminho e o nome de arquivo completos devem estar entre aspas. Essa opção não pode ser usada com /O.

/O " nome_do_arquivo "
Especifica o caminho e o nome de um arquivo no qual devem ser gravados os resultados de rastreamento. O caminho e o nome de arquivo completos devem estar entre aspas. Essa opção não pode ser usada com /F.

/L ID_do_local
Não disponível.

/M " MM-DD-AA hh:mm:ss "
Especifica a data e a hora para o rastreamento parar. A hora de parada deve estar entre aspas. Especifique a hora de parada de acordo com os parâmetros na tabela abaixo:

Parâmetro	Definição
MM	Mês de dois dígitos
DD	Dia de dois dígitos
YY	Ano de dois dígitos
hh	Hora de dois dígitos em um relógio de 24 horas
MM	Minuto de dois dígitos
ss	Segundo de dois dígitos

Observação

O formato “MM-DD-AA hh:mm:ss” só poderá ser usado se a opção Usar configurações regionais para exibir valores de data e hora estiver habilitada no SQL Server Profiler. Se essa opção não estiver habilitada, você deverá usar o formato de data e hora "AAAA-MM-DD hh:mm:ss".

/R
Habilita a substituição do arquivo de rastreamento.

/Z tamanho_do_arquivo
Especifica o tamanho do arquivo de rastreamento em megabytes (MB). O tamanho padrão é 5 MB. Se a substituição estiver habilitada, todos os arquivos de substituição serão limitados ao valor especificado neste argumento.

Comentários

Para iniciar um rastreamento com um modelo específico, use as opções /S e /T juntas. Por exemplo, para iniciar um rastreamento usando o modelo Padrão em MyServer\MyInstance, digite o seguinte no prompt de comando:

profiler /S MyServer\MyInstance /T "Standard"  

Consulte Também

Referência de utilitários de prompt de comando (Mecanismo de Banco de Dados)