NEWID (Transact-SQL)

Cria um valor exclusivo de uniqueidentifier de tipo.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

NEWID ( )

Tipos de retorno

uniqueidentifier

Exemplos

A. Usando uma função NEWID com uma variável

O exemplo seguinte usa NEWID() para atribuir um valor a uma variável declarada como tipo de dados uniqueidentifier. O valor da variável de tipo de dados uniqueidentifier é impresso antes de o valor ser testado.

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

Aqui está o conjunto de resultados.

Value of @myid is: 6F9619FF-8B86-D011-B42D-00C04FC964FF
ObservaçãoObservação

O valor retornado por NEWID é diferente para cada computador. O número mostrado é meramente ilustrativo.

B. Usando NEWID em uma instrução CREATE TABLE

O exemplo seguinte cria a tabela cust com um tipo de dados uniqueidentifier e usa NEWID para preenchê-la com um valor padrão. Ao atribuir o valor padrão de NEWID(), cada linha existente e nova possui um valor exclusivo para a coluna CustomerID.

-- 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 data 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')
INSERT cust
(CustomerID, Company, ContactName, Address, City, StateProvince,
PostalCode, CountryRegion, Telephone, Fax)
VALUES 
(NEWID(), 'Wellington Importadora', 'Paula Parente', 'Rua do Mercado, 12', 'Resende', 'SP',
 '08737-363', 'Brasil', '(14) 555-8122', '')
INSERT cust
(CustomerID, Company, ContactName, Address, City, StateProvince,
 PostalCode, CountryRegion, Telephone, Fax)
VALUES
(NEWID(), 'Cactus Comidas para Ilevar', 'Patricio Simpson', 'Cerrito 333', 'Buenos Aires', NULL, 
 '1010', 'Argentina', '(1) 135-5555', '(1) 135-4892')
INSERT cust
(CustomerID, Company, ContactName, Address, City, StateProvince,
 PostalCode, CountryRegion, Telephone, Fax)
VALUES 
(NEWID(), 'Ernst Handel', 'Roland Mendel', 'Kirchgasse 6', 'Graz', NULL,
 '8010', 'Austria', '7675-3425', '7675-3426')
INSERT cust
(CustomerID, Company, ContactName, Address, City, StateProvince,
 PostalCode, CountryRegion, Telephone, Fax)
VALUES 
(NEWID(), 'Maison Dewey', 'Catherine Dewey', 'Rue Joseph-Bens 532', 'Bruxelles', NULL,
 'B-1180', 'Belgium', '(02) 201 24 67', '(02) 201 24 68')
GO

C. Usando uniqueidentifier e atribuição de variável

O exemplo seguinte declara uma variável local chamada @myid como uma variável de tipo de dados uniqueidentifier. Em seguida, é atribuído um valor à variável usando-se a instrução SET.

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