SELECT – Cláusula INTO (Transact-SQL)

Artigo
10/16/2024

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Warehouse do PDW (Analytics Platform System) no Microsoft Fabric

SELECT…INTO cria uma tabela no grupo de arquivos padrão e insere nela as linhas resultantes da consulta. Para exibir a sintaxe completa de SELECT, confira SELECT (Transact-SQL).

Convenções de sintaxe de Transact-SQL

Sintaxe

[ INTO new_table ]
[ ON filegroup ]

Argumentos

new_table
Especifica o nome de uma nova tabela a ser criada com base nas colunas da lista de seleção e nas linhas escolhidas na origem dos dados.

O formato de new_table é determinado pela avaliação das expressões na lista de seleção. As colunas na new_table são criadas na ordem especificada pela lista de seleção. Cada coluna em new_table tem o mesmo nome, tipo de dados, nulidade e valor que a expressão correspondente na lista de seleção. A propriedade IDENTITY de uma coluna é transferida, exceto nas condições definidas em "Trabalhando com colunas de identidade", na seção Comentários.

Para criar a tabela em outro banco de dados na mesma instância do SQL Server, especifique new_table como um nome totalmente qualificado no formato database.schema.table_name.

Não é possível criar new_table em um servidor remoto. No entanto, você pode popular new_table de uma fonte de dados remota. Para criar new_table de uma tabela de origem remota, especifique a tabela de origem usando um nome de quatro partes no formato linked_server.catálogo.esquema.objeto na cláusula FROM da instrução SELECT. Como alternativa, é possível usar a função OPENQUERY ou a função OPENDATASOURCE na cláusula FROM para especificar a fonte de dados remota.

filegroup
Especifica o nome do grupo de arquivos no qual a nova tabela será criada. O grupo de arquivos especificado deverá existir no banco de dados, caso contrário, o mecanismo do SQL Server gerará um erro.

Aplica-se a: SQL Server 2016 (13.x) SP2 e posterior.

Tipos de dados

O atributo FILESTREAM não é transferido para a nova tabela. Os BLOBs do FILESTREAM são copiados e armazenados na nova tabela como BLOBs varbinary(max) . Sem o atributo FILESTREAM, o tipo de dados varbinary(max) tem uma limitação de 2 GB. Se um FILESTREAM BLOB exceder esse valor, ocorrerá o erro 7119, e a instrução será interrompida.

Quando uma coluna de identidade existente é seleciona para uma nova tabela, a nova coluna herda a propriedade IDENTITY, a menos que uma das seguintes condições seja verdadeira:

A instrução SELECT contém uma junção.
Várias instruções SELECT são unidas usando UNION.
A coluna de identidade é listada mais de uma vez na lista de seleção.
A coluna de identidade faz parte de uma expressão.
A coluna de identidade provém de uma fonte de dados remota.

Se alguma dessas condições for verdadeira, a coluna será criada como NOT NULL em vez de herdar a propriedade IDENTITY. Se uma coluna de identidade for obrigatória na nova tabela, mas não estiver disponível, ou se você desejar um valor de semente ou de incremento diferente da coluna de identidade de origem, defina a coluna na lista de seleção que usa a função IDENTITY. Consulte "Criando uma coluna de identidade usando a função IDENTITY" na seção Exemplos abaixo.

Comentários

A instrução SELECT...INTO opera em duas partes – a nova tabela é criada e, em seguida, as linhas são inseridas. Isso significa que, se as inserções falharem, elas serão todas revertidas, mas a nova tabela (vazia) permanecerá. Se você precisar que toda a operação tenha êxito ou falhe como um todo, use uma transação explícita.

O Warehouse no Microsoft Fabric não dá suporte a grupos de arquivos. Referências e exemplos neste artigo para grupos de arquivos não se aplicam ao Warehouse no Microsoft Fabric.

Limitações e Restrições

Não é possível especificar uma variável de tabela ou um parâmetro com valor de tabela como a nova tabela.

Você não pode usar SELECT...INTO para criar uma tabela particionada, mesmo quando a tabela de origem está particionada. SELECT...INTO não usa o esquema de partição da tabela de origem; em vez disso, a nova tabela é criada no grupo de arquivos padrão. Para inserir linhas em uma tabela particionada, crie primeiro a tabela particionada e depois use a instrução INSERT INTO...SELECT...FROM.

Índices, restrições e gatilhos definidos na tabela de origem não são transferidos para a nova tabela, nem podem ser especificados na instrução SELECT...INTO. Se esses objetos forem obrigatórios, você poderá criá-los depois de executar a instrução SELECT...INTO.

Especificar uma cláusula ORDER BY não garante que as linhas sejam inseridas na ordem especificada.

Quando uma coluna esparsa é incluída na lista de seleção, a propriedade da coluna esparsa não é transferida para a coluna na nova tabela. Se essa propriedade for necessária na nova tabela, altere a definição de coluna depois de executar a instrução SELECT... INTO para incluir essa propriedade.

