Share via

  • Article

Méthode DetachDatabase (String, Boolean, Boolean)

Détache la base de données spécifiée de l'instance de SQL Server avec l'option de mise à jour des statistiques avant que la base de données ne soit détachée.

Espace de noms :  Microsoft.SqlServer.Management.Smo
Assembly :  Microsoft.SqlServer.Smo (en Microsoft.SqlServer.Smo.dll)

Syntaxe

'Déclaration
Public Sub DetachDatabase ( _
    databaseName As String, _
    updateStatistics As Boolean, _
    removeFulltextIndexFile As Boolean _
)
'Utilisation
Dim instance As Server
Dim databaseName As String
Dim updateStatistics As Boolean
Dim removeFulltextIndexFile As Boolean

instance.DetachDatabase(databaseName, _
    updateStatistics, removeFulltextIndexFile)

public void DetachDatabase(
    string databaseName,
    bool updateStatistics,
    bool removeFulltextIndexFile
)

public:
void DetachDatabase(
    String^ databaseName, 
    bool updateStatistics, 
    bool removeFulltextIndexFile
)

member DetachDatabase : 
        databaseName:string * 
        updateStatistics:bool * 
        removeFulltextIndexFile:bool -> unit 

public function DetachDatabase(
    databaseName : String, 
    updateStatistics : boolean, 
    removeFulltextIndexFile : boolean
)

Paramètres

  • updateStatistics
    Type : System. . :: . .Boolean
    Valeur Boolean qui spécifie s'il faut mettre à jour les statistiques pour la base de données avant de la détacher.
    Si la valeur est True, les statistiques sont mises à jour.
    Si la valeur est False, elles ne le sont pas.
  • removeFulltextIndexFile
    Type : System. . :: . .Boolean
    Valeur Boolean qui spécifie s'il faut supprimer un fichier d'index de recherche en texte intégral avant de détacher la base de données.
    Si la valeur est True, le fichier d'index de recherche en texte intégral est supprimé.
    Si la valeur est False, il ne l'est pas.

Notes

The data and transaction log files of a database can be detached and then reattached to the same or another instance of SQL Server. Detaching and attaching a database is useful if you want to change the database to a different instance of SQL Server on the same computer, or if you want to move the database.

Exemples

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("AdventureWorks2008R2").Owner

'Detach the AdventureWorks2008R2 database.
srv.DetachDatabase("AdventureWorks2008R2", 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\AdventureWorks2008R2_Data.mdf"
Logstr = "C:\Program Files\Microsoft SQL Server"
Logstr = datastr + "\MSSQL10_50\MSSQL\Data\AdventureWorks2008R2_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("AdventureWorks2008R2", 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("AdventureWorks2008R2")
$owner = $db.Owner
$srv.DetachDatabase("AdventureWorks2008R2", $FALSE, $FALSE)
$datastr = "C:\Program Files\Microsoft SQL Server"
$datastr = $datastr + "\MSSQL10_50\MSSQL\Data\AdventureWorks2008R2_Data.mdf"
$logstr = "C:\Program Files\Microsoft SQL Server"
$logstr = $logstr + "\MSSQL10_50\MSSQL\Data\AdventureWorks2008R2_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("AdventureWorks2008R2", $sc, $owner, [Microsoft.SqlServer.Management.Smo.AttachOptions]::None)