Esecuzione di funzioni definite dall'utente (Motore di database)

  • Articolo

Data aggiornamento: 14 aprile 2006

Le funzioni definite dall'utente possono essere richiamate in query o in altre istruzioni o espressioni, ad esempio le colonne calcolate o le espressioni stringa. Le funzioni con valori scalari possono essere eseguite utilizzando l'istruzione EXECUTE.

Richiamata di funzioni definite dall'utente che restituiscono un valore scalare

È possibile richiamare una funzione definita dall'utente che restituisce un valore scalare in qualsiasi posizione di un'istruzione Transact-SQL in cui sia consentita un'espressione scalare con lo stesso tipo di dati. Le funzioni con valori scalari devono essere richiamate utilizzando almeno il nome composto da due parti della funzione. Per ulteriori informazioni sui nomi composti da più parti, vedere Convenzioni della sintassi Transact-SQL (Transact-SQL).

Query

Le funzioni definite dall'utente che restituiscono valori scalari sono consentite nelle posizioni seguenti:

  • Come parametro expression in select_list di un'istruzione SELECT:

    USE AdventureWorks;
GO
SELECT ProductID, ListPrice, dbo.ufnGetProductDealerPrice(ProductID, StartDate) AS DealerPrice,
    StartDate, EndDate
FROM Production.ProductListPriceHistory
WHERE ListPrice > .0000
ORDER BY ProductID, StartDate;
GO

  • Come parametro expression o string_expression nel predicato di una clausola WHERE o HAVING:

    USE AdventureWorks;
GO
SELECT ProductID, ListPrice, StartDate, EndDate
FROM Production.ProductListPriceHistory
WHERE dbo.ufnGetProductDealerPrice(ProductID, StartDate) > .0000
ORDER BY ProductID, StartDate;
GO

  • Come parametro group_by_expression in una clausola GROUP BY.

  • Come parametro order_by_expression in una clausola ORDER BY.

  • Come parametro expression nella clausola SET di un'istruzione UPDATE:

    USE AdventureWorks;
GO
UPDATE Production.ProductListPriceHistory
SET ListPrice = dbo.ufnGetProductDealerPrice(ProductID, StartDate)
WHERE ProductID > 900;
GO

  • Come parametro expression nella clausola VALUES di un'istruzione INSERT:
    Le funzioni definite dall'utente a cui si fa riferimento in queste posizioni vengono eseguite logicamente una volta per riga.

Vincoli CHECK

Le funzioni definite dall'utente che restituiscono valori scalari possono essere richiamate tramite vincoli CHECK se i valori degli argomenti passati alla funzione fanno riferimento solo a colonne della tabella o a costanti. Ogni volta che Query Processor verifica il vincolo, viene richiamata la funzione con i valori degli argomenti associati alla riga verificata. Il proprietario di una tabella deve essere anche il proprietario della funzione definita dall'utente richiamata da un vincolo CHECK della tabella.

Definizioni DEFAULT

Le funzioni definite dall'utente possono essere richiamate come parametro constant_expression di definizioni DEFAULT se i valori degli argomenti passati alla funzione includono solo costanti. Il proprietario della tabella deve essere anche il proprietario della funzione definita dall'utente richiamata da una definizione DEFAULT della tabella.

Colonne calcolate

Le funzioni possono essere richiamate da colonne calcolate se i valori degli argomenti passati alla funzione fanno riferimento solo a colonne della tabella o a costanti. Il proprietario della tabella deve essere anche il proprietario della funzione definita dall'utente richiamata da una colonna calcolata della tabella.

Operatori di assegnazione

Gli operatori di assegnazione (left_operand = right_operand) possono richiamare funzioni definite dall'utente che restituiscono un valore scalare nell'espressione specificata come operando destro.

Istruzioni per il controllo di flusso

Le funzioni definite dall'utente che restituiscono valori scalari possono essere richiamate da istruzioni per il controllo di flusso nelle rispettive espressioni booleane.

Espressioni CASE

Le funzioni definite dall'utente che restituiscono valori scalari possono essere richiamate in qualsiasi espressione CASE.

Istruzioni PRINT

Le funzioni definite dall'utente che restituiscono una stringa di caratteri possono essere richiamate come espressione string_expr di istruzioni PRINT.

Funzioni e stored procedure

  • Gli argomenti delle funzioni possono essere inoltre riferimenti a una funzione definita dall'utente che restituisce un valore scalare.
  • Le istruzioni RETURN integer_expression incluse in stored procedure possono richiamare funzioni definite dall'utente che restituiscono un valore integer come parametro integer_expression.
  • Le istruzioni RETURN return_type_spec incluse in funzioni definite dall'utente possono richiamare funzioni definite dall'utente che restituiscono un tipo di dati scalare, ad esempio return_type_spec, a condizione che il valore restituito dalla funzione definita dall'utente possa essere convertito implicitamente nel tipo di dati restituito dalla funzione chiamante.

Esecuzione di funzioni definite dall'utente che restituiscono un valore scalare

Le funzioni definite dall'utente che restituiscono valori scalari possono essere eseguite in base alle stesse modalità utilizzate per le stored procedure. Quando si esegue una funzione definita dall'utente che restituisce un valore scalare, i parametri vengono specificati come per le stored procedure:

  • I valori degli argomenti non vengono racchiusi tra parentesi.
  • È possibile specificare i nomi dei parametri.
  • Se vengono specificati i nomi dei parametri, i valori degli argomenti non devono essere necessariamente specificati nella stessa sequenza dei parametri.

Nell'esempio seguente viene creata una funzione definita dall'utente che restituisce un valore scalare decimale.

IF OBJECT_ID(N'dbo.ufn_CubicVolume', N'FN') IS NOT NULL
    DROP FUNCTION dbo.ufn_CubicVolume;
GO
CREATE FUNCTION dbo.ufn_CubicVolume
-- Input dimensions in centimeters.
   (@CubeLength decimal(4,1), @CubeWidth decimal(4,1),
    @CubeHeight decimal(4,1) )
RETURNS decimal(12,3) -- Cubic Centimeters.
WITH SCHEMABINDING
AS
BEGIN
   RETURN ( @CubeLength * @CubeWidth * @CubeHeight )
END;
GO

Nell'esempio seguente viene eseguita la funzione dbo.ufn_CubicVolume. Nell'istruzione Transact-SQL EXECUTE gli argomenti vengono identificati in un ordine diverso rispetto a quello dei parametri inclusi nella definizione della funzione:

DECLARE @MyDecimalVar decimal(12,3);
EXEC @MyDecimalVar = dbo.ufn_CubicVolume @CubeLength = 12.3,
                        @CubeHeight = 4.5, @CubeWidth = 4.5;
SELECT @MyDecimalVar;
GO

Nell'esempio seguente viene eseguita la funzione dbo.ufn_CubicVolume senza che vengano specificati i nomi dei parametri:

DECLARE @MyDecimalVar decimal(12,3);
EXEC @MyDecimalVar = dbo.ufn_CubicVolume 12.3, 4.5, 4.5;
SELECT @MyDecimalVar;
GO

È inoltre possibile utilizzare la sintassi ODBC CALL per eseguire la funzione dbo.ufn_CubicVolume in applicazioni OLE DB o ODBC:

-- First use SQLBindParam to bind the return value parameter marker
-- to a program variable of the appropriate type
SQLExecDirect(hstmt,
              "{ CALL ? = dbo.ufn_CubicVolume(12.3, 4.5, 4.5) }",
              SQL_NTS);

Richiamata di funzioni definite dall'utente che restituiscono il tipo di dati table

È possibile richiamare una funzione definita dall'utente che restituisce il tipo di dati table in qualsiasi posizione in cui sono consentite espressioni relative a tabelle nella clausola FROM delle istruzioni SELECT, INSERT, UPDATE e DELETE. La richiamata di una funzione definita dall'utente che restituisce una tabella può essere seguita da un alias di tabella facoltativo. Nell'esempio seguente viene illustrata la chiamata della funzione valutata a livello di tabella dbo.ufnGetContactInformation nella clausola FROM di un'istruzione SELECT.

USE AdventureWorks;
GO
SELECT ContactID, FirstName, LastName, JobTitle, ContactType
FROM dbo.ufnGetContactInformation(2200);
GO
SELECT ContactID, FirstName, LastName, JobTitle, ContactType
FROM dbo.ufnGetContactInformation(5);
GO

Se nella clausola FROM di una subquery si richiama una funzione definita dall'utente che restituisce una tabella, negli argomenti della funzione non è possibile fare riferimento a colonne della query esterna.

In un'istruzione SELECT in cui la clausola FROM fa riferimento a una funzione definita dall'utente che restituisce una tabella, è possibile aprire esclusivamente cursori statici di sola lettura.

Un'istruzione SELECT che fa riferimento a una funzione definita dall'utente che restituisce dati di tipo table richiama tale funzione una sola volta.

Richiamata di funzioni valutate a livello di tabella predefinite

Sono disponibili diverse funzioni valutate a livello di tabella predefinite che restituiscono un valore di tabella. È possibile richiamare tali funzioni definite dall'utente in modalità non qualificata oppure utilizzando il qualificatore di schema sys. È consigliabile utilizzare il qualificatore di schema sys per le funzioni valutate a livello di tabella predefinite, in quanto consente di evitare conflitti con le funzioni definite dall'utente aventi lo stesso nome. Nell'esempio seguente viene illustrato come richiamare la funzione di sistema predefinita fn_helpcollations.

SELECT *
FROM sys.fn_helpcollations();
GO

Utilizzo di hint con funzioni valutate a livello di tabella

Quando si crea una funzione definita dall'utente, è possibile applicare un hint di tabella in qualsiasi query che forma la definizione di funzione. Gli hint applicati alle viste che fanno riferimento a funzioni Transact-SQL valutate a livello di tabella vengono applicati anche alle funzioni. Tali funzioni possono creare conflitti con gli hint inclusi nella definizione di funzione. Per ulteriori informazioni, vedere Risoluzione delle viste.

Non è possibile applicare hint in viste che fanno riferimento a funzioni CLR valutate a livello di tabella.

[!NOTA] La possibilità in Motore di database di applicare hint delle viste a funzioni valutate a livello di tabella con istruzioni multiple che fanno parte della definizione della vista verrà rimossa a partire da una delle prossime versioni di SQL Server.

Evitare di applicare un hint di tabella al risultato di qualsiasi funzione valutata a livello di tabella nella clausola FROM di una query.

Vedere anche

Concetti

Creazione di funzioni definite dall'utente (Motore di database)
Creazione di funzioni CLR
Creazione di funzioni di aggregazione definite dall'utente
Visualizzazione delle funzioni definite dall'utente

Guida in linea e informazioni

Assistenza su SQL Server 2005

Cronologia modifiche

Versione Cronologia

14 aprile 2006
Nuovo contenuto:
  • Aggiunta del testo che indica che le funzioni con valori scalari devono essere richiamate utilizzando almeno il nome composto da due parti della funzione.