Quando uma coluna computada é incluída na lista de seleção, a coluna correspondente na nova tabela não é uma coluna computada. Os valores na nova coluna são os que foram calculados no momento em que a SELECT...INTO foi executada.

Comportamento de log

A quantidade de registro em log para SELECT...INTO depende do modelo de recuperação em vigor para o banco de dados. Nos modelos de recuperação simples ou bulk-logged, as operações em massa são registradas minimamente. Com o log mínimo, usar a instrução SELECT...INTO pode ser mais eficiente do que criar uma tabela e então preenchê-la usando uma instrução INSERT. Para obter mais informações, confira O log de transações (SQL Server).

As instruções SELECT...INTO que contêm UDFs (funções definidas pelo usuário) são operações totalmente registradas em log. Caso as funções definidas pelo usuário usadas na instrução SELECT...INTO não executem nenhuma operação de acesso a dados, será possível especificar a cláusula SCHEMABINDING para as funções definidas pelo usuário. Elas definirão a propriedade derivada UserDataAccess como 0 para essas funções definidas pelo usuário. Após essa alteração, as instruções SELECT...INTO serão minimamente registradas em log. Caso a instrução SELECT...INTO ainda referencie ao menos uma função definida pelo usuário que tenha essa propriedade definida como 1, a operação será totalmente registrada em log.

Permissões

Requer a permissão CREATE TABLE no banco de dados e a permissão ALTER no esquema no qual a tabela está sendo criada.

Exemplos

a. Criando uma tabela especificando colunas de várias origens

O exemplo a seguir cria a tabela dbo.EmployeeAddresses no banco de dados AdventureWorks2022 selecionando sete colunas de várias tabelas relacionadas a funcionários e endereços.

SELECT c.FirstName, c.LastName, e.JobTitle, a.AddressLine1, a.City,   
    sp.Name AS [State/Province], a.PostalCode  
INTO dbo.EmployeeAddresses  
FROM Person.Person AS c  
    JOIN HumanResources.Employee AS e   
    ON e.BusinessEntityID = c.BusinessEntityID  
    JOIN Person.BusinessEntityAddress AS bea  
    ON e.BusinessEntityID = bea.BusinessEntityID  
    JOIN Person.Address AS a  
    ON bea.AddressID = a.AddressID  
    JOIN Person.StateProvince as sp   
    ON sp.StateProvinceID = a.StateProvinceID;  
GO

B. Inserindo linhas usando log mínimo

O exemplo a seguir cria a tabela dbo.NewProducts e insere linhas da tabela Production.Product. O exemplo pressupõe que o modelo de recuperação do banco de dados AdventureWorks2022 esteja definido como FULL. Para assegurar um log mínimo, o modelo de recuperação do banco de dados AdventureWorks2022 é definido como BULK_LOGGED antes da inserção das linhas e redefinido como FULL após a instrução SELECT...INTO. Esse processo garante que a instrução SELECT... INTO use um espaço mínimo no log de transações e seja executada de forma eficiente.

ALTER DATABASE AdventureWorks2022 SET RECOVERY BULK_LOGGED;  
GO  
  
SELECT * INTO dbo.NewProducts  
FROM Production.Product  
WHERE ListPrice > $25   
AND ListPrice < $100;  
GO  
ALTER DATABASE AdventureWorks2022 SET RECOVERY FULL;  
GO

C. Criando uma coluna de identidade usando a função IDENTITY

O exemplo a seguir usa a função IDENTITY para criar uma coluna de identidade na nova tabela Person.USAddress do banco de dados AdventureWorks2022. Isso é necessário porque a instrução SELECT que define a tabela contém uma junção; por isso, a propriedade IDENTITY não é transferida para a nova tabela. Observe que os valores de semente e incremento especificados na função IDENTITY são diferentes dos valores da coluna AddressID na tabela de origem Person.Address.

-- Determine the IDENTITY status of the source column AddressID.  
SELECT OBJECT_NAME(object_id) AS TableName, name AS column_name, 
  is_identity, seed_value, increment_value  
FROM sys.identity_columns  
WHERE name = 'AddressID';  
  
-- Create a new table with columns from the existing table Person.Address. 
-- A new IDENTITY column is created by using the IDENTITY function.  
SELECT IDENTITY (int, 100, 5) AS AddressID,   
       a.AddressLine1, a.City, b.Name AS State, a.PostalCode  
INTO Person.USAddress   
FROM Person.Address AS a  
INNER JOIN Person.StateProvince AS b 
  ON a.StateProvinceID = b.StateProvinceID  
WHERE b.CountryRegionCode = N'US';   
  
-- Verify the IDENTITY status of the AddressID columns in both tables.  
SELECT OBJECT_NAME(object_id) AS TableName, name AS column_name, 
  is_identity, seed_value, increment_value  
FROM sys.identity_columns  
WHERE name = 'AddressID';

