{"id":30516,"date":"2024-03-05T07:13:42","date_gmt":"2024-03-05T06:13:42","guid":{"rendered":"https:\/\/expert-only.com\/?p=30516"},"modified":"2024-03-06T16:19:35","modified_gmt":"2024-03-06T15:19:35","slug":"sql-server-executar-um-procedimento-armazenado-com-parametros","status":"publish","type":"post","link":"https:\/\/expert-only.com\/pt-pt\/t-sql\/sql-server-executar-um-procedimento-armazenado-com-parametros\/","title":{"rendered":"SQL Server – Executar um Procedimento Armazenado com Par\u00e2metros"},"content":{"rendered":"\n

Tutorial com exemplos de c\u00f3digo T-SQL para executar uma stored procedure no SQL Server com um ou v\u00e1rios par\u00e2metros de entrada.<\/em><\/h4>\n\n\n\n

Dependendo do c\u00f3digo SQL Server, para executar procedimento armazenado com par\u00e2metros devem ser fornecidos valores obrigat\u00f3rios ou ser\u00e3o usados valores padr\u00e3o. Primeiro, deve-se definir o valor NULL no c\u00f3digo da procedure. Isso acontece porque criamos os par\u00e2metros de forma obrigat\u00f3ria ou n\u00e3o obrigat\u00f3ria. Para par\u00e2metros opcionais, podemos atribuir um valor padr\u00e3o na declara\u00e7\u00e3o de cria\u00e7\u00e3o da procedure no SQL. Assim, par\u00e2metros opcionais n\u00e3o impedem a execu\u00e7\u00e3o da procedure e a obten\u00e7\u00e3o de um feedback potencial no SSMS.<\/p>\n\n\n\n

1. Executar uma stored procedure no SQL Server com um par\u00e2metro<\/h2>\n\n\n\n

Primeiramente, crie a procedure a ser chamada, ou certifique-se de que o alvo j\u00e1 est\u00e1 no banco de dados. Se n\u00e3o, execute o c\u00f3digo abaixo, similar ao usado para criar a procedure uspGetCustomer<\/strong><\/a> deste tutorial. Nesta stored procedure, o \u00fanico par\u00e2metro de entrada \u00e9 o ID do Cliente, sendo obrigat\u00f3rio. O objetivo da procedure \u00e9 exibir todas as informa\u00e7\u00f5es, ou seja, todas as colunas da tabela Clientes para o n\u00famero de cliente dado como par\u00e2metro. O exemplo da stored procedure com este script:<\/p>\n\n\n\n

CREATE PROCEDURE uspGetCustomer\n   @NoClient INT\nAS\n   SELECT  *\n   FROM    [dbo].[CLIENTS]\n   WHERE   [NOCLIENT] = @NoClient\nGO<\/pre>\n\n\n\n
Aqui est\u00e1 um exemplo simples de como executar uma stored procedure no MS SQL com um ou mais par\u00e2metros como entrada. De fato, para passar as informa\u00e7\u00f5es de entrada para o c\u00f3digo SQL, execute este c\u00f3digo e adapte esta sintaxe ao caso de neg\u00f3cio espec\u00edfico: <\/p>\n\n\n\n
EXEC dbo.uspGetCustomer\n   @NoClient = 1;\n<\/pre>\n\n\n\n
2. Executar uma stored procedure com v\u00e1rios par\u00e2metros em T-SQL<\/h2>\n\n\n\n
Neste segundo caso, o ID do Cliente e a Cidade s\u00e3o usados como par\u00e2metros. Nestes exemplos mais pr\u00e1ticos, \u00e9 claro que \u00e9 poss\u00edvel usar apenas nomes e valores expl\u00edcitos em vez de IDs t\u00e9cnicos.<\/p>\n\n\n\n
-- Criar a mesma procedure com dois par\u00e2metros e tamb\u00e9m valores padr\u00e3o NULL\nCREATE PROCEDURE uspGetCustomer\n  @ClientNumber  int          = NULL, \n  @City          nvarchar(20) = NULL\nAS\n  SELECT *\n  FROM   [dbo].[CLIENTS]\n  WHERE  [ClientNumber] = @ClientNumber\n    OR   [City]         = @City\nGO\n<\/pre>\n\n\n\n
Assim, para executar uma stored procedure codificada no SQL Server, simplesmente chame a procedure, com os par\u00e2metros obrigat\u00f3rios separados por valores, e na ordem correta, ou nomeados explicitamente, que \u00e9 a maneira recomendada. <\/p>\n\n\n\n
EXEC dbo.uspGetCustomer\n   @ClientNumber = 2,\n   @City         = 'Casablanca';\n <\/pre>\n\n\n\n
De fato, no par\u00e1grafo anterior menciono o fato de que n\u00e3o \u00e9 necess\u00e1rio chamar explicitamente os nomes das vari\u00e1veis, podendo cham\u00e1-las desta forma:<\/p>\n\n\n\n
EXEC dbo.uspGetCustomer\n   2,\n   'Casablanca';\n <\/pre>\n\n\n\n
3. A ordem \u00e9 importante ao executar stored procedures em T-SQL<\/h2>\n\n\n\n
Mas neste caso, a ordem deve ser respeitada. Por exemplo, tente executar o c\u00f3digo abaixo, ou seja, sem respeitar a ordem.<\/p>\n\n\n\n
EXEC dbo.uspGetCustomer\n   'Casablanca', \n   2;\n<\/pre>\n\n\n\n
Voc\u00ea pode encontrar um erro do SQL Server como este, porque os tipos dos par\u00e2metros n\u00e3o s\u00e3o os mesmos. E se ambos fossem inteiros, poderia ser pior, pois ent\u00e3o o resultado seria falso.<\/p>\n\n\n
\n
\"Para
Para executar uma stored procedure com par\u00e2metros no SQL Server sem erro: a ordem deve ser respeitada<\/em><\/figcaption><\/figure><\/div>\n\n\n
Msg 8114, Level 16, State 1, Procedure dbo.uspGetCustomer, Line 0 [Batch Start Line 0]
Erro ao converter o tipo de dados varchar para int.<\/em><\/p>\n\n\n\n
Uma sintaxe simples desde que os par\u00e2metros e valores padr\u00e3o sejam usados<\/h3>\n\n\n\n
Este \u00e9 o fim do tutorial sobre como executar um procedimento armazenado com par\u00e2metros usando a programa\u00e7\u00e3o do SQL Server. Para aprofundar na jornada de aprendizado do SQL Server<\/a> e T-SQL, este \u00e9 um breve tutorial sobre como retornar valores com uma stored procedure usando a op\u00e7\u00e3o OUTPUT<\/a>. De fato, stored procedures, ao contr\u00e1rio de fun\u00e7\u00f5es SQL, nem sempre retornam um valor. Para retornar um valor com uma procedure no MS SQL, use a op\u00e7\u00e3o OUTPUT.<\/p>\n\n\n\n
Mais conte\u00fado sobre Stored Procedures SQL<\/h5>\n\n\n\n