SQL-Jobs

{"URL":["/*.*/awa/pa_view_JOBS_SQL"],"heroDescriptionIdentifier":"ice_sql_jobs_intro","customCards":[{"id":"ice_sql_jobs_defining","title":"Defining SQL Jobs","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_job_SQL.htm","languages":["en-us"]},{"id":"ice_sql_attributes","title":"SQL Job Attributes","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_job_Attributes_SQL.htm","languages":["en-us"]},{"id":"ice_attributes_alljobs","title":"Attributes for all Job Types","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_job_Attributes_All.htm","languages":["en-us"]},{"id":"ice_registered_job_output","title":"Registered Job Output","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_Job_RegisteredOutput.htm","languages":["en-us"]},{"id":"ice_scripting_and_the_ae_scripting_language","title":"The Automation Engine Scripting Language","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Script/Writing/AE_Scripting_Language.htm","languages":["en-us"]},{"id":"ice_jcl_for_sql","title":"JCL for SQL","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Script/Reference/JCL_SQL.htm","languages":["en-us"]},{"id":"ice_jobs_overview","title":"About Job Objects","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_job.htm","languages":["en-us"]},{"id":"ice_jobs_workingwith","title":"Working with Job Objects","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_job.htm","languages":["en-us"]},{"id":"ice_working_with_objects","title":"Working with Objects","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_WorkingWithOverview.htm","languages":["en-us"]},{"id":"ice_job_executing","title":"Executing Jobs","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Executions/Exec_Jobs.htm","languages":["en-us"]},{"id":"ice_ExecutingObjects","title":"Executing Objects","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Executions/obj_Executing_overview.htm","languages":["en-us"]},{"id":"ice_Object_AnalyzeLastExecution","title":"Analyzing the Last Execution of a Job","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_WkgWithAnalyzeExecData.htm","languages":["en-us"]},{"id":"ice_jobs_monitoring","title":"Monitoring Jobs","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/ProcMonitoring/JOBSMonitor/PM_MonitoringJobsOverview.htm","languages":["en-us"]},{"id":"ice_monitoringtasks_overview","title":"Monitoring Tasks","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/ProcMonitoring/PM_MonitoringTasksOverview.htm","languages":["en-us"]},{"id":"ice_ExecutionData","title":"Execution Data","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Reports/Executions_Overview.htm","languages":["en-us"]},{"id":"ice_jobreports","title":"Job Reports","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Reports/Reports_Jobs.htm","languages":["en-us"]},{"id":"ice_ReportsOverview","title":"Understanding the Reports","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Reports/Reports_Overview.htm","languages":["en-us"]},{"id":"ice_reportsview_workingwith","title":"Reports Window","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Reports/Reports_Window.htm","languages":["en-us"]},{"id":"ice_AWIs_CommonFunctions","title":"Common Functions","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/_Common/CommonFunctions/CF_OverviewOfChapter.htm","languages":["en-us"]},{"id":"ice_UnderstandingPA","title":"Understanding the Process Assembly Perspective","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/ProcessAssembly.htm","languages":["en-us"]},{"id":"ice_Overview_AWI","title":"Understanding the User Interface","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/_Common/GettingStarted/GS_OverviewAWI.htm","languages":["en-us"]}]}

SQL-Jobs starten und überwachen Prozesse i den SQL-Zielsystemen. Ihr Automic Automation-System ist über den Agenten mit MS SQL verbunden. Der Agent sendet die Befehle vom Mandanten an MS SQL, ohne sie zu interpretieren oder zu transformieren.

Voraussetzungen

Um SQL-Jobs zu erstellen und auszuführen, muss Folgendes zutreffen:

Ein SQL-Agent ist verfügbar und aktiv
Eines der folgenden Elemente ist verfügbar:
- Ein Login-Objekt, das dem Agenten zugeordnet ist
- Ein Verbindungsobjekt, das dem SQL-Job zugeordnet ist
Sie stellen die Anmeldedaten bereit, mit denen sich der Agent bei MS SQL anmelden kann.

Wie alle Jobobjekte (JOBS) können SQL-Jobs eigenständig laufen oder zu einer Gruppe (JOBG) oder einem Workflow hinzugefügt werden. Weitere Informationen zur Integration von Automic Automation mit SQL finden Sie unter AE und Datenbanken.

Diese Seite beinhaltet Folgendes:

SQL-Jobs definieren

Die Definition eines SQL-Jobs besteht aus den folgenden Seiten:

Standardseiten, die unabhängig von dem von Ihnen definierten Objekttyp zu jeder Zeit verfügbar sind:
Für ausführbare Objekte sind immer die folgenden zusätzlichen Seiten verfügbar:
- Definieren der Prozessseiten in Jobs
  Hinweis: SQL-Jobs haben eine zusätzliche Seite Child-Post-Prozess. Sie erstellen die Logik der Child-Prozesse auf dieser Seite.
- Die Seite Attribute definieren
- Registrieren von externen Ausgabedateien
- Die Seite "Variablen" definieren
- Definieren der Seite "PromptSets"
- Definieren der Seite "Rollback"
Die hier beschriebene Seite SQL.

Einen SQL-Job definieren

