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

APLICA-SE A: simSQL Server simBanco de Dados SQL do Azure simAzure Synapse Analytics (SQL DW) nãoParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database yesAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Cria um valor exclusivo do tipo uniqueidentifier.Creates a unique value of type uniqueidentifier.

Ícone de link do tópico Convenções de sintaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

  
NEWID ( )  

Tipos de retornoReturn Types

uniqueidentifieruniqueidentifier

RemarksRemarks

NEWID() é compatível com RFC4122.NEWID() is compliant with RFC4122.

ExemplosExamples

A.A. Usando uma função NEWID com uma variávelUsing the NEWID function with a variable

O exemplo a seguir usa NEWID() para atribuir um valor a uma variável declarada como o tipo de dados uniqueidentifier.The following example uses NEWID() to assign a value to a variable declared as the uniqueidentifier data type. O valor da variável de tipo de dados uniqueidentifier é impresso antes de o valor ser testado.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)  

Aqui está o conjunto de resultados.Here is the result set.

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

Observação

O valor retornado por NEWID é diferente para cada computador.The value returned by NEWID is different for each computer. O número mostrado é meramente ilustrativo.This number is shown only for illustration.

B.B. Usando NEWID em uma instrução CREATE TABLEUsing NEWID in a CREATE TABLE statement

Aplica-se a: SQL ServerSQL ServerApplies to: SQL ServerSQL Server

O exemplo a seguir cria a tabela cust com um tipo de dados uniqueidentifier e usa NEWID para preenchê-la com um valor padrão.The following example creates the cust table with a uniqueidentifier data type, and uses NEWID to fill the table with a default value. Ao atribuir o valor padrão de NEWID(), cada linha existente e nova possui um valor exclusivo para a coluna 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. Usando uniqueidentifier e atribuição de variávelUsing uniqueidentifier and variable assignment

O exemplo a seguir declara uma variável local chamada @myid como uma variável do tipo de dados uniqueidentifier.The following example declares a local variable called @myid as a variable of uniqueidentifier data type. Em seguida, é atribuído um valor à variável usando-se a instrução 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  

Consulte TambémSee Also

NEWSEQUENTIALID (Transact-SQL) NEWSEQUENTIALID (Transact-SQL)
ALTER TABLE (Transact-SQL) ALTER TABLE (Transact-SQL)
CAST e CONVERT (Transact-SQL) CAST and CONVERT (Transact-SQL)
CREATE TABLE (Transact-SQL) CREATE TABLE (Transact-SQL)
Tipos de dados (Transact-SQL) Data Types (Transact-SQL)
Funções de sistema (Transact-SQL) System Functions (Transact-SQL)
uniqueidentifier (Transact-SQL) uniqueidentifier (Transact-SQL)
Números de sequênciaSequence Numbers