Création de scripts
L'écriture de scripts dans SMO est contrôlée par l'objet Scripter et ses objets enfants ou par la méthode Script sur des objets individuels. L'objet Scripter contrôle le mappage en dehors des relations d'interdépendance pour les objets sur une instance de MicrosoftSQL Server.
L'écriture de scripts avancés à l'aide de l'objet Scripter et ses objets enfants est un processus en trois phases :
Découverte
Génération de la liste
Génération du script
La phase de découverte utilise l'objet DependencyWalker. À partir d'une liste URN d'objets, la méthode DiscoverDependencies de l'objet DependencyWalker retourne un objet DependencyTree pour les objets de la liste URN. Le paramètre booléen fParents est utilisé pour indiquer si les parents ou les enfants de l'objet spécifié doivent être découverts. L'arborescence des dépendances peut être modifiée à ce stade.
Dans la phase de la génération de la liste, l'arborescence est transmise et la liste résultante est retournée. Cette liste d'objets suit l'ordre d'écriture du script et peut être manipulée.
Les phases de génération de la liste utilisent la méthode WalkDependencies pour retourner un objet DependencyTree. L'objet DependencyTree peut être modifié à ce stade.
Au cours de la troisième et dernière phase, un script est généré à l'aide de la liste et des options spécifiées. Le résultat est retourné sous la forme d'un objet système StringCollection. Au cours de cette phase, les noms des objets dépendants sont extraits de la collection Items des objets et propriétés DependencyTree, comme NumberOfSiblings et FirstChild.
Exemple
Pour utiliser un exemple de code fourni, vous devez sélectionner l'environnement, le modèle et le langage de programmation à utiliser pour créer votre application. Pour plus d'informations, consultez Procédure : créer un projet SMO Visual Basic dans Visual Studio .NET ou Procédure : créer un projet SMO Visual C# dans Visual Studio .NET.
Cet exemple de code requiert une instruction Imports pour l'espace de noms System.Collections.Specialized. Insérez-la avec les autres instructions Imports, avant toute autre déclaration dans l'application.
Imports Microsoft.SqlServer.Management.Smo
Imports Microsoft.SqlServer.Management.Common
Imports System.Collections.Specialized
Écriture sous forme de scripts des dépendances pour une base de données en Visual Basic
Cet exemple de code montre comment découvrir les dépendances et parcourir la liste pour afficher les résultats.
'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Reference the AdventureWorks database.
Dim db As Database
db = srv.Databases("AdventureWorks")
'Define a Scripter object and set the required scripting options.
Dim scrp As Scripter
scrp = New Scripter(srv)
scrp.Options.ScriptDrops = False
scrp.Options.WithDependencies = True
'Iterate through the tables in database and script each one. Display the script.
'Note that the StringCollection type needs the System.Collections.Specialized namespace to be included.
Dim tb As Table
Dim smoObjects(1) As Urn
For Each tb In db.Tables
smoObjects = New Urn(0) {}
smoObjects(0) = tb.Urn
If tb.IsSystemObject = False Then
Dim sc As StringCollection
sc = scrp.Script(smoObjects)
Dim st As String
For Each st In sc
Console.WriteLine(st)
Next
End If
Next
Écriture sous forme de scripts des dépendances pour une base de données en Visual C#
Cet exemple de code montre comment découvrir les dépendances et parcourir la liste pour afficher les résultats.
//Connect to the local, default instance of SQL Server.
{
Server srv = default(Server);
srv = new Server();
//Reference the AdventureWorks database.
Database db = default(Database);
db = srv.Databases("AdventureWorks");
//Define a Scripter object and set the required scripting options.
Scripter scrp = default(Scripter);
scrp = new Scripter(srv);
scrp.Options.ScriptDrops = false;
scrp.Options.WithDependencies = true;
//Iterate through the tables in database and script each one. Display the script.
//Note that the StringCollection type needs the System.Collections.Specialized namespace to be included.
Table tb = default(Table);
Urn[] smoObjects = new Urn[2];
foreach ( tb in db.Tables) {
smoObjects = new Urn[1];
smoObjects(0) = tb.Urn;
if (tb.IsSystemObject == false) {
StringCollection sc = default(StringCollection);
sc = scrp.Script(smoObjects);
string st = null;
foreach ( st in sc) {
Console.WriteLine(st);
}
}
}
}