Compartilhar via


Como: usar parâmetros em procedimentos armazenados e funções definidas pelo usuário

Os parâmetros permitem que você crie rotinas flexíveis SQL que usam os valores fornecidos em tempo de execução.Como os parâmetros podem ser alterados cada vez que o procedimento executa, você evita criar uma rotina SQL para cada valor que você deseja corresponder.

Por exemplo, em um banco de dados Microsoft SQL Server, você pode adicionar um parâmetro de @HireDate a um procedimento armazenado que procura a tabela de employee pelos funcionários cuja data de admissão corresponde a data que você especificar.Você pode então executar o procedimento armazenado cada vez que você deseja especificar uma data de admissão diferente.Ou você pode usar uma combinação de parâmetros para especificar um intervalo de datas.Por exemplo, você pode criar dois parâmetros — @BeginningDate e @EndingDate — na cláusula de where do procedimento armazenado, e então especifica um intervalo de datas de admissão em que você executar o procedimento.

Quando você usa parâmetros ou em procedimentos em funções definidas pelo usuário armazenada você pode:

  • Retornar um valor de status para outra rotina SQL para indicar sucesso ou falha e a razão para a falha.

  • Passe valores de parâmetro para outras funções ou procedimentos armazenados.

Um parâmetro leva o local de uma constante; não pode tomar o lugar de um nome de tabela, o nome da coluna, ou outro objeto de banco de dados.Em Gerenciador de Servidores, quando você executar um procedimento armazenado ou função definida pelo usuário que contêm parâmetros, você será solicitado para os valores de parâmetro.

ObservaçãoObservação

Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Configurações de Visual Studio.

para exibir parâmetros para um procedimento ou uma função definida pelo usuário armazenada

  • Em Gerenciador de Servidores, expanda o nome do procedimento ou função definida pelo usuário armazenada.

    Os parâmetros são listados abaixo do nome da rotina SQL.Em bancos de dados Microsoft SQL Server, cada nome do parâmetro começa com o caractere “@”.por exemplo, @percentage.

Para inserir valores de parâmetro para uma rotina SQL de execução

  1. executar o procedimento ou a função definida pelo usuário armazenada.

    Se a rotina SQL contém um ou mais parâmetros, a caixa de diálogo de Executar Procedimento Armazenado ou de Executar função é exibida.

  2. Para cada parâmetro, insira o valor a ser usada.Não se esqueça de fornecer um valor que corresponde ao tipo de dados do parâmetro.

  3. Quando você tiver terminado inserir valores de parâmetro, clique em OK.

Para mais informações e exemplos de como seu banco de dados funciona com parâmetros, consulte a documentação para o servidor de banco de dados.Se você estiver usando o Microsoft SQL Server, consulte “configurações” em SQL Server Books Online.

Consulte também

Outros recursos

Trabalhando com procedimentos armazenados e funções definidas pelo usuário