NEWID (Transact-SQL)NEWID (Transact-SQL)

SE APLICA A: síSQL Server (a partir de 2008) síAzure SQL Database síAzure SQL Data Warehouse noAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server (starting with 2008) yesAzure SQL Database yesAzure SQL Data Warehouse noParallel Data Warehouse

Crea un valor único del tipo uniqueidentifier.Creates a unique value of type uniqueidentifier.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax


NEWID ( )  

Tipos devueltosReturn Types

uniqueidentifieruniqueidentifier

NotasRemarks

NEWID() es compatible con RFC4122.NEWID() is compliant with RFC4122.

EjemplosExamples

A.A. Utilizar la función NEWID con una variableUsing the NEWID function with a variable

En el siguiente ejemplo se usa NEWID() para asignar un valor a una variable declarada con el tipo de datos uniqueidentifier.The following example uses NEWID() to assign a value to a variable declared as the uniqueidentifier data type. El valor de la variable de tipo uniqueidentifier se imprime antes de ser comprobado.The value of the uniqueidentifier data type variable is printed before the value is tested.

-- Creating a local variable with DECLARE/SET syntax.  
DECLARE @myid uniqueidentifier  
SET @myid = NEWID()  
PRINT 'Value of @myid is: '+ CONVERT(varchar(255), @myid)  

El conjunto de resultados es el siguiente.Here is the result set.

Value of @myid is: 6F9619FF-8B86-D011-B42D-00C04FC964FF  

Nota

El valor que devuelve NEWID es distinto en cada equipo.The value returned by NEWID is different for each computer. Este número solo se indica a título ilustrativo.This number is shown only for illustration.

B.B. Utilizar NEWID en una instrucción CREATE TABLEUsing NEWID in a CREATE TABLE statement

Se aplica a: SQL ServerSQL ServerApplies to: SQL ServerSQL Server

En el siguiente ejemplo se crea una tabla cust con un tipo de datos uniqueidentifier y se usa NEWID para llenarla con un valor predeterminado.The following example creates the cust table with a uniqueidentifier data type, and uses NEWID to fill the table with a default value. Al asignar como valor predeterminado NEWID(), cada fila nueva y existente tendrá un valor único en la columna CustomerID.In assigning the default value of NEWID(), each new and existing row has a unique value for the CustomerID column.

-- Creating a table using NEWID for uniqueidentifier data type.  
CREATE TABLE cust  
(  
 CustomerID uniqueidentifier NOT NULL  
   DEFAULT newid(),  
 Company varchar(30) NOT NULL,  
 ContactName varchar(60) NOT NULL,   
 Address varchar(30) NOT NULL,   
 City varchar(30) NOT NULL,  
 StateProvince varchar(10) NULL,  
 PostalCode varchar(10) NOT NULL,   
 CountryRegion varchar(20) NOT NULL,   
 Telephone varchar(15) NOT NULL,  
 Fax varchar(15) NULL  
);  
GO  
-- Inserting 5 rows into cust table.  
INSERT cust  
(CustomerID, Company, ContactName, Address, City, StateProvince,   
 PostalCode, CountryRegion, Telephone, Fax)  
VALUES  
 (NEWID(), 'Wartian Herkku', 'Pirkko Koskitalo', 'Torikatu 38', 'Oulu', NULL,  
 '90110', 'Finland', '981-443655', '981-443655')  
,(NEWID(), 'Wellington Importadora', 'Paula Parente', 'Rua do Mercado, 12', 'Resende', 'SP',  
 '08737-363', 'Brasil', '(14) 555-8122', '')  
,(NEWID(), 'Cactus Comidas para Ilevar', 'Patricio Simpson', 'Cerrito 333', 'Buenos Aires', NULL,   
 '1010', 'Argentina', '(1) 135-5555', '(1) 135-4892')  
,(NEWID(), 'Ernst Handel', 'Roland Mendel', 'Kirchgasse 6', 'Graz', NULL,  
 '8010', 'Austria', '7675-3425', '7675-3426')  
,(NEWID(), 'Maison Dewey', 'Catherine Dewey', 'Rue Joseph-Bens 532', 'Bruxelles', NULL,  
 'B-1180', 'Belgium', '(02) 201 24 67', '(02) 201 24 68');  
GO  

C.C. Utilizar uniqueidentifier y la asignación de variableUsing uniqueidentifier and variable assignment

En este ejemplo se declara una variable local denominada @myid como variable del tipo de datos uniqueidentifier.The following example declares a local variable called @myid as a variable of uniqueidentifier data type. A continuación, se asigna un valor a la variable con la instrucción SET.Then, the variable is assigned a value by using the SET statement.

DECLARE @myid uniqueidentifier ;  
SET @myid = 'A972C577-DFB0-064E-1189-0154C99310DAAC12';  
SELECT @myid;  
GO  

Ver tambiénSee Also

NEWSEQUENTIALID (Transact-SQL) NEWSEQUENTIALID (Transact-SQL)
ALTER TABLE (Transact-SQL) ALTER TABLE (Transact-SQL)
CAST y CONVERT (Transact-SQL) CAST and CONVERT (Transact-SQL)
CREATE TABLE (Transact-SQL) CREATE TABLE (Transact-SQL)
Tipos de datos (Transact-SQL) Data Types (Transact-SQL)
Funciones del sistema (Transact-SQL) System Functions (Transact-SQL)
uniqueidentifier (Transact-SQL) uniqueidentifier (Transact-SQL)
Números de secuenciaSequence Numbers