D. Criando uma tabela especificando colunas de uma fonte de dados remotos

O seguinte exemplo demonstra três métodos para criar uma nova tabela no servidor local de uma fonte de dados remota. O exemplo começa criando um link para a fonte de dados remota. O nome do servidor vinculado, MyLinkServer,, é especificado na cláusula FROM da primeira instrução SELECT...INTO e na função OPENQUERY da segunda instrução SELECT...INTO. A terceira instrução SELECT... INTO usa a função OPENDATASOURCE, que especifica a fonte de dados remota diretamente, em vez de usar o nome de servidor vinculado.

Aplica-se a: SQL Server 2008 (10.0.x) e posterior.

USE master;  
GO  
-- Create a link to the remote data source.   
-- Specify a valid server name for @datasrc as 'server_name' 
-- or 'server_name\instance_name'.  
EXEC sp_addlinkedserver @server = N'MyLinkServer',  
    @srvproduct = N' ',  
    @provider = N'SQLNCLI',   
    @datasrc = N'server_name',  
    @catalog = N'AdventureWorks2022';  
GO  

USE AdventureWorks2022;  
GO  
-- Specify the remote data source in the FROM clause using a four-part name   
-- in the form linked_server.catalog.schema.object.  
SELECT DepartmentID, Name, GroupName, ModifiedDate  
INTO dbo.Departments  
FROM MyLinkServer.AdventureWorks2022.HumanResources.Department  
GO  
-- Use the OPENQUERY function to access the remote data source.  
SELECT DepartmentID, Name, GroupName, ModifiedDate  
INTO dbo.DepartmentsUsingOpenQuery  
FROM OPENQUERY(MyLinkServer, 'SELECT *  
               FROM AdventureWorks2022.HumanResources.Department');   
GO  
-- Use the OPENDATASOURCE function to specify the remote data source.  
-- Specify a valid server name for Data Source using the format 
-- server_name or server_name\instance_name.  
SELECT DepartmentID, Name, GroupName, ModifiedDate  
INTO dbo.DepartmentsUsingOpenDataSource  
FROM OPENDATASOURCE('SQLNCLI',  
    'Data Source=server_name;Integrated Security=SSPI')  
    .AdventureWorks2022.HumanResources.Department;  
GO

E. Importar de uma tabela externa criada com PolyBase

Importe dados do Hadoop ou armazenamento do Azure para SQL Server, para armazenamento persistente. Use SELECT INTO para importar os dados referenciados por uma tabela externa para o armazenamento persistente no SQL Server. Crie uma tabela relacional rapidamente e, em seguida, crie um índice de repositório de coluna sobre a tabela em uma segunda etapa.

Aplica-se a: SQL Server.

-- Import data for car drivers into SQL Server to do more in-depth analysis.  
SELECT DISTINCT   
        Insured_Customers.FirstName, Insured_Customers.LastName,   
        Insured_Customers.YearlyIncome, Insured_Customers.MaritalStatus  
INTO Fast_Customers from Insured_Customers INNER JOIN   
(  
        SELECT * FROM CarSensor_Data where Speed > 35   
) AS SensorD  
ON Insured_Customers.CustomerKey = SensorD.CustomerKey  
ORDER BY YearlyIncome;

F. Copiar os dados de uma tabela para outra e criar a tabela em questão em um grupo de arquivos especificado

O exemplo a seguir demonstra a criação de uma nova tabela como uma cópia de outra tabela e seu carregamento em um grupo de arquivos especificado diferente do grupo de arquivos padrão do usuário.

Aplica-se a: SQL Server 2016 (13.x) SP2 e posterior.

ALTER DATABASE [AdventureWorksDW2022] ADD FILEGROUP FG2;
ALTER DATABASE [AdventureWorksDW2022]
ADD FILE
(
NAME='FG2_Data',
FILENAME = '/var/opt/mssql/data/AdventureWorksDW2022_Data1.mdf'
)
TO FILEGROUP FG2;
GO
SELECT * INTO [dbo].[FactResellerSalesXL] ON FG2 FROM [dbo].[FactResellerSales];

Consulte Também

SELECT (Transact-SQL)
Exemplos de SELECT (Transact-SQL)
INSERT (Transact-SQL)
IDENTITY (função) (Transact-SQL)

Partilhar via

SELECT – Cláusula INTO (Transact-SQL)

Sintaxe

Argumentos

Tipos de dados

Comentários

Limitações e Restrições

Comportamento de log

Permissões

Exemplos

a. Criando uma tabela especificando colunas de várias origens

B. Inserindo linhas usando log mínimo

C. Criando uma coluna de identidade usando a função IDENTITY

D. Criando uma tabela especificando colunas de uma fonte de dados remotos

E. Importar de uma tabela externa criada com PolyBase

F. Copiar os dados de uma tabela para outra e criar a tabela em questão em um grupo de arquivos especificado

Consulte Também

Comentários

Recursos adicionais