Metoda ScriptTransfer
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.
ScriptTransfer Metoda generuje poleceń języka Transact-SQL partia , tworzy obiekty bazy danych zawartych w Transfer obiekt wskazany.
Składnia
object
.ScriptTransfer(
Transfer
, [ ScriptFileMode ] , [ ScriptFile ] )asString
Części
obiekt
Wyrażenie, którego wartością obiekt na liście dotyczy.Transfer
Transfer obiekt, który definiuje kopii danych i obiektów bazy danych.ScriptFileMode
Opcjonalne.Długa liczba całkowita, która zastępuje domyślne zachowanie wykonywanie skryptów, jak opisano w ustawieniach.Plik_skryptu
Opcjonalne.Ciąg określający ścieżka systemu operacyjnego lub pliku jako dodatkowego miejsce docelowe wygenerowane języka Transact-SQL można script(s) w opisanym w ustawieniach.
Prototyp (C/C++)
HRESULT ScriptTransfer(
LPSQLDMOTRANSFER TransferSpec,
SQLDMO_XFRSCRIPTMODE_TYPE ScriptFileMode = SQLDMOXfrFile_Default,
SQLDMO_LPCSTR ScriptFilePath = NULL,
SQLDMO_LPBSTR ScriptText = NULL);
Ostrzeżenie
Ciągi znaków SQL Distributed Management Objects (SQL-DMO) 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.
Ustawienia
Ustawienie ScriptFileMode argument dotyczy interpretacji plik_skryptu argumentu.Podczas ustawiania ScriptFileMode, wartości te ustawienia za pomocą plik_skryptu zgodnie z opisem.
Stała |
Wartość |
Opis |
|---|---|---|
SQLDMOXfrFile_Default |
1 |
SQLDMOXfrFile_SummaryFiles. |
SQLDMOXfrFile_SingleFile |
2 |
Polecenia partia są zapisywane w jednym pliku.Określić nazwę pliku z plik_skryptu argumentu.Jeśli ścieżka nie jest uwzględniony w nazwie pliku, plik jest tworzony w katalogu wskazywany przez zmienną środowiskową TEMP dla klient komputera. |
SQLDMOXfrFile_ i SingleFilePerObject |
4 |
Polecenia partia są zapisywane do wielu plików jeden plik dla każdego składnik programu SQL Server przeniesione.Określ ścieżka za pomocą plik_skryptu argumentu.Jeżeli nie określono ścieżka, pliki są tworzone w katalogu wskazywany przez zmienną środowiskową TEMP dla klient komputera. |
SQLDMOXfrFile_ i SingleSummaryFile |
8 |
Polecenia partia są zapisywane w jednym pliku.Polecenia partia zawartości są zorganizowane według typu obiektu.Określić nazwę pliku z plik_skryptu argumentu.Jeśli ścieżka nie jest uwzględniony w nazwie pliku, plik jest tworzony w katalogu wskazywany przez zmienną środowiskową TEMP dla klient komputera. |
SQLDMOXfrFile_ i SummaryFiles |
1 |
Polecenia partia są zapisywane do wielu plików przeniesione jeden plik dla każdego rodzaju obiektu.Na przykład można wygenerować plik dla typów danych zdefiniowanych przez użytkownika i osobny plik dla tabel.Określ ścieżka za pomocą plik_skryptu argumentu.Jeżeli nie określono ścieżka, pliki są tworzone w katalogu wskazywany przez zmienną środowiskową TEMP dla klient komputera. |
Zwraca
Polecenia języka Transact-SQL partia jako ciąg.
Uwagi
Use the ScriptTransfer method to capture the database object creation statements (schema transfer) specified by a Transferobject.Utworzone pliki partia polecenia mogą być używane w innym procesie, takie jak zaplanowanego transferu schemat bazy danych.
Aby użyć metoda ScriptTransfer
Tworzenie Transfer obiektu.
Wypełnianie obiektu przy użyciu AddObject lub AddObjectByName metoda.
W razie potrzeby zestaw ScriptType i Script2Type Właściwości formantu zawartości polecenia partia generowane pliki.
Wywołanie ScriptTransfer wskazujące metoda Transfer obiektu utworzonego w kroku 1, opcjonalnie wskazujące położenie wyjściowe lub dane wyjściowe jednego pliku.
Ostrzeżenie
Obiektu SQL-DMO wykonywanie skryptów metody są w pełni zgodne z wystąpienie programu SQL Server w wersja 7.0.Jednakże poziom zgodności bazy danych wpływa na polecenia języka Transact-SQL partia zawartości.
Gdy wykonywanie skryptów bazy danych z poziom zgodności z mniej niż 7.0 lub jego obiekty wynikowe poleceń języka Transact-SQL wykonywanie skryptów partia zawiera słowa kluczowe zarezerwowana przez tego poziom.
Składnia polecenia języka Transact-SQL jest zawsze zgodna z wystąpienie programu SQL Server 7.0.Jeżeli można użyć opcjonalne argumenty wykonywanie skryptów, takich jak SQLDMOScript2_NoFG, aby usunąć niektóre składni wystąpienie programu SQL Server 7.0.