Requisiti per le aggregazioni CLR definite dall'utente
Si applica a:
SQL Server
Un tipo in un assembly CLR (Common Language Runtime) può essere registrato come funzione di aggregazione definita dall'utente, purché implementi il contratto di aggregazione necessario. Questo contratto è costituito dall'attributo SqlUserDefinedAggregate e dai metodi del contratto di aggregazione. Il contratto di aggregazione include il meccanismo per salvare lo stato intermedio dell'aggregazione e il meccanismo per accumulare nuovi valori, costituiti da quattro metodi: Init, Accumulate, Mergee Terminate. Dopo aver soddisfatto questi requisiti, è possibile sfruttare appieno le aggregazioni definite dall'utente in SQL Server. Questo articolo fornisce altre informazioni su come creare e usare aggregazioni definite dall'utente. Per un esempio, vedere Richiamare funzioni di aggregazione CLR definite dall'utente.
Per altre informazioni, vedere SqlUserDefinedAggregateAttribute.
Metodi di aggregazione
La classe registrata come aggregazione definita dall'utente deve supportare i metodi di istanza seguenti. Query Processor usa i metodi seguenti per calcolare l'aggregazione.
Metodo Init
Sintassi:
public void Init();
Query Processor utilizza questo metodo per inizializzare il calcolo dell'aggregazione. Questo metodo viene richiamato una volta per ogni gruppo aggregato da Query Processor. Query Processor potrebbe scegliere di riutilizzare la stessa istanza della classe di aggregazione per l'elaborazione di aggregazioni di più gruppi. Il metodo Init deve eseguire qualsiasi pulizia in base alle esigenze degli usi precedenti di questa istanza e consentire il riavvio di un nuovo calcolo aggregato.
Metodo Accumulate
Sintassi:
public void Accumulate(input-type value[, input-type value, ...]);
Uno o più parametri che rappresentano i parametri della funzione.
input_type deve essere il tipo di dati di SQL Server gestito equivalente al tipo di dati di SQL Server nativo specificato da input_sqltype nell'istruzione CREATE AGGREGATE. Per altre informazioni, vedere mapping dei dati dei parametri CLR.
Per i tipi definiti dall'utente (UDT, User-Defined Type), il tipo di input coincide con il tipo definito dall'utente. Query Processor utilizza questo metodo per accumulare i valori di aggregazione. Il metodo viene richiamato una volta per ogni valore nel gruppo aggregato. Query Processor chiama sempre questo metodo solo dopo aver chiamato il metodo Init nell'istanza specificata della classe di aggregazione. L'implementazione di questo metodo deve aggiornare lo stato dell'istanza per riflettere l'accumulazione del valore dell'argomento passato.
Metodo merge
Sintassi:
public void Merge(udagg_class value);
Questo metodo può essere utilizzato per unire un'altra istanza di questa classe di aggregazione all'istanza corrente. Query Processor utilizza questo metodo per unire più calcoli parziali di un'aggregazione.
Metodo Terminate
Sintassi:
public return_type Terminate();
Questo metodo completa il calcolo di aggregazione e restituisce il risultato dell'aggregazione. Il return_type deve essere un tipo di dati di SQL Server gestito equivalente a quello gestito di return_sqltype specificato nell'istruzione CREATE AGGREGATE. Il return_type può anche essere un tipo definito dall'utente.