Server.AttachDatabase メソッド (String, StringCollection, String)
1 つ以上のファイルで構成される既存のデータベースを、指定の名前で、指定のデータ ファイルを使用して、SQL Server のインスタンスにアタッチします。
名前空間: Microsoft.SqlServer.Management.Smo
アセンブリ: Microsoft.SqlServer.Smo (Microsoft.SqlServer.Smo.dll)
構文
'宣言
Public Sub AttachDatabase ( _
name As String, _
files As StringCollection, _
owner As String _
)
'使用
Dim instance As Server
Dim name As String
Dim files As StringCollection
Dim owner As String
instance.AttachDatabase(name, files, owner)
public void AttachDatabase(
string name,
StringCollection files,
string owner
)
public:
void AttachDatabase(
String^ name,
StringCollection^ files,
String^ owner
)
member AttachDatabase :
name:string *
files:StringCollection *
owner:string -> unit
public function AttachDatabase(
name : String,
files : StringCollection,
owner : String
)
パラメーター
- name
型: System.String
アタッチするデータベースの名前を示す String 値です。
- files
型: System.Collections.Specialized.StringCollection
データベース ファイルの一覧を含む StringCollection オブジェクトの値です。
- owner
型: System.String
データベースの新しい所有者を示す String 値です。
説明
データベースのデータ ファイルおよびトランザクション ログ ファイルを、いったんデタッチして、SQL Server の同一または別のインスタンスに再度アタッチすることができます。 同一のコンピューターにある別の SQL Server のインスタンスにデータベースを変更する場合や、データベースを移動する場合は、データベースをデタッチしてアタッチすると便利です。
このオーバーロードを使用して、データベースをアタッチした後、その所有者を指定します。
使用例
Visual Basic
'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
Dim owner As String
Dim logstr as String
Dim datastr as String
owner = srv.Databases("AdventureWorks2012").Owner
'Detach the AdventureWorks2012 database.
srv.DetachDatabase("AdventureWorks2012", False, False)
'Display information about the detached database.
Dim d As DataTable
Datastr = "C:\Program Files\Microsoft SQL Server"
Datastr = datastr + "\MSSQL10_50\MSSQL\Data\AdventureWorks2012_Data.mdf"
Logstr = "C:\Program Files\Microsoft SQL Server"
Logstr = datastr + "\MSSQL10_50\MSSQL\Data\AdventureWorks2012_Log.ldf"
d = srv.DetachedDatabaseInfo(datastr)
Dim r As DataRow
Dim c As DataColumn
For Each r In d.Rows
Console.WriteLine("==========================")
For Each c In r.Table.Columns
Console.WriteLine(c.ColumnName + " = " + r[c].ToString)
Next
Next
'Check whether the file is a detached primary file.
Console.WriteLine(srv.IsDetachedPrimaryFile(datastr))
'Attach the database
Dim sc As StringCollection
sc = New StringCollection
sc.Add(datastr)
sc.Add(logstr)
srv.AttachDatabase("AdventureWorks2012", sc, owner, AttachOptions.None)
PowerShell
$srv = new-object Microsoft.SqlServer.Management.Smo.Server("(local)")
$db = New-Object Microsoft.SqlServer.Management.Smo.Database
$db = $srv.Databases.Item("AdventureWorks2012")
$owner = $db.Owner
$srv.DetachDatabase("AdventureWorks2012", $FALSE, $FALSE)
$datastr = "C:\Program Files\Microsoft SQL Server"
$datastr = $datastr + "\MSSQL10_50\MSSQL\Data\AdventureWorks2012_Data.mdf"
$logstr = "C:\Program Files\Microsoft SQL Server"
$logstr = $logstr + "\MSSQL10_50\MSSQL\Data\AdventureWorks2012_Log.ldf"
$d = $srv.DetachedDatabaseInfo($datastr)
foreach ($r in $d.Rows)
{
Write-Host "=========================="
Foreach ($c in $d.Columns)
{
Write-Host $c.ColumnName "=" $r[$c].ToString()
}
}
Write-Host $srv.IsDetachedPrimaryFile($datastr)
$sc = new-object Systems.Collections.Specialized.StringCollection
$sc.Add($datastr)
$sc.Add($logstr)
$srv.AttachDatabase("AdventureWorks2012", $sc, $owner, [Microsoft.SqlServer.Management.Smo.AttachOptions]::None)
関連項目
参照
Microsoft.SqlServer.Management.Smo 名前空間