Registrazione dei tipi definiti dall'utente in SQL Server
Si applica a:
SQL Server
Per usare un tipo definito dall'utente (UDT) in Microsoft SQL Server, è necessario registrarlo. La registrazione di un tipo definito dall'utente (UDT) comporta la registrazione dell'assembly e la creazione del tipo nel database in cui si desidera utilizzarlo. I tipi definiti dall'utente (UDT) vengono definiti nell'ambito di un singolo database e non possono essere utilizzati in più database a meno che lo stesso assembly e lo stesso tipo definito dall'utente (UDT) non vengano registrati con ogni database. Dopo aver registrato l'assembly UDT e aver creato il tipo, è possibile usare il tipo definito dall'utente in Transact-SQL e nel codice client. Per altre informazioni, vedere Tipi CLR definiti dall'utente.
Utilizzo di Visual Studio per distribuire i tipi definiti dall'utente (UDT)
Il modo più semplice per distribuire il tipo definito dall'utente consiste nell'usare Microsoft Visual Studio. Per scenari di distribuzione più complessi e la massima flessibilità, tuttavia, usare Transact-SQL come descritto più avanti in questo argomento.
Seguire questi passaggi per creare e distribuire un tipo definito dall'utente (UDT) mediante Visual Studio:
Creare un nuovo progetto di database nei nodi del linguaggio Visual Basic o Visual C# .
Aggiungere un riferimento al database SQL Server che conterrà il tipo definito dall'utente.
Aggiungere una classe Di tipo definito dall'utente .
Scrivere il codice per implementare il tipo definito dall'utente (UDT).
Scegliere Distribuisci dal menu Compila. In questo modo viene registrato l'assembly e viene creato il tipo nel database SQL Server.
Utilizzo di Transact-SQL per distribuire i tipi definiti dall'utente (UDT)
La sintassi Transact-SQL CREATE ASSEMBLY viene usata per registrare l'assembly nel database in cui si desidera utilizzare il tipo definito dall'utente. Viene archiviata internamente nelle tabelle di sistema del database e non esternamente nel file system. Se il tipo definito dall'utente (UDT) dipende dagli assembly esterni, questi dovranno essere caricati nel database. L'istruzione CREATE TYPE viene utilizzata per creare il tipo definito dall'utente (UDT) nel database in cui deve essere utilizzato. Per altre informazioni, vedere CREATE ASSEMBLY (Transact-SQL) e CREATE TYPE (Transact-SQL).
Utilizzo di CREATE ASSEMBLY
La sintassi CREATE ASSEMBLY registra l'assembly nel database in cui si desidera utilizzare il tipo definito dall'utente (UDT). Dopo avere registrato l'assembly, non saranno presenti dipendenze.
Non è possibile creare più versioni dello stesso assembly in uno specifico database. È tuttavia possibile creare più versioni dello stesso assembly basate sulle impostazioni cultura in un database specificato. SQL Server distingue più versioni delle impostazioni cultura di un assembly con nomi diversi registrati nell'istanza di SQL Server. Per ulteriori informazioni, vedere la sezione relativa alla creazione e all'utilizzo di assembly con nome sicuro in .NET Framework SDK.
Quando CREATE ASSEMBLY viene eseguito con il set di autorizzazioni SAFE o EXTERNAL_ACCESS, l'assembly viene controllato per garantire che sia verificabile e indipendente dai tipi. Se non si specifica un set di autorizzazioni, viene utilizzato SAFE. Il codice con il set di autorizzazioni UNSAFE non viene controllato. Per altre informazioni sui set di autorizzazioni per gli assembly, vedere Progettazione di assembly.
Esempio
L'istruzione Transact-SQL seguente registra l'assembly Point in SQL Server nel database AdventureWorks, con il set di autorizzazioni SAFE. Se la clausola WITH PERMISSION_SET viene omessa, l'assembly viene registrato con il set di autorizzazioni SAFE.
USE AdventureWorks;
CREATE ASSEMBLY Point
FROM '\\ShareName\Projects\Point\bin\Point.dll'
WITH PERMISSION_SET = SAFE;
L'istruzione Transact-SQL seguente registra l'assembly usando <assembly_bits> argomento nella clausola FROM. Questo valore varbinary rappresenta il file come flusso di byte.
USE AdventureWorks;
CREATE ASSEMBLY Point
FROM 0xfeac4 ... 21ac78
Utilizzo di CREATE TYPE
Dopo aver caricato l'assembly nel database, è possibile creare il tipo usando l'istruzione TRANSACT-SQL CREATE TYPE. In questo modo il tipo viene aggiunto all'elenco di tipi disponibili per il database. Il tipo viene definito nell'ambito del database e può essere utilizzato solo nel database in cui è stato creato. Se il tipo definito dall'utente (UDT) esiste già nel database, l'istruzione CREATE TYPE ha esito negativo e restituisce un errore.
Nota
La sintassi CREATE TYPE viene usata anche per la creazione di tipi di dati alias nativi SQL Server ed è destinata a sostituire sp_addtype come mezzo per la creazione di tipi di dati alias. Alcuni argomenti facoltativi nella sintassi CREATE TYPE si riferiscono alla creazione dei tipi definiti dall'utente (UDT) e non sono applicabili alla creazione dei tipi di dati alias, ad esempio il tipo di base.
Per altre informazioni, vedere CREATE TYPE (Transact-SQL).
Esempio
L'istruzione Transact-SQL seguente crea il tipo Point . Il nome ESTERNO viene specificato utilizzando la sintassi di denominazione in due parti di AssemblyName. UDTName.
CREATE TYPE dbo.Point
EXTERNAL NAME Point.[Point];
Rimozione di un tipo definito dall'utente (UDT) dal database
L'istruzione DROP TYPE rimuove un tipo definito dall'utente (UDT) dal database corrente. Dopo avere eliminato un tipo definito dall'utente (UDT), è possibile utilizzare l'istruzione DROP ASSEMBLY per eliminare l'assembly dal database.
L'istruzione DROP TYPE non viene eseguita nelle situazioni seguenti:
Tabelle del database che contengono colonne definite mediante il tipo definito dall'utente (UDT).
Funzioni, stored procedure o trigger che utilizzano variabili o parametri del tipo definito dall'utente (UDT), creati nel database con la clausola WITH SCHEMABINDING.
Esempio
L'istruzione Transact-SQL seguente deve essere eseguita nell'ordine seguente. Prima la tabella che fa riferimento al tipo definito dall'utente del punto deve essere eliminata, quindi il tipo e infine l'assembly.
DROP TABLE dbo.Points;
DROP TYPE dbo.Point;
DROP ASSEMBLY Point;
Ricerca di dipendenze di tipi definiti dall'utente (UDT)
Se sono presenti oggetti dipendenti, ad esempio tabelle con definizioni di colonne con tipo definito dall'utente (UDT), l'istruzione DROP TYPE avrà esito negativo. L'istruzione avrà esito negativo anche se nel database sono stati creati trigger, funzioni o stored procedure mediante la clausola WITH SCHEMABINDING, e tali routine utilizzano variabili o parametri del tipo definito dall'utente (UDT). È necessario innanzitutto eliminare tutti gli oggetti dipendenti, quindi eseguire l'istruzione DROP TYPE.
La query Transact-SQL seguente individua tutte le colonne e i parametri che usano un tipo definito dall'utente nel database AdventureWorks .
USE Adventureworks;
SELECT o.name AS major_name, o.type_desc AS major_type_desc
, c.name AS minor_name, c.type_desc AS minor_type_desc
, at.assembly_class
FROM (
SELECT object_id, name, user_type_id, 'SQL_COLUMN' AS type_desc
FROM sys.columns
UNION ALL
SELECT object_id, name, user_type_id, 'SQL_PROCEDURE_PARAMETER'
FROM sys.parameters
) AS c
JOIN sys.objects AS o
ON o.object_id = c.object_id
JOIN sys.assembly_types AS at
ON at.user_type_id = c.user_type_id;
Gestione di tipi definiti dall'utente (UDT)
Non è possibile modificare un tipo definito dall'utente una volta creato in un database di SQL Server, anche se è possibile modificare l'assembly su cui si basa il tipo. Nella maggior parte dei casi, è necessario rimuovere il tipo definito dall'utente dal database con l'istruzione DROP TYPE Transact-SQL, apportare modifiche all'assembly sottostante e ricaricarlo usando l'istruzione ALTER ASSEMBLY. È necessario quindi ricreare il tipo definito dall'utente (UDT) e tutti gli oggetti dipendenti.
Esempio
L'istruzione ALTER ASSEMBLY viene utilizzata dopo avere apportato le modifiche al codice sorgente nell'assembly del tipo definito dall'utente (UDT) e averlo ricompilato. Il file con estensione dll viene copiato nel server e riassociato al nuovo assembly. Per la sintassi completa, vedere ALTER ASSEMBLY (Transact-SQL).
L'istruzione TRANSACT-SQL ALTER ASSEMBLY seguente ricarica l'assembly Point.dll dal percorso specificato sul disco.
ALTER ASSEMBLY Point
FROM '\\Projects\Point\bin\Point.dll'
Utilizzo di ALTER ASSEMBLY per aggiungere codice sorgente
La clausola ADD FILE nella sintassi ALTER ASSEMBLY non è presente in CREATE ASSEMBLY. È possibile utilizzarla per aggiungere codice sorgente o altri file associati a un assembly. I file vengono copiati dai percorsi originali e vengono archiviati nelle tabelle di sistema del database. In questo modo il codice sorgente o gli altri file saranno sempre disponibili nel caso in cui sia necessario ricreare o documentare la versione corrente del tipo definito dall'utente (UDT).
L'istruzione Transact-SQL ALTER ASSEMBLY seguente aggiunge il codice sorgente della classe Point.cs per il tipo definito dall'utente point. Il testo contenuto nel file Point.cs viene copiato e archiviato nel database con il nome "PointSource".
ALTER ASSEMBLY Point
ADD FILE FROM '\\Projects\Point\Point.cs' AS PointSource;
Le informazioni sull'assembly vengono archiviate nella tabella sys.assembly_files nel database in cui è stato installato l'assembly. La tabella sys.assembly_files contiene le colonne seguenti.
assembly_id
Identificatore definito per l'assembly. Questo numero viene assegnato a tutti gli oggetti relativi allo stesso assembly.
nome
Nome dell'oggetto.
file_id
Numero che identifica ogni oggetto, con il primo oggetto associato a un determinato assembly_id dato il valore 1. Se sono presenti più oggetti associati allo stesso assembly_id, ogni valore file_id successivo viene incrementato di 1.
content
Rappresentazione esadecimale dell'assembly o del file.
È possibile utilizzare la funzione CAST o CONVERT per convertire il contenuto della colonna contenuto in testo leggibile. Nella query seguente il contenuto del file Point.cs viene convertito in testo leggibile, utilizzando il nome nella clausola WHERE per limitare il set di risultati a una singola riga.
SELECT CAST(content AS varchar(8000))
FROM sys.assembly_files
WHERE name='PointSource';
Se i risultati vengono copiati e incollati in un editor di testo, si noterà come le interruzioni di riga e gli spazi presenti nell'originale sono stati conservati.
Gestione di assembly e di tipi definiti dall'utente (UDT)
Quando si pianifica l'implementazione di tipi definiti dall'utente (UDT), considerare quali metodi sono necessari nell'assembly del tipo definito dall'utente (UDT) stesso e quali metodi devono essere creati in assembly separati e implementati come stored procedure o funzioni definite dall'utente. La separazione dei metodi in assembly distinti consente di aggiornare il codice senza influire sui dati che possono essere archiviati in una colonna con tipo definito dall'utente (UDT) di una tabella. È possibile modificare gli assembly del tipo definito dall'utente (UDT) senza eliminare le colonne con tipo definito dall'utente (UDT) e gli altri oggetti dipendenti solo quando la nuova definizione può leggere i valori precedenti e la firma del tipo non viene modificata.
Separando il codice procedurale che può cambiare dal codice necessario per implementare il tipo definito dall'utente (UDT) si semplifica notevolmente la manutenzione. Includendo solo il codice necessario per l'utilizzo del tipo definito dall'utente (UDT) e mantenendo le definizioni del tipo definito dall'utente (UDT) il più semplice possibile, si riduce il rischio di dovere eliminare il tipo definito dall'utente (UDT) dal database per revisioni del codice o correzioni di bug.
Funzione di conversione valuta e tipo definito dall'utente (UDT) Currency
Il tipo definito dall'utente di valuta nel database di esempio AdventureWorks fornisce un esempio utile del modo consigliato per strutturare un tipo definito dall'utente e le relative funzioni associate. Il tipo definito dall'utente valuta viene usato per gestire i soldi in base al sistema monetario di una determinata cultura e consente l'archiviazione di diversi tipi di valuta, ad esempio dollari, euro e così via. La classe UDT espone un nome delle impostazioni cultura come stringa e una quantità di denaro come tipo di dati decimale . Tutti i metodi di serializzazione necessari sono contenuti all'interno dell'assembly che definisce la classe. La funzione che implementa la conversione di valuta da una cultura a un'altra viene implementata come funzione esterna denominata ConvertCurrency e questa funzione si trova in un assembly separato. La funzione ConvertCurrency esegue il proprio lavoro recuperando la frequenza di conversione da una tabella nel database AdventureWorks . Se l'origine dei tassi di conversione deve essere modificata o se è necessario apportare altre modifiche al codice esistente, l'assembly può essere facilmente modificato senza influire sul tipo definito dall'utente valuta .
L'elenco di codice per le funzioni Currency UDT e ConvertCurrency è disponibile installando gli esempi CLR (Common Language Runtime).
Utilizzo di tipi definiti dall'utente (UDT) tra database
I tipi definiti dall'utente (UDT) vengono definiti nell'ambito di un singolo database. Un tipo definito dall'utente (UDT) in un database non può pertanto essere utilizzato in una definizione di colonna di un altro database. Per utilizzare i tipi definiti dall'utente (UDT) in più database, è necessario eseguire le istruzioni CREATE ASSEMBLY e CREATE TYPE in ogni database in assembly identici. Gli assembly sono considerati identici se hanno nome, nome sicuro, lingua, versione, set di autorizzazioni e contenuto binario identici.
Dopo avere registrato e reso accessibile il tipo definito dall'utente (UDT) in entrambi database, è possibile convertire un valore UDT in un database per utilizzarlo nell'altro. I tipi definiti dall'utente (UDT) identici possono essere utilizzati tra i database negli scenari seguenti:
Chiamata a una stored procedure definita in database diversi.
Esecuzione di una query su tabelle definite in database diversi.
Selezione di dati del tipo definito dall'utente (UDT) da una colonna con tipo definito dall'utente (UDT) della tabella di database e inserimento di tali dati in un secondo database con una colonna con tipo definito dall'utente (UDT) identica.
In queste situazioni, la conversione richiesta dal server viene eseguita automaticamente. Non è possibile eseguire le conversioni in modo esplicito usando le funzioni CAST Transact-SQL o CONVERT.
Si noti che non è necessario eseguire alcuna azione per l'uso di tipi definiti dall'utente quando SQL Server motore di database crea tabelle di lavoro nel database di sistema tempdb. Ciò include la gestione di cursori, variabili di tabella e funzioni con valori di tabella definiti dall'utente che includono tipi definiti dall'utente e che usano in modo trasparente tempdb. Tuttavia, se si crea in modo esplicito una tabella temporanea in tempdb che definisce una colonna definita dall'utente, il tipo definito dall'utente deve essere registrato in tempdb allo stesso modo di un database utente.
Vedere anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per