SELECT - INTO 句 (Transact-SQL)
適用対象: SQL Server
Azure SQL Database
Azure SQL Managed Instance
Azure Synapse Analytics
Analytics Platform System (PDW)
Microsoft Fabric のウェアハウス
SELECT...INTO は、既定のファイル グループに新しいテーブルを作成し、クエリの結果得られた行をそのテーブルに挿入します。 SELECT の完全な構文を確認するには、「SELECT (Transact-SQL)」を参照してください。
構文
[ INTO new_table ]
[ ON filegroup ]
Note
SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。
引数
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)