Udostępnij za pośrednictwem


Obiekt JobStep

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.

JobStep Obiektu opisuje atrybuty jednego SQL Server kroku wykonywalnego zadanie agenta.

Model obiektów SQL-DMO pokazujący bieżący obiekt

Uwagi

SQL ServerZadania agenta zawierają jednostek wykonanie nazywane kroki.Każdy krok zadania zawiera tekstowy polecenia typu wykonanie, która określa polecenie interpretacji i logiki, która określa zachowanie zadanie krok lub niepomyślnym.Na przykład kroku zadanie może zawierać:

  • Tekst polecenia:

    DBCC CHECKDB ('Northwind') WITH NO_INFOMSGS
    
  • Typ wykonywanie kroku zadanie języka Transact-SQL.

  • Wskazanie, że zadanie należy zatrzymać, jeśli krok nie powiedzie się.

Z JobStep obiektu, możesz:

  • Utwórz krok zadanie agenta programu SQL Server.

  • Usuwanie kroku zlecenia zadanie agenta programu SQL Server.

  • Zarządzanie kroki istniejącego zadanie, zmieniając na przykład tekst polecenia lub czynności na sukces lub niepowodzenie kroku.

  • Uzyskać szczegółowe informacje o ostatniej próby wykonywania kroku.

Name Właściwość JobStepobiekt może zawierać maksymalnie 100 znaków.Wartość Name właściwość musi być unikatowa w obrębie zadanie.

Po utworzeniu krok zadanie jest dołączany do listy kroków zadanie agenta programu SQL Server.

Podczas tworzenia zadania czynności za pomocą JobStep obiekt, domyślnej logiki do sukcesu lub niepowodzenia jest Zatrzymuje zadanie.Nowe kroki w celu zapewnienia, że są warunki zakończenia kontroli SQL Distributed Management Objects (SQL-DMO) zestaw poprawnie.Dodając serii kroków do zadanie za pomocą obiektu SQL-DMO, użyj BeginAlter i DoAlter metody Job obiekt oblewania proces, który krok logiki sprawdzania jest wszystkie kroki dodawane do zadanie.

Aby utworzyć SQL Server krok zadanie agenta

  1. Tworzenie JobStep obiektu.

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

  3. Ustaw StepID właściwość.

  4. Ustaw Command właściwość.Domyślny typ wykonanie zadanie krok zdefiniowany przez nowy JobStep jest obiekt języka Transact-SQL.Jeśli polecenie jest system operacyjny wykonywalnego lub pliku wsadowego zestaw SubSystem właściwość CmdExec.

  5. Dodaj JobStep obiektu, aby JobSteps kolekcja Job obiekt, który odwołuje się do istniejącego zadanie agenta programu SQL Server.

Aby usunąć SQL Server krok zadanie agenta

  1. Get the Job object from the Jobs collection of a connected JobServerobject.

  2. Użyj BeginAlter metoda Job obiekt, aby oznaczyć początek zmiany zadanie agenta programu SQL Server.

  3. Pobierz JobStep obiekt z JobSteps kolekcja Job obiektu.

  4. Użyj Remove metoda JobStep obiekt, aby usunąć krok z listy kroków zadanie agenta programu SQL Server.

  5. Jak get właściwe, JobStep obiektów, które wskazują usunięty krok w ich logiki.Dopasuj OnFailStep i OnSuccessStep Właściwości tych JobStep obiektów, aby poprawić ich logiki.

  6. Użyj DoAlter metoda Job obiekt, aby oznaczyć koniec zmiany i przesyłać zmiany do serwera.