Compartilhar via


Utilitário Profiler

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çãoObservaçã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çãoObservaçã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.

  • /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çãoObservaçã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)