CREATE TYPE (Transact-SQL)

Sintassi

CREATE TYPE [ schema_name. ] type_name
{ 
    FROM base_type 
    [ ( precision [ , scale ] ) ]
    [ NULL | NOT NULL ] 
  | EXTERNAL NAME assembly_name [ .class_name ] 
  | AS TABLE ( { <column_definition> | <computed_column_definition> }
        [ <table_constraint> ] [ ,...n ] )  
} [ ; ]

<column_definition> ::=
column_name <data_type>
    [ COLLATE collation_name ] 
    [ NULL | NOT NULL ]
    [ 
        DEFAULT constant_expression ] 
      | [ IDENTITY [ ( seed ,increment ) ] 
    ]
    [ ROWGUIDCOL ] [ <column_constraint> [ ...n ] ] 

<data type> ::= 
[ type_schema_name . ] type_name 
    [ ( precision [ , scale ] | max | 
                [ { CONTENT | DOCUMENT } ] xml_schema_collection ) ] 

<column_constraint> ::= 
{     { PRIMARY KEY | UNIQUE } 
        [ CLUSTERED | NONCLUSTERED ] 
        [ 
            WITH ( <index_option> [ ,...n ] ) 
        ]
  | CHECK ( logical_expression ) 
} 

<computed_column_definition> ::=
column_name AS computed_column_expression 
[ PERSISTED [ NOT NULL ] ]
[ 
    { PRIMARY KEY | UNIQUE }
        [ CLUSTERED | NONCLUSTERED ]
        [ 
            WITH ( <index_option> [ ,...n ] )
        ]
    | CHECK ( logical_expression ) 
] 

<table_constraint> ::=
{ 
    { PRIMARY KEY | UNIQUE } 
        [ CLUSTERED | NONCLUSTERED ] 
                              ( column [ ASC | DESC ] [ ,...n ] ) 
        [ 
           WITH ( <index_option> [ ,...n ] ) 
        ]
    | CHECK ( logical_expression ) 
} 

<index_option> ::=
{ 
    IGNORE_DUP_KEY = { ON | OFF } 
}

Argomenti

• schema_name
  Nome dello schema a cui appartiene il tipo di dati alias o il tipo definito dall'utente.

• type_name
  Nome del tipo di dati alias o del tipo definito dall'utente. I nomi dei tipi devono essere conformi alle regole per gli identificatori.

• base_type
  Tipo di dati di SQL Server su cui è basato il tipo di dati alias. base_type è di tipo sysname e non prevede alcun valore predefinito. I possibili valori sono i seguenti:

  bigint	binary(n)	bit	char(n)
  date	datetime	datetime2	datetimeoffset
  decimal	float	image	int
  money	nchar(n)	ntext	numeric
  nvarchar(n| max)	real	smalldatetime	smallint
  smallmoney	sql_variant	text	time
  tinyint	uniqueidentifier	varbinary(n| max)	varchar(n| max)

  Per l'argomento base_type è inoltre possibile specificare qualsiasi sinonimo di tipo di dati mappato a uno di questi tipi di dati di sistema.

• precision
  Per i tipi decimal o numeric, valore integer non negativo che indica il numero massimo totale di cifre decimali che è possibile archiviare, sia a sinistra che a destra del separatore decimale. Per ulteriori informazioni, vedere decimal e numeric (Transact-SQL).

• scale
  Per i tipi decimal o numeric, valore integer non negativo che indica il numero massimo di cifre decimali che è possibile archiviare a destra del separatore decimale. Deve essere minore o uguale al valore della precisione. Per ulteriori informazioni, vedere decimal e numeric (Transact-SQL).

• NULL | NOT NULL
  Specifica se il tipo supporta la memorizzazione di valori Null. Se omesso, l'impostazione predefinita è NULL.

• assembly_name
  Specifica l'assembly di SQL Server che fa riferimento all'implementazione del tipo definito dall'utente in CLR. assembly_name deve corrispondere a un assembly esistente in SQL Server nel database corrente.

• [.class_name ]
  Specifica la classe nell'assembly che implementa il tipo definito dall'utente. class_name deve essere un identificatore valido di una classe esistente nell'assembly con visibilità a livello dell'assembly. Per l'argomento class_name non viene applicata alcuna distinzione tra maiuscole e minuscole, indipendentemente dalle regole di confronto del database, e il nome deve essere esattamente uguale al nome di classe nell'assembly corrispondente. Il nome di classe può essere un nome qualificato con lo spazio dei nomi e racchiuso tra parentesi quadre ([ ]) se il linguaggio di programmazione utilizzato per scrivere la classe utilizza il concetto degli spazi dei nomi, come C#. Se class_name viene omesso, SQL Server presume che equivalga a type_name.

• <column_definition>
  Definisce le colonne per un tipo di tabella definito dall'utente. Per ulteriori informazioni sulle colonne, vedere Aggiunta ed eliminazione di colonne.