Geben Sie im Abschnitt Verbindung folgende Daten an:
- Verbindungsobjekt
  
  Das Objekt, das die Parameter beinhaltet, die für die Verbindung zur Datenbank verwendet werden.
  
  Wichtig! Die Datenbanktypen des Agenten und des Verbindungsobjektes müssen übereinstimmen, sonst schlägt der Job fehl.
  
  Wenn Sie hier ein Verbindungsobjekt auswählen, werden die darin definierten Server- und Datenbankparameter mit diesem Job verwendet und die nächsten beiden Felder (Server:Port und Datenbank) sind nicht verfügbar.
  
  Bei der Definition des SQL-Jobobjekts können Sie ihm ein Login-Objekt auf der Seite Attribute zuordnen. Wenn Sie dies nicht tun, wird die Login-Information verwendet, die im Verbindungsobjekt definiert ist.
  
  Hinweise:
  - Die Angabe der Login-Information ist erforderlich. Wenn Sie weder ein Login- noch eine Verbindungsobjekt angeben, wird der Job abbrechen.
  - Wird in einem SQL-Job mit einem Datenbank-Agenten, der als "GENERIC" konfiguriert ist, ein Verbindungsobjekt des Typs "Generic JDBC" verwendet, dann wird der Datenbank-Anbieter, dem der Agent zugewiesen ist, bei der ersten Verwendung des Agenten definiert. Nach der Zuweisung steht der Agent erst wieder nach einem Neustart für andere JDBC-Anbieter zur Verfügung.
- Server:Port
  
  Sichtbar, wenn Sie einen Eintrag im Verbindungsobjekt ausgewählt haben.
  
  Name des Rechners, auf dem sich die Datenbank befindet.
  
  Erlaubtes Format: Server Name: Port
  
  Die Standardports sind:
  - MS SQL Server: 1433
  - Oracle: 1521
    
    Die Angabe eines Servers ist bei Jobs, die in einer Oracle-Datenbank in RAC verarbeitet werden, nicht erforderlich. Die Oracle-Datei tnsnames.ora enthält bereits die entsprechenden Verbindungsdaten.
  - DB2: 50000
  - MySQL: 3306
  Für Informix muss der Port angegeben werden.
- Datenbank
  
  Sichtbar, wenn Sie keinen Eintrag im Verbindungsobjekt gewählt haben
  
  Name der Datenbank.
  
  Bei Informix ist der Name des Servers und der Datenbank durch einen Schrägstrich getrennt anzugeben. Beispiel: ol_ids_1110_1/ang
Geben Sie die Daten im Abschnitt Job-Report an. Weitere Informationen finden Sie unter Job-Reports.
Geben Sie im Abschnitt Ergebnistabellen-Einstellungen folgende Daten an:

Die Ergebnisse von SQL-Jobausführungen werden in benutzerfreundliche Reports geschrieben. In diesem Abschnitt definieren Sie, wie diese Reports aussehen sollen:
- Zeige
  
  Wählen Sie die Optionen für die Darstellung des Reports:
  - Überschriften in einer Tabelle
    
    Die Reports zur Darstellung der Überschriften
  - NULL für leere Strings
    
    Die Reports zeigen NULL an, wenn ein leerer String zurückgegeben wird.
- Zeilenumbrüche entfernen
  
  Entfernt Zeilenumbrüche in Spalten.
- Spaltentrenner
  
  Zeichen, das verwendet werden soll, um Spalten in den Ergebnissen von SELECT-Anweisungen zu trennen.
- Ersatzzeichen
  
  Alternatives Zeichen. Kommt das Zeichen für den Spaltentrenner innerhalb eines Datenbankfeldes vor, so wird es durch das Ersatzzeichen ausgetauscht.
- Maximale Zeilen in Tabelle
  
  Die Beschränkung gilt pro SQL-Anweisung. Enthält das Ergebnis einer SQL-Anweisung mehr Zeilen, als hier spezifiziert, so werden sie abgeschnitten.
  
  Geben Sie den Wert "0" an, so wird keine Einschränkung der Zeilenanzahl vorgenommen.
- Maximale Zeichen in Spalte
  
  Weist der Inhalt eines Datenbankfeldes mehr Zeichen auf, als hier spezifiziert, so wird er abgeschnitten.
  
  Datenbankfelder, deren Inhalt als Zahl oder Zeitstempel definiert worden ist, werden nicht gekürzt.
  
  Hinweis: Beim spaltenweisen Lesen des Reports gibt es Einschränkungen bei der Script-Funktion PREP_PROCESS_REPORT.

SQL-Kommandos für SQL-Jobs

SQL-Jobs werden mit Sets von vordefinierten Befehlen geliefert. Ein Befehl ist eine Gruppe von SQL-spezifischen Strings oder -Funktionen. Sie erstellen die Logik eines SQL-Jobs auf seiner Prozess-Seite indem Sie ihm Befehle hinzufügen. Die Seite Prozess von SQL-Jobs enthält eine zusätzliche Ansicht namens Formulare – eine intuitive und benutzerfreundliche Methode zum Darstellen der Werte in einem bestimmten Kommando. Die Formularansicht eines Befehls kann Dropdown-Listen, Eingabefelder, Optionsfelder usw. enthalten. Weitere Informationen finden Sie unter Definieren der Prozessseiten in Jobs und Verständnis der Formularansicht auf der Prozessseite.

Siehe auch: