Aggregazioni CLR definite dall'utente - Requisiti

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, costituito da quattro metodi: Init, Accumulate, Merge e Terminate. Dopo aver soddisfatto questi requisiti, sarà possibile sfruttare appieno le aggregazioni definite dall'utente in Microsoft SQL Server. Nelle sezioni seguenti di questo argomento sono disponibili altre informazioni dettagliate su come creare e utilizzare aggregazioni definite dall'utente. Per un esempio, vedere Richiamo di funzioni di aggregazione CLR definite dall'utente.

SqlUserDefinedAggregate

Per altre informazioni, vedere SqlUserDefinedAggregateAttribute.

Metodi di aggregazione

La classe registrata come aggregazione definita dall'utente deve supportare i metodi di istanza seguenti. Tali metodi vengono utilizzati da Query Processor per calcolare l'aggregazione:

metodo	Sintassi	Descrizione
Init	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 può scegliere di riutilizzare la stessa istanza della classe di aggregazione per il calcolo delle aggregazioni di più gruppi. Il metodo Init deve eseguire qualsiasi pulizia in base alle esigenze degli usi precedenti di questa istanza e abilitarlo per riavviare un nuovo calcolo di aggregazione.
Accumulare	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 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.
Unione	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.
Terminare	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.

Vedi anche

Tipi CLR definiti dall'utente
Chiamata di funzioni di aggregazione CLR definite dall'utente