{"id":30379,"date":"2024-02-28T05:54:00","date_gmt":"2024-02-28T04:54:00","guid":{"rendered":"https:\/\/expert-only.com\/?p=30379"},"modified":"2024-03-01T12:17:24","modified_gmt":"2024-03-01T11:17:24","slug":"como-chamar-uma-funcao-do-sql-server","status":"publish","type":"post","link":"https:\/\/expert-only.com\/pt-pt\/t-sql\/como-chamar-uma-funcao-do-sql-server\/","title":{"rendered":"Como Chamar uma Fun\u00e7\u00e3o do SQL Server ?"},"content":{"rendered":"\n

Como chamar fun\u00e7\u00f5es do SQL Server a partir de scripts Transact-SQL?<\/em><\/strong><\/h4>\n\n\n\n

Tutorial sobre como chamar uma fun\u00e7\u00e3o do SQL Server usando scripts T-SQL, com e sem par\u00e2metros. De facto, a sintaxe T-SQL para chamar uma fun\u00e7\u00e3o difere da chamada de uma stored procedure. Utilize a fun\u00e7\u00e3o do SQL Server da mesma forma que seleciona dados de uma tabela. Aprender a chamar uma fun\u00e7\u00e3o definida pelo utilizador do SQL Server com um script T-SQL \u00e9 essencial para otimizar a manuten\u00e7\u00e3o do seu banco de dados e facilitar a manipula\u00e7\u00e3o de dados.<\/p>\n\n\n\n

Neste tutorial SQL, vamos examinar como usar uma fun\u00e7\u00e3o definida pelo utilizador e como personalizar a sa\u00edda da fun\u00e7\u00e3o para atender a necessidades espec\u00edficas. Uma fun\u00e7\u00e3o definida pelo utilizador do SQL Server<\/strong><\/a> \u00e9 um programa Transact-SQL que aceita par\u00e2metros de entrada. Quando chamada, realiza a\u00e7\u00f5es, como ler uma tabela do SQL Server, e retorna um resultado de sa\u00edda.<\/p>\n\n\n\n

1. Par\u00e2metro de entrada n\u00e3o \u00e9 obrigat\u00f3rio numa fun\u00e7\u00e3o do SQL Server<\/h2>\n\n\n\n

Uma fun\u00e7\u00e3o n\u00e3o necessariamente tem um par\u00e2metro de entrada. No entanto, uma fun\u00e7\u00e3o definida pelo utilizador do SQL Server retorna dados<\/a>, que podem ser um conjunto de resultados vazio, uma \u00fanica linha ou m\u00faltiplas colunas. Por exemplo, ao chamar a fun\u00e7\u00e3o integrada para exibir a data no SQL Server, o sistema retorna a data atual.<\/p>\n\n\n\n

SELECT GETDATE();\n<\/pre>\n\n\n\n
2. O resultado de sa\u00edda \u00e9 obrigat\u00f3rio em fun\u00e7\u00f5es T-SQL<\/h2>\n\n\n\n
De fato, uma fun\u00e7\u00e3o \u00e9 definida pelo fato de retornar um resultado. Para chamar uma fun\u00e7\u00e3o, abra o SSMS e adapte o c\u00f3digo da fun\u00e7\u00e3o se necess\u00e1rio. Considere este script para criar uma fun\u00e7\u00e3o chamada dbo.ufnDisplayCustomers em T-SQL:<\/p>\n\n\n\n
CREATE FUNCTION dbo.ufnDisplayCustomers(@CustomerID INTEGER)\nRETURNS NVARCHAR(20)\nAS \nBEGIN \n  DECLARE @CustomerName  AS NVARCHAR(20);\n  SELECT  @CustomerName = [Name]\n  FROM    [dbo].[Customers]\n  WHERE   [CustomerID] = @CustomerID;\n  RETURN  @CustomerName;\nEND\nGO\n<\/pre>\n\n\n\n
Para chamar uma fun\u00e7\u00e3o do SQL Server, utilize a seguinte sintaxe:<\/p>\n\n\n\n
SELECT dbo.FunctionName(Parameters);<\/strong><\/em><\/p>\n\n\n\n
A fun\u00e7\u00e3o abaixo exibe o nome de um cliente associado ao n\u00famero do cliente passado como par\u00e2metro. Claro que assumimos que voc\u00ea tem uma tabela com pelo menos estas duas colunas, como no exemplo.<\/p>\n\n\n\n
    \n
  1. CustomerID<\/li>\n\n\n\n
  2. Name<\/li>\n<\/ol>\n\n\n\n
    \/* Expert-Only.com *\/ \nSELECT [CustomerID]\n      ,[Name]\n  FROM [Expert-Only].[dbo].[Customers];\n\n\n\/* Expert-Only.com *\/ \nSELECT dbo.ufnDisplayCustomers(1);\n<\/pre>\n\n\n
    \n
    \"Exemplo
    Exemplo de query para chamar uma Fun\u00e7\u00e3o do SQL Server a partir do T-SQL<\/em><\/figcaption><\/figure>\n<\/div>\n\n\n
    \n
    How to create a SQL Server function with a script ?<\/a><\/blockquote>