• <Tipo di dati>
  Definisce il tipo di dati in una colonna con un tipo di tabella definito dall'utente. Per ulteriori informazioni sui tipi di dati, vedere Tipi di dati (Transact-SQL). Per ulteriori informazioni sulle tabelle, vedere CREATE TABLE (Transact-SQL).

• <column_constraint>
  Definisce i vincoli di colonna per un tipo di tabella definito dall'utente. I vincoli supportati includono PRIMARY KEY, UNIQUE e CHECK. Per ulteriori informazioni sui vincoli, vedere Applicazione dell'integrità dei dati. Per ulteriori informazioni sulle tabelle, vedere CREATE TABLE (Transact-SQL).

• <computed_column_definition>
  Definisce un'espressione di colonna calcolata come una colonna in un tipo di tabella definito dall'utente. Per ulteriori informazioni sulle colonne calcolate, vedere Colonne calcolate. Per ulteriori informazioni sulle tabelle, vedere CREATE TABLE (Transact-SQL).

• <table_constraint>
  Definisce un vincolo di tabella per un tipo di tabella definito dall'utente. I vincoli supportati includono PRIMARY KEY, UNIQUE e CHECK. Per ulteriori informazioni sui vincoli di tabella, vedere Vincoli.

• <index_option>
  Specifica il tipo di risposta in caso di errori di valori di chiave duplicati in un'operazione di inserimento di più righe su un indice cluster o non cluster univoco. Per ulteriori informazioni sulle opzioni per gli indici, vedere CREATE INDEX (Transact-SQL).

Osservazioni

Quando si utilizza CREATE TYPE per creare un tipo CLR definito dall'utente, la compatibilità del database deve essere pari a 90.

La classe dell'assembly specificata in assembly_name e i relativi metodi devono soddisfare tutti i requisiti per l'implementazione di un tipo definito dall'utente in SQL Server. Per ulteriori informazioni su tali requisiti, vedere Tipi CLR definiti dall'utente.

Ulteriori considerazioni:

• La classe può contenere metodi di overload, ma tali metodi possono essere chiamati solo da codice gestito e non da Transact-SQL.

• Qualsiasi membro statico deve essere dichiarato come const o readonly se assembly_name è impostato su SAFE o EXTERNAL_ACCESS.

Nell'ambito di un database può esistere un solo tipo definito dall'utente registrato per qualsiasi tipo specificato caricato in SQL Server da CLR. Se si crea un tipo definito dall'utente basato su un tipo CLR per cui esiste già un tipo definito dall'utente nel database, l'istruzione CREATE TYPE viene interrotta e viene generato un errore. Questa restrizione risulta necessaria per evitare ambiguità durante la risoluzione dei tipi SQL, nel caso un tipo CLR possa essere mappato a più di un tipo definito dall'utente.

Se qualsiasi metodo mutatore nel tipo non restituisce void, l'istruzione CREATE TYPE non viene eseguita.

Per modificare un tipo definito dall'utente, è necessario eliminare il tipo tramite l'istruzione DROP TYPE e quindi ricrearlo.

Diversamente dai tipi definiti dall'utente creati tramite sp_addtype, al ruolo del database public non viene concessa automaticamente l'autorizzazione REFERENCES per i tipi creati tramite CREATE TYPE. È necessario concedere l'autorizzazione separatamente.

Nei tipi di tabella definiti dall'utente, i tipi strutturati definiti dall'utente utilizzati in column_name< tipo di dati> sono parte dell'ambito dello schema del database in cui il tipo di tabella è definito. Per accedere ai tipi strutturati definiti dall'utente in un ambito diverso all'interno del database, utilizzare nomi in due parti.

Nei tipi di tabella definiti dall'utente, la chiave primaria sulle colonne calcolate deve essere PERSISTED e NOT NULL.

Autorizzazioni

È richiesta l'autorizzazione CREATE TYPE nel database corrente e l'autorizzazione ALTER per schema_name. Se schema_name viene omesso, vengono applicate le regole predefinite per la risoluzione dei nomi per determinare lo schema dell'utente corrente. Se l'argomento assembly_name viene specificato, è necessario che l'utente sia il proprietario dell'assembly o disponga dell'autorizzazione REFERENCES per tale assembly.

Esempi

A. Creazione di un tipo alias basato sul tipo di dati varchar

CREATE TYPE SSN
FROM varchar(11) NOT NULL ;

B. Creazione di un tipo definito dall'utente

CREATE ASSEMBLY utf8string
FROM '\\ComputerName\utf8string\utf8string.dll' ;
GO
CREATE TYPE Utf8String 
EXTERNAL NAME utf8string.[Microsoft.Samples.SqlServer.utf8string] ;
GO

C. Creazione di un tipo di tabella definito dall'utente

/* Create a user-defined table type */
CREATE TYPE LocationTableType AS TABLE 
    ( LocationName VARCHAR(50)
    , CostRate INT )
GO

Vedere anche

Riferimento

Concetti