Udostępnij przez


Metoda GenerateSQL (indeks)

Ta funkcja zostanie usunięta z przyszłej wersji programu Microsoft SQL Server. Należy unikać stosowania tej funkcji w nowych projektach oraz zaplanować modyfikację aplikacji, w których obecnie jest używana ta funkcja.

GenerateSQL Metoda zwraca ciąg zawierający partia języka Transact-SQL polecenia używany do tworzenia indeksu Microsoft SQL Server określone przez właściwości Index obiektu użytego.

Składnia

object
.GenerateSQL(
Table
)
as
String

Części

  • obiekt
    Wyrażenie, którego wartością obiekt na liście dotyczy.

  • Tabela
    Wyrażenie, którego wynikiem SQL Distributed Management Objects (SQL-DMO) Table obiektu.

Prototyp (C/C++)

HRESULT GenerateSQL(
LPSQLDMOTABLE pTable,
SQLDMO_LPBSTR pRetVal);

Ostrzeżenie

SQL-DMO ciągi są zawsze zwracane jako obiekty OLE BSTR.Aplikacja c i C++ pobiera odwołanie do ciąg.Aplikacja musi zwolnić, przy użyciu odwołania SysFreeString.

Zwraca

Polecenia języka Transact-SQL partia jako ciąg.

Uwagi

Użyj GenerateSQL lub GenerateCreationSQL metoda tworzenia polecenia partia do użycia w innym procesie.For example, to define a new index, capture the command batch using the GenerateSQL or GenerateCreationSQLmethod, and then use the command batch to create a job step for scheduled index creation.

Dla Index obiekt, GenerateSQL i GenerateCreationSQL metody wykonywać podobne funkcje.Skrypt zwrócony przez GenerateSQL Metoda zawiera Transact-SQL instrukcji tworzenia indeksu.GenerateCreationSQL metoda prefiksy instrukcja tworzenia indeksu ze składnią języka Transact-SQL, który warunkowo usuwa istniejący indeks.

Aby użyć metoda GenerateSQL lub GenerateCreationSQL

  1. Utwórz nowy Index obiektu.

  2. Ustaw Name właściwość.

  3. Ustaw IndexedColumns właściwość; odwołanie kolumny w tabela miejsce docelowe według nazwy.

  4. Ustawić dodatkowe właściwości, które definiują takie jak indeks FileGroup i Type.

  5. Pobierz Table obiekt, który odwołuje się do tabela miejsce docelowe z Tables kolekcja.

  6. Wywołanie metoda, która generuje poleceń języka Transact-SQL partia, przechwytywanie zwrócony tekst.

    Ważna informacjaWażne:

    The GenerateSQL and GenerateCreationSQLmethods generate a Transact-SQL batch used to create an index.Metoda nie działa, jeśli Index obiektów używanych odwołania istniejącego indeksu programu SQL Server.Użyj Script metoda Index obiekt, aby utworzyć partia poleceń języka Transact-SQL definiujący istniejący indeks.

Stosuje się do: