SELECT - INTO 句 (Transact-SQL)

[アーティクル]
05/23/2023

適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) Microsoft Fabric のハードウェア SQL データベース

SELECT...INTO は、既定のファイルグループに新しいテーブルを作成し、クエリの結果得られた行をそのテーブルに挿入します。 SELECT の完全な構文を確認するには、「SELECT (Transact-SQL)」を参照してください。

Transact-SQL 構文表記規則

構文

[ INTO new_table ]
[ ON filegroup ]

引数

new_table
新しいテーブルの名前を指定します。このテーブルは選択リストで指定した列とデータソースから選択された行を基に作成されます。

new_table の形式は、選択リスト内の式を評価することによって決まります。 new_table 内の列は、選択リストの指定順に作成されます。 new_table 内の各列の名前、データ型、NULL 値の許容属性、値は、選択リスト内の対応する式と同じになります。列の IDENTITY プロパティは、[解説] の "ID 列の使用" に示されている条件に当てはまる場合を除いて転送されます。

同じ SQL Server インスタンスの別のデータベースにテーブルを作成するには、new_table を database.schema.table_name の形式で完全修飾名として指定します。

リモートサーバーに new_table を作成することはできませんが、new_table にリモートデータソースのデータを設定することはできます。リモートソーステーブルから new_table を作成するには、SELECT ステートメントの FROM 句で、linked_server.catalog.schema.object という形式の 4 部構成の名前を使用してソーステーブルを指定します。 FROM 句で OPENQUERY 関数か OPENDATASOURCE 関数を使用してリモートデータソースを指定することもできます。

filegroup
新しいテーブルを作成するファイルグループの名前を指定します。指定されたファイルグループがデータベースに存在する必要があります。存在しない場合は、SQL Server エンジンからエラーがスローされます。

適用対象: SQL Server 2016 (13.x) SP2 以降。

データ型

FILESTREAM 属性は新しいテーブルに転送されません。 FILESTREAM BLOB がコピーされ、varbinary(max) BLOB として新しいテーブルに格納されます。 FILESTREAM 属性がない場合、varbinary(max) データ型は 2 GB までに制限されます。 FILESTREAM BLOB がこの値を超えると、エラー 7119 が発生して、ステートメントが中止されます。

既存の ID 列が新しいテーブルに選択された場合は、次の条件のいずれかが満たされている場合を除き、新しい列には IDENTITY プロパティが継承されます。

SELECT ステートメントに結合が含まれています。
複数の SELECT ステートメントが UNION を使用して結合されている。
ID 列が選択リストに 2 回以上指定されている。
ID 列が式の一部である。
ID 列がリモートデータソースから取得されている。

これらの条件が 1 つでも満たされている場合は、列に IDENTITY プロパティは継承されず、代わりに NOT NULL として作成されます。新しいテーブルに ID 列が必要であるものの使用できる列がない場合や、ソースの ID 列とは異なるシード値や増分値が必要な場合は、選択リストで IDENTITY 関数を使用してその列を定義します。以下の「例」の「IDENTITY 関数を使用して ID 列を作成する」を参照してください。

解説

SELECT...INTO ステートメントによる操作は 2 つの部分からなります。新しいテーブルが作成され、それから行が挿入されます。つまり、挿入できない場合、すべてロールバックされますが、新しい (空の) テーブルは残ります。操作が全体として成功または失敗した場合、明示的なトランザクションを使用します。

Microsoft Fabric のウェアハウスでは、ファイルグループはサポートされていません。この記事でのファイルグループに関する記述と例は、Microsoft Fabric のウェアハウスには適用されません。

制限事項と制約事項

テーブル変数やテーブル値パラメーターを新しいテーブルとして指定することはできません。

ソーステーブルがパーティション分割されている場合でも、SELECT...INTO を使用してパーティションテーブルを作成することはできません。 SELECT...INTO では、ソーステーブルのパーティション構成が使用されず、新しいテーブルが既定のファイルグループに作成されます。パーティションテーブルに行を挿入するには、まずパーティションテーブルを作成してから INSERT INTO...SELECT...FROM ステートメントを使用する必要があります。

ソーステーブルに定義されているインデックス、制約、およびトリガーは、新しいテーブルに転送されません。SELECT...INTO ステートメントで指定することもできません。これらのオブジェクトが必要な場合は、SELECT...INTO ステートメントの実行後に作成できます。

ORDER BY 句を指定しても、行が指定した順序どおりに挿入されるかどうかは保証されません。

選択リストにスパース列が含まれている場合、新しいテーブルの列にスパース列のプロパティは転送されません。新しいテーブルでこのプロパティが必要な場合は、SELECT...INTO ステートメントの実行後に列の定義を変更してプロパティを追加してください。

リストに計算列が指定されている場合、新しいテーブル内の対応する列は計算列にはなりません。新しい列の値は、SELECT...INTO が実行された時点の計算値になります。

ログ記録の動作

SELECT...INTO のログ記録量は、データベースに対して有効な復旧モデルによって異なります。単純復旧モデルまたは一括ログ復旧モデルでは、一括操作は最小限しかログに記録されません。最小ログ記録を使用する場合は、テーブルを作成してから INSERT ステートメントでそのテーブルにデータを設定するより、SELECT...INTO ステートメントを使用する方が効率的である可能性があります。詳細については、「トランザクションログ (SQL Server)」を参照してください。

