sp_attach_db (Transact-SQL)

適用対象:SQL Server

データベースをサーバーにアタッチします。

不明なソースまたは信頼されていないソースからデータベースをアタッチまたは復元しないでください。 こうしたデータベースには、意図しない Transact-SQL コードを実行したり、スキーマまたは物理データベース構造を変更してエラーを発生させるような、悪意のあるコードが含まれている可能性があります。 不明または信頼できないソースのデータベースを使用する前に、運用サーバー以外のサーバーでそのデータベースに対し DBCC CHECKDB を実行し、さらに、そのデータベースのストアド プロシージャやその他のユーザー定義コードなどのコードを調べます。

構文

sp_attach_db
    [ @dbname = ] N'dbname'
    , [ { @filename1 ... @filename16 } = ] { N'*filename1*' ... N'*filename16*' }
[ ; ]

引数

[ @dbname = ] N'dbname'

サーバーに接続するデータベースの名前。 @dbnameは sysname で、既定値はありません。

[ { @filename1 ... @filename16 } = ] { N'filename1' ...N'filename16' }

データベース ファイルの物理名 (パスを含む)。 このパラメーターは nvarchar(260) で、既定値は NULL. 最大 16 個のファイル名を指定できます。 パラメーター名は@filename1から始まり、@filename16にインクリメントされます。 ファイル名の一覧には、少なくともプライマリ ファイル (.mdf) が含まれている必要があります。 プライマリ ファイルには、データベース内の他のファイルを指すシステム テーブルが含まれています。 一覧には、データベースのデタッチ後に移動されたファイルも含める必要があります。

このパラメーターは、ステートメントの FILENAME パラメーターに CREATE DATABASE マップされます。 詳細については、[CREATE DATABASE](/sql/t-sql/statements/create-database-sql-server-transact-sql) に関する記事をご覧ください。

リターン コードの値

0 (成功) または 1 (失敗)。

結果セット

ありません。

解説

ストアド プロシージャは sp_attach_db 、明示的 sp_detach_db な操作またはコピーされたデータベースを使用して、以前にデータベース サーバーからデタッチされたデータベースでのみ実行する必要があります。 16 個を超えるファイルを指定する必要がある場合は、CREATE DATABASE <database_name> FOR ATTACHCREATE DATABASE <database_name> FOR_ATTACH_REBUILD_LOG 詳細については、[CREATE DATABASE](/sql/t-sql/statements/create-database-sql-server-transact-sql) に関する記事をご覧ください。

指定されていないファイルは、最後の既知の場所にあると見なされます。 異なる場所にあるファイルを使用するには、新しい場所を指定する必要があります。

より新しいバージョンの SQL Server によって作成されたデータベースは、以前のバージョンではアタッチできません。

デタッチされずにコピーされたレプリケートされたデータベースをアタッチする場合は、次の条件を考慮してください。

• データベースを元のデータベースと同じサーバー インスタンスとバージョンにアタッチする場合、それ以上の手順は必要ありません。

• 同じサーバー インスタンスのアップグレードされたバージョンにデータベースをアタッチする場合は、アタッチ操作が完了した後、sp_vupgrade_replication を実行してレプリケーションをアップグレードする必要があります。

• バージョンに関係なく、別のサーバー インスタンスにデータベースをアタッチする場合は、アタッチ操作が完了した後、sp_removedbreplication を実行してレプリケーションを削除する必要があります。

データベースが SQL Server の新しいインスタンスに最初にアタッチまたは復元されるとき、サービス マスター キー (SMK) によって暗号化されたデータベース マスター キー (DMK) のコピーはまだサーバーに格納されません。 DMK の暗号化を解除するには、 OPEN MASTER KEY ステートメントを使用する必要があります。 DMK の暗号化が解除されたら、ステートメントを使用して ALTER MASTER KEY REGENERATE 、SMK で暗号化された DMK のコピーをサーバーに提供することで、将来的に自動復号化を有効にできます。 データベースを以前のバージョンからアップグレードする場合は、新しい AES アルゴリズムを使用するために DMK を再生成する必要があります。 DMK を再作成する方法については、「ALTER MASTER KEY (Transact-SQL)」を参照してください。 DMK キーを再作成して AES にアップグレードするのに必要な時間は、DMK によって保護されているオブジェクトの数によって異なります。 AES にアップグレードするために DMK キーを再生成する必要があるのは 1 回だけであり、キー ローテーション戦略の一環として将来の再生成には影響しません。

アクセス許可

データベースがアタッチされるときにアクセス許可がどのように処理されるかについては、「CREATE DATABA Standard Edition」を参照してください。

例

次の例では、ファイル AdventureWorks2022 を現在のサーバーにアタッチします。

EXEC sp_attach_db @dbname = N'AdventureWorks2022',
    @filename1 =
N'C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\Data\AdventureWorks2022_Data.mdf',
    @filename2 =
N'C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\Data\AdventureWorks2022_log.ldf';

関連するコンテンツ

• データベースのデタッチとアタッチ (SQL Server)
• sp_detach_db (Transact-SQL)
• sp_helpfile (Transact-SQL)
• sp_removedbreplication (Transact-SQL)
• システム ストアド プロシージャ (Transact-SQL)