Scripting

platí pro:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analyticssql database v Microsoft Fabric

Skriptování v SMO je řízeno Scripter objektem a jeho podřízenými objekty, nebo Script metoda pro jednotlivé objekty. Objekt Scripter řídí mapování relací závislostí pro objekty na instanci Microsoft SQL Serveru.

Pokročilé skriptování pomocí objektu Scripter a jeho podřízených objektů je třífázový proces:

1. Discovery

2. Generování seznamů

3. Generování skriptů

Fáze zjišťování používá DependencyWalker objekt. Vzhledem k seznamu objektů DiscoverDependencies URN vrátí metoda DependencyWalker objektu DependencyTree objekt pro objekty v seznamu URN. Logický parametr fParents slouží k výběru toho, zda mají být zjištěny nadřazené objekty nebo podřízené položky zadaného objektu. Strom závislostí lze v této fázi upravit.

Ve fázi generování seznamu se strom předá a výsledný seznam se vrátí. Tento seznam objektů je v pořadí skriptování a lze s ním manipulovat.

Fáze generování seznamu používají metodu WalkDependenciesDependencyTreek vrácení . V této fázi je možné ho DependencyTree upravit.

Ve třetí a poslední fázi se vygeneruje skript se zadaným seznamem a možnostmi skriptování. Výsledek se vrátí jako StringCollection systémový objekt. V této fázi jsou závislé názvy objektů následně extrahovány z kolekce Items objektu DependencyTree a vlastností, jako NumberOfSiblingsFirstChilda .

Example

Pokud chcete použít libovolný zadaný příklad kódu, budete muset zvolit programovací prostředí, programovací šablonu a programovací jazyk, ve kterém chcete vytvořit aplikaci. Další informace najdete v tématu Vytvoření projektu SMO visual C# v sadě Visual Studio .NET.

Tento příklad kódu vyžaduje příkaz Imports pro obor názvů System.Collections.Specialized. Vložte tento příkaz s ostatními příkazy Imports před jakékoli deklarace v aplikaci.

Imports Microsoft.SqlServer.Management.Smo  
Imports Microsoft.SqlServer.Management.Common  
Imports System.Collections.Specialized  

Skriptování závislostí pro databázi v jazyce Visual Basic

Tento příklad kódu ukazuje, jak zjistit závislosti a iterovat v seznamu, aby se zobrazily výsledky.

' compile with:   
' /r:Microsoft.SqlServer.Smo.dll   
' /r:Microsoft.SqlServer.ConnectionInfo.dll   
' /r:Microsoft.SqlServer.Management.Sdk.Sfc.dll   
  
Imports Microsoft.SqlServer.Management.Smo  
Imports Microsoft.SqlServer.Management.Sdk.Sfc  
  
Public Class A  
   Public Shared Sub Main()  
      ' database name  
      Dim dbName As [String] = "AdventureWorksLT2012"   ' database name  
  
      ' Connect to the local, default instance of SQL Server.   
      Dim srv As New Server()  
  
      ' Reference the database.    
      Dim db As Database = srv.Databases(dbName)  
  
      ' Define a Scripter object and set the required scripting options.   
      Dim scrp As New Scripter(srv)  
      scrp.Options.ScriptDrops = False  
      scrp.Options.WithDependencies = True  
      scrp.Options.Indexes = True   ' To include indexes  
      scrp.Options.DriAllConstraints = True   ' to include referential constraints in the script  
  
      ' Iterate through the tables in database and script each one. Display the script.  
      For Each tb As Table In db.Tables  
         ' check if the table is not a system table  
         If tb.IsSystemObject = False Then  
            Console.WriteLine("-- Scripting for table " + tb.Name)  
  
            ' Generating script for table tb  
            Dim sc As System.Collections.Specialized.StringCollection = scrp.Script(New Urn() {tb.Urn})  
            For Each st As String In sc  
               Console.WriteLine(st)  
            Next  
            Console.WriteLine("--")  
         End If  
      Next  
   End Sub  
End Class  

Skriptování závislostí pro databázi v jazyce Visual C#

Tento příklad kódu ukazuje, jak zjistit závislosti a iterovat v seznamu, aby se zobrazily výsledky.

// compile with:   
// /r:Microsoft.SqlServer.Smo.dll   
// /r:Microsoft.SqlServer.ConnectionInfo.dll   
// /r:Microsoft.SqlServer.Management.Sdk.Sfc.dll   
  
using System;  
using Microsoft.SqlServer.Management.Smo;  
using Microsoft.SqlServer.Management.Sdk.Sfc;  
  
public class A {  
   public static void Main() {   
      String dbName = "AdventureWorksLT2012"; // database name  
  
      // Connect to the local, default instance of SQL Server.   
      Server srv = new Server();  
  
      // Reference the database.    
      Database db = srv.Databases[dbName];  
  
      // Define a Scripter object and set the required scripting options.   
      Scripter scrp = new Scripter(srv);  
      scrp.Options.ScriptDrops = false;  
      scrp.Options.WithDependencies = true;  
      scrp.Options.Indexes = true;   // To include indexes  
      scrp.Options.DriAllConstraints = true;   // to include referential constraints in the script  
  
      // Iterate through the tables in database and script each one. Display the script.     
      foreach (Table tb in db.Tables) {   
         // check if the table is not a system table  
         if (tb.IsSystemObject == false) {  
            Console.WriteLine("-- Scripting for table " + tb.Name);  
  
            // Generating script for table tb  
            System.Collections.Specialized.StringCollection sc = scrp.Script(new Urn[]{tb.Urn});  
            foreach (string st in sc) {  
               Console.WriteLine(st);  
            }  
            Console.WriteLine("--");  
         }  
      }   
   }  
}  

Skriptování závislostí pro databázi v PowerShellu

Tento příklad kódu ukazuje, jak zjistit závislosti a iterovat v seznamu, aby se zobrazily výsledky.

# Set the path context to the local, default instance of SQL Server.  
CD \sql\localhost\default  
  
# Create a Scripter object and set the required scripting options.  
$scrp = New-Object -TypeName Microsoft.SqlServer.Management.SMO.Scripter -ArgumentList (Get-Item .)  
$scrp.Options.ScriptDrops = $false  
$scrp.Options.WithDependencies = $true  
$scrp.Options.IncludeIfNotExists = $true  
  
# Set the path context to the tables in AdventureWorks2022.  
  
CD Databases\AdventureWorks2022\Tables  
  
foreach ($Item in Get-ChildItem)  
 {    
 $scrp.Script($Item)  
 }