SELECT...INTO ユーザー定義関数 (UDF) を含むステートメントは、完全なログが記録される操作です。 SELECT...INTO ステートメントで使用されているユーザー定義関数でデータアクセス操作が実行されない場合は、そのユーザー定義関数に SCHEMABINDING 句を指定できます。これにより、ユーザー定義関数の派生 UserDataAccess プロパティが 0 に設定されます。この変更後は、SELECT...INTO ステートメントで最小限のログが記録されます。 SELECT...INTO ステートメントで引き続き、このプロパティが 1 に設定されているユーザー定義関数が少なくとも 1 つ参照されている場合は、操作の完全なログが記録されます。

アクセス許可

データベースの CREATE TABLE 権限と、テーブルを作成するスキーマの ALTER 権限が必要です。

例

A. 複数のソースの列を指定してテーブルを作成する

次の例では、各種の従業員関連テーブルと住所関連テーブルから 7 つの列を選んで、AdventureWorks2022 データベースにテーブル dbo.EmployeeAddresses を作成します。

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. 最小ログ記録を使用して行を挿入する

次の例では、テーブル dbo.NewProducts を作成し、Production.Product テーブルの行を挿入します。この例では、AdventureWorks2022 データベースの復旧モデルが FULL に設定されていると想定しています。したがって、最小限のログが使われるようにするために、行を挿入する前に AdventureWorks2022 データベースの復旧モデルを BULK_LOGGED に設定し、SELECT...INTO ステートメントの後に FULL に戻しています。これにより、SELECT...INTO ステートメントが使用するトランザクションログの領域が最小化され、ステートメントが効率的に実行されるようになります。

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. IDENTITY 関数を使用して ID 列を作成する

次の例では、IDENTITY 関数を使って、AdventureWorks2022 データベースの新しいテーブル Person.USAddress に ID 列を作成します。この操作が必要になるのは、テーブルを定義する SELECT ステートメントに結合が含まれているため、IDENTITY プロパティが新しいテーブルに転送されないからです。 IDENTITY 関数で、ソーステーブル AddressID の 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. リモートデータソースの列を指定してテーブルを作成する

次の例は、ローカルサーバーで新しいテーブルをリモートデータソースから作成するための 3 つの方法を示しています。最初にリモートデータソースへのリンクを作成した後、リンクサーバー名の MyLinkServer, を、1 つ目の SELECT...INTO ステートメントの FROM 句と、2 つ目の SELECT...INTO ステートメントの OPENQUERY 関数に指定しています。 3 つ目の SELECT...INTO ステートメントでは、OPENDATASOURCE 関数を使用して、リンクサーバー名を使用する代わりに直接リモートデータソースを指定しています。

適用対象: SQL Server 2008 (10.0.x) 以降。

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. PolyBase で作成された外部テーブルをインポートする

Hadoop または Azure ストレージからデータを永続的なストレージの SQL Server にインポートします。 SELECT INTO を使用して、SQL Server の永続記憶装置に、外部テーブルで参照されるデータをインポートします。リレーショナルテーブルにその場を作成し、2 番目の手順で、テーブルの上に列ストアインデックスを作成します。

適用対象: 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. あるテーブルから別のテーブルにデータをコピーし、指定したファイルグループに新しいテーブルを作成する

次の例は、新しいテーブルを別のテーブルのコピーとして作成し、ユーザーの既定のファイルグループとは異なる、指定したファイルグループに読み込む方法を示しています。

適用対象: SQL Server 2016 (13.x) SP2 以降。

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];

参照

SELECT (Transact-SQL)
SELECT の例 (Transact-SQL)
INSERT (Transact-SQL)
IDENTITY (関数) (Transact-SQL)

次の方法で共有

SELECT - INTO 句 (Transact-SQL)

構文

引数

データ型

解説

制限事項と制約事項

ログ記録の動作

アクセス許可

例

A. 複数のソースの列を指定してテーブルを作成する

B. 最小ログ記録を使用して行を挿入する

C. IDENTITY 関数を使用して ID 列を作成する

D. リモートデータソースの列を指定してテーブルを作成する

E. PolyBase で作成された外部テーブルをインポートする

F. あるテーブルから別のテーブルにデータをコピーし、指定したファイルグループに新しいテーブルを作成する

参照

フィードバック

その他のリソース

次の方法で共有

SELECT - INTO 句 (Transact-SQL)

構文

引数

データ型

解説

制限事項と制約事項

ログ記録の動作

アクセス許可

例

A. 複数のソースの列を指定してテーブルを作成する

B. 最小ログ記録を使用して行を挿入する

C. IDENTITY 関数を使用して ID 列を作成する

D. リモート データ ソースの列を指定してテーブルを作成する

E. PolyBase で作成された外部テーブルをインポートする

F. あるテーブルから別のテーブルにデータをコピーし、指定したファイルグループに新しいテーブルを作成する

参照

フィードバック

その他のリソース

D. リモートデータソースの列を指定してテーブルを作成する