Utilitário Profiler

Artigo
08/01/2012

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 é planejado para rastreamentos de script. Para obter mais informações, consulte 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 de argumentos profiler.
/U login_id
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 password
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 sql_server_name
Especifica uma instância do SQL Server. O Profiler irá se conectar automaticamente ao servidor especificado usando as informações de autenticação especificadas nas opções /U e /Pou na opção /E. Para conectar-se a uma instância nomeada do SQL Server, use /S sql_server_name\instance_name.
/A analysis_services_server_name
Especifica uma instância do Analysis Services. O Profiler irá se conectar automaticamente ao servidor especificado usando as informações de autenticação especificadas nas opções /U e /Pou na opção /E. Para conectar-se a uma instância nomeada do SQL Server, use /A analysis_services_server_name\instance_name.
/D database
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 " trace_table_name "
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" template_name "
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" filename "
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 " filename "
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 locale_ID
Não disponível.

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

/M " MM-DD-YY 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 file_size
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

Conceitos

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

Partilhar via