Dienstprogramme - Sybase

Dienstprogramme
Adaptive Server® Enterprise
12.5.1

DOKUMENT-ID: DC32959-01-1251-01
LETZTE ÜBERARBEITUNG: August 2003
Copyright © 1989-2004 Sybase Inc. Alle Rechte vorbehalten.
Dieses Handbuch ist Bestandteil der Dokumentation der Sybase-Software und jeder weiteren Version, sofern in neueren Ausgaben
oder technischen Hinweisen nicht anders angegeben. Änderungen sind ohne vorherige Ankündigung jederzeit möglich. Die hierin
beschriebene Software unterliegt einer Lizenzvereinbarung und darf nur im Rahmen der darin enthaltenen Bestimmungen eingesetzt
oder kopiert werden.
Kunden in den USA und Kanada können weitere Dokumentationsteile anfordern. Wenden Sie sich dazu an die Abteilung Customer
Fulfillment unter der Telefonnummer (800) 685-8225 und der Faxnummer (617) 229-9845.
Kunden außerhalb der USA mit einer amerikanischen Lizenz können mit unserer Abteilung Customer Fulfillment über Telefax oder mit
Telesales unter Tel. 0130-73 91 87 (Deutschland) Kontakt aufnehmen. Alle anderen internationalen Kunden sollten sich an ihre Sybase-
Geschäftsstelle oder an ihren örtlichen Vertriebsbeauftragten wenden. Upgrades sind erst nach dem regulären Erscheinungsdatum der
Softwareversion erhältlich. Kein Teil dieses Dokuments darf ohne vorherige schriftliche Genehmigung der Sybase Inc. in irgendeiner
Form, sei es elektronisch, mechanisch, manuell, optisch oder auf sonstige Weise, fotokopiert, reproduziert oder in eine andere Sprache
übersetzt werden.
Sybase, das Sybase-Logo, AccelaTrade, ADA Workbench, Adaptable Windowing Environment, Adaptive Component Architecture,
Adaptive Server, Adaptive Server Anywhere, Adaptive Server Enterprise, Adaptive Server Enterprise Monitor, Adaptive Server
Enterprise Replication, Adaptive Server Everywhere, Adaptive Server IQ, Adaptive Warehouse, Anywhere Studio, Application
Manager, AppModeler, APT Workbench, APT-Build, APT-Edit, APT-Execute, APT-FORMS, APT-Translator, APT-Library, AvantGo,
AvantGo Application Alerts, AvantGo Mobile Delivery, AvantGo Mobile Document Viewer, AvantGo Mobile Inspection, AvantGo
Mobile Marketing Channel, AvantGo Mobile Pharma, AvantGo Mobile Sales, AvantGo Pylon, AvantGo Pylon Application Server,
AvantGo Pylon Conduit, AvantGo Pylon PIM Server, AvantGo Pylon Pro, Backup Server, BizTracker, ClearConnect, Client-Library,
Client Services, Convoy/DM, Copernicus, Data Pipeline, Data Workbench, DataArchitect, Database Analyzer, DataExpress, DataServer,
DataWindow, DB-Library, dbQueue, Developers Workbench, Direct Connect Anywhere, DirectConnect, Distribution Director, e-ADK,
E-Anywhere, e-Biz Integrator, E-Whatever, EC Gateway, ECMAP, ECRTP, eFulfillment Accelerator, Embedded SQL, EMS, Enterprise
Application Studio, Enterprise Client/Server, Enterprise Connect, Enterprise Data Studio, Enterprise Manager, Enterprise SQL Server
Manager, Enterprise Work Architecture, Enterprise Work Designer, Enterprise Work Modeler, eProcurement Accelerator, EWA,
Financial Fusion, Financial Fusion Server, Gateway Manager, GlobalFIX, ImpactNow, Industry Warehouse Studio, InfoMaker,
Information Anywhere, Information Everywhere, InformationConnect, InternetBuilder, iScript, Jaguar CTS, jConnect for JDBC, Mail
Anywhere Studio, MainframeConnect, Maintenance Express, Manage Anywhere Studio, M-Business Channel, M-Business Network,
M-Business Server, MDI Access Server, MDI Database Gateway, media.splash, MetaWorks, My AvantGo, My AvantGo Media Channel,
My AvantGo Mobile Marketing, MySupport, Net-Gateway, Net-Library, New Era of Networks, ObjectConnect, ObjectCycle,
OmniConnect, OmniSQL Access Module, OmniSQL Toolkit, Open Biz, Open Client, Open ClientConnect, Open Client/Server, Open
Client/Server Interfaces, Open Gateway, Open Server, Open ServerConnect, Open Solutions, Optima++, PB-Gen, PC APT Execute, PC
Net Library, PocketBuilder, Pocket PowerBuilder, Power++, power.stop, PowerAMC, PowerBuilder, PowerBuilder Foundation Class
Library, PowerDesigner, PowerDimensions, PowerDynamo, PowerJ, PowerScript, PowerSite, PowerSocket, Powersoft, PowerStage,
PowerStudio, PowerTips, Powersoft Portfolio, Powersoft Professional, PowerWare Desktop, PowerWare Enterprise, ProcessAnalyst,
Rapport, Report Workbench, Report-Execute, Replication Agent, Replication Driver, Replication Server, Replication Server Manager,
Replication Toolkit, Resource Manager, RW-DisplayLib, S-Designor, SDF, Secure SQL Server, Secure SQL Toolset, Security Guardian,
SKILS, smart.partners, smart.parts, smart.script, SQL Advantage, SQL Anywhere, SQL Anywhere Studio, SQL Code Checker, SQL
Debug, SQL Edit, SQL Edit/TPU, SQL Everywhere, SQL Modeler, SQL Remote, SQL Server, SQL Server Manager, SQL SMART,
SQL Toolset, SQL Server/CFT, SQL Server/DBM, SQL Server SNMP SubAgent, SQL Station, SQLJ, STEP, SupportNow, S.W.I.F.T.
Message Format Libraries, Sybase Central, Sybase Client/Server Interfaces, Sybase Financial Server, Sybase Gateways, Sybase MPP,
Sybase SQL Desktop, Sybase SQL Lifecycle, Sybase SQL Workgroup, Sybase User Workbench, SybaseWare, Syber Financial,
SyberAssist, SyBooks, System 10, System 11, System XI (logo), SystemTools, Tabular Data Stream, TradeForce, Transact-SQL,
Translation Toolkit, UltraLite.NET, UNIBOM, Unilib, Uninull, Unisep, Unistring, URK Runtime Kit for UniCode, Viewer, Visual
Components, VisualSpeller, VisualWriter, VQL, WarehouseArchitect, Warehouse Control Center, Warehouse Studio, Warehouse
WORKS, Watcom, Watcom SQL, Watcom SQL Server, Web Deployment Kit, Web.PB, Web.SQL, WebSights, WebViewer,
WorkGroup SQL Server, XA-Library, XA-Server und XP Server sind Marken von Sybase, Inc.
Unicode und das Unicode-Logo sind eingetragene Marken von Unicode Inc.
Alle anderen Unternehmens- oder Produktbezeichnungen sind Marken oder eingetragene Marken des jeweiligen Inhabers.
Sybase, Inc., One Sybase Drive, Dublin, CA 94568.

Inhalt
KAPITEL 1 Server mit dem dataserver-Dienstprogramm einrichten............. 1
Einführung........................................................................................ 1
Ein neues Master-Device einrichten................................................. 2
Betriebsumgebungen für dataserver ......................................... 3
Einrichtmodus............................................................................ 4
Start-Modus............................................................................... 7
Upgrade zu einem Server mit größeren Seitengrößen ............. 7
Die aktuellen Server-Beschränkungen anzeigen ...................... 7
KAPITEL 2 Das isql-Dienstprogramm verwenden........................................... 9
Vorbereitungen................................................................................. 9
isql starten und stoppen ................................................................. 10
Transact-SQL in isql verwenden .................................................... 10
isql-Ausgabe formatieren ........................................................ 11
Eingabe korrigieren ................................................................. 12
set-Optionen, die sich auf die Ausgabe auswirken ................. 13
Das Befehlsabschlusszeichen ändern ........................................... 13
Wechselwirkung von Performance-Statistik und
Befehlsabschlusszeichen-Werten .................................... 14
Netzwerkpaketgröße einstellen...................................................... 15
Eingabe- und Ausgabedateien....................................................... 16
UNIX-Befehlszeile umleiten..................................................... 16
KAPITEL 3 Daten mit bcp in und aus Adaptive Server übertragen ............. 17
Methoden zum Verschieben von Daten ......................................... 18
Daten mit bcp .......................................................................... 18
bcp-Anforderungen ........................................................................ 19
bcp-Modi ........................................................................................ 21
bcp-Performance............................................................................ 22
Schnellen oder langsamen bcp verwenden ............................ 22
Daten mit schnellem bcp importieren ...................................... 25
Mit dem Massenexport/-import Daten in partitionierte
Tabellen kopieren ............................................................. 26
Dienstprogramme iii

Inhalt
Mit parallelem Massenexport/-import Daten in eine
bestimmte Partition kopieren ............................................ 29
Die bcp-Optionen verwenden......................................................... 35
Die Standardformate verwenden............................................. 36
Abschlusszeichen von der Befehlszeile ändern ...................... 38
Die Standardwerte ändern: Interaktiver bcp................................... 38
Auf bcp-Eingabeaufforderungen reagieren ............................. 39
Dateispeichertyp...................................................................... 41
Präfixlänge .............................................................................. 43
Feldlänge................................................................................. 44
Feld- und Zeilenabschlusszeichen .......................................... 47
Formatdateien verwenden ............................................................. 50
Elemente der bcp-Formatdatei................................................ 51
Beispiele: Daten interaktiv exportieren........................................... 54
Daten mit Feldlängen exportieren ........................................... 55
Daten mit Begrenzern exportieren .......................................... 56
Beispiele: Daten interaktiv importieren........................................... 57
Daten mit Feldlängen importieren ........................................... 58
Daten mit Begrenzern importieren .......................................... 60
Daten mit einer Formatdatei importieren................................. 60
bcp mit anderen Sprachen verwenden .......................................... 61
bcp und Zugriffsregeln auf Zeilenebene......................................... 62
Importieren und Anweisungsfolgedateien ...................................... 62
Wiederherstellbarkeit erleichtern............................................. 63
Anweisungsfolgen und partitionierte Tabellen......................... 64
Exportieren und Text- und Bilddaten.............................................. 64
Netzwerkpaketgröße festlegen ...................................................... 65
Importieren und Fehlerdateien ....................................................... 65
Exportieren und Fehlerdateien....................................................... 67
Datenintegrität: Standardwerte, Regeln und Trigger...................... 67
Standardwerte und Datentypen............................................... 67
Regeln und Trigger.................................................................. 68
Wie unterscheidet sich bcp von anderen
Dienstprogrammen? ......................................................... 68
KAPITEL 4 dsedit verwenden .......................................................................... 71
Mit dsedit arbeiten.......................................................................... 71
dsedit starten........................................................................... 71
Eine Bearbeitungssitzung öffnen............................................. 73
Servereinträge hinzufügen, anzeigen und bearbeiten ................... 75
Servereinträge in Windows NT ändern ................................... 76
Servereinträge auf UNIX-Plattformen ändern ......................... 79
Servereinträge kopieren .......................................................... 82
iv Adaptive Server Enterprise

Inhalt
dsedit-Fehlerbehandlung ............................................................... 83
Das dsedit-Dienstprogramm startet nicht ................................ 83
Fehlermeldung: „Öffnen der X-Anzeige nicht möglich“ ........... 84
Hinzufügen, Ändern oder Löschen von Servereinträgen
nicht möglich..................................................................... 84
KAPITEL 5 dscp verwenden............................................................................ 85
Mit dscp arbeiten............................................................................ 85
Eine dscp-Sitzung verwenden................................................. 86
Mit Servereinträgen arbeiten.......................................................... 87
Servereinträge hinzufügen und ändern ................................... 87
Servereinträge kopieren .......................................................... 90
Inhalte von Servereinträgen auflisten und anzeigen ............... 91
Servereinträge löschen ........................................................... 92
dscp beenden................................................................................. 93
Übersicht über die dscp-Dienstprogrammbefehle.......................... 93
KAPITEL 6 Migrations-Dienstprogramm........................................................ 95
Überblick ........................................................................................ 95
Bestehende Lösungen ............................................................ 96
Vorteile von sybmigrate........................................................... 96
Was sybmigrate durchführt ..................................................... 96
Was sybmigrate nicht tut ......................................................... 98
Vorbereitungen............................................................................. 100
Erforderliche Komponenten für sybmigrate........................... 100
Voraussetzungen .................................................................. 100
Installation ............................................................................. 100
Upgrade................................................................................. 100
Berechtigungen ..................................................................... 101
Plattformen ............................................................................ 102
Umgebungsvariablen ............................................................ 102
Migrationsprozess ........................................................................ 103
Überblick über den Migrationsprozess .................................. 103
Vorbereitung der Migration.................................................... 104
Konfiguration und Optimierung für eine bessere
Performance ................................................................... 107
Fehlervermeidung ................................................................. 110
Automatische Auswahl abhängiger Objekte für
die Migration ................................................................... 110
sybmigrate ausführen............................................................ 110
GUI-Modus ............................................................................ 114
Ressourcedatei-Modus ......................................................... 122
Aufgaben nach der Migration ....................................................... 130
Dienstprogramme v

Inhalt
Daten aus Replication Server in Adaptive Server 12.5
migrieren......................................................................... 130
Vorbereitung der Datenbanken mit Replikationsdaten
für die Migration.............................................................. 132
Aufgaben für replizierte Datenbanken nach
der Migration................................................................... 133
Einschränkungen ......................................................................... 138
Problembehebung und Fehlermeldungen.................................... 140
Objekte werden nicht migriert................................................ 140
Beginn der Datenbankmigration............................................ 140
„Connection refused“ und „Unable to obtain
connection to the server“ ................................................ 141
Der Zielserver ist vom Quellserver nicht erreichbar .............. 141
Wenn sybmigrate bei der Migration hängt............................. 141
Zwei Datenbanken zusammenführen.................................... 142
Bereinigen von Fehlern nach der Migration .......................... 142
Datenbank erneut migrieren.................................................. 142
Einzelne Objekte neu erstellen.............................................. 143
Verbindung fehlgeschlagen................................................... 143
„Insufficient memory in JVM shared class“............................ 143
„There is not enough memory in the procedure cache“ ........ 144
java.lang-Fehler..................................................................... 144
KAPITEL 7 Adaptive Server Plug-In installieren .......................................... 145
Einführung.................................................................................... 145
Lieferung des Adaptive Server Plug-Ins................................ 146
Funktionsunterschiede zwischen den Versionen
im Vergleich.................................................................... 146
Auf die Monitor Client-GUI zugreifen ........................................... 148
Monitor Client-GUI als eigenständige Anwendung
ausführen........................................................................ 148
KAPITEL 8 Übersicht über die Dienstprogrammbefehle............................. 151
Erste Orientierung ........................................................................ 152
*_dce- und *_r-Dienstprogramme.......................................... 154
Dienstprogramm-Überblick .......................................................... 155
Installations- und Konfigurationsdienstprogramme ............... 155
Dienstprogramme für Sprachen, Zeichensätze
und Sortierreihenfolgen .................................................. 156
Dienstprogramme zum Starten von Servern ......................... 156
Erstellungs- und Bearbeitungsdienstprogramme
für Datenbanken ............................................................. 157
Dienstprogramme zum Sammeln von Informationen ............ 157
vi Adaptive Server Enterprise

Inhalt
backupserver................................................................................ 158
bcp ............................................................................................... 163
buildmaster................................................................................... 176
certauth ........................................................................................ 176
certpk12 ....................................................................................... 179
certreq .......................................................................................... 182
charset ......................................................................................... 185
cobpre .......................................................................................... 186
cpre .............................................................................................. 186
dataserver .................................................................................... 187
dataxtr .......................................................................................... 194
ddlgen .......................................................................................... 194
defncopy....................................................................................... 209
dscp.............................................................................................. 216
dsedit............................................................................................ 217
extractjava.................................................................................... 218
installjava ..................................................................................... 221
isql................................................................................................ 226
langinstall ..................................................................................... 236
optdiag ......................................................................................... 239
pwdcrypt....................................................................................... 246
showserver................................................................................... 247
sqldbgr ......................................................................................... 247
sqlloc ............................................................................................ 253
sqllocres ....................................................................................... 254
sqlsrvr........................................................................................... 255
sqlupgrade ................................................................................... 263
sqlupgraderes .............................................................................. 264
srvbuild......................................................................................... 264
srvbuildres.................................................................................... 265
startserver .................................................................................... 266
sybmigrate.................................................................................... 269
xpserver ....................................................................................... 273
Index ........................................................................................................................................... 277
Dienstprogramme vii

Inhalt
viii Adaptive Server Enterprise

Über dieses Handbuch
Dienstprogramme für Adaptive Server Enterprise ist ein Leitfaden für
die Dienstprogramme in Sybase ® Adaptive Server ® Enterprise, die für
UNIX-Plattformen und Windows NT verfügbar sind. Dienstprogramme
sind Befehle, die Sie direkt vom Betriebssystem aus aufrufen können.
Zielgruppe Dieses Handbuch ist für Benutzer gedacht, die Transact-SQL ® und
Adaptive Server Enterprise Version 12.5 verwenden. Es setzt voraus,
dass Sie Grundkenntnisse über Adaptive Server und Ihr Betriebssystem
besitzen.
Umgang mit dieser
Dokumentation
Dieses Handbuch besteht aus folgenden Kapiteln:
Kapitel 1, „Server mit dem dataserver-Dienstprogramm einrichten“,
beschreibt, wie Sie mit dem Dienstprogramm dataserver neue Server
erstellen.
Kapitel 2, „Das isql-Dienstprogramm verwenden“, beschreibt, wie
Sie das Dienstprogramm Interactive SQL (isql) verwenden, mit dem
Sie von Ihrem Betriebssystem aus auf SQL zugreifen können.
Kapitel 3, „Daten mit bcp in und aus Adaptive Server übertragen“,
beschreibt detailliert das Dienstprogramm bcp für den Massenexport/
-import von Daten, mit dem Sie Daten zwischen Adaptive Server und
einer Betriebssystemdatei verschieben können.
Kapitel 4, „dsedit verwenden“, beschreibt wie Sie das Verzeichnisdienst-Editor-Dienstprogramm
dsedit verwenden, um die Interface-
Datei sql.ini unter Windows NT zu bearbeiten, und um in X-Windows
Servereinträge in der Interface-Datei auf UNIX-Plattformen
anzuzeigen und zu bearbeiten.
Kapitel 5, „dscp verwenden“, beschreibt, wie Sie mit dem
Dienstprogramm dscp Servereinträge in der Interface-Datei auf
UNIX-Plattformen anzeigen und bearbeiten.
Kapitel 6, „Migrations-Dienstprogramm“, beschreibt, wie Sie mit
dem Dienstprogramm sybmigrate Daten und Datenbankenschemata
aus Datenbankversionen vor 12.5 in Datenbanken der Version 12.5
übertragen.
Dienstprogramme ix

Weiterführende
Dokumentationen
Kapitel 7, „Adaptive Server Plug-In installieren“, beschreibt das
Adaptive Server Enterprise Plug-In sowie den Einsatz der Monitor
Client-GUI als Teil des Adaptive Server Plug-In und als eigenständige
Anwendung. Außerdem wird die Verwendung der C++-Version des
Adaptive Server Plug-In erläutert.
Kapitel 8, „Übersicht über die Dienstprogrammbefehle“, listet
die Dienstprogrammbefehle und ihre Beschreibung auf, mit denen
Sie Ihre Datenbanken und Adaptive Server Enterprise verwalten und
pflegen können.
Die Beispiele in diesem Handbuch basieren auf der Musterdatenbank pubs2.
Ihr Systemadministrator kann Ihnen beim Zugriff auf eine saubere Kopie der
Datenbank pubs2 behilflich sein.
Die Dokumentation von Sybase ® Adaptive Server ® Enterprise umfasst
Folgendes:
Versionshinweise für Ihre Plattform – Diese Dokumentation enthält
aktuelle Informationen, die in die anderen Dokumente nicht mehr
aufgenommen werden konnten.
Eine neuere Ausgabe dieser Versionshinweise finden Sie unter Umständen
im World Wide Web. Um wichtige Produkt- oder Dokumentationsinformationen
zu erhalten, die erst nach der Herausgabe der Produkt-CD
verfasst wurden, benutzen Sie die „Technical Library“.
Installationsanleitungen für Ihre Plattform – Diese Dokumentationen
beschreiben Installations- und Upgrade-Prozeduren für alle Adaptive
Server-Installationen und ähnliche Sybase-Produkte.
What’s New in Adaptive Server Enterprise? (in englischer Sprache) –
Diese Einführungsdokumentation beschreibt die neuen Funktionen der
Version 12.5.1 von Adaptive Server Enterprise, die für die Unterstützung
dieser Funktionen durchgeführten Systemänderungen und die
Änderungen, die sich auf Ihre vorhandenen Anwendungen
auswirken können.
ASE Replicator User’s Guide (in englischer Sprache) – Diese
Dokumentation beschreibt die Verwendungsweise der ASE Replicator-
Funktion von Adaptive Server zur Umsetzung einer grundlegenden
Replikation aus einem Primärserver auf einen oder mehrere entfernte
Adaptive Server.
Component Integration Services User’s Guide (in englischer Sprache) –
In dieser Dokumentation wird erklärt, wie Sie die Adaptive Server
Component Integration Services verwenden, um sich mit entfernten
Sybase- und Nicht-Sybase-Datenbanken zu verbinden.
x Adaptive Server Enterprise

Über dieses Handbuch
Konfigurationsanleitung für Adaptive Server Enterprise für Ihre
Plattform – Diese Dokumentation enthält Anweisungen für bestimmte
Aufgaben zur Konfiguration von Adaptive Server.
EJB Server User’s Guide (in englischer Sprache) – Dieses Benutzerhandbuch
erläutert, wie EJB Server zur Bereitstellung und Ausführung
von Enterprise JavaBeans in Adaptive Server eingesetzt wird.
Error Messages and Troubleshooting Guide (in englischer Sprache) –
Diese Dokumentation beschreibt, wie häufig auftretende Fehler behoben
werden können, und bietet Lösungen zu Systemfehlern, auf die Benutzer
häufig stoßen.
Full-Text Search Specialty Data Store User’s Guide (in englischer
Sprache) – Dieses Benutzerhandbuch beschreibt den Einsatz der Volltext-
Recherchefunktion mit Verity zum Durchsuchen von Daten in Adaptive
Server Enterprise-Datenbanken.
Glossary (in englischer Sprache) – Im Glossar werden Fachbegriffe
definiert, die in der Dokumentation von Adaptive Server verwendet
werden.
Historical Server User’s Guide (in englischer Sprache) – Dieses
Handbuch beschreibt den Einsatz von Historical Server für den Abruf
von Performancedaten von SQL Server ® und Adaptive Server.
Java in Adaptive Server Enterprise (in englischer Sprache) – Diese
Dokumentation beschreibt, wie Sie Java-Klassen als Datentypen sowie
benutzerdefinierte Funktionen in der Adaptive Server-Datenbank
installieren und einsetzen.
Job Scheduler User’s Guide (in englischer Sprache) – Dieses
Handbuch enthält Anleitungen zur Installation und Konfiguration sowie
zur Erstellung und Planung von Aufträgen auf lokalen oder entfernten
Adaptive Server-Installationen über die Befehlszeile oder eine grafische
Benutzeroberfläche.
Monitor Client Library Programmer’s Guide (in englischer Sprache) –
Dieses Handbuch für Programmierer enthält Anleitungen zum
Programmieren von Monitor Client Library-Anwendungen,
die auf Performancedaten von Adaptive Server zugreifen.
Monitor Server User’s Guide (in englischer Sprache) – Dieses Handbuch
beschreibt den Einsatz von Monitor Server für den Abruf von
Performancedaten von SQL Server und Adaptive Server.
Dienstprogramme xi

Performance and Tuning Guide (in englischer Sprache) – In dieser
vierteiligen Dokumentation wird erklärt, wie Adaptive Server so optimiert
wird, dass er mit höchster Performance arbeitet:
Basics – Dieses Dokument enthält grundlegende Informationen
zum Verständnis und zur Untersuchung von Performancefragen in
Adaptive Server.
Locking – Dieses Dokument erläutert die Verwendungsweise der
unterschiedlichen Sperrschemata zur Performanceverbesserung in
Adaptive Server.
Optimizer and Abstract Plans – Dieses Dokument erläutert,
wie ein Optimierer Abfragen verarbeitet und wie Abstraktpläne
zur Anpassung von Optimiererplänen verwendet werden können.
Monitoring and Analyzing – Dieses Dokument beschreibt, wie
statistische Daten abgerufen und zur Überwachung und Optimierung
der Performance verwendet werden.
Kurzreferenz – Diese Kurzübersicht bietet eine vollständige Liste der
Namen und der Syntax von Befehlen, Funktionen, Systemprozeduren,
erweiterten Systemprozeduren, Datentypen und Dienstprogrammen im
handlichen Taschenbuchformat.
Reference Manual (in englischer Sprache) – Diese vierteilige
Dokumentation enthält folgende detaillierte Informationen zu
Transact-SQL ® :
Building Blocks – Enthält Transact-SQL-Datentypen, Funktionen,
globale Variablen, Ausdrücke, Bezeichner und Wildcard-Zeichen
sowie reservierte Wörter.
Commands – Enthält Transact-SQL-Befehle.
Procedures – Enthält Transact-SQL-Systemprozeduren, Katalog-
Systemprozeduren, erweiterte Systemprozeduren sowie gespeicherte
Prozeduren für dbcc.
Tables – Enthält Transact-SQL-Systemtabellen und dbcc-Tabellen.
Systemadministration für Adaptive Server Enterprise – Diese
Dokumentation bietet detaillierte Informationen zur Verwaltung von
Servern und Datenbanken. Außerdem werden darin Anleitungen und
Richtlinien für die Verwaltung von physischen Ressourcen, Sicherheit
und Benutzer- bzw. Systemdatenbanken sowie für die Definition der
Zeichensatzkonvertierung, für internationale Sprachversionen und für
Einstellungen der Sortierreihenfolge besprochen.
xii Adaptive Server Enterprise

Über dieses Handbuch
System Tables Diagram – Dieses Übersichtsschema zeigt die
Systemtabellen und ihre Entitätsrelationen in Form eines Plakats.
Nur in gedruckter Form verfügbar.
Transact-SQL User’s Guide (in englischer Sprache) – Diese
Dokumentation beschäftigt sich mit Transact-SQL, der von Sybase
erweiterten Version der Sprache für relationale Datenbanken. Dieses
Handbuch dient als Lehrbuch für Erstbenutzer des Datenbank-
Managementsystems. Außerdem enthält es Beschreibungen der
Beispieldatenbanken pubs2 und pubs3.
Using Adaptive Server Distributed Transaction Management
Features (in englischer Sprache) – Diese Dokumentation erklärt, wie
Sie Adaptive Server DTM-Funktionen in einer Umgebung mit verteilter
Transaktionsverarbeitung konfigurieren und verwenden sowie eventuell
auftretende Fehler beheben.
Using Sybase Failover in a High Availability System (in englischer
Sprache) – Diese Dokumentation enthält Anweisungen zur Arbeit mit
Sybase Failover, um Adaptive Server als Begleitserver-Konfiguration
in einem System mit hoher Verfügbarkeit zu konfigurieren.
Dienstprogramme – Dieses Handbuch dokumentiert die Adaptive Server-
Dienstprogramme wie isql und bcp, die auf Betriebssystemebene
ausgeführt werden.
Web Services User’s Guide (in englischer Sprache) – Dieses Handbuch
erläutert die Konfiguration und Verwendung von Web Services für
Adaptive Server sowie Maßnahmen zur Fehlerbehebung.
XA Interface Integration Guide for CICS, Encina, and TUXEDO
(in englischer Sprache) – Dieses Handbuch für die Integration von
Schnittstellen enthält Anweisungen zur Verwendung der Sybase-
DTM-XA-Schnittstelle mit X/Open XA-Transaktionsmanagern.
XML Services in Adaptive Server Enterprise (in englischer Sprache) –
Dieses Dokument beschreibt den Sybase-eigenen XML-Prozessor und
den Java-basierten XML-Support von Sybase, gibt eine Einführung in
XML in Datenbanken und legt die Abfrage- und Zuordnungsfunktionen
der XML Services dar.
Dienstprogramme xiii

Sybase-
Zertifizierungen
im Internet
Sybase-EBFs und
Software-Updates
Die technischen Informationen auf der Sybase-Website werden in
regelmäßigen Abständen aktualisiert.
❖ So finden Sie die neuesten Informationen zu Produkt-Zertifizierungen:
1 Gehen Sie in Ihrem Webbrowser zur Adresse Technical Documents
http://www.sybase.com/support/techdocs/.
2 Wählen Sie „Products“ aus der Navigationsleiste auf der linken Seite.
3 Wählen Sie ein Produkt aus der Auswahlliste aus und klicken Sie
auf „Go“.
4 Wählen Sie den Filter „Certification Report“ aus, geben Sie einen
Zeitrahmen an, und klicken Sie auf „Go“.
5 Klicken Sie auf den gewünschten Titel, um den Report anzuzeigen.
❖ So erstellen Sie eine auf Ihre persönlichen Bedürfnisse angepasste
Ansicht der Sybase-Website (einschließlich Support-Seiten):
Richten Sie ein MySybase-Profil ein. MySybase ist eine kostenlose
Serviceleistung, mit der Sie eine auf Ihre persönlichen Anforderungen
angepasste Ansicht der Sybase-Website erstellen können.
1 Gehen Sie in Ihrem Webbrowser zur Adresse Technical Documents
http://www.sybase.com/support/techdocs/.
2 Klicken Sie auf „MySybase“ und erstellen Sie ein MySybase-Profil.
❖ So finden Sie die neuesten Informationen zu EBFs und Software-
Updates:
1 Gehen Sie in Ihrem Webbrowser zur Adresse the Sybase Support Page
http://www.sybase.com/support.
2 Wählen Sie „EBFs/Maintenance“ aus. Geben Sie einen Benutzernamen
und ein Kennwort ein, falls Sie dazu aufgefordert werden, oder erstellen
Sie ein neues Konto (ein kostenloser Dienst).
3 Wählen Sie ein Produkt aus.
4 Geben Sie einen Zeitrahmen an und klicken Sie auf „Go“.
5 Klicken Sie zur Anzeige des EBF/Maintenance-Reports auf das
Info-Symbol, oder klicken Sie auf die Produktbeschreibung, um die
entsprechende Software herunterzuladen.
xiv Adaptive Server Enterprise

Über dieses Handbuch
Konventionen Im normalen Fließtext dieses Handbuchs werden Namen von Dateien,
Datenträgern und Verzeichnissen kursiv gesetzt, zum Beispiel:
Unter Windows NT: %SYBASE%\bin
Auf UNIX-Plattformen: $SYBASE
Hinweis Setzen Sie Ihr Sybase-Installationslaufwerk und -verzeichnis
unter UNIX auf $SYBASE und unter Windows NT auf %SYBASE%.
Tabelle 1 beschreibt die typographischen (Schriftart- und Syntax-)
Konventionen, die in dieser Dokumentation benutzt werden.
Tabelle 1: Schriftart- und Syntaxkonventionen in diesem Handbuch
Element Beispiel
Die Namen von Befehlen, Befehlsoptionen, dsedit
Datenbanken, Datentypen, Dienstprogrammen,
Dienstprogramm-Parametern und anderen
Schlüsselwörtern werden in Helvetica dargestellt.
Variablen oder Wörter, die durch einen
select Spaltenname
entsprechenden Wert ersetzt werden müssen, from Tabellenname
werden kursiv dargestellt.
where Suchbedingungen
Runde Klammern sind ein Teil des Befehls und compute row_aggregate (Spaltenname)
müssen eingegeben werden.
Geschweifte Klammern bedeuten, dass
{Käse, Soße}
Sie zumindest eine der darin angegebenen
Optionen wählen müssen (siehe Komma).
Hinweis Die geschweiften Klammern selbst dürfen nicht
eingegeben werden.
Eckige Klammern bedeuten, dass die darin
angegebenen Optionen wahlfrei sind.
Der Senkrechtstrich bedeutet, dass Sie nur eine
der angegebenen Optionen auswählen können.
Das Komma bedeutet, dass Sie beliebig viele der
angegebenen Optionen durch Kommas voneinander
getrennt eingeben können.
[Salat, grüne_Bohnen, Sauerkraut]
Hinweis Die Klammern selbst dürfen nicht eingegeben
werden.
{Barzahlung | Scheck | Kreditkarte}
Hinweis Die geschweiften Klammern selbst dürfen nicht
eingegeben werden.
[Schmelzkäse, Avocados, Sahne]
Hinweis Die Klammern selbst dürfen nicht eingegeben
werden.
Dienstprogramme xv

Element Beispiel
Auslassungspunkte (...) bedeuten, dass Sie den
vorhergehenden Eintrag beliebig oft wiederholen
können.
Syntaxanweisungen, die die Syntax der
Dienstprogramme mit all ihren Optionen zeigen,
werden wie folgt dargestellt: entweder in der Schrift
San Serif bei Dienstprogramm-Parametern und
Optionen (-v) oder kursiv bei vom Benutzer
gelieferten Werten (Benutzername).
Beispiele, die Computerausgaben zeigen, werden in
Courier dargestellt:
Falls Sie Hilfe
brauchen
Dinge kaufen = Preis [Bargeld | Scheck |
Kreditkarte]
[, Dinge = Preis [Bargeld | Scheck |
Kreditkarte] ]...
Sie müssen zumindest ein Ding (Objekt) kaufen und den
Preis dafür bezahlen.
Sie können die Zahlungsart aussuchen: eine der Optionen
in den eckigen Klammern.
Sie können auch zusätzliche Objekte kaufen, so viele
Sie wollen. Für jedes Objekt, das Sie kaufen, geben
Sie seinen Namen, seinen Preis und (fakultativ) die
Zahlungsart an.
charset
[-PKennwort]
[-SServer]
[-ISchnittstelle]
Sortierreihenfolge | Zeichensatz
pub_id pub_name city state
------ --------- ---------- -----
0736 New Age Books Boston MA
0877 Binnet & Hardley Washington DC
(2 rows affected)
Für jede Sybase-Installation, für die ein Kundendienst-Vertrag abgeschlossen
wurde, werden Personen bestimmt, die im Bedarfsfall Kontakt zum
technischen Kundendienst von Sybase aufnehmen. Wenn Sie ein Problem
haben, das Sie weder mit der Dokumentation noch mit der Online-Hilfe lösen
können, bitten Sie die in Ihrer Organisation vorgesehene Person, mit dem
technischen Kundendienst von Sybase oder der Sybase-Geschäftsstelle in
Ihrem Bereich Kontakt aufzunehmen.
xvi Adaptive Server Enterprise

KAPITEL 1 Server mit dem dataserver-
Dienstprogramm einrichten
Einführung
Adaptive Server Version 12.5 verwendet nicht mehr die buildmaster-
Binärdatendatei, um das Master-Device zu erstellen. Stattdessen hat
Sybase die buildmaster-Funktionalität in dataserver integriert. In diesem
Kapitel wird beschrieben, wie Sie dataserver zum Einrichten Ihres Servers
verwenden.
Thema Seite
Einführung 1
Ein neues Master-Device einrichten 2
Hinweis Die dataserver-Binärdatendatei hat unter Windows NT den
Namen sqlsrvr.exe. Wenn Sie die Windows NT-Plattform verwenden,
ersetzen Sie alle Verweise auf dataserver in diesem Kapitel durch sqlsrvr.
Eine ausführliche Beschreibung der dataserver-Syntax finden Sie unter
dataserver auf Seite 188. Eine ausführliche Beschreibung der sqlsrvr-
Syntax finden Sie unter sqlsrvr auf Seite 259.
Mit dem Befehl dataserver können Sie Master-Devices und Datenbanken
mit logischen Seitengrößen von 2 KByte, 4 KByte, 8 KByte oder
16 KByte erstellen. Größere logische Seiten ermöglichen Ihnen, größere
Zeilen zu erstellen, die Adaptive Server die Möglichkeit geben, auf mehr
Daten bei jedem Seitenlesen zuzugreifen. Eine 16-KByte-Seite zum
Beispiel kann das Achtfache der Datenmenge einer 2-KByte-Seite
aufnehmen, eine 8-KByte-Seite das Vierfache einer 2-KByte-Seite
usw.; dies gilt für alle Größen von logischen Seiten.
Dienstprogramme 1

Ein neues Master-Device einrichten
Da die logische Seitengröße eine serverweite Einstellung ist, können Sie keine
Datenbanken mit unterschiedlichen logischen Seitengrößen auf demselben
Server einrichten. Die Größe aller Tabellen wird entsprechend angepasst,
so dass die Zeilengröße die aktuelle Seitengröße des Servers nicht
überschreitet. Das heißt, Zeilen können sich nicht über mehrere Seiten
erstrecken.
Ein neues Master-Device einrichten
In diesem Abschnitt wird der Vorgang zur Erstellung eines neuen Master-
Device anhand des Dienstprogramms dataserver beschrieben. Das Master-
Device wird unter Verwendung des build-Modus in dataserver eingerichtet.
Nachdem das Master-Device eingerichtet worden ist, fährt der Server herunter.
Sie müssen nun den Server manuell im start-Modus starten. Danach können
Sie Adaptive Server nach Bedarf jederzeit starten, stoppen und erneut starten,
ohne dass Sie das Master-Device neu einrichten müssen.
Adaptive Server verwendet drei Typen von Seitengrößen:
Logische Seitengröße – dies sind die Seiten, mit denen die
Datenbankobjekte eingerichtet werden. Eine Datenbank und alle sich
auf sie beziehenden Objekte müssen dieselbe logische Seitengröße
verwenden. Logische Seitengrößen sind 2 KByte, 4 KByte, 8 KByte
und 16 KByte.
Virtuelle Seitengröße – dies ist die physische Seitenzuweisung auf der
Plattenspeicher-Ebene, die immer in 2-KByte-Seiten erfolgt. Alle I/O-
Vorgänge werden als Vielfaches der virtuellen Seitengröße durchgeführt.
Speicher-Seitengröße – der Speicher, der innerhalb von Adaptive Server
zugewiesen und verwaltet wird. Die Speicher-Seitengröße besteht immer
aus Einheiten von 2-KByte-Seiten.
Die folgende Syntax erstellt ein neues Master-Device mit dataserver:
dataserver -dDevice_Name
. . .
-b [Master_Device_Größe [k|K|m|M|g|G]
[-z logische_Seitengröße [k|K]
-h
2 Adaptive Server Enterprise

Wobei gilt:
Kapitel 1 Das isql-Dienstprogramm verwenden
-d Device_Name ist der vollständige Pfad des Device für die master-
Datenbank. Das Master-Datenbankdevice muss für den Benutzer,
der Adaptive Server startet, beschreibbar sein. Der standardmäßige
master-Datenbankdevicename lautet d_master.
-b gibt an, dass dataserver sich im Einrichtmodus befindet und ein neues
Master-Device erstellt, und zeigt die Größe des Master-Device an. Wenn
Sie keine Einheit (k, m oder g) für die Größe des Device anführen, nimmt
dataserver eine Größe in virtuellen Seiten an. Die Größe einer virtuellen
Seite ist immer 2 KByte. Beispiel:
-b 51204 legt ein Device von 51.204 virtuellen Seiten (100,0078125
MByte) fest.
-b 100M gibt ein Device von 100 MByte an.
-z legt die logische Seitengröße fest, die immer 2K, 4K, 8K oder 16K beträgt.
Das heißt, eine logische Seite = N virtuelle Seiten. Dieser Parameter ist
während der Einrichtphase fakultativ und wird im Start-Modus ignoriert.
Wenn Sie keinen -z-Parameter während des Einrichtmodus angeben,
wird das Master-Device mit logischen Seiten von 2 KByte erstellt.
-h druckt die Syntax für den dataserver-Befehl.
Unter dataserver auf Seite 188 finden Sie eine vollständige Liste der
dataserver-Parameter sowie ihre Definitionen.
Betriebsumgebungen für dataserver
Wenn Sie eine Adaptive Server-Installation mit dem dataserver-Programm
starten, entnimmt Adaptive Server seine Betriebsumgebung aus:
der Konfigurationsdatei, die Sie in -c Konfigurationsdatei festgelegt haben
der Standard-Konfigurationsdatei servername.cfg, sofern Sie den
Parameter -c nicht angegeben haben
Standardwerten, sofern Sie weder -c Konfigurationsdatei noch
servername.cfg angegeben haben
Weitere Hinweise zu diesen Konfigurationsparametern finden Sie in
Kapitel 17, „Konfigurationsparameter einstellen“, in der Dokumentation
Systemadministration für Adaptive Server Enterprise.
Dienstprogramme 3

Ein neues Master-Device einrichten
Einrichtmodus
Um eine neue Adaptive Server-Installation einzurichten, verwenden Sie
dataserver mit den Optionen -b und -z. Zum Beispiel:
So richten Sie ein 100-MByte-Master-Device ein, wobei die logische
Standard-Seitengröße (2 KByte) verwendet wird, und starten den Server:
dataserver -d /var/sybase/masterdb.dat -b100M -sMASTER2K
So richten Sie ein 100-MByte-Master-Device mit einer logischen
Seitengröße von 4 KByte ein:
dataserver -d /var/sybase/masterdb.dat -b100M -z4K -sMASTER4K
So richten Sie ein Master-Device von 102.400 virtuellen Seiten mit
der Größe von 2 KByte ein, erstellen Datenbanken mit einer logischen
Seitengröße von 8 KByte und fahren den Server hoch:
dataserver -d /var/sybase/masterdb.dat -b102400 -z8K -sMASTER8K
Wenn der angeforderte Platzbedarf (102.400 x 2 KByte = 200 MByte)
nicht ausreicht, um alle benötigten Systemdatenbanken mit der angegebenen
logischen Seitengröße einzurichten, wird eine Fehlermeldung ausgegeben,
und der Vorgang schlägt fehl.
Beispiel Es folgt ein Beispiel der Ausgabe von dataserver, wobei ein 200-MByte-
Device mit einer logischen Seitengröße von 2 KByte namens personnel2k
eingerichtet wird:
dataserver -d /var/sybase/personnel2k.dat -b200M -z2k -sPERSONNEL2K
dataserver verwendet eine Standard-Konfigurationsdatei, wenn Sie keine
angeben:
00:00000:00000:2001/04/16 10:24:31.73 kernel Warning: Using default file
'/var/sybase/PERSONNEL2K.cfg' since a configuration file was not specified.
Specify a configuration file name in the RUNSERVER file to avoid this
message.
Um Ihre eigene Konfigurationsdatei anzugeben, verwenden Sie den Parameter
-c von dataserver. Weitere Hinweise finden Sie in Kapitel 11, „Konfigurationsparameter
einstellen“, in der Dokumentation Systemadministration für
Adaptive Server Enterprise.
4 Adaptive Server Enterprise

Kapitel 1 Das isql-Dienstprogramm verwenden
Adaptive Server Version 12.5 behandelt jede Installation als ein Upgrade,
unabhängig davon, ob Sie bereits eine Version von Adaptive Server haben oder
nicht. Daher erhalten Sie bei Ausführung von dataserver die folgende Ausgabe:
00:00000:00001:2001/04/16 10:24:32.63 server Database 'master' appears to
be at an older revision than the present installation; SQL Server will assess
it, and upgrade it as required.
00:00000:00001:2001/04/16 10:24:32.66 server Database 'master': beginning
upgrade step [ID 1]: Initialize disk and create empty allocation units on
master device.
00:00000:00001:2001/04/16 10:24:34.74 server Database 'master': beginning
upgrade step [ID 2]: Bootstrap basic system catalogs in database.
dataserver fährt mit der Erstellung der master-Datenbank fort, einschließlich
aller Tabellen wie systypes, sysobjects und sysusages:
00:00000:00001:2001/04/16 10:24:35.21 server Database 'master': beginning
upgrade step [ID 3]: creating index (table systypes, index ncsystypes)
00:00000:00001:2001/04/16 10:24:35.36 server Database 'master': beginning
upgrade step [ID 4]: creating index (table sysobjects, index ncsysobjects)
00:00000:00001:2001/04/16 10:24:35.44 server Database 'master': beginning
upgrade step [ID 20]: creating table (table sysusages)
[...]
Wenn dataserver die master-Datenbank erstellt hat, wird die model-Datenbank
erstellt:
[...]
00:00000:00001:2001/04/16 10:24:43.14 server Database 'model' appears to
be at an older revision than the present installation; SQL Server will assess
it, and upgrade it as required.
00:00000:00001:2001/04/16 10:24:43.14 server Database 'model': beginning
upgrade step [ID 1]: Initialize disk and create empty allocation units on
master device.
00:00000:00001:2001/04/16 10:24:43.83 server Database 'model': beginning
upgrade step [ID 2]: Bootstrap basic system catalogs in database.
00:00000:00001:2001/04/16 10:24:43.89 server Database 'model': beginning
upgrade step [ID 3]: creating index (table systypes, index ncsystypes)
00:00000:00001:2001/04/16 10:24:43.91 server Database 'model': beginning
upgrade step [ID 4]: creating index (table sysobjects, index ncsysobjects)
[...]
Dienstprogramme 5

Ein neues Master-Device einrichten
Wenn dataserver die model-Datenbank erstellt hat, werden die Datenbanken
tempdb und sybsystemdb erstellt:
[...]
00:00000:00001:2001/04/16 10:24:45.23 server CREATE DATABASE: allocating
1024 logical pages (2.0 megabytes) on disk 'master'.
00:00000:00001:2001/04/16 10:24:46.79 server Database sybsystemdb
successfully created.
[...]
dataserver war erfolgreich, wenn der Server die standardmäßige
Sortierreihenfolge ändert und herunterfährt:
[...]
00:00000:00001:2001/04/16 10:24:47.23 server Now loading SQL Server's new
default sort order and character set
[...]
00:00000:00001:2001/04/16 10:24:47.31 server Default Sort Order
successfully changed.
00:00000:00001:2001/04/16 10:24:47.37 server SQL Server shutdown after
verifying System Indexes.
00:00000:00001:2001/04/16 10:24:47.37 kernel ueshutdown: exiting
Fehlermeldungen Falls dataserver fehlgeschlagen ist, können Sie den Server nicht auf dem
Master-Device hochfahren, und es wird folgende Fehlermeldung ausgegeben:
00:00000:00001:2001/04/16 19:02:39.53 kernel Use license file
/var/sybase/SYSAM-1_0/licenses/license.dat.
00:00000:00001:2001/04/16 19:02:39.54 kernel The master device's
configuration area appears to be corrupt. The server needs this data to boot,
and so cannot continue. The server will shut down.
Wenn Sie dataserver mit einer benutzerdefinierten Konfigurationsdatei
ausführen, die Optionen enthält, die die Zuweisung eines gemeinsam
genutzten Segments und den Start eines Servers verhindern, schlägt dataserver
fehl und gibt eine Fehlermeldung aus. Sie können in diesem Fall den Server
nicht auf dem Master-Device hochfahren:
00:00000:00001:2001/04/16 19:04:01.11 kernel Use license file
/var/sybase/SYSAM-1_0/licenses/license.dat.
00:00000:00000:2001/02/09 19:04:01.25 kernel Using config area from primary
master device.
00:00000:00001:2001/04/16 19:04:01.36 server The value of the 'max
total_memory' parameter (33792) defined in the configuration file is not
high enough to set the other parameter values specified in the configuration
file. 'max total_memory' should be greater than the logical memory '34343'.
6 Adaptive Server Enterprise

Start-Modus
Kapitel 1 Das isql-Dienstprogramm verwenden
Um eine vorhandene Adaptive Server-Installation zu starten, geben Sie
dataserver ohne die Optionen -b und -z aus.
dataserver -d /sybase/masterdb.dat
Upgrade zu einem Server mit größeren Seitengrößen
Adaptive Server vor der Version 12.5 haben logische Seitengrößen von
2 KByte verwendet. Sie können die Seitengrößen einer Installation nicht
durch ein Upgrade ändern. Das heißt, wenn Ihre derzeitige Adaptive Server-
Installation logische Seiten von 2 KByte verwendet, kann das Ergebnis des
Upgrades nur ein Adaptive Server sein, der ebenfalls logische Seiten von
2 KByte verwendet.
Sie können allerdings Datenbanken mit logischen 2-KByte-Seiten aus früheren
Versionen von Adaptive Server migrieren. Hinweise dazu, wie Sie das dataxtr-
Datenmigrations-Tool einsetzen, finden Sie in den Adaptive Server Enterprise-
Versionshinweisen für Ihre Plattform.
Die aktuellen Server-Beschränkungen anzeigen
So zeigen Sie Informationen über die Beschränkungen einer Adaptive Server-
Installation an:
Die Ausgabe von dbcc serverlimits enthält die logische Seitengröße Ihres
Servers. Dazu geben Sie beispielsweise ein:
dbcc serverlimits
Suchen Sie nach der Zeichenfolge „logical page size“ im Fehlerlog.
Die globale Variable @@maxpagesize zeigt die logische Seitengröße des
Servers an. Geben Sie an der isql-Eingabeaufforderung Folgendes ein:
select @@maxpage size
-----------
8192
Dienstprogramme 7

Ein neues Master-Device einrichten
8 Adaptive Server Enterprise

KAPITEL 2 Das isql-Dienstprogramm
verwenden
Vorbereitungen
Dieses Kapitel beschreibt das interaktive SQL-Dienstprogramm isql.
Thema Seite
Vorbereitungen 9
isql starten und stoppen 10
Transact-SQL in isql verwenden 10
Das Befehlsabschlusszeichen ändern 13
Wechselwirkung von Performance-Statistik und
Befehlsabschlusszeichen-Werten
14
Netzwerkpaketgröße einstellen 15
Eingabe- und Ausgabedateien 16
Eine ausführliche Beschreibung der isql-Syntax finden Sie unter isql auf
Seite 227.
Wenn Sie Open Client Version 11.1 oder später ausführen und eine
externe Sybase-Konfigurationsdatei verwenden, müssen Sie Folgendes
Ihrer Konfigurationsdatei hinzufügen, um isql zu aktivieren:
[CTISQL]
Dienstprogramme 9

isql starten und stoppen
isql starten und stoppen
Um isql zu starten, geben Sie an der Betriebssystem-Eingabeaufforderung
den folgenden Befehl ein:
isql
Wenn die Eingabeaufforderung erscheint, geben Sie Ihr Kennwort ein.
Das Kennwort wird während der Eingabe nicht angezeigt. Die isql-
Eingabeaufforderung wird angezeigt:
1>
Sie können nun Transact-SQL-Befehle eingeben.
Um isql zu beenden, geben Sie einen der folgenden Befehle in einer neuen
Zeile ein:
quit
exit
Transact-SQL in isql verwenden
isql sendet Transact-SQL-Befehle an Adaptive Server, wobei die Ergebnisse
formatiert und an die Standardausgabe ausgegeben werden. Es gibt keine
maximale Größe für eine isql-Anweisung. Weitere Hinweise zur Verwendung
von Transact-SQL finden Sie in der Dokumentation Transact-SQL
User’s Guide.
Hinweis Um Transact-SQL mit dem Dienstprogramm isql direkt vom
Betriebssystem aus verwenden zu können, müssen Sie ein Konto (Login)
auf Adaptive Server haben.
Um einen Transact-SQL-Befehl auszuführen, geben Sie das Standard-
Befehlsabschlusszeichen „go“ auf einer neuen Zeile ein.
10 Adaptive Server Enterprise

Beispiel:
isql
Kennwort:
isql-Ausgabe formatieren
1> use pubs2
2> go
1> select *
2> from authors
3> where city = "Oakland"
4> go
Kapitel 2 Das isql-Dienstprogramm verwenden
Tabelle 2-1 beschreibt die Optionen, die das Format der isql-Ausgabe ändern:
Tabelle 2-1: Formatoptionen bei isql
Option Standardwerte Bedeutung
-h Headers 1 Anzahl der Zeilen, die zwischen Spaltentiteln
anzuzeigen ist
-s Spaltentrennzeichen Einzelne Leerstelle Ändert das Spaltentrennzeichen
-w Spaltenbreite 80 Zeichen Ändert die Zeilenbreite
-e Bezieht jeden an isql ausgegebenen Befehl in die
Ausgabe ein
-n Entfernt Nummerierung und
Eingabeaufforderungssymbole
In diesem Beispiel werden die Ergebnisse der Abfrage in eine Datei namens
output geschrieben:
isql -Uuser_name -Ppassword -Sserver -e -n -o output
use pubs2
go
select *
from authors
where city = "Oakland"
go
quit
Um den Inhalt von output anzuzeigen, geben Sie Folgendes ein:
Unter Windows NT:
type output
Dienstprogramme 11

Transact-SQL in isql verwenden
Auf UNIX-Plattformen:
cat output
select *
from authors
where city = "Oakland"
au_id au_lname au_fname
phone address
city state country postalcode
----------- -------------------------------------------- -----------
--------
---------- ----------------------------------------
------------------ ---- ----------- -----------
213-46-8915 Green Marjorie
415 986-7020 309 63rd St. #411
Oakland CA USA 94618
274-80-9391 Straight Dick
415 834-2919 5420 College Av.
Oakland CA USA 94609
724-08-9931 Stringer Dirk
415 843-2991 5420 Telegraph Av.
Oakland CA USA 94609
724-80-9391 MacFeather Stearns
415 354-7128 44 Upland Hts.
Oakland CA USA 94612
756-30-7391 Karsen Livia
415 534-9219 5720 McAuley St.
Oakland CA USA 94609
Eingabe korrigieren
Hinweis Die output-Datei enthält nicht das Befehlsabschlusszeichen.
Wenn Sie einen Fehler machen, während Sie einen Transact-SQL-Befehl
eingeben, haben Sie folgende Möglichkeiten:
Drücken Sie Strg-c oder geben Sie das Wort „reset“ auf einer eigenen
Zeile ein. Daraufhin wird der Abfragepuffer bereinigt und die isql-
Eingabeaufforderung angezeigt.
Schreiben Sie den Namen Ihres Texteditors auf eine eigene Zeile. Dadurch
wird eine Textdatei geöffnet, in der Sie die Abfrage bearbeiten können.
Wenn Sie die Datei bearbeitet und gespeichert haben, kehren Sie zu isql
zurück, und die korrigierte Abfrage wird angezeigt. Geben Sie „go“ ein,
um sie auszuführen.
12 Adaptive Server Enterprise

set-Optionen, die sich auf die Ausgabe auswirken
Kapitel 2 Das isql-Dienstprogramm verwenden
Tabelle 2-2 listet die set-Optionen auf, die die Transact-SQL-Ausgabe
betreffen. Ausführliche Hinweise zu set finden Sie in der Dokumentation
Reference Manual.
Tabelle 2-2: set-Optionen, die sich auf die Transact-SQL-Ausgabe
auswirken
set-Option Standardwerte Bedeutung
char_convert Aus Schaltet die Zeichensatzkonvertierung zwischen Adaptive Server und
einem Client ein und aus; startet außerdem eine Konvertierung zwischen
dem Serverzeichensatz und einem unterschiedlichen Clientzeichensatz.
fipsflagger Aus Warnt, falls irgendwelche Transact-SQL-Erweiterungen zur Einstiegsebene
SQL92 verwendet werden. Mit dieser Option werden die SQL-
Erweiterungen nicht deaktiviert. Die Prozessverarbeitung wird fortgesetzt,
wenn Sie den nicht zum ANSI-Standard gehörenden SQL-Befehl eingeben.
flushmessage Aus Versendet Meldungen, während sie erzeugt werden.
language us_english Stellt die Sprache für Systemmeldungen ein.
nocount Aus Schaltet die Ausgabe der Anzahl der betroffenen Zeilen aus.
noexec Aus Kompiliert jede Abfrage, führt sie jedoch nicht aus; häufig mit showplan
verwendet.
parseonly Aus Überprüft die Syntax von Abfragen und gibt Fehlermeldungen aus,
ohne die Abfragen zu kompilieren oder auszuführen.
showplan Aus Erzeugt eine Beschreibung des Verarbeitungsplans für eine Abfrage;
gibt keine Ergebnisse aus, wenn die Option innerhalb einer gespeicherten
Prozedur oder eines Triggers verwendet wird.
statistics io
statistics time
Aus Zeigt die Performance-Statistik nach jeder Ausführung an.
statistics Aus Zeigt die Anzahl der Cachetreffer, Cachefehlanzeigen und Zeilen im
subquerycache
Unterabfragencache für jede Unterabfrage an.
textsize 32KB Steuert die Anzahl der Bytes von ausgegebenen Text- oder Bild-Daten.
Das Befehlsabschlusszeichen ändern
Wenn Sie das Befehlsabschlusszeichen-Argument (-c) verwenden, können Sie
Ihr eigenes Abschlusszeichensymbol festlegen. go ist der Standartwert dieser
Option. Sie müssen das Befehlsabschlusszeichen immer ohne vorangestellte
Tabulatoren oder Leerzeichen eingeben.
Dienstprogramme 13

Wechselwirkung von Performance-Statistik und Befehlsabschlusszeichen-Werten
Um zum Beispiel einen Punkt als Befehlsabschlusszeichen zu verwenden,
rufen Sie isql folgendermaßen auf:
isql -c.
Eine isql-Mustersitzung mit diesem Befehlsabschlusszeichen sieht
folgendermaßen aus:
1> select name from sysusers
2> .
name
----------sandy
kim
leslie
(3 rows affected)
Wenn Sie die isql-Befehlsabschlusszeichen-Option in Skripten verwenden
wollen, müssen Sie Ihre Programmierarbeit entsprechend planen:
In Adaptive Server mitgelieferte Skripten, z.B. installmaster, verwenden
„go“. Ändern Sie das Befehlsabschlusszeichen nicht für Sitzungen, die
diese Skripten verwenden.
Ihre eigenen Skripten enthalten möglicherweise bereits „go“. Vergessen
Sie nicht, Ihre Skripten zu aktualisieren, um das Abschlusszeichen
einzufügen, das Sie verwenden möchten.
Wechselwirkung von Performance-Statistik und
Befehlsabschlusszeichen-Werten
isql stellt eine Performance-Statistikoption (-p) zur Verfügung.
Diese Syntax zum Beispiel gibt folgende Statistikdaten zurück:
isql -p
1> select * from sysobjects
2> go
Execution Time (ms.): 1000 Clock Time (ms.): 1000
1 xact:
14 Adaptive Server Enterprise

Kapitel 2 Das isql-Dienstprogramm verwenden
Die Ausgabe bedeutet, dass eine einzelne Transaktion 100 Millisekunden
gebraucht hat. Der Uhrzeitwert bezieht sich auf die gesamte Transaktion,
die beginnt, wenn Client-Library die Abfrage kompiliert, und endet,
wenn Client-Library die Information von Adaptive Server zurückmeldet.
Sie können die Performance-Statistik auf der Grundlage von einer oder
mehreren Transaktionen zusammenstellen. Um die Statistik aus mehr als
einer Transaktion zusammenzustellen, geben Sie eine Zahl nach dem
Befehlsabschlusszeichen ein.
Der folgende Befehl zum Beispiel weist Adaptive Server an, drei select *-
Transaktionen auszuführen und die Performance-Statistik auszugeben:
isql -p
1> select * from sysobjects
2> go 3
Netzwerkpaketgröße einstellen
Execution Time (ms.): 1000 Clock Time (ms.): 1000
Execution Time (ms.): 1000 Clock Time (ms.): 2000
Execution Time (ms.): 1000 Clock Time (ms.): 1000
Execution Time (ms.): 1000 Clock Time (ms.): 4000
3xact:
Das korrekte Einstellen der Netzwerkpaketgröße kann die Performance von
Adaptive Server erheblich verbessern.
Die Option -A Größe gibt die Netzwerkpaketgröße an, die in einer isql-Sitzung
verwendet werden soll. Um zum Beispiel die Paketgröße auf 2048 Byte für die
aktuelle isql-Sitzung einzustellen, geben Sie Folgendes ein:
Auf UNIX-Plattformen:
isql -A 2048
Unter Windows NT:
load isql -A 2048
Um Ihre Netzwerkpaketgröße zu überprüfen, geben Sie Folgendes ein:
select * from sysprocesses
Dienstprogramme 15

Eingabe- und Ausgabedateien
Der Wert für diese isql-Sitzung wird unterhalb des network_pktsz-Titels in der
Tabelle sysprocesses angezeigt.
Weitere Hinweise zum Einstellen der Netzwerkpaketgröße finden Sie in der
Dokumentation Systemadministration für Adaptive Server Enterprise.
Eingabe- und Ausgabedateien
UNIX-Befehlszeile umleiten
Sie können in der Befehlszeile mit den Optionen -i und -o Eingabe- und
Ausgabedateien festlegen.
isql stellt keine Formatierungsoptionen für die Ausgabe zur Verfügung. Sie
können allerdings die Option -n verwenden, um die isql-Eingabeaufforderungen
und andere Tools zu entfernen, wenn Sie die Ausgabe neu
formatieren möchten.
Wenn Sie die Option -e verwenden, zeigt isql die Eingabe in der Ausgabe an
(Echo). Die resultierende Ausgabedatei enthält sowohl die Abfragen als auch
ihre Ergebnisse.
Die UNIX-Umleitungssymbole „“ stellen einen ähnlichen
Mechanismus wie die Optionen -i und -o zur Verfügung, und zwar
folgendermaßen:
isql -Usa < input > output
Sie können isql anweisen, die Eingabe vom Terminal zu beziehen, wie im
folgenden Beispiel gezeigt:
isql -Usa -PKennwort -SServername Ausgabe
use pubs2
go
select * from table
go
EOF
„

KAPITEL 3 Daten mit bcp in und aus
Adaptive Server übertragen
Dieses Kapitel beschreibt, wie Sie mit dem Dienstprogramm für den
Massenexport/-import von Daten, bcp, Daten zwischen Adaptive Server
und einer Betriebssystemdatei verschieben.
Thema Seite
Methoden zum Verschieben von Daten 18
bcp-Anforderungen 19
bcp-Modi 21
bcp-Performance 22
Die bcp-Optionen verwenden 35
Die Standardwerte ändern: Interaktiver bcp 38
Formatdateien verwenden 50
Beispiele: Daten interaktiv exportieren 54
Beispiele: Daten interaktiv importieren 57
bcp mit anderen Sprachen verwenden 61
Importieren und Anweisungsfolgedateien 62
Exportieren und Text- und Bilddaten 64
Netzwerkpaketgröße festlegen 65
Importieren und Fehlerdateien 65
Exportieren und Fehlerdateien 67
Datenintegrität: Standardwerte, Regeln und Trigger 67
Wie unterscheidet sich bcp von anderen Dienstprogrammen? 68
bcp ist eine bequeme und schnelle Methode zum Übertragen von Daten
zwischen einer Datenbanktabelle oder Ansicht und einer Betriebssystemdatei.
bcp kann Dateien in verschiedenen Formaten lesen oder schreiben.
Wenn Sie aus einer Datei in die Tabelle kopieren, fügt bcp Daten in eine
vorhandene Datenbanktabelle ein. Wenn Sie aus einer Tabelle in eine
Datei kopieren, überschreibt bcp den vorhandenen Inhalt der Datei.
Ausführliche Hinweise zur Syntax von bcp finden Sie unter bcp auf
Seite 164.
Dienstprogramme 17

Methoden zum Verschieben von Daten
Methoden zum Verschieben von Daten
Daten mit bcp
Sie können die folgenden Methoden verwenden, um Daten in und aus Ihren
Adaptive Server-Datenbanken zu verschieben:
bcp als Standalone-Programm vom Betriebssystem. Dieses Kapitel enthält
Hinweise zu dieser Methode.
Client Library, um Bibliotheks-Routinen für die Massenmaterialisierung
aufzurufen. Ausführliche Hinweise zur Client Library finden Sie in der
Dokumentation Open Client and Open Server Common Libraries
Reference Manual.
Transact-SQL-Befehle können Daten nicht mit Massenmaterialisierung
übertragen. Daher müssen Sie bei großen Übertragungsmengen bcp
verwenden. Sie können bcp für die folgenden Aufgaben verwenden:
Daten importieren, die vorher einem anderen Programm zugeordnet
waren, wie zum Beispiel Datensätze von einem anderen Datenbank-
Managementsystem. Dies ist die gängigste Verwendung von bcp.
Bevor Sie bcp verwenden können, müssen Sie eine Datei der zu
importierenden Datensätze erstellen. Gehen Sie folgendermaßen vor:
a Legen Sie die zu übertragenden Daten in eine Betriebssystemdatei.
b Führen Sie bcp von der Befehlszeile des Betriebssystems aus.
Verschieben Sie Tabellen zwischen Adaptive Server-Installationen oder
zwischen einer Adaptive Server-Installation und anderen Datenquellen,
die eine Betriebssystemdatei generieren können.
Kopieren Sie Daten aus einer Ansicht. Unter bcp auf Seite 164 wird die
Syntax beschrieben, mit der bcp Daten aus einer Ansicht kopiert.
Hinweis Sie können mit bcp keine Daten in eine Ansicht kopieren.
18 Adaptive Server Enterprise

cp-Anforderungen
Grundlegende
Anforderungen
Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Übertragen Sie Daten zur Verwendung mit anderen Programmen, zum
Beispiel mit einem Tabellenkalkulationsprogramm. Führen Sie folgende
Schritte durch, um Daten zu übertragen:
a Verwenden Sie bcp, um die Daten von einer Adaptive Server-
Installation in eine Betriebssystemdatei zu verschieben. Von hier
aus kann das andere Programm die Daten importieren.
b Wenn Sie die Bearbeitung Ihrer Daten mit dem anderen Programm
abgeschlossen haben, kopieren Sie die Daten in eine Betriebssystemdatei
und übertragen Sie sie mit bcp in die Adaptive Server-
Installation.
Adaptive Server kann Daten in jedem Zeichen- oder Binärformat annehmen,
solange die Datendatei entweder die Länge der Felder oder die
Abschlusszeichen (Zeichen zur Trennung von Spalten) angibt.
Für bcp müssen die Strukturen der von der Übertragung betroffenen Tabellen
nicht identisch sein, und zwar aus folgenden Gründen:
Beim Import aus einer Datei werden die Daten an eine vorhandene
Datenbanktabelle angehängt.
Beim Export in eine Datei wird der vorherige Inhalt der Datei
überschrieben.
Nach dem Abschluss des Kopiervorgangs gibt bcp die folgenden
Informationen aus: Anzahl der Zeilen, in die erfolgreich Daten kopiert wurden,
Anzahl der Zeilen (falls vorhanden), die nicht kopiert werden konnten,
Gesamtdauer des Kopiervorgangs, durchschnittliche Zeit in Millisekunden
für das Kopieren einer Zeile, Anzahl der kopierten Zeilen pro Sekunde.
Bevor Sie das Dienstprogramm bcp verwenden können, müssen Sie einige
grundlegende Informationen eingeben sowie die Daten für die Übertragung
und den Befehl für den Datenzugriff vorbereiten.
Sie müssen die folgenden Informationen zur Verfügung stellen, um erfolgreich
Daten in eine und aus einer Adaptive Server-Installation zu übertragen:
Name der Datenbank und der Tabelle oder Ansicht
Name der Betriebssystemdatei
Richtung der Übertragung (in oder out)
Dienstprogramme 19

cp-Anforderungen
Darüber hinaus können Sie bcp verwenden, um wahlweise den Speichertyp,
die Speicherlänge und das Abschlusszeichen der einzelnen Spalten zu ändern.
Berechtigungen Um bcp verwenden zu können, müssen Sie ein Adaptive Server-Konto und die
entsprechenden Berechtigungen für die Datenbanktabellen oder Ansichten und
Betriebssystemdateien haben, die Sie übertragen werden.
Um Daten in eine Tabelle kopieren zu können, müssen Sie über die insertund
select-Berechtigung für die Tabelle verfügen.
Um eine Tabelle in eine Betriebssystemdatei kopieren zu können, müssen
Sie über die select-Berechtigung für die folgenden Tabellen verfügen:
die zu kopierende Tabelle
sysobjects
syscolumns
sysindexes
Vorbereitende Tasks Bevor Sie bcp in verwenden können, müssen Sie den Befehl und die Daten für
die Übertragung vorbereiten:
Um schnellen oder langsamen bcp zu verwenden, stellen Sie select
into/bulkcopy/pllsort auf true ein. Beispiel: Um diese Option für die
Datenbank pubs2 zu aktivieren, können Sie Folgendes eingeben:
sp_dboption pubs2, "select into/bulkcopy/pllsort", true
Weitere Informationen finden Sie unter „bcp-Modi“ auf Seite 21.
Um schnellen bcp zu verwenden, entfernen Sie Indizes und Trigger in
der Zieltabelle. Weitere Hinweise zu dieser Anforderung finden Sie unter
„bcp-Performance“ auf Seite 22.
Zusätzlich:
Wenn Sie Open Client Version 11.1 oder später ausführen und eine
externe Sybase-Konfigurationsdatei verwenden, müssen Sie Folgendes
hinzufügen, um bcp zu aktivieren:
[BCP]
Sie müssen die SYBASE-Umgebungsvariable auf die Position der
aktuellen Version des Adaptive Servers einstellen, bevor Sie bcp
verwenden können.
20 Adaptive Server Enterprise

cp-Modi
Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Um eine frühere Version von bcp verwenden zu können, müssen Sie
die CS_BEHAVIOR-Eigenschaft im [bcp]-Abschnitt der ocs.cfg-
Datei einstellen:
[bcp]
CS_BEHAVIOR = CS_BEHAVIOR_100
Wenn CS_BEHAVIOR nicht auf CS_BEHAVIOR_100 eingestellt ist,
können Sie die Funktionalität nur für bcp 11.1 oder später verwenden.
bcp in kann in zwei Modi ausgeführt werden:
Langsamer bcp – protokolliert alle durchgeführten Zeileneinfügungen;
wird bei Tabellen verwendet, die ein oder mehrere Indizes oder
Trigger haben.
Schneller bcp – protokolliert nur Seitenzuweisungen, wobei Daten so
schnell wie möglich in Tabellen ohne Indizes oder Trigger kopiert werden.
Um den für Ihre Kopieraufgabe geeigneten bcp-Modus zu bestimmen,
berücksichtigen Sie folgende Punkte:
Die Größe der Tabelle, in die Sie Daten kopieren
Die Menge der Daten, die Sie importieren
Die Anzahl der Indizes auf der Tabelle
Die Menge an freiem Datenbankdevice-Speicherplatz, der Ihnen zum
Wiedererstellen der Indizes zur Verfügung steht
Hinweis Schneller bcp steigert zwar möglicherweise die Performance,
langsamer bcp erleichtert Ihnen jedoch die Wiederherstellbarkeit der Daten.
Dienstprogramme 21

cp-Performance
bcp-Performance
Wenn Indizes und Trigger auf der Tabelle verbleiben, wird beim
Massenexport/-import der Daten automatisch langsamer bcp verwendet.
Allerdings füllt langsamer bcp das Transaktionslog sehr schnell.
Wenn Sie eine große Anzahl von Zeilen kopieren, können die
Performance-Einbußen und der Logspeicherplatz-Bedarf bei der
Verwendung von langsamem bcp entscheidend sein.
Bei extrem großen Tabellen ist die Verwendung von langsamem bcp keine
echte Option, weil die Ausführung durch das ausführliche Log extrem
verlangsamt wird.
So können Sie die Performance von bcp steigern:
Verwenden Sie partitionierte Tabellen. Mehrere bcp-Sitzungen mit einer
partitionierten Tabelle können die Zeit, die zum Kopieren von Daten
benötigt wird, deutlich reduzieren. Solche Performance-Steigerungen
sind bei schnellem bcp deutlicher als bei langsamem bcp.
Verwenden Sie bcp im parallelen Modus, um die Performance deutlich
zu verbessern. Paralleler Massenexport/-import der Daten kann eine
ausgeglichene Datenverteilung in den Partitionen bewirken. Weitere
Hinweise finden Sie unter „Mit parallelem Massenexport/-import Daten
in eine bestimmte Partition kopieren“ auf Seite 29.
Schnellen oder langsamen bcp verwenden
Das Vorhandensein von Indizes und Triggern auf Tabellen wirkt sich
auf die Geschwindigkeit der Übertragung aus. Wenn Sie bcp auf solchen
Tabellen verwenden, verwendet bcp automatisch den langsamen Modus,
der Dateneinfügungen im Transaktionslog protokolliert. Dadurch kann
das Transaktionslog sehr groß werden.
Um diese Datenmassen zu bewältigen und um sicherzustellen, dass die
Datenbank bei einem Ausfall voll wiederherstellbar ist, können Sie das
Log mit dump transaction sichern.
Hinweis bcp löst keinen Trigger auf der Zieltabelle aus.
22 Adaptive Server Enterprise

Tabellen mit Indizes
oder Triggern
kopieren
Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Schneller bcp protokolliert nur Seitenzuweisungen. Beim Kopieren von Daten
in eine Tabelle ist bcp am schnellsten, wenn Ihre Datenbanktabelle keine
Indizes oder Trigger hat.
Wenn Sie allerdings langsamen bcp verwendet haben, um Dateneinfügungen
durchzuführen (die vom schnellen bcp nicht protokolliert werden), können Sie
das Transaktionslog nicht mit einem dump-Befehl auf einem Device sichern.
Die Änderungen sind nicht im Log verzeichnet und ein Zurückladen der nicht
vorhandenen Sicherungsdaten ist nicht möglich. Die erforderliche Sicherung
(dump transaction) erzeugt eine Fehlermeldung, in der Sie aufgefordert werden,
statt dessen dump database zu verwenden. Diese Einschränkung bleibt bis zur
erfolgreichen Ausführung von dump database bestehen.
Weitere Hinweise zu dump database und dump transaction finden Sie in den
Dokumentationen Systemadministration für Adaptive Server Enterprise und
Reference Manual.
Das bcp-Programm ist optimal darauf abgestimmt, Daten in Tabellen zu laden,
die keine ihnen zugeordneten Indizes oder Trigger haben. Das Programm
kopiert so schnell wie möglich Daten in Tabellen ohne Indizes oder Trigger
und beschränkt dabei die Protokollierung im Transaktionslog auf ein
Minimum. Seitenzuordnungen werden logmäßig erfasst, die Einfügung
von Zeilen hingegen nicht.
Wenn Sie Daten in eine Tabelle kopieren, die einen oder mehrere Indizes oder
Trigger hat, wird automatisch eine langsamere Version von bcp verwendet, die
die Zeileneinfügungen protokolliert. Dies gilt auch für Indizes, die implizit mit
der eindeutigen Identitätsregel einer create table-Anweisung erstellt wurden.
bcp erzwingt jedoch keine anderen Integritätsregeln, die für eine Tabelle
definiert sind.
Standardmäßig ist die select into/bulkcopy/pllsort-Option in neu erstellten
Datenbanken auf false (aus) eingestellt. Um diesen Standardwert zu ändern,
schalten Sie diese Option in der model-Datenbank ein.
Hinweis Das Log kann während langsamem bcp stark anwachsen, da
das bcp-Programm Einfügungen in einer Tabelle mit Indizes und Triggern
protokolliert. Nachdem der Massenexport/-import der Daten abgeschlossen ist,
stellen Sie mit dump database eine Sicherung der Datenbank her und kürzen
dann das Log mit dump transaction, nachdem der Massenexport/-import
der Daten abgeschlossen ist und Sie Ihre Datenbank mit dump database
gesichert haben.
Dienstprogramme 23

cp-Performance
Während die select into/bulkcopy/pllsort-Option eingeschaltet ist, können
Sie das Transaktionslog nicht sichern. Die Ausgabe der Anweisung dump
transaction erzeugt eine Fehlermeldung, in der Sie aufgefordert werden,
stattdessen dump database zu verwenden.
Achtung! Sichern Sie Ihre Datenbank, bevor Sie die select into/bulkcopy/pllsort-
Option ausschalten. Wenn Sie unprotokollierte Daten in Ihre Datenbank
eingefügt haben und Sie dump transaction vor dump database durchführen,
werden Sie nicht in der Lage sein, Ihre Daten wiederherzustellen.
Schneller bcp läuft langsamer, während ein dump database-Befehl
ausgeführt wird.
Tabelle 3-1 zeigt, welche Version von bcp beim Importieren verwendet wird,
welche Einstellungen für die select into/bulkcopy/pllsort-Option erforderlich
sind und ob ein Transaktionslog geführt wird und gesichert werden kann.
Tabelle 3-1: Vergleiche von schnellem und langsamem bcp
select into/bulkcopy/pllsort ein aus
schneller bcp (keine Indizes oder OK
bcp nicht zulässig
Trigger auf Zieltabelle)
dump transaction nicht zulässig dump transaction
langsamer bcp (ein oder mehrere
Indizes oder Trigger)
Hinweis Die Performance-Einbuße beim Kopieren von Daten in eine Tabelle,
die Indizes und Trigger enthält, kann schwerwiegend sein. Wenn Sie eine sehr
große Anzahl von Zeilen kopieren, kann es schneller sein, alle Indizes und
Trigger im Voraus mit drop index (oder alter table bei Indizes, die mit einer
Eindeutigkeits-Integritätsregel erstellt sind) und drop trigger zu löschen, die
Datenbankoption einzustellen, die Daten in die Tabelle zu kopieren, die Indizes
und Trigger neu zu erstellen und dann die Datenbank zu sichern. Denken
Sie daran, Plattenspeicherplatz für die Erstellung der Indizes und Trigger
zuzuweisen: ungefähr 2,2 Mal die Menge des Speicherplatzes, der für die
Daten benötigt wird.
24 Adaptive Server Enterprise
OK
dump transaction nicht zulässig
OK
dump transaction OK

Datenbanken für
schnellen bcp
konfigurieren
Indizes und
Trigger löschen
Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Um einem Benutzer das Kopieren von Daten mit schnellem bcp zu
ermöglichen, muss der Systemadministrator oder Datenbankeigentümer
zunächst mit sp_dboption den Befehl select into/bulkcopy/pllsort auf der
Datenbank, die die Zieltabellen enthält, auf true einstellen. Wenn die Option
auf false gesetzt ist und ein Benutzer versucht, mit schnellem bcp Daten in
eine Tabelle zu kopieren, die keine Indizes oder Trigger hat, erzeugt Adaptive
Server eine Fehlermeldung.
Hinweis Sie müssen die select into/bulkcopy/pllsort-Option nicht auf true setzen,
um Daten aus einer Tabelle zu exportieren oder in eine Tabelle zu importieren,
die Indizes und Trigger hat. Langsames bcp kopiert stets Tabellen mit Indizes
und Triggern und protokolliert alle Einfügungen.
Standardmäßig ist die Option select into/bulkcopy/pllsort in neu erstellten
Datenbanken auf false (aus) eingestellt. Um die Standardeinstellung für
zukünftige Datenbanken zu ändern, aktivieren Sie die Option (eingestellt
auf true) in der model-Datenbank.
Wenn Sie eine große Anzahl von Zeilen kopieren, muss der Speicherplatz
1,2 Mal größer sein als die vorhandene Datenmenge. Außerdem muss der
Speicherplatz für den Server groß genug sein, um einen Clustered-Index
wieder aufzubauen.
Wenn ausreichend Platz vorhanden ist, können Sie mit drop index und drop
trigger alle Indizes und Trigger vorher löschen.
Wenn nicht genügend Platz vorhanden ist, um die Daten zu sortieren und
den Index oder die Indizes zu kompilieren, verwenden Sie langsames bcp.
Daten mit schnellem bcp importieren
Tabelle 3-2 fasst die Schritte beim Importieren von Daten in eine Adaptive
Server-Installation unter Verwendung von schnellem bcp zusammen.
Tabelle 3-2: Schritte beim Importieren von Daten mit schnellem bcp
Schritt Berechtigung
Stellen Sie den Befehl select into/bulkcopy/pllsort mit sp_dboption Systemadministrator oder
auf true ein.
Datenbankeigentümer
Führen Sie in der geänderten Datenbank den Befehl checkpoint aus.
Vergewissern Sie sich, dass Sie genügend Speicherplatz haben, um etwaige
Indizes oder Trigger auf der Tabelle neu erstellen zu können.
Löschen Sie die Indizes und Trigger auf der Tabelle.
Tabelleneigentümer
Dienstprogramme 25

cp-Performance
Schritt Berechtigung
Vergewissern Sie sich, dass Sie über die insert-Berechtigung für
die Tabelle verfügen.
Vom Tabelleneigentümer erteilt
Führen Sie den Import mit bcp aus. Alle Benutzer mit insert-Berechtigung
Erstellen Sie die Indizes und Trigger neu. Tabelleneigentümer
Stellen Sie sp_dboption gegebenenfalls neu ein und führen Sie checkpoint
in der Datenbank aus, die geändert wurde.
Systemadministrator oder
Datenbankeigentümer
Verwenden Sie dump database, um die eben eingefügten Daten zu sichern. Systemadministrator, Operator oder
Datenbankeigentümer
Führen Sie gespeicherte Prozeduren oder Abfragen aus, um festzustellen,
ob die neu geladenen Daten Regeln verletzen.
Tabelleneigentümer oder Eigentümer
der gespeicherten Prozedur
Mit dem Massenexport/-import Daten in partitionierte Tabellen
kopieren
Unter bestimmten Umständen können Sie die Performance von bcp deutlich
steigern, indem Sie mehrere bcp-Sitzungen mit einer partitionierten Tabelle
ausführen.
Partitionierte Tabellen erhöhen die Einfügegeschwindigkeit, indem
Sperrenkonflikte vermindert und I/O-Vorgänge über mehrere Devices verteilt
werden. Die bcp-Performance mit partitionierten Tabellen wird hauptsächlich
durch verteilte I/O-Vorgänge gesteigert.
Wenn Sie eine bcp-Sitzung ausführen, bedenken Sie Folgendes:
Eine partitionierte Tabelle erhöht die Performance nur, wenn Sie mit dem
Massenexport/-import Daten in die Tabelle kopieren (importieren).
Die Performance-Steigerung von langsamem bcp ist bei partitionierten
Tabellen nicht so deutlich festzustellen. Löschen Sie stattdessen alle
Indizes und Trigger und verwenden Sie zur Performance-Steigerung
schnelles bcp, wie in Tabelle 3-2 auf Seite 25 beschrieben.
Im Netzwerkverkehr können Engpässe eintreten, wenn mehrere bcp-
Sitzungen ausgeführt werden. Verwenden Sie wenn möglich eine lokale
Verbindung zur Adaptive Server-Installation, um dieses Problem zu
vermeiden.
26 Adaptive Server Enterprise

Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Es gibt zwei Methoden, Daten in eine partitionierte Heap-Tabelle zu kopieren:
Die Daten nach dem Zufallsprinzip (ungesteuert) kopieren, ohne Bezug
auf die Partition, in die Daten kopiert werden
Die Daten in eine bestimmte Partition kopieren
Wenn die Tabelle einen Clustered-Index hat, wird bcp verwendet, und der
Index steuert die Platzierung der Zeilen.
❖ Daten ungesteuert in Partitionen kopieren
Um Daten ungesteuert in partitionierte Tabellen unter Verwendung mehrerer
bcp-Sitzungen zu kopieren, führen Sie die folgenden Schritte durch:
1 Konfigurieren Sie die Tabelle mit so vielen Partitionen und physischen
Devices, wie es Ihr System erfordert.
Weitere Hinweise finden Sie in der Dokumentation Performance and
Tuning Guide und unter „Mit parallelem Massenexport/-import Daten
in eine bestimmte Partition kopieren“ auf Seite 29 dieses Handbuchs.
2 Achten Sie darauf, dass Adaptive Server mit genug Sperren konfiguriert
ist, um mehrere bcp-Sitzungen zu unterstützen. Informationen zum
Konfigurieren von Sperren finden Sie in der Dokumentation
Systemadministration für Adaptive Server Enterprise.
3 Entfernen Sie Trigger und Indizes auf der Tabelle und aktivieren Sie
schnellen bcp. Anleitungen finden Sie unter „Schnellen oder langsamen
bcp verwenden“ auf Seite 22.
Hinweis Wenn Sie langsamen bcp verwenden, erhöht sich die
Performance möglicherweise nicht im gewünschten Ausmaß, nachdem
Sie Trigger und Indizes entfernt haben. Wenn die Tabelle Indizes enthält,
kann es zusätzlich Deadlocks auf den Indexseiten geben.
4 Teilen Sie die bcp-Eingabedatei auf so viele gleich große Dateien auf,
wie die Anzahl der geplanten bcp-Sitzungen beträgt.
Sie können auch die Optionen -F first_row und -L last_row verwenden,
um den Start und das Ende der einzelnen Eingabedateien anzugeben.
5 Führen Sie die bcp-Sitzungen mit separaten Dateien parallel und wenn
möglich auf der lokalen Adaptive Server-Installation aus.
Auf UNIX-Plattformen können Sie zum Beispiel verschiedene Sitzungen
in verschiedenen Shell-Fenstern ausführen oder einzelne bcp-Sitzungen
im Hintergrund starten.
Dienstprogramme 27

cp-Performance
Eine ausführliche Beschreibung des Kopierens von Daten in partitionierte
Tabellen finden Sie in der Dokumentation Performance and Tuning Guide.
bcp-Sitzungen mit dbcc checktable und sp_helpsegment überwachen
Wenn Sie nicht festlegen, welche Partitionen die bcp-Sitzungen verwenden
sollen, ordnet Adaptive Server die mehrfachen bcp-Sitzungen nach eigenem
Ermessen den verfügbaren Partitionen der Tabelle zu. Wenn Sie diese
ungesteuerte Zuordnung verwenden, stellen Sie sicher, dass der Prozess die
Einfügungen gleichmäßig verteilt hat, indem Sie eines der folgenden Verfahren
verwenden:
dbcc checktable – um in regelmäßigen Abständen die Gesamtseitenanzahl
für die einzelnen Partitionen zu prüfen
sp_helpsegment oder sp_helpartition – um eine ähnliche Prüfung
durchzuführen, aber ohne die Datenbankobjekte zu sperren
Weitere Hinweise zu dbcc checktable finden Sie in der Dokumentation
Systemadministration für Adaptive Server Enterprise. Weitere Hinweise
zu sp_helpsegment und sp_helpartition finden Sie in der Dokumentation
Reference Manual.
Weitere Hinweise zu Tabellenpartitionen finden Sie in der Dokumentation
Performance and Tuning Guide.
Vermindertes Protokollieren durch Erhöhung der Seitenzuweisungen
Wenn Sie schnelles bcp verwenden, bedenken Sie, dass jede bcp in -
Anweisungsfolge den Seiten-Manager veranlasst, einen oder mehrere Extents
zuzuweisen. Jede solche Seitenzuweisung erzeugt einen einzelnen Logeintrag.
Mit dem Konfigurationsparameter number of preallocated extents können Sie
festlegen, wie viele Extents Adaptive Server durch den Seiten-Manager
zuweisen soll.
Für den Konfigurationsparameter number of preallocated extents sind
Werte von 0 bis 31 zulässig. Der Standardwert ist 2.
Sie müssen Adaptive Server neu starten, um diesen Wert zu ändern.
Erhöhen Sie diese Zahl, wenn Sie große bcp-Vorgänge durchführen,
um zu verhindern, dass Seitenzuweisungen das Log auffüllen.
Setzen Sie diesen Wert auf 0, um umfangreiche Extent-Zuweisungen zu
verhindern, damit der Seiten-Manager nur einzelne Seitenzuweisungen
durchführt.
28 Adaptive Server Enterprise

Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Da Adaptive Server möglicherweise mehr Seiten zuordnet, als tatsächlich
benötigt werden, sollten Sie diesen Wert niedrig halten, wenn der Speicherplatz
beschränkt ist. Diese Seiten werden am Ende der Anweisungsfolge
freigegeben.
Weitere Hinweise finden Sie in der Dokumentation Systemadministration für
Adaptive Server Enterprise.
Mit parallelem Massenexport/-import Daten in eine bestimmte
Partition kopieren
Verwenden Sie den parallelen Massenexport/-import von Daten, um parallel in
eine bestimmte Partition zu kopieren. Das Bulk-Copy-Dienstprogramm erhöht
die Performance während bcp-Sitzungen deutlich, weil große bcp-Aufträge in
mehrere Sitzungen aufgeteilt und gleichzeitig ausgeführt werden können.
So verwenden Sie den parallelen Massenexport/-import der Daten:
Die Zieltabelle muss partitioniert sein.
Mit sp_helpartition können Sie die Anzahl der Partitionen auf der
Tabelle anzeigen.
Verwenden Sie alter table ... partition, um die Tabelle aufzuteilen,
wenn die Tabelle noch nicht partitioniert ist.
Die Zieltabelle sollte aus folgenden Gründen keine Indizes enthalten:
Wenn die Tabelle einen Clustered-Index hat, bestimmt der Index die
physische Platzierung der Daten, und die Partitionsspezifikation im
bcp-Befehl wird ignoriert.
Wenn irgendein Index vorhanden ist, verwendet bcp automatisch die
langsame statt der schnellen Version.
Wenn Nonclustered-Indizes auf den Tabellen vorkommen, kann der
Massenexport/-import der Daten leicht zu Deadlocks auf Indexseiten
führen.
Die beste Performance erhalten Sie, wenn sich jede Partition auf einer
anderen physischen Festplatte befindet.
Dienstprogramme 29

cp-Performance
Große Datei aufgeteilt in
vier kleinere Dateien
Datei 1
Datei 2
Datei 3
Datei 4
Bevor Sie Daten in Ihre Datenbank kopieren, müssen Sie die Tabelle
aufteilen, die die Daten enthalten wird.
Paralleler Massenexport/-import der Daten kann in eine Tabelle
aus mehreren Betriebssystemdateien kopieren. Hierzu führen Sie
Folgendes aus:
bcp Tabellenname :Partitionsnummer in Dateiname
Abbildung 3-1 zeigt den parallelen Massenexport/-import der Daten.
Abbildung 3-1: Daten in eine partitionierte Tabelle mit parallelem
Massenexport/-import kopieren
bcp mydb..bigtable:1 in Datei 2 &
Kopie in Partition 1
bcp mydb..bigtable:2 in Datei 2 &
Kopie in Partition 2
Kopie in Partition 3
bcp mydb..bigtable:3 in Datei 2 &
Kopie in Partition 4
bcp mydb..bigtable:4 in Datei 2 &
Partitionierte Tabelle
Weitere Hinweise zur Partitionierung von Tabellen finden Sie in der
Dokumentation Performance and Tuning Guide.
Hinweis Wenn Sie den parallelen Massenexport/-import der Daten verwenden,
um Daten zu exportieren, können Sie nicht bestimmen, welche Partitionen bcp
verwenden soll.
30 Adaptive Server Enterprise

cp-Import und Sperren
Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Wenn Sie in eine Tabelle mit bcp importieren, und besonders wenn Sie mit
parallelem bcp kopieren, erwirbt der Kopierprozess die folgenden Sperren:
Eine exklusive Absichtssperre für die Tabelle
Eine exklusive Seitensperre für jede Datenseite
Eine exklusive Sperre für Indexseiten, falls vorhanden
Wenn Sie in sehr große Tabellen kopieren, und vor allem, wenn Sie
gleichzeitiges Kopieren in partitionierte Tabellen verwenden, kann dies eine
sehr große Anzahl von Sperren bedeuten.
So können Sie einen Sperrenmangel vermeiden:
Erhöhen Sie die Anzahl der Sperren.
Mit folgender Formel können Sie die Anzahl der erforderlichen
Sperren schätzen:
#Nr_gleichzeitige_Stapel * (Zeilen_pro_Stapel / (2016/Zeilenlänge))
Um die Zeilenlänge bei einer Tabelle einzusehen, führen Sie
Folgendes aus:
1> select maxlen
2> from sysindexes
3> where id = object_id("Tabellenname") and (indid = 0 or indid = 1)
Weitere Hinweise zur Einstellung der Sperrenanzahl finden Sie in der
Dokumentation Systemadministration für Adaptive Server Enterprise.
Verwenden Sie die Markierung -b Größe_der_Anweisungsfolge,
um kleinere Anweisungsfolgen zu kopieren.
Führen Sie weniger Anweisungsfolgen gleichzeitig aus.
Methoden des parallelen Massenexports/-imports
Verwenden Sie eine der folgenden Methoden, um Daten mit dem
Massenexport/-import zu importieren:
Starten Sie mehrere bcp-Sitzungen im Hintergrund und führen Sie
folgende Schritte aus:
Geben Sie das Kennwort in die Befehlszeile ein.
Verwenden Sie den nativen Modus, den Zeichenmodus oder eine
Formatdatei.
Sie können bcp so oft starten, wie die Tabelle aufgeteilt ist.
Dienstprogramme 31

cp-Performance
Erstellen und verwenden Sie eine Formatdatei:
a Starten Sie bcp im interaktiven Modus.
b Beantworten Sie die Eingabeaufforderungen.
c Erstellen Sie eine Formatdatei, die Ihre Antworten speichert.
d Legen Sie den Prozess in den Hintergrund, wenn der Kopiervorgang
anfängt.
e Geben Sie den nächsten bcp-Befehl ein und geben Sie die Formatdatei
an, die mit dem ersten bcp erstellt wurde.
Starten Sie bcp-Sitzungen in mehreren Fenstern.
Syntax des parallelen Massenexport/-import von Daten
Die Syntax bei parallelem Massenexport/-import von Daten lautet:
bcp Tabellenname[:Partitionsnummer] in Dateiname -PMeinKennwort
Dabei gilt Folgendes:
Tabellenname ist der Name der Tabelle, in die Sie die Daten kopieren
Partitionsnummer ist die Nummer der Partition, in die Sie kopieren
Dateiname ist die Hostdatei, die die Daten enthält
MeinKennwort ist Ihr Kennwort
Parallelen Massenexport/-import auf partitionierten Tabellen verwenden
So kopieren Sie sortierte Daten parallel in eine bestimmte Partition:
Geben Sie die Partitionsnummer an, indem Sie einen Doppelpunkt (:)
und die Partitionsnummer an den Tabellennamen anfügen. Beispiel:
publishers:10
Hinweis Die angegebene Partition muss vorhanden sein, bevor Sie den
bcp-Befehl eingeben.
32 Adaptive Server Enterprise

Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Teilen Sie die sortierten Daten in separate Dateien auf oder legen Sie
den Bereich der Zeilen in den „Dateien“ fest, indem Sie die erste Zeile
(-F erste_Zeile) und die letzte Zeile (-L letzte_Zeile) der Hostdatei angeben.
Notieren Sie die Anzahl der Partitionen in der Tabelle. Diese Zahl limitiert
die Anzahl von parallelen Massenexport/-importprozessen, die Sie
starten können.
Wenn eine Tabelle zum Beispiel vier Partitionen hat und Sie fünf parallele
Massenexport/-import-Sitzungen starten, können nur die ersten vier
Aufträge parallel ausgeführt werden; der fünfte Auftrag startet erst,
wenn einer der vier anderen Aufträge beendet wird.
bcp kopiert jede Datei oder Menge von Zeilennummern in eine separate
Partition. Um zum Beispiel mit dem parallelen Massenexport/-import sortierte
Daten in mydb..bigtable aus vier Dateien in vier Partitionen zu kopieren, geben
Sie Folgendes ein:
bcp mydb..bigtable:1 in file1 -Pmypassword -c &
bcp mydb..bigtable:2 in file2 -Pmypassword -c &
bcp mydb..bigtable:3 in file3 -Pmypassword -c &
bcp mydb..bigtable:4 in file4 -Pmypassword -c &
Paralleler Massenexport/-import und Identity-Spalten
Wenn Sie den parallelen Massenexport/-import verwenden, können Identity-
Spalten einen Engpass verursachen. Während bcp die Daten liest, erzeugt
das Dienstprogramm die Werte für die Identity-Spalte und aktualisiert
den Höchstwert der Identity-Spalte bei jeder Zeile. Dieser zusätzliche
Arbeitsschritt kann sich auf die Performance-Steigerung auswirken,
die Sie sich von der Verwendung des Massenexport/-imports der Daten
erwartet haben.
Um diesen Engpass zu vermeiden, können Sie explizit den Identity-Startpunkt
für jede Sitzung festlegen.
Dienstprogramme 33

cp-Performance
Sortierreihenfolge aufrecht erhalten
Wenn Sie sortierte Daten in die Tabelle kopieren, ohne den Identity-Startpunkt
explizit anzugeben, erstellt bcp möglicherweise die Identity-Spaltenwerte
nicht in der sortierten Reihenfolge. Der parallele Massenexport/-import
der Daten liest die Informationen in alle Partitionen gleichzeitig ein und
aktualisiert die Werte der Identity-Spalte, während die Daten gelesen werden.
Eine bcp-Anweisung ohne expliziten Startpunkt würde Identity-
Spaltennummern erzeugen, die den in Abbildung 3-2 gezeigten ähnlich sind:
Abbildung 3-2: Identity-Spalten in Sortierreihenfolge erzeugen
Partition 1 Partition 2 Partition 3 Partition 4
ID-Spalte
100 A
104 A
107 B
108 B
114 B
ID-Spalte
102 C
106 C
109 C
112 D
117 E
ID-Spalte
103 F
105 F
111 F
116 G
119 G
Die Tabelle hat eine maximale Identity-Spaltennummer von 119, aber die
Reihenfolge ist nicht mehr sinnvoll.
Wenn Adaptive Server eindeutige Identity-Spaltenwerte erzwingen soll,
müssen Sie bcp entweder mit dem Parameter -g oder -E ausführen.
Den Startpunkt von der Befehlszeile aus angeben
Verwenden Sie die Option -g ID_Anfangswert, um den Startpunkt der Identity-
Spalte für eine Sitzung in der Befehlszeile festzulegen.
Der -g-Parameter fordert Adaptive Server auf, eine Sequenz von Identity-
Spaltenwerten für die bcp-Sitzung zu generieren, ohne den Höchstwert der
Identity-Spalte der Tabelle für jede Zeile zu überprüfen und zu aktualisieren.
Statt einer Prüfung aktualisiert Adaptive Server den Höchstwert am Ende jeder
Anweisungsfolge.
Achtung! Sie können aus Versehen mehrfach vorhandene Identity-Werte
erstellen, wenn Sie Identity-Bereiche festlegen, die sich überschneiden.
Um einen Identity-Anfangswert anzugeben, geben Sie ein:
bcp [-gID_Anfangswert]
ID-Spalte
101 H
110 H
113 I
115 J
118 J
34 Adaptive Server Enterprise

Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Um zum Beispiel in vier Dateien mit jeweils 100 Zeilen zu kopieren,
geben Sie ein:
bcp mydb..bigtable in file1 -g100
bcp mydb..bigtable in file2 -g200
bcp mydb..bigtable in file3 -g300
bcp mydb..bigtable in file4 -g400
Die Verwendung des -g -Parameters stellt nicht sicher, dass die Identity-
Spaltenwerte eindeutig sind. Um Eindeutigkeit zu erzwingen, ist Folgendes
notwendig:
Sie müssen wissen, wie viele Zeilen in der Eingabedatei sind und was der
höchste vorhandene Wert ist. Verwenden Sie diese Informationen, um die
Startwerte mit dem -g-Parameter festzulegen, damit Sie Bereiche
generieren, die nicht überlappen.
Wenn im obenstehenden Beispiel eine Datei mehr als 100 Zeilen enthält,
überlappen die Identity-Werte die nächsten 100 Zeilen von Daten,
wodurch doppelte Identity-Werte erstellt werden.
Sie müssen auch sicherstellen, dass niemand sonst Daten einfügt,
die widersprechende Identity-Werte erzeugen können.
Den Startpunkt mit der Datendatei angeben
Verwenden Sie den -E-Parameter, um den Identity-Startpunkt explizit von der
Datendatei aus zu setzen.
Der -E-Parameter bewirkt, dass Sie von bcp aufgefordert werden, einen
expliziten Identity-Spaltenwert für die einzelnen Zeilen einzugeben.
Wenn dabei der höchstmögliche Identity-Spaltenwert überschritten
wird, gibt Adaptive Server einen Fehler aus.
Die bcp-Optionen verwenden
Im vorliegenden Abschnitt werden einige der komplexeren Optionen der bcp-
Syntax genauer beschrieben. Ausführliche Hinweise zur Syntax finden Sie
unter bcp auf Seite 164.
Dienstprogramme 35

Die bcp-Optionen verwenden
Die Standardformate verwenden
Natives Format
bcp stellt zwei Programm-Startparameter zur Verfügung, die Dateien mit
häufig verwendeten Standardformaten erstellen. Diese Optionen bieten die
einfachste Möglichkeit, Daten in und aus einer Adaptive Server-Installation
zu kopieren.
Die -n -Option verwendet „native“ Formate (Betriebssystemformate).
Die Option -c verwendet für alle Spalten „Zeichen“ (Datentyp char).
Dieser Datentyp verwendet Tabulator-Trennzeichen zwischen Feldern in
einer Zeile und ein Neue-Zeile-Abschlusszeichen (z.B. Zeilenschaltung)
am Ende jeder Zeile.
Wenn Sie die Optionen „nativ“ oder „Zeichen“ verwenden, operiert bcp nicht
interaktiv und fragt Sie nur nach Ihrem Kennwort in Adaptive Server.
Die Option -n erstellt Dateien mit nativen (betriebssystemspezifischen)
Formaten. Native Formate erstellen gewöhnlich eine kompaktere
Betriebssystemdatei. Mit dem folgenden Befehl wird beispielsweise die
Tabelle publishers in eine Datei namens pub_out kopiert, wobei das native
Datenformat verwendet wird:
bcp pubs2..publishers out pub_out -n
Inhalt von pub_out:
0736^MNew Age Books^FBoston^BMA0877^PBinnet & Hardley^J
Washington^BDC1389^TAlgodata Infosystems^HBerkeley^BCA
bcp stellt jedem Feld, außer pub_id, dem der Datentyp char(4) zugeordnet ist,
ein ASCII-Zeichen voran, das der Länge der Daten im Feld entspricht. Zum
Beispiel besteht „New Age Books“ aus 13 Zeichen, und ^M (Strg-m) ist
ASCII 13.
Alle in der Datei pub_out gespeicherten Tabellendaten sind Daten des
Typs char oder varchar und daher in einer lesbaren Form. In einer Tabelle mit
nummerischen Daten schreibt bcp die Informationen im Datendarstellungsformat
des Betriebssystems in die Datei; diese Daten sind möglicherweise für den
Benutzer nicht lesbar.
36 Adaptive Server Enterprise

Zeichenformat
Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
bcp kopiert Daten aus einer Tabelle in eine Datei entweder unter Beibehaltung
ihrer Datenbankdatentypen oder mit Umwandlung in einen Datentyp, bei
dem implizite Konvertierung unterstützt wird. bcp kopiert benutzerdefinierte
Datentypen als Basis-Datentyp oder beliebigen Datentyp, für den die implizite
Konvertierung unterstützt wird. Weitere Informationen zur Datentypkonvertierung
finden Sie unter dbconvert in der Dokumentation Open Client DB-
Library/C Reference Manual oder der Dokumentation Sybase Adaptive Server
Enterprise Reference Manual.
Hinweis Das Dienstprogramm bcp unterstützt nicht das Kopieren von Daten
im nativen Format von verschiedenen Betriebssystemen (zum Beispiel von NT
auf UNIX). Verwenden Sie die Option -c, wenn Sie mit bcp Dateien von einem
Betriebssystem auf ein anderes kopieren.
Achtung! Verwenden Sie keine Zeilenabschlusszeichen-Parameter (-t)
oder Feldabschlusszeichen-Parameter (-r) mit bcp im nativen Format. Die
Ergebnisse sind nicht vorhersehbar und die Daten könnten beschädigt werden.
Das Zeichenformat (-c) verwendet für alle Spalten den Datentyp char. Es fügt
Tabulatoren zwischen die Felder jeder Zeile ein und setzt ein Neue-Zeile-
Abschlusszeichen am Ende jeder Zeile.
Mit dem folgenden Befehl werden beispielsweise die Daten aus der Tabelle
publishers im Zeichenformat in die Datei pub_out kopiert:
bcp pubs2..publishers out pub_out -c
Der Befehl erzeugt die folgende bcp-Ausgabe:
0736 New Age Books Boston MA
0877 Binnet & Hardley Washington DC
1389 Algodata Infosystems Berkeley CA
Dienstprogramme 37

Die Standardwerte ändern: Interaktiver bcp
Abschlusszeichen von der Befehlszeile ändern
Abschlusszeichen sind die Zeichen, die Datenfelder trennen (Feldabschlusszeichen).
Das Zeilenabschlusszeichen ist das Feldabschlusszeichen des letzten
Felds in der Tabelle oder der Datei. Verwenden Sie die Programm-Startparameter
-tFeldabschlusszeichen und -rrow_terminator Zeilen-Abschlusszeichen
mit der Zeichenformatoption (-c), um die Abschlusszeichen von der Befehlszeile
zu ändern.
Das folgende Beispiel verwendet das Komma (,) als Feldabschlusszeichen
und die Zeilenschaltung (\r) als Zeilenabschlusszeichen.
Auf UNIX-Plattformen:
bcp pubs2..publishers out pub_out -c -t , -r \\r
Vergessen Sie nicht, den Rückstrich mit Escape-Zeichen zu markieren,
falls das bei Ihrer Betriebssystem-Befehlsoberfläche erforderlich ist.
Unter Windows NT:
bcp pubs2..publishers out pub_out -c -t , -r \r
Diese bcp-Befehlszeile gibt die folgenden Informationen aus:
0736,New Age Books,Boston,MA
0877,Binnet & Hardley,Washington,DC
1389,Algodata Infosystems,Berkeley,CA
Hinweis Mit den Optionen -t und -r können Sie die Standard-Abschlusszeichen
ohne Berücksichtigung der Zeichenoption (-c) ändern.
Die Standardwerte ändern: Interaktiver bcp
Wenn Sie kein natives Format (-n) oder Zeichenformat (-c) angeben, werden
Sie von bcp interaktiv aufgefordert, die folgenden Informationen
bereitzustellen:
Dateispeichertyp
Präfixlänge
Abschlusszeichen für alle zu kopierenden Datenspalten
Länge für Felder, die als char oder binary
gespeichert werden sollen
38 Adaptive Server Enterprise

Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Die Standardwerte für diese Eingabeaufforderungen führen zu denselben
Ergebnissen wie das Verwenden des nativen Formats und bieten eine einfache
Methode, Daten aus einer Datenbank zu exportieren, um sie später wieder in
die Adaptive Server-Installation zurückzuladen.
Wenn Sie Daten zur Verwendung mit anderen Programmen in die oder aus
der Adaptive Server-Installation kopieren, sollten Sie Ihre Antworten auf die
Eingabeaufforderungen auf dem Format aufbauen, das für die andere Software
erforderlich ist.
Diese vier Eingabeaufforderungen sind ein äußerst flexibles System,
mit dem Sie eine Datei aus einer anderen Software lesen können oder eine
Datei erstellen können, die nach geringer oder keiner Bearbeitung mit vielen
anderen Datenformaten kompatibel ist.
In den folgenden Abschnitten werden diese Eingabeaufforderungen, ihre
Wechselbeziehungen und ihre Auswirkungen auf die Daten erörtert.
Auf bcp-Eingabeaufforderungen reagieren
Wenn Sie Daten mit den Parametern -n (natives Format) oder -c
(Zeichenformat) importieren oder exportieren, fordert Sie bcp zur Eingabe
Ihres Kennworts auf, wenn es nicht bereits mit dem Parameter -P angegeben
wurde. Wenn Sie den Parameter -n, -c oder -f Formatdatei nicht angeben, fordert
bcp Sie auf, Daten in die einzelnen Felder der Tabelle oder Ansicht einzugeben.
Jede Eingabeaufforderung zeigt in Klammern einen Standardwert an,
den Sie durch Drücken der Eingabetaste bestätigen können.
Diese Eingabeaufforderungen sind:
Der Dateispeichertyp – entweder character oder ein anderer in
Adaptive Server gültiger Datentyp
Die Präfixlänge, eine Ganzzahl, die die Länge der nachfolgenden
Daten in Byte anzeigt
Die Speicherlänge der Daten in der Datei für Nicht-NULL-Felder
Das Feldabschlusszeichen – eine beliebige Zeichenfolge
(Windows NT) – Dezimalstellen und Gesamtstellenzahl bei
nummerischen und Dezimal-Datentypen
Das Zeilenabschlusszeichen ist das Feldabschlusszeichen des letzten
Felds in der Tabelle, Ansicht oder Datei.
Dienstprogramme 39

Die Standardwerte ändern: Interaktiver bcp
Die in Klammern gefassten Standardwerte sind angemessene Werte für die
Datentypen der betreffenden Felder. Die wirkungsvollste Ausnutzung des
Speicherplatzes erzielen Sie, wenn Sie beim Kopieren von Daten aus einer
Tabelle folgende Hinweise berücksichtigen:
Bestätigen Sie die vorgeschlagenen Standardwerte.
Kopieren Sie alle Daten in den Datentypen, wie sie von ihrer Tabelle
definiert sind.
Verwenden Sie die angegebenen Präfixe.
Verwenden Sie keine Abschlusszeichen.
Akzeptieren Sie die Standardlängen.
Tabelle 3-3 zeigt die bcp-Eingabeaufforderungen, Standardwerte und die
möglichen Benutzerantworten:
Tabelle 3-3: Standardwerte und Benutzerantworten für
bcp-Eingabeaufforderungen
Eingabeaufforderung Verfügbarer Standard Mögliche Benutzerreaktion
Dateispeichertyp Verwenden Sie den Datenbankspeichertyp
für die meisten Felder, ausgenommen:
char für varchar
binary für varbinary
Präfixlänge 0 für Felder, die mit dem Datentyp char
(nicht Speichertyp) definiert sind und
alle Datentypen mit festen Längen
1 für die meisten anderen Datentypen
2 für binary und varbinary gespeichert
als char
4 für text und image
Speicherlänge Verwenden Sie für char und varchar
die definierte Länge.
Verwenden Sie für binary und
varbinary gespeichert als char das
Doppelte der definierten Länge.
Verwenden Sie für alle anderen
Datentypen die erforderliche
Mindestlänge, um Kürzen oder
Datenüberlauf zu verhindern.
char, um eine benutzerlesbare Datei
zu erstellen; alle Adaptive Server-
Datentypen, die implizite Konvertierung
unterstützen.
0, wenn kein Präfix gewünscht wird;
Standardwerte werden empfohlen.
Standardwerte oder höher werden
empfohlen.
40 Adaptive Server Enterprise

Feld- oder
Zeilenabschlusszeichen
Dateispeichertyp
Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Eingabeaufforderung Verfügbarer Standard Mögliche Benutzerreaktion
Keiner Bis zu 30 Zeichen oder eines der
folgenden:
\t – Tabulator
\n – Zeilenschaltung
\r – Wagenrücklauf
\0 – Nullabschlusszeichen
\ – Rückstrich
Die Eingabeaufforderung für den Datentyp bietet Ihnen eine Auswahl von
Optionen, wie die Daten in der Datei zu speichern sind. Sie können Daten
folgendermaßen in eine Datei kopieren:
Als ihr Datenbanktabellentyp
Als Zeichenfolge oder
Als beliebiger Datentyp, für den implizite Konvertierung unterstützt wird.
Hinweis bcp kopiert benutzerdefinierte Datentypen als Basistypen.
Tabelle 3-4 zeigt den Standard-Speichertyp für alle Adaptive Server-
Datentypen und die Abkürzungen, die von bcp akzeptiert werden.
Am kompaktesten können Sie mit den Standortwerten speichern.
Verwenden Sie für Zeichendateien den Datentyp char.
Beachten Sie, dass der Speichertyp date das interne Speicherformat
von Adaptive Server für datetime und nicht das Format des Host-
Betriebssystems für das Datum ist.
timestamp-Daten werden als binary(8) behandelt.
In Tabelle 3-4 bedeuten eckige Klammern [ ], dass Sie das erste Zeichen oder
die Anfangszeichen des Wortes verwenden können. Für „bit“ können Sie zum
Beispiel „b“, „bi“ oder „bit“ verwenden.
Dienstprogramme 41

Die Standardwerte ändern: Interaktiver bcp
Tabelle 3-4: Datentypen für den Dateispeicher für bcp
Tabellendatentyp Speichertyp
char, varchar c[har]
text T[ext]
int i[nt]
smallint s[mallint]
tinyint t[inyint]
float f[loat]
money m[oney]
bit b[it]
datetime d[atetime]
binary, varbinary x
image I[mage]
smalldatetime D
real r
smallmoney M
numeric n
decimal e
Um diese Liste anzuzeigen, während Sie bcp interaktiv ausführen,
geben Sie ein Fragezeichen (?) als Antwort auf die Eingabeaufforderung
„Dateispeichertyp eingeben“ ein.
Die vorgeschlagenen Werte, die in den Eingabeaufforderungen angezeigt
werden, sind die Standardwerte. Vergessen Sie nicht, dass Ihre Antwort
festlegt, wie Ihre Daten in der Ausgabedatei gespeichert werden. Sie müssen
den Typ der Spalte in der Datenbanktabelle nicht angeben.
bcp wird nicht erfolgreich ausgeführt, wenn Sie einen Datentyp eingeben, der
weder implizit konvertierbar noch char ist. Beispiel: Sie können smallint nicht
für int-Daten verwenden (es kann zu Überlaufsfehlern kommen). Sie können
jedoch int für smallint verwenden.
Wenn Sie Nicht-Zeichen-Datentypen in Form ihrer Datenbanktypen speichern,
schreibt bcp die Daten in eine Datei im internen Datendarstellungsformat von
Adaptive Server für das Host-Betriebssystem und nicht in einem für den
Benutzer lesbaren Format.
42 Adaptive Server Enterprise

Präfixlänge
Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Bevor Sie Daten im Zeichenformat von einer Datei in eine Datenbanktabelle
kopieren, überprüfen Sie die Datentypeingaberegeln in der Dokumentation
Reference Manual. Zeichendaten, die mit bcp in eine Datenbank kopiert
werden, müssen diesen Regeln entsprechen. Beachten Sie, dass
Datumsangaben im nicht begrenzten Format (yy)yymmdd einen
Überlauf bewirken können, wenn das Jahr nicht zuerst angegeben wird.
Wenn Sie Host-Datendateien an Standorte versenden, die Terminals mit
einem anderen Zeichensatz verwenden, geben Sie mit datafile_charset
den Zeichensatz bekannt, den Sie zum Erstellen der Datei verwendet haben.
Standardmäßig stellt bcp jedem Feld, das eine variable Speicherlänge hat, eine
Zeichenfolge von einem oder mehreren Byte voran, die die Länge des Feldes
anzeigt. Durch dieses Präfix wird die kompakteste Feldspeicherung erreicht.
Die Standardwerte in den Eingabeaufforderungen zeigen die effizienteste
Präfixlänge an:
Bei Feldern mit fester Länge sollte das Präfix 0 betragen.
Bei Feldern von 255 Bytes oder weniger ist der Standardwert 1.
Für die Datentypen text oder image beträgt die Standard-Präfixlänge 4.
Für die Datentypen binary und varbinary, die in char-Speichertypen
konvertiert werden, lautet die Standard-Präfixlänge 2, da pro Byte
Tabellendaten 2 Byte Dateispeicher erforderlich ist.
Verwenden Sie für Daten des Datentyps binary, varbinary und image gerade
Zahlen für Präfix und Länge. Diese Bedingung sorgt für Konsistenz mit
Adaptive Server, der Daten als eine gerade Zahl von hexadezimalen
Ziffern speichert.
Verwenden Sie für alle Datenspalten, die Nullwerte zulassen, eine
Präfixlänge (nicht 0) oder ein Abschlusszeichen, um die Länge der Daten
der einzelnen Zeilen anzugeben. bcp behandelt diese Spalten wie auch
Spalten mit ganzzahligen Datentypen, die normalerweise wie Spalten
mit fester Länge behandelt werden, wie Spalten mit variabler Länge.
Verwenden Sie für Daten ohne Präfix vor der Spalte eine Präfixlänge
von 0.
Dienstprogramme 43

Die Standardwerte ändern: Interaktiver bcp
Feldlänge
Eine Präfixlänge ist eine Ganzzahl von 1, 2 oder 4 Byte, die die Länge jedes
Datenwerts in Byte wiedergibt. Sie steht dem Datenwert in der Hostdatei
unmittelbar voran.
Wenn Sie kein Abschlusszeichen eingeben, füllt bcp jedes gespeicherte
Feld mit Leerstellen auf die volle Länge auf, die an der nächsten
Eingabeaufforderung, „Länge“, angegeben wird.
Da Präfixlängen aus nativen Formatganzzahlen bestehen, enthält die
resultierende Hostdatei nicht-druckbare Zeichen. Dadurch sind Sie
möglicherweise nicht in der Lage, die Hostdatei auszudrucken oder sie
mittels eines Kommunikationsprogramms zu übermitteln, das ausschließlich
druckbare Zeichen handhaben kann.
Weitere Hinweise zu Präfixlängen finden Sie unter Tabelle 3-9 auf Seite 53.
In den meisten Fällen können Sie für das Exportieren von Daten den
Standardwert von bcp für die Speicherlänge verwenden.
Hinweis In diesem Abschnitt beziehen sich „Länge“ und „Speicherlänge“ auf
die Betriebssystemdatei und nicht auf die Feldlängen von Adaptive Server.
Wenn Sie eine Datei zum Wiederladen in Adaptive Server erstellen,
schränken Standardpräfixe und -länge den benötigten Speicherplatz
auf ein Minimum ein.
Wenn Sie eine vom Benutzer lesbare Datei erstellen, verhindert
die Standardlänge ein Kürzen der Daten oder die Erzeugung von
Überlauffehlern, die zum Scheitern von bcp führen.
Da es möglich ist, die Standardlänge zu ändern, indem Sie einen anderen Wert
eingeben, müssen Sie mit den Daten vertraut sein, die übertragen werden.
Wenn Sie Zeichendaten von anderer Software kopieren, sollten Sie die
Quelldatei genauestens überprüfen, bevor Sie Längenwerte auswählen.
Hinweis Wenn der Speicherungstyp Nichtzeichen ist, speichert bcp die Daten
in der nativen Datendarstellung des Betriebssystems und fordert Sie nicht zur
Eingabe der Länge auf.
44 Adaptive Server Enterprise

Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Wenn bcp Nichtzeichen-Daten in Zeichenspeicherung konvertiert, wird eine
Standardfeldlänge vorgeschlagen, die groß genug zum Speichern der Daten ist,
ohne dass datetime-Daten abgeschnitten werden oder ein Überlauf von
nummerischen Daten verursacht wird.
Die Standardlänge ist die Byteanzahl, die benötigt wird, um den längsten
Wert für den Adaptive Server-Datentyp anzuzeigen. Tabelle 3-5 listet
die Standardfeldlängen für die Datenkonvertierung in
Zeichenspeicherung auf.
Tabelle 3-5: Standard-Feldlängen bei der Konvertierung von
Nichtzeichen- in Zeichendatentypen
Datentyp Standardgröße
int 12 Byte
smallint 6 Byte
tinyint 3 Byte
float 25 Byte
money 24 Byte
bit 1 Byte
datetime 26 Byte
smalldatetime 26 Byte
real 25 Byte
smallmoney 24 Byte
Wenn Sie eine Feldlänge angeben, die beim Kopieren von Daten aus einer
Tabelle für nummerische Daten zu kurz ist, gibt bcp eine Überlaufmeldung
aus und kopiert die Daten nicht.
Die Standardlänge für die Felder binary und varbinary entspricht zweimal
der für die Spalte definierten Länge, da pro Byte des Feldes 2 Byte
Feldspeicherung erforderlich sind.
Wenn Sie die Standard-Speicherlänge akzeptieren, hängt die tatsächlich
zugewiesene Menge an Speicherplatz davon ab, ob Sie eine Präfixlänge
und Abschlusszeichen angeben.
Wenn Sie eine Präfixlänge von 1, 2 oder 4 angeben, verwendet bcp als
Speicherplatz die tatsächliche Datenlänge plus die Länge des Präfixes
plus etwaige Abschlusszeichen.
Dienstprogramme 45

Die Standardwerte ändern: Interaktiver bcp
Wenn Sie eine Präfixlänge von 0 und kein Abschlusszeichen angeben,
weist bcp die maximale Menge des in der Eingabeaufforderung
angezeigten Speicherplatzes zu. Dies entspricht dem maximalen
Platzbedarf für den betreffenden Datentyp. Mit anderen Worten:
bcp behandelt das Feld so, als hätte es eine feste Länge, um zu
bestimmen, wo ein Feld endet und das nächste beginnt.
Wenn zum Beispiel das Feld als varchar(30) definiert ist, verwendet
bcp 30 Byte für jeden Wert, auch wenn manche Werte nur 1 Zeichen
lang sind.
Felder, die in der Datenbank als char, nchar und binary definiert sind,
und Felder, die keine Nullwerte zulassen, werden stets mit Leerstellen
(null Byte bei binär) auf die volle in der Datenbank definierte Länge
aufgefüllt. timestamp-Daten werden als binary(8) behandelt.
Wenn Daten in den Feldern varchar und varbinary länger als die Länge
sind, die Sie zum Exportieren angeben, kürzt bcp die Daten in der Datei
stillschweigend auf die festgelegte Länge.
bcp weiß nicht, wie lang ein beliebiger Datenwert sein wird, bevor nicht
alle Daten kopiert sind. Daher werden char-Datentypen immer vollständig
bis zur angegebenen Länge aufgefüllt.
Der Dateispeichertyp und die Länge einer Spalte müssen nicht unbedingt
dem Typ und der Länge der Spalte in der Datenbanktabelle entsprechen.
Wenn die in die Tabelle kopierten Typen und Formate nicht mit der
Struktur der Datenbanktabelle kompatibel sind, scheitert der
Kopiervorgang.
Die Dateispeicherlänge stellt gewöhnlich die größte Menge von zu
übertragenden Daten für die Spalte dar, ausgenommen Abschlusszeichen
und/oder Präfixe.
Wenn Sie Daten in eine Tabelle kopieren, beachtet bcp die Standardwerte,
die für Spalten und benutzerdefinierte Datentypen definiert sind.
Allerdings ignoriert bcp Regeln, damit das Laden von Daten mit der
optimalen Geschwindigkeit durchgeführt werden kann.
Da bcp alle Datenspalten, die Nullwerte enthalten, als Spalten mit
variabler Länge einstuft, sollten Sie entweder ein Längenpräfix oder ein
Abschlusszeichen verwenden, um die Länge der einzelnen Zeilen von
Daten zu kennzeichnen.
Der Dateispeichertyp und die Länge einer Spalte müssen nicht unbedingt
dem Typ und der Länge der Spalte in der Datenbanktabelle entsprechen.
(Wenn die importierten Typen und Formate nicht mit der Struktur der
Datenbanktabelle kompatibel sind, scheitert der Kopiervorgang.)
46 Adaptive Server Enterprise

Feld- und Zeilenabschlusszeichen
Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Sie können ein Abschlusszeichen verwenden, um das Ende einer Spalte oder
Zeile zu markieren und von der folgenden abzugrenzen. Als Standard ist kein
Abschlusszeichen angegeben.
Feldabschlusszeichen trennen Tabellenspalten.
Das Zeilenabschlusszeichen ist das Feldabschlusszeichen des letzten
Felds in der Zeile der Tabelle oder Datei.
Abschlusszeichen sind sehr nützlich beim Arbeiten mit Zeichendaten, weil
Sie für sie ein vom Benutzer lesbares Format auswählen können. Die bcp-
Zeichenoption, die zwischen den Spalten Tabulatoren und am Ende jeder Zeile
ein Neue-Zeile-Abschlusszeichen verwendet, ist ein Beispiel für den Einsatz
von Abschlusszeichen zur besseren Lesbarkeit einer Datendatei.
Wenn Sie Daten in anderen Programmen verwenden und mit bcp Tabellendaten
vorbereiten möchten, geben Sie Ihre eigenen Abschlusszeichen ein.
Die verfügbaren Abschlusszeichen sind:
Tabulatoren, gekennzeichnet durch \t
Neue Zeilen, gekennzeichnet durch \n
Zeilenschaltungen, gekennzeichnet durch \r
Rückstrich, gekennzeichnet durch \
Nullabschlusszeichen (kein sichtbares Abschlusszeichen),
gekennzeichnet durch \0
Jedes druckbare Zeichen, zum Beispiel *, A, t, |
Zeichenketten von bis zu 10 druckbaren Zeichen, einschließlich mancher
oder aller Abschlusszeichen, die oben aufgelistet sind (zum Beispiel
**\t**, end, !!!!!!!!!! und \t--\n)
Hinweis Steuerzeichen (ASCII 0–25) können nicht gedruckt werden.
Dienstprogramme 47

Die Standardwerte ändern: Interaktiver bcp
Abschlusszeichen auswählen
Wählen Sie Abschlusszeichen mit Mustern aus, die sonst nirgendwo in den
Daten auftreten.
So kann beispielsweise die Verwendung eines Tabulator-Abschlusszeichens
mit einer Zeichenfolge von Daten, die ebenfalls einen Tabulator enthält,
zweideutig sein: Welcher Tabulator stellt das Ende der Zeichenfolge dar? bcp
sucht immer nach dem ersten möglichen Abschlusszeichen, was in diesem Fall
nicht korrekt wäre, da das erste Tabulatorzeichen, auf das das Programm stößt,
Teil der Zeichenfolge ist.
Daten im nativen Format können auch Konflikte mit Abschlusszeichen
bewirken. Bei einer Spalte, die eine 4-Byte Ganzzahl im nativen Format
enthält, ist es unmöglich, ein Abschlusszeichen auszuwählen, das ganz sicher
nicht innerhalb der Daten vorkommt, außer wenn die Werte dieser Ganzzahlen
streng begrenzt sind. Verwenden Sie die native Formatoption von bcp bei
Daten im nativen Format.
Hinweis „Kein Abschlusszeichen“ entspricht nicht dem „Nullabschlusszeichen“,
das ein unsichtbares, jedoch reales Zeichen ist.
Eine Feldabschlusszeichenfolge kann bis zu 30 Zeichen lang sein. Die
häufigsten Abschlusszeichen sind das Tabulatorzeichen (eingegeben als
\t und in allen Spalten mit Ausnahme der letzten Spalte verwendet) und
die Zeilenschaltung (eingegeben als \n und im letzten Feld einer Zeile
verwendet). Andere Abschlusszeichen: \0 (Nullabschlusszeichen),
\ (Rückstrich) und \r (Zeilenschaltung). Stellen Sie bei Auswahl eines
Abschlusszeichens sicher, dass es in keinen Zeichendaten vorkommt,
denn bcp sucht immer nach dem ersten möglichen Abschlusszeichen.
Beispiel: Wenn Sie Tabulator-Abschlusszeichen für eine Zeichenfolge
verwenden, in der ein Tabulatorzeichen enthalten ist, kann bcp nicht
beurteilen, welches der beiden Tabulatorzeichen das Abschlusszeichen
ist. Da bcp immer nach dem ersten möglichen Abschlusszeichen sucht,
würde das Programm in diesem Fall das falsche Tabulatorzeichen als
Abschlusszeichen interpretieren.
48 Adaptive Server Enterprise

Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Ein Abschlusszeichen oder ein Präfix wirkt sich auf die tatsächliche Länge
der übertragenen Daten aus:
Wenn ein Abschlusszeichen oder ein Präfix vorhanden ist, wirkt es
sich auf die Länge der übertragenen Daten aus. Wenn die Länge eines
Eintrags, der aus einer Tabelle in eine Datei kopiert wird, kürzer als die
Speicherlänge ist, wird ihm das Abschlusszeichen oder das Präfix des
nächsten Feldes unmittelbar angefügt. Der Eintrag wird nicht auf die
volle Speicherlänge aufgefüllt (char, nchar und binary-Daten wurden
von Adaptive Server bereits auf die volle Länge aufgefüllt).
Wenn bcp aus einer Datei in eine Tabelle kopiert, werden Daten so
lange übertragen, bis die in der Eingabeaufforderung „Länge“ angegebene
Byteanzahl erreicht ist oder das Programm auf ein Abschlusszeichen stößt.
Sobald so viele Byte kopiert sind, wie es in der Längenangabe festgelegt
wurde, wird der Rest der Daten gelöscht, bis das Abschlusszeichen
auftritt. Werden keine Abschlusszeichen verwendet, so wird die
Speicherlänge der Tabelle strikt eingehalten.
Felder, die als char (außer char, nchar und binary-Felder) und nicht als ihre
Datenbank-Datentypen gespeichert sind, benötigen weniger Speicherplatz
mit der Standardlänge und Präfix oder Abschlusszeichen. bcp kann sowohl
ein Abschlusszeichen als auch ein Präfix verwenden, um eine optimale
Nutzung des verfügbaren Speicherplatzes zu gewährleisten. bcp schlägt
die maximale Menge für den Speicherplatz vor, der für jedes Feld als
Standard erforderlich ist. Für char oder varchar -Daten akzeptiert bcp
jede Länge.
Tabelle 3-6 und Tabelle 3-7 zeigen die Auswirkung von Präfixlängen,
Abschlusszeichen und Feldlängen auf die Daten in der Datei. „P“ zeigt
das Präfix in der gespeicherten Tabelle, „T“ das Abschlusszeichen und
Bindestriche (--) zeigen angefügte Leerstellen an. Auslassungspunkte (...)
zeigen an, dass sich das Muster bei jedem Feld wiederholt. Die Feldlänge
ist bei jeder Spalte 8 Byte; „string“ stellt immer das 6-Zeichen-Feld dar.
Tabelle 3-6: char-Daten von Adaptive Server
Präfixlänge = 0 Präfixlänge–1, 2 oder 4
Kein
Zeichenfolge-- PZeichenfolge--
Abschlusszeichen Zeichenfolge--... PZeichenfolge--...
Abschlusszeichen Zeichenfolge-- PZeichenfolge--
TZeichenfolge--T... TPZeichenfolge--T...
Dienstprogramme 49

Formatdateien verwenden
Formatdateien verwenden
Tabelle 3-7: Andere Datentypen konvertiert in char-Speicher
Präfixlänge = 0 Präfixlänge–1, 2 oder 4
Kein
Zeichenfolge--
PZeichenfolgePZeichenfolge...
Abschlusszeichen Zeichenfolge--...
Abschlusszeichen ZeichenfolgeTZeichenfolgeT... PZeichenfolgeTPZeichenfolgeT...
Nachdem Informationen über alle Felder in der Tabelle gesammelt wurden,
fragt Sie bcp, ob Sie die Informationen in einer Formatdatei speichern wollen,
und fordert Sie zur Eingabe eines Dateinamens auf.
Wenn Sie eine Formatdatei verwenden, die für die mit dem bcp-
Dienstprogramm zu kopierenden Daten erstellt wurde, können Sie die
Daten ohne Interaktion importieren und exportieren, d.h. bcp wird Sie
nicht zur Eingabe von Informationen auffordern. Die Formatdatei liefert die
Informationen, die bcp benötigt. Verwenden Sie diese Formatdatei, um Daten
in die Adaptive Server-Installation zurückzukopieren oder um Daten aus einer
Tabelle zu einem beliebigen Zeitpunkt zu exportieren.
Abbildung 3-3 zeigt das Format der bcp-Formatdateien. Sie zeigt die
publishers-Tabelle aus der pubs2-Datenbank. Alle Spalten der Hostdatei
werden im Zeichenformat ohne Präfix angezeigt und verwenden Standard-
Datenlänge, Neue-Zeile-Abschlusszeichen am Ende der letzten Spalte einer
Zeile sowie Tabulatoren als Abschlusszeichen für alle anderen Spalten.
50 Adaptive Server Enterprise

Nummer
von
Spalten
Hostdatei-
Spaltenreihenfolge
Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Abbildung 3-3: bcp-Formatdatei
TDS-
Ebene
Elemente der bcp-Formatdatei
10.0
4
1 SYBCHAR 0 4 "\t" 1 pub_id
2 SYBCHAR 0 20 "\t" 2 pub_name
3 SYBCHAR 0 20 "\t" 3 city
4 SYBCHAR 0 2 "\n" 4 state
Hostdatei-
Datentyp
Präfixlänge Abschlusszeichen
Hostdatei-
Datenlänge
Server-
Spaltenname
Server-
Spaltenreihenfolge
Die folgende Liste führt die verschiedenen Elemente einer bcp-Formatdatei
auf. Verwenden Sie Abbildung 3-3 auf Seite 51 als Beispiel für die
Formatdatei.
Die Tabular Data Stream-Version (TDS) ist immer die erste Zeile der
Datei. Sie gibt die Version von TDS an, die Sie verwenden, und nicht die
Adaptive Server-Version, und wird als eine literale Zeichenfolge ohne
Anführungszeichen dargestellt. In Abbildung 3-3 ist die Version 10.0.
Die zweite Zeile einer bcp-Formatdatei gibt die Anzahl der Spalten an,
die sich auf die Anzahl von Datensätzen in der Formatdatei bezieht,
ohne dabei die Zeilen 1 und 2 mitzuzählen. Alle Spalten in der Host-
Tabelle verfügen über eine Zeile.
Der ersten und zweiten Zeile folgt eine Zeile für jede Spalte in der
Datenbanktabelle. Jede Zeile besteht aus Elementen, die üblicherweise
durch Tabulatoren getrennt werden, ausgenommen der Hostdatei-
Datentyp und die Präfixlänge, die gewöhnlich durch eine Leerstelle
getrennt werden. Die Elemente sind folgende:
Hostdatei-Spaltenreihenfolge
Hostdatei-Datentyp
Dienstprogramme 51

Formatdateien verwenden
Hostdatei-
Spaltenreihenfolge
Präfixlänge
Hostdatei-Datenlänge
Abschlusszeichen
Server-Spaltenreihenfolge
Server-Spaltenname
Spalten-Gesamtstellenzahl
Spalten-Dezimalstellen
Die folgenden Abschnitte beschreiben die Spaltenelemente in der Formatdatei.
Die Hostdatei-Spaltenreihenfolge ist die sequenzielle Zahl des Felds in der
Hostdatendatei, beginnend mit 1.
Hostdatei-Datentyp Hostdatei-Datentyp bezieht sich auf das Speicherungsformat des Felds in der
Hostdatendatei, und nicht auf den Datentyp der Datenbanktabellenspalte.
Tabelle 3-8 listet die gültigen Speicherungsformate auf.
Tabelle 3-8: Speicherungsformat von Hostdatei-Datentypen
Speicherungsformat Adaptive Server-Datentyp
SYBCHAR char, varchar (ASCII)
SYBTEXT text
SYBBINARY binary
SYBIMAGE image
SYBINT1 tinyint
SYBINT2 smallint
SYBINT4 int
SYBFLT8 float
SYBREAL real
SYBBIT bit
SYBNUMERIC numeric
SYBDECIMAL decimal
SYBMONEY money
SYBMONEY4 smallmoney
SYBDATETIME datetime
SYBDATETIME4 smalldatetime
52 Adaptive Server Enterprise

Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Daten, die in ihrem Betriebssystemformat in eine Host-Datei geschrieben
werden, behalten ihre Gesamtstellenzahl. datetime und float-Werte behalten
ihre Gesamtstellenzahl ebenfalls, auch wenn sie in das Zeichenformat
konvertiert werden. Adaptive Server speichert money-Werte mit einer
Gesamtstellenanzahl von einem Zehntausendstel einer Währungseinheit.
Wenn money-Werte in das Zeichenformat konvertiert werden, werden ihre
Zeichenformatwerte allerdings nur auf zwei Stellen genau aufgezeichnet.
Beschreibungen und entsprechende Anwendungen von Datentypen in
Adaptive Server finden Sie in Kapitel 1, „System and User-Defined
Datatypes“, der Dokumentation Reference Manual.
Präfixlänge Präfixlänge zeigt die Byteanzahl im Feldlängen-Präfix an. Die Präfixlänge ist
ein ganzzahliger Wert ohne Vorzeichen von 0, 1, 2 oder 4 Byte, der in die Host-
Datendatei eingebettet ist, die die tatsächliche Länge der im Feld enthaltenen
Daten angibt. Es ist möglich, dass manche Felder Längenpräfixe haben, andere
hingegen nicht.
Tabelle 3-9 zeigt die zulässigen Präfixlängenwerte.
Tabelle 3-9: Erlaubte Präfixlängenwerte
Länge (in Byte) Bereich
0 Kein Präfix
1 2 8 -1; 0-255
2 216-1; 0-65535
4 2 32 -1; 0-4,294,967,295
Hostdatei-Datenlänge Hostdatei-Datenlänge bezieht sich auf die maximale Anzahl von zu
kopierenden Bytes im Feld. Um zu bestimmen, wie viele Daten zu importieren
oder exportieren sind, verwendet bcp einen der folgenden Werte:
Die maximale Feldlänge
Die Präfixlänge (falls vorhanden)
Die Feldabschlusszeichen-Zeichenfolge (falls vorhanden)
Wenn mehr als eine Methode der Feldlängenspezifikation angegeben wird,
wählt bcp diejenige aus, die die geringste Menge an Daten kopiert.
Abschlusszeichen Das Abschlusszeichen kann bis zu 30 Byte Zeichen enthalten, die in
Anführungszeichen („ “) eingeschlossen werden. Das Abschlusszeichen
kennzeichnet das Ende der Daten für das Host-Datendateifeld.
Server-
Spaltenreihenfolge
Die Server-Spaltenreihenfolge stellt die colid (Spaltenkennung) der
syscolumns-Spalte dar, in die die Spalte der Hostdatendatei eingelesen
werden soll. Zusammen mit der Hostdatei-Spaltenreihenfolge bildet dieses
Element die Host-Datendatei-Felder der Datenbank-Tabellenspalten ab.
Dienstprogramme 53

Beispiele: Daten interaktiv exportieren
Server-Spaltenname Der Server-Spaltenname ist der Name der Datenbank-Tabellenspalte,
in die das Feld eingelesen wird.
Spalten-
Gesamtstellenzahl
Spalten-
Dezimalstellen
Die Spalten-Gesamtstellenzahl ist die Gesamtstellenzahl der Datenbank-
Tabellenspalte, in die dieses Feld geladen wird. Dieses Element ist nur
vorhanden, wenn als Speicherungsformat numeric oder decimal vorgegeben ist.
Die Spalten-Dezimalstellen sind die Dezimalstellen der Datenbank-
Tabellenspalte, in die dieses Feld geladen wird. Dieses Element ist nur
vorhanden, wenn als Speicherungsformat numeric oder decimal vorgegeben ist.
Beispiele: Daten interaktiv exportieren
Indem Sie die Standardwerte der Eingabeaufforderungen für bcp ändern,
können Sie Daten so aufbereiten, dass sie von anderer Software verarbeitet
werden können.
Um eine vom Benutzer lesbare Datei zu erstellen, beantworten Sie die bcp-
Eingabeaufforderungen wie folgt:
Dateispeichertyp – Geben Sie 0 ein.
Präfixlänge – Geben Sie 0 ein.
Feldlänge – Übernehmen Sie den Standardwert.
Abschlusszeichen – Das einzugebende Feldabschlusszeichen hängt von
der von Ihnen verwendeten Software ab.
Wählen Sie zwischen begrenzten Feldern oder Feldern mit fester
Länge. Verwenden Sie stets \n, das Neue-Zeile-Abschlusszeichen,
um das letzte Feld abzuschließen.
Bei Feldern mit fester Länge dürfen Sie kein Abschlusszeichen
verwenden. Jedes Feld hat eine feste Länge, wobei Leerstellen die
Felder auffüllen. Benachbarte Felder, in denen die Daten das erste
Feld vollständig anfüllen, scheinen ineinander überzugehen, da es
keine Feldseparatoren in jeder Zeile der Ausgabe gibt. Siehe
untenstehendes Beispiel.
Für eine Komma-begrenzte Ausgabe verwenden Sie ein Komma (,)
als Abschlusszeichen für die einzelnen Felder. Um eine tabulare
Ausgabe zu erzielen, verwenden Sie das Tabulatorzeichen (\t).
54 Adaptive Server Enterprise

Daten mit Feldlängen exportieren
bcp pubs2..sales out sal_out
Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Das folgende Beispiel verwendet Felder mit fester Länge, um eine Ausgabe im
Personal-Computer-Format namens SDF (System Data Format) zu erstellen.
Dieses Format kann von anderer Software problemlos gelesen oder erzeugt
werden.
Hinweis Hinweise zu Formatdateien finden Sie unter „Formatdateien
verwenden“ auf Seite 50.
Die Ergebnisse werden folgendermaßen in der sal_out-Datei gespeichert:
5023 AB-123-DEF-425-1Z3 Oct 31 1985 12:00AM
5023 AB-872-DEF-732-2Z1 Nov 6 1985 12:00AM
5023 AX-532-FED-452-2Z7 Dec 1 1990 12:00AM
5023 BS-345-DSE-860-1F2 Dec 12 1986 12:00AM
5023 GH-542-NAD-713-9F9 Mar 15 1987 12:00AM
5023 NF-123-ADS-642-9G3 Jul 18 1987 12:00AM
5023 XS-135-DER-432-8J2 Mar 21 1991 12:00AM
5023 ZA-000-ASD-324-4D1 Jul 27 1988 12:00AM
5023 ZD-123-DFG-752-9G8 Mar 21 1991 12:00AM
5023 ZS-645-CAT-415-1B2 Mar 21 1991 12:00AM
5023 ZZ-999-ZZZ-999-0A0 Mar 21 1991 12:00AM
6380 234518 Sep 30 1987 12:00AM
6380 342157 Dec 13 1985 12:00AM
6380 356921 Feb 17 1991 12:00AM
7066 BA27618 Oct 12 1985 12:00AM
7066 BA52498 Oct 27 1987 12:00AM
7066 BA71224 Aug 5 1988 12:00AM
7067 NB-1.142 Jan 2 1987 12:00AM
7067 NB-3.142 Jun 13 1990 12:00AM
7131 Asoap132 Nov 16 1986 12:00AM
7131 Asoap432 Dec 20 1990 12:00AM
7131 Fsoap867 Sep 8 1987 12:00AM
7896 124152 Aug 14 1986 12:00AM
7896 234518 Feb 14 1991 12:00AM
8042 12-F-9 Jul 13 1986 12:00AM
8042 13-E-7 May 23 1989 12:00AM
8042 13-J-9 Jan 13 1988 12:00AM
8042 55-V-7 Mar 20 1991 12:00AM
8042 91-A-7 Mar 20 1991 12:00AM
8042 91-V-7 Mar 20 1991 12:00AM
Dienstprogramme 55

Beispiele: Daten interaktiv exportieren
Die Formatdatei sal_fmt sieht wie folgt aus:
10.0
3
1 SYBCHAR 04 "" 1 stor_id
2 SYBCHAR 020 "" 2 ord_num
3 SYBCHAR 026 "" 3 date
Daten mit Begrenzern exportieren
Hinweise zu Formatdateien finden Sie unter „Formatdateien verwenden“ auf
Seite 50.
In diesem Beispiel kopiert bcp interaktiv Daten aus der publishers-Tabelle in
eine Datei.
Hinweis Hinweise zu Formatdateien finden Sie unter „Formatdateien
verwenden“ auf Seite 50.
Komma- und Neue-Zeile-begrenzte Ausgabe mit Formatdatei
Das erste Beispiel erstellt eine Ausgabe mit Kommas zwischen allen Feldern
in einer Zeile und einem Neue-Zeile-Abschlusszeichen am Ende jeder Zeile.
Es erstellt eine Formatdatei (pub_fmt), die Sie später verwenden können,
um dieselben oder ähnliche Daten in die Adaptive Server-Installation
zurückzukopieren.
bcp pubs2..publishers out pub_out
Die Ergebnisse werden folgendermaßen in der pub_out-Datei gespeichert:
0736,New Age Books,Boston,MA
0877,Binnet & Hardley,Washington,DC
1389,Algodata Infosystems,Berkeley,CA
56 Adaptive Server Enterprise

Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Der Inhalt der pub_fmt-Formatdatei sieht wie folgt aus:
10.0
4
1 SYBCHAR 0 4 "," 1 pub_id
2 SYBCHAR 0 40 "," 2 pub_name
3 SYBCHAR 0 20 "," 3 city
4 SYBCHAR 0 2 "\n" 4 state
Tabulator-begrenzte Ausgabe mit Formatdatei
Entsprechend erstellt das folgende Beispiel eine tabulator-begrenzte Ausgabe
von der Tabelle pubs2..publishers in der Datei pub_out.
bcp pubs2..publishers out pub_out
Die Ergebnisse werden in der pub_out-Datei folgendermaßen gespeichert:
0736 New Age Books Boston MA
0877 Binnet & Hardley Washington DC
1389 Algodata Infosystems Berkeley CA
Der Inhalt der pub_fmt-Formatdatei sieht wie folgt aus:
10.0
4
1 SYBCHAR 04 "\t" 1 pub_id
2 SYBCHAR 040 "\t" 2 pub_name
3 SYBCHAR 020 "\t" 3 city
4 SYBCHAR 02 "\n" 4 state
Beispiele: Daten interaktiv importieren
Um Daten einer Datei erfolgreich in eine Tabelle zu kopieren, müssen Sie
wissen, welche Abschlusszeichen die Datei enthält, oder welche Werte die
Feldlängen haben. Die entsprechenden Angaben sind einzugeben, wenn Sie
bcp verwenden.
Die folgenden Beispiele zeigen, wie man Daten entweder mit Feldern fester
Länge oder mit Begrenzern importiert, wobei bcp mit oder ohne eine
Formatdatei verwendet wird.
Dienstprogramme 57

Beispiele: Daten interaktiv importieren
Daten mit Feldlängen importieren
In diesem Beispiel kopiert bcp Daten aus der Datei salesnew in die Tabelle
pubs2..sales.
In der salesnew-Datei gibt es drei Felder: das erste ist 4, das zweite 20
und das dritte 26 Zeichen lang. Jede Zeile endet mit einem Neue-Zeile-
Abschlusszeichen (\n), und zwar folgendermaßen:
5023ZS-731-AAB-780-2B9 May 24 1993 12:00:00:000AM
5023XC-362-CFB-387-3Z5 May 24 1993 12:00:00:000AM
6380837206 May 24 1993 12:00:00:000AM
6380838441 May 24 1993 12:00:00:000AM
Mit dem folgenden Befehl werden die Daten interaktiv aus salesnew in die
Tabelle kopiert:
bcp pubs2..sales in salesnew
Das System antwortet folgendermaßen auf den bcp-Befehl:
Password:
Enter the file storage type of field stor_id [char]:
Enter prefix-length of field stor_id [0]:
Enter length of field stor_id [4]:
Enter field terminator [none]:
Enter the file storage type of field ord_num [char]:
Enter prefix-length of field ord_num [1]: 0
Enter length of field ord_num [20]:
Enter field terminator [none]:
Enter the file storage type of field date [datetime]: char
Enter prefix-length of field date [1]: 0
Enter length of field date [26]:
Enter field terminator [none]: \n
Do you want to save this format information in a file? [Y/n] y
Host filename [bcp.fmt]: salesin_fmt
Starting copy...
4 rows copied.
Clock Time (ms.): total = 1 Avg = 0 (116000.00 rows per sec.)
Wenn Sie sich bei Adaptive Server anmelden und auf sales zugreifen, können
Sie die folgenden Daten aus salesnew sehen, die an die Tabelle angehängt sind:
select * from sales
stor_id ord_num date
------- -------------------- -------------------------
5023 AB-123-DEF-425-1Z3 Oct 31 1985 12:00AM
5023 AB-872-DEF-732-2Z1 Nov 6 1985 12:00AM
58 Adaptive Server Enterprise

Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
5023 AX-532-FED-452-2Z7 Dec 1 1990 12:00AM
5023 BS-345-DSE-860-1F2 Dec 12 1986 12:00AM
5023 GH-542-NAD-713-9F9 Mar 15 1987 12:00AM
5023 NF-123-ADS-642-9G3 Jul 18 1987 12:00AM
5023 XS-135-DER-432-8J2 Mar 21 1991 12:00AM
5023 ZA-000-ASD-324-4D1 Jul 27 1988 12:00AM
5023 ZD-123-DFG-752-9G8 Mar 21 1991 12:00AM
5023 ZS-645-CAT-415-1B2 Mar 21 1991 12:00AM
5023 ZZ-999-ZZZ-999-0A0 Mar 21 1991 12:00AM
6380 234518 Sep 30 1987 12:00AM
6380 342157 Dec 13 1985 12:00AM
6380 356921 Feb 17 1991 12:00AM
7066 BA27618 Oct 12 1985 12:00AM
7066 BA52498 Oct 27 1987 12:00AM
7066 BA71224 Aug 5 1988 12:00AM
7067 NB-1.142 Jan 2 1987 12:00AM
7067 NB-3.142 Jun 13 1990 12:00AM
7131 Asoap132 Nov 16 1986 12:00AM
7131 Asoap432 Dec 20 1990 12:00AM
7131 Fsoap867 Sep 8 1987 12:00AM
7896 124152 Aug 14 1986 12:00AM
7896 234518 Feb 14 1991 12:00AM
8042 12-F-9 Jul 13 1986 12:00AM
8042 13-E-7 May 23 1989 12:00AM
8042 13-J-9 Jan 13 1988 12:00AM
8042 55-V-7 Mar 20 1991 12:00AM
8042 91-A-7 Mar 20 1991 12:00AM
8042 91-V-7 Mar 20 1991 12:00AM
(34 rows affected)
Da es einen eindeutigen Clustered-Index auf den Spalten stor_id- und ord_num
von sales gibt, werden die neuen Zeilen sortiert.
Ein Konflikt oder Regelverstoß kann sich auf den Kopierprozess
folgendermaßen auswirken:
Wenn es in den Daten, die aus der Datei kopiert wurden, eine Verletzung
des eindeutigen Indizes auf den Spalten gegeben hätte, wäre von bcp die
gesamte Anweisungsfolge verworfen worden, in der die problematische
Zeile aufgetreten ist.
Eine Anweisungsfolgengröße von 1 berechnet jede Zeile einzeln, lädt
jedoch langsamer und erstellt eine separate Datenseite für jede Zeile
während einer bcp-Sitzung.
Wenn die kopierten Typen nicht mit den Datenbanktypen kompatibel sind,
scheitert der gesamte Kopiervorgang.
Dienstprogramme 59

Beispiele: Daten interaktiv importieren
Daten mit Begrenzern importieren
In diesem Beispiel kopiert bcp Daten aus der Datei newpubs in die Tabelle
pubs2..publishers. In der newpubs-Datei endet jedes Feld in einer Zeile mit
einem Tabulatorzeichen (\t), und jede Zeile mit einem Neue-Zeile-
Abschlusszeichen (\n). Dies sieht so aus:
1111 Stone Age Books Boston MA
2222 Harley & Davidson Washington DC
3333 Infodata Algosystems Berkeley CA
Da newpubs nur Zeichendaten enthält, können Sie die Zeichen-
Befehlszeilenmarkierung verwenden und die Abschlusszeichen mit
den Befehlszeilenoptionen folgendermaßen angeben:
Auf UNIX-Plattformen:
Daten mit einer Formatdatei importieren
bcp pubs2..publishers in newpubs -c -t\\t -r\\n
Unter Windows NT:
bcp pubs2..publishers in newpubs -c -t\t -r\n
Um Daten unter Verwendung der gespeicherten Formatdatei pub_fmt
zurück in die Adaptive Server-Installation zu kopieren, verwenden Sie
den folgenden Befehl:
bcp pubs2..publishers in pub_out -fpub_fmt
Sie können die pub_fmt-Datei verwenden, um Daten mit demselben Format
in die Adaptive Server-Installation zu kopieren. Wenn Sie eine ähnliche
Datendatei mit anderen Begrenzern haben, können Sie die Begrenzer in der
Formatdatei ändern.
Auf gleiche Weise können Sie die Formatdatei bearbeiten, um etwaige
Änderungen von Feldlängen zu berücksichtigen, solange alle Felder dieselbe
Länge haben. Die Datei moresales enthält beispielsweise die folgenden Daten:
804213-L-9 Jan 21 1993 12:00AM
804255-N-8 Mar 12 1993 12:00AM
804291-T-4 Mar 23 1993 12:00AM
804291-W-9 Mar 23 1993 12:00AM
60 Adaptive Server Enterprise

Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Bearbeiten Sie die Formatdatei sal_fmt, damit sie folgendermaßen aussieht:
10.0
3
1 SYBCHAR 0 4 "" 1 stor_id
2 SYBCHAR 0 7 "" 2 stor_id
3 SYBCHAR 0 21 "\n" 3 date
Dann geben Sie folgenden Befehl ein:
Auf UNIX-Plattformen:
bcp pubs2..sales in moresales -fsal_fmt
Unter Windows NT:
bcp pubs2..sales in moresale -fsal_fmt
Das System meldet sich wie folgt:
Starting copy...
4 rows copied.
Clock Time (ms.): total = 1 Avg = 0 (116000.00 rows per sec.)
bcp mit anderen Sprachen verwenden
Adaptive Server speichert Daten mit dem Standard-Zeichensatz, der
während der Installation konfiguriert wurde. Wenn Ihr Terminal diesen
Standard-Zeichensatz nicht unterstützt, kann er irreführende Zeichen an bcp
versenden, sobald Sie einer Eingabeaufforderung durch Eingabe von Zeichen
nachkommen oder Hostdatei-Skripts verwenden.
Wenn Sie keine Zeichensatz-Optionen auswählen, verwendet bcp den
Zeichensatz, der als Standardwert für die Plattform angegeben wurde.
Dieser Standardwert kann folgende Kommunikationsprobleme entwickeln:
Der Standardwert ist nicht unbedingt der gleiche Zeichensatz, der für
den Adaptive Server konfiguriert wurde.
Der Standard ist nicht unbedingt der Zeichensatz, den der Client
verwendet.
Weitere Hinweise über Zeichensätze und zugeordnete Optionen finden Sie
in Kapitel 8, „Konfiguration der Client/Server-Zeichensatzkonvertierung“,
der Dokumentation Systemadministration für Adaptive Server Enterprise.
Dienstprogramme 61

cp und Zugriffsregeln auf Zeilenebene
bcp und Zugriffsregeln auf Zeilenebene
Wenn Adaptive Server für den Zugriff auf Zeilenebene aktiviert ist und
Sie Daten aus einer Tabelle kopieren, kopiert bcp nur die Zeilen, auf die Sie
Zugriff haben. Um die gesamte Tabelle zu kopieren, müssen Sie zuerst die
Zugriffsregeln löschen und dann bcp out ausführen. Richten Sie im Anschluss
die Zugriffsregeln wieder ein, falls zutreffend.
Wenn Sie große Datenmengen mit bcp in eine Tabelle kopieren,
für die Zugriffsregeln aktiv sind, gibt Adaptive Server möglicherweise
Fehlermeldungen bezüglich einer „Verletzung der Eindeutigkeit“ aus. Wenn
Sie z.B. Daten aus einer bcp-Datendatei einlesen, die erzeugt wurde, bevor
die Zugriffsregeln für die Tabelle erstellt wurden, und die bcp-Datendatei
Zeilen enthält, die davor in die Tabelle eingefügt wurden, können Sie diesen
Fehlertyp erhalten.
Ist dies der Fall, hat der Benutzer den Eindruck, dass die Zeilen, für die der bcp-
Einfügevorgang aufgrund der Eindeutigkeitsverletzung fehlgeschlagen ist,
in der Tabelle nicht enthalten sind. In Wahrheit hat der Benutzer aufgrund
der Zugriffsregeln lediglich keinen Zugriff auf die „fehlenden“ Zeilen.
Um die gesamte Tabelle zu kopieren, löschen Sie die Zugriffsregeln,
lesen die Daten ein und setzen die Zugriffsregeln danach wieder ein.
Importieren und Anweisungsfolgedateien
Die Anweisungsfolgefunktion gilt nur, wenn Sie mit dem Massenexport/import
Daten in eine Tabelle kopieren. Sie hat keine Wirkung, wenn Sie Daten
aus einer Tabelle exportieren. Standardmäßig kopiert Adaptive Server alle
Zeilen in Anweisungsfolgen von 1000 Ausgabezeilen. Um eine andere Größe
der Anweisungsfolge festzulegen, verwenden Sie den Programm-
Startparameter (-b).
bcp kopiert alle Anweisungsfolgen in einer einzigen Transaktion. Wenn
Adaptive Server eine beliebige Zeile in der Anweisungsfolge verwirft, wird die
gesamte Transaktion zurückgesetzt. Standardmäßig kopiert bcp alle Zeilen in
einer einzigen Anweisungsfolge. Verwenden Sie den -b -Parameter, um die
Standard-Anweisungsfolgengröße zu ändern. Adaptive Server betrachtet
jede Anweisungsfolge als einen einzelnen bcp-Vorgang, schreibt jede
Anweisungsfolge auf eine separate Datenseite und fährt mit der nächsten
Anweisungsfolge fort, unabhängig davon, ob die vorherige Transaktion
erfolgreich war oder nicht.
62 Adaptive Server Enterprise

Wiederherstellbarkeit erleichtern
Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Die importierten Daten können entweder von Adaptive Server oder von bcp
zurückgewiesen werden.
Adaptive Server behandelt jede Anweisungsfolge als eine eigene
Transaktion. Wenn der Server eine beliebige Zeile in der Anweisungsfolge
verwirft, wird die gesamte Transaktion zurückgesetzt.
Wenn bcp eine Anweisungsfolge zurückweist, wird mit der nächsten
Anweisungsfolge fortgefahren. Nur schwerwiegende Fehler machen die
Transaktion rückgängig.
Adaptive Server erzeugt Fehlermeldungen pro Anweisungsfolge und
nicht pro Zeile. Wenn ein Fehler gefunden wird, wird die gesamte
Anweisungsfolge verworfen. Fehlermeldungen werden auf Ihrem
Terminal und in der Fehlerdatei angezeigt.
So sorgen Sie für eine verbesserte Wiederherstellbarkeit:
Teilen Sie große Eingabedateien in kleinere Einheiten auf.
Beispiel: Sie verwenden bcp mit einer Anweisungsfolgengröße von
100.000 Zeilen, um 300.000 Zeilen zu importieren. Nach Zeile 200.000
tritt ein schwerwiegender Fehler auf. bcp hat in diesem Fall die ersten zwei
Anweisungsfolgen (200.000 Zeilen) erfolgreich in die Adaptive Server-
Installation kopiert. Ohne Anweisungsfolgenfunktion hätte bcp keine
Zeilen in Adaptive Server kopieren können.
Stellen Sie trunc log on chkpt auf true (aktiviert) ein.
Der Logeintrag für die Transaktion kann nach Abschluss der
Anweisungsfolge gekürzt werden. Wenn Sie in eine Datenbank kopieren,
für die die Datenbankoption trunc log on chkpt eingeschaltet ist (true),
entfernt der nächste automatische Checkpoint die Logeinträge für
abgeschlossene Anweisungsfolgen. Damit werden große bcp-Vorgänge
zerlegt, was wiederum verhindert, dass das Log zu sehr wächst.
Stellen Sie -b batch_size auf 10 ein.
Die Einstellung des Anweisungsfolgengröße-Parameters auf 10
bewirkt, dass bcp die Anweisungsfolge von 10 Zeilen, einschließlich der
fehlerhaften Zeile, zurückweist. Anhand des Fehlerlogs können Sie bei
dieser Einstellung präzise ermitteln, welche Zeile fehlerhaft ist.
Dienstprogramme 63

Exportieren und Text- und Bilddaten
bcp verarbeitet Anweisungsfolgen mit einer Mindestgröße von 1.
Hinweis bcp erstellt 1 Datenseite pro Anweisungsfolge. Wenn Sie b
batch_size auf 10 einstellen, werden 10 Zeilen auf jeder Seite erstellt.
Wenn Sie -b batch_size auf 1 einstellen, werden Datenseiten mit 1 Zeile
pro Seite erstellt. Diese Einstellung führt dazu, dass Daten langsam
geladen werden und Speicherplatz beansprucht wird.
Anweisungsfolgen und partitionierte Tabellen
Wenn Sie beim Massenexport/-import von Daten in eine partitionierte Tabelle
kopieren, ohne eine Partitionsnummer anzugeben, ordnet Adaptive Server jede
Anweisungsfolge nach dem Zufallsprinzip (ungesteuert) einer verfügbaren
Partition zu. Das Kopieren von Zeilen in einer einzigen Anweisungsfolge
platziert alle kopierten Zeilen in eine einzige Partition, was ein
Ungleichgewicht beim Laden der partitionierten Tabelle zur Folge
haben könnte.
Um zu erreichen, dass partitionierte Tabellen gleichmäßig geladen werden,
sollten Sie beim Kopieren mit dem Massenexport/-import der Daten eine
geringe Anweisungsfolgengröße verwenden oder während der bcp-Sitzung
eine Partitionskennung angeben. Weitere Hinweise zu Tabellenpartitionen
finden Sie in der Dokumentation Performance and Tuning Guide.
Exportieren und Text- und Bilddaten
Wenn Sie text oder image -Daten exportieren, kopiert Adaptive Server
standardmäßig nur die ersten 32 KByte der Daten in ein text oder image-Feld.
Mit dem Parameter -T text_or_image_size können Sie einen anderen Wert
angeben. Beispiel: Wenn das Feld text, das aus der Tabelle kopiert werden soll,
bis zu 40 KByte Daten enthält, kopieren Sie die gesamten 40 KByte mit dem
folgenden Befehl:
bcp pubs2..publishers out -T40960
Hinweis Wenn ein text or image-Feld größer als der angegebene Wert oder der
Standardwert ist, exportiert bcp die verbleibenden Daten nicht.
64 Adaptive Server Enterprise

Netzwerkpaketgröße festlegen
Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Um die Performance von umfangreichen Massenexport/-importen zu erhöhen,
empfiehlt es sich, größere Netzwerkpaketgrößen als die Standardwerte zu
verwenden. Die Option -A Größe gibt die Netzwerkpaketgröße an, die in einer
bcp-Sitzung verwendet werden soll.
Der Wert von Größe muss
zwischen den für die Konfigurationsparameter default network packet size
und max network packet size festgelegten Werten liegen und
ein Vielfaches von 512 sein
Hinweis Die neue Paketgröße gilt nur für die aktuelle bcp-Sitzung.
Der folgende Befehl legt beispielsweise fest, dass Adaptive Server 40 KByte
von text oder image-Daten mit einer Paketgröße von 2048 Byte für diese bcp-
Sitzung verwendet.
bcp pubs2..authors out -A 2048 -T40960
Importieren und Fehlerdateien
Wenn Sie die Option -e error_file beim Importieren angeben, speichert bcp die
Zeilen, die nicht in die Adaptive Server-Installation kopiert werden konnten,
in der angegebenen Fehlerdatei.
Die Fehlerdatei speichert die folgenden Elemente:
Eine Ausgabezeile, die angibt, welche Zeile fehlgeschlagen und
welcher Fehler aufgetreten ist
Eine Ausgabezeile, die eine exakte Kopie der Zeile in der Hostdatei
darstellt
Wenn der nach dem -e angegebene Dateiname bereits vorhanden ist,
überschreibt bcp die vorhandene Datei.
Wenn bcp auf keine Fehler stößt, wird die Datei nicht erstellt.
Dienstprogramme 65

Importieren und Fehlerdateien
bcp in erkennt zwei Typen von Fehlern:
Datenkonvertierungsfehler
Fehler beim Kompilieren der Zeile: Versuche, einen Nullwert in Spalten
einzufügen, die keine Nullwerte akzeptieren, oder unzulässige
Datenformate (wie eine 3-Byte-Ganzzahl)
Der laufende Kopiervorgang zeigt Fehlermeldungen auf Ihrem Bildschirm an.
Das folgende Beispiel lädt die Datei newpubs in die Datenbank publishers,
wobei etwaige Fehlerzeilen in der Datei pub_err gespeichert werden:
bcp pubs2..publishers in newpubs -epub_err
Beachten Sie Folgendes, wenn Sie mit Fehlerdateien arbeiten, die beim
Importieren erzeugt werden:
bcp speichert Zeilen nur in einer Fehlerdatei, wenn das Programm bcp
selbst den Fehler entdeckt.
bcp kopiert weitere Zeilen, bis bcp auf die Höchstzahl von Fehlerzeilen
stößt, woraufhin bcp den Kopiervorgang stoppt.
bcp sendet Zeilen in Anweisungsfolgen an Adaptive Server, daher kann
bcp keine Kopien von Zeilen speichern, die Adaptive Server zurückweist
(z.B. bei einer doppelten Zeile für eine Tabelle, die einen eindeutigen
Index hat).
Adaptive Server erzeugt Fehlermeldungen pro Anweisungsfolge und nicht
pro Zeile. Wenn ein Fehler gefunden wird, wird die gesamte
Anweisungsfolge verworfen.
Adaptive Server sieht es nicht als Fehler an, doppelte Zeilen zu verwerfen,
wenn entweder allow_dup_row oder ignore_dup_key beim Erstellen
eines Tabellenindex festgelegt wurden. Der Kopiervorgang wird normal
weitergeführt, aber die doppelten Zeilen werden weder in der Tabelle noch
in der bcp-Fehlerdatei gespeichert.
66 Adaptive Server Enterprise

Exportieren und Fehlerdateien
Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Wie beim Importieren überschreibt bcp während des Exportvorgangs
eine Datei desselben Namens und erstellt die Fehlerdatei nur, wenn Fehler
auftreten.
Es gibt zwei Situationen, in denen Zeilen während des Kopierens von Daten
aus einer Tabelle in der Fehlerdatei protokolliert werden:
Ein Daten-Konvertierungsfehler in einer der Spalten der Zeile
Ein I/O-Fehler beim Schreiben in die Hostdatei
Beachten Sie Folgendes, wenn Sie mit Fehlerdateien arbeiten, die beim
Exportieren erzeugt werden:
bcp protokolliert Zeilen in der Fehlerdatei im Standard-Zeichenformat.
Alle Daten werden als Zeichen mit Tabulatoren zwischen den Spalten und
einem Neue-Zeile-Abschlusszeichen am Ende jeder Zeile angezeigt.
Datenintegrität: Standardwerte, Regeln und Trigger
Standardwerte und Datentypen
Um Datenintegrität zu gewährleisten, verarbeitet bcp die zu kopierenden Daten
abhängig von den dazugehörigen Elementen.
Wenn Sie Daten in eine Tabelle kopieren, beachtet bcp die Standardwerte,
die für Spalten und benutzerdefinierte Datentypen definiert sind. Das heißt,
wenn es ein Nullfeld in den Daten in einer Datei gibt, lädt bcp während des
Kopiervorgangs statt des Nullwerts den Standardwert.
Beispiel: Die folgenden zwei Zeilen sollen in authors geladen werden:
409-56-7008,Bennet,David,415 658-9932,622 Pine
St.,Berkeley,CA,USA,94705213-46-8915,Green,Marjorie,,309 63rd St.
#411,Oakland,CA,USA,94618
Dienstprogramme 67

Wie unterscheidet sich bcp von anderen Dienstprogrammen?
Kommas trennen die Felder und ein Neue-Zeile-Abschlusszeichen trennt die
Zeilen. Es gibt keine Telefonnummer für Marjorie Green. Da die Spalte phone
der Tabelle authors einen Standardwert von „unknown“ (unbekannt) hat,
werden die Zeilen in der geladenen Tabelle folgendermaßen dargestellt:
409-56-7008 Bennet David 415 658-9932 622 Pine St.
Berkeley CA USA 94705
213-46-8915 Green Marjorie unknown 309 63rd St. #411
Oakland CA USA 94618
Regeln und Trigger
Um die maximale Geschwindigkeit beim Laden von Daten zu ermöglichen,
aktiviert bcp weder Regeln noch Trigger.
Um Zeilen zu ermitteln, die Regeln oder Trigger übertreten, kopieren Sie die
Daten in die Tabelle und führen Abfragen oder gespeicherte Prozeduren aus,
die die Regel- oder Trigger-Bedingungen testen.
Wie unterscheidet sich bcp von anderen
Dienstprogrammen?
dump database,
load database,
dump transaction
und load transaction
Das bcp-Dienstprogramm kopiert komplette Tabellen oder Teile einer
einzelnen Tabelle und unterscheidet sich von anderen Dienstprogrammen zum
Verschieben von Daten.
Die folgende Liste führt andere Dienstprogramme und ihre Befehle auf und
beschreibt, wie Sie sie am besten zum Verschieben von Daten verwenden.
Verwenden Sie die SQL-Befehle dump database, load database, dump
transaction und load transaction nur für Sicherungszwecke. Im Gegensatz zu
bcp erstellen die dump-Befehle ein physisches Abbild der gesamten
Datenbank.
Sie müssen load database oder load transaction verwenden, um mit dump
database oder dump transaction gesicherte Daten zu laden.
Weitere Hinweise zur Verwendung der SQL-Befehle dump und load finden Sie
in den Dokumentationen Systemadministration für Adaptive Server Enterprise
und Reference Manual.
68 Adaptive Server Enterprise

insert, update
und delete
Kapitel 3 Daten mit bcp in und aus Adaptive Server übertragen
Verwenden Sie die Datenänderungsbefehle insert, update und delete, um einer
Tabelle oder Ansicht neue Zeilen hinzuzufügen, vorhandene Zeilen darin zu
ändern oder Zeilen aus einer Tabelle oder Ansicht zu entfernen.
Verwenden Sie den insert-Befehl mit einer select-Anweisung, um Daten
zwischen Tabellen zu verschieben.
Verwenden Sie die select-Anweisung mit einer into-Klausel, um eine neue
Tabelle zu erstellen, basierend auf:
den in der select-Anweisung angegebenen Spalten
den in der from-Klausel angegebenen Tabellen und
Daten der in der where-Klausel angegebenen Zeilen
Hinweise zum Hinzufügen, Ändern oder Löschen von Daten finden Sie unter
insert, update und delete in der Dokumentation Reference Manual.
Dienstprogramme 69

Wie unterscheidet sich bcp von anderen Dienstprogrammen?
70 Adaptive Server Enterprise

KAPITEL 4 dsedit verwenden
Mit dsedit arbeiten
dsedit starten
Dieses Kapitel beschreibt, wie Sie das dsedit-Dienstprogramm
verwenden, um die Adaptive Server-Interfaces-Datei zu bearbeiten.
Thema Seite
Mit dsedit arbeiten 71
Servereinträge hinzufügen, anzeigen und bearbeiten 75
dsedit-Fehlerbehandlung 83
dsedit ist ein grafisches Dienstprogramm, mit dem Sie Servereinträge in
der Interfaces-Datei (sql.ini in Windows 98 und Windows NT) anzeigen
und bearbeiten können. Eine ausführliche Beschreibung der dsedit-Syntax
finden Sie unter „dsedit“ auf Seite 218.
Hinweis UNIX-Benutzer: Wenn Ihr System kein X-Windows enthält,
verwenden Sie dscp, um Servereinträge in der Interfaces-Datei zu
konfigurieren. Weitere Informationen finden Sie in Kapitel 5, „dscp
verwenden“.
Windows NT Sie können dsedit von der Befehlszeilen, vom Windows NT Explorer oder
von der Programmgruppe „Sybase“ aus starten.
❖ dsedit von der Befehlszeile aus starten
Geben Sie ein:
dsedit
Dienstprogramme 71

Mit dsedit arbeiten
Sie können eine der folgenden Befehlszeilenoptionen festlegen:
-ddsName – Benennt den Verzeichnisdienst, mit dem eine
Verbindung hergestellt werden soll. dsName ist der lokale Name des
Verzeichnisdienstes, wie er in der libtcl.cfg-Datei aufgeführt ist.
Wenn Sie das Argument -ddsName nicht angeben, zeigt dsedit im
ersten Dialogfeld eine Liste mit Verzeichnisdienstoptionen an.
-lPfad – Benennt den Pfad zur libtcl.cfg-Datei, wenn dieser nicht
SYBASE_home\INI ist. Benutzen Sie dieses Argument nur, wenn
Sie eine andere libtcl.cfg-Datei verwenden möchten als die in
SYBASE_home\INI gespeicherte.
❖ dsedit mit dem Windows NT Explorer starten
1 Wechseln Sie ins Verzeichnis %SYBASE%\bin\.
2 Doppelklicken Sie auf die DSEDIT.exe-Datei.
❖ e dsedit mit der Windows-Programmgruppe starten
1 Im Menü „Start“ wählen Sie „Sybase“.
2 Wählen Sie dsedit im Menü „Sybase“. Das Dialogfeld „Select Directory
Service“ (Verzeichnisdienst wählen) erscheint.
UNIX-Plattformen Bevor Sie dsedit starten, vergewissern Sie sich, dass Sie eine Schreibberechtigung
für die Interfaces-Datei haben.
Wenn Sie dsedit von einem entfernten Rechner ausführen, stellen Sie sicher,
dass die DISPLAY-Umgebungsvariable so eingestellt ist, dass die dsedit-
Bildschirme auf Ihrem System und nicht auf dem entfernten Rechner angezeigt
werden.
❖ DISPLAY-Umgebungsvariable einstellen
1 Melden Sie sich beim entfernten Rechner an.
2 Geben Sie ein:
❖ dsedit starten
setenv DISPLAY Name_Ihres_Rechners:0.0
Geben Sie ein:
$SYBASE/bin/dsedit
Das Dialogfeld „Select Directory Service“ (Verzeichnisdienst wählen)
erscheint. Mit diesem Fenster können Sie Sitzungen zur Bearbeitung
der Interfaces-Datei öffnen. Der vollständige Pfadname der Standard-
Interfaces-Datei wird im Feld „Interfaces File to Edit“ angezeigt. Der
vollständige Pfadname der Konfigurationsdatei ist darunter zu sehen.
72 Adaptive Server Enterprise

Eine Bearbeitungssitzung öffnen
Kapitel 4 dsedit verwenden
Windows NT Das Dialogfeld „Select Directory Service“ ermöglicht es Ihnen, eine Sitzung
mit einem Verzeichnisdienst zu öffnen. Sie können eine Sitzung
folgendermaßen öffnen:
Mit jedem Verzeichnisdienst, der einen Treiber in der libtcl.cfg-Datei
angeführt hat.
Mit der sql.ini-Datei.
❖ Eine Sitzung in Windows NT öffnen
1 Doppelklicken Sie auf den lokalen Namen des Directory Services, mit
dem Sie sich verbinden wollen, wie im Feld „DS Name“ aufgelistet.
2 Oder klicken Sie auf den lokalen Namen des Directory Services,
mit dem Sie sich verbinden wollen, wie im Feld „DS Name“ aufgelistet,
und klicken Sie auf die Schaltfläche „OK“.
Hinweis dsedit verwendet die SYBASE-Umgebungsvariable, um die
libtcl.cfg-Datei zu lokalisieren. Wenn die SYBASE-Umgebungsvariable
nicht korrekt eingestellt ist, kann dsedit die libtcl.cfg-Datei nicht finden.
Die Sitzungsnummer und der lokale Name des Verzeichnisdienstes
erscheinen in der Titelleiste.
❖ Zusätzliche Sitzungen öffnen
Sie können mit dsedit mehrere Sitzungen gleichzeitig geöffnet haben.
1 Wählen Sie „Open Directory Service“ aus dem Menü „File“ aus.
Das Feld „Select Directory Service“ erscheint.
2 Doppelklicken Sie auf den lokalen Namen des Directory Services,
mit dem Sie sich verbinden wollen (oder klicken Sie auf den Directory
Service-Namen und wählen „OK“).
Wenn Sie mehrere Sitzungen öffnen, können Sie Einträge von einem
Verzeichnisdienst in einen anderen kopieren. Weitere Informationen finden
Sie unter „Servereinträge kopieren“ auf Seite 82.
Dienstprogramme 73

Mit dsedit arbeiten
UNIX-Plattformen
❖ Zwischen Sitzungen wechseln
Wenn Sie gleichzeitig mehrere Sitzungen geöffnet haben, müssen Sie eine
Sitzung aktivieren, bevor Sie in ihr arbeiten können.
Zum Aktivieren einer Sitzung stehen Ihnen zwei Möglichkeiten zur
Verfügung:
Klicken Sie auf das Sitzungsfenster.
Wählen Sie die Sitzung aus dem Windows-Menü.
Die dsedit-Titelleiste zeigt an, welche Sitzung aktiv ist.
❖ Standard-Interfaces-Datei für die Bearbeitung öffnen
1 Wählen Sie „Sybase Interfaces File“ aus.
2 Klicken Sie auf OK.
❖ Eine andere als die Standard-Interfaces-Datei öffnen
1 Wählen Sie „Sybase Interfaces File“ aus.
2 Bearbeiten Sie den angezeigten Dateinamen.
3 Klicken Sie auf OK.
Das Fenster „Directory Service Session“ wird angezeigt.
Sie können mehrere Interfaces-Datei-Sitzungen mit verschiedenen Dateien
öffnen.
Der Bildschirm „Directory Service Session“ zeigt den vollständigen
Pfadnamen der Interfaces-Datei an und listet die darin enthaltenen
Servereinträge auf.
Add new server entry – Zeigt das Fenster „Server Entry Editor“ an, in dem
Sie Name und Netzwerkadresse für einen neuen Servereintrag festlegen.
Modify server entry – Damit können Sie die Netzwerkadressen für einen
ausgewählten Servereintrag anzeigen und ändern. Um einen Servereintrag
anzuzeigen oder zu ändern, wählen Sie den Server in der Liste aus und
klicken auf „Modify server entry“, um die Attribute des Servers im Fenster
„Server Entry Editor“ anzuzeigen.
Copy server entry – Damit können Sie einen oder mehrere Einträge in eine
andere Interfaces-Datei kopieren.
Close Session – Schließt das Sitzungsfenster und schreibt die Änderungen
in die Interfaces-Datei.
74 Adaptive Server Enterprise

Kapitel 4 dsedit verwenden
Prozeduren zur Verwendung dieser Schaltflächen werden unter
„Servereinträge in Windows NT ändern“ auf Seite 76 beschrieben.
Ein Klicken auf die Schaltflächen „Add new server entry“ oder „Modify server
entry“ zeigt das Fenster „Server Entry Editor“ an.
Sie verwenden das Fenster „Server Entry Editor“, um Servereinträge in einer
Interfaces-Datei anzuzeigen und zu bearbeiten.
Server name – Wenn Sie einen Servereintrag hinzufügen, geben Sie den
Namen des neuen Servers ein. Wenn Sie einen Servereintrag bearbeiten,
können Sie das Namensfeld bearbeiten, um den Server umzubenennen.
Der neue Name darf nicht bereits in der Interfaces-Datei vorhanden sein.
Available network transports – Eine Liste von Netzwerkadressen, bei
denen der Server Clientverbindungen akzeptiert.
Um eine neue Adresse zu erstellen, klicken Sie auf „Add network
transport“. Siehe „Servereinträge in Windows NT ändern“ auf
Seite 76.
Um eine vorhandene Adresse zu bearbeiten, klicken Sie auf „Modify
network transport“. Siehe „Servereinträge in Windows NT ändern“
auf Seite 76.
Um eine ausgewählte Netzwerkadresse zu entfernen, klicken Sie auf
„Delete network transport“.
Um die Reihenfolge der Adressen in der Liste zu ändern, klicken
Sie auf „Move network transport up“ oder „Move network
transport down“.
OK – Schreibt Ihre Änderungen fest und schließt das Fenster. Änderungen
in der Interfaces-Datei werden erst angewandt, wenn Sie die Sitzung mit
der Schaltfläche „Close Session“ des Fensters „Directory Service
Session“ schließen.
Cancel – Schließt das Fenster, ohne etwaige Änderungen anzuwenden.
Servereinträge hinzufügen, anzeigen und bearbeiten
Sobald Sie sich in einer geöffneten Sitzung befinden, können Sie
Servereinträge, die dieser Sitzung zugeordnet sind, hinzufügen, ändern,
umbenennen und löschen, wie auch Servereinträge innerhalb einer Sitzung
kopieren oder von Sitzung zu Sitzung übertragen.
Dienstprogramme 75

Servereinträge hinzufügen, anzeigen und bearbeiten
Servereinträge in Windows NT ändern
Die Servereinträge dieser Sitzung erscheinen im Feld „Server“. Klicken Sie auf
einen Servereintrag, um ihn auszuwählen.
Ein Servereintrag umfasst verschiedene Attribute. Die Attribute werden in
Tabelle 4-1 beschrieben.
Attributname Typ des
Werts
Tabelle 4-1: Serverattribute
Beschreibung Standardwert
Server Version Ganzzahl Versionsebene der Server-Objektdefinition. Sybase benutzt
dieses Attribut, um künftige Änderungen der
Objektdefinition zu identifizieren.
110
Server Name Zeichenfolge Servername k.A.
Server Service Zeichenfolge Eine Beschreibung der vom Server gebotenen Dienste.
Dieser Wert kann jede beliebige sinntragende
Beschreibung sein.
Server Status Ganzzahl Der Betriebsstatus des Servers. Gültige Werte sind:
Active (Aktiv)
Stopped (Gestoppt)
Failed (Fehlgeschlagen)
Unknown (Unbekannt)
Security
Mechanism
Zeichenfolge Zeichenfolgen für Objektbezeichner (OID), die die vom
Server unterstützten Sicherheitsmechanismen angeben.
Diese Attribute sind fakultativ. Wenn sie ausgelassen
werden, ermöglicht Open Server Clients, sich mit jedem
Sicherheitsmechanismus zu verbinden, für den Open
Server einen entsprechenden Sicherheitstreiber hat.
Adaptive
Server
76 Adaptive Server Enterprise
4
k.A.

❖ Einen Servereintrag hinzufügen
Kapitel 4 dsedit verwenden
Attributname Typ des
Werts
Beschreibung Standardwert
Server Address Zeichenfolge Eine oder mehrere Adressen für den Server
Das Format der Adresse variiert je nach Protokoll und einige
Protokolle lassen mehr als ein Format zu. Die Optionen sind:
TCP/IP – zwei Formate:
Computername,Portnummer
IP-Adresse,Portnummer
Named Pipe – pipe name: „\pipe“ ist das erforderliche
Präfix für alle Pipe-Namen. Server-Pipes können nur lokal
sein.
Lokal – \pipe\sql\query
Entfernt – \\computer_name\pipe\sql\query
IPX/SPX – drei Formate:
Servername
Netz-Nummer,Knoten-Nummer, Socket-Nummer
Servername,Socket-Nummer
DECnet – vier Formate:
Bereichsnummer.Knotennummer,Objektname
Bereichsnummer.Knotennummer,Objektnummer
Knotenname,Objektname
Knotenname,Objektnummer
k.A.
1 Wählen Sie „Server Object | Add“.
2 Geben Sie einen Servernamen in das Feld „Server Name“ ein.
3 Klicken Sie auf OK.
Der Servereintrag erscheint im Feld „Server“. Wenn Sie für den Server
eine Adresse angeben möchten, müssen Sie den Eintrag ändern.
❖ Ein Serverattribut ändern
Sie können alle Attribute eines Servereintrags ändern.
1 Klicken Sie auf einen Servereintrag im Feld „Server“.
2 Wählen Sie „Server Object | Modify Attribute“.
Dienstprogramme 77

Servereinträge hinzufügen, anzeigen und bearbeiten
3 Klicken Sie auf das Attribut, das Sie ändern wollen, im Feld „Attributes“.
Ein Dialogfeld wird angezeigt, das den Wert des aktuellen Attributs
enthält.
4 Geben Sie einen neuen Wert für das Attribut ein oder wählen Sie einen aus
der Dropdown-Liste.
In Tabelle 4-1 auf Seite 76 finden Sie eine Beschreibung aller Attribute.
5 Klicken Sie auf OK.
❖ Einen Servereintrag umbenennen
1 Klicken Sie auf einen Servereintrag im Feld „Server“.
2 Wählen Sie „Server Object | Rename“.
3 Geben Sie einen neuen Namen für den Servereintrag im Feld „Server
Name“ ein.
4 Klicken Sie auf OK.
❖ Einen Servereintrag löschen
1 Klicken Sie auf einen Servereintrag im Feld „Server“.
2 Wählen Sie „Server Object | Delete“.
❖ Servereinträge innerhalb der aktuellen Sitzung kopieren
1 Klicken Sie auf einen oder mehrere Servereinträge im Feld „Server“.
Benutzen Sie die Umschalttaste, um mehrere Einträge zu markieren.
2 Klicken Sie auf die Schaltfläche „Copy“ (unterhalb der Menüleiste),
oder wählen Sie „Edit | Copy“.
3 Klicken Sie auf die Schaltfläche „Paste“ (unterhalb der Menüleiste),
oder wählen Sie „Edit | Paste“.
dsedit fügt an die kopierten Servereinträge eine Versionsnummer _n an.
Sie können die kopierten Servereinträge mit der Option „Server Object |
Rename“ umbenennen. Weitere Informationen finden Sie unter „Einen
Servereintrag umbenennen“ auf Seite 78.
78 Adaptive Server Enterprise

❖ Servereinträge zwischen Sitzungen kopieren
Kapitel 4 dsedit verwenden
1 Öffnen Sie eine Sitzung mit dem Directory Service oder der sql.ini-Datei,
in die Sie Einträge kopieren möchten.
2 Um eine Sitzung zu öffnen, wählen Sie „File | Open Directory Service“.
Weitere Informationen finden Sie unter „Zusätzliche Sitzungen öffnen“
auf Seite 73.
3 Klicken Sie auf einen oder mehrere Servereinträge im Feld „Server“ der
Sitzung, aus der Sie Einträge kopieren möchten.
Benutzen Sie die Umschalttaste, um mehrere Einträge zu markieren.
4 Um die Servereinträge zu kopieren, klicken Sie auf die Schaltfläche
„Copy“ (unterhalb der Menüleiste) oder wählen Sie „Edit | Copy“.
Um die Servereinträge auszuschneiden, klicken Sie auf die Schaltfläche
„Cut“ (unterhalb der Menüleiste) oder wählen Sie „Edit | Cut“.
5 Aktivieren Sie die Sitzung, in der Sie die Servereinträge einfügen wollen.
Weitere Anweisungen zum Aktivieren einer Sitzung finden Sie unter
„Zwischen Sitzungen wechseln“ auf Seite 74.
6 Klicken Sie auf die Schaltfläche „Paste“ (unterhalb der Menüleiste),
oder wählen Sie „Edit | Paste“.
Sie können die kopierten Servereinträge mit „Server Object | Rename“
umbenennen. Weitere Informationen finden Sie unter „Zwischen Sitzungen
wechseln“ auf Seite 74.
Servereinträge auf UNIX-Plattformen ändern
Um die Prozeduren in diesem Abschnitt auszuführen, öffnen Sie das Fenster
für die Interfaces-Datei-Sitzung, indem Sie die Anleitungen unter „Eine
Bearbeitungssitzung öffnen“ auf Seite 73 verwenden.
Hinweis Nachdem Sie die einzelnen Prozeduren in diesem Abschnitt
ausgeführt haben, müssen Sie auf „Close Session“ klicken, um Ihre
Bearbeitungen an der Interfaces-Datei anzuwenden. Ein Klicken auf diese
Schaltfläche schließt auch das Fenster für die Interfaces-Datei-Sitzung.
Dienstprogramme 79

Servereinträge hinzufügen, anzeigen und bearbeiten
❖ Einen neuen Servereintrag hinzufügen
1 Klicken Sie auf „Add new server entry“.
2 Geben Sie Namen und Netzwerkadresse für einen neuen Servereintrag an.
❖ Einen Servereintrag anzeigen oder ändern
1 Klicken Sie auf „Modify server entry“.
2 Führen Sie die Änderungen an den Attributen durch.
❖ Einen Servereintrag in eine andere Interfaces-Datei kopieren
1 Wählen Sie die zu kopierenden Einträge mit einer der folgenden Methoden
aus:
Um einen einzelnen Eintrag zu kopieren, klicken Sie einmal auf ihn.
Um eine Reihe von aufeinanderfolgenden Einträgen zu kopieren,
klicken Sie auf den ersten Eintrag der Reihe, dann drücken Sie die
Umschalttaste und halten sie gedrückt, während Sie auf den letzten
Eintrag der Reihe klicken. Sie können auch „verkehrtherum“
auswählen, indem Sie auf den letzten Eintrag klicken, die
Umschalttaste gedrückt halten und auf den ersten Eintrag klicken.
Um mehrere, nicht zusammenhängende Einträge auszuwählen,
drücken Sie die Strg-Taste und halten sie gedrückt, während Sie
auf die einzelnen Einträge klicken.
2 Klicken Sie auf „Copy server entry“.
3 Wählen Sie die Sybase-Interfaces-Datei in der Liste aus.
4 Bearbeiten Sie den angezeigten Dateinamen.
5 Klicken Sie auf OK.
Netzwerktransportadressen hinzufügen oder bearbeiten
Mit dem Fenster „Network Transport Editor“ können Sie die Transportadressen
anzeigen, bearbeiten oder erstellen, bei denen ein Server
Clientverbindungen akzeptiert. Dieses Fenster zeigt den Namen des Servereintrags
für die Adresse an und erlaubt es Ihnen, die folgenden Elemente zu
konfigurieren:
Transport type – Legt das Protokoll und die Schnittstelle für die Adresse
fest. Außer bei Digital UNIX gelten für alle Plattformen die Werte tcp, tli
tcp, tli spx und spx. Bei Digital UNIX lauten die Werte decnet, tcp und tli tcp.
80 Adaptive Server Enterprise

Kapitel 4 dsedit verwenden
Address information – Abhängig vom Transporttyp sind unterschiedliche
Adressenkomponenten erforderlich. Die folgenden Abschnitte
beschreiben die Adressenformate genauer.
TCP/IP-Adressen Die Adressenangaben für einen TCP/IP-Eintrag bestehen aus einem
Hostnamen (oder IP-Adresse) und einer Portnummer (als Dezimalwert
angegeben). Bei tli tcp-formatierten Interface-Einträgen werden IP-Adresse
und Portnummer des Hosts in die hexadezimale 16-Byte-Darstellung
konvertiert, die für tli tcp-formatierte Interfaces-Einträge erforderlich ist.
Verwenden Sie tli tcp für Interface-Einträge in folgenden Fällen:
Bei allen Clients vor der Version 10.0 auf Plattformen, die tli-formatierte
Interface-Einträge verwenden.
Bei Adaptive Server oder Replication Server Version 11.0.x oder früher
auf Plattformen, die tli-formatierte Interface-Einträge verwenden.
Verwenden Sie tcp bei anderen Clients und Servern.
Um eine TCP/IP-Adresse anzugeben, wählen Sie tcp oder tli tcp im Menü
„Transport Type“ aus.
SPX/IPX-Adressen
SPX/IPX-Adressen ermöglichen es Adaptive Server, nach Verbindungen von
Clientanwendungen zu suchen, die auf einem Novell-Netzwerk ausführen.
SPX/IPX-Adressen bestehen aus folgenden Elementen:
Host address – Ein hexadezimaler Wert aus acht Ziffern, der die IP-
Adresse des Rechners darstellt, auf dem der Server ausgeführt wird. Jede
Komponente des durch Punkte unterteilten dezimalen IP-Adressenformats
wird durch ein Byte im hexadezimalen Adressenformat abgebildet. Wenn
zum Beispiel die IP-Adresse des Hosts 128.15.15.14 lautet, geben Sie
„800F0F0E“ als den Wert für die SPX/IPX-Hostadresse ein.
Port number – die Portnummer, dargestellt als hexadezimale Nummer aus
vier Ziffern.
Endpoint – der Pfad für die Devicedatei, der auf den SPX-Devicetreiber
zeigt. Verweist standardmäßig auf /dev/mspx bei Solaris und auf /dev/nspx
bei jeder anderen Plattform. Falls erforderlich korrigieren Sie den Pfad,
damit er dem Rechner entspricht, auf dem der Server läuft. Der
Standardpfad basiert auf der Plattform, auf der Sie dsedit ausführen.
Um eine SPX/IPX-Adresse anzugeben, wählen Sie tli spx oder spx im Menü
„Transport Type“ aus.
Dienstprogramme 81

Servereinträge hinzufügen, anzeigen und bearbeiten
Servereinträge kopieren
Windows NT
dsedit ermöglicht es Ihnen, Servereinträge innerhalb einer Sitzung und
zwischen Sitzungen zu kopieren. Außerdem können Sie auch Einträge
aus einer sql.ini-Datei in einen Verzeichnisdienst kopieren.
❖ Servereinträge innerhalb der aktuellen Sitzung kopieren
1 Klicken Sie auf einen oder mehrere Servereinträge im Feld „Server“.
Benutzen Sie die Umschalttaste, um mehrere Einträge zu markieren.
2 Klicken Sie auf die Schaltfläche „Copy“ (unterhalb der Menüleiste),
oder wählen Sie „Edit | Copy“.
3 Klicken Sie auf die Schaltfläche „Paste“ (unterhalb der Menüleiste),
oder wählen Sie „Edit | Paste“.
dsedit fügt an die kopierten Servereinträge eine Versionsnummer _n an.
Sie können die kopierten Servereinträge mit „Server Object | Rename“
umbenennen. Weitere Informationen finden Sie unter „Einen
Servereintrag umbenennen“ auf Seite 78.
❖ Servereinträge zwischen Sitzungen kopieren
1 Öffnen Sie eine Sitzung mit dem Directory Service oder der sql.ini-Datei,
in die Sie Einträge kopieren möchten.
2 Um eine Sitzung zu öffnen, wählen Sie „File | Open Directory Service“.
Weitere Informationen finden Sie unter „Zusätzliche Sitzungen öffnen“
auf Seite 73.
3 Klicken Sie auf einen oder mehrere Servereinträge im Feld „Server“ der
Sitzung, aus der Sie Einträge kopieren möchten.
Benutzen Sie die Umschalttaste, um mehrere Einträge zu markieren.
4 Um die Servereinträge zu kopieren, klicken Sie auf die Schaltfläche
„Copy“ (unterhalb der Menüleiste) oder wählen Sie „Edit | Copy“.
Um die Servereinträge auszuschneiden, klicken Sie auf die Schaltfläche
„Cut“ (unterhalb der Menüleiste) oder wählen Sie „Edit | Cut“.
5 Aktivieren Sie die Sitzung, in der Sie die Servereinträge einfügen wollen.
Weitere Anweisungen zum Aktivieren einer Sitzung finden Sie unter
„So wechseln Sie zu einer anderen geöffneten Sitzung“ auf Seite 86.
82 Adaptive Server Enterprise

UNIX-Plattformen
Kapitel 4 dsedit verwenden
6 Klicken Sie auf die Schaltfläche „Paste“ (unterhalb der Menüleiste),
oder wählen Sie „Edit | Paste“.
Sie können die kopierten Servereinträge mit dem Befehl „Rename“ im Menü
„Server Object“ umbenennen. Weitere Informationen finden Sie unter „Einen
Servereintrag umbenennen“ auf Seite 78.
❖ Einen Servereintrag in eine andere Interfaces-Datei kopieren
dsedit-Fehlerbehandlung
1 Wählen Sie die zu kopierenden Einträge mit einer der folgenden
Methoden aus:
Um einen einzelnen Eintrag zu kopieren, klicken Sie einmal auf ihn.
Um eine Reihe von aufeinanderfolgenden Einträgen zu kopieren,
klicken Sie auf den ersten Eintrag der Reihe, dann drücken Sie die
Umschalttaste und halten sie gedrückt, während Sie auf den letzten
Eintrag der Reihe klicken. Sie können auch „verkehrtherum“
auswählen, indem Sie auf den letzten Eintrag klicken, die
Umschalttaste gedrückt halten und auf den ersten Eintrag klicken.
Um mehrere, nicht zusammenhängende Einträge auszuwählen,
drücken Sie die Strg-Taste und halten sie gedrückt, während Sie
auf die einzelnen Einträge klicken.
2 Klicken Sie auf „Copy server entry“.
3 Wählen Sie die Sybase-Interfaces-Datei in der Liste aus.
4 Bearbeiten Sie den angezeigten Dateinamen.
5 Klicken Sie auf OK.
Dieser Abschnitt listet einige übliche dsedit-Probleme auf und beschreibt,
wie sie zu beheben sind.
Das dsedit-Dienstprogramm startet nicht
Überprüfen Sie Folgendes:
Dienstprogramme 83

dsedit-Fehlerbehandlung
Die SYBASE-Umgebungsvariable ist nicht eingestellt oder verweist auf
das falsche Verzeichnis.
UNIX-Plattformen X-Windows ist nicht korrekt konfiguriert. Wenn
Sie dsedit auf einem entfernten Host ausführen, stellen Sie sicher, dass
X-Windows-Clients auf dem entfernten Host sich mit dem X-Windows-
Server auf Ihrem Rechner verbinden können. In Ihrer X-Windows-
Dokumentation finden Sie weitere Hinweise über die Fehlerbehandlung.
Wenn X-Windows nicht verfügbar ist, verwenden Sie dscp anstelle
von dsedit.
Fehlermeldung: „Öffnen der X-Anzeige nicht möglich“
UNIX-Plattformen dsedit funktioniert möglicherweise nicht, weil der
Anzeige-Rechner so eingestellt ist, dass er X-Windows-Verbindungen von
entfernten Hosts zurückweist. Wenn das das Problem ist, wird eine Meldung
angezeigt, die der folgenden ähnlich ist:
Unable to open X display. Check the value of your
$DISPLAY variable. If it is set correctly, use the
'xhost +' command on the display machine to authorize
use of the X display. If no X display is available,
run dscp instead of dsedit.
Dieser Fehler kann aus einer der folgenden Situationen entstehen:
Der Wert der DISPLAY-Umgebungsvariable ist nicht korrekt eingegeben
oder nicht eingestellt.
Lösung: Geben Sie die DISPLAY-Umgebungsvariable korrekt ein.
Sie sind nicht berechtigt, Fenster auf dem Rechner zu öffnen, auf den sich
DISPLAY bezieht.
Lösung: Führen Sie den Befehl ‘xhost +’ auf dem Anzeige-Rechner aus.
Hinzufügen, Ändern oder Löschen von Servereinträgen nicht
möglich
Überprüfen Sie die Berechtigungen für die Interfaces-Datei. Um Interface-
Einträge bearbeiten zu können, müssen Sie eine Schreibberechtigung sowohl
für die Interfaces-Datei als auch für das Sybase-Installationsverzeichnis haben.
84 Adaptive Server Enterprise

KAPITEL 5 dscp verwenden
Mit dscp arbeiten
dscp ist ein UNIX-Dienstprogramm, mit dem Sie Servereinträge in der
Interface-Datei anzeigen und bearbeiten können.
Hinweis dscp ist nicht für Windows NT verfügbar.
Thema Seite
Mit dscp arbeiten 85
Mit Servereinträgen arbeiten 87
dscp beenden 93
Übersicht über die dscp-Dienstprogrammbefehle 93
Eine ausführliche Beschreibung der dscp-Syntax finden Sie unter dscp auf
Seite 217.
❖ So starten Sie dscp
Geben Sie ein:
$SYBASE/bin/dscp
Die dscp-Eingabeaufforderung >> wird angezeigt.
❖ So rufen Sie die dscp-Hilfe auf
Um den dscp-Hilfebildschirm anzuzeigen, geben Sie einen der
folgenden Befehle ein:
help
h
?
Dienstprogramme 85

Mit dscp arbeiten
Eine dscp-Sitzung verwenden
Bevor Sie Servereinträge anzeigen, hinzufügen oder ändern können, müssen
Sie eine Sitzung öffnen, damit Sie mit der Interface-Datei arbeiten können.
Sie können mehrere Sitzungen gleichzeitig geöffnet haben.
❖ So öffnen Sie eine Sitzung mit der Interface-Datei:
Geben Sie ein:
open InterfacesDriver
Wenn Sie eine Sitzung öffnen, gibt dscp die Nummer der Sitzung an.
Wenn Sie zum Beispiel eine Sitzung mit dem Befehl open InterfacesDriver
öffnen, zeigt dscp die folgende Meldung an:
ok
Session 1 InterfacesDriver>>
❖ So listen Sie alle geöffneten Sitzungen auf
Geben Sie ein:
sess
❖ So wechseln Sie zu einer anderen geöffneten Sitzung
Geben Sie Folgendes ein, wobei Sitzungsnummer die tatsächliche
Sitzungsnummer ist:
switch Sitzungsnummer
Um zum Beispiel zu Sitzung 3 zu wechseln, geben Sie Folgendes ein:
switch 3
Das Schlüsselwort switch ist fakultativ. Wenn Sie zum Beispiel nur „3“
eingeben, wechseln Sie ebenfalls zur Sitzung 3.
❖ So schließen Sie eine Sitzung
Geben Sie Folgendes ein, wobei Sitzungsnummer die tatsächliche
Sitzungsnummer ist:
close Sitzungsnummer
Sitzung 3 zum Beispiel wird geschlossen, wenn Sie Folgendes eingeben:
close 3
Wenn Sie keine Sitzungsnummer angeben, schließt dscp die aktuelle
Sitzung.
86 Adaptive Server Enterprise

Mit Servereinträgen arbeiten
Mit dscp können Sie Servereinträge hinzufügen und ändern.
Servereinträge hinzufügen und ändern
Kapitel 5 dscp verwenden
Nachdem Sie eine Sitzung geöffnet haben, können Sie in dieser Sitzung
Servereinträge hinzufügen oder ändern.
Hinweis Wenn Sie einen Servereintrag hinzufügen oder ändern, erstellt
oder ändert dscp automatisch sowohl die Master-Ausgabezeilen als auch die
Abfragen-Ausgabezeilen. Die Master- und die Abfragen-Ausgabezeilen einer
Interface-Datei enthalten identische Informationen.
Ein Servereintrag umfasst verschiedene Attribute. Wenn Sie einen
Servereintrag hinzufügen oder ändern, fordert Sie dscp zur Eingabe von
Informationen über jedes Attribut auf. Tabelle 5-2 beschreibt die einzelnen
Attribute.
Tabelle 5-1: Serverattribute
Standardwert und
Bearbeitung bei Hinzufügen
oder Ändern eines
Attribute Typ des Werts gültige Werte
Servereintrags möglich
Server Object Ganzzahl 110 Hinzufügen: Nein
Version
Ändern: Nein
Server Name Zeichenfolge k.A. Hinzufügen: k.A.
Ändern: Nein
Server Service Zeichenfolge SQL SERVER Hinzufügen: Ja
Ändern: Nein
Server Status Ganzzahl 4
Hinzufügen: Nein
Gültige Werte sind:
1 Active (Aktiv)
2 Stopped (Gestoppt)
3 Failed (Fehlgeschlagen)
4 Unknown (Unbekannt)
Ändern: Nein
Transport Type Zeichenfolge tcp. Gültige Werte sind:
decnet, spx, tcp, tli, spx,
tli tcp
Hinzufügen: Ja
Ändern: Ja
Dienstprogramme 87

Mit Servereinträgen arbeiten
Attribute Typ des Werts
Transport
Address
Security
Mechanism
Zeichenfolge Keiner. Gültige Werte sind
Zeichenfolgen, die vom
angegebenen Transporttyp
erkannt werden.
Zeichenfolge
Hinweis Sie können bis
zu 20 Sicherheitsmechanismen-
Zeichenfolgen für
jeden Servereintrag
hinzufügen.
❖ So fügen Sie einen Servereintrag hinzu
1 Geben Sie ein:
Standardwert und
gültige Werte
Keiner. Gültige Werte sind
Zeichenfolgen,
die Objektbezeichnern
zugeordnet sind, die in der
Datei objectid.dat
des Benutzers festgelegt
sind.
add Servername
Sie sind nun im Hinzufügungsmodus. Sie können weitere Servereinträge
hinzufügen, allerdings können Sie keine anderen dscp-Befehle ausführen,
bevor Sie nicht diesen Modus verlassen haben. Während Sie im
Hinzufügungsmodus sind, fordert Sie dscp zur Eingabe von
Informationen über Servername auf.
2 Führen Sie eine der folgenden Maßnahmen durch:
Geben Sie einen Wert für jedes Attribut ein, oder
Drücken Sie die Eingabetaste, um den Standardwert zu akzeptieren,
der in Klammern [ ] angezeigt wird.
Beispiel: dscp fordert Sie zur Eingabe der nachstehenden Informationen
auf, wenn Sie Folgendes eingeben:
add myserver
Hinzufügen: Ja
Ändern: Ja
Hinzufügen: Ja
Ändern: Ja
Service: [SQL Server]
Transport Type: [tcp] tcp
Transport Address: victory 8001
Security Mechanism []:
Bearbeitung bei Hinzufügen
oder Ändern eines
Servereintrags möglich
Ein Servereintrag kann bis zu 20 zugeordnete Transporttyp/Adressen-
Kombinationen enthalten.
88 Adaptive Server Enterprise

Kapitel 5 dscp verwenden
Eine Beschreibung der Serverattribute finden Sie in Tabelle 5-1 auf
Seite 87.
3 Um den Hinzufügungsmodus zu beenden, geben Sie Folgendes ein:
#done
❖ So ändern Sie einen Servereintrag
Sie können mit dscp nicht die Versions-, Service- und Statuseinträge in der
Interface-Datei ändern.
1 Geben Sie ein:
mod Servername
Sie sind nun im Änderungsmodus. Sie können weitere Servereinträge
ändern, allerdings können Sie keine anderen dscp-Befehle ausführen,
bevor Sie nicht diesen Modus verlassen haben. Während Sie im
Änderungsmodus sind, fordert Sie dscp zur Eingabe von Informationen
über Servername auf.
2 Führen Sie eine der folgenden Maßnahmen durch:
Geben Sie einen Wert für jedes Attribut ein, oder
Drücken Sie die Eingabetaste, um den Standardwert zu akzeptieren,
der in Klammern [ ] angezeigt wird.
Beispiel: dscp fordert Sie zur Eingabe der nachstehenden Informationen
auf, wenn Sie Folgendes eingeben:
mod myserver
Version: [1]
Service: [SQL Server] Open Server
Status: [4]
Address:
Transport Type: [tcp]
Transport Address: [victory 1824] victory 1826
Transport Type: [tcp]
Transport Address: [victory 1828]
Transport Type: []
Security Mechanism []:
Eine Beschreibung der Serverattribute finden Sie in Tabelle 5-1 auf
Seite 87.
Dienstprogramme 89

Mit Servereinträgen arbeiten
Servereinträge kopieren
3 Um eine Adresse zu löschen, geben Sie Folgendes ein:
#del
4 Um den Änderungsmodus zu beenden, geben Sie Folgendes ein:
#done
dscp ermöglicht es Ihnen, Servereinträge innerhalb einer Sitzung und zwischen
zwei Sitzungen zu kopieren. Es gibt vier Optionen, wenn Sie einen
Servereintrag kopieren.
Sie können Folgendes kopieren:
Einen Servereintrag in einen neuen Namen in der aktuellen Sitzung
Einen Servereintrag in eine andere Sitzung
Einen Servereintrag in einen neuen Namen in einer anderen Sitzung
Alle Einträge in der aktuellen Sitzung in eine andere Sitzung
❖ So erstellen Sie einen neuen Servereintrag durch Kopieren
Geben Sie ein:
copy Name1 to Name2
Nehmen wir als Beispiel folgende Eingabe:
copy myserver to my_server
dscp erstellt einen neuen Eintrag, „my_server“, der mit „myserver“
identisch ist. Sie können den neuen Eintrag bearbeiten, ohne das Original
zu ändern.
❖ So kopieren Sie einen Servereintrag, ohne den Namen zu ändern:
Geben Sie ein:
copy Name1 to Sitzungsnr
Zum Beispiel überträgt dscp den Eintrag „myserver“ der aktuellen Sitzung
in die Sitzung 2, wenn Sie Folgendes eingeben:
copy myserver to 2
90 Adaptive Server Enterprise

❖ So kopieren Sie einen Servereintrag und benennen ihn um
Geben Sie ein:
copy Name1 to Sitzungsnr Name2
Kapitel 5 dscp verwenden
Zum Beispiel kopiert dscp den Eintrag „myserver“ der aktuellen Sitzung
in die Sitzung 2 und benennt ihn in „my_server“ um, wenn Sie Folgendes
eingeben:
copy myserver to 2 my_server
❖ So kopieren Sie alle Einträge in der aktuellen Sitzung in eine andere
Sitzung
Geben Sie ein:
copyall Sitzungsnr
Zum Beispiel kopiert dscp alle Einträge der aktuellen Sitzung in die
Sitzung 2, wenn Sie Folgendes eingeben:
copyall 2
Inhalte von Servereinträgen auflisten und anzeigen
Sie können die Namen und Attribute auflisten, die einer Sitzung
zugeordnet sind.
❖ So listen Sie die Namen von Servereinträgen auf
Geben Sie ein:
list
❖ So listen Sie die Attribute von Servereinträgen auf
Geben Sie ein:
list all
Eine Beschreibung der Serverattribute finden Sie in Tabelle 5-1 auf
Seite 87.
❖ So zeigen Sie den Inhalt eines Servereintrags an
Geben Sie ein:
read Servername
Dienstprogramme 91

Mit Servereinträgen arbeiten
Servereinträge löschen
Die folgenden Informationen werden zum Beispiel angezeigt,
wenn Sie Folgendes eingeben:
read myserver
DIT base for object: interfaces
Distinguish name: myserver
Server Version: 1
Server Name: myserver
Server Service: SQL Server
Server Status: 4 (Unknown)
Server Address:
Transport Type: tcp
Transport Addr: victory 1824
Transport Type: tcp
Transport Addr: victory 1828
Eine Beschreibung der Serverattribute finden Sie in Tabelle 5-1 auf
Seite 87.
Sie können einen Eintrag oder alle Einträge löschen, die einer Sitzung
zugeordnet sind.
❖ So löschen Sie Einträge, die einer Sitzung zugeordnet sind
Geben Sie ein:
del Servername
Zum Beispiel löscht dscp den Eintrag für „myserver“, wenn Sie Folgendes
eingeben:
del myserver
❖ So löschen Sie alle Einträge, die einer Sitzung zugeordnet sind
Geben Sie ein:
delete-all
92 Adaptive Server Enterprise

dscp beenden
Kapitel 5 dscp verwenden
Um dscp zu beenden, geben Sie einen der folgenden Befehle ein:
exit
quit
Übersicht über die dscp-Dienstprogrammbefehle
In dscp führen Sie Funktionen aus, indem Sie Befehle an der dscp-
Eingabeaufforderung eingeben. Tabelle 5-2 bietet eine Übersicht über
diese Befehle.
Tabelle 5-2: dscp-Befehle
Befehl Beschreibung
add Servername Fügt den Servereintrag Servername in der aktuellen Sitzung ein. dscp fordert Sie zur
Eingabe von Informationen über Servername auf. Drücken Sie die Eingabetaste, um den
Standardwert zu akzeptieren, der in eckigen Klammern [ ] angezeigt wird. Geben Sie
„#done“ ein, um den Hinzufügungsmodus zu beenden.
addattr Servername Fügt dem Servereintrag Servername in der aktuellen Sitzung ein Attribut hinzu.
close [Sitzungsnr] Schließt die Sitzung, die durch Sitzungsnr angegeben wird. Wenn Sie keine Sitzungsnr
eingeben, wird die aktuelle Sitzung geschlossen.
config Zeigt Konfigurationsinformationen an, die sich auf Ihre Sybase-Umgebung beziehen.
copy Name1 to Kopiert den Servereintrag Name1 in der aktuellen Sitzung in:
{Name2 | Sitzungsnr | den Servereintrag Name2 in der aktuellen Sitzung
Sitzungsnr_Name2}
die Sitzung Sitzungsnr oder
den Servereintrag Name2 in Sitzung Sitzungsnr.
copyall to Sitzungsnr Kopiert alle Servereinträge in der aktuellen Sitzung in die Sitzung Sitzungsnr.
del Servername Löscht den Servereintrag Servername in der aktuellen Sitzung.
delete-all Löscht alle Servereinträge in der aktuellen Sitzung.
exit Beendet dscp.
help, ?, h Zeigt die Online-Hilfe an.
list [all] Listet die Servereinträge für die aktuelle Sitzung auf. Um die Namen der Einträge
aufzulisten, verwenden Sie den Befehl list. Um die Attribute der einzelnen Einträge
aufzulisten, verwenden Sie den Befehl list all.
mod Servername Ändert den Servereintrag Servername in der aktuellen Sitzung. dscp fordert Sie zur
Eingabe von Informationen über Servername auf. Drücken Sie die Eingabetaste, um den
Standardwert zu akzeptieren, der in eckigen Klammern [] angezeigt wird. Geben Sie
„#done“ ein, um den Änderungsmodus zu beenden.
Dienstprogramme 93

Übersicht über die dscp-Dienstprogrammbefehle
Befehl Beschreibung
open [DS_Name] Öffnet eine Sitzung für den angegebenen Verzeichnisdienst (Directory Service), wobei
DS_Name der Verzeichnisdienstname ist. Wenn Sie keinen Namen für DS_Name angeben,
wird durch diesen Befehl eine Sitzung für den Standard-Verzeichnisdienst geöffnet.
Um eine Sitzung zu öffnen, geben Sie den Wert „InterfacesDriver“ für DS_Name an.
quit Beendet dscp.
read Servername Zeigt den Inhalt des Servereintrags Servername an.
sess Listet alle geöffneten Sitzungen auf.
[switch] Sitzungsnr Macht die Sitzungsnummer Sitzungsnr zur aktuellen Sitzung.
94 Adaptive Server Enterprise

KAPITEL 6 Migrations-Dienstprogramm
Überblick
In diesem Kapitel wird das Dienstprogramm sybmigrate erläutert.
Thema Seite
Überblick 95
Vorbereitungen 100
Migrationsprozess 103
Aufgaben nach der Migration 130
Daten aus Replication Server in Adaptive Server 12.5 migrieren 130
Einschränkungen 138
Problembehebung und Fehlermeldungen 140
Hinweis sybmigrate kann nur auf Adaptive Server 12.5.0.1 und höher
ausgeführt werden.
Mit Adaptive Server 12.5 und höher können Sie die Seitengröße Ihres
Servers mit 2 KByte, 4 KByte, 8 KByte oder 16 KByte konfigurieren.
Bei den herkömmlichen Upgrade-Methoden von Adaptive Server können
Sie die Seitengröße jedoch nicht ändern. Um die aktuelle Seitengröße
Ihres Adaptive Server zu ändern, müssen Sie deshalb zunächst einen
zweiten Adaptive Server mit der gewünschten Seitengröße installieren,
und dann mit dem Dienstprogramm sybmigrate sowohl Schema als auch
Daten aus dem alten Adaptive Server (Quelle) auf den neuen Adaptive
Server (Ziel) kopieren.
sybmigrate ermöglicht Ihnen auch die plattformübergreifende Migration.
Dienstprogramme 95

Überblick
Bestehende Lösungen
Vorteile von sybmigrate
Das Merkmal der variablen Seitengröße erhöht die Funktionalität und
Nutzbarkeit von Adaptive Server, bietet jedoch für bestehende Kunden
keine Upgrade-Möglichkeit. Benutzer, die die Seitengröße eines vorhandenen
Adaptive Server ändern müssen, müssen einen neuen Server mit der
gewünschten Seitengröße einrichten und die Daten vom alten in den neuen
Adaptive Server migrieren. Da die Sicherungs- und Lademechanismen nicht
für mehrere Seitengrößen unterstützt wird, besteht die einzige Möglichkeit
darin, mit ddlgen oder einer ähnlichen Methode ein Schema zu generieren und
die Daten anschließend mit bcp aus dem alten Adaptive Server zu extrahieren
und in den neuen Adaptive Server zu laden. Dieses Verfahren ist recht
schwierig und komplex.
sybmigrate:
Was sybmigrate durchführt
Unterstützt Benutzer bei der Änderung der Seitengröße ihrer
Datenbankanwendungen.
Ermöglicht einen sanften und durchführbaren Migrationsvorgang.
Ermöglicht die Nutzung der Funktion der variablen Seitengröße für
bestehende Datenbanken mit Benutzerdaten, d.h. des gesamten Potenzials
von Adaptive Server 12.5 und höher.
Während der Setup-Phase des Migrationsprozesses werden die folgenden
Serverdaten in den neuen Adaptive Server migriert:
Fremdserver
Logins
Login-Attribute
Serverrollen
Login-Rollen
Rollenattribute
Benutzer
96 Adaptive Server Enterprise

Kapitel 6 Migrations-Dienstprogramm
Alternative Benutzer
Rollen
Berechtigungen
Entfernte Logins
Externe Login-Attribute
Timer
Ressourcengrenzen
Replikationsattribute
Attribute der Anzeigeebene
Benutzernachrichten in der master-Datenbank
Java-Klassen in der master-Datenbank
JAR-Dateien in der master-Datenbank
Während der Migrationsphase des Migrationsprozesses werden die folgenden
datenbankspezifischen Daten in die Zieldatenbank migriert:
Standardwerte
Benutzerdefinierte Datentypen
Regeln
Benutzertabellen
Benutzertabellendaten
Ansichten
Trigger
Indizes
Gespeicherte Prozeduren
Erweiterte gespeicherte Prozeduren
Benutzer
Logins
Rollen
Fremdserver
Dienstprogramme 97

Überblick
Was sybmigrate nicht tut
Datenbankdaten
Benutzer
Alternative Benutzer
Rollen
Rollenattribute
Berechtigungen
Benutzernachrichten
Java-Klassen
JAR-Dateien
Standardwerte
Regeln
Benutzerdefinierte Typen
Tabellen
Indizes
Referenzielle Integritätsregeln
Ansichten
Gespeicherte Prozeduren
Trigger
Die folgenden Daten müssen manuell migriert werden:
Benutzerdefinierte Schwellenwerte
Abstrakte, in sysqueryplans gepflegte Plandefinitionen
Alle Systemdatenbanken außer der model-Datenbank
Alle erforderlichen Datenbankoptionen wie Cachebindung, Wiederherstellungsreihenfolge
und zugehörige Log-I/O-Größen wie von
sp_logiosize vorgegeben
98 Adaptive Server Enterprise

Kapitel 6 Migrations-Dienstprogramm
Proxy-Datenbanken
Engine-Gruppen
Engine-Bindungen
Ausführungsklassen
Cachekonfigurationen
Audit-Tabellen und Auditing-Konfiguration
Einstellungen für serverweite Zeilensperrenerweiterung
Zugriffsregeln
Hinweis Löschen Sie die Zugriffsregeln, bevor Sie mit
der Datenmigration beginnen. Diese könnten sonst dem
Datenbankeigentümer den Zugriff auf alle Zeilen in der Tabelle
verwehren, was eine vollständige Datenmigration verhindern würde.
Kompilierte Objekte mit verborgenem SQL-Text
Benutzerdefinierte Segmente
Integritätsregeln werden zwar migriert, wenn sie jedoch nach Name an
benutzerdefinierte Nachrichtennummern gebunden sind, müssen diese
Bindungen manuell neu erstellt werden
Einstellungen für Objekte wie ascinserts, maxwritedes, indextrips,
oamtrips, datatrips und sortbufsize, die mit dbcc tune erstellt wurden
Devicedefinitionen
SQLJ-Funktionen
Proxy-Tabellen für externe Dateien
Audit-Optionen und -Ereignisse
Serverkonfiguration
Dienstprogramme 99

Vorbereitungen
Vorbereitungen
Erforderliche Komponenten für sybmigrate
Voraussetzungen
Installation
Upgrade
sybmigrate erfordert JRE 1.3, jConnect für JDBC 5.5, ddlgen-
Komponenten und die Component Integration Services im alten Adaptive
Server.
Da sybmigrate mit einer Server-zu-Server-Verbindung arbeitet, müssen zwei
Adaptive Server ausgeführt werden. Stellen Sie sicher, dass Sie über die
erforderlichen Lizenzen verfügen.
Bevor Sie mit dem Migrationsprozess beginnen, erstellen Sie auf dem neuen
Adaptive Server Datenbanken, Devices und Segmente. Auch die Server- und
Cachekonfigurationen müssen bereits auf diesem Server installiert sein.
Extrahieren Sie mit ddlgen die entsprechenden Skripte aus dem alten Adaptive
Server und ändern Sie diese nach Bedarf, bevor Sie sie auf dem neuen
Adaptive Server anwenden. Weitere Hinweise dazu finden Sie unter ddlgen auf
Seite 195.
sybmigrate wird im Rahmen der Software Adaptive Server 12.5.0.1 installiert.
Hinweise zur Installation von Adaptive Server finden Sie im Installationshandbuch
für Ihre Plattform.
Bevor Sie sybmigrate ausführen, aktualisieren Sie den alten Adaptive Server
mindestens auf Version 12.5.0.1, und installieren Sie den neuen Adaptive
Server ebenso als Version 12.5.0.1 oder höher. Führen Sie alle für Upgrades
relevante Überprüfungen durch, bevor Sie mit der Datenmigration beginnen.
100 Adaptive Server Enterprise

Berechtigungen
Kapitel 6 Migrations-Dienstprogramm
Sie müssen den neuen Adaptive Server mit der neuen Seitengröße installieren.
Verwenden Sie entweder srvbuild oder sysconfig.exe, um den neuen Adaptive
Server einzurichten.
Die Hauptversion des alten und des neuen Adaptive Server muss identisch
sein. Das heißt, wenn Sie sybmigrate auf Adaptive Server 12.5.0.1 ausführen,
sollte die 12.5 identisch, der letzte Teil 0.1 kann jedoch höher sein.
Für die Setup-Phase des Migrationsprozesses wird das Systemadministrator-
Login benötigt. Für den restlichen Prozess muss das Login die Berechtigungen
„sa_role“ und „sso_role“ umfassen, um sybmigrate ausführen zu können.
Neue Login-Konten ändern
Wenn Sie eine plattformübergreifende Migration durchgeführt haben, sind die
Login-Kennwörter nicht kompatibel. Sie können jedoch während der Setup-
Phase des Migrationsprozesses mit sybmigrate das Kennwort für die Login-
Konten auf dem neuen Adaptive Server ändern.
Um das Kennwort für das neue Login-Konto zu ändern, muss sich der
Systemadministrator am neuen Adaptive Server anmelden und sp_password
für alle Login-Konten ausführen.
Hinweis Wenn Sie die Kennwörter für die Login-Konten des neuen Adaptive
Server nicht während der Setup-Phase des Migrationsprozesses ändern, muss
der Systemadministrator sie nach Beendigung des Migrationsprozesses auf
dem neuen Adaptive Server manuell ändern.
Neben der Änderung der Kennwörter ermöglicht sybmigrate auch das Sperren
und Entsperren der Konten auf Ihrem neuen Adaptive Server. Mithilfe dieser
Funktion kann der Systemadministrator einen Benutzer daran hindern, sich
während des Migrationsprozesses am neuen Adaptive Server anzumelden.
Dienstprogramme 101

Vorbereitungen
Plattformen
Umgebungsvariablen
sybmigrate lässt sich auf UNIX- und Windows NT-Plattformen ausführen.
Bei UNIX-Systemen befindet sich die ausführbare Datei im Verzeichnis
$SYBASE/$SYBASE_ASE/bin/sybmigrate.
Bei NT-Systemen befindet sich die ausführbare Datei im Verzeichnis
%SYBASE%\%SYBASE_ASE%\bin\sybmigrate.bat.
Die folgenden Umgebungsvariablen müssen korrekt eingerichtet sein.
Mit Ausnahme von SYBMIGRATE_MEMORY werden diese Umgebungsvariablen
in den Dateien SYBASE.csh oder SYBASE.sh definiert, die während
der Installation von Studio Installer angelegt werden.
SYBASE – Diese Variable definiert den Pfad des Sybase-
Versionsverzeichnisses.
SYBASE_ASE – Diese Umgebungsvariable definiert den Pfad des
Verzeichnisses, in das die Komponenten von Adaptive Server installiert
werden.
SYBASE_JRE – Diese Umgebungsvariable definiert den Pfad der Java-
Laufzeitumgebung. Dieser lautet im Versionsbereich von Adaptive Server
in der Regel $SYBASE/shared-1_0/jre1.2.2. Diese Umgebungsvariable
überschreibt JAVA_HOME.
SYBASE_JRE lautet standardmäßig $SYBASE/shared-1_0/jre1.2.2.
JAVA_HOME – Diese Umgebungsvariable definiert den Pfad der Java-
Laufzeitumgebung, falls SYBASE_JRE nicht eingerichtet ist.
Hinweis Damit sybmigrate richtig ausgeführt werden kann, ist entweder
SYBASE_JRE oder JAVA_HOME erforderlich.
SYBMIGRATE_MEMORY – Diese Umgebungsvariable gibt
die Speichermenge an, die beim Aufruf der Java Virtual Machine
(JVM) belegt wird. Die Umgebungsvariable sollte mit einer Zahl
eingerichtet werden, die die Speichermenge in Megabyte angibt.
Wenn SYBMIGRATE_MEMORY nicht eingerichtet ist, verwendet
JVM die Standardspeichereinstellung von 512 MByte.
102 Adaptive Server Enterprise

Migrationsprozess
Kapitel 6 Migrations-Dienstprogramm
Wenn sybmigrate viele Threads verwendet, oder gleichzeitig auf viele
Tabellen oder Indizes ausgeführt wird, sollten Sie die Speichermenge
für die JVM auf Clientseite erhöhen.
Mit sybmigrate steht ein Tool zur Verfügung, alle Objekte und Benutzerdaten,
die auf dem alten Adaptive Server existieren, zu migrieren. Es gibt jedoch auch
einige serverweite Daten, die migriert werden müssen, bevor Benutzerdaten
oder -objekte in die einzelnen Datenbanken migriert werden können.
Die Hierarchie der Objekte gibt die Reihenfolge vor, in der die Objekte neu
erstellt werden. In der Regel werden zuerst die serverweiten Objekte von der
master-Datenbank erstellt. Unabhängige Objekte wie Standardsprachen und -
zeichen werden zunächst in die Datenbanken migriert.
Überblick über den Migrationsprozess
Der Migrationsprozess umfasst die Konfiguration des alten Adaptive Server
und des neuen Adaptive Server, die Einrichtung der Migrationspfade und
Migrationsobjekte sowie die Validierung der migrierten Objekte.
Während der Setup-Sitzung werden die Migrationspfade von der
Quelldatenbank zu der Zieldatenbank definiert. Es werden ferner die
Repository-Datenbank und die Arbeitsdatenbanken eingerichtet, und es wird
festgelegt, ob die Serverdaten migriert werden sollen. Die Setup-Sitzung kann
nur von einem Benutzer mit dem Login „sa“ durchgeführt werden.
Während der Migrationssitzung werden die Objekte und Daten von der
Quelldatenbank in die Zieldatenbank migriert.
Bei der Validierungssitzung werden die migrierten Objekte überprüft.
Die Validierung stellt die Integrität der Daten und Objekte sicher,
die von der Quelldatenbank in die Zieldatenbank migriert wurden.
Dienstprogramme 103

Migrationsprozess
Vorbereitung der Migration
Sie müssen den alten Adaptive Server und den neuen Adaptive Server
gleichzeitig ausführen, wenn Sie Daten von einem zum anderen Server
migrieren möchten.
sybmigrate geht davon aus, dass der neue Adaptive Server vor der
Datenmigration installiert und konfiguriert wurde. Verwenden Sie srvbuild
oder syconfig, um einen neuen Adaptive Server mit der erforderlichen
logischen Seitengröße zu erstellen.
Berücksichtigen Sie vor der Migration folgende Punkte, wenn Sie den neuen
Adaptive Server erstellen und den ursprünglichen Adaptive Server
konfigurieren:
Wenn Sie den neuen Adaptive Server, in den Sie die Daten migrieren
wollen, mit einer anderen logischen Seitengröße erstellen, müssen Sie
die Größe der Datenbank auf dem neuen Server so einstellen, dass die
importierten Daten auch untergebracht werden können. Dies ist besonders
dann wichtig, wenn Sie Daten in einen Adaptive Server mit einer größeren
logischen Seitengröße migrieren.
Verwenden Sie den Bericht zur Speicherschätzung space_est, um
den auf Ihrer Zieldatenbank verfügbaren Speicherplatz zu ermitteln.
Weitere Hinweise zu space_est finden Sie unter „sybmigrate ausführen“
auf Seite 110.
Um den Migrationsprozess zu beschleunigen, können Sie mehrere
Sitzungen von sybmigrate auf dem gleichen Server ausführen. Es ist
jedoch nicht erlaubt, mehr als eine sybmigrate-Sitzung auf dem gleichen
Quell- und Zieldatenbankpfad auszuführen.
Sie müssen in der Zieldatenbank manuell Segmente erstellen, bevor Sie
Tabellen und Indizes migrieren.
Die Datenübertragungsrate für sybmigrate wird mit CIS bulk insert array
size konfiguriert. Die Standardeinstellung von CIS bulk insert array size
lautet 50 Zeilen. Das bedeutet, dass bis zu 50 Zeilen Daten von CIS in den
Puffer gestellt werden, bevor sie an den neuen Adaptive Server übertragen
werden.
Um den Datendurchsatz zu erhöhen, stellen Sie CIS bulk insert array size
auf einen höheren Wert ein.
104 Adaptive Server Enterprise

Kapitel 6 Migrations-Dienstprogramm
Beachten Sie jedoch, dass bei Erhöhung von CIS bulk insert array size
der alte Adaptive Server für lokale Puffer Speicherressourcen aus
dem Betriebssystem nutzt. Dies kann zu einer übermäßig hohen
Beanspruchung des Betriebssystemspeichers führen.
Sybase empfiehlt, dass Sie den Standardwert von CIS bulk insert array size
nur moderat heraufsetzen sollten. Weitere Informationen finden Sie in der
CIS-Dokumentation.
CIS bulk insert array size hat keine Auswirkungen auf den Datendurchsatz,
wenn die zu übertragende Tabelle eine Spalte text, image oder Java ADT
enthält. Enthält eine Tabelle eine Spalte text, image oder Java ADT, werden
während der Migration dieser Tabelle alle Daten Zeile für Zeile migriert.
Es findet auch keine Array-Pufferung statt.
Wenn die Datenmigration mithilfe von CIS bulk transfer erfolgt, kann sich
der Wert des Konfigurationsparameters CIS packet size auf dem alten
Adaptive Server auf die Schnelligkeit der Datenübertragung auswirken.
Der empfohlene Wert für CIS packet size auf dem alten Adaptive Server
ist die logische Seitengröße (2 KByte, 4 KByte, 8 KByte oder 16 KByte)
des neuen Adaptive Server.
max packet size allowed auf dem neuen Adaptive Server sollte mit dem
Wert von CIS packet size auf dem alten Adaptive Server übereinstimmen.
Weitere Hinweise zu max packet size allowed finden Sie in der
Dokumentation Systemadministration für Adaptive Server Enterprise.
Um die Performance von sybmigrate zu maximieren, setzen Sie den
Konfigurationsparameter additional network memory auf dem neuen
Adaptive Server auf einen höheren Wert.
Weitere Hinweise zu additional network memory finden Sie in der
Dokumentation Systemadministration für Adaptive Server Enterprise.
Alle zuvor genannten Punkte betreffen den Konfigurationsparameter
max memory. Bevor Sie Ihre Daten migrieren, stellen Sie sicher,
dass max memory auf einen ausreichend hohen Wert gesetzt ist.
Es gibt drei Arten von Daten, die migriert werden: Serverdaten,
Datenbankdaten und Benutzerobjekte. Um die Metadaten (Server- und
Datenbankdaten) zu migrieren, muss der neue Adaptive Server frisch
installiert sein, damit die migrierten Metadaten nicht mit möglichen
Restdaten aus vorheriger Nutzung in Konflikt treten.
Dienstprogramme 105

Migrationsprozess
Wenn Sie nur Benutzerobjekte migrieren, können Sie auch einen zuvor
bereits genutzten Adaptive Server verwenden. Bei Benutzerdaten ist
jedoch zu beachten, dass die Zieltabellen leer sein müssen.
Bevor Sie Daten migrieren, erstellen Sie die Datenbanken, in die
Sie die Daten auf dem neuen Adaptive Server migrieren möchten.
Die Datenbanken sollten jeweils den gleichen Namen wie auf dem
alten Adaptive Server haben.
Um eine Umwandlung der Zeichensätze zu ermöglichen, die über keine
interne Adaptive Server-Konvertierungsroutine verfügen, konfigurieren
Sie den neuen Adaptive Server mit enable unicode conversions gleich 1.
Ermitteln Sie die Größe der benannten Caches und Pufferpools auf dem
neuen Adaptive Server. sybmigrate migriert keine Cachekonfigurationen.
Sie können die von ddlgen erzeugten Informationen auf den neuen
Adaptive Server anwenden. Oder Sie konfigurieren aufgrund der größeren
Seitengröße mehr Speicherplatz.
sybmigrate migriert jedoch Cachebindungen, weshalb im Migrationslog
Warnmeldungen ausgegeben werden, wenn der erforderliche Cache im
neuen Adaptive Server nicht existiert.
Bevor Sie sybmigrate ausführen, müssen Sie die gewünschten Sprachen
auf dem neuen Adaptive Server installieren. Die Standardsprache des alten
und des neuen Adaptive Server muss identisch sein.
Wenn Benutzernachrichten auf dem alten Adaptive Server vorhanden
sind, die nicht auf dem neuen Adaptive Server installiert sind, bricht
sybmigrate die Migration der Nachrichten ab und gibt einen Fehler aus.
Wenn Sie Java-Spalten migrieren, müssen Sie Java vor der Migration auf
dem alten und dem neuen Adaptive Server aktivieren. Geben Sie folgende
Zeichenfolge ein:
sp_configure 'enable java', 1
Nachdem Sie Ihren alten Adaptive Server auf Version 12.5.0.1 oder höher
aktualisiert haben, starten Sie ihn neu, bevor Sie mit der Migration
beginnen.
Für die Migration müssen der alte und neue Adaptive Server
unterschiedliche lokale Servernamen haben. Richten Sie den lokalen
Servernamen ein, und starten Sie die Server neu, damit die Änderung
wirksam wird.
106 Adaptive Server Enterprise

Kapitel 6 Migrations-Dienstprogramm
Wenn aus mehreren Bytes bestehende Zeichensätze auf dem neuen
Adaptive Server konfiguriert sind, nachdem der Migrationsprozess
gestartet wurde, müssen Sie manuell dbcc fix_text auf den
Systemkatalogen sysattributes und sysxtypes ausführen, damit die
text-Spalten in diesen Katalogen mit den Mehrbyte-Zeichensätzen
konsistent sind.
Sybase empfiehlt, zunächst den Zeichensatz des neuen Servers zu
konfigurieren und dann den Migrationsprozess zu starten.
Konfiguration und Optimierung für eine bessere Performance
Je nach Serverressourcen können Sie sybmigrate und Adaptive Server
so konfigurieren, dass für eine optimale Performance gesorgt wird.
Hinweise zur Konfiguration von sybmigrate
Zur Migration von Tabellen und erneuten Erstellung von Indizes werden „copy
threads“ und „create index threads“ verwendet. Wenn Sie sybmigrate im Setup-
Modus konfigurieren, können die Werte von COPY_THREADS und
INDEX_THREADS den Kopier- und Migriervorgang von sybmigrate
beschleunigen.
Die Anzahl der Copy Threads steuert die Anzahl der Tabellen, für die
gleichzeitig eine Datenmigration durchgeführt wird. Jeder Tabelle wird
ein Copy Thread zugeordnet. Wenn der Thread eine Aufgabe erfolgreich
abgeschlossen hat, fährt er mit der nächsten fort. Je nach Größe Ihrer
Datenbank und den Ihrem Adaptive Server zur Verfügung stehenden
Ressourcen können Sie die Anzahl der Copy Threads erhöhen, die im
Migrationsprozess verwendet werden, um die Performance zu verbessern.
Hinweis Wenn Sie viele Objekte gleichzeitig migrieren, prüfen Sie anhand des
Werts von SYBMIGRATE_MEMORY, ob sybmigrate genügend Speicher
zugewiesen wurde.
Dienstprogramme 107

Migrationsprozess
Index Threads steuern die Anzahl von Threads, die für die Neuerstellung von
Indizes für die Tabellen des neuen Adaptive Server verwendet werden. Zur
Neuerstellung von Indizes wird ein Thread pro Tabelle verwendet. Wenn die
Indizes für eine Tabelle neu erstellt wurden, fährt der Thread mit der nächsten
migrierten Tabelle fort. Alle Threads ohne Aufgabe werden beendet.
Die Anzahl der Create Index Threads sollte deutlich geringer sein als
die Anzahl der Copy Threads.
Wenn Sie INDEX_THREADS auf eine hohe Zahl einstellen, sollten Sie darauf
achten, dass auch der neue Adaptive Server mit einer hohen Anzahl von
Sortierpuffern ausgestattet ist. Da die Nutzung von Index Threads in der
Zieldatenbank Speicherplatz verbraucht, sollten Sie sicherstellen, dass für
die Zieldatenbank ausreichend Speicherplatz für die angegebene Anzahl von
Index Threads eingerichtet ist. Sie müssen außerdem die Zieldatenbank mit
zusätzlichem Speicherplatz konfigurieren, wenn Sie Clustered-Indizes neu
erstellen werden.
Hinweise zur Konfiguration von Adaptive Server
Es gibt mehrere Konfigurationsparameter sowohl auf dem alten als auch auf
dem neuen Adaptive Server, die die Performance des Migrationsprozesses
beeinflussen.
Auf dem alten Adaptive Server:
cis packet size – sollte identisch sein mit dem Wert von max page size auf
dem neuen Adaptive Server.
number of user connections – sollte hoch genug sein, um die gleichzeitige
Migration mehrerer Tabellen entsprechend den Werten von
COPY_THREADS und INDEX_THREADS zu ermöglichen.
max parallel degree – sollte auf einen Wert gesetzt werden, der
höher als die höchste Anzahl von Partitionen in einer Tabelle ist.
Die Datenmigration erfolgt parallel. Wenn der Wert von max parallel
degree nicht hoch genug eingestellt ist, um die partitionierten Tabellen
aufzunehmen, werden die Tabellen nicht migriert.
number of worker processes – Die Datenmigration für partitionierte
Tabellen erfordert einen Worker-Thread pro Partition. Wenn also t
partitionierte Tabellen mit p Partitionen gleichzeitig migriert werden,
müssen Sie insgesamt t x p Worker-Threads auf dem alten Adaptive
Server einrichten.
108 Adaptive Server Enterprise

Kapitel 6 Migrations-Dienstprogramm
cis bulk insert batch size – legt die Anzahl der Zeilen fest, nach denen
die Datenübertragung festgeschrieben wird. Standardwert ist 0. Die
Verwendung des Standardwertes ist zwar die sicherste Methode, bei
der Datenmigration die Integrität der Daten zu gewährleisten, dies kann
jedoch zu einer großen Anzahl von Seiten- und Zeilensperren auf dem
alten Adaptive Server führen. Um die Anzahl der Sperren zu reduzieren,
erhöhen Sie also diesen Wert.
Wenn Sie den Wert von cis bulk insert batch size erhöhen, wird nur ein Teil
der Daten migriert, wenn es beim Prozess zu einem Fehler kommen sollte.
Kürzen Sie in diesem Fall die Zieltabelle manuell, und führen Sie
sybmigrate erneut aus.
cis bulk insert array size – legt die Anzahl der Zeilen fest, die gleichzeitig
zusammen übertragen werden. Der Standardwert ist 50 Zeilen pro Batch.
Erhöhen Sie den Wert, um die Datenmigration zu beschleunigen.
Wenn die Tabelle text- oder image-Spalten enthält, werden die Daten Zeile
für Zeile übertragen, und zwar unabhängig von dem für cis bulk insert array
size eingestellten Wert.
Die folgenden Konfigurationsparameter auf dem neuen Adaptive Server
beeinflussen die Performance von sybmigrate:
max network packet size – sollte auf einen Wert gesetzt werden,
der mindestens genauso hoch ist wie der von max page size.
number of user connections – sollte hoch genug sein, um die gleichzeitige
Migration mehrerer Tabellen und partitionierter Tabellen zu ermöglichen.
Für die parallele Migration partitionierter Tabellen sind auf dem alten
Adaptive Server Worker-Prozesse und auf dem neuen Adaptive Server
Benutzerverbindungen erforderlich. Wenn Sie partitionierte Tabelle
migrieren, setzen Sie number of user connections auf dem neuen Adaptive
Server auf die gleichen Werte wie number of worker processes auf dem
alten Adaptive Server.
number of sort buffers – der Standardwert von 500 ist für die Migration
ausreichend. Sie können diesen Wert erhöhen, wenn sybmigrate die
Indizes neu aufbaut, insbesondere dann, wenn Sie Indizes partitionierter
Tabellen migrieren.
Dienstprogramme 109

Migrationsprozess
Fehlervermeidung
Vor dem Starten der Datenmigration prüft sybmigrate, ob die folgenden
Fehlerbedingungen zutreffen. Trifft eine dieser Fehlerbedingungen zu,
wird der Migrationsvorgang abgebrochen.
Eine Zieltabelle mit vorhandenen Daten: Jeglicher Versuch, Daten in eine
Tabelle zu migrieren, die bereits Daten enthält, führt zu einem Abbruch
von sybmigrate.
Eine Zieltabelle mit Indizes: Sollten in einer Zieltabelle Indizes vorhanden
sein, wird sybmigrate in einem langsamen bcp (Bulk Copy Utility;
Massenexport/-import der Daten) ausgeführt. Löschen Sie vor der
Datenmigration alle Indizes manuell.
Nicht übereinstimmende Partitionszahlen in den Quell- und Zieltabellen:
Falls die Anzahl der Partitionen in der Quell- und Zieltabelle nicht
übereinstimmt, schlägt die Datenmigration fehl. sybmigrate dient lediglich
der Datenmigration, nicht jedoch der Neuverteilung der Daten auf
Partitionen.
Automatische Auswahl abhängiger Objekte für die Migration
sybmigrate ausführen
Wenn Sie die Funktion zur automatischen Auswahl abhängiger Objekte
nutzen, wählt sybmigrate selbst abhängige Objekte für die Migration aus.
Diese Funktion der automatischen Auswahl überprüft, ob es abhängige
Objekte gibt, und migriert diese dann automatisch in den neuen Adaptive
Server. Sybase empfiehlt, diese Funktion zu nutzen, damit die Migration
erfolgreich abgeschlossen werden kann.
Achtung! sybmigrate geht davon aus, dass auf beiden Servern (alter und neuer
Adaptive Server) während der Migration keine Aktivitäten stattfinden. Werden
während des Migrationsprozesses (Setup, Migration, Validierung) Objekte
erstellt, geändert oder gelöscht, kann Sybase nicht für die Integrität der
Migration garantieren.
110 Adaptive Server Enterprise

Kapitel 6 Migrations-Dienstprogramm
Unabhängig davon, ob Sie den GUI- oder Ressourcedatei-Modus von
sybmigrate ausführen, starten Sie diesen Befehl mit den folgenden
Befehlszeilenargumenten:
Wobei:
sybmigrate [-v ] [-h ] [-f ]
[-D 1 | 2 | 3 | 4 ]
[-I Interfaces-Datei ]
[-r Eingabe_Ressourcedatei]
[-m setup | migrate | validate | report ]
[-rn status | space_est | repl | diff | password ]
[-l Logdatei ]
[-t Ausgabevorlage_Ressourcedatei ]
[-J Client_Zeichensatz ]
[-z Sprache ]
[-T Trace_Flags ]
[-Tase Trace-Flags ]
[-f ]
-v gibt die Versionszeichenfolge aus und wird dann beendet.
-h gibt die Hilfeinformationen und Syntaxverwendung aus und wird dann
beendet.
-f überschreibt die Sperrsitzung.
Wenn sybmigrate eine Sitzung unaufgefordert beendet hat, überschreiben
Sie mit -f die erstellte Datenbankbindung auf dem alten und neuen Server,
sodass nur eine Sitzung von sybmigrate auf einem Quell- und
Zieldatenbankpfad ausgeführt werden kann.
-D – legt das Debug-Level für sybmigrate fest. Der Standardwert des
Debug-Level lautet 2.
-I gibt eine interfaces-Datei an, die nach Servernamen durchsucht werden
soll. Wenn kein Ort für die interfaces-Datei angegeben wurde, wird unter
Windows $SYBASE/interfaces und unter UNIX %SYBASE%\ini\sql.ini
verwendet.
Hinweis Sie können sybmigrate überschreiben und die interfaces-Datei
verwenden, indem Sie das Argument -I übergeben, falls der LDAP-
Eintrag in $SYBASE/$SYBASE_OCS/config/libtcl.cfg (Unix) oder in
%SYBASE%\%SYBASE_OCS%\ini\libtcl.cfg (NT) definiert ist.
Dienstprogramme 111

Migrationsprozess
-r gibt an, dass der Ressourcedatei-Modus beim Migrationsprozess
verwendet werden soll. Wenn die Eingabe-Ressourcedatei über den
Parameter -r nicht angegeben wird, wird sybmigrate im GUI-Modus
ausgeführt.
Wenn Sie den Parameter -r verwenden, müssen Sie auch das Argument -m
übergeben, um die Art der auszuführenden Aktion anzugeben: setup,
migrate, validate oder report. Sie können den ganzen Migrationsprozess im
Ressourcedatei-Modus durchführen, Sie können aber auch nur Teile des
Vorgangs in diesem Modus ausführen.
-m gibt die Arten der Aktionen an, die ausgeführt werden sollen:
setup: Einrichtung der Repository- und Arbeitsdatenbank und
Migration der serverweiten Daten.
migrate: Durchführung der Migration der Daten und Objekte.
validate: Validierung der migrierten Objekte.
report: Ausführung eines der fünf Berichte. Die Berichte können
im GUI- oder Ressourcedatei-Modus ausgeführt werden.
Die verfügbaren Berichte sind:
status – Der Bericht über den Migrationsstatus der Objekte
enthält Informationen zu den Objekten, die bereits migriert
wurden. Um diesen Bericht auszuführen, geben Sie folgenden
Befehl ein:
sybmigrate -r Ressource-Datei -m report -rn
status
space_est – Mit dem Bericht zur Schätzung des Speicherplatzes
auf der Zieldatenbank können Sie überprüfen, ob der
Zieldatenbank ausreichend Ressourcen zugewiesen wurden.
Um den Bericht space_est auszuführen, geben Sie im
Ressourcedatei-Modus den folgenden Befehl ein:
sybmigrate -r Ressource-Datei -m report -rn
space_est
repl – Mit dem Replikationsbericht können Sie alle explizit
replizierten Objekte anzeigen, die migriert wurden, die Art des
Replikationssystems bestimmen und SQL-Befehle erzeugen,
die von den Benutzern auf dem neuen Adaptive Server und dem
Replication Server ausgeführt werden können. Um den Bericht
repl auszuführen, geben Sie folgende Befehlszeile ein:
sybmigrate -r Ressource-Datei -m report -rn
repl
112 Adaptive Server Enterprise

Kapitel 6 Migrations-Dienstprogramm
diff – Dieser Bericht überprüft die Objekte zwischen Quell- und
Zieldatenbank. Die Benutzer können diesen Bericht auf einzelne
Objekte oder die ganze Datenbank ausführen, ausgenommen
Server- und Datenbankinformationen bzw. Metadaten.
Sie können den Bericht diff zu jeder Zeit ausführen. Sie müssen
keine Setup-Sitzung starten, um den Bericht diff auszuführen.
Der Name der Quell- und Zieldatenbank muss nicht identisch
sein, wenn Sie diff ausführen.
Der Bericht diff liefert folgende Informationen zu den folgenden
Objekttypen:
Serverinformationen – Vergleich der Systemkatalog-
Zeilenzahl der Master-Datenbank zwischen altem und
neuem Adaptive Server. Diese Aufgabe ähnelt der
Validierungssitzung.
Datenbankinformationen – Vergleich der Systemkatalog-
Zeilenzahl der Benutzerdatenbank zwischen altem und
neuem Adaptive Server. Diese Aufgabe ähnelt der
Validierungssitzung.
DDL-Objekte – Der Bericht gibt an, ob die Objekte auf
dem alten oder neuen Adaptive Server existieren. Wenn
die Objekte in beiden Datenbanken existieren, wird das
betreffende Objekt im Bericht nicht aufgeführt.
Benutzertabellendaten – Vergleich der Zeilenzahl der
Benutzertabellen zwischen altem und neuem Adaptive
Server. Wenn die Tabelle nur in den Quell- oder
Zieldatenbanken existiert, wird table im Bericht nicht
aufgeführt.
password – Dieser Befehl erstellt eine Datei für geänderte
Kennwörter. Dieser Bericht kann nur von einem Systemadministrator
ausgeführt werden.
-rn gibt an, welche Art von Bericht erzeugt werden soll. Wenn für -rn nichts
angegeben wurde, werden alle fünf Berichte generiert.
-l gibt eine benutzerdefinierte Logdatei an, in der die Ausgabe des Migrationsprozesses
gespeichert wird. Wenn für -l keine Angaben gemacht
wurden, werden die Logs unter $SYBASE/$SYBASE_ASE/init/logs oder
im Arbeitsverzeichnis abgelegt.
Dienstprogramme 113

Migrationsprozess
GUI-Modus
Setup
-t weist sybmigrate an, eine Ausgabevorlage der Ressourcedatei zu
generieren, die für folgende Migrationen im Ressourcedatei-Modus
genutzt werden kann.
-t erfordert das Ausführen von sybmigrate mit dem Argument -r unter
Angabe der Login-Daten. Dieses Argument setzt ferner voraus, dass mit -
m die Art der zu generierenden Ressourcedatei angegeben wird.
Hinweis Sie können -t nur im Ressourcedatei-Modus verwenden.
-J gibt den Zeichensatz an, der für die Adaptive Server-Verbindung
genutzt werden soll.
-z gibt die Sprache an, die für die Adaptive Server-Verbindung verwendet
werden soll.
-T setzt die Trace-Flags für die Befehlszeile.
-Tase wird verwendet, um Adaptive Server-Trace-Flags (Aktivierung mit
dbcc traceon) für alle Adaptive Server-Verbindungen auszuführen, die
von sybmigrate geöffnet wurden. Die Trace-Flags sollten in einer durch
Komma getrennte Liste angegeben werden.
Sie können entweder den GUI- oder Ressourcedatei-Modus für den
Migrationsprozess nutzen. Sie haben auch die Möglichkeit, Teile des
Migrationsprozesses im GUI-Modus und andere Teile im Ressourcedatei-
Modus auszuführen.
Wenn Sie sybmigrate im GUI-Modus ausführen, müssen Sie sich bei der
Migration an die folgenden drei Phasen halten: Setup, Migration und
Validierung.
Bevor Sie Daten migrieren, geben Sie den alten und den neuen Adaptive
Server an, und registrieren Sie die Pfade zwischen den enthaltenen Quell- und
Zieldatenbanken. Starten Sie hierzu sybmigrate mit der Befehlszeilenoption -m
setup oder durch Auswahl von „Setup source databases for migration“,
wenn Sie dazu eine Aufforderung im Fenster „Session Type“ erhalten.
114 Adaptive Server Enterprise

Kapitel 6 Migrations-Dienstprogramm
❖ Angabe des alten und neuen Adaptive Servers und Registrierung der
Pfade zwischen den Quell- und Zieldatenbanken
1 Im Fenster „Connect to ASE“ können Sie den alten und neuen Adaptive
Server für Ihren Migrationsprozess angeben.
Sie können die Server aus dem Dropdown-Menü in den jeweiligen
Feldern „Server“ auswählen. In diesen Dropdown-Menüs sind
die Adaptive Server enthalten, die sich in der standardmäßig
eingerichteten interfaces-Datei befinden ($SYBASE/interfaces unter
UNIX oder %SYBASE%\ini\sql.ini unter NT) oder in der interfaces-
Datei, die Sie mit dem Befehlszeilenargument -I angegeben haben.
Wenn Sie nicht mit der interfaces-Datei arbeiten, können Sie das
Befehlszeilenargument -I nicht verwenden, sondern müssen den
alten und neuen Adaptive Server im Format host:port angeben.
Während der Setup-Phase müssen Sie bei beiden Servern als
Systemadministrator angemeldet sein. Tragen Sie „sa“ in das
Loginfeld ein, geben Sie Ihr Kennwort ein, und wählen Sie
„Connect“.
Hinweis Sie können nur eine Sitzung von sybmigrate zurzeit ausführen.
Falls also ein anderer Benutzer sybmigrate auf dem gleichen Quell- und
Zielserver ausführt, erscheint die Fehlermeldung „Setup session lock:
Either previous setup exit abnormal or there is another setup session
running. Do you want to override?“. Sie können die Sitzungssperre
überschreiben, da es sein kann, dass die vorherige Sitzung abgestürzt
ist oder vorzeitig abgebrochen wurde.
Bevor Sie mit dem Setup- und Migrationsprozess fortfahren, stellen Sie
also sicher, dass keine anderen Benutzer sybmigrate ausführen. Wenn mehr
als ein Benutzer sybmigrate gleichzeitig ausführt, kann Sybare keine
Datenintegrität gewährleisten.
2 Im Fenster „Session Type“ müssen Sie die Art der Aktion angeben,
die Sie durchführen möchten. Sie haben folgende Optionen:
Setup source databases for migration
Migrate database objects and data
Dienstprogramme 115

Migrationsprozess
Validate the migrated objects and data
Reports: Wenn Sie „Reports“ wählen, wird ein Fenster mit den
Berichtsarten angezeigt. Es stehen folgende Berichte zur Auswahl:
status, space_est, repl, diff oder password. Wenn Sie den Bericht zur
Speicherermittlung oder den Replikationsbericht auswählen, werden
Sie im Fenster „Report Paths“ aufgefordert, die Datenbankpfade
anzugeben, auf denen die Berichte ausgeführt werden sollen.
Die Berichte zu Kennwort, Status und Replikationen sind deaktiviert,
wenn die Setup-Sitzung für den alten und neuen Adaptive Server
noch nicht vollständig abgeschlossen wurde.
Wenn Sie sybmigrate mit der Option -m unter Angabe von setup, migrate,
validate oder reports gestartet haben, wird dieses Fenster nicht angezeigt.
3 Im Fenster „Setup Paths“ wählen Sie nun die Quell- und Zieldatenbanken
auf Ihrem alten und neuen Adaptive Server aus, damit sybmigrate weiß,
wo es die Daten aus dem Quellserver im Zielserver ablegen soll.
Hinweis Die Namen der Quell- und Zieldatenbanken müssen
identisch sein.
In der Dropdown-Liste „Source Database“ sind die Datenbanken Ihres
alten Adaptive Server aufgeführt.
In der Dropdown-Liste „Target Database“ sind die Datenbanken des neuen
Adaptive Server aufgelistet. Sie müssen die Datenbanken auf dem neuen
Adaptive Server vor dem Migrationsprozess eingerichtet haben, um
sybmigrate ausführen zu können.
Mit sybmigrate können Sie die Werte von Copy Thread, Create Index
Thread und Work Thread während der Setup-, Migrations- oder
Validierungssitzung einstellen. Der Wert, den Sie diesen Eigenschaften
beim Setup zuweisen, wird zum Standardwert. Sie können diesen Wert
in der Migrations- bzw. Validierungssitzung jedoch vorübergehend
überschreiben.
Das Feld „Copy Thread“ gibt sybmigrate vor, wie viele Threads bei der
Datenmigration verwendet werden sollen. Bei der Anzahl der Threads gibt
es keine Obergrenze, das heißt, je nach Datenmenge, die migriert werden
soll, und je nach verfügbaren Serverressourcen können Sie die Anzahl der
Copy Threads erhöhen, um die Performance zu maximieren.
116 Adaptive Server Enterprise

Kapitel 6 Migrations-Dienstprogramm
Das Feld „Create Copy Thread“ gibt sybmigrate vor, wie viele Index
Threads bei der Datenmigration verwendet werden sollen. Bei der Anzahl
der Create Index Threads gibt es ebenfalls keine Obergrenze; Sie können
also auch diese Zahl erhöhen, um die Performance zu maximieren.
Hinweis Die Werte von Copy Thread und Create Index Thread sind
nur auf die verfügbaren Ressourcen von Adaptive Server begrenzt.
Geben Sie die Anzahl der Copy Threads und Create Index Threads für
jeden Datenbankpfad an, den Sie erstellen. Wenn auf dem gleichen Server
große und kleine Datenbanken vorhanden sind, können Sie die Anzahl der
Threads entsprechend reduzieren oder erhöhen.
Nachdem Sie eine Quell- und Zieldatenbank ausgewählt und die Anzahl
der Copy Threads und Create Index Threads angegeben haben, klicken Sie
auf „Add Path“. Ihre Angaben werden unter „Migrate Paths“ angezeigt.
Sie können beliebig viele Pfade erstellen. Wenn Sie später zusätzliche
Pfade benötigen, können Sie neue Pfade durch erneutes Ausführen von
sybmigrate im Setup-Modus hinzufügen. Wenn Sie sybmigrate mehr als
einmal im Setup-Modus ausführen, werden noch Ihre ursprünglichen
Angaben angezeigt, und alle Änderungen werden diesen Angaben
hinzugefügt.
Um die Anzahl der Copy Threads oder Create Index Threads zu ändern,
nachdem Sie den Pfad zu sybmigrate hinzugefügt haben, wählen Sie die
Spalte aus, die Sie ändern möchten, und geben Sie den neuen Wert ein.
Um die Quell- oder Zieldatenbank zu ändern, wählen Sie die ganze Zeile
aus, und löschen Sie diese. Wenn Sie auf die Schaltfläche „Reset“ unten
im Fenster klicken, werden alle von Ihnen eingegebenen Daten gelöscht,
und Sie kehren zur ursprünglichen Version des Fensters „Setup Paths“
zurück.
Wenn Sie mit der Erstellung der Pfade fertig sind, klicken Sie auf die
Schaltfläche „Next...“.
Dienstprogramme 117

Migrationsprozess
Hinweis Der Benutzer steuert die Anzahl der Threads, die für die parallele
Übertragung von Tabellen genutzt werden. Jede Tabelle, die gleichzeitig
übertragen wird, erfordert eine Server-zu-Server-CIS-Verbindung.
Berücksichtigen Sie alle Aspekte dieser Anforderung, wenn Sie die
Kapazität Ihres Systems bestimmen.
In einem einfachen Szenario sind die Tabellen, die Sie migrieren, nicht
partitioniert. Wenn Sie nicht partitionierte Tabellen migrieren, wird eine
einzige Server-zu-Server-Verbindung hergestellt. Diese Verbindung
belegt eine user connection auf dem alten Adaptive Server und eine user
connection auf dem neuen Adaptive Server.
Wenn die Datenmigration für n-Weg-Partitionstabellen durchgeführt wird,
erfolgt die Datenübertragung mit einem Parallelitätsgrad von n-Weg. Dies
erfordert n worker processes auf dem alten Adaptive Server und zwei nuser
connections auf dem neuen Adaptive Server.
Wenn Sie beispielsweise 10 n-Weg-Partitionstabellen haben und vier
Threads in sybmigrate verwenden möchten, konfigurieren Sie den alten
Adaptive Server mit mindestens vier worker processes und acht user
connections. Konfigurieren Sie den neuen Adaptive Server mit mindestens
acht user connections.
4 Im Fenster „Setup Devices“ müssen Sie die Größe der Repository-
Datenbank und das Device angeben, auf dem Sie sybmigrate ausführen
möchten.
Im Feld „Create Database Size“ wird ein Standardwert in Megabyte
vorgeschlagen. Dieser Standardwert basiert auf der Anzahl der Copy
Threads und Create Index Threads, die Sie im vorhergehenden Fenster
angegeben haben. Der Standardwert entspricht dem erforderlichen
Mindestwert. Wenn Sie diesen Wert ändern möchten, können Sie
ihn also nur erhöhen.
Im Feld „Use Device“ können Sie das Device angeben, auf dem Sie
die Arbeitsdatenbank erstellen möchten. Sie können das standardmäßig
eingerichtete Device übernehmen oder ein anderes Device angeben.
118 Adaptive Server Enterprise

Kapitel 6 Migrations-Dienstprogramm
Im Feld „Repository Database Size“ können Sie zusätzlichen
Speicherplatz für die Repository-Datenbank angeben. Wenn Sie
sybmigrate zum ersten Mal im Setup-Modus ausführen, wird die
Größe der Repository-Datenbank abhängig von den bereits eingegebenen
Informationen und dem Inhalt der Quelldatenbank in Megabyte
angegeben. Wenn Sie sybmigrate erneut im Setup-Modus ausführen, gibt
die Zahl, die Sie im Feld „Repository Database Size“ eingeben, die Zahl
in Megabyte an, um die Sie die Repository-Datenbank erhöhen möchten.
Wählen Sie das logische Device aus der Dropdown-Liste „Logical
Device“. Das logische Device wird verwendet, um die Repository-
Datenbank zu erstellen und zu ändern. Wählen Sie ein Device mit viel
Speicher für die geschätzte Größe Ihrer Repository-Datenbank.
Geben Sie im Feld „Migrate Server Data“ an, ob Sie Serverdaten
migrieren möchten oder nicht. Sie können „Yes“, „No“ oder „Undecided“
wählen.
Wenn Sie „Yes“ wählen, werden die Serverdaten am Ende der Setup-
Phase migriert. Wenn Sie später sybmigrate in der Setup-Phase ausführen,
können Sie die Serverdaten nicht mehr migrieren, da sie bereits migriert
wurden.
Wenn Sie „Yes“ wählen, um die Serverdaten zu migrieren, wird die
Schaltfläche „Option...“ aktiviert. Wenn Sie auf diese Schaltfläche
klicken, wird das Dialogfeld „Login Account“ angezeigt.
Im Dialogfeld „Login Account Options“ sperren oder entsperren Sie
Konten oder ändern das Kennwort des neuen Adaptive Server.
Wenn Sie „No“ wählen, werden die Serverdaten nicht migriert. Sie können
aber jederzeit hierher zurückkehren und die Migration der Serverdaten
starten, vorausgesetzt, die Migration der Datenbank hat noch nicht
begonnen.
Wenn Sie „Undecided“ wählen, können Sie jederzeit zu diesem
Fenster zurückkehren und „Yes“ oder „No“ wählen. Wenn Sie jedoch
„Undecided“ wählen, können Sie nicht mit der Migrationsphase beginnen.
„Undecided“ ist eine sehr nützliche Option, wenn Sie zwar alle
Daten für den Migrationsprozess einrichten möchten, die eigentliche
Datenmigration jedoch erst zu einem späteren Zeitpunkt geplant ist.
Wenn Sie mit der Einrichtung der Devices fertig sind, klicken Sie auf
„Setup“.
Dienstprogramme 119

Migrationsprozess
Migration
5 Im Fenster „Setup Progress“ wird der Fortschritt der Setup-Phase
angezeigt.
Zu diesem Zeitpunkt erstellt sybmigrate die Repository-Datenbank,
installiert das Datenbankschema, erstellt eine Arbeitsdatenbank für jeden
angegebenen Pfad und migriert die Serverdaten (je nach ausgewählter
Option). Diese Vorgänge erfolgen in genau dieser Reihenfolge. Wenn Sie
sybmigrate ein weiteres Mal im Setup-Modus ausführen, werden für die
Datenmigration neue Pfade erstellt. Wenn Sie keine neuen Pfade erstellen
möchten, müssen Sie sybmigrate nicht mehr als einmal im Setup-Modus
ausführen.
Um den Fortschritt im Log anzuzeigen, klicken Sie auf „Show Log“. Der
Setup-Vorgang ist abgeschlossen, wenn im Fenster „Current Task“ DONE
und im Log SETUP_COMPLETE angezeigt wird. Klicken Sie auf
„Close“, um das Log und das Fenster „Setup Progress“ zu schließen.
6 Sie kehren zum Fenster „Connect to ASE“ zurück. Wählen Sie
„Quit“, um sybmigrate zu beenden. Um die Migrationsphase des
Datenmigrationsprozesses zu starten, beenden Sie sybmigrate,
und starten Sie sybmigrate im Migrationsmodus.
Nachdem Sie die Setup-Phase abgeschlossen haben, können Sie mit der
Migration beginnen. Starten Sie sybmigrate mit der Befehlszeilenoption-m
migrate erneut, oder wählen Sie die zu migrierenden Datenbankobjekte und
Datenoptionen im GUI-Fenster aus.
1 Wählen Sie im Fenster „Connect to ASE“ den alten und neuen Adaptive
Server aus, zu dem Sie die Verbindung herstellen möchten.
2 Wenn Sie sybmigrate nicht mit dem Befehlszeilenargument -m migrate
gestartet haben, wählen Sie die Art der Sitzung im Fenster „Session Type“.
3 Im Fenster „Object Selection“ können Sie angeben, welche Arten von
Datenbankdaten Sie migrieren möchten.
Im Fenster „Object Selection“ können Sie die Parameter für den Copy
Thread, Create Index Thread und Work Thread von der Menüleiste
„Setting“ einstellen.
Im Fenster „Object Selection“ können Sie außerdem veranlassen, dass
sybmigrate abhängige Objekte automatisch auswählt, indem Sie mit der
rechten Maustaste auf den entsprechenden Knoten im Objektbaum
klicken.
120 Adaptive Server Enterprise

Kapitel 6 Migrations-Dienstprogramm
Wenn Sie den Ordner mit den Datenbankdaten erweitern, sehen Sie eine
Datei für jeden Pfad, den Sie beim Setup erstellt haben. Anhand jeder
Datei können Sie die Daten auswählen, die Sie für diese Datenbank
migrieren möchten. Sie können folgende Optionen auswählen:
Datenbankdaten
Hinweis Wenn Sie Datenbankdaten migrieren möchten, müssen Sie
alle Datenbankdaten migrieren. Wenn Sie Teile der Datenbankdaten
von der Selektion ausnehmen, werden Sie in einer Fehlermeldung
gefragt, ob Sie Datenbankdaten migrieren möchten oder nicht.
Wenn Sie beim Setup keine Serverdaten migriert haben, ist die Option
„Database Data“ deaktiviert.
Standardwerte
Regeln
Benutzerdefinierte Datentypen
Tabellen
Indizes
Referenzielle Integritätsregeln
Ansichten
Gespeicherte Prozeduren
Trigger
Das Feld „Status“ für diese Objekte gibt an, ob die Daten erfolgreich
migriert wurden oder nicht. „Success“ bedeutet, dass die Daten bereits
migriert wurden. „Initial“ bedeutet, dass die Migration noch nicht gestartet
wurde. Wenn Sie bei den migrierten Daten auf einen Fehler stoßen,
können Sie das Feld „Status“ auf den Wert „Initial“ zurücksetzen, sodass
die Daten erneut migriert werden. Der Validierungsvorgang wird nur
für die Objekte durchgeführt, die mit Erfolg migriert wurden. Um den
Validierungsvorgang also ohne die Daten, die erfolgreich migriert wurden,
durchzuführen, setzen Sie das Feld „Status“ auf den Wert „Success“
zurück. „Work in Progress“ bedeutet, dass das Objekt für die Migration
ausgewählt wurde, diese jedoch nicht durchgeführt wurde, da sybmigrate
aufgrund eines Fehlers vorzeitig abgebrochen wurde.
Dienstprogramme 121

Migrationsprozess
Validierung
Ressourcedatei-Modus
Sie können sehen, ob die Serverdaten für die Migration ausgewählt
wurden. Diese Anzeige dient jedoch lediglich Informationszwecken,
da die Serverdaten in diesem Stadium des Migrationsprozesses bereits
migriert wurden.
Wenn Sie die Daten ausgewählt haben, die Sie migrieren möchten,
klicken Sie auf „Migrate“.
Die Validierungsphase gleicht der Migrationsphase. In den Fenstern werden
Sie aufgefordert, die gleichen Informationen einzugeben, diesmal wählen Sie
jedoch keine Daten für die Migration, sondern für die Validierung aus.
Sie können nur die Objekte validieren, die erfolgreich migriert wurden.
Sie müssen im Ressourcedatei-Modus die folgenden Änderungen vornehmen:
Die Attribute data_copy_thread, create_index_thread und work_thread
werden in den Setup-, Migrations- und Validierungssitzungen von
sybmigrate erkannt. In der Setup-Sitzung werden diese Werte in der
Repository-Datenbank gespeichert und in der Migrations- und
Validierungssitzung als Standardwerte verwendet. In den Migrations- und
Validierungssitzungen können Sie die Standardwerte durch Angabe eines
neuen Wertes überschreiben.
lock_account ist eine neue Funktion für die Verwaltung der Login-Konten.
lock_account weist sybmigrate an, alle Konten auf dem neuen Adaptive
Server zu sperren oder zu entsperren, nachdem die Login-Daten kopiert
wurden. Die gültigen Werte sind „Yes“ und „Nein“. Wenn Sie „Yes“
wählen, sperrt sybmigrate die Konten auf dem neuen Adaptive Server.
Um lock_account zu aktivieren, müssen Sie migrate_server_data in der
Setup-Sitzung auf „Yes“ stellen.
Wenn das Attribut lock_account nicht gesetzt ist, werden die Login-Konten
auf dem Zielserver nicht gesperrt.
122 Adaptive Server Enterprise

Kapitel 6 Migrations-Dienstprogramm
login_password_file wurde hinzugefügt, um die Kennwortänderung auf
dem neuen Adaptive Server zu unterstützen. In der Setup-Sitzung zieht
login_password_file die eingegebene Kennwortdatei oder den Wert
„“ heran. „“ ist ein spezieller Schlüssel, der
sybmigrate anweist, die Kennwörter zu generieren, anstatt sie aus der
Kennwortdatei zu lesen. Wenn dieses Attribut in der Setup-Sitzung nicht
in der Ressourcedatei gesetzt wird, werden die Login-Kennwörter auf
dem neuen Adaptive Server nicht geändert. Um login_password_file zu
aktivieren, müssen Sie migrate_server_data in der Setup-Sitzung auf „Yes“
stellen.
Die Kennwortdatei muss eine reine Textdatei sein. Diese Datei enthält
zwei Spalten: die Spalte mit den Login-Namen und die Spalte mit den
Kennwörtern. Die Spalten sind durch Tabs oder Leerzeichen getrennt.
Alle Zeilen, die mit „#“ beginnen, sind Kommentare.
auto_select_dependent_objects ist ein neuer Wert, der in der Migrationsund
Validierungssitzung zur Verfügung steht. Dieses Attribut weist
sybmigrate an, die abhängigen Objekte automatisch für die Migration
und Validierung auszuwählen. Die gültigen Werte für dieses Attribut
sind entweder „Yes“ oder „No“. „No“ ist der Standardwert.
Wenn die Attribute source_ase, source_ase_login, source_ase_password,
target_ase, target_ase_login und target_ase_password nicht in der
Ressourcedatei vorhanden sind, fordert sybmigrate den Benutzer auf,
diese Attribute anzugeben.
Im Datenbankabschnitt der Ressourcedatei werden alle Objekte und
Objekttypen ausgewählt, wenn Sie keine Objekte und kein SQL angeben.
Beispiel: In der folgenden Ressourcedatei werden alle Objekttypen
(Standard, Regel, Tabelle usw.) von den Datenbanken pubs2 und pubs3
migriert:
[server}
source_ase=tho:5002
source_ase_login=sa
source_ase_password=
target_ase=tho:6002
target_ase_login=sa
target_ase_password=
[database]
source_database_name=pubs2
target_database_name=pubs2
Dienstprogramme 123

Migrationsprozess
[database]
source_database_name=pubs3
target_database_name=pubs3
Der Ressourcedatei-Modus ist nicht interaktiv. Die Ressourcedatei enthält
alle Informationen, die für die Migration benötigt werden. Sie können den
Ressourcedatei-Modus nutzen, wenn der GUI-Modus nicht unterstützt wird
oder Sie Batch-Dateien ausführen müssen.
Wenn Sie in der Ressourcedatei keine Attribute zu den zu migrierenden
Objekttypen angeben, wird die ganze Datenbank von sybmigrate migriert.
Wenn Sie in der Ressourcedatei kein Login oder Kennwort für den alten bzw.
neuen Adaptive Server angeben, wird der Benutzer von sybmigrate
aufgefordert, diese Informationen bereitzustellen.
Im Folgenden sehen Sie das Format der Ressourcedatei, wie sybmigrate
im nicht interaktiven Modus ausgeführt wird. Um eine Ressourcedatei zu
erstellen, geben Sie alle Werte in eine Datei ein:
#
# This is a sample Migration Tool resource file.
# This resource file will migrate objects in pubs2,
# pubs3, and foo databases.
#
######################################################
# Server wide information
######################################################
[server]
# ":" or just server name.
source_ase=tho:5002
source_ase_login=sa
source_ase_password=
# ":" or just server name.
target_ase=tho:6002
target_ase_login=sa
target_ase_password=
# Repository database setup attributes. This is
required with "setup" mode.
# Repository database size in MB.
repository_database_size=7
# Device used to create the "sybmigrate" database.
repository_device=master
124 Adaptive Server Enterprise

Kapitel 6 Migrations-Dienstprogramm
# Migrate server wide data - logins, roles, remote servers, etc...
# valid only with "setup" mode, default is yes
migrate_server_data=yes
# Tell sybmigrate to lock or unlock all login accounts on the
# target Adaptive Server. Valid values are "yes" and "no":
# "yes" to lock and "no" to unlock. This is only valid if
# "migrate_server_data" is set to "yes" and run in "setup" mode.
# If this attribute is not specified, target Adaptive Server login
# accounts are not change.
lock_account=no
# Change target Adaptive Server login passwords. This is only valid
# if "migrate_server_data" is set to "yes" and run in "setup" mode.
# If this attribute is not specified, target Adaptive Server login
# accounts are not change.
# The valid values are "" and password file.
# "" instructs sybmigrate to use random passwords.
# Password file instructs sybmigrate to use the passwords from
# this file.
# The content of the password file consists of two columns:
# the login name column and the password string column.
# The separator between the columns are tabs and or spaces.
login_password_file=
######################################################
# Database information
######################################################
#
# Migrate the "pubs2" database objects
#
[database]
# Specify the source target database to migrate.
source_database_name=pubs2
target_database_name=pubs2
# Migrate database data, valid only if "migrate_server_data"
# was set to "yes" in "setup" mode. This is default to yes.
migrate_database_data=yes
# Work database setup attributes. This is required with "setup" mode.
# Work database size in MB.
work_database_size=5
# Device used to create the work database.
work_database_device=master
Dienstprogramme 125

Migrationsprozess
# Number of threads use to do user table data copy
data_copy_thread=5
# Number of thread use to create indexes.
create_index_thread=1
# Number of thread use to do ddl migration/validation
work_thread=10
# Automatically select the depedent objects for migration and
# validation. Valid values are "yes" or "no".
auto_select_dependent_objects=yes
#
## Migrate objects
#
# These attributes specify the list of DDL object to
# migrate or validate. User can directly specify the
# list of DDL object or ask Migration tool to query the
# list. Directly specifying the list has the higher
# precedence. The SQL command will ignore if the list
# is given.
#
# Note:
# * The SQL command for the "*_list_from_sql" attributes
# must return column or columns and
# * Index type must also specify the table name. For
# example, "." for
# "index_create_list" attribute or columns ,
# for "index_create_list_from_sql"
# attribute.
# * Value "" can be used on any of the
# attributes to specify all objects for the type.
# * If none of these attributes are given, all objects
# and data are migrated.
#
user_defined_type_create_list=
id
dbo.tid
default_create_list_from_sql=
select user_name(uid), name from sysobjects
where type = 'D'
rule_create_list=
126 Adaptive Server Enterprise

pub_idrule, title_idrule
table_create_list=
publishers
titles
dbo.authors
dbo.titleauthor
dbo.roysched
stores
dbo.sales
dbo.salesdetail
dbo.discounts
dbo.au_pix
blurbs
table_migrate_list=
dbo.publishers titles dbo.authors dbo.titleauthor
dbo.roysched
stores dbo.sales dbo.salesdetail dbo.discounts au_pix
dbo.blurbs
index_create_list=
dbo.authors.auidind
dbo.authors.aunmind
publishers.pubind
roysched.titleidind
sales.salesind
salesdetail.titleidind
salesdetail.salesdetailind
titleauthor.taind
titleauthor.auidind
titleauthor.titleidind
titles.titleidind
titles.titleind
trigger_create_list=
deltitle
totalsales_trig
store_procedure_create_list_from_sql=
select name from sysobjects where type = 'P'
view_create_list_from_sql=
referential_constraint_create_list_from_sql=
Kapitel 6 Migrations-Dienstprogramm
Dienstprogramme 127

Migrationsprozess
#####################################################
#
# Migrate the "pubs3" database objects
#
[database]
source_database_name=pubs3
target_database_name=pubs3
# Migrate database data - user, etc.
migrate_database_data=yes
# These two attributes valid only with "setup" mode
work_database_size=5
work_database_device=master
# Number of threads use to do user table data copy
data_copy_thread=5
# Number of thread use to create indexes.
create_index_thread=1
# Number of thread use to do ddl migration/validation
work_thread=10
# Migrate objects
user_defined_type_create_list=
default_create_list=
rule_create_list=
table_create_list=
dbo.authors
publishers
dbo.titles
dbo.roysched
stores
dbo.sales
dbo.store_employees
salesdetail
dbo.titleauthor
dbo.discounts
blurbs
128 Adaptive Server Enterprise

table_migrate_list_from_sql=
index_create_list=
trigger_create_list=
store_procedure_create_list=
view_create_list=
referential_constraint_create_list_from_sql=
#####################################################
Kapitel 6 Migrations-Dienstprogramm
#
# Migrate all the "foo" database objects with default settings.
#
[database]
source_database_name=foo
target_database_name=foo
# Migrate database data - user, etc.
migrate_database_data=yes
# These two attributes valid only with "setup" mode
work_database_size=5
work_database_device=master
# Number of threads use to do user table data copy
data_copy_thread=5
# Number of thread use to create indexes.
create_index_thread=1
# Number of thread use to do ddl migration/validation
work_thread=10
Dienstprogramme 129

Aufgaben nach der Migration
Aufgaben nach der Migration
sybmigrate unterstützt nur die Migration von den in diesem Dokument
genannten Objekten. Migrieren Sie andere Schemenobjekte und
Konfigurationsinformationen manuell, um sicherzustellen, dass Adaptive
Server uneingeschränkt betriebsfähig ist.
Die Index-Statistiken werden beim Neuaufbau der Indizes automatisch
neu erstellt. sybmigrate erstellt jedoch keine neuen Statistiken von
Spalten, die keine Indizes sind. Benutzerdefinierte Stufenwerte für Index-
Statistiken werden bei der Migration nicht beibehalten. Um Statistiken des
neuen Servers zu erhalten, die denen des alten Servers ähneln, verwenden
Sie optdiag, um die Tabellen mit Nicht-Index-Spalten zu ermitteln, die
Statistiken enthalten. Nachdem Sie ermittelt haben, welche Nicht-Index-
Spalten Statistiken enthalten, aktualisieren Sie die Statistiken manuell.
Allen Meldungen, die der Aufmerksamkeit des Benutzers bedürfen,
ist das Wort „Attention“ vorangestellt. Sie werden im Migrationslog
protokolliert.
Führen Sie den Bericht über den Migrationsstatus der Objekte aus, um zu
überprüfen, ob alle Objekte migriert wurden.
Daten aus Replication Server in Adaptive Server 12.5
migrieren
Adaptive Server Version 12.5 kann unabhängig von der Seitengröße von
Adaptive Server breitere Daten generieren als Replication Server Version 12.1.
So kann ein Adaptive Server mit einer 2-KByte-Seite beispielsweise mehr als
250 Spalten umfassen, die breiter sind als 255 Bytes.
Replication Server 12.1 und frühere Versionen können breite Daten nicht
verarbeiten. Wenn breite Daten vom RepAgent an den Replication Server
übergeben werden, kann es sein, dass verschiedene Replication Server-Threads
beendet werden.
Wenn sich RepAgent mit dem Replication Server verbindet, gibt er eine LTL-
Version zurück. Diese Version sowie die Einstellung data limits filter mode legen
fest, wie RepAgent breite Daten behandelt. Die Versionen von Replication
Server und LTL sind wie folgt kompatibel:
130 Adaptive Server Enterprise

Kapitel 6 Migrations-Dienstprogramm
Tabelle 6-1: Versionen von Replication Server und LTL
Replication Server-Version LTL-Version
12.1 und niedriger < 400
höher als 12.1 >= 400
Die Kompatibilität bezüglich der Einschränkungen je nach LTL-Version lautet
wie folgt:
Tabelle 6-2: Replication Server: eingeschränkte Anzahl/Breite Spalten
Eigenschaft 12.1 und niedriger
Replication Server
Zeilenanzahl 250 65535
Zeilenbreite 255 65535
Höher als 12.1
Replication Server
Bei Adaptive Server 12.5 in Verbindung mit Replication Server 12.1 und
früheren Versionen lautet die Standardeinstellung für data limits filter mode
„stop“. Der RepAgent wird beendet, wenn er auf Daten stößt, die breiter als
die Verarbeitungskapazitäten von Replication Server sind. Wenn data limits
filter mode auf „skip“ eingestellt ist, überspringt RepAgent die breiten Daten,
die die Verarbeitungskapazitäten von Replication Server überschreiten, und
protokolliert eine Info-Meldung.
Wenn data limits filter mode auf „truncate“ eingestellt ist, kürzt RepAgent die
breiten Daten, damit diese von Replication Server verarbeitet werden können.
In Replication Servern der Version 12.1 und früher werden nur die ersten
250 Spalten oder Parameter übermittelt, wenn die Tabelle oder gespeicherte
Prozedur mehr als 250 Spalten oder Parameter umfasst. Ist die Spalte oder
der Parameter breiter als 255, werden nur die ersten 255 Byte gesendet.
Hinweis Wenn data limits filter mode auf „off“ eingestellt ist, werden die breiten
Daten an Replication Server gesendet, was aber zu Fehlern im Replication
Server führen kann.
Replication Server erkennt alle Verbindungen nach Servername.Datenbank.
Das bedeutet, dass Sie nach der Migration den Namen des Zielservers in den
Namen des Quellservers ändern müssen.
Dienstprogramme 131

Daten aus Replication Server in Adaptive Server 12.5 migrieren
Vorbereitung der Datenbanken mit Replikationsdaten für
die Migration
Sie müssen sicherstellen, dass die Replikation von bzw. in jede Datenbank
vollständig ist. Für eine Primärdatenbank müssen also alle Änderungen auf
alle replizierten Datenbanken vollständig ausgeführt worden sein, die für
Daten aus dieser Datenbank gelten; und für eine Replikatdatenbank müssen
alle Änderungen, die für diese Datenbank gelten, vollständig auf diese
Datenbank ausgeführt worden sein. Das bedeutet auch, dass es keinen
unabgeschlossenen Replication DDL geben sollte, einschließlich Routen,
Verbindungen und Subskriptionen. In der Dokumentation zu Replication
Server finden Sie Anleitungen zur Überprüfung, ob Replication DDL noch
nicht abgeschlossen ist.
Zu „vollständig angewandt“ zählen Transaktionen in den ein- und
ausgehenden Warteschlangen von Replication Server. Nach der Migration
können die Daten in den Warteschlangen von Replication Server nicht mehr
wiederhergestellt werden, deshalb müssen Sie absolut sichergehen, dass die
Replikationsdaten vollständig angewandt wurden.
❖ Primäre Replikatdatenbank verwenden
1 Melden Sie sich am Replication Server an, und unterbinden Sie den
Log-Transfer mit folgendem Befehl:
suspend log transfer from Server.Datenbank
2 Fahren Sie RepAgent in der Datenbank herunter, indem Sie sich am
Adaptive Server anmelden und folgenden Befehl eingeben:
use Datenbank
sp_stop_rep_agent Datenbank
❖ Replikatdatenbank verwenden
Trennen Sie sämtliche DSI-Verbindungen mit dieser Datenbank, indem
Sie sich am Replication Server anmelden und folgenden Befehl eingeben:
suspend connection to Server.Datenbank
❖ RSSD-Datenbank verwenden
1 Wenn es sich bei der RSSD-Datenbank auch um eine primäre Datenbank
oder eine Replikatdatenbank handelt, müssen Sie die oben genannten
Aktionen je nach Bedarf durchführen.
2 Versetzen Sie die RSSD-Datenbank in den Hibernation-Modus, indem Sie
folgende Zeichenfolge eingeben:
sysadmin hibernate_on, Replication Server
132 Adaptive Server Enterprise

Kapitel 6 Migrations-Dienstprogramm
Bevor Sie mit der Migration beginnen, zeichnet sybmigrate die
Replikationsinformationen in seinem Log auf. Aus diesem Log können
die Informationen abgerufen werden, die zur Wiederherstellung der
Replikationsinformationen bei den der Migration folgenden Aufgaben
notwendig sind. Weitere Hinweise finden Sie unter „Aufgaben für replizierte
Datenbanken nach der Migration“ auf Seite 133.
Aufgaben für replizierte Datenbanken nach der Migration
Stellen Sie nach der Migration die Replikationsinformationen in der
Datenbank wieder her. Die dafür notwendigen Schritte können mit dem
Bericht repl generiert werden.
❖ Primärdatenbanken wiederherstellen
1 Wenn für die originale Primärdatenbank „Warm Standby“ aktiviert ist,
geben Sie Folgendes ein:
sp_reptostandby Datenbankname, Standby-Status
Der Standby-Status der Quelldatenbank wird von sybmigrate im
Migrationslog gespeichert. Befolgen Sie die o. g. Schritte, um den
Standby-Status wiederherzustellen:
2 Setzen Sie die Generationsnummer durch Eingabe folgenden Befehls
zurück:
dbcc settrunc ("ltm", "gen_id", Gen_Nr)
Die Generationsnummer der Quelldatenbank wird von sybmigrate im
Migrationslog gespeichert. Verwenden Sie den o. g. Befehl, um die
Generationsnummer wiederherzustellen:
3 Sekundär-Logtrennstelle zurücksetzen
dbcc settrunc ("ltm", "valid")
4 Setzen Sie den Ort von Replication Server für diese Datenbank in der
RSSD des Replication Server auf Null, zu dem diese Datenbank gehört.
Geben Sie dazu folgende Zeichenfolge ein:
rs_zeroltm Server, Datenbankname
Dienstprogramme 133

Daten aus Replication Server in Adaptive Server 12.5 migrieren
Replikatdatenbanken wiederherstellen
5 Wenn diese Datenbank eine aktive Verbindung einer Warm Standby-
Konfiguration ist, materialisieren Sie die Standby-Datenbank durch
Sichern der Primärdatenbank und Laden der Sicherungen in den Standby
neu. Anleitungen hierzu finden Sie in der Dokumentation zu Replication
Server.
6 Starten Sie RepAgent auf der Primärdatenbank wie folgt:
sp_start_rep_agent Datenbankname
7 Melden Sie sich am Replication Server an, und starten Sie den Log-
Transfer neu:
resume log transfer from Server.Datenbank
Wenn es sich bei der Datenbank um eine Replikatdatenbank handelt, geben
Sie die folgenden Befehle ein, um rs_lastcommit und rs_threads zu ändern,
da sie von der logischen Seitengröße abhängen.
Mit diesem Befehl ändern Sie rs_lastcommit:
declare @pad8_size integer
declare @alter_cmd varchar(200)
select @pad8_size = (@@maxpagesize / 2)
- (select sum(A.length) from
syscolumns A, sysobjects B
where A.id = B.id
and B.name = 'rs_lastcommit')
+ (select A.length from
syscolumns A, sysobjects B
where A.id = B.id
and B.name = 'rs_lastcommit'
and A.name = 'pad8')
select @alter_cmd = "alter table rs_lastcommit "
+ "modify pad8 char("
+ convert(varchar(100), @pad8_size)
+ ")"
execute (@alter_cmd)
go
134 Adaptive Server Enterprise

Mit diesem Befehl ändern Sie rs_threads:
declare @pad4_size integer
declare @alter_cmd varchar(200)
Kapitel 6 Migrations-Dienstprogramm
select @pad4_size = (@@maxpagesize / 2)
- (select sum(A.length) from
syscolumns A, sysobjects B
where A.id = B.id
and B.name = 'rs_threads')
+ (select A.length from
syscolumns A, sysobjects B
where A.id = B.id
and B.name = 'rs_threads'
and A.name = 'pad4')
select @alter_cmd = "alter table rs_threads "
+ "modify pad4 char("
+ convert(varchar(100), @pad4_size)
+ ")"
execute (@alter_cmd)
go
RSSD-Datenbanken wiederherstellen
Setzen Sie die RSSD fort, indem Sie sich am Replication Server anmelden und
folgenden Befehl eingeben. Dabei steht Replication Server für den Namen des
Replication Server, der angegeben wurde, als die RSSD-Datenbank vor der
Migration in den Hibernations-Modus geschaltet wurde:
Logs
sysadmin hibernat_off Replication Server
Ändern Sie die Tabellen rs_lastcommit und rs_threads wie unter
„Replikatdatenbanken wiederherstellen“ auf Seite 134 beschrieben.
Hinweis Starten Sie Ihr Replikationssystem erst dann neu, wenn Sie alle
Replikationsinformationen der Datenbank wiederhergestellt haben.
Im Log des Migrationstools stehen vor den Informationen zu den replizierten
Objekten folgende Überschriften:
=== Replication Information for Database 'pdb1' ===
Dienstprogramme 135

Daten aus Replication Server in Adaptive Server 12.5 migrieren
Im Folgenden sehen Sie eine Beispiellogdatei einer Primärdatenbank mit der
Bezeichnung pdb1:
sp_repostandby 'pdb1' is NONE.
Wenn der Standby-Status der Datenbank auf NONE eingestellt ist, verwenden
Sie den Standby-Status wie in den oben beschriebenen, der Migration
folgenden Aufgaben.
sp_config_rep_agent 'pdb1'
Für sp_config_rep_agent brauchen Sie die aktuelle Konfiguration von
RepAgent. Das Migrationstool stellt die Konfiguration von RepAgent
automatisch wieder her. In diesem Log können Sie die Konfiguration
von RepAgent anzeigen.
Parameter name Default Config Value Run value
priority 5 5 5
fade timeout 30 30 30
scan timeout 15 15 15
retry timeout 60 60 60
rs username n/a rs1_user rs1_user
trace flags 0 8194 8194
batch ltl true true true
rs servername n/a rs1 rs1
send buffer size 2k 2k 2k
trace log file n/a n/a n/a
connect database n/a pdb1 pdb1
connect dataserver n/a pds1 pds1
can batch size 1000 1000 1000
security mechanism n/a n/a n/a
msg integrity false false false
unified login false false falses
kip ltl errors false false false
msg origin check false false false
short ltl keywords false false false
msg confidentiality false false false
data limits filter mode stop stop stop
msg replay detection false false false
mutual authentication false false false
send structured oqids false false false
send warm standby xacts false false false
msg out-of-sequence check false false false
skip unsupported features false false false
send maint xacts to replicate false false false
(28 rows affected)
136 Adaptive Server Enterprise

Kapitel 6 Migrations-Dienstprogramm
Dies ist eine Liste der explizit replizierten Tabellen. sybmigrate stellt den
Replikationsstatus für explizit replizierte Tabellen automatisch wieder her.
Sie können den Replikationsstatus der explizit replizierten Tabellen in diesem
Teil des Logs anzeigen.
sp_setreptable
Name Repdef Mode
------------------------------ ---------t1
owner_off
t2 owner_on
(2 rows affected)
Dies ist eine Liste der explizit replizierten gespeicherten Prozeduren.
Das Migrationstool stellt den Replikationsstatus für explizit replizierte
gespeicherte Prozeduren automatisch wieder her. Sie können den
Replikationsstatus der explizit replizierten gespeicherten Prozeduren in
diesem Teil des Logs anzeigen.
sp_setrepproc
Name Type Log Mode
----------------------- ------------- ----------p1
function log_sproc
p2 function log_current
p3 table log_sproc
p4 table log_current
(4 rows affected)
Dies sind Informationen zur Sekundär-Logtrennseite. Bei den nach der
Migration zu erledigenden Aufgaben brauchen Sie die Spalte generation_id.
dbcc gettrunc
secondary_trunc_page secondary_trunc_state dbrepstat generation_id
database_id database_name ltl_version
----------------------------------------------------------
621 1 167 0
6 pdb1 400
(1 row affected)
This appears to be a replicated primary database.
Make sure the post processing steps for a replicated primary
database are performed. Please consult the manuals for
the steps that need to be performed.
Dienstprogramme 137

Einschränkungen
Es folgt ein Beispiellogeintrag für eine Replikatdatenbank.
This appears to be a replicate database.
If the pagesize is greater than 2K, make sure the
post processing steps for a replicate database
are performed. Please consult the manuals for the
steps that need to be performed.
Es folgt ein Beispiellogeintrag für eine RSSD-Datenbank.
This appears to be a replication system database
Make sure the post processing steps for a replication system
database are performed. Please consult the manuals for
the steps that need to be performed
Einschränkungen
Hohe Verfügbarkeit
(High Availability)
Es ist möglich, dass alle drei Logs für eine Datenbank existieren,
da eine Datenbank die drei Kategorien auflisten kann.
Hinweis Bei der Migration der Serverdaten setzt sybmigrate voraus,
dass der Katalog des neuen Adaptive Server nur Standarddaten enthält.
Die Standarddaten auf Windows-Rechnern unterscheiden sich von denen auf
UNIX-Rechnern. Deshalb kommt es bei der Migration von UNIX- auf NT-
Rechner zu Problemen. Um eine erfolgreiche Migration von einem UNIX- auf
einen NT-Rechner durchzuführen, löschen Sie den Namen des XP Servers und
das Login mon_user des NT-Rechners, auf den die Daten migriert werden.
Die Datenmigration ist nicht möglich, wenn Sie die hohe Verfügbarkeit (High
Availability) eingestellt haben. Sie müssen diese Einstellung zurücknehmen,
bevor Sie mit der Datenbankmigration beginnen.
❖ Hohe Verfügbarkeit vor Beginn der Datenbankmigration ausschalten
1 Entkoppeln Sie den primären und sekundären Adaptive Server.
2 Migrieren Sie die Daten des primären alten Adaptive Server
und des sekundären alten Adaptive Server separat in den primären
neuen Adaptive Server und den sekundären neuen Adaptive Server.
138 Adaptive Server Enterprise

Weitere
Einschränkungen
Kapitel 6 Migrations-Dienstprogramm
3 Stellen Sie auf dem neuen Adaptive Server die hohe Verfügbarkeit ein.
Achtung! Damit die hohe Verfügbarkeit ausgeführt werden kann, müssen
der primäre und sekundäre Adaptive Server mit der gleichen logischen
Seitengröße konfiguriert sein.
sybmigrate unterstützt keine Migration zwischen Servern mit
unterschiedlichen Hauptversionsnummern. Das heißt, sowohl auf dem
Quell- als auch auf dem Zielserver muss Adaptive Server 12.5.0.1 oder
höher installiert sein.
Um nachzusehen, ob Adaptive Server 12.5.0.1 oder höher installiert ist,
führen Sie auf dem Server den Befehl @@version aus.
sybmigrate bietet keine spezielle Verarbeitung für eine DTM/XA-
Umgebung. Der Status der offenen Transaktionen und ausstehender
vorbereiteter Transaktionen sollte berücksichtigt werden. Ist eine spezielle
Verarbeitung erforderlich, muss diese manuell erfolgen.
sybmigrate bietet keine zuverlässige Methode zur Ermittlung der
Abhängigkeit verschiedener Objekte. sybmigrate legt anhand der
Abhängigkeiten von Objekten zu anderen Objekten keine Reihenfolge
fest, in der die Objekte migriert werden. Die Neuerstellung von Tabellen
kann fehlschlagen, wenn Fremdschlüssel oder gemeinsame Schlüssel mit
sp_foreignkey oder sp_commonkey definiert werden. Ansichten können
von anderen Ansichten abhängig sein. Sie werden nicht neu erstellt,
wenn die Ansicht, von der sie abhängen, noch nicht migriert wurde.
Die Migration gespeicherter Prozeduren und Trigger kann fehlschlagen,
wenn die Daten, von denen sie abhängen, noch nicht migriert wurden.
Datenbankübergreifende Abhängigkeiten bedeuten, dass Sie die
Migration zugehöriger Objekte koordinieren müssen. Existieren
Abhängigkeiten innerhalb des ausgewählten Satzes, werden diese von
sybmigrate berücksichtigt. Wenn die Abhängigkeiten jedoch außerhalb des
ausgewählten Satzes bestehen, müssen Sie sybmigrate unter Umständen
mehr als einmal bei der Migration ausführen. Deshalb müssen Sie
möglicherweise einige Anlaufversuche unternehmen, um die
Datenmigration zu einem erfolgreichen Abschluss zu bringen.
Der Name der Quell- und Zieldatenbanken muss identisch sein.
Das von ddlgen generierte SQL-Schema kann Objekte umfassen,
die mit dem Namen des alten Adaptive Server qualifiziert werden
müssen.
Dienstprogramme 139

Problembehebung und Fehlermeldungen
sybmigrate unterstützt kein Auditing der Migrationsaktivitäten.
Wenn Sie kompilierte Objekte (Prozeduren, Ansichten, Regeln,
Standardwerte) umbenennen, wird der Name des Objekts in syscomments
nicht aktualisiert.
Während der Migration fragt DDLGen das Objekt von syscomments mit
dem alten Namen im Text ab. Dieser alte Name im Text macht sybmigrate
bei der DDL-Migration Probleme.
Problembehebung und Fehlermeldungen
Objekte werden nicht migriert
Beginn der Datenbankmigration
In diesem Abschnitt werden allgemeine Fehler und deren Behebung sowie
die verschiedenen Fehlermeldungen und deren Bedeutungen beschrieben.
Beim ersten Versuch werden Objekte oft nicht migriert. sybmigrate wiederholt
alle fehlgeschlagenen Migrationsversuche automatisch. Wenn Sie jedoch
versuchen, ein Objekt zu migrieren, das von einem anderen nicht migrierten
Objekt abhängt, wird die Migration auf jeden Fall fehlschlagen.
Um zu verhindern, dass Objekte nicht migriert werden, überprüfen Sie die
Abhängigkeiten der Objekte, die Sie für die Migration vorsehen. So können Sie
z. B. keinen Trigger migrieren, wenn die Tabelle, für die der Trigger definiert
ist, nicht auch migriert wird. Analog dazu können auch Ansichten nicht
migriert werden, die auf anderen Ansichten oder Tabellen erstellt wurden,
wenn diese nicht auch migriert werden.
Wenn Sie sich in der Setup-Phase des Migrationsprozesses befinden, müssen
Sie entscheiden, ob Sie Serverdaten migrieren möchten oder nicht. Sie können
die Option „Yes“, „No“ oder „Undecided“ wählen.
140 Adaptive Server Enterprise

Kapitel 6 Migrations-Dienstprogramm
Wenn Sie „Undecided“ wählen, können Sie den Migrationsprozess einrichten
und zu einem späteren Zeitpunkt zurückkehren, an dem Sie die Migration
wirklich durchführen möchten. Wenn Sie „Undecided“ wählen, können
Sie die Datenbankmigration erst starten, wenn Sie angegeben haben,
ob die Serverdaten migriert werden sollen.
Wenn Sie in der Setup-Phase angeben, dass die Serverdaten nicht migriert
werden sollen, können Sie nicht mit der Datenbankmigration beginnen.
„Connection refused“ und „Unable to obtain connection to the
server“
Für das Auftreten dieser beiden Fehler kann es zwei Gründe geben.
Wenn der alte oder der neue Adaptive Server nicht ausgeführt wird,
kann sybmigrate keine Verbindung herstellen.
Der Konfigurationsparameter number of user connections muss so
eingestellt sein, dass auf beiden Servern (alter und neuer Adaptive Server)
ausreichend Ressourcen zur Verfügung stehen.
Der Zielserver ist vom Quellserver nicht erreichbar
Die Interfaces-Datei wird zum Starten des alten Adaptive Server verwendet.
Stellen Sie sicher, dass diese Datei über einen Eintrag verfügt, der den neuen
Adaptive Server identifiziert.
Überprüfen Sie, ob Sie mit Ihrem Login vom alten auf den neuen Adaptive
Server zugreifen können.
Wenn sybmigrate bei der Migration hängt
Wenn sybmigrate beim Migrationsprozess hängt, prüfen Sie das Log
sybmigrate in $SYBASE/$SYBASE_ASE/init/logs auf irgendwelche Fehler
oder Ausnahmen.
Überprüfen Sie auch die Logs Ihres Adaptive Server. Wenn die Adaptive
Server-Logs über nicht mehr ausreichend Speicher in der Datenbank
verfügen, erhöhen Sie die Datenbankgröße, und installieren Sie die
gespeicherte Prozedur sp_threasholdaction, um dump tran auszuführen,
wenn das Log voll ist.
Dienstprogramme 141

Problembehebung und Fehlermeldungen
Zwei Datenbanken zusammenführen
Um zwei Datenbanken auf dem alten Adaptive Server in eine Datenbank auf
dem neuen Adaptive Server zusammenzuführen, gehen Sie wie folgt vor.
❖ Zwei Datenbanken zusammenführen
1 Richten Sie die erste Datenbank ein, und migrieren Sie diese.
2 Nachdem Sie die erste Datenbank migriert haben, ändern Sie den Namen
der Zieldatenbank in den Namen der zweiten Quelldatenbank.
3 Richten Sie die zweite Datenbank ein, und migrieren Sie diese.
Hinweis Sie können die Datenbankdaten der zweiten Datenbank nicht
migrieren, wenn die Benutzer, Rollen und anderen Datenbankdaten bereits
auf der Zieldatenbank existieren.
Bereinigen von Fehlern nach der Migration
Datenbank erneut migrieren
Wenn sybmigrate unerwartet fehlschlägt, bereinigen Sie den alten und neuen
Adaptive Server, und führen Sie die Migration erneut durch. Es gibt einige
Aktionen, die Sie auf dem alten und dem neuen Adaptive Server ausführen
müssen.
Auf dem alten Adaptive Server:
Löschen Sie die temporären Arbeitsdatenbanken mtpdb$%.
Löschen Sie die Repository-Datenbank sybmigratedb.
Löschen Sie alle Fremdserver mtrs$%.
Auf dem neuen Adaptive Server:
Wenn Serverdaten migriert wurden, bauen Sie den Adaptive Server mit
srvbuild oder syconfig neu auf.
Erstellen Sie die Zieldatenbanken neu.
Um eine Datenbank erneut zu migrieren, gehen Sie wie folgt vor:
1 Starten Sie sybmigrate.
142 Adaptive Server Enterprise

Einzelne Objekte neu erstellen
Verbindung fehlgeschlagen
Kapitel 6 Migrations-Dienstprogramm
2 Klicken Sie in der Setup-Sitzung im Fenster „Setup Paths“ mit der rechten
Maustaste auf den Migrationspfad, den Sie erneut ausführen möchten.
3 Wählen Sie im Popup-Menü die Option „Delete Migration Path“.
4 Bereinigen oder entfernen Sie die migrierten Daten und Objekte auf
der Zieldatenbank, oder löschen Sie die Zieldatenbank und erstellen Sie
sie neu.
5 Starten Sie sybmigrate erneut, und führen Sie das Tool im Setup-
Modus aus.
So erstellen Sie ein Objekte neu:
1 Löschen Sie im neuen Adaptive Server das Objekt, das Sie neu erstellen
möchten.
2 Starten Sie sybmigrate in der Migrationssitzung, und öffnen Sie das
Fenster „Migrate Object Selection“. Markieren Sie das Objekt, das Sie
neu erstellen möchten, und klicken Sie auf die rechte Maustaste.
3 Wählen Sie vom Popup-Menü „Reset Object to Initial status“.
4 Schließen Sie den Migrationsprozess ab.
Wenn Sie eine Fehlermeldung erhalten, dass keine Verbindung hergestellt
werden konnte, obwohl alter und neuer Adaptive Server ausgeführt werden,
verwenden Sie möglicherweise den falschen Zeichensatz. Wenn Sie sybmigrate
nutzen, müssen Sie den Standarddatensatz verwenden. Führen Sie sybmigrate
mit der Option -J Zeichensatz aus, um den Zeichensatz zu ändern.
„Insufficient memory in JVM shared class“
Wenn dieser Fehler im Serverlog angezeigt wird, müssen Sie den
Konfigurationsparameter size of shared class heap auf einen höheren
Wert einstellen.
01:00000:00036:2002/01/28 14:17:05.63 server Java VM
Host: Memory allocation request failed because of
Dienstprogramme 143

Problembehebung und Fehlermeldungen
insufficient memory in Jvm Shared Class.
„There is not enough memory in the procedure cache“
java.lang-Fehler
Wenn bei der Migration von Indizes die Fehlermeldung „there is not
enough memory in the procedure cache“ angezeigt wird, erhöhen
Sie mithilfe von sp_configure procedure cache size den Prozedurcache.
Wird die Meldung
java.lang.NoClassDefFoundError:com/sybasejdbcx/Sybdriver
angezeigt, wenn Sie sich mit Adaptive Server verbinden, müssen Sie
sicherstellen, dass im Verzeichnis $SYBASE ($SYBASE/jConnect-5_5)
JConnect 5.5 installiert ist.
144 Adaptive Server Enterprise

KAPITEL 7 Adaptive Server Plug-In
installieren
Einführung
Dieses Kapitel beschreibt das Adaptive Server Enterprise Plug-In und
behandelt außerdem folgende Themen:
Einsatz der Monitor Client-GUI als Teil von Adaptive Server
Plug-In und als eigenständige Anwendung
Verwendung der C++-Version von Adaptive Server Plug-In
Thema Seite
Einführung 145
Funktionsunterschiede zwischen den Versionen im Vergleich 146
Auf die Monitor Client-GUI zugreifen 148
Das Adaptive Server Plug-In ist mit dem Sybase Central-Toolkit
entwickelt worden. Es wird als Plug-In in einem Anzeigeprogramm
ausgeführt, in das Sie gleichzeitig mehrere Plug-Ins laden können. Das
Adaptive Server Plug-In, das auf der C++-Version von Sybase Central
basiert und nur unter Windows NT, Windows 2000 und Windows 98 läuft,
wird nicht mehr hergestellt. Es wird durch das Plug-In für Adaptive Server
Version 12.5 ersetzt, das auf Grundlage des Sybase Central Java Edition-
Toolkit entwickelt wurde und auf allen Plattformen läuft.
Ausführliche Informationen zum Gebrauch der Funktionen des Plug-Ins
finden Sie in der Online-Hilfe für Sybase Central.
Dienstprogramme 145

Funktionsunterschiede zwischen den Versionen im Vergleich
Lieferung des Adaptive Server Plug-Ins
Adaptive Server Version 12.5 enthält zwei Versionen des Adaptive Server
Plug-Ins:
Das Java Adaptive Server Plug-In auf Basis des Sybase Central Java
Edition Framework – auf allen Server-Installations-CDs und auf der PC-
Client-Installations-CD enthalten.
Das C++ Adaptive Server Plug-In auf Basis von Sybase Central C++
Version – nur auf der PC-Client-Installations-CD enthalten. Um auf die
C++-Version zugreifen zu können, müssen Sie sie mit der PC-Client-
Installations-CD auf einer Windows-Plattform installieren.
Funktionsunterschiede zwischen den Versionen im
Vergleich
Die Funktionalität der Java und C++ Plug-Ins unterscheidet sich in mehreren
Hinsichten . Die Java-Edition sollte zur Ausführung administrativer Aufgaben
in Adaptive Server 12.5 benutzt werden. Die C++-Version des Plug-Ins wurde
nur in Version 12.5 integriert, um Zugriff auf die Monitor Client-GUI zu
gewähren.
Das Java Plug-In bietet Unterstützung für alle Leistungsmerkmale von
Adaptive Server 12.5.x, einschl. EJB Server, größere Seitengrößen, größere
Spaltenlängen, Unicode-Datentypen und den neuen Adaptive Server
Replicator. Die C++-Version des Plug-Ins, die im Lieferumfang von Adaptive
Server 12.5 enthalten ist, enthält keine dieser funktionalen Verbesserungen.
Einige der Funktionen in der C++-Version des Plug-Ins sind derzeit nicht in der
Java-Version vorhanden.
146 Adaptive Server Enterprise

Kapitel 7 Adaptive Server Plug-In installieren
Tabelle 7-1 zeigt einen Vergleich der Hauptunterschiede zwischen der C++-
und der Java-Edition des Adaptive Server Plug-Ins.
Funktion
Tabelle 7-1: Funktionsvergleich
C++ Java
Läuft auf allen Plattformen Nein – läuft nur auf Windows-
Plattformen.
Ja
Kann lokalen Server starten Ja – kann eine Adaptive Server-
Installation auf dem lokalen
Rechner starten.
Nein
SQL Monitor Client-Unterstützung Ja Nein
Client Library-Schnittstelle zu Servern Ja – die Edition C++ verwendet
Client-Library und die Java-
Edition benutzt jConnect. Daher
sind beispielsweise syntaktische
Interface-Analysen und
Verzeichnisdienste bei der Java-
Edition nicht ‘nativ’ und zeigen
ein anderes Verhalten als bei der
C++-Edition.
Nein – Der Interface-Parser der
aktuellen Java-Version unterstützt
nur einen Teil der gesamten
Interfaces-Dateisyntax (verwendet
beispielsweise das TLI-Format auf
allen UNIX-Plattformen).
JConnect-Schnittstelle zu Servern Nein Ja
Modusunabhängige Dialoge Nein Ja
Sortierung auf Client-Seite Nein – Sortierung findet auf Ja – führt Sortierungen auf dem
Server-Seite statt.
Client durch und erreicht höhere
Leistung.
SQL-Ablaufprotokoll Ja In Planung
Bearbeiten von gespeicherten Prozeduren
und Aktualisieren von gespeicherten
Prozedurdefinitionen
Ja In Planung
DDLGen Nein Ja
Unterstützung für Funktionen der
Version 12.5.0.1: große Spalten,
mehrere Seitengrößen, Unicode-
Datentypen, EJB Server, ASE Replicator
Nein Ja
Unterstützung von Proxy-Tabellen Ja Ja – verbesserte Funktionen zur
Unterstützung von Proxy-Tabellen
bei Version 12.5.0.1 und höheren
Versionen.
Login mit LDAP-Verzeichnisdiensten Nein Ja – ab Version 12.5.0.1 und
höheren Versionen.
Dienstprogramme 147

Auf die Monitor Client-GUI zugreifen
Auf die Monitor Client-GUI zugreifen
Sie können die Monitor Client-GUI-Anwendung vom „Monitors“-Ordner der
C++-Version des Adaptive Server Plug-Ins aufrufen. Diese Anwendung ist nur
auf Windows-Plattformen verfügbar. Die Java-Edition des Adaptive Server
Plug-Ins enthält weder den „Monitors“-Ordner noch die Monitor Client-GUI-
Anwendung, die in der C++-Version vorhanden sind. Wenn Sie die Monitor
Client-GUI zusammen mit einer Adaptive Server 12.5-Installation benutzen
möchten, müssen Sie die C++-Version des Plug-Ins verwenden, die im
Lieferumfang der Adaptive Server Version 12.5 enthalten ist.
Es ist nicht beabsichtigt, Monitor Client in die Java-Edition des Adaptive
Server Plug-Ins zu integrieren.
Hinweis Die C++-Version des Adaptive Server Plug-Ins, die im Lieferumfang
früherer Versionen als Adaptive Server 12.5 enthalten war, funktioniert mit
einer Adaptive Server 12.5-Installation. Jedoch kann die Monitor Client-GUI
in diesen Versionen nicht auf Adaptive Server 12.5 Monitor Server zugreifen.
Wenn Sie die Monitor Client-GUI zusammen mit einer Adaptive Server 12.5-
Installation und Monitor Server benutzen möchten, müssen Sie die C++-
Version des Plug-Ins verwenden, die im Lieferumfang der Adaptive Server
Version 12.5 enthalten ist.
Monitor Client-GUI als eigenständige Anwendung ausführen
Sie können die Monitor Client-GUI auch als eigenständige Java-Anwendung
ausführen. Dies ist nur auf Windows-Plattformen möglich. Befolgen
Sie hierzu die unten angegebenen Anweisungen. Die Erstellung einer
Stapelverarbeitungsdatei für diese Schritte kann sinnvoll sein.
❖ Monitor Client-GUI als eigenständige Java-Anwendung ausführen
In Ihrem System muss eine Kopie von Java Runtime Environment (JRE)
Version 1.1.8 installiert sein.
Folgende Monitor Client-GUI-Dateien müssen in Ihrem System
installiert sein:
Mclib.dll
Mchelp.dll
3pclass.zip
monclass.zip
148 Adaptive Server Enterprise

Kapitel 7 Adaptive Server Plug-In installieren
Die Adaptive Server-Installationen und Monitor Server müssen Einträge
in Ihrer lokalen sql.ini-Datei haben.
Für jede Adaptive Server-Installation, die Sie überwachen möchten,
muss eine Monitor Server-Installation ausgeführt werden.
Von der Befehlszeile oder innerhalb einer Stapelverarbeitungsdatei:
1 Setzen Sie JAVA_HOME auf das JRE 1.1.8-Verzeichnis.
2 Setzen Sie PATH auf %JAVA_HOME%\bin;%PATH%.
3 Ihr Klassenpfad CLASSPATH muss folgende Dateien enthalten:
set CLASSPATH=DRIVENAME:PATHNAME\monclass.zip;:\
3pclass.zip;%JAVA_HOME%\lib\rt.jar
Dabei gilt:
DRIVENAME ist der Laufwerksbuchstabe des Laufwerks, in dem Ihre
Dateien installiert sind.
PATHNAME ist das Verzeichnis, in dem die Dateien gespeichert sind.
4 Führen Sie die Monitor Client-Anwendung in der Java Virtual Machine
aus, indem Sie folgenden Befehl eingeben:
jre sybase.monclt.mcgui.procact.ProcActApp SQL_SERVER_NAME 12.5
MS_SERVER_NAME sa "" en 0 scssen.hlp
Dabei gilt:
SQL_SERVER_NAME ist der Name der Adaptive Server-Installation,
die Sie in Ihrer sql.ini-Datei überwachen möchten.
MS_SERVER_NAME ist der Name der Monitor Server-Installation
für diese Adaptive Server-Installation in Ihrer sql.ini-Datei.
5 Über die Optionen im Monitor Client-Menü „File“ können Sie die
Überwachungswerte auswählen, die Sie anzeigen möchten.
Dienstprogramme 149

Auf die Monitor Client-GUI zugreifen
150 Adaptive Server Enterprise

KAPITEL 8 Übersicht über die
Dienstprogrammbefehle
In diesem Kapitel werden Adaptive Server-Dienstprogrammbefehle
zusammenfassend behandelt.
Thema Seite
backupserver 158
bcp 164
buildmaster 177
certauth 177
certpk12 180
certreq 183
charset 186
cobpre 187
cpre 187
dataserver 188
dataxtr 195
ddlgen 195
defncopy 210
dscp 217
dsedit 218
extractjava 219
installjava 222
isql 227
langinstall 237
optdiag 240
pwdcrypt 247
showserver 248
sqldbgr 249
sqlloc 255
sqllocres 257
sqlsrvr 259
sqlupgrade 267
Dienstprogramme 151

Erste Orientierung
Erste Orientierung
Thema Seite
sqlupgraderes 268
srvbuild 269
srvbuildres 270
startserver 271
xpserver 278
UNIX Sie geben einen Dienstprogrammbefehl in einer UNIX-Shell an der
System-Eingabeaufforderung ein.
Windows NT
Wenn ein Dienstprogramm in der Programmgruppe „Sybase“ als
Programmsymbol dargestellt ist, können Sie es starten, indem Sie auf
das Symbol doppelklicken.
Wenn für ein Dienstprogramm in der Programmgruppe kein
Programmsymbol vorhanden ist, geben Sie den Dienstprogrammbefehl
an der Windows- oder Windows NT-Eingabeaufforderung ein, um das
Dienstprogramm zu starten.
Setzen Sie Zeichen mit spezieller Bedeutung für die Shell (die Eingabeaufforderung
in Windows NT), wie den Rückstrich (\), das Sternchen (*), den
Schrägstrich (/) und Leerstellen, in Anführungszeichen. Sie können einigen
Sonderzeichen einen Rückstrich (\) als „Escape-Zeichen“ voransetzen.
Dadurch wird die Shell (Eingabeaufforderung) gehindert, die Sonderzeichen
zu interpretieren.
Tabelle 8-1 beschreibt die Dienstprogramme, die für Adaptive Server zur
Verfügung stehen.
Hinweis Die in Tabelle 8-1 beschriebenen Dienstprogramme erlauben es
Ihnen möglicherweise, einen -P-Parameter zu verwenden, um Ihr Kennwort
einzugeben. Wenn Sicherheit ein Problem ist, verwenden Sie diesen Parameter
nicht, um Ihr Kennwort anzugeben. Ein anderer Benutzer hat möglicherweise
die Gelegenheit, es einzusehen. Stattdessen melden Sie sich wie gewohnt ohne
-P-Parameter an und lassen sich vom Adaptive Server zur Eingabe Ihres
Kennworts auffordern.
152 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Dienstprogramm
Tabelle 8-1: Dienstprogramme
Beschreibung
backupserver Ausführbares Format des Backup Server-Programms.
bcp Kopiert Zeilen in einer Datenbanktabelle aus einer oder in eine Betriebssystemdatei in
einem vom Benutzer festgelegten Format.
certauth Konvertiert eine Server-Zertifikatsanforderung in ein Zertifikat mit CA-Berechtigung
(Certificate Authority).
certpk12 Exportiert oder importiert eine PKCS#12-Datei.
certreq Erstellt eine Server-Zertifikatsanforderung und den entsprechenden privaten Schlüssel auf
zwei Arten.
charset Lädt die Zeichensätze und Sortierreihenfolgen-Dateien.
cobpre Precompiler für COBOL.
cpre Precompiler für C.
dataserver Adaptive Server-Programmdatei.
dataxtr Daten-Migrationstool.
ddlgen Generiert Datendefinitionssprache für Objekte der Server- und Datenbank-Ebene in ASE.
defncopy Kopiert Definitionen für angegebene Ansichten, Regeln, Standardwerte, Trigger,
Prozeduren oder Protokolle aus einer Datenbank in eine Betriebssystemdatei bzw. aus einer
Betriebssystemdatei in eine Datenbank.
dscp Ermöglicht es Ihnen, Servereinträge in der Interfaces-Datei von der Befehlszeile aus
anzuzeigen und zu bearbeiten.
dsedit Ermöglicht es Ihnen, Servereinträge in der Interfaces-Datei anzuzeigen und zu bearbeiten,
indem Sie eine auf X11/Motif basierende grafische Benutzeroberfläche verwenden.
extractjava Kopiert eine gespeicherte JAR-Datei von einer Adaptive Server-Installation in eine
Clientdatei.
installjava Installiert eine JAR-Datei von einer Clientdatei in eine Adaptive Server-Installation.
isql Interactive SQL-Parser von Adaptive Server.
langinstall Installiert eine neue Spracheinstellung auf Adaptive Server.
optdiag Zeigt Optimiererstatistiken an oder lädt die aktualisierte Statistik in Systemtabellen.
pwdcrypt Erstellt und schreibt ein verschlüsseltes LDAP-Kennwort in der Datei libtcl.cfg.
showserver Zeigt Adaptive Server und Backup Server an, die derzeit auf dem lokalen Rechner
ausgeführt werden.
sqldbgr Fehlersuche in gespeicherten Prozeduren und Triggern.
sqlloc Installiert und modifiziert Sprachen-, Zeichensatz- und Sortierreihenfolgen-Standardwerte
für Adaptive Server im GUI-Modus.
sqllocres Installiert und modifiziert Sprachen-, Zeichensatz- und Sortierreihenfolgen-Standardwerte
für Adaptive Server im Befehlszeilenmodus.
sqlsrvr Adaptive Server-Programmdatei.
sqlupgrade Upgrade Ihrer derzeit installierten Adaptive Server-Version auf die neueste Version im
GUI-Modus.
Dienstprogramme 153

Erste Orientierung
Dienstprogramm Beschreibung
sqlupgraderes Upgrade Ihrer derzeit installierten Adaptive Server-Version auf die neueste Version im
Befehlszeilenmodus.
srvbuild Erstellt neue Adaptive Server, Backup Server, Monitor Server oder XP Server im
GUI-Modus mit den Standard- oder benutzerdefinierten Werten für wichtige
Konfigurationsattribute.
srvbuildres Erstellt neue Adaptive Server, Backup Server, Monitor Server oder XP Server im
Befehlszeilenmodus mit den Standard- oder benutzerdefinierten Werten für wichtige
Konfigurationsattribute.
sqlsrvr Adaptive Server-Programmdatei.
startserver Startet eine Adaptive Server- oder Backup Server-Installation.
srvmgr Startet Adaptive Server und Backup Server als Windows NT-Dienste.
sybload Lädt Sybase-Produkte vom Datenträger und baut das Sybase Installationsverzeichnis von
der Befehlszeile aus auf.
sybmigrate Ermöglicht Ihnen die Migration von Datenbanken von einem Server, der logische 2-KByte-
Seiten verwendet, auf einen Server, der logische 4-, 8- oder 16-KByte-Seiten verwendet.
sybsetup Installiert und konfiguriert Adaptive Server von einem einzigen Standort mittels einer
GUI-Schnittstelle.
xpserver Startet XP Server manuell.
*_dce- und *_r-Dienstprogramme
Sybase stattet Sie mit _dce-Versionen von manchen Dienstprogrammen aus,
was im „Syntax“-Teil der einzelnen Dienstprogrammabschnitte angezeigt
wird. Sie müssen die dce-Versionen der Dienstprogramme verwenden,
falls Sie das Distributed Computing Environment-Verzeichnis (DCE) oder
Sicherheitsdienste für Sybase Clientanwendungen für die IBM RS/6000-
Plattform verwenden.
Sybase stellt Ihnen zusätzlich die _r-Versionen von einigen Dienstprogrammen
zur Verwendung mit Thread-Treibern zur Verfügung.
Folgende Dienstprogramme in diesem Handbuch haben _dce- und _r-
Versionen:
bcp
cobpre
cpre
defncopy
dscp
isql
154 Adaptive Server Enterprise

Dienstprogramm-Überblick
Kapitel 8 Übersicht über die Dienstprogrammbefehle
Dieser Abschnitt enthält einen Überblick über die Dienstprogramme,
in folgende Kategorien unterteilt:
„Installations- und Konfigurationsdienstprogramme“ auf Seite 155
„Dienstprogramme für Sprachen, Zeichensätze und Sortierreihenfolgen“
auf Seite 156
„Dienstprogramme zum Starten von Servern“ auf Seite 156
„Erstellungs- und Bearbeitungsdienstprogramme für Datenbanken“
auf Seite 157
„Dienstprogramme zum Sammeln von Informationen“ auf Seite 157
Installations- und Konfigurationsdienstprogramme
Verwenden Sie die folgenden Dienstprogramme, um Datenbanken zu
installieren und zu konfigurieren:
dataserver Damit können Sie einen neuen Adaptive Server installieren.
dscp Ermöglicht es Ihnen, Servereinträge in der Interfaces-Datei von der
Befehlszeile aus anzuzeigen und zu bearbeiten.
dsedit Ermöglicht es Ihnen, auf UNIX-Plattformen Servereinträge in der Interfaces-
Datei anzuzeigen und zu bearbeiten, indem Sie eine auf X11/Motif basierende
grafische Benutzeroberfläche (GUI) verwenden.
In Windows NT können Sie damit Netzwerkverbindungsinformationen in den
Interfaces-Dateien erstellen und ändern.
sqlupgrade Stellt auf UNIX-Plattformen Ihre derzeit installierte Adaptive Server-Version
auf die neueste Version um, wobei eine auf X11/Motif basierende grafische
Benutzeroberfläche (GUI) verwendet wird.
sqlupgraderes Stellt auf UNIX-Plattformen Ihre derzeit installierte Adaptive Server-Version
auf die neueste Version um, wobei Ressourcendateien verwendet werden.
srvbuild Erstellt neue Adaptive Server, Backup Server, Monitor Server oder XP
Server mit den Standard- oder benutzerdefinierten Werten für wichtige
Konfigurationsattribute auf UNIX-Plattformen, wobei eine auf X11/Motif
basierende grafische Benutzeroberfläche verwendet wird.
Dienstprogramme 155

Dienstprogramm-Überblick
srvbuildres Erstellt neue Adaptive Server, Backup Server, Monitor Server oder XP Server
auf UNIX-Plattformen, wobei Ressourcendateien verwendet werden,
um die Werte für die wichtigsten Konfigurationsattribute festzulegen.
Dienstprogramme für Sprachen, Zeichensätze und
Sortierreihenfolgen
Verwenden Sie die folgenden Dienstprogramme, um Sprachen, Zeichensätze
und Sortierreihenfolgen einzustellen:
charset Lädt die Zeichensätze und Sortierreihenfolgen-Dateien in Windows NT.
langinstall Installiert eine neue Spracheinstellung auf Adaptive Server.
sqlloc Installiert und modifiziert Sprachen-, Zeichensatz- und Sortierreihenfolge-
Standardwerte für Adaptive Server auf UNIX-Plattformen, wobei eine auf
X11/Motif basierende grafische Benutzeroberfläche verwendet wird.
sqllocres Installiert und modifiziert Sprachen-, Zeichensatz- und Sortierreihenfolge-
Standardwerte für Adaptive Server auf UNIX-Plattformen, wobei eine
Ressourcendatei verwendet wird.
Dienstprogramme zum Starten von Servern
Verwenden Sie die folgenden Dienstprogramme, um Server manuell zu starten:
backupserver Startet das Backup Server-Programm. Verwenden Sie den startserver-Befehl an
Stelle dieses Dienstprogramms, um Backup Server manuell zu starten. In NT
können Sie statt dessen das srvmgr-Dienstprogramm verwenden, um Backup
Server manuell zu starten.
dataserver Startet das Adaptive Server-Programm. Verwenden Sie den startserver-Befehl
an Stelle dieses Dienstprogramms, um Adaptive Server manuell zu starten.
histserver Startet das Historical Server-Programm. Verwenden Sie den histserver-Befehl
an Stelle dieses Dienstprogramms, um Historical Server manuell zu starten.
monserver Startet das Monitor Server-Programm. Verwenden Sie den monserver-Befehl
an Stelle dieses Dienstprogramms, um Monitor Server manuell zu starten.
sqlsrvr Startet das Adaptive Server-Programm in Windows NT. Verwenden Sie das
services manager-Dienstprogramm an Stelle dieses Dienstprogramms,
um Adaptive Server manuell zu starten.
156 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
srvmgr Startet, stoppt und unterbricht Adaptive Server, Backup Server und Adaptive
Server Monitor als Windows NT-Dienste.
startserver Startet eine Adaptive Server- und eine Backup Server-Installation auf UNIX-
Plattformen.
Erstellungs- und Bearbeitungsdienstprogramme für Datenbanken
Verwenden Sie die folgenden Dienstprogramme, um Datenbanken zu erstellen
und zu bearbeiten:
bcp Kopiert eine Datenbanktabelle aus einer oder in eine Betriebssystemdatei in
einem vom Benutzer festgelegten Format.
defncopy Kopiert Definitionen für angegebene Ansichten, Regeln, Standardwerte,
Trigger oder Prozeduren aus einer Datenbank in eine Betriebssystemdatei bzw.
aus einer Betriebssystemdatei in eine Datenbank.
extractjava Kopiert eine gespeicherte JAR-Datei und die darin enthaltenen Klassen von
einer Adaptive Server-Installation in eine Clientdatei.
installjava Installiert eine JAR-Datei von einer Clientdatei in eine Adaptive Server-
Datenbank.
isql Interactive SQL-Parser von Adaptive Server.
optdiag Zeigt Optimiererstatistiken an oder lädt die aktualisierte Statistik in
Systemtabellen.
Dienstprogramme zum Sammeln von Informationen
Verwenden Sie die folgenden Dienstprogramme, um Informationen abzurufen:
showserver Zeigt die Adaptive Server- und Backup Server-Installationen auf UNIX-
Plattformen an, die derzeit auf dem lokalen Rechner ausgeführt werden.
wdllvers Liefert Informationen über die Sybase-DLLs (Dynamic Link Libraries)
in Windows NT, die im Speicher geladen sind.
Dienstprogramme 157

ackupserver
backupserver
Beschreibung Die Backup Server-Programmdatei unter $SYBASE/ASE-12_5/bin.
Windows NT Das Dienstprogramm heißt bcksrvr.exe unter
%SYBASE%\ASE-12_5\bin.
Syntax backupserver
[-C Server-Verbindungen]
[-S b_Servername]
[-I Interfaces-Datei]
[-e Fehlerlogdatei]
[-M sybmultbuf_Binärdaten]
[-N Netzwerk-Verbindungen]
[-T Trace-Wert]
[-L Sybase_Sprachenname]
[-J Sybase_Zeichensatzname]
[-c Band-Konfigurationsdatei]
[-D n]
[-A Pfadname]
[-P aktive_Dienst-Threads]
[-V Ebenen-Nummer]
[-p n]
[-m max_gemeinsam_genutzter_Speicher]
Oder
backupserver -v
Parameter -C Server-Verbindungen
legt die Anzahl der Serververbindungen zu Backup Server fest. Backup
Server benötigt:
Zwei Verbindungen für jede Sicherungssitzung
Eine Verbindung für jede Ladesitzung
Eine Verbindung für Datenträgerwechselmeldungen
Nehmen Sie als Maximum das Dreifache der Anzahl von erwarteten
gleichzeitigen Sicherungs- und Ladesitzungen. Der Standardwert ist 30.
-S b_Servername
gibt den Namen der Backup Server-Installation an, die gestartet werden soll.
Der Standard ist SYB_BACKUP. Dieser Eintrag muss den Namen eines
Backup Servers in der Interfaces-Datei angeben.
158 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-I Interfaces-Datei
gibt den Namen und Position der Interfaces-Datei an, die durchsucht werden
soll, wenn eine Verbindung mit Backup Server hergestellt wird. Wenn -I
weggelassen wird, sucht backupserver nach einer Datei namens interfaces
in dem Verzeichnis, auf das von Ihrer Sybase-Umgebungsvariablen
gezeigt wird.
-v
gibt die Versionsnummer und Copyright-Meldung der backupserver-
Software an und beendet dann.
-e Fehlerlogdatei
gibt den Namen und die Position der Fehlerlogdatei der Backup Server-
Installation an, die verwendet wird, um interne Open Server-Fehler,
sybmultbuf-Fehler und Fehler, die Backup Server anhalten, sowie Fehler bei
nicht verbundenen Sitzungen zu melden. Alle anderen Fehler werden an die
notify-Destination gesendet, die in den dump database-, dump transaction-,
load database- und load transaction-Befehlen angegeben wird.
-M sybmultbuf_Binärdaten
gibt den vollständigen Pfadnamen der sybmultbuf-Programmdatei an.
Verwenden Sie diesen Parameter nur, wenn Sie Backup Server von einem
anderen als dem bin-Verzeichnis im Sybase-Installationsverzeichnis starten,
oder wenn Sie eine Diagnose-Version von sybmultbuf verwenden.
-N Netzwerk-Verbindungen
gibt die Anzahl von Netzwerkverbindungen (DBPROCESS) an, die die
Master Backup Server-Installation herstellen kann. Der Standardwert ist 25.
-T Trace-Wert
interpretiert trace_value als Bitmaske (Basis-2 Zahl). Die 1 Bits in
trace_value entsprechen den Open Server Trace-Flags, die einzuschalten
sind. Wenn Sie mehr als einen -T-Parameter in der Befehlszeile angeben,
hebt der letzte -T-Wert die Werte von früheren -T-Parametern auf.
trace_value muss eine positive Ganzzahl sein.
-L Sybase_Sprachenname
gibt die Standardsprache von Backup Server an. Wenn dieser Parameter
nicht angegeben wird, benutzt Backup Server die Sprachumgebungskonfiguration,
die durch die Umgebungsvariablen LC_ALL oder LANG
festgelegt wurde. Wenn diese Variablen nicht eingestellt sind, sucht Backup
Server nach dem „default“-Eintrag in locales.dat.
Hinweis Der -L-Parameter hebt nicht den Wert auf, der in der LANG-
Umgebungsvariable eingestellt ist.
Dienstprogramme 159

ackupserver
-J Sybase_Zeichensatzname
gibt den Standard-Zeichensatz von Backup Server an.
-c Band-Konfigurationsdatei
gibt Namen und Position der Band-Konfigurationsdatei an, die nach
Banddevice-Konfigurationsinformation durchsucht wird, bevor ein dump
database oder ein dump transaction durchgeführt wird. Wenn Sie -c nicht
angeben, lautet der Standard-Pfadname für die Band-Konfigurationsdatei
$SYBASE/backup_tape.cfg.
-D n
gibt die Bitmaske (Zahl auf Basis 10) der Diagnose-Optionen an, die in
Backup Server verwendet werden.
-A Pfadname
legt den Pfadnamen zum Verzeichnis der dynamisch ladbaren Bibliothek der
Archiv-API fest.
-P aktive_Dienst-Threads
ermöglicht es Ihnen, die Anzahl der Sicherungseinheiten während mehrerer
Sicherungen/Wiederherstellungsvorgängen zu erhöhen (mit einem
Maximum von 12286 Sicherungseinheiten pro einzelnem Vorgang).
-V Ebenen-Nummer
beschränkt die Meldungen, die an das Backup Server-Fehlerlog ausgegeben
werden. Die Ebenen-Nummer-Variable bestimmt das Ausmaß der Fehler-
Ausführlichkeit (-V, Verbosität) bei Backup Server:
-V3 – zeigt nur Abschlussmeldungen für einen normalendump- oder load-
Befehl sowie die folgenden Meldungstypen an:
Fehlermeldungen von Backup Server und sybmultbuf
Andere sybmultbuf-Meldungen
Datenträgerwechsel-Meldungen
Open Server-Meldungen
Trace-Druckmeldungen
Informative Meldungen von den System & Tape Auto Config-Modulen
160 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-V2 – zeigt Folgendes an:
Alle -V3-Meldungen sowie
Meldungen zur Dateierstellung und zum Mounten von Datenträgern
-V1 – zeigt Folgendes an:
Alle -V2-Meldungen sowie
Phasenmeldungen
-V0 (Standardwert) – zeigt alle Meldungen an, einschließlich den
Sicherungsfortschritt betreffende.
Diese Beschränkung betrifft nicht Meldungen, die an den Client oder die
Konsole entsprechend dem NOTIFY=-Parameter in einem dump- oder load-
Befehl gesendet werden.
Diese Option hat auch keine Auswirkungen auf die Protokollierung
folgender Meldungstypen:
Open Server-Meldungen
Trace-Druckmeldungen von bs_traceprint
sybmultbuf-Meldungen
-p n
bestimmt die TDS-Paketgröße in Byte, die der lokale Backup Server
vom entfernten Backup Server während Netzwerk-Sicherungen anfordert.
Die tatsächlich verwendete Paketgröße wird durch den -p-Parameterwert
des entfernten Backup Servers limitiert. Wenn Sie -p nicht festlegen,
ist der Standardwert 2048 Byte. Die Paketgröße sollte eine Ganzzahl
größer oder gleich 256 sein.
-m max_gemeinsam_genutzter_Speicher
bestimmt den Maximalwert des gemeinsam genutzten Speichers in
Megabyte, den Backup Server für alle dump- oder load-Sitzungen
verwenden kann.
Syntax Starten Sie Backup Server mit dem startserver-Befehl und nicht,
indem Sie direkt das backupserver-Programm ausführen.
Um Standardwerte in UNIX zu ändern, bearbeiten Sie die
RUN_servername-Datei im Sybase-Installationsverzeichnis.
Weitere Hinweise finden Sie unter startserver in diesem Handbuch.
Um Standardwerte in Windows zu ändern, benutzen Sie Server
Config, um die Befehlszeilenparameter von Backup Server zu ändern.
In der Konfigurationsanleitung finden Sie weitere Hinweise.
Dienstprogramme 161

ackupserver
Stellen Sie sicher, dass die mit dem Sicherungsbefehl angegebenen
Devicetreiber-Optionen korrekt sind. Backupserver überprüft keine
Devicetreiber-Optionen, die Sie bei einem Sicherungsbefehl verwenden.
Wenn Sie beispielsweise eine Option angeben, die Backupserver zum
Rückspulen eines Bandes vor der Verwendung veranlasst, wird das Band
immer an den Anfang zurückgespult, anstatt das Band vom Punkt der
Sicherung zu lesen.
Wenn Sie einen Backup Server-Namen ohne den -S-Parameter angeben
und nicht die Umgebungsvariable DSLISTEN eingestellt haben,
verwendet backupserver den Backup Server-Standardnamen
SYB_BACKUP in UNIX.
In Windows NT – bcksrvr verwendet den Backup Server-Standardnamen
Server-Name_BS. Der Wert der Umgebungsvariablen DSLISTEN setzt
diesen Standardwert außer Kraft. Der -S-Parameter setzt den Standardwert
und den Wert in DSLISTEN außer Kraft.
Soweit wie möglich, sollte der Backup Server und Adaptive Server, die
ihre Datenbanken und Transaktionslogs direkt über diesen Backup Server
sichern und wiederherstellen, dieselbe Interfaces-Datei (sql.ini in UNIX)
benutzen. Die Interfaces-Datei, die der Backup Server verwendet, muss
Einträge zu folgenden Komponenten enthalten:
Backup Server
Jeden anderen Backup Server, mit dem dieses Backup Server-System
kommuniziert
Trace-Flags sorgen dafür, dass Backup Server Informationen über seine
Tätigkeiten ausgibt, um die Suche nach Fehlern im Backup Server-System
zu ermöglichen. Weitere Hinweise über Trace-Flags finden Sie in der
Dokumentation Open Server Server-Library/C Reference Manual.
Backup Server unterstützt nicht den Gebrauch der Open
Server-definierten SRV_TR-Symbole für -T.
Wenn Backup Server die Verzeichnisse locales und charsets, die in den -L-
und -J-Parametern angegeben wurden, nicht finden kann, oder wenn diese
Parameter eine ungültige Sprach- und Zeichensatzkombination enthalten,
gibt Backup Server eine Fehlermeldung aus und verwendet die
Standardsprache und den Standardzeichensatz.
162 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Backup Server kann zwischen Servern, die unterschiedliche logische
Seitengrößen verwenden, keine Lade- oder Sicherungsvorgänge
durchführen. Sie können beispielsweise eine Datenbanksicherung mit
einer logischen Seitengröße von 4 KByte auf einen anderen Server mit
der logischen Seitengröße von 4 KByte laden. Backup Server unterstützt
jedoch nicht die Sicherung einer Datenbank mit einer logischen
Seitengröße von 4 KByte in das anschließende Laden in eine
Datenbank mit einer logischen Seitengröße von 16 KByte.
Berechtigungen Jeder mit Ausführungsberechtigung auf die Binärdaten, der Lese/Schreib-
Zugriff auf alle Dateien hat.
Siehe auch Dienstprogramme startserver
Dienstprogramme 163

cp
bcp
Beschreibung Kopiert eine Datenbanktabelle aus einer oder in eine Betriebssystemdatei
in einem vom Benutzer festgelegten Format. bcp befindet sich unter
$SYBASE/$SYBASE_OCS/bin.
Windows NT Das Dienstprogramm heißt bcp.exe und befindet sich unter
%SYBASE%\%SYBASE_OCS%\bin.
Syntax bcp [[Datenbankname.]Eigentümer.]Tabellenname [:Scheibennummer] {in |
out} Datendatei
[-m max-Fehler]
[-f Formatdatei]
[-e Fehlerdatei]
[-F erste_Zeile]
[-L letzte_Zeile]
[-b Anweisungsfolgengröße]
[-n]
[-c]
[-t Feld-Abschlusszeichen]
[-r Zeilen-Abschlusszeichen]
-U Benutzername
[-P Kennwort]
[-I Interfaces-Datei]
[-S Server]
[-a Anzeige-Zeichensatz]
[-z Sprache]
[-A Paketgröße]
[-J Client-Zeichensatz]
[-T text_oder_image_Größe]
[-E]
[-g ID_Anfangswert]
[-N]
[-X]
[-K Keytab-Datei]
[-R entfernter_Hauptserver]
[-V [Sicherheitsoptionen]]
[-Z Sicherheitsmechanismus]
[-Q]
[-Y]
Oder
bcp -v
Parameter Datenbankname
ist ein wahlweiser Parameter, wenn sich die kopierte Tabelle in Ihrer
Standard-Datenbank oder in master befindet. Ansonsten müssen Sie
den Datenbanknamen angeben.
164 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Eigentümer
ist fakultativ, wenn Ihnen oder dem Datenbankeigentümer die Tabelle
gehört, die kopiert wird. Wenn Sie keinen Eigentümer angeben, sucht bcp
zuerst nach einer Tabelle dieses Namens, die Ihnen gehört, und dann nach
einer, die dem Datenbankeigentümer gehört. Wenn die Tabelle einem
anderen Benutzer gehört, müssen Sie den Namen des Eigentümers angeben,
oder der Befehl schlägt fehl.
Ansichtsname
ist der Name der Ansicht, aus der Sie kopieren.
Tabellenname
ist der Name der Datenbanktabelle, die Sie kopieren wollen. Der
Tabellenname darf kein reserviertes Wort der Transact-SQL-Sprache sein.
Die Partitionsnummer Partition_Nummer ist in der Tabellenname-Tabelle
nicht vorhanden.
Scheibennummer
ist die Nummer der Scheibe der zu kopierenden Datenbanktabelle.
Partition_ID
ist der Bezeichner der Partition, in die Sie kopieren.
in | out
ist die Richtung der Kopie. in bedeutet eine Kopie von einer Datei in
die Datenbanktabelle; out bedeutet eine Kopie in eine Datei aus der
Datenbanktabelle oder Ansicht.
Datendatei
ist der vollständige Pfadname einer Betriebssystemdatei. Der Pfadname
darf 1 - 255 Zeichen lang sein.
-m max-Fehler
ist die zulässige Höchstzahl an nicht schwerwiegenden Fehlern, bevor bcp
den Kopiervorgang abbricht. bcp verwirft jede Zeile, die das Programm
nicht einfügen kann (wegen eines Datenkonvertierungsfehlers oder wegen
eines Versuchs, einen Nullwert in eine Spalte einzufügen, die keine
Nullwerte zulässt), wobei jede verworfene Zeile als Fehler gezählt wird.
Wenn Sie diesen Parameter nicht angeben, verwendet bcp den
Standardwert 10.
Dienstprogramme 165

cp
-f Formatdatei
ist der vollständige Pfadname einer Datei mit gespeicherten Antworten,
die bei der letzten Ausführung von bcp auf derselben Tabelle geschrieben
wurden. Nachdem Sie die Formatfragen von bcp beantwortet haben, werden
Sie gefragt, ob Sie die Antworten in einer Formatdatei speichern wollen.
Die Erstellung der Formatdatei ist fakultativ. Der Standard-Dateiname ist
bcp.fmt. Das bcp-Programm kann eine Formatdatei beim Kopieren von
Daten als Informationsquelle benutzen. Sie ersparen sich dadurch die
wiederholte Eingabe von Formatinformationen. Verwenden Sie den -f-
Parameter nur, wenn Sie bereits eine Formatdatei erstellt haben, die Sie
jetzt für Ihre Kopiervorgänge verwenden wollen. Wenn Sie diesen
Parameter nicht angeben, werden Sie von bcp interaktiv nach
Formatinformationen abgefragt.
-e Fehlerdatei
ist der vollständige Pfadname einer Fehlerdatei, in der bcp Zeilen speichert,
die nicht von der Datei in die Datenbank übertragen werden konnten.
Fehlermeldungen von bcp werden auf Ihrem Bildschirm angezeigt. bcp
erstellt nur eine Fehlerdatei, wenn Sie diesen Parameter benutzen.
-F erste_Zeile
ist die Nummer der ersten Zeile, die von einer Eingabedatei kopiert werden
soll (Standard ist die erste Zeile).
Verwenden Sie die -F-Option nicht, um umfangreiche und komplizierte
Kopiervorgänge durchzuführen, da dadurch bcp im Allgemeinen langsamer
läuft. Statt dessen verwenden Sie -F bei ein-prozessigen Ad-hoc-
Kopiervorgängen.
-L letzte_Zeile
ist die Nummer der letzten Zeile, die von einer Eingabedatei kopiert werden
soll (Standard ist die letzte Zeile).
166 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-b Anweisungsfolgengröße
ist die Anzahl der Zeilen pro Anweisungsfolge der kopierten Daten
(Standard ist, alle Zeilen in eine Anweisungsfolge zu kopieren). Die
Anweisungsfolgefunktion gilt nur, wenn Sie mit dem Massenexport/-import
Daten in eine Tabelle kopieren. Sie hat keine Wirkung, wenn Sie Daten
aus einer Tabelle herauskopieren. Die kleinste Zahl, die bcp für
Anweisungsfolgengröße annimmt, ist 1.
Hinweis Das Einstellen der Anweisungsfolgengröße auf 1 bewirkt, dass
der Adaptive Server einer Datenseite jeweils eine importierte Zeile zuweist.
Diese Option gilt nur bei schnellem bcp und ist nur für das Auffinden von
fehlerhaften Datenzeilen geeignet. Verwenden Sie -b1 mit Vorsicht. Dadurch
wird jeder einzelnen Zeile eine neue Seite zugewiesen, was eine schlechte
Platzausnutzung bedeutet.
-n
führt den Kopiervorgang durch, indem native (Betriebssystem-) Formate
verwendet werden. Das Angeben des -n-Parameters bedeutet, dass bcp
keine Eingabeaufforderung für die einzelnen Felder angibt. Dateien im
Betriebssystem-Datenformat sind für den Benutzer nicht lesbar.
Achtung! Verwenden Sie bcp im ursprünglichem Format nicht bei der Daten-
Wiederherstellung oder um einen Notfall zu beheben. Verwenden Sie bcp
im ursprünglichem Format nicht, um Daten zwischen unterschiedlichen
Hardware-Plattformen, unterschiedlichen Betriebssystemen oder
verschiedenen Versionen von Adaptive Server zu transportieren. Verwenden
Sie keine Feldabschlusszeichen (-t) oder Zeilenabschlusszeichen (-r) mit bcp
im ursprünglichen Format. Die Ergebnisse sind nicht vorhersehbar und die
Daten könnten beschädigt werden. Das Verwenden von bcp im nativen
Format kann unbrauchbare Dateien erstellen, die nicht in den Adaptive
Server zurückgeladen werden können, und es ist möglicherweise unmöglich,
diese Daten wiederherzustellen. Wenn Sie nicht in der Lage sind, bcp in
Zeichenformat zurückzuverwandeln (weil zum Beispiel eine Tabelle gekürzt
oder gelöscht wurde, eine Hardware-Beschädigung auftrat, eine Datenbank
gelöscht wurde usw.), sind die Daten nicht wiederherstellbar.
Dienstprogramme 167

cp
-c
führt den Kopiervorgang mit dem char-Datentyp als Standard-Speichertyp
für alle Spalten in der Datendatei durch. Verwenden Sie dieses Format,
wenn Daten auf verschiedenen Plattformen benutzt werden. Dieser
Parameter fordert Sie nicht zur Eingabe in jedes Feld auf; er verwendet
char als Standardspeichertyp, keinen Präfix, \t (Tabulator) als Standard-
Feldabschlusszeichen und \n (Neue Zeile) als Standard-
Zeilenabschlusszeichen.
-t Feld-Abschlusszeichen
legt das Standard-Feldabschlusszeichen fest.
-r Zeilen-Abschlusszeichen
legt das Standard-Zeilenabschlusszeichen fest.
Achtung! Verwenden Sie nicht die -t- oder -r-Parameter mit bcp im
ursprünglichen Format. Die Ergebnisse sind nicht vorhersehbar und die
Daten könnten beschädigt werden.
Wenn Sie Abschlusszeichen von der Befehlszeile mit dem -t- oder -r-
Parameter, angeben, müssen Sie Escape-Zeichen bei Zeichen verwenden,
die eine besondere Bedeutung für das UNIX-Betriebssystem (oder die
Befehlseingabeaufforderung-Shell unter Windows NT) haben. Weitere
Hinweise finden Sie bei den bcp-Beispielen. Entweder stellen Sie einen
Rückstrich voran oder schließen das Zeichen in Anführungszeichen ein.
Das ist nicht nötig, wenn bcp zur Eingabe auffordert (interaktiver Modus).
-U Benutzername
gibt einen Adaptive Server-Login-Namen an.
-P Kennwort
gibt ein Adaptive Server-Kennwort an. Wenn Sie -PKennwort, nicht
angeben, fordert bcp zur Eingabe eines Kennworts auf. Sie können die
-P-Option weglassen, wenn Ihr Kennwort NULL ist.
-I Interfaces-Datei
gibt den Namen und Position der Interfaces-Datei an, die durchsucht werden
soll, wenn eine Verbindung mit Adaptive Server hergestellt wird. Wenn
Sie -I, nicht angeben, sucht bcp nach einer Interfaces-Datei (sql.ini in
Windows NT), die sich unter dem Verzeichnis befindet, das durch die
SYBASE-Umgebungsvariable (ini-Verzeichnis in Windows NT)
definiert ist.
168 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-S Server
gibt den Namen der Adaptive Server-Installation an, mit dem die
Verbindung hergestellt werden soll. Wenn Sie -S ohne Argument
angeben, verwendet bcp die Installation, die durch die DSQUERY-
Umgebungsvariable festgelegt wird.
-a Anzeige-Zeichensatz
ermöglicht es Ihnen bcp von einem Terminal auszuführen, auf dem sich der
Zeichensatz von dem des Rechners unterscheidet, auf dem bcp läuft. -a in
Verbindung mit -J gibt die Zeichensatzkonvertierungs-Datei (.xlt-Datei) an,
die für die Konvertierung erforderlich ist. Verwenden Sie -a ohne -J nur
dann, wenn der Client-Zeichensatz mit dem Standardzeichensatz
identisch ist.
Die folgende Fehlermeldung wird angezeigt, wenn die Zeichenübersetzungsdateien,
die mit dem -a-Parameter genannt werden, fehlen, oder wenn
Sie die Namen falsch eingegeben haben:
Fehler beim Versuch, die Größe eines
Konvertierungstabellenpaars zu bestimmen.:'stat'-
Dienstprogramm fehlgeschlagen.
-z Sprache
ist der offizielle Name einer Alternativsprache, die der Server zur Anzeige
von bcp-Eingabeaufforderungen und Meldungen verwendet. Ohne die -z-
Option verwendet bcp die Standardsprache des Servers.
Sie können einem Adaptive Server-System während der Installation oder
später entweder mit dem langinstall-Dienstprogramm (bzw. langinst in
Windows NT) oder der gespeicherten Prozedur sp_addlanguage andere
Sprachen hinzufügen.
Die folgende Fehlermeldung wird angezeigt, wenn eine inkorrekte oder
nicht erkannte Sprache mit dem -z-Parameter angeführt wird:
Nicht erkanntes Sprachlokalisierungsobjekt. Standardwert 'iso_1' wird
verwendet.Kopiervorgang beginnt...
=> Warnung.
-v
zeigt die Versionsnummer und Copyright-Meldung für bcp an und kehrt
zum Betriebssystem zurück.
Dienstprogramme 169

cp
-A Paketgröße
gibt die Netzwerk-Paketgröße an, die in dieser bcp-Sitzung verwendet
werden soll. Beispiel:
bcp pubs2..titles out table_out -A 2048
Mit dieser Eingabe wird die Paketgröße für diese bcp-Sitzung auf 2048 Byte
gesetzt. Paketgröße muss zwischen den Werten der Konfigurationsparameter
default network packet size und maximum network packet size liegen und
ein Vielfaches von 512 sein.
Verwenden Sie Netzwerk-Paketgrößen, die größer als der Standard sind,
um die Performance von umfangreichen Massenexporten/-importen zu
verbessern.
-J Client-Zeichensatz
gibt den Zeichensatz an, der auf dem Client verwendet wird. bcp verwendet
einen Filter, um die Eingabe zwischen Clientzeichensatz und dem Adaptive
Server-Zeichensatz zu konvertieren.
-J Client-Zeichensatz verlangt, dass Adaptive Server in und von Client-
Zeichensatz, dem auf dem Client verwendeten Zeichensatz, konvertiert.
-J ohne Argument stellt die Zeichensatzkonvertierung auf NULL. Es findet
keine Konvertierung statt. Verwenden Sie diese Einstellung, wenn Client
und Server denselben Zeichensatz verwenden.
Das Weglassen von -J stellt den Zeichensatz auf einen Standardwert der
Plattform ein, der nicht unbedingt der Zeichensatz ist, den der Client
verwendet. Tabelle 8-2 listet die Plattform-Standardwerte auf.
Tabelle 8-2: Standard-Zeichensätze für verschiedene Plattformen
Plattform Standard-Zeichensatz
Sun Solaris, Digital UNIX, NCR, RS/6000 iso_1
HP-UX roman8
OS/2, Novell NetWare 386 cp850
Macintosh mac
Die folgende Fehlermeldung wird angezeigt, wenn eine inkorrekter oder
nicht erkannter Zeichensatz mit dem -J-Parameter angeführt wird:
Nicht erkanntes Sprachlokalisierungsobjekt. Standardwert 'iso_1' wird
verwendet.Kopiervorgang beginnt...
=> Warnung.
Weitere Hinweise über Zeichensätze und zugeordnete Optionen finden Sie
in der Dokumentation Systemadministration für Adaptive Server Enterprise.
170 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-T text_oder_image_Größe
ermöglicht es Ihnen, die maximale Länge in Byte von text- oder image-
Daten anzugeben, die Adaptive Server versendet. Standard ist 32 KByte.
Wenn ein text- oder ein image-Feld größer als der Wert von -T oder der
Standardwert ist, sendet bcp den Rest nicht.
-E
gibt explizit den Wert der Identity-Spalte einer Tabelle an.
Wenn Sie mit dem Massenexport/-import Daten in eine Tabelle mit einer
Identity-Spalte kopieren, ordnet bcp standardmäßig jeder Zeile einen
temporären Identity-Spaltenwert von 0 zu. Das gilt nur, wenn Sie Daten
in eine Tabelle kopieren. bcp liest die Werte für die ID-Spalte aus der
Datendatei, sendet ihn aber nicht an den Server. Während bcp jede Zeile in
die Tabelle einfügt, ordnet ihr der Server einen eindeutigen, sequenziellen
Identity-Spaltenwert zu, beginnend mit dem Wert 1. Wenn Sie die -E-Option
angeben und Daten in eine Tabelle kopieren, liest bcp den Wert aus der
Datendatei und sendet ihn an de Server, der den Wert in die Tabelle einfügt.
Wenn dabei der höchstmögliche Identity-Zeilenwert überschritten wird, gibt
Adaptive Server einen Fehler aus.
Der -E-Parameter hat keine Wirkung, wenn Sie mit dem Massenexport/import
Daten aus einer Tabelle kopieren. Adaptive Server kopiert die
ID-Spalte in die Datendatei, außer Sie verwenden den -N-Parameter.
Sie können die -E- und -g-Optionen nicht zusammen verwenden.
-g ID_Anfangswert
gibt den Wert der Identity-Spalte an, der als Ausgangspunkt des
Datenkopiervorgangs verwendet werden soll.
Sie können die -g- und -E-Optionen nicht zusammen verwenden.
-N
überspringt die Identity-Spalte. Verwenden Sie diese Option, wenn Sie
Daten in eine Tabelle kopieren und Ihre Host-Datendatei keinen Platzhalter
für die Identity-Spaltenwerte enthält, oder wenn Sie Daten aus der Tabelle
herauskopieren und die Identity-Spalteninformation in der Host-Datei nicht
enthalten sein soll.
Sie können beim Importieren von Daten nicht sowohl den -N- als auch den
-E-Parameter verwenden.
Dienstprogramme 171

cp
-X
gibt an, dass das Login in dieser Verbindung zum Server mit
Kennwortverschlüsselung durch den Client hergestellt werden soll. bcp
(der Client) gibt dem Server bekannt, dass die Kennwortverschlüsselung
gewünscht wird. Der Server sendet einen Verschlüsselungsschlüssel zurück,
den bcp zur Verschlüsselung Ihres Kennworts verwendet, und der Server
verwendet den Schlüssel, um die Zugangserlaubnis Ihres Kennworts zu
überprüfen, wenn es ankommt.
Wenn bcp ausfällt, erstellt das System eine Core-Datei, die Ihr Kennwort
enthält. Wenn Sie die Verschlüsselungsoption nicht verwendet haben,
wird Ihr Kennwort als normaler Text in der Datei angezeigt. Wenn Sie
die Verschlüsselungsoption verwenden, ist Ihr Kennwort nicht lesbar.
-K Keytab-Datei
gibt den Pfad zur Keytab-Datei an, die zur Authentifizierung in DCE
verwendet wird.
-R entfernter_Hauptserver
legt den Hauptnamen für den Server fest, wie vom Sicherheitsmechanismus
definiert. Standardmäßig entspricht der Hauptname dem Netzwerknamen
des Servers (der mit dem -S-Parameter oder der DSQUERY-Umgebungsvariablen
angegeben wird). Verwenden Sie den -R-Parameter, wenn der
Hauptname des Servers nicht mit seinem Netzwerknamen übereinstimmt.
-V Sicherheitsoptionen
legt eine netzbasierte Benutzer-Authentifizierung fest. Bei dieser Option
muss sich der Benutzer beim Sicherheitssystem des Netzwerks anmelden,
bevor er das Dienstprogramm ausführt. In diesem Fall muss der Benutzer
den Netzwerk-Benutzernamen mit der-U-Option angeben; ein mit der -P-
Option angegebenes Kennwort wird ignoriert.
-V – Auf diesen Parameter kann eine Sicherheitsoptionen-Zeichenfolge
folgen, die Schlüsselzeichen für die Aktivierung zusätzliche
Sicherheitsdienste enthalten. Es gibt folgende Schlüsselzeichen:
c – Datenvertraulichkeitsdienst aktivieren
c – Datenintegritätsdienst aktivieren
m – Gegenseitige Authentifizierung für Verbindungserstellung
aktivieren
c – Abzeichnungsdienst für Datenursprung aktivieren
r – Datenwiedergabeermittlung aktivieren
q – Feststellung von Fehlern in der Sequenzreihenfolge aktivieren
172 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-Z Sicherheitsmechanismus
legt den Namen eines Sicherheitsmechanismus fest, der bei der Verbindung
verwendet werden soll.
Namen für Sicherheitsmechanismen sind in der Konfigurationsdatei
$SYBASE/install/libtcl.cfg festgelegt. Wenn kein Name für den
Sicherheitsmechanismus angegeben ist, wird der Standardmechanismus
verwendet. Weitere Hinweise zu Namen für den Sicherheitsmechanismus
entnehmen Sie der Beschreibung der libtcl.cfg-Datei in der Dokumentation
Open Client/Server Configuration Guide.
-Q
liefert Rückwärtskompatibilität mit der bcp-Version 10.0.4 bei
Kopiervorgängen mit Spalten, die NULL-Werte aufnehmen können.
-Y
gibt an, dass die Zeichensatzkonvertierung auf dem Server deaktiviert ist
und statt dessen von bcp auf der Client-Seite durchgeführt wird, wenn bcp
IN verwendet wird.
Hinweis Die gesamte Zeichensatzkonvertierung erfolgt auf dem Server bei
Verwendung von bcp OUT.
Beispiele Beispiel 1 Es werden Daten aus der publishers-Tabelle im Zeichenformat
(unter Verwendung von char bei allen Feldern) kopiert, wobei der -c-Parameter
verwendet wird. Der Parameter -t Feld-Abschlusszeichen beendet jedes Feld
mit einem Komma, und der Parameter -r Zeilen-Abschlusszeichen beendet
jede Zeile mit einer Zeilenschaltung. bcp fordert nur zur Eingabe eines
Kennworts auf:
Auf UNIX-Plattformen – Der erste Rückstrich vor dem letzten „r“ ist ein
Escape-Zeichen für den zweiten, wodurch nur der Rückstrich gedruckt wird.
bcp pubs2..publishers out pub_out -c -t , -r \\r
Unter Windows NT:
bcp pubs2..publishers out pub_out -c -t , -r \r
Dienstprogramme 173

cp
Beispiel 2 Es werden Daten aus der Tabelle publishers in eine Datei namens
pub_out kopiert, die später wieder in die Adaptive Server-Installation eingelesen
werden soll. Mit der Eingabetaste bestätigen Sie die Standardwerte, die von
der Eingabeaufforderung angezeigt werden. Dieselben Eingabeaufforderungen
werden angezeigt, wenn Daten in die Tabelle publishers kopiert werden:
bcp pubs2..publishers out pub_out
Kennwort:
Dateispeichertyp für das Feld pub_id [char] eingeben:
Präfixlänge des Feldes pub_id [0] eingeben:
Länge des Feldes pub_id [4] eingeben:
Feldabschlusszeichen eingeben [keines]:
Dateispeichertyp für das Feld pub_name [char] eingeben:
Präfixlänge des Feldes pub_name [1] eingeben:
Länge des Feldes pub_name [40] eingeben:
Feldabschlusszeichen eingeben [keines]:
Dateispeichertyp für das Feld city [char] eingeben:
Präfixlänge des Feldes city [1] eingeben:
Länge des Feldes city [20] eingeben:
Feldabschlusszeichen eingeben [keines]:
Dateispeichertyp für das Feld state [char] eingeben:
Präfixlänge des Feldes state [1] eingeben:
Länge des Feldes state [2] eingeben:
Feldabschlusszeichen eingeben [keines]:
Unter UNIX werden Sie Folgendes gefragt:
Wollen Sie diese Formatinformationen in eine
Datei speichern? [Y-n] y
Host-Dateiname [bcp.fmt]: pub_form
Kopiervorgang beginnt...
3 Zeilen kopiert.
Uhrzeit (ms.): Summe = 1 Durchschnitt = 0 (3000.00
Zeilen pro Sek.)
Beispiel 3 Hier werden Daten zurück in die Adaptive Server-Installation
kopiert, indem die gespeicherte Formatdatei pub_form verwendet wird:
bcp pubs2..publishers in pub_out -f pub_form
174 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beispiel 4 Geben Sie den einzelnen Buchstaben genauso ein, wie er unten
dargestellt ist.
Um Beispiele von Datentypen anzuzeigen, geben Sie "?"
an der Eingabeaufforderung ein:
Dateispeichertyp des Feldes 'pub_id' eingeben
['char']:?
Unzulässiger Spaltentyp. Gültige Typen sind:
: gleicher Typ wie Adaptive Server-Spalte.
c : char
T : text
i : int
s : smallint
t : tinyint
f : float
m : money
b : bit
d : datetime
x : binary
I : image
D : smalldatetime
r : real
M : smallmoney
n : numeric
e : decimal
Beispiel 5 Hier wird eine Datendatei, die mit einem Zeichensatz
erstellt wurde, wie er auf einem VT200-Terminal verwendet wird, in die
pubs2..publishers-Tabelle kopiert. Die -z-Option zeigt bcp-Meldungen auf
Französisch an:
bcp pubs2..publishers in vt200_data -J iso_1 -z french
Beispiel 6 Nur UNIX-Plattformen – Hier wird angegeben, dass Sie einen
Macintosh verwenden und bcp auf einer Workstation mit dem Zeichensatz
roman8 ausführen:
bcp pubs2..publishers in -a mac -J roman8
Beispiel 7 Legt fest, dass Adaptive Server 40 KByte text- oder image-Daten
mit einer Paketgröße von 4096 Byte sendet:
bcp pubs2..publishers out -T 40960 -A 4096
Syntax Verwenden Sie diese Syntax bei bcp_r, wenn Sie Thread-Treiber
verwenden.
Verwenden Sie diese Syntax bei bcp_dce, wenn Sie Thread-Treiber auf
der IBM-Plattform verwenden.
Dienstprogramme 175

cp
Die aktuelle Version von bcp ignoriert den Parameter -y sybase_directory.
Sie können nicht Named Pipes verwenden, um Dateien zu kopieren.
Das Fehlermeldungsformat unterscheidet sich von den früheren Versionen
von bcp. Wenn Sie Skripten haben, die Routinen aufgrund der Werte dieser
Meldungen ausführen, werden Sie sie möglicherweise umschreiben
müssen. Zum Beispiel:
Die Anzeigemeldung, die die Anzahl von
transferierten Zeilen angibt, wurde geändert.
Diese Version von bcp meldet während einer Sitzung
regelmäßig die laufenden Summen von übertragenen
Zeilen. Diese Meldung ersetzt die Meldung "1000 rows
transferred", angezeigt vom früheren bcp.
Berechtigungen Um bcp verwenden zu können, müssen Sie ein Adaptive Server-Konto und die
entsprechenden Berechtigungen für die Datenbanktabellen oder Ansichten und
Betriebssystemdateien haben, die Sie übertragen werden.
Um Daten in eine Tabelle kopieren zu können, müssen Sie die insert-
Berechtigung für die Tabelle haben.
Um eine Tabelle in eine Betriebssystemdatei kopieren zu können,
müssen Sie die select-Berechtigung für folgende Tabellen haben:
die zu kopierende Tabelle
sysobjects
syscolumns
sysindexes
Benutzte Tabellen sysaudits_01 – sysaudits_08
Siehe auch Im Kapitel 3, „Daten mit bcp in und aus Adaptive Server übertragen“,
finden Sie eine ausführliche Erläuterung des Programms bcp.
In der Dokumentation Performance and Tuning Guide finden Sie weitere
Informationen darüber, wie sich eine Änderung bestimmter Parameter auf bcp
bei umfangreichen Anweisungsfolgen auswirken kann.
Befehle insert
Systemprozeduren sp_audit, sp_dboption, sp_displayaudit
176 Adaptive Server Enterprise

uildmaster
Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beschreibung Adaptive Server Version 12.5 verwendet nicht die buildmaster-Binärdaten,
um das Master-Device einzurichten. Statt dessen hat Sybase die buildmaster-
Funktionalität in dataserver integriert. Weitere Hinweise finden Sie im
Kapitel 1, „Server mit dem dataserver-Dienstprogramm einrichten“,
und Syntaxinformationen finden Sie unter dataserver auf Seite 188.
Syntax Keine.
certauth
Beschreibung Konvertiert eine Server-Zertifikatsanforderung in ein Zertifikat mit
CA-Berechtigung (Certificate Authority). Standort ist
$SYBASE/ASE-12_5/bin.
Windows NT Das Dienstprogramm heißt certauth.exe und befindet sich in
%SYBASE%\ASE-12_5\bin.
Syntax certauth
[-r]
[-C caCert-Datei]
[-Q Anforderung-Dateiname]
[-K caKey-Dateiname]
[-O SignedCert-Dateiname]
[-P ca-Kennwort]
[-T Gültigkeitsdauer]
Parameter -r
Oder
certauth -v
wenn angegeben, wird ein selbst unterschriebenes Stamm-Zertifikat für die
Test-Umgebung erstellt.
-C caCert-Datei
gibt den Namen der CA-Zertifikatsanforderungsdatei an, wenn -r angegeben
ist; oder es bestimmt den Namen des CA-Stamm-Zertifikats.
-Q Anforderung-Dateiname
gibt den Namen der Zertifikatsanforderungsdatei an.
-K caKey-Dateiname
gibt den Namen des privaten CA-Schlüssels an.
Dienstprogramme 177

certauth
-O SignedCert-Dateiname
gibt den Namen für die Ausgabe an, wenn eine unterschriebene
Zertifikatsdatei erstellt wird. Wenn -r angegeben ist, ist SignedCert-
Dateiname das selbst unterschriebene Stammzertifikat. Wenn die -r-Option
nicht verwendet wird, ist SignedCert-Dateiname das Zertifikat, das von der
caCert-Datei unterschrieben wird.
-P ca-Kennwort
gibt das CA-Kennwort an, mit dem der private Schlüssel entschlüsselt wird.
-T Gültigkeitsdauer
legt den gültigen Zeitbereich für ein unterschriebenes Zertifikat fest.
Die Gültigkeitsdauer wird in Tageseinheiten gezählt.
-v
gibt die Versionsnummer und Copyright-Meldung für das certauth-Tool an
und beendet das Programm dann.
Beispiele Beispiel 1 Dieses Beispiel konvertiert die CA-Zertifikatsanforderung
(ca_req.txt) in ein Zertifikat, wobei der private Schlüssel (ca_pkey.txt)
verwendet wird. Der private Schlüssel wird geschützt, indem das Kennwort
angegeben wird. Dieses Beispiel setzt die Gültigkeitsdauer auf 365 Tage,
unterschreibt das Zertifikat selbst und gibt es als ein Stamm-Zertifikat
(trusted.txt) aus:
certauth -r -C ca_req.txt -Q ca_req.txt
-K ca_pkey.txt -P password -T 365 -O trusted.txt
Das Dienstprogramm gibt folgende Meldung zurück:
-- Sybase Test Certificate Authority --
Certificate Validity:
startDate = Tue Sep 5 10:34:43 2000
endDate = Wed Sep 5 10:34:43 2001
CA sign certificate SUCCEED (0)
Hinweis Sie brauchen ein vertrauenswürdiges Stamm-Zertifikat für den CA-
Test nur einmal zu erstellen. Nachdem Sie das vertrauenswürdige Stamm-
Zertifikat erstellt haben, können Sie damit mehrere Server-Zertifikate in Ihrer
Test-Umgebung unterschreiben.
178 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beispiel 2 Dieses Beispiel konvertiert eine Server-Zertifikatsanforderung
(srv5_req.txt) in ein Zertifikat und legt eine Gültigkeitsdauer von 180 Tagen
fest. Es unterschreibt das Zertifikat mit einem CA-Zertifikatsschlüssel
(trusted.txt und einem privaten Schlüssel ca_pkey.txt), verwendet
Kennwortschutz und gibt das unterschriebene Zertifikat als sybase_srv5.crt
zurück:
certauth -C trusted.txt -Q srv5_req.txt
-K ca_pkey.txt -P password -T 180 -O sybase_srv5.crt
Hinweis Wenn Sie keine Gültigkeitsdauer angeben, beträgt der Standardwert
365 Tage.
Das Dienstprogramm gibt folgende Meldung zurück:
-- Sybase Test Certificate Authority --
Certificate Validity:
startDate = Tue Sep 5 10:38:32 2000
endDate = Sun Mar 4 09:38:32 2001
CA sign certificate SUCCEED (0)
Untenstehend finden Sie ein Muster-Zertifikat. Im folgenden Syntax-Abschnitt
finden Sie zusätzliche Schritte, um ein Server-Zertifikat zu erstellen, das der
Server verwenden kann.
-----BEGIN CERTIFICATE-----
MIICSTCCAgUCAVAwCwYHKoZIzjgEAwUAMG8xCzAJBgNVBAYTAlVTMRMwEQYDVQQI
EwpDYWxpZm9ybmlhMRMwEQYDVQQHEwpFbWVyeXZpbGxlMQ8wDQYDVQQKFAZTeWh
c2UxDDAKBgNVBAsUA0RTVDEXMBUGA1UEAxQOc3liYXNlX3Rlc3RfY2EwHhcNMDAw
ODE4MTkxMzM0WhcNMDEwODE4MTkxMzM0WjBvMQswCQYDVQQGEwJVUzETMBEGAUE
CBMKQ2FsaWZvcm5pYTETMBEGA1UEBxMKRW1lcnl2aWxsZTEPMA0GA1UEChQGU3li
YXNlMQwwCgYDVQQLFANEU1QxFzAVBgNVBAMUDnN5YmFzZV90ZXN0X2NhMIHwMIo
BgcqhkjOOAQBMIGcAkEA+6xG7XCxiklxbP96nHBnQrTLTCjHlcy8QhIekwv9OlqG
EMG9AjJLxj6VCkPOD75vqVMEkaPPjoIbXEJEe/aYXQIVAPyvY1+B9phC2e2YFcf7
cReCcSNxAkBHt7rnOJZ1Dnd8iLQGt0wd1w4lo/Xx2OeZS4CJW0KVKkGId1hNGz8r
GrQTspWcwTh2rNGbXxlNXhAV5g4OCgrYA0MAAkA70uNEl90Kmhdt3RISiceCMgOf
1J8dgtWF15mcHeS8OmF9s/vqPAR5NkaVk7LJK6kk7QvXUBY+8LMOugpJf/TYMAsG
ByqGSM44BAMFAAMxADAuAhUAhM2Icn1pSavQtXFzXJUCoOmNLpkCFQDtE8RUGuo8
ZdxnQtPu9uJDmoBiUQ==
-----END CERTIFICATE-----
Dienstprogramme 179

certpk12
Syntax Um eine Server-Zertifikatsdatei zu erstellen, die Adaptive Server
akzeptiert, hängen Sie den privaten Schlüssel des Zertifikat-Anforderers
am Ende der unterschriebenen Zertifikatsdatei an. Im obenstehenden
Beispiel 2 würden Sie mit Ausschneiden und Einfügen srv5_pkey.txt an
das Ende der unterschriebenen Zertifikatsdatei sybase_srv5.crt anfügen.
Um eine vertrauenswürdige Stammdatei zu erstellen, die der Server beim
Starten laden kann, benennen Sie trusted.txt um in sybase_srv5.txt, wobei
sybase_srv5.txt der allgemeine Name des Servers ist.
Dann kopieren Sie die sybase_srv5.txt-Datei in das Adaptive Server-
Installationsverzeichnis, zum Beispiel $SYBASE/$SYBASE_ASE/
certificates.
Die Datei, die für einen auf SSL basierende Sitzung erforderlich ist, wird
verwendet, um die SSL-aktivierte Adaptive Server-Installation zu starten.
Nachdem das CA-Stamm-Zertifikat erstellt ist, können Sie damit mehrere
Server-Zertifikate unterschreiben.
Siehe auch Dienstprogramme certpk12, certreq
certpk12
Beschreibung Exportiert oder importiert eine PKCS #12-Datei in eine Zertifikatsdatei und
einen privaten Schlüssel. Standort ist $SYBASE/ASE-12_5/bin.
Windows NT Das Dienstprogramm heißt certpk12.exe und befindet sich in
%SYBASE%\ASE-12_5\bin.
Syntax certpk12
{-O Pkcs12-Datei | -I Pkcs12-Datei}
[-C Zert-Datei]
[-K Schlüssel-Datei]
[-P Schlüssel-Kennwort]
[-E Pkcs12-Kennwort]
Oder
certpk12 -v
Parameter -O Pkcs12-Datei
gibt den Namen einer PKCS #12-Datei an, die exportiert werden soll. Die
Datei kann ein Zertifikat samt privatem Schlüssel, ein einzelnes Zertifikat
oder einen einzelnen privaten Schlüssel enthalten. Sie müssen entweder -O
oder -I festlegen.
180 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-I Pkcs12-Datei
gibt den Namen einer PKCS #12-Datei an, die importiert werden soll. Die
Datei kann ein Zertifikat samt privatem Schlüssel, ein einzelnes Zertifikat
oder einen einzelnen privaten Schlüssel enthalten. Sie müssen entweder -I
oder -O festlegen.
-C Zert-Datei
gibt den Namen einer Zertifikatsdatei an, die in eine PKCS #12-Datei
exportiert werden soll, wenn -O eingestellt ist; oder den Namen einer
Zertifikatsdatei, die in eine PKCS #12-Datei importiert werden soll, wenn -I
eingestellt ist.
-K Schlüssel-Datei
gibt den Namen eines privaten Schlüssels an, der in eine PKCS #12-Datei
exportiert werden soll, wenn -O eingestellt ist; oder den Namen eines
privaten Schlüssels, der in eine PKCS #12-Datei importiert werden soll,
wenn -I eingestellt ist.
-P Schlüssel-Kennwort
legt ein Kennwort fest, mit dem der private Schlüssel geschützt wird, der
durch -K angegeben wurde. Wenn -O gesetzt ist, exportiert das Kennwort
den privaten Schlüssel in eine PKCS #12-Datei; wenn -I gewählt wurde,
gibt das Kennwort den privaten Schlüssel in eine Textdatei zurück,
nachdem er aus einer PKCS #12-Datei importiert wurde.
-E Pkcs12-Kennwort
legt das Kennwort fest, mit dem die PKCS #12-Datei geschützt wird. Wenn
-O eingestellt ist, wird mit dem Kennwort die zu exportierende PKCS #12-
Datei verschlüsselt; wenn -I gewählt wurde, wird damit die zu importierende
PKCS #12-Datei entschlüsselt. Das Kennwort wird auch „Transport-
Kennwort“ genannt.
-v
gibt die Versionsnummer und Copyright-Meldung für das certpk12-Tool an
und beendet das Programm.
Beispiele Beispiel 1 Exportiert die Zertifikatsdatei caRSA.crt und die private
Schlüsseldatei caRSApkey.txt in eine PKCS#12-Datei (caRSA.p12). Kennwort
ist das Kennwort, mit dem caRSApkey.txt entschlüsselt wird. pk12-Kennwort
ist das Kennwort, mit dem die endgültige caRSA.p12 verschlüsselt wird.
certpk12 -O caRSA.p12 -C caRSA.crt -K caRSApkey.txt
-P Kennwort -E pk12-Kennwort
-- Sybase PKCS#12 Conversion Utility certpk12 Thu Nov 9 16:55:51 2000--
Dienstprogramme 181

certpk12
Beispiel 2 Importiert die PKCS #12-Datei caRSA.p12, die ein Zertifikat
und einen privaten Schlüssel enthält. Das eingebettete Zertifikat wird in die
Textdatei (caRSA_new.crt) und der eingebettete private Schlüssel in die
Textdatei (caRSApkey_new.txt) ausgegeben:
certpk12 -I caRSA.p12 -C caRSA_new.crt -K caRSApkey_new.txt
-P neues_Kennwort -E pk12-Kennwort
-- Sybase PKCS#12 Conversion Utility certpk12 Thu Nov 9 16:55:51 2000--
Neues_Kennwort wird verwendet, um caRSApkey_new.txt zu schützen, und
pk12-Kennwort ist erforderlich, um die caRSA.p12-Datei zu entschlüsseln.
Hinweis Nachdem Sie Beispiele 1 und 2 ausgeführt haben, sind caRSA.crt
und caRSA_new.crt identisch. caRSApkey.txt und caRSApkey_new.txt sind
verschieden, weil sie nach dem Zufallsprinzip verschlüsselt werden.
Beispiel 3 Exportiert die Zertifikatsdatei (caRSA.crt) in eine PKCS#12-Datei
(caRSAcert.p12). pkcs12-Kennwort wird verwendet, um caRSAcert.p12 zu
verschlüsseln.
certpk12 -O caRSAcert.p12 -C caRSA.crt -E pk12-Kennwort
-- Sybase PKCS#12 Conversion Utility certpk12 Thu Nov 9 16:55:51 2000--
Beispiel 4 Importiert eine PKCS#12-Datei (caRSAcert.p12), die ein Zertifikat
enthält. Das eingebettete Zertifikat wird in eine Textdatei (caRSAcert.txt)
ausgegeben.
certpk12 -I caRSAcert.p12 -C caRSAcert.txt -E pk12-Kennwort
-- Sybase PKCS#12 Conversion Utility certpk12 Thu Nov 9 16:55:51 2000pk12-Kennwort
ist erforderlich, um die caRSAcert.p12-Datei zu entschlüsseln.
Hinweis Nachdem Sie die Beispiele 3 und 4 ausgeführt haben, sind caRSA.crt
und caRSAcert.txt identisch.
Syntax certpk12 unterstützt nur dreifach DES-verschlüsselte PKCS #12-Dateien.
Hängen Sie den privaten Schlüssel des Zertifikat-Anforderers an das Ende
der unterschriebenen Zertifikatsdatei an.
182 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Benennen Sie die Datei Servername.crt, wobei Servername der
Name des Servers ist. Speichern Sie sie im Zertifikatsverzeichnis unter
$SYBASE/$SYBASE_ASE (%SYBASE%\%SYBASE_ASE% in Windows).
Diese Datei wird benötigt, um die SSL-aktivierte Adaptive Server-
Installation zu starten.
Siehe auch Dienstprogramme certauth, certreq
certreq
Beschreibung Erstellt eine Serverzertifikatsanforderung und einen entsprechenden privaten
Schlüssel. Dieses Dienstprogramm kann im interaktiven Modus verwendet
werden, oder Sie geben alle fakultativen Parameter in der Befehlszeile ein.
Standort ist $SYBASE/ASE-12_5/bin.
Windows NT Das Dienstprogramm heißt certreq.exe und befindet sich in
%SYBASE%\ASE-12_5\bin.
Syntax certreq
[-F Eingabedatei]
[-R Anforderung-Dateiname]
[-K PK-Dateiname]
[-P Kennwort]
Oder
certreq -v
Parameter -F Eingabedatei
gibt den Namen der Datei an, die Attributinformationen zum Kompilieren
einer Zertifikatsanforderung enthält. Wenn Sie keinen Eingabedatei-Namen
angeben, müssen die erforderlichen Informationen vom Benutzer interaktiv
eingegeben werden.
Die Eingabedatei benötigt jeweils einen Eintrag für die folgenden Angaben:
req_certtype={Server,Client}
req_keytype={RSA,DSA}
req_keylength={for RSA: 512-2048;
for DSA: 512,768,1024}
req_country={string}
req_state={string}
req_locality={string}
req_organization={string}
req_orgunit={string}
req_commonname={string}
Dienstprogramme 183

certreq
Hinweis Der allgemeine Name (commonname) muss derselbe wie der
Servername sein.
Im Beispiel 2 finden Sie eine Musterdatei namens Eingabedatei.
-R Anforderung-Dateiname
gibt den Namen für die Zertifikatsanforderungsdatei an.
-K PK-Dateiname
gibt den Namen für die private Schlüsseldatei an.
-P Kennwort
legt das Kennwort fest, mit dem der private Schlüssel geschützt wird.
-v
gibt die Versionsnummer und Copyright-Meldung an und beendet dann.
Beispiele Beispiel 1 Dieses Beispiel verwendet nicht den -F Eingabedatei-Parameter und
verwendet daher den interaktiven Modus. Um eine Server-
Zertifikatsanforderung (server_req.txt) und ihren privaten Schlüssel
(server_pkey.txt) zu erstellen, geben Sie ein:
certreq
Choose certificate request type:
S – Server certificate request
C – Client certificate request (not supported)
Q – Quit
Enter your request [Q]: s
Choose key type:
R – RSA key pair
D – DSA/DHE key pair
Q – Quit
Enter your request [Q]: r
Enter key length (512, 768, 1024 for DSA; 512-2048 for
RSA) : 512
Country: US
State: california
Locality: emeryville
Organization: sybase
Organizational Unit: dst
Common Name: server
184 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Das Dienstprogramm gibt folgende Meldung zurück:
Generating key pair (please wait) . . .
Nachdem das Schlüssel-Paar generiert wurde, werden Sie vom certreq-
Dienstprogramm zur Eingabe folgender Informationen aufgefordert.
Enter password for private key: Kennwort
Enter file path to save request: server_req.txt
Enter file path to save private key: server_pkey.txt
Beispiel 2 In dieser Muster-Textdatei wird das Format tag=value bei der nichtinteraktiven
Eingabe für eine Zertifikatsanforderung verwendet. Sie können
die -F-Option im nicht-interaktiven Modus verwenden. Wenn Sie die -F-Option
verwenden, stellen Sie sicher, dass Sie gültige Werte eingeben und das oben
beschriebene Format beachten. Anderenfalls wird das Zertifikat nicht korrekt
kompiliert.
certreq -F Eingabedatei
req_certtype=server
req_keytype=RSA
req_keylength=512
req_country=us
req_state=california
req_locality=emeryville
req_organization=sybase
req_orgunit=dst
req_commonname=server
Nachdem Sie diese Datei erstellt und gespeichert haben, geben Sie Folgendes
auf der Befehlszeile ein, wobei Pfad_und_Datei der Standort der Textdatei ist:
certreq -F Pfad_und_Datei -R server_req.txt -K server_pkey.txt -P Kennwort
Diese Datei erstellt eine Server-Zertifikatsanforderung, server_req.txt, und
ihren private Schlüssel server_pkey.txt, der durch Kennwort geschützt ist.
Sie können die Server-Zertifikatsdatei mit jedem Standard-ASCII-Texteditor
bearbeiten.
Syntax Die Eingabedatei verwendet das Format tag=value. tag berücksichtigt
Groß-/Kleinschreibung und muss der oben stehenden Beschreibung
entsprechen.
Das „=“ ist erforderlich. Ein gültiger value-Wert muss mit einem
Buchstaben oder einer Ziffer beginnen und aus einem Wort bestehen;
überdies dürfen keine Leerstellen in value vorhanden sein.
Dienstprogramme 185

charset
value ist erforderlich für req_certtype, req_keytype, req_keylength
und req_commonname.
Rigsum , = und value sind Leerstellen und Tabulatoren erlaubt.
Leere Zeilen sind ebenfalls erlaubt.
Jede Kommentarzeile muss mit # beginnen.
Die Zertifikatsanforderungsdatei ist im PKCS #10-Format und wird
vom certauth-Tool als Eingabe anerkannt, um die Anforderung in ein
unterschriebenes CA-Zertifikat zu konvertieren.
Siehe auch Dienstprogramme certauth, certpk12
charset
Beschreibung Nur UNIX-Plattformen Lädt die Zeichensätze und Sortierreihenfolgen-
Dateien in Adaptive Server. Standort ist $SYBASE/ASE-12_5/bin.
Syntax charset
[-P Kennwort]
[-S Server]
[-ISchnittstelle]
Sortierreihenfolge
[ Zeichensatz ]
Oder
charset -v
Parameter -P Kennwort
gibt Ihr Kennwort an. Wenn Sie -P nicht verwenden, fordert charset zur
Eingabe Ihres Kennworts auf.
-S Server
legt den Namen des Servers fest, auf dem der Zeichensatz und die
Sortierreihenfolge geändert werden sollen.
-I Schnittstelle
legt die Netzwerk-Schnittstelle fest, die vom Server benutzt werden soll.
Sortierreihenfolge
legt den Namen der Sortierreihenfolgen-Datei fest, die Adaptive Server
verwenden wird.
186 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Zeichensatz
legt den Zeichensatz fest, den Adaptive Server verwenden wird.
-v
gibt die Versionsnummer und Copyright-Meldung für charset an.
Syntax Bevor Sie charset verwenden, müssen Sie die SYBASE-Umgebungsvariable
so einstellen, dass sie auf das aktuelle Sybase-Versionsverzeichnis zeigt.
Berechtigungen Sie müssen Systemadministrator sein, um charset auszuführen.
Siehe auch Befehle set
cobpre
Dienstprogramme langinstall
Beschreibung Precompiler für COBOL unter $SYBASE/$SYBASE_OCS/bin
(%SYBASE%\%SYBASE_OCS%\bin in Windows NT). Eine ausführliche
Beschreibung von cobpre finden Sie in Anhang A der Dokumentation Open
Client/Server Programmer’s Supplement.
Syntax Siehe oben.
cpre
Beschreibung Precompiler für C unter $SYBASE/$SYBASE_OCS/bin
(%SYBASE%\%SYBASE_OCS%\bin in Windows NT). Eine ausführliche
Beschreibung von cpre finden Sie in Anhang A der Dokumentation Open
Client/Server Programmer’s Supplement.
Syntax Siehe oben.
Dienstprogramme 187

dataserver
dataserver
Beschreibung Nur UNIX-Plattformen Die Adaptive Server-Programmdatei unter
$SYBASE/ASE-12_5/bin.
Syntax dataserver [-f] [-g] [-G] [-h] [-H] [-m] [-q] [-v] [-X]
[-a Pfad_zu_CAP-Direktivendatei]
-b Master-Device-Größe [k | K | m | M | g | G]
[-c Konfig-Datei_für_Server]
[-d Devicename]
[-e Pfad_zu_Fehler-Log]
[-i Interfaces-Datei-Verzeichnis]
[-K Keytab-Datei]
[-L Konfig-Dateiname_für_Connectivity]
[-M gemeinsam_genutzer_Speicher-Repository-Verzeichnis]
[-p SA-Loginname]
[-r Spiegel-Plattenspeichername]
[-s Servername]
[-T Trace-Flag]
[-u SA/SSO-Name]
[-w Master- | Modelldatenbank]
[-y [Kennwort] ]
[-z Seitengröße [ k | K ]]
Parameter -f
Oder
dataserver -v
erzwingt die Initialisierung eines Devices oder einer Datenbank. -f ist nur
gültig, wenn der Parameter mit -b und/oder -w verwendet wird. Der Server
startet nicht neu, wenn Sie -f ohne -b oder -w verwenden. -f wirkt sich auf
den Server unterschiedlich aus, abhängig davon, ob -w vorhanden ist.
Weitere Hinweise finden Sie unter „Mögliche Probleme bei gemeinsamer
Verwendung der -f- und -w-Option“ auf Seite 193 und „Abhängigkeiten
und Bedingungen der -b- und -w-Optionen“ auf Seite 194.
-g
schaltet das Protokollieren von Ereignissen aus.
-G logserv-Name
legt den Namen des Ereignislog-Servers fest.
188 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-h
druckt die Hilfemeldung und beendet dann.
-H
startet den HA-Server (High Availability, Hohe Verfügbarkeit), wenn Sie die
HA-Funktion in Ihrer Adaptive Server-Installation installiert haben.
-m
startet Adaptive Server im Einzelbenutzer-Modus.
-q
behandelt Datenbanken im Ruhezustand wie „in Wiederherstellung“.
-v
gibt die Versionsnummer und Copyright-Meldung für dataserver an und
beendet dann.
-X
startet diesen Server als sybmon, und nicht als dataserver.
-a Pfad_zu_CAP-Direktivendatei
gibt den Pfad zur CAP-Direktivendatei an.
-b Master-Device-Größe [k | K | m | M | g | G]
gibt die Größe des Master-Devices oder der Datenbank an, die Sie einrichten
wollen. Der Server errechnet die Größen, also können Sie „K“, „M“ und
„G“ anstelle der genauen Byte-Anzahl verwenden.
-c Konfig-Datei_für_Server
gibt den vollständigen Pfadnamen einer Adaptive Server-Konfigurationsdatei
an. Verwenden Sie diesen Parameter, um Adaptive Server mit den
Konfigurationswerten in der angegebenen Konfigurationsdatei zu starten.
Wenn Sie eine Konfigurationsdatei mit dem dataserver -c-Parameter
angeben, stellen Sie sicher, dass alle Parameter in dieser Konfigurationsdatei
kompatibel sind, bevor Sie den Server neu starten. Wenn einige Konfigurationsparameter
nicht kompatibel sind, startet der Server möglicherweise
nicht neu. Um das zu vermeiden, geben Sie keine Konfigurationsdatei an,
wenn Sie das Master-Device einrichten. Die Einrichtphase verwendet alle
Standardeinstellungen, wenn Sie keine Konfigurationsdatei angeben.
Weitere Hinweise finden Sie in der Dokumentation Systemadministration
für Adaptive Server Enterprise.
Dienstprogramme 189

dataserver
-d Devicename
ist der vollständige Pfadname des Devices für die master-Datenbank.
Das Master-Datenbankdevice muss für den Benutzer beschreibbar sein,
der Adaptive Server startet. Wenn Sie den -d-Parameter nicht verwenden,
lautet der Standardname des master-Datenbankdevices d_master.
-e Fehlerlogdatei
ist der vollständige Pfadname der Fehlerlogdatei für Fehlermeldungen der
Adaptive Server-Systemebene.
-i Interfaces-Datei-Verzeichnis
gibt den Namen und den Standort der Interfaces-Datei an, die durchsucht
werden soll, wenn die Verbindung mit der Adaptive Server-Installation
eingerichtet wird. Wenn -I weggelassen wird, sucht dataserver nach einer
Datei namens interfaces in dem Verzeichnis, auf das von Ihrer Sybase-
Umgebungsvariablen gezeigt wird.
-K Keytab-Datei
gibt den Pfad zur Keytab-Datei an, die zur Authentifizierung in DCE
verwendet wird.
-L Konfig-Dateiname_für_Connectivity
gibt den Namen der Konfigurationsdatei für Connectivity an.
-M gemeinsam_genutzer_Speicher-Verzeichnis
platziert Shared-Memory-Dateien in das angegebene Verzeichnis und nicht
an den Standardstandort, $SYBASE. Wenn gemeinsam_genutzter_Speicher-
Verzeichnis mit „\“ startet, wird angenommen, dass der Verzeichnisname
absolut ist. Ansonsten wird der Verzeichnisname relativ zu $SYBASE
interpretiert.
-p SSO-Loginname
gibt den Login-Namen eines Sicherheitsadministrators an, wenn Adaptive
Server gestartet wird, damit für das neue Konto ein neues Kennwort
eingerichtet werden kann. Adaptive Server erzeugt ein Zufallskennwort,
zeigt es an, verschlüsselt es und speichert es in master..syslogins als das
neue Kennwort für das Konto.
-r Master-Spiegel
startet den Spiegel für das Master-Device. Verwenden Sie diesen Parameter,
um Adaptive Server zu starten, falls das Master-Device beschädigt wurde.
-s Servername
gibt den Namen der Adaptive Server-Installation an, die gestartet werden
soll. Wenn -s weggelassen wird, wird ein Server mit Namen SYBASE
gestartet.
190 Adaptive Server Enterprise

-T Trace-Flag
Kapitel 8 Übersicht über die Dienstprogrammbefehle
-u SA/SSO-Name
gibt den Namen des Systemadministrators oder Sicherheitsadministrators
an, den Sie freigeben wollen.
-w Master- | Modelldatenbank
legt fest, ob Sie eine Master- oder eine Modelldatenbank schreiben wollen.
-y [Kennwort]
mit diesem Parameter können Sie ein Kennwort für den verschlüsselten
privaten Schlüssel zuordnen, damit der Server den Benutzer zur Eingabe
eines Kennworts auffordert. Dieses Kennwort sollte jenem entsprechen,
mit dem Sie den privaten Schlüssel verschlüsselt haben, als er erstellt
wurde. Sie können diesen Parameter nicht verwenden, wenn Sie den
Server im Hintergrund ausführen.
Hinweis Auch wenn Sie ein Kennwort mit -y, setzen können, empfiehlt Sybase
ausdrücklich, dies aus Sicherheitsgründen zu unterlassen.
Ein privater Schlüssel ist im digitalen Zertifikat Ihres Servers enthalten.
Standardmäßig finden Sie die Zertifikatsdatei unter:
/usr/local/sybase/certificates/servername.crt
Der Standort der Zertifikatsdatei ändert sich, wenn Sie den sp_ssladmin
addcert-Befehl aufrufen.
-z Seitengröße [ k | K ]
legt die Seitengröße für den Server fest. Sie müssen -b und -w verwenden,
um diese Option zu nutzen, und eine gerade Zweierpotenz zwischen
2 KByte und 16 KByte angeben, da sonst der Server nicht neu startet.
Beispiele Beispiel 1 Erstellt eine neue Installation mit einem 100-MByte-Master-
Device und einer 4-KByte-Seite:
dataserver -d my_master_device -z 4k -b 100.02M
Die Leerstellen zwischen den Optionen und den nachfolgenden Argumenten
sind fakultativ und werden akzeptiert. In diesem Beispiel werden „100.02M“
für ein 100-MByte-Master-Device festgelegt, da der Server einen 16-KByte-
Overhead für seinen Konfigurationsbereich benötigt.
Beispiel 2 Schreibt eine fehlerhafte Modelldatenbank neu:
dataserver -d my_master_device -w model
Dienstprogramme 191

dataserver
Beispiel 3 Schreibt eine fehlerhafte Master-Datenbank neu, wobei die
Devicegröße angegeben wird:
dataserver -d my_master_device -w master -z 4k
Beispiel 4 Schreibt eine fehlerhafte Master-Datenbank neu, indem Deviceund
Seitengrößen festgelegt werden und der Server gezwungen wird, diese
Werte anstelle von solchen, die er möglicherweise im Konfigurationsblock
findet, zu akzeptieren:
dataserver -d my_master_device -w master -z 4k -b
100.02M -f
Beispiel 5 Schreibt eine fehlerhafte Master-Datenbank, wobei eine
Seitengröße angegeben wird, die nicht der entspricht, die der Server in
seinem Konfigurationsblock findet. Das erzeugt einen Fehler:
dataserver -d my_master_device -w master -z 8k
00:00000:00000:2001/01/19 12:01:26.94 server Die
konfigurierte Seitengröße des Servers entspricht
nicht der, die auf der Befehlszeile angegeben ist.
Um die konfigurierte Größe zu verwenden, lassen Sie die
Größenangabe in der Befehlszeile weg. Um den Wert in der
Befehlszeile zu verwenden, geben Sie 'force' (-f) ein.
Beispiel 6 Schreibt eine fehlerhafte Master-Datenbank neu, wobei eine
inkorrekte Seitengröße angegeben ist, sogar bei einem normalen Neustart.
Das erzeugt einen Fehler:
dataserver -d my_master_device -z4000
dataserver: Die 'z'-Option darf nicht ohne 'b' oder 'w'
verwendet werden. dataserver: Server wird die 'z'-
Option ignorieren. dataserver: die 'z'-Option enthält
eine ungültige Seitengröße. dataserver: Die Seitengröße
muss eine gerade Zweierpotenz zwischen 2048 und 16384
Byte sein.
Syntax dataserver ermöglicht es Ihnen, Devices und Datenbanken zu erstellen,
die bis zu 32 GByte groß sind, abhängig von den Einschränkungen Ihres
Betriebssystems. Weitere Hinweise zu Größenbeschränkungen finden Sie
in der Installationsanleitung für Ihre Plattform.
Starten Sie Adaptive Server mit dem startserver-Befehl und nicht, indem
Sie direkt das dataserver-Programm ausführen. Um Standardwerte
zu ändern, bearbeiten Sie die RUN_servername-Datei im Sybase-
Installationsverzeichnis. Weitere Hinweise finden Sie unter startserver
in diesem Handbuch.
192 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Da Adaptive Server-Kennwörter verschlüsselt sind, können
Sie vergessene Kennwörter nicht wiederherstellen. Wenn alle
Sicherheitsadministratoren ihre Kennwörter verlieren, erzeugt der -p-
Parameter ein neues Kennwort für ein Sicherheitsadministrator-Konto.
Starten Sie Adaptive Server mit -p, melden Sie sich sofort bei Adaptive
Server mit einem neuen Zufalls-Kennwort an und führen Sie sp_password
aus, um Ihr Kennwort durch ein sichereres zu ersetzen.
Nachdem Sie das Adaptive Server-Installationsprogramm fertig
ausgeführt haben, stellen Sie die Dateiberechtigungen in der ausführbaren
dataserver-Datei ein, um den Zugriff auf ihre Ausführung zu beschränken.
Wenn Sie einen Adaptive Server-Namen ohne den -s-Parameter angeben
und nicht die Umgebungsvariable DSLISTEN eingestellt haben,
verwendet dataserver den Adaptive Server-Standardnamen SYBASE.
Der Wert der Umgebungsvariablen DSLISTEN setzt diesen Standardwert
außer Kraft. Der -s-Parameter setzt den Standardwert und die DSLISTEN-
Umgebungsvariable außer Kraft.
Automatische Login-Sperren können dazu führen, dass auf einem
Rechner alle Logins gesperrt sind, die dazu berechtigt sind, Logins
freizugeben (Systemadministratoren und Sicherheitsadministratoren).
Wenn das passiert, verwenden Sie das dataserver-Dienstprogramm mit
dem -u-Parameter, um das angegebene Login auf Systemadministratoroder
Sicherheitsadministrator-Berechtigungen zu überprüfen, geben Sie
das Konto frei und setzen Sie den Zählerwert für aktuelle fehlgeschlagene
Logins auf Null.
Mögliche Probleme bei gemeinsamer Verwendung der -f- und -w-Option
Bei der gemeinsamen Verwendung der Optionen -f und -w ist äußerste Vorsicht
geboten. Wenn Sie beim Neuschreiben der Master-Datenbank die -w-Option
verwenden, verlangt der Server, dass die Konfigurationsblock-Seitengröße
und die Devicegröße korrekt sind. Wenn Sie diese nicht auf der Befehlszeile
angeben, müssen sie übereinstimmen. Der Server stellt das Master-Device
wieder her und speichert Master- sowie alle anderen darin vorhandenen
Datenbanken wieder an ihre richtigen Standorte.
Verwenden Sie die -f-Option zur erzwungenen Initialisierung, setzen Ihre
Seitengröße und Master-Devicegröße die Werte im Konfigurationsblock
außer Kraft. Darüber hinaus weist -f den gesamten restlichen unbekannten
Speicherplatz, also nicht benutzte oder fehlerhafte Zuordnungsblöcke,
der Masterdatenbank zu.
Dienstprogramme 193

dataserver
Abhängigkeiten und Bedingungen der -b- und -w-Optionen
Die Auswirkung von -b ist abhängig davon, ob -w vorhanden ist:
-b ohne -w erstellt ein Master-Device, benannt durch -d (der Standardwert
ist d_master) und mit einer in -z angegebenen Seitengröße
(der Standardwert ist 2048):
Wenn das benannte Device bereits als eine OS-Datei vorhanden ist,
schlägt der Versuch fehl und Sie erhalten eine ähnliche Meldung wie
die Folgende:
Datei bereits vorhanden. Entfernen Sie die
vorhandene Datei, bevor Sie versuchen, eine
neue Datei mit der b-Serveroption zu erstellen.
Erstellen des Master-Devices nicht möglich.
Wenn das benannte Device eine vorhandene unformatierte Partition
benennt, schlägt der Versuch fehl, außer Sie beziehen die -f-Option
ein. Das reinitialisiert die unformatierte Partition als ein Server-
Master-Device.
-b mit -w master fordert dataserver dazu auf, die in -z angegebene Größe
zu verwenden, wenn die Master-Datenbank neu erstellt wird. Diese
Einstellung bezieht sich nicht auf das Erstellen eines neuen Devices.
-w erfordert möglicherweise zusätzliche Optionen:
Wenn Sie -w model verwenden, werden die -z- und -b-Optionen akzeptiert,
aber ignoriert.
Wenn Sie -w master bei neuen Installationen verwenden, werden -z und -b
nicht benötigt, weil die Device-Größeninformationen im config_block
gespeichert sind.
Wenn Sie -w master zum Upgrade alter Installationen verwenden,
beachten Sie Folgendes:
Der Server benötigt -b und/oder -z, wenn der config_block keinen
gültigen Eintrag für die zugeordneten Größen enthält. Der Befehl
schlägt fehl, wenn er keine gültigen Daten für die Seitengröße oder
die Devicegröße erhält.
Sie können -b und/oder -z angeben, wenn config_block gültige
Einträge für die Größen, die sie darstellen, enthält. Wenn die Größen
allerdings nicht mit denen im config_block übereinstimmen, müssen
Sie -f hinzufügen, um Ihre neuen Größenwerte durchzusetzen.
194 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Berechtigungen Jeder mit Ausführungsberechtigung auf die Binärdaten, der Lese/Schreib-
Zugriff auf alle Dateien hat.
Siehe auch Befehle disk mirror, disk remirror, disk unmirror
dataxtr
Systemprozeduren sp_ssladmin addcert
Dienstprogramme startserver
Beschreibung Das Daten-Migrationstool mit grafischer Benutzeroberfläche (GUI), zum
Verschieben von Daten und Datenbankschemata aus Adaptive Server-
Datenbanken vor Version 12.5 in 12.5-Datenbanken. Der Standort ist
$SYBASE/ASE-12_5/bin (%SYBASE%\ASE-12_5\bin in Windows NT).
Hinweise zur Verwendung des dataxtr-Dienstprogramms finden Sie ihn den
Versionshinweisen für Adaptive Server Enterprise 12.5 für Ihre Plattform.
Syntax Keine.
ddlgen
Beschreibung Ein auf Java basierendes Tool, das Definitionen für Objekte der Server- und
Datenbankebene in Adaptive Server generiert. ddlgen unterstützt Adaptive
Server Version 12.0 und später.
Die Befehlszeilen-Version von ddlgen befindet sich unter $SYBASE/sybcent41
(%SYBASE%\sybcent41 in Windows NT).
Syntax ddlgen
-ULogin
-PKennwort
-SHostname : Portnummer
[-TObjekttyp]
[-NObjektname]
[-DDatenbankname]
[-Xerweiterter_Objekttyp]
[-OAusgabedatei]
[-EFehlerdatei]
[-LFortschritts-Logdatei]
[-J Client-Zeichensatz]
-F[ % | SGM | GRP | USR | R | D | UDD | U | V | P | XP | I | RI | KC | TR]
Dienstprogramme 195

ddlgen
Oder
ddlgen -v
Parameter -U Login
gibt einen Loginnamen an und berücksichtigt Groß-/Kleinschreibung.
-P Kennwort
gibt Ihr Kennwort an.
-S Hostname : Portnummer
gibt den Hostnamen oder IP-Adresse von Adaptive Server an, wie auch
seine Portnummer. Trennen Sie Hostname und Portnummer mit einem
Doppelpunkt ohne Leerstellen.
Hinweis Sie müssen die -S-Option verwenden da ddlgen nicht mit einem
Standard-Server verbindet.
-T Objekttyp
legt den Typ des Objekts fest, das Sie erstellen. Wenn Sie nicht -T
verwenden, erstellt ddlgen eine DDL für die Standarddatenbank von Login.
Tabelle 8-3 listet Objekttypen für -T auf.
Tabelle 8-3: Gültige Objekttypen für die ddlgen -T-Option
Objekttyp Beschreibung
C Cache
D Standardwert
DB Datenbank
DBD Datenbankdevice
DPD Sicherungsdevice
EC Ausführungsklasse
EG Engine-Gruppe
GRP Gruppe
I Index
KC Schlüssel-Integritätsregeln
L Login
P Gespeicherte Prozedur
R Regel
196 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Objekttyp Beschreibung
RI Referenzielle Integrität
RO Rolle
RS Fremdserver
SGM Segment
TR Trigger
U Tabelle
UDD Benutzerdefinierter Datentyp
USR Benutzer
V Ansicht
XP Erweiterte gespeicherte Prozedur
-N Objektname
bestimmt den vollständig qualifizierten Namen des Objekts, das Sie
erstellen, wie zum Beispiel -Ndb-Name.Eigentümername.
Tabellenname.Objektname. Die -N-Option:
ist erforderlich, wenn Sie einen anderen Objekttyp als DB (Datenbank)
im -T-Parameter angeben.
akzeptiert Wildcards, wenn Sie mit % verwendet werden.
erstellt eine DDL für alle Einträge eines bestimmten Objekttyps auf
Ihrem Server.
erzwingt eine strikte Reihenfolge für die Analyse der Namen im Format
-Ndb-Name.Eigentümername.Tabellenname.Objektname. Wenn Sie nur
drei Argumente angeben, nimmt ddlgen an, dass es sich dabei um
Eigentümername, Tabellenname und Objektname, in genau dieser
Reihenfolge handelt. Sie können auch -NEigentümername.Tabellenname
-Ddb-Name verwenden. ddlgen macht diese Einschränkung nicht,
wenn Objektname ein Index (I) ist.
-D Datenbankname
legt den Namen der Datenbank für das Objekt fest, das Sie in der -N-Option
angeben. Der Standardwert ist die Standarddatenbank des Benutzers.
Dienstprogramme 197

ddlgen
-X erweiterter_Objekttyp
unterscheidet folgende Elemente voneinander:
Benutzertabellen (OU) von Proxy-Tabellen (OD), wenn Sie eine Tabelle
als Ihren Objekttyp (-TU) angeben
temporäre Datenbanken (OD) von nicht-temporären Datenbanken
(OU), wenn Sie eine Datenbank als Ihren Objekttyp angeben (-TDB)
SQLJ-Prozeduren (OD) von gespeicherten Prozeduren (OU), wenn Sie
eine Prozedur als Ihren Objekttyp angeben (-TP).
Wenn der Objekttyp (-T) ein U-Typ (Tabelle) ist und -X nicht angegeben
wird, generiert ddlgen DDL sowohl für Benutzertabellen als auch für Proxy-
Tabellen. So generieren Sie eine DDL-Datei nur für:
Benutzertabellen – verwenden Sie den erweiterten OU-Objekttyp mit
der -X-Option.
Proxy-Tabellen – verwenden Sie den erweiterten OD-Objekttyp mit der
-X-Option.
Hinweis ddlgen unterstützt keine Systemtabellen.
-O Ausgabedatei
gibt eine Ausgabedatei für die generierten DDL an. Wenn Sie nicht -O
angeben, wird die DDL, die Sie generieren, in einem Konsolenfenster
angezeigt.
-E Fehlerdatei
bestimmt eine Logdatei zum Aufzeichnen der Fehler. Wenn Sie nicht -E
angeben, werden die generierten Fehler in einem Konsolenfenster
angezeigt.
-L Fortschritts-Logdatei
bestimmt eine Logdatei zur Protokollierung des Fortschritts von ddlgen.
Wenn Sie -L nicht festlegen, wird der Fortschritt nicht aufgezeichnet.
198 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-J Client-Zeichensatz
gibt den Zeichensatz an, der auf dem Client verwendet wird. -J Client-
Zeichensatz verlangt, dass Adaptive Server in und von Client-Zeichensatz,
dem auf dem Client verwendeten Zeichensatz, konvertiert. Ein Filter
konvertiert die Eingabe zwischen Client-Zeichensatz und dem Adaptive
Server-Zeichensatz.
Das Weglassen von -J stellt den Zeichensatz auf einen Standardwert der
Plattform ein. Der Standard ist nicht unbedingt der Zeichensatz, den der
Client verwendet.
-F
filtert Indizes, Trigger und Integritätsregeln aus Tabellen- und
Datenbankdefinitionen in der DDL von Objekten auf Tabellen- und
Datenbankebene. Folgende Filter sind gültig:
Für Tabellen – [ % | I | RI | KC | TR]
Für Datenbanken – [ % | SGM | GRP | USR | R | D | UDD | U | V | P |
XP|I|RI | KC |TR]
Mögliche Filteroptionen:
% – filtert alles heraus und fragt nur die Schema-Definition einer
Tabelle ab.
SGM – filtert Segmente heraus
GRP – filtert Gruppen heraus
USR – filtert Benutzer heraus
R – filtert Regeln heraus
D – filtert Standardwerte heraus
UDD – filtert benutzerdefinierte Datentypen heraus
U – filtert Benutzertabellen heraus
V – filtert Ansichten heraus
P – filtert gespeicherte Prozeduren heraus
XP – filtert erweiterte gespeicherte Prozeduren heraus
I – filtert Indizes heraus
RI – filtert referenzielle Integritätsregeln heraus
KC – filtert primäre und eindeutige Schlüssel-Integritätsregeln heraus
TR – filtert Trigger heraus
Dienstprogramme 199

ddlgen
-v
zeigt Versionsnummer und Copyright-Meldung von ddlgen an und kehrt
zum Betriebssystem zurück.
Beispiele Beispiel 1 Caches – Generiert eine DDL für einen Cache namens
Standarddatencache auf einem Rechner namens HARBOR unter Verwendung
von Port 1955:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TC -N"default data cache"
Generieren von DDL für alle Caches:
ddlgen -ULogin -PKennwort -SServer:Port -TC -N%
Beispiel 2 Standardwerte – Generiert eine DDL für einen Standardwert
namens „phondflt“ mit dem Eigentümer „jones“ in der Datenbank pubs2
auf einem Rechner namens HARBOR unter Verwendung von Port 1955:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TD -Njones.phonedflt -Dpubs2
Da ddlgen die Verwendung eines vollständig qualifizierten Namens in der
-N-Option ermöglicht, können Sie alternativ dazu auch -Ddb-Name weglassen
und den Datenbanknamen in der -N-Option angeben:
ddlgen -ULogin -PKennwort -SServer:Port -TD -Ndb-
Name.Eigentümer.Standardname
Generieren von DDL für alle Standardwerte in einer Datenbank,
die „Eigentümer“ gehört:
ddlgen -ULogin -PKennwort -SServer:Port -TD -NEigentümer.% -Ddb-Name
Beispiel 3 Datenbanken – Generiert eine DDL für eine Datenbank namens
pubs2 auf einem Rechner namens HARBOR unter Verwendung von Port 1955:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TDB -Npubs2
Wenn Sie db-Name nicht angeben, generiert ddlgen eine DDL für die
Standarddatenbank von Login:
ddlgen -ULogin -PKennwort -SServer:Port
Wenn Sie den -T-Parameter nicht angeben, generiert ddlgen eine DDL für eine
Standardtyp-Datenbank:
ddlgen -ULogin -PKennwort -SServer:Port -Ndb-Name
Generieren von DDL für alle Datenbanken:
ddlgen -ULogin -PKennwort -SServer:Port -TDB -N%
200 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beispiel 4 Datenbankdevice – Generiert eine DDL für ein Datenbankdevice
namens master auf einem Rechner namens HARBOR unter Verwendung von
Port 1955:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TDBD -Nmaster
Generieren von DDL für alle Datenbankdevices:
ddlgen -ULogin -PKennwort -SServer:Port -TDBD -N%
Beispiel 5 Temporäre Datenbanken – Generiert eine DDL für alle
Datenbanken einschl. tempdbs:
ddlgen -ULogin -PKennwort -SServer:Port -TDB -N%
Zum Generieren von DDL für alle temporären Datenbanken verwenden Sie
den erweiterten Datenbanktyp OD:
ddlgen -ULogin -PKennwort -SServer:Port -TDB -XOD -N%
Sie können den erweiterten Typ OD in Adaptive Server 12.5.0.3 und späteren
Versionen verwenden; in früheren Versionen als 12.5.0.3 werden jedoch
Warnmeldungen ausgegeben. Diese Meldungen können Sie ruhig ignorieren,
da ddlgen die Verarbeitung des Befehls fortsetzt.
Zum Generieren von DDL für alle Datenbanken außer temporären
Datenbanken verwenden Sie den erweiterten Typ OU:
ddlgen -ULogin -PKennwort -SServer:Port -TDB -XOU -N%
Folgende Syntax generiert eine DDL für eine temporäre Datenbank namens
tempdb1:
ddlgen -ULogin -PKennwort -SServer:Port -TDB -Ntempdb1
Die Ausgabe besteht aus folgenden Elementen:
Die Anweisung create temporary database
create temporary database tempdb1 on master = 4,
asdas = 2
go
Die Anweisung sp_tempdb bind, in der die isql-Anwendung mit tempdb1
verbunden wird:
sp_tempdb 'bind','ap', 'isql', 'DB', 'tempdb1'
go
Dienstprogramme 201

ddlgen
Hinweis DDL für Objekte wie Ansichten, gespeicherte Prozeduren und
Tabellen werden nicht zusammen mit DDL für eine temporäre Datenbank
erzeugt, weil diese Objekte temporär sind und beim Neustart des Servers
erneut erstellt werden.
Beispiel 6 Sicherungsdevice – Generiert eine DDL für ein Sicherungsdevice
namens tapedump1 auf einem Rechner namens HARBOR unter Verwendung
von Port 1955:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TDPD -Ntapedump1
Generieren von DDL für alle Sicherungsdevices:
ddlgen -ULogin -PKennwort -SServer:Port -TDPD -N%
Beispiel 7 Ausführungsklasse – Generiert eine DDL für eine Ausführungsklasse
namens EC2 auf einem Rechner namens HARBOR unter Verwendung
von Port 1955:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TEC -NEC2
Generieren von DDL für alle Ausführungsklassen:
ddlgen -ULogin -PKennwort -SServer:Port -TEC -N%
Beispiel 8 Engine-Gruppen – Generiert eine DDL für eine Engine-Gruppe
namens LASTONLINE auf einem Rechner namens HARBOR unter
Verwendung von Port 1955:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TEG -NLASTONLINE
Generieren von DDL für alle Engine-Gruppen:
ddlgen -ULogin -PKennwort -SServer:Port -TEG -N%
Beispiel 9 Erweiterte gespeicherte Prozeduren – Generiert eine DDL für die
erweiterte gespeicherte Prozedur xp_cmdshell in der Datenbank pubs2, die dem
Eigentümer „Jones“ gehört und auf einem Rechner namens HARBOR unter
Verwendung von Port 1955 läuft; hierzu wird das vollständig qualifizierte
Format db-Name.Eigentümer.erweiterte_gespeicherte_Prozedur mit der -N-
Option verwendet:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TXP -Npubs2.jones.xp_cmdshell
202 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Anstelle des vollständig qualifizierten Namens können Sie auch die -D-Option
verwenden:
ddlgen -ULogin -PKennwort -SServer:Port -TXP
-NEigentümer.erweiterte_gespeicherte_Prozedur
-Ddb-Name
Generieren von DDL für alle erweiterten gespeicherten Prozeduren:
ddlgen -ULogin -PKennwort -SServer:Port -TXP -Ndb-Name.Eigentümer.%
Beispiel 10 Gruppen – Generiert eine DDL für eine Gruppe namens „public“
in der Datenbank pubs2, die auf einem Rechner namens HARBOR unter
Verwendung von Port 1955 läuft; hierzu wird das vollständig qualifizierte
Format db-Name.Gruppenname in der -N-Option verwendet:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TGRP -Npubs2.public
Alternativ dazu können Sie auch die -D-Option verwenden, um db-Name
anzugeben:
ddlgen -ULogin -PKennwort -SServer:Port -TGRP -NGruppenname -Ddb-Name
Generieren von DDL für alle Gruppen:
ddlgen -ULogin -PKennwort -SServer:Port -TGRP -Ndb-Name.%
Beispiel 11 Indizes – Generiert eine DDL für einen Index namens au_lname
für die Tabelle authors, die dem Eigentümer „dbo“ gehört und sich in der
Datenbank pubs2 befindet:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TI -Ndbo.authors.au_lname -Dpubs2
Da ddlgen die Verwendung eines vollständig qualifizierten Namens in der
-N-Option ermöglicht, können Sie alternativ dazu auch -Ddb-Name weglassen
und den Datenbanknamen in der -N-Option angeben:
ddlgen -ULogin -PKennwort -SServer:Port
-TI -Ndb-Name.Eigentümer.Tabellenname.Indexname
Bei Verwendung eines vollständig qualifizierten Namens können Sie die -D-
Option weglassen.
Generieren von DDL für alle Indizes:
ddlgen -ULogin -PKennwort -SServer:Port -TI
-Ndb-Name.Eigentümer.Tabellenname.%
Dienstprogramme 203

ddlgen
Beispiel 12 Schlüssel – Diese beiden Anweisungen generieren eine DDL
für die primären und eindeutigen Schlüssel aller Tabellen in einer Datenbank,
die mit „PK“ beginnen:
Oder:
ddlgen -Usa -P -TKC -Ndb-Name.%.%.PK%
ddlgen -Usa -P -TKC -N%.%.PK% -Ddb-Name
Hinweis Normalerweise können Sie alle Indizes nur für eine Tabelle erzeugen;
jedoch ermöglicht Ihnen der Objekttyp-Parameter -T zusammen mit dem RI-
und KC-Wert, sowohl Fremdschlüssel als auch primäre und eindeutige
Schlüssel für eine ganze Datenbank zu erzeugen.
Beispiel 13 Logins – Generiert eine DDL für alle Logins auf einem Rechner
namens HARBOR unter Verwendung von Port 1955:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TL -N%
Hinweis Das Kennwort in der für alle Logins generierten DDL ist „Kennwort“.
Oder Sie geben ein individuelles Login an, indem Sie -NBenutzername anstelle
von -N% verwenden:
ddlgen -ULogin -PKennwort -SServer:Port -TL -Ndb-Name.Benutzername
Beispiel 14 Entfernte Server – Generiert eine DDL für einen entfernten Server
namens ORANGE auf einem Rechner namens HARBOR unter Verwendung
von Port 1955:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TRS -NORANGE
Generieren von DDL für alle entfernten Server:
ddlgen -ULogin -PKennwort -SServer:Port -TRS -N%
Beispiel 15 Rollen – Generiert eine DDL für die Rolle „sa_role“ auf einem
Rechner namens HARBOR unter Verwendung von Port 1955:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TRO -Nsa_role
Generieren von DDL für alle Rollen:
ddlgen -ULogin -PKennwort -SServer:Port -TRO -N%
Hinweis Das Kennwort in der für alle Rollen generierten DDL ist „Kennwort“.
204 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beispiel 16 Regeln – Generiert eine DDL für alle Regeln, die authors
zugeordnet sind, auf einem Rechner namens HARBOR unter Verwendung
von Port 1955:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TR -Nauthors.dbo.%
Das %-Symbol fordert DDLGen auf, DDL für alle Regeln zu erstellen, die auf
dem Server vorhanden sind.
Sie können auch den vollständig qualifizierten Namen der Regel angeben:
ddlgen -ULogin -PKennwort -SServer:Port -TR -Ndb-Name.Eigentümer.Regelname
Sie können alternativ dazu auch den -D-Parameter verwenden:
ddlgen -ULogin -PKennwort -SServer:Port -TR -NEigentümer.Regelname
-Ddb-Name
Beispiel 17 Segmente – Generiert eine DDL mithilfe des vollständig
qualifizierten Formats db-Name.Segmentname in der -N-Option für ein
Segment namens logsegment für die Datenbank pubs2 auf einem Rechner
namens HARBOR unter Verwendung von Port 1955:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TSGM -Npubs2.logsegment
Alternativ dazu können Sie auch db-Name angeben, indem Sie die -D-Option
verwenden:
ddlgen -ULogin -PKennwort -SServer:Port -TGSM -NSegmentname -Ddb-Name
Generieren von DDL für alle Segmente:
ddlgen -ULogin -PKennwort -SServer:Port -TSGM -Ndb-Name.%
Beispiel 18 SQLJ-Funktionen – Generiert eine DDL für eine SQLJ-Funktion
namens region_of, die dem Eigentümer dbo gehört und sich in der Datenbank
master befindet:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TDB –Nmaster.dbo.region_of
Sie können alternativ dazu auch den -D-Parameter verwenden:
ddlgen -ULogin -PKennwort -SServer:Port -TDB –Ndbo.region_of –Dmaster
Um eine DDL für alle SQLJ-Funktionen in einer Datenbank zu erzeugen,
verwenden Sie Objekttyp F:
ddlgen -ULogin -PKennwort -SServer:Port -TF –Ndb-Name.Eigentümer.%
Dienstprogramme 205

ddlgen
Beispiel 19 SQLJ-Prozeduren – sind eine Art gespeicherte Prozedur. Sie
können DDL für SQL-Prozeduren zusammen mit DDL für gespeicherte
Prozeduren generieren. Folgende Anweisung erzeugt eine DDL für
alle gespeicherten Prozeduren (einschl. SQLJ-Prozeduren), die dem
Eigentümer dbo gehören und sich in der Datenbank master befinden:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TP –Nmaster.dbo.%
Um eine DDL für alle SQLJ-Prozeduren zu erzeugen, die nur dem Eigentümer
dbo gehören und sich in der Datenbank master befinden, verwenden Sie
folgende Anweisung, wobei der erweiterte Typ OD sich auf SQLJ-Prozeduren
bezieht:
ddlgen -ULogin -PKennwort -SServer:Port - TP –Nmaster.dbo.% -XOD
Um eine DDL für alle SQLJ-Prozeduren zu erzeugen, außer denjenigen,
die dem Eigentümer dbo gehören und sich in der Datenbank master befinden,
verwenden Sie folgende Anweisung, wobei der erweiterte Typ OU sich auf alle
gespeicherten Prozeduren mit Ausnahme von SQLJ-Prozeduren bezieht:
ddlgen -ULogin -PKennwort -SServer:Port - TP –Nmaster.dbo.% -XOU
Beispiel 20 Gespeicherte Prozeduren – Generiert eine DDL für die
gespeicherte Prozedur sp_monitor für die Datenbank pubs2 auf einem
Rechner namens HARBOR unter Verwendung von Port 1955; hierzu wird
das vollständig qualifizierte Format db-Name.Eigentümer.Prozedurname für
die -N-Option verwendet:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TP -Npubs2.dbo.sp_monitor
Alternativ dazu können Sie auch db-Name angeben, indem Sie die -D-Option
verwenden:
DDLGen -ULogin -PKennwort -SServer:Port -TP -NEigentümer.Prozedurname
-Ddb-Name
Generieren von DDL für alle gespeicherten Prozeduren:
ddlgen -ULogin -PKennwort -SServer:Port -TP -Ndb-Name.Eigentümer.%
Beispiel 21 Tabellen – Generiert eine DDL für alle Benutzertabellen in der
Datenbank pubs2, die dem Eigentümer „dbo“ gehören und auf einem Rechner
namens HARBOR unter Verwendung von Port 1955 laufen:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TU -Ndbo.% -Dpubs2
Sie können auch den -N-Parameter verwenden, um den vollständig
qualifizierten Namen der Tabelle anzugeben:
ddlgen -ULogin -PKennwort -SServer:Port -TU
-Ndb-Name.Tabelleneigentümer.Tabellenname
206 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Sie können alternativ dazu auch den -D-Parameter verwenden, um die
Datenbank zu bestimmen:
ddlgen -ULogin -PKennwort -SServer:Port -TU
-NTabelleneigentümer.Tabellenname -Ddb-Name
Um eine DDL für alle Proxy-Tabellen, die den Wert OD verwendet,
zu generieren, verwenden Sie statt dessen -XOD, wobei X der erweiterte
Typ ist und OD Proxy-Tabellen kennzeichnet:
ddlgen -ULogin -PKennwort -SServer:Port -TU
-NTabelleneigentümer.% -Ddb-Name -XOD
Um eine DDL für alle Benutzertabellen, die den Wert OU verwendet,
zu generieren, verwenden Sie statt dessen -XOU, wobei X der erweiterte
Typ ist und OU Benutzertabellen kennzeichnet:
ddlgen -ULogin -PKennwort -SServer:Port -TU
-NTabelleneigentümer.% -Ddb-Name -XOU
Generieren von DDL für alle Tabellen einschl. Benutzertabellen und Proxy-
Tabellen:
ddlgen -ULogin -PKennwort -SServer:Port -TU -Ndb-Name.Tabelleneigentümer.%
Beispiel 22 Trigger – Generiert eine DDL für den Trigger checksum für die
Datenbank pubs2 auf einem Rechner namens HARBOR unter Verwendung
von Port 1955; hierzu wird das vollständig qualifizierte Format db-Name.
Eigentümer.Triggername für die -N-Option verwendet:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TTR -Npubs2.dbo.checksum
Alternativ dazu können Sie auch Datenbankname angeben, indem Sie die -D-
Option verwenden:
ddlgen -ULogin -PKennwort -SServer:Port -TTR
-NEigentümer.Triggername -Ddb-Name
Generieren von DDL für alle Trigger:
ddlgen -ULogin -PKennwort -SServer:Port -TTR -Ndb-Name.Eigentümer.%
Beispiel 23 Benutzerdefinierte Datentypen – Generiert eine DDL für den
benutzerdefinierten Datentyp „dentype“ für die Datenbank pubs2 auf einem
Rechner namens HARBOR unter Verwendung von Port 1955; hierzu wird das
vollständig qualifizierte Format db-Name.benutzerdefinierter_Datentyp für die
-N-Option verwendet:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TUDD -Npubs2.Identype
Alternativ dazu können Sie auch die -D-Option verwenden, um db-Name
anzugeben:
Dienstprogramme 207

ddlgen
ddlgen -ULogin -PKennwort -SServer:Port -TUDD
-Nbenutzerdefinierter_Datentyp -Ddb-Name
Generieren von DDL für alle benutzerdefinierten Datentypen:
ddlgen -ULogin -PKennwort -SServer:Port -TUDD -Ndb-Name.%
Beispiel 24 Ansichten – Generiert eine DDL für eine Ansicht namens retail,
die dem Eigentümer „Miller“ gehört und sich in der Datenbank pubs2 befindet,
die auf einem Rechner namens HARBOR unter Verwendung von Port 1955
läuft, hierzu wird das vollständig qualifizierte Format db-Name.Eigentümer.
Ansichtsname mit der -N-Option verwendet:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TV -Npubs2.miller.retail
Anstelle des vollständig qualifizierten Namens können Sie auch die -D-Option
verwenden:
ddlgen -ULogin -PKennwort -SServer:Port -TV -NEigentümer.Ansichtsname
-Ddb-Name
Generieren von DDL für alle Ansichten:
DDLGen -ULogin -PKennwort -SServer:Port -TV -Ndb-Name.Eigentümer.%
Beispiel 25 Benutzer – Generiert eine DDL für einen Benutzer namens
„Smith“ in der Datenbank pubs2, die auf einem Rechner namens HARBOR
unter Verwendung von Port 1955 läuft; hierzu wird das vollständig
qualifizierte Format db-Name.Benutzername mit der -N-Option verwendet:
ddlgen -Uroy -Proy123 -SHARBOR:1955 -TUSR -Npubs2.smith
Oder Sie können die Optionen -N und -D anstelle eines vollständig
qualifizierten Namens in -N verwenden:
ddlgen -ULogin -PKennwort -SHostname:Port -TUSR -NBenutzername -Ddb-Name
Generieren von DDL für alle Benutzer:
ddlgen -ULogin -PKennwort -SServer:Port -TUSR -Ndb-Name.%
Syntax ddlgen identifiziert keine vorhandenen Sequenzen innerhalb von
Ansichten, gespeicherten Prozeduren oder Triggern. Daher müssen Sie
beim Erzeugen von DDL für eine Datenbank zuerst ddlgen auf diesen
Ansichten, gespeicherten Prozeduren und Triggern, die unabhängig sind,
ausführen, bevor Sie ddlgen auf solchen mit Abhängigkeiten ausführen.
Wenn zum Beispiel die Ansicht B von Ansicht A abhängt, müssen Sie
ddlgen zuerst auf Ansicht A ausführen, bevor Sie es auf Ansicht B
ausführen.
208 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Die Standard-Informationen für ddlgen sind:
Option Parameter benötigt Standardwerte
-U Benutzername Ja Keiner
-P Kennwort Ja Keiner
-S Hostname:Portnummer Ja Keiner
-T Objekttyp
Eine Liste der gültigen Objekttypen finden
Sie in Tabelle 8-3.
Nein Datenbank
-N Objektname Ja, wenn Objekttyp
für -T nicht DB
(Datenbank) ist.
Standard-Datenbankname
von Benutzername, wenn
-TObjekttyp db ist bzw. -T
nicht angegeben ist.
-D Datenbankname Nein Standarddatenbank von
Benutzername.
-X erweiterter_Objekttyp
Optionen sind OU bei Benutzertabellen und
OD bei Proxy-Tabellen.
Nein; nur verwendet,
wenn Objekttyp für -T
U (Benutzertabellen),
P (Prozedur), DB
(Datenbank) ist.
Keiner
-O Ausgabedatei-Name Nein Standard out
-E Fehlerdatei-Name Nein Standard out
-L Logdatei-Name Nein Keiner
-V Versionsnummer von ddlgen Nein Keiner
Um ddlgen von einer Befehlszeile aus aufzurufen, müssen Sie JRE 1.1.8
oder höher installieren und DDLGen.jar in Ihrem Klassenpfad haben.
Auf der Befehlszeile rufen Sie ddlgen unter Verwendung der DDLGen.sh-
Datei (DDLGen.bat für Windows NT), die in Ihrer Adaptive Server-
Installation enthalten ist. Die Hauptklasse in DDLGen.jar ist
com.sybase.ddlgen.DDLGenerator.
So starten Sie ddlgen in Sybase Central, dem Plug-In-Programm für
Adaptive Server:
a Rechtsklicken Sie auf das Objekt, für welches Sie eine DDL
generieren wollen.
b Wählen Sie DDL erstellen.
In der ausgegebenen DDL von create table werden Bindungsanweisungen
als unabhängige DLL und nicht als abhängige DLL generiert.
Dienstprogramme 209

defncopy
Filter
Wenn Sie einen ungültigen Filterparameter verwenden, erzeugt ddlgen eine
Warnung, ignoriert diesen Parameter und fährt mit den restlichen gültigen
Parametern, die Sie angeben, fort.
Wenn Sie % zusammen mit anderen Filterparametern angeben, ignoriert
ddlgen alle anderen filterbaren Parameter und zeigt nur Schema-Definitionen
an. Anschließend wertet ddlgen die Abhängigkeiten innerhalb der Untergruppe
der angewendeten Parameter weiterhin als filterbare Parameter für die
Datenbank.
Berechtigungen Da ddlgen Daten aus Systemkatalogen abrufen muss, müssen die Benutzer
entweder als „dbo“ angemeldet sein oder über die Select- Berechtigung auf
syscatalogs verfügen.
defncopy
Beschreibung Kopiert Definitionen für angegebene Ansichten, Regeln, Standardwerte,
Trigger oder Prozeduren aus einer Datenbank in eine Betriebssystemdatei
bzw. aus einer Betriebssystemdatei in eine Datenbank. Standort ist
$SYBASE/$SYBASE_OCS/bin.
Windows NT Das Dienstprogramm heißt defncopy.exe und befindet sich
unter %SYBASE%\%SYBASE_OCS%\bin.
Syntax defncopy
[-X]
[-a Anzeige-Zeichensatz]
[-I Interfaces-Datei]
[-J [Client-Zeichensatz]]
[-K Keytab-Datei]
[-P Kennwort]
[-R entfernter_Hauptserver]
[-S [Servername]]
[-U Benutzername]
[-V Sicherheitsoptionen]
[-Z Sicherheitsmechanismus]
[-z Sprache]
{ in Dateiname Datenbankname |
out Dateiname Datenbankname [Eigentümer.]Objektname
[[Eigentümer.]Objektname...] }
Oder
defncopy -v
210 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Parameter -X
stellt das Login in dieser Verbindung zum Server mit Kennwortverschlüsselung
durch den Client her. defncopy (der Client) gibt dem
Server bekannt, dass die Kennwortverschlüsselung gewünscht wird.
Der Server sendet einen Verschlüsselungsschlüssel zurück, den defncopy
zur Verschlüsselung Ihres Kennworts und der Server verwendet, um die
Zugangserlaubnis Ihres Kennworts zu überprüfen, wenn es ankommt.
Wenn defncopy ausfällt, erstellt das System eine Core-Datei, die Ihr
Kennwort enthält. Wenn Sie die Verschlüsselungsoption nicht verwendet
haben, wird Ihr Kennwort als normaler Text in der Datei angezeigt. Wenn
Sie die Verschlüsselungsoption verwenden, ist Ihr Kennwort nicht lesbar.
-a Anzeige-Zeichensatz
führt defncopy von einem Terminal aus, dessen Zeichensatz von dem des
Rechners, auf dem defncopy läuft, verschieden ist. -a in Verbindung mit -J
gibt die Zeichensatzkonvertierungs-Datei (.xlt-Datei) an, die für die
Konvertierung erforderlich ist. Verwenden Sie -a ohne -J nur dann,
wenn der Client-Zeichensatz mit dem Standardzeichensatz identisch ist.
Hinweis Der ascii_7-Zeichensatz ist mit allen anderen Zeichensätzen
kompatibel. Wenn entweder der Adaptive Server- oder der Clientzeichensatz
auf ascii_7 eingestellt ist, können alle 7-Bit-ASCII-Zeichen unverändert
zwischen Client und Server übermittelt werden. Andere Zeichen erzeugen
Konvertierungsfehler. Weitere Hinweise zur Zeichensatzkonvertierung finden
Sie in der Dokumentation Systemadministration für Adaptive Server
Enterprise.
-I Interfaces-Datei
gibt den Namen und Position der Interfaces-Datei an, die durchsucht werden
soll, wenn eine Verbindung mit Adaptive Server hergestellt wird. Wenn Sie
für -I keine Angaben machen, sucht defncopy auf UNIX-Plattformen nach
einer Datei namens interfaces in dem Verzeichnis, das durch die SYBASE-
Umgebungsvariable bestimmt wird, und nach sql.ini im ini-Unterverzeichnis
für Ihr Sybase-Versionsverzeichnis in Windows NT.
Dienstprogramme 211

defncopy
-J Client-Zeichensatz
gibt den Zeichensatz an, der auf dem Client verwendet wird. Ein Filter
konvertiert die Eingabe zwischen Client-Zeichensatz und dem Adaptive
Server-Zeichensatz.
-J Client-Zeichensatz verlangt, dass Adaptive Server in und von Client-
Zeichensatz, dem Zeichensatz des Clients, konvertiert.
-J ohne Argument stellt die Zeichensatzkonvertierung auf NULL. Es findet
keine Konvertierung statt. Verwenden Sie dies, wenn der Client und der
Server denselben Zeichensatz verwenden.
Das Weglassen von -J stellt den Zeichensatz auf einen Standardwert der
Plattform ein. Der Standardwert ist nicht unbedingt der Zeichensatz, den
der Client verwendet. Weitere Hinweise über Zeichensätze und zugeordnete
Optionen finden Sie in der Dokumentation Systemadministration für
Adaptive Server Enterprise und in der Konfigurationsanleitung für Ihre
Plattform.
-K Keytab-Datei
gibt den Pfad zur Keytab-Datei an, die zur Authentifizierung in DCE
verwendet wird.
-P Kennwort
gibt Ihr Kennwort an. Wenn Sie -P nicht verwenden, fordert defncopy zur
Eingabe Ihres Kennworts auf.
-R entfernter_Hauptserver
legt den Hauptnamen für den Server fest. Standardmäßig entspricht der
Hauptname dem Netzwerknamen des Servers (der mit dem -S-Parameter
oder der DSQUERY-Umgebungsvariablen angegeben wird). Verwenden
Sie den -R-Parameter, wenn der Hauptname des Servers nicht mit seinem
Netzwerknamen übereinstimmt.
-S Servername
gibt den Namen der Adaptive Server-Installation an, mit dem die
Verbindung hergestellt werden soll. Wenn Sie -S ohne Argument eingeben,
sucht defncopy nach einem Server namens SYBASE. Wenn Sie -S nicht
angeben, verwendet defncopy den Server, der durch Ihre DSQUERY-
Umgebungsvariable festgelegt wird.
-U Benutzername
gibt einen Login-Namen an. Login-Namen reagieren auf Groß/
Kleinschreibung. Wenn Sie Benutzername nicht angeben, verwendet
defncopy den Betriebssystem-Login-Namen des aktuellen Benutzers.
212 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-V Sicherheitsoptionen
legt eine netzbasierte Benutzer-Authentifizierung fest. Bei dieser Option
muss sich der Benutzer beim Sicherheitssystem des Netzwerks anmelden,
bevor er das Dienstprogramm ausführt. In diesem Fall muss der Benutzer
den Netzwerk-Benutzernamen mit der-U-Option angeben; ein mit der
-P-Option angegebenes Kennwort wird ignoriert.
-V – Auf diesen Parameter kann eine Sicherheitsoptionen-Zeichenfolge
folgen, die Schlüsselzeichen für die Aktivierung zusätzliche
Sicherheitsdienste enthalten. Es gibt folgende Schlüsselzeichen:
c – Datenvertraulichkeitsdienst aktivieren
c – Datenintegritätsdienst aktivieren
m – Gegenseitige Authentifizierung für Verbindungserstellung
aktivieren
c – Abzeichnungsdienst für Datenursprung aktivieren
r – Datenwiedergabeermittlung aktivieren
q – Feststellung von Fehlern in der Sequenzreihenfolge aktivieren
-Z Sicherheitsmechanismus
legt den Namen eines Sicherheitsmechanismus fest, der bei der Verbindung
verwendet werden soll.
Namen für Sicherheitsmechanismen sind in der Konfigurationsdatei
$SYBASE/install/libtcl.cfg festgelegt. Wenn kein Name für den
Sicherheitsmechanismus angegeben ist, wird der Standardmechanismus
verwendet. Weitere Hinweise zu Namen für den Sicherheitsmechanismus
entnehmen Sie der Beschreibung der libtcl.cfg-Datei in der Dokumentation
Open Client/Server Configuration Guide.
-z Sprache
ist der offizielle Name einer Alternativsprache, die der Server zur Anzeige
von defncopy-Eingabeaufforderungen und Meldungen verwendet. Ohne die
-z-Option verwendet defncopy die Standardsprache des Servers.
Sie fügen Sprachen einem Adaptive Server-System während der Installation
hinzu, oder später mit dem Dienstprogramm langinstall (langinst in
Windows NT) bzw. mit der gespeicherten Prozedur sp_addlanguage.
Dienstprogramme 213

defncopy
in | out
legt die Richtung der Definitionskopie fest.
Dateiname
legt den Namen der Betriebssystemdatei (Ziel oder Quelle) für die
Definitionskopie fest. Die Kopie überschreibt etwaig vorhandene Dateien.
Datenbankname
legt den Namen der Datenbank fest, aus der oder in die die Definitionen
kopiert werden.
Eigentümer
ist fakultativ, wenn Ihnen oder dem Datenbankeigentümer die Tabelle
gehört, die kopiert wird. Wenn Sie keinen Eigentümer angeben, sucht
defncopy zuerst nach einer Tabelle dieses Namens, die Ihnen gehört, und
dann nach einer, die dem Datenbankeigentümer gehört. Wenn die Tabelle
einem anderen Benutzer gehört, müssen Sie den Namen des Eigentümers
angeben, oder der Befehl schlägt fehl.
Objektname
gibt die Namen von Datenbankobjekten an, die defncopy aus einer
Datenbank kopieren soll. Verwenden Sie objectname nicht, wenn Sie
Definitionen in die Datenbank kopieren.
-v
zeigt Versionsnummer und Copyright-Meldung von defncopy an und kehrt
zum Betriebssystem zurück.
Beispiele Beispiel 1 Kopiert Definitionen aus der Datei new_proc in die Datenbank
stagedb auf dem Server MERCURY. Die Verbindung mit MERCURY wird
mit dem Benutzernamen „sa“ und einem NULL-Kennwort hergestellt:
defncopy -Usa -P -SMERCURY in new_proc stagedb
Beispiel 2 Kopiert Definitionen für die Objekte sp_calccomp und sp_vacation
aus der employees-Datenbank auf dem SYBASE-Server in die Datei dc.out.
Meldungen und Eingabeaufforderungen werden auf Französisch angezeigt.
Der Benutzer wird zur Eingabe eines Kennworts aufgefordert:
defncopy -S -z french out dc.out employees sp_calccomp sp_vacation
214 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Syntax Verwenden Sie diese Syntax bei defncopy_r, wenn Sie Thread-Treiber
verwenden.
Verwenden Sie diese Syntax bei defncopy_dce, wenn Sie Thread-Treiber
auf der IBM-Plattform verwenden.
Sie müssen die SYBASE-Umgebungsvariable auf die Position der
aktuellen Version der Adaptive Server-Installation einstellen, bevor
Sie defncopy verwenden können.
Das defncopy -Dienstprogramm kann keine Tabellendefinitionen oder
Protokolle kopieren, die mit Report Workbench erstellt wurden.
Rufen Sie das defncopy-Programm direkt vom Betriebssystem auf.
defncopy stellt eine nicht-interaktive Möglichkeit dar, Definitionen
(create-Anweisungen) für Ansichten, Regeln, Standardwerte, Trigger
und Prozeduren von einer Datenbank auf eine Betriebssystemdatei zu
kopieren. Oder Sie können alle Definitionen aus einer angegebenen Datei
in eine Datenbank kopieren.
Die Angabe von in Dateiname oder out Dateiname und des
Datenbanknamens ist erforderlich und muss eindeutig sein. Beim
Kopieren aus einer Datenbank verwenden Sie Dateinamen, die sowohl
auf den Namen des Objekts als auch auf seinen Eigentümer verweisen.
defncopy beendet jede Definition, die aus einer Datenbank kopiert wird,
mit folgendem Kommentar:
/* ### DEFNCOPY: END OF DEFINITION */
Definitionen, die Sie als Text erstellen, müssen mit diesem Kommentar
aufhören, da defncopy sie sonst nicht erfolgreich kopieren kann.
Setzen Sie in defncopy angegebene Werte in Klammern, wenn sie Zeichen
enthalten, die für die Shell möglicherweise signifikant sind.
Achtung! Lange Kommentare mit mehr als 100 Zeichen, die vor einer
create-Anweisung platziert sind, können dazu führen, dass defncopy
fehlschlägt.
Berechtigungen Sie müssen die select-Berechtigung für die sysobjects- und syscomments-
Tabellen haben, um Definitionen zu kopieren; Sie benötigen nicht die
Berechtigung für das Objekt selbst.
Dienstprogramme 215

defncopy
Benutzte Tabellen syscomments, sysobjects
Siehe auch Befehle create, select
Sie haben möglicherweise keine select-Berechtigung für die text-Spalte
der syscomments-Tabelle, wenn der Sicherheitsadministrator (SSO)
den allow select on syscomments.text column-Parameter mit der
Systemprozedur sp_configure wiederhergestellt hat. Diese Neueinstellung
beschränkt die select-Berechtigung auf den Objekteigentümer und den
Systemadministrator. Diese Einschränkung ist erforderlich, um Adaptive
Server in der bewerteten Konfiguration auszuführen, wie in der
Installations- und Konfigurationsdokumentation für Ihre Plattform
beschrieben. In diesem Fall muss der Objekteigentümer oder der System-
Administrator defncopy ausführen, um Definitionen zu exportieren.
Hinweis Wenn der Text verschlüsselt wurde, kann er vor Ihnen verborgen
sein, auch wenn Sie alle erforderlichen Berechtigungen haben. Nähere
Informationen hierzu finden Sie unter „Verifying and Encrypting Source
Text“ in der Dokumentation Transact-SQL User’s Guide.
Sie müssen die entsprechende create-Berechtigung für den Typ von
Objekten haben, den Sie in eine Datenbank kopieren. Importierte Objekte
gehören dem Kopierer. Ein System-Administrator, der Definitionen im
Auftrag eines Benutzers in eine Datenbank kopiert, muss sich unter
dem Namen dieses Benutzers anmelden, um ihm den Zugriff auf die
wiedererstellten Datenbankobjekte zu ermöglichen.
Systemprozeduren sp_addlanguage, sp_checkreswords, sp_configure,
sp_procqmode, sp_remap
Dienstprogramme langinstall
216 Adaptive Server Enterprise

dscp
Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beschreibung Nur UNIX-Plattformen Ermöglicht es Ihnen, auf UNIX-Plattformen
Servereinträge in der Interfaces-Datei von der Befehlszeile aus anzuzeigen
und zu bearbeiten. Standort ist $SYBASE/$SYBASE_OCS/bin.
Syntax dscp [-p]
oder
dscp -v
So beenden Sie dscp:
quit
oder
exit
Parameter -p
unterdrückt Eingabeaufforderungen in der Befehlszeile.
-v
zeigt Versionsnummer und Copyright-Meldung von dscp an und kehrt zum
Betriebssystem zurück.
Beispiele Öffnet die Standard-Interfaces-Datei zur Bearbeitung und unterdrückt die
Eingabeaufforderung in der Befehlszeile.
dscp -p
Syntax Verwenden Sie diese Syntax bei dscp_r, wenn Sie Thread-Treiber
verwenden.
Verwenden Sie diese Syntax bei dscp_dce, wenn Sie Thread-Treiber
auf der IBM-Plattform verwenden
Sie müssen die SYBASE-Umgebungsvariable auf die Position der
aktuellen Version der Adaptive Server-Installation einstellen, bevor Sie
dscp verwenden können.
Das dscp-Dienstprogramm ist ein auf Text basierendes Dienstprogramm.
In Kapitel 5, „dscp verwenden“ finden Sie weitere Hinweise über das
dscp-Dienstprogramm.
Siehe auch Dienstprogramme dsedit
Dienstprogramme 217

dsedit
dsedit
Beschreibung UNIX-Plattformen Das dsedit-Dienstprogramm ermöglicht es Ihnen,
auf UNIX-Plattformen Servereinträge in der Interfaces-Datei anzuzeigen
und zu bearbeiten, indem Sie eine auf X11/Motif basierende grafische
Benutzeroberfläche (GUI) verwenden. Das Dienstprogramm befindet
sich unter $SYBASE/$SYBASE_OCS/bin.
Windows NT Das Dienstprogramm dsedit.exe erstellt und ändert
Netzwerkverbindungsinformationen in der Interfaces-Datei. Das
Dienstprogramm befindet sich unter %SYBASE%\%SYBASE_OCS%bin.
Syntax dsedit
oder
dsedit -v
Parameter -v
zeigt Versionsnummer und Copyright-Meldung von dsedit an.
Syntax Verwenden Sie diese Syntax bei dsedit_r, wenn Sie Thread-Treiber
verwenden.
Verwenden Sie diese Syntax bei dsedit_dce, wenn Sie Thread-Treiber
auf der IBM-Plattform verwenden.
Sie müssen die SYBASE-Umgebungsvariable auf die Position der
aktuellen Version der Adaptive Server-Installation einstellen, bevor Sie
dsedit verwenden können.
Siehe auch Dienstprogramme dscp
Sie müssen die DISPLAY-Umgebungsvariable einstellen, bevor Sie dsedit
aufrufen, außer Sie verwenden den -v-Parameter, um die Versionsnummer
anzuzeigen.
Weitere Hinweise über das dsedit-Dienstprogramm finden Sie in
Kapitel 4, „dsedit verwenden“ sowie in der Installationsanleitung
und der Konfigurationsanleitung für Ihre Plattform.
218 Adaptive Server Enterprise

extractjava
Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beschreibung Kopiert eine gespeicherte JAR-Datei und die darin enthaltenen Klassen
von einer Adaptive Server-Installation in eine Clientdatei. Standort ist
$SYBASE/$SYBASE_OCS/bin.
Unter Windows NT Das Dienstprogramm heißt extrjava.exe und befindet
sich unter %SYBASE%\%SYBASE_OCS%\bin.
Syntax extractjava (extrjava in Windows NT)
-j jar-Name
-f Dateiname
[-S Servername]
[-U Benutzername]
[-P Kennwort]
[-D Datenbankname]
[-I Interfaces-Datei]
[-a Anzeige-Zeichensatz]
[-J Client-Zeichensatz]
[-z Sprache]
[-t Zeitüberschreitung]
[-v]
Oder
extractjava -v
Parameter -j jar-Name
der Name, der der gespeicherten JAR-Dateien in der Datenbank zugeordnet
ist, die die Quelle der Übertragung ist.
-f Dateiname
der Name der Clientdatei, die das Ziel der Übertragung ist.
-S Servername
der Name des Servers.
-U Benutzername
ein Adaptive Server-Login-Name. Wenn Sie die -U-Option und Parameter
weglassen oder die -U-Option ohne Parameter angeben, verwendet Adaptive
Server den Betriebssystem-Login-Namen des aktuellen Benutzers.
-P Kennwort
ein Adaptive Server-Kennwort. Wenn Sie die -P-Option und Parameter
weglassen, fordert Sie extractjava zur Eingabe eines Kennworts auf.
Wenn Sie die -P-Option ohne Kennwort angeben, wird das Null-Kennwort
verwendet.
Dienstprogramme 219

extractjava
-D Datenbankname
der Name der Datenbank, in der die JAR-Datei installiert werden soll. Wenn
Sie die -D-Option weglassen oder die -D-Option ohne Parameter angeben,
wird die Standarddatenbank des Benutzers verwendet.
-I Interfaces-Datei
der Name und die Position der Interfaces-Datei, die durchsucht werden soll,
wenn mit Adaptive Server verbunden wird. Wenn Sie die -I-Option und
Parameter weglassen oder die -I-Option ohne Parameter angeben, wird die
Interfaces-Datei in dem Verzeichnis verwendet, auf das Ihre SYBASE-
Umgebungsvariable verweist.
-a Anzeige-Zeichensatz
damit können Sie extractjava von einem Rechner aus verwenden, dessen
Zeichensatz sich von dem des Servers unterscheidet. -a in Verbindung mit -J
gibt die Zeichensatzkonvertierungs-Datei (.xlt-Datei) an, die für die
Konvertierung erforderlich ist. Verwenden Sie -a ohne -J nur dann,
wenn der Client-Zeichensatz mit dem Standardzeichensatz identisch ist.
-J Client-Zeichensatz
gibt den Zeichensatz an, der auf dem Client verwendet wird. extractjava
verwendet einen Filter, um die Eingabe zwischen Client-Zeichensatz und
dem Adaptive Server-Zeichensatz zu konvertieren.
-J Client-Zeichensatz verlangt, dass Adaptive Server in und von Client-
Zeichensatz, dem auf dem Client verwendeten Zeichensatz, konvertiert.
-J ohne Argument deaktiviert die Zeichensatz-Konvertierung. Verwenden
Sie diese Einstellung, wenn Client und Server denselben Zeichensatz
verwenden.
Das Weglassen von -J stellt den Zeichensatz auf einen Standardwert der
Plattform ein, der nicht unbedingt der Zeichensatz ist, den der Client
verwendet. Weitere Hinweise über Zeichensätze und ihre zugeordneten
Optionen finden Sie in den Dokumentation Systemadministration für
Adaptive Server Enterprise.
-z Sprache
der Name einer Alternativsprache, um extractjava-Eingabeaufforderungen
und -Meldungen anzuzeigen. Ohne die -z-Option verwendet extractjava die
Standardsprache des Servers. Sie können einem Adaptive Server-System
während der Installation oder später mit dem langinstall-Dienstprogramm
bzw. mit der gespeicherten Prozedur sp_addlanguage andere Sprachen
hinzufügen.
220 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-t Zeitüberschreitung
legt die Anzahl der Sekunden fest, bevor für den SQL-Befehl eine
Zeitüberschreitung eintritt. Wenn Sie keine Zeitüberschreitung festlegen,
wird ein Befehl ohne Zeitbeschränkung ausgeführt. Das wirkt sich auf
Befehle aus, die von extractjava ausgegeben werden, und nicht auf die
Verbindungszeit. Die Standard-Zeitüberschreitung zum Anmelden bei
extractjava beträgt 60 Sekunden.
-v
gibt die Versionsnummer und Copyright-Meldung für extractjava an und
beendet dann.
Beispiele Lädt die der employees-JAR-Datei zugeordneten Klassen in die Clientdatei
newaddr.jar herunter.
UNIX:
extractjava -j employees -f '/home/usera/jars/addr.jar' -new
Windows NT:
extrjava -j employees -f '\home\usera\jars\addr.jar' -new
Syntax Sie müssen die SYBASE-Umgebungsvariable auf die Position der
aktuellen Version der Adaptive Server-Installation einstellen, bevor Sie
extractjava verwenden können.
Wenn die Ziel-Clientdatei bereits existiert, wird ihr Inhalt von extractjava
überschrieben.
Die Parameteroptionen -f, -j, -S, -U, -P, -D und -I können mit oder ohne
Leerstelle zwischen dem Optionsbuchstaben und dem folgenden
Parameter geschrieben werden.
Wenn Sie extractjava ausführen, wird eine Exklusivsperre auf
sysxtypes gelegt.
Wenn -jar angegeben ist, wird eine exklusive Tabellensperre auf
sysjars gelegt.
Weitere Hinweise über die Verwendung dieses Dienstprogramms, wenn
Java in der Datenbank aktiviert ist, finden Sie in der Dokumentation Java
in Adaptive Server Enterprise.
Dienstprogramme 221

installjava
Berechtigungen Sie müssen Systemadministrator oder Datenbankeigentümer sein,
um extractjava auszuführen.
Benutzte Tabellen sysjars, sysxtypes
Siehe auch Befehle remove java
installjava
Systemprozeduren sp_helpjava
Dienstprogramme installjava
Beschreibung Installiert eine JAR-Datei von einer Clientdatei in eine Adaptive Server-
Installation. Das Dienstprogramm befindet sich unter $SYBASE/
$SYBASE_OCS/bin.
Windows NT Das Dienstprogramm heißt instjava.exe und befindet sich unter
%SYBASE%\%SYBASE_OCS%\bin.
Syntax installjava
-f Dateiname
[ -new | -update ]
[ -j jar-Name ]
[ -S Servername ]
[ -U Benutzername ]
[ -P Kennwort ]
[ -D Datenbankname ]
[ -I Interfaces-Datei ]
[ -a Anzeige-Zeichensatz ]
[ -J Client-Zeichensatz ]
[ -z Sprache ]
[ -t Zeitüberschreitung ]
[-v]
Oder
installjava -v
Parameter -f Dateiname
der Name der Quellendatei, die die Klassen enthält, die in der Datenbank
installiert werden sollen.
222 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-new | -update
legt fest, ob die Klassen in der Datei bereits in der Datenbank
vorhanden sind.
Wenn Sie den new-Parameter angeben, können Sie keine Klasse mit dem
Namen einer vorhandenen Klasse installieren.
Wenn Sie den update-Parameter angeben, können Sie eine Klasse mit
dem Namen einer vorhandenen Klasse installieren, und die neu installierte
Klasse ersetzt die vorhandene Klasse.
-j jar-Name
der Name der JAR-Datei, die die Klassen enthält, die in der Datenbank
installiert werden sollen. Zeigt an, dass die JAR-Datei in der Datenbank
gespeichert und den in ihr enthaltenen Klassen zugeordnet werden soll.
-S Servername
der Name des Servers.
-U Benutzername
ein Adaptive Server-Login-Name. Wenn Sie die -U-Option und Parameter
weglassen oder die -U-Option ohne Parameter angeben, verwendet Adaptive
Server den Betriebssystem-Login-Namen des aktuellen Benutzers.
-P Kennwort
ein Adaptive Server-Kennwort. Wenn Sie die -P-Option und Parameter
weglassen, fordert Sie installjava zur Eingabe eines Kennworts auf. Wenn
Sie die -P-Option ohne Kennwort angeben, wird das Null-Kennwort
verwendet.
-D Datenbankname
der Name der Datenbank, in der die JAR-Datei installiert werden soll. Wenn
Sie die -D-Option weglassen oder die -D-Option ohne Parameter angeben,
wird die Standarddatenbank des Benutzers verwendet.
-I Interfaces-Datei
der Name und die Position der Interfaces-Datei, die durchsucht werden soll,
wenn mit Adaptive Server verbunden wird. Wenn Sie die -I-Option und
Parameter weglassen oder die -I-Option ohne Parameter angeben, wird die
Interfaces-Datei in dem Verzeichnis verwendet, auf das Ihre SYBASE-
Umgebungsvariable verweist.
Dienstprogramme 223

installjava
-a Anzeige-Zeichensatz
damit können Sie installjava von einem Rechner aus verwenden, dessen
Zeichensatz sich von dem des Servers unterscheidet. -a in Verbindung mit -J
gibt die Zeichensatzkonvertierungs-Datei (.xlt-Datei) an, die für die
Konvertierung erforderlich ist. Verwenden Sie -a ohne -J nur dann,
wenn der Client-Zeichensatz mit dem Standardzeichensatz identisch ist.
-J Client-Zeichensatz
gibt den Zeichensatz an, der auf dem Client verwendet wird. installjava
verwendet einen Filter, um die Eingabe zwischen Client-Zeichensatz und
dem Adaptive Server-Zeichensatz zu konvertieren.
-J Client-Zeichensatz verlangt, dass Adaptive Server in und von Client-
Zeichensatz, dem auf dem Client verwendeten Zeichensatz, konvertiert.
-J ohne Argument deaktiviert die Zeichensatz-Konvertierung. Verwenden
Sie diese Einstellung, wenn Client und Server denselben Zeichensatz
verwenden.
Das Weglassen von -J stellt den Zeichensatz auf einen Standardwert der
Plattform ein, der nicht unbedingt der Zeichensatz ist, den der Client
verwendet. Weitere Hinweise über Zeichensätze und ihre zugeordneten
Optionen finden Sie in den Dokumentation Systemadministration für
Adaptive Server Enterprise.
-z Sprache
der Name einer Alternativsprache, um installjava-Eingabeaufforderungen
und -Meldungen anzuzeigen. Ohne die -z-Option verwendet installjava die
Standardsprache des Servers. Sie können einem Adaptive Server-System
während der Installation oder später mit dem langinstall-Dienstprogramm
bzw. mit der gespeicherten Prozedur sp_addlanguage andere Sprachen
hinzufügen.
-t Zeitüberschreitung
legt die Anzahl der Sekunden fest, bevor für den SQL-Befehl eine
Zeitüberschreitung eintritt. Wenn Sie keine Zeitüberschreitung festlegen,
wird ein Befehl ohne Zeitbeschränkung ausgeführt. Das wirkt sich auf
Befehle aus, die von installjava ausgegeben werden, und nicht auf die
Verbindungszeit. Die Standard-Zeitüberschreitung zum Anmelden bei
installjava beträgt 60 Sekunden.
-v
gibt die Versionsnummer und Copyright-Meldung für installjava an und
beendet dann.
224 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beispiele Beispiel 1 Installiert addr.jar und ihre Klassen, hält aber nicht die Zuordnung
zwischen der JAR-Datei und den Klassen aufrecht:
installjava -f '/home/usera/jars/addr.jar' -new
In Windows NT:
instjava -f '\home\usera\jars\addr.jar' -new
Beispiel 2 Reinstalliert addr.jar und ordnet ihre Klassen dem employees-JAR-
Dateinamen zu:
installjava -f '/home/usera/jars/addr.jar' -update -j employees
In Windows NT:
instjava -f '\home\usera\jars\addr.jar' -update -j employees
Syntax Sie müssen die SYBASE-Umgebungsvariable auf die Position der
aktuellen Version der Adaptive Server-Installation einstellen, bevor Sie
installjava verwenden können.
Weitere Hinweise über die Verwendung dieses Dienstprogramms,
wenn Java in der Datenbank aktiviert ist, finden Sie in der Dokumentation
Java in Adaptive Server Enterprise.
Jeder Benutzer kann installierte Klassen referenzieren.
Die Parameteroptionen -f, -j, -S, -U, -P, -D und -I können mit oder ohne
Leerstelle zwischen dem Optionsbuchstaben und dem folgenden
Parameter geschrieben werden.
Neue JAR-Dateien hinzufügen
Wenn Sie „new“ mit der -jar-Option verwenden und eine JAR-Datei
dieses Namens bereits auf der Datenbank vorhanden ist, tritt eine
Ausnahmebedingung ein.
Wenn irgendwelche Klassen desselben Namens wie die in der Quellen-
JAR-Datei bereits in der Datenbank vorhanden sind, tritt eine
Ausnahmebedingung ein.
JAR-Dateien und Klassen aktualisieren
Achtung! Wenn Sie eine Klasse ändern, die als ein Spaltendatentyp verwendet
wird, indem Sie eine geänderte Version der Klasse reinstallieren, müssen
Sie sicherstellen, dass die geänderte Klasse vorhandene Objekte (Zeilen)
in Tabellen lesen und verwenden kann, die diese Klasse als Datentyp
verwenden. Sonst sind Sie möglicherweise nicht in der Lage, auf diese
Objekte zuzugreifen, ohne die Klasse zu reinstallieren.
Dienstprogramme 225

installjava
Wenn Sie -update mit der -jar-Option verwenden, tritt Folgendes ein:
Alle Klassen in der Datenbank, die der JAR-Datei zugeordnet sind,
werden aus der Datenbank gelöscht und die Klassen in der Quellen-
JAR-Datei werden installiert.
Wenn eine Klasse in der Quellen-JAR-Datei bereits in der Datenbank
installiert ist, ohne einer JAR-Datei zugeordnet zu sein, dann wird die
Klasse in der Quellen-JAR-Datei in der Datenbank installiert, und die
nicht zugeordnete Klasse wird gelöscht.
Wenn Sie -update ohne die -jar-Option verwenden, tritt Folgendes ein:
Klassen in der Quellen-JAR-Datei ersetzen nicht zugeordnete
Klassen desselben Namens.
Klassen in der Quellen-JAR-Datei, die keiner installierten Klasse
entsprechen, werden als nicht zugeordnete Klassen in der Datenbank
installiert.
Wenn Sie eine neue JAR-Datei mit einem Ersatz für eine installierte
Klasse installieren, die von einer SQLJ-Prozedur oder -Funktion
referenziert wird, stellen Sie sicher, dass die neu installierte Klasse eine
gültige Signatur für die SQLJ-Routine hat. Wenn die Signatur ungültig ist,
wird eine Ausnahmebedingung ausgelöst, wenn die SQLJ-Routine
aufgerufen wird.
Sperren
Wenn Sie installjava ausführen, wird eine Exklusivsperre auf
sysxtypes gelegt.
Wenn -jar angegeben ist, wird eine exklusive Tabellensperre auf
sysjars gelegt.
Berechtigungen Sie müssen Systemadministrator oder Datenbankeigentümer sein,
um installjava auszuführen.
Benutzte Tabellen sysjars, sysxtypes
Siehe auch Befehle remove java
Systemprozeduren sp_helpjava
Dienstprogramme extractjava
226 Adaptive Server Enterprise

isql
Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beschreibung Interactive SQL-Parser von Adaptive Server. Standort ist $SYBASE/
ASE-12_5/bin.
Windows NT Das Dienstprogramm heißt isql.exe unter %SYBASE%\
ASE-12_5\bin.
Syntax isql [-b] [-e] [-F] [-p] [-n] [-v] [-X] [-Y] [-Q]
[-a Anzeige-Zeichensatz]
[-A Paketgröße]
[-c Befehlsende]
[-D Datenbank]
[-E Editor]
[-h Header]
[-H Hostname]
[-i Eingabedatei]
[-I Interfaces-Datei]
[-J Client-Zeichensatz]
[-K Keytab-Datei]
[-l Login-Zeitüberschreitung]
[-m Fehlerebene]
[-o Ausgabedatei]
[-P Kennwort]
[-R entfernter_Hauptserver]
[-s Spaltentrennzeichen]
[-S Servername]
[-t Zeitüberschreitung]
-U Benutzername
[-V [Sicherheitsoptionen]]
[-w Spaltenbreite]
[-z Sprachumgebung-Name]
[-Z Sicherheitsmechanismus]
So beenden Sie einen Befehl:
go
So löschen Sie den Abfragepuffer:
reset
So rufen Sie den Standard-Editor auf:
vi
Dienstprogramme 227

isql
Parameter -b
So führen Sie einen Betriebssystembefehl aus:
!! Befehl
So beenden Sie isql:
oder
quit
exit
deaktiviert die Anzeige der Tabellen-Header-Ausgabe.
-e
zeigt die Eingabe an (Echo).
-F
aktiviert den FIPS-Flagger. Wenn Sie den -F-Parameter angeben, gibt der
Server eine Meldung zurück, wenn er auf einen Nicht-Standard-SQL-
Befehl stößt. Diese Option deaktiviert nicht die SQL-Erweiterungen. Die
Prozessverarbeitung wird fortgesetzt, wenn Sie den nicht zum ANSI-
Standard gehörenden SQL-Befehl eingeben.
-p
druckt Performance-Statistiken.
-n
-v
entfernt die Nummerierung und das Eingabeaufforderungssymbol (>)
aus Eingabezeilen in der Ausgabedatei, wenn es zusammen mit -e
verwendet wird.
gibt die Versionsnummer und Copyright-Meldung für isql an und
beendet dann.
-X
stellt das Login in dieser Verbindung zum Server mit
Kennwortverschlüsselung durch den Client her. isql (der Client) gibt
dem Server bekannt, dass die Kennwortverschlüsselung gewünscht wird.
Der Server sendet einen Verschlüsselungsschlüssel zurück, den isql zur
Verschlüsselung Ihres Kennworts verwendet, und der Server verwendet den
Schlüssel, um die Zugangserlaubnis Ihres Kennworts zu überprüfen, wenn
es ankommt.
Wenn isql ausfällt, erstellt das System eine Core-Datei, die Ihr Kennwort
enthält. Wenn Sie die Verschlüsselungsoption nicht verwendet haben,
wird Ihr Kennwort als normaler Text in der Datei angezeigt. Wenn Sie
die Verschlüsselungsoption verwenden, ist Ihr Kennwort nicht lesbar.
228 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-Y
weist Adaptive Server an, verkettete Transaktionen zu verwenden.
-Q
stattet Clients mit der Failover-Eigenschaft aus. Weitere Hinweise finden
Sie in der Dokumentation Using Sybase Failover in a High Availability
System.
-a Anzeige-Zeichensatz
führt isql von einem Terminal aus, dessen Zeichensatz von dem des
Rechners, auf dem isql läuft, verschieden ist. -a in Verbindung mit -J gibt die
Zeichensatzkonvertierungs-Datei (.xlt-Datei) an, die für die Konvertierung
erforderlich ist. Verwenden Sie -a ohne -J nur dann, wenn der Client-
Zeichensatz mit dem Standardzeichensatz identisch ist.
Hinweis Der ascii_7-Zeichensatz ist mit allen anderen Zeichensätzen
kompatibel. Wenn entweder der Adaptive Server- oder der Clientzeichensatz
auf ascii_7 eingestellt ist, können alle 7-Bit-ASCII-Zeichen unverändert
zwischen Client und Server übermittelt werden. Andere Zeichen erzeugen
Konvertierungsfehler. Weitere Hinweise über Zeichensatz-Konvertierung
finden Sie in der Dokumentation Systemadministration für Adaptive
Enterprise.
-A Paketgröße
gibt die Netzwerk-Paketgröße an, die in dieser isql-Sitzung verwendet
werden soll. Der folgende Befehl zum Beispiel stellt die Paketgröße auf
2048 Byte für die aktuelle isql-Sitzung ein:
isql -A 2048
Um Ihre Netzwerk-Paketgröße zu überprüfen, geben Sie Folgendes ein:
select * from sysprocesses
Der Wert wird unter der Überschrift network_pktsz angezeigt.
Größe muss zwischen den Werten der Konfigurationsparameter default
network packet size und maximum network packet size liegen und ein
Vielfaches von 512 sein.
Verwenden Sie Paketgrößen, die größer als der Standardwert sind,
um I/O-intensive Vorgänge wie zum Beispiel readtext oder writetext
durchzuführen.
Das Einstellen oder das Ändern der Paketgröße von Adaptive Server
wirkt sich auf die Paketgröße eines Remote Procedure Calls nicht aus.
Dienstprogramme 229

isql
-c Befehlsende
ändert das Befehlsabschlusszeichen. Standardmäßig sollten Sie Befehle
abschließen und an die Adaptive Server-Installation senden, indem Sie „go“
auf einer eigenen Zeile eingeben. Wenn Sie das Befehlsabschlusszeichen
ändern, dürfen Sie keine reservierten SQL-Wörter oder Steuerungszeichen
verwenden.
-D Datenbank
wählt die Datenbank aus, in der die isql-Sitzung beginnt.
-E Editor
legt einen anderen Editor als den Standard-Editor vi fest.
-h Header
bestimmt die Anzahl der Zeilen, die zwischen den Spaltentiteln gedruckt
werden sollen. Mit der Standardeinstellung werden Überschriften nur
einmal pro Abfrageergebnis ausgegeben.
-H Hostname
legt den Hostnamen des Clients fest.
-i Eingabedatei
gibt den Namen einer Betriebssystemdatei an, die die Eingaben für
isql enthält. Die Datei muss Befehlsabschlusszeichen enthalten
(standardmäßig „go“).
Wenn Sie den Parameter folgendermaßen eingeben, ist er äquivalent zu
< Eingabedatei:
-i Eingabedatei
Wenn Sie -i verwenden und in der Befehlszeile Ihr Kennwort nicht
eingeben, fordert isql Sie zur Eingabe des Kennworts auf.
Wenn Sie < Eingabedatei verwenden und in der Befehlszeile Ihr
Kennwort nicht eingeben, müssen Sie Ihr Kennwort als erste Zeile in
die Eingabedatei einfügen.
-I Interfaces-Datei
gibt den Namen und die Position der Interfaces-Datei an, die durchsucht
werden soll, wenn eine Verbindung mit Adaptive Server hergestellt wird.
Wenn Sie für -I keine Angaben machen, sucht isql nach einer Datei namens
interfaces, die sich im von der SYBASE-Umgebungsvariablen
angegebenen Verzeichnis befindet.
230 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-J Client-Zeichensatz
gibt den Zeichensatz an, der auf dem Client verwendet wird. -J Client-
Zeichensatz verlangt, dass Adaptive Server in und von Client-Zeichensatz,
dem auf dem Client verwendeten Zeichensatz, konvertiert. Ein Filter
konvertiert die Eingabe zwischen Client-Zeichensatz und dem Adaptive
Server-Zeichensatz.
-J ohne Argument stellt die Zeichensatzkonvertierung auf NULL. Es findet
keine Konvertierung statt. Verwenden Sie diese Einstellung, wenn Client
und Server denselben Zeichensatz verwenden.
Das Weglassen von -J stellt den Zeichensatz auf einen Standardwert der
Plattform ein. Der Standard ist nicht unbedingt der Zeichensatz, den der
Client verwendet. Weitere Hinweise über Zeichensätze und zugeordnete
Optionen finden Sie in Kapitel 20, „Konfiguration der Client/Server-
Zeichensatzkonvertierung“, in der Dokumentation Systemadministration
für Adaptive Server Enterprise. Die Standardzeichensätze für verschiedene
Plattformen sind folgende:
Plattform Standardzeichensatz
Sun Solaris, Digital UNIX, Pyramid, NCR, RS/6000 iso_1
HP-UX roman8
OS/2, Novell NetWare 386 cp850
Macintosh mac
-K Keytab-Datei
gibt den Pfad zur Keytab-Datei an, die zur Authentifizierung in DCE
verwendet wird.
-l Login-Zeitüberschreitung
legt den maximalen Zeitüberschreitungswert fest, der bei der Verbindung zu
Adaptive Server erlaubt ist. Der Standard beträgt 60 Sekunden. Dieser Wert
wirkt sich nur auf die Zeitspanne aus, in der isql auf den Server wartet, um
auf einen Login-Versuch zu antworten. Um einen Zeitüberschreitungszeitraum
für Prozessverarbeitung festzulegen, verwenden Sie den -t timeout-
Parameter.
-m Fehlerebene
passt die Fehlermeldungsanzeige an. Bei Fehlern mit dem angegebenen
Schweregrad oder höher werden nur die Meldungsnummer, der Status und
die Fehlerebene angezeigt. Der Fehlertext wird weggelassen. Bei Fehlern
unterhalb der angegebenen Fehlerebene erfolgt keine Anzeige.
Dienstprogramme 231

isql
-o Ausgabedatei
gibt den Namen einer Betriebssystemdatei an, in der die Eingaben von isql
gespeichert werden sollen. Die Angabe des Parameters als -o Ausgabedatei
entspricht > Ausgabedatei.
-P Kennwort
gibt Ihr Adaptive Server-Kennwort an. Wenn Sie die -P-Option nicht
angeben, fordert isql zur Eingabe eines Kennworts auf. Wenn Ihr Kennwort
NULL ist, verwenden Sie die -P-Option ohne Kennwort.
-R entfernter_Hauptserver
legt den Hauptnamen für den Server fest, wie vom Sicherheitsmechanismus
definiert. Standardmäßig entspricht der Hauptname dem Netzwerknamen
des Servers (der mit dem -S-Parameter oder der DSQUERY-Umgebungsvariablen
angegeben wird). Verwenden Sie den -R-Parameter, wenn der
Hauptname des Servers nicht mit seinem Netzwerknamen übereinstimmt.
-s Spaltentrennzeichen
stellt das Spaltentrennungszeichen neu ein, das standardmäßig leer ist.
Um Zeichen verwenden zu können, die eine spezielle Bedeutung für das
Betriebssystem haben (zum Beispiel „|“, „;“, „&“, „“), schließen Sie
sie in Anführungszeichen ein oder stellen ihnen einen Rückstrich voran.
-S Servername
gibt den Namen der Adaptive Server-Installation an, mit dem die
Verbindung hergestellt werden soll. isql sucht nach diesem Namen in der
Interfaces-Datei. Wenn Sie -S ohne Argument eingeben, sucht ISQL nach
einem Server namens SYBASE. Wenn Sie -S nicht angeben, sucht isql nach
dem Server, der durch Ihre DSQUERY-Umgebungsvariable festgelegt wird.
-t Zeitüberschreitung
legt die Anzahl der Sekunden fest, bevor für den SQL-Befehl eine
Zeitüberschreitung eintritt. Wenn Sie keine Zeitüberschreitung festlegen,
wird ein Befehl ohne Zeitbeschränkung ausgeführt. Das wirkt sich
auf Befehle aus, die von isql ausgegeben werden, und nicht auf die
Verbindungszeit. Die Standard-Zeitüberschreitung zum Anmelden bei
isql beträgt 60 Sekunden.
-U Benutzername
gibt einen Login-Namen an. Login-Namen reagieren auf
Groß/Kleinschreibung.
232 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-V Sicherheitsoptionen
legt eine netzbasierte Benutzer-Authentifizierung fest. Bei dieser Option
muss sich der Benutzer beim Sicherheitssystem des Netzwerks anmelden,
bevor er das Dienstprogramm ausführt. In diesem Fall muss der Benutzer
den Netzwerk-Benutzernamen mit der-U-Option angeben; ein mit der
-P-Option angegebenes Kennwort wird ignoriert.
-V – Auf diesen Parameter kann eine Sicherheitsoptionen-Zeichenfolge
folgen, die Schlüsselzeichen für die Aktivierung zusätzliche
Sicherheitsdienste enthalten. Es gibt folgende Schlüsselzeichen:
c – Datenvertraulichkeitsdienst aktivieren
c – Datenintegritätsdienst aktivieren
m – Gegenseitige Authentifizierung für Verbindungserstellung
aktivieren
c – Abzeichnungsdienst für Datenursprung aktivieren
q – Feststellung von Fehlern in der Sequenzreihenfolge aktivieren
r – Datenwiedergabeermittlung aktivieren
-w Spaltenbreite
stellt die Bildschirmbreite für die Ausgabe ein. Der Standardwert ist
80 Zeichen. Wenn eine Ausgabezeile die maximale Bildschirmbreite
erreicht, wird sie in mehrere Ausgabezeilen umgebrochen.
-z Sprachumgebung-Name
ist der offizielle Name einer Alternativsprache zur Anzeige von isql-
Eingabeaufforderungen und Meldungen. Ohne -z verwendet isql die
Standardsprache des Servers. Sie können einem Adaptive Server-System
während der Installation oder später mit dem langinstall-Dienstprogramm
bzw. mit der gespeicherten Prozedur sp_addlanguage andere Sprachen
hinzufügen.
-Z Sicherheitsmechanismus
legt den Namen eines Sicherheitsmechanismus fest, der bei der Verbindung
verwendet werden soll.
Namen für Sicherheitsmechanismen sind in der Konfigurationsdatei
libtcl.cfg festgelegt, die sich im ini-Unterverzeichnis unterhalb des
Sybase-Installationsverzeichnisses befindet. Wenn kein Name für den
Sicherheitsmechanismus angegeben ist, wird der Standardmechanismus
verwendet. Weitere Hinweise zu Namen für den Sicherheitsmechanismus
entnehmen Sie der Beschreibung der libtcl.cfg-Datei in der Dokumentation
Open Client/Server Configuration Guide.
Dienstprogramme 233

isql
Beispiele Beispiel 1 Damit wird der Texteditor aufgerufen, in dem Sie die Abfrage
bearbeiten können. Wenn Sie die Datei bearbeitet und gespeichert haben,
kehren Sie zu isql zurück. Die Abfrage wird angezeigt; tippen Sie „go“ auf
eine eigene Zeile, um sie auszuführen:
isql -Ujoe -Pabracadabra
1> select *
2> from authors
3> where city = "Oakland"
4> vi
Beispiel 2 reset löscht den Abfragepuffer. quit bringt Sie zum Betriebssystem
zurück:
isql -Ualma
Password:
1> select *
2> from authors
3> where city = "Oakland"
4> reset
1> quit
Beispiel 3 Gibt an, dass Sie isql auf einem Macintosh gegenüber einem Server
ausführen, der den roman8-Zeichensatz verwendet:
isql -a mac -J roman8
Syntax Verwenden Sie diese Syntax bei isql_r, wenn Sie Thread-Treiber
verwenden.
Verwenden Sie diese Syntax bei isql_dce, wenn Sie Thread-Treiber auf
der IBM-Plattform verwenden.
Sie müssen die SYBASE-Umgebungsvariable auf die Position der
aktuellen Version der Adaptive Server-Installation einstellen, bevor Sie
isql verwenden können.
Die 5701-Servermeldung („changed database“) wird nicht mehr nach
einem Login oder der Ausgabe des use database-Befehls angezeigt.
Das Fehlermeldungsformat unterscheidet sich von den früheren isql-
Versionen. Wenn Sie Skripten haben, die Routinen aufgrund der Werte
dieser Meldungen ausführen, werden Sie sie möglicherweise umschreiben
müssen.
234 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Um isql interaktiv zu verwenden, geben Sie den Befehl isql
(und alle zusätzlichen Parameter) nach der Eingabeaufforderung Ihres
Betriebssystems ein. Das isql-Programm akzeptiert SQL-Befehle und
sendet sie an Adaptive Server. Die Ergebnisse werden formatiert und
als Standardausgabe gesandt. Sie beenden isql mit quit oder exit.
Sie schließen einen Befehl ab, indem Sie das Standard-Befehlsabschlusszeichen
go oder ein anderes Befehlsabschlusszeichen eingeben, wenn der
-c-Parameter verwendet wird. Sie können dem Befehlsabschlusszeichen
eine Gesamtzahl anfügen, um anzugeben, wie oft der Befehl ausgeführt
werden soll. Um den Befehl zum Beispiel 100 Mal auszuführen, geben
Sie Folgendes ein:
select x = 1
go 100
Die Ergebnisse werden am Ende der Ausführung einmal angezeigt.
Wenn Sie eine Option mehr als einmal in der Befehlszeile angeben,
verwendet isql den letzten Wert. Wenn Sie zum Beispiel den folgenden
Befehl eingeben, überschreibt „send“, der zweite Wert für -c, „.“,
den ersten Wert:
isql -c"." -csend
Dadurch können Sie etwaige Aliasnamen aufheben, die Sie
eingerichtet haben.
Um einen Editor für den aktuellen Abfragepuffer aufzurufen, geben Sie
seinen Namen als erstes Wort in einer Zeile ein. Definieren Sie Ihren
bevorzugten aufrufbaren Editor, indem Sie ihn mit der EDITOR-
Umgebungsvariable angeben. Wenn EDITOR nicht definiert ist,
ist der Standardwert vi.
Sie führen Betriebssystembefehle aus, indem Sie eine Zeile mit „!!“,
gefolgt vom Befehl, beginnen. So rufen Sie auch Alternativ-Editoren
auf, ohne EDITOR zu definieren.
Um einen vorhandenen Abfragepuffer zu löschen, geben Sie reset in einer
eigenen Zeile ein. isql verwirft etwaige noch ausstehende Eingaben.
Sie können auch Strg-c an einer beliebigen Stelle in einer Zeile drücken.
Dies bricht die aktuelle Abfrage ab und bringt den Benutzer zur isql-
Eingabeaufforderung zurück.
Mit dem folgenden Befehl lesen Sie eine Betriebssystemdatei ein,
die eine Abfrage zur Ausführung von isql enthält:
isql -U alma -PKennwort < Eingabedatei
Dienstprogramme 235

isql
Die Datei muss ein Befehlsabschlusszeichen enthalten. Die Ergebnisse
werden auf Ihrem Terminal angezeigt. Mit dem folgenden Befehl lesen Sie
eine Betriebssystemdatei ein, die eine Abfrage enthält, und übermitteln die
Ergebnisse an eine andere Datei:
isql -U alma -PKennwort < Eingabedatei >
Ausgabedatei
isql-Optionen beachten Groß/Kleinschreibung.
isql zeigt nur 6 Stellen von float- oder real-Daten nach
dem Dezimalzeichen an und rundet den Rest.
Wenn Sie isql interaktiv verwenden, lesen Sie eine Betriebssystemdatei
mit folgendem Befehl in den Befehlspuffer ein:
:r Dateiname
Geben Sie kein Befehlsabschlusszeichen in die Datei ein; sobald Sie mit
der Bearbeitung fertig sind, geben Sie das Abschlusszeichen auf eine
eigene Zeile interaktiv ein.
Sie können Kommentare in eine Transact-SQL-Anweisung einfügen,
die an Adaptive Server von isql übermittelt wird. Leiten Sie einen
Kommentar mit „/*“ ein. Schließen Sie ihn mit „*/“, wie im folgenden
Beispiel gezeigt:
select au_lname, au_fname
/*Zu- und Vorname der Autoren abrufen*/
from authors, titles, titleauthor
where authors.au_id = titleauthor.au_id
and titles.title_id = titleauthor.title_id
/*das ist ein Dreifach-Join, der Autoren
**mit den Büchern verknüpft, die sie geschrieben
haben.*/
Wenn Sie einen go-Befehl kommentieren, sollte er nicht am Anfang der
Zeile stehen. Löschen Sie zum Beispiel den Kommentar aus dem go-
Befehl, indem Sie Folgendes eingeben:
/*
**go
*/
Folgendes dürfen Sie nicht verwenden:
/*
go
*/
236 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Siehe auch In Kapitel 2, „Das isql-Dienstprogramm verwenden“ finden Sie weitere
Hinweise zu isql.
langinstall
In der Dokumentation Sybase Adaptive Server Enterprise Reference Manual
finden Sie weitere Hinweise über die Konfigurationsparameter default network
packet size und maximum network packet size.
Befehle create schema, set
Datentyp exact numeric datatypes
System ESP xp_sendmail
Systemprozeduren sp_addlanguage, sp_addlogin, sp_addremotelogin,
sp_add_resource_limit, sp_bindexeclass, sp_configure, sp_defaultlanguage,
sp_droplanguage, sp_helplanguage, sp_processmail, sp_remoteoption,
sp_serveroption, sp_showcontrolinfo, sp_unbindexeclass, sp_volchanged
Beschreibung Installiert eine neue Spracheinstellung in Adaptive Server. Standort ist
$SYBASE/ASE-12_5/bin.
Windows NT Das Dienstprogramm heißt langinst.exe unter
%SYBASE%\ASE-12_5\bin.
Syntax langinstall
[-S Server]
[-U Benutzer]
[-I Interfaces-Datei]
[-P Kennwort]
[-R Versionsnummer]
[-I Pfad_zu_Interfaces-Datei]
Sprache
Zeichensatz
Oder
langinstall -v
Parameter -S Server
gibt den Namen der Adaptive Server-Installation an, mit dem die
Verbindung hergestellt werden soll. Wenn Sie -S nicht angeben, verwendet
langinstall den Server, der durch Ihre DSQUERY-Umgebungsvariable
festgelegt wird. Wenn DSQUERY nicht eingestellt ist, versucht langinstall,
mit einem Server namens SYBASE zu verbinden.
Dienstprogramme 237

langinstall
-U Benutzer
gibt einen Login-Namen an. Login-Namen reagieren auf Groß/
Kleinschreibung.
-I Interfaces-Datei
gibt den Namen und den Standort der Interfaces-Datei (sql.ini in
Windows NT) an, die langinstall bei der Verbindungsaufnahme mit Adaptive
Server sucht. Wenn Sie für -I keine Angaben machen, sucht langinstall
nach der Interfaces-Datei im von der SYBASE-Umgebungsvariablen
angegebenen Verzeichnis. Wenn SYBASE nicht eingestellt ist,
sucht langinstall nach dem Standard-SYBASE-Verzeichnis.
-P Kennwort
ist das Kennwort des Systemadministrators („sa“-Konto). Wenn Sie
-P weglassen, fordert Sie langinstall zur Eingabe des „sa“-Konto-
Kennworts auf.
-R Versionsnummer
legt die Versionsnummer fest, im Format n.n.n, die verwendet wird, um
Meldungen in master..sysmessages umzustellen. Verwenden Sie -R nur,
wenn Fehler auftreten, wenn beispielsweise langinstall (langinst in
Windows NT) nicht ausgeführt werden kann oder wenn Benutzerfehler
auftreten; oder wenn Sie annehmen, dass die Ursache der Fehler auf
veraltete Meldungen in sysmessages zurückzuführen ist.
Der -R-Parameter teilt langinstall mit, Meldungen aus einer früheren
Version als der aktuellen abzurufen. langinstall vergleicht die vorhandenen
Meldungen mit denen, die installiert werden sollen und ersetzt alle, die sich
geändert haben.
Wenn zum Beispiel die aktuellste Version 12.5 ist und die vorherige 12.0
war, Sie aber glauben, dass sysmessages möglicherweise nicht korrekt ist,
dann können Sie Meldungen aus der vorherigen Version (in diesem
Fall 12.0) in die syslanguages.upgrade-Spalte aufnehmen, indem Sie
-R 12.0 angeben. langinstall installiert dann alle Meldungen aus Adaptive
Server 12.0.
-I Pfad_zu_Interfaces-Datei
gibt den Pfad zur Interfaces-Datei an.
Sprache
ist der offizielle Name der Sprache, die installiert werden soll. Sie müssen
eine Sprache angeben.
238 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Zeichensatz
ist der Name des Standard-Zeichensatzes der Adaptive Server-Installation.
Zeichensatz zeigt den Verzeichnisnamen der Lokalisierungsdateien für die
Sprache an. Die common.loc- und server.loc-Lokalisierungsdateien für eine
offizielle Sprache befinden sich im Zeichensatzverzeichnis $SYBASE/
locales/language/character_set auf UNIX-Plattformen bzw. unter
%sybase%\locales\language\character_set in Windows NT. Sie müssen
einen Zeichensatz angeben.
-v
gibt die Versionsnummer und Copyright-Meldung für langinstall an und
beendet dann.
Syntax Das Adaptive Server-Installationsprogramm führt langinstall automatisch
bei einer neuen Installation sowie für Benutzer aus, die ein Upgrade einer
früheren Version durchführen.
langinstall führt Folgendes durch:
Die spezifischen Sprachinformationen werden in
master..syslanguages mittels sp_addlanguage hinzugefügt. Wenn die
Sprache bereits existiert, aktualisiert langinstall die entsprechende
Zeile in syslanguages.
Falls erforderlich werden Meldungen aus master..sysmessages
hinzugefügt, aktualisiert und gelöscht.
syslanguages.update, wird aktualisiert, indem die neue
Versionsnummer eingefügt wird.
langinstall überprüft die Einträge, die in den verwendeten
Lokalisierungsdateiabschnitten gefunden werden. Wenn etwas fehlt,
gibt langinstall eine Fehlermeldung aus und fügt die Sprache syslanguages
nicht hinzu.
langinstall vergleicht die Versionsnummern der beiden verwendeten
Lokalisierungsdateien common.loc und server.loc. Wenn sie
nicht übereinstimmen, wird eine Warnmeldung ausgegeben.
syslanguages.upgrade ist immer entsprechend der Versionsnummer
in server.loc eingestellt.
Dienstprogramme 239

optdiag
Berechtigungen Nur ein Systemadministrator, der das „sa“-Konto verwendet, kann langinstall
ausführen.
Benutzte Tabellen master.dbo.syslanguages, master.dbo.sysmessages
Siehe auch Systemprozeduren sp_addlanguage, sp_addlogin, sp_configure,
sp_defaultlanguage, sp_droplanguage, sp_helplanguage
optdiag
Dienstprogramme defncopy, srvbuild
Beschreibung Zeigt Optimiererstatistiken an oder lädt die aktualisierte Statistik in
Systemtabellen. Standort ist $SYBASE/ASE-12_5/bin.
Windows NT Das Dienstprogramm heißt optdiag.exe unter
%SYBASE%\ASE-12_5\bin.
Syntax optdiag [binary] [simulate] statistics
{ -i Eingabedatei |
Datenbank[.Eigentümer[.[Tabelle[.Spalte]]]][-o Ausgabedatei] }
[-U Benutzername]
[-P Kennwort]
[-T Trace-Wert]
[-I Interfaces-Datei]
[-S Server]
[-v]
[-h]
[-s]
[-z Sprache ]
[-J Client-Zeichensatz]
[-a Anzeige-Zeichensatz]
Parameter binary
extrahiert die Statistik in lesbarer Form oder im Binärdatenformat.
Bei Verwendung mit einer Eingabedatei (-i Eingabedatei) wird die binäre
Statistik in Systemtabellen geladen.
simulate
gibt an, dass optdiag eine simulierte Statistik anzeigt oder lädt. Weitere
Hinweise finden Sie in der Dokumentation Performance and Tuning Guide.
-i Eingabedatei
gibt den Namen einer Betriebssystemdatei an, die die Eingaben für
optdiag enthält. Das Angeben einer Eingabedatei bewirkt, dass optdiag die
Optimiererstatistik für die Tabelle oder Spalte aktualisiert, indem die Werte
in der angegebenen Datei verwendet werden (auch „Eingabemodus“
genannt).
240 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Datenbank
ist der Name der Datenbank, deren Statistik Sie anzeigen wollen.
Im Eingabemodus verwendet optdiag den Datenbanknamen, wie er in der
Datei angegeben ist, und akzeptiert nicht den Datenbanknamen von der
Befehlszeile.
Eigentümer
ist der Name eines Tabelleneigentümers.
Wenn Sie im Anzeigen-Modus keinen Eigentümer angeben, aber einen
Tabellennamen angeben, zeigt optdiag die Ausgabe für alle Eigentümer
einer Tabelle an.
Im Eingabemodus ignoriert optdiag den in der Befehlszeile
angegebenen Tabelleneigentümer und verwendet den Wert in der
Eingabedatei.
Tabelle
ist der Name der Tabelle, deren Statistik erstellt wird.
Wenn der Befehl keinen Eigentümer- oder Tabellennamen enthält,
zeigt optdiag die Statistik für alle Tabellen in der Datenbank an.
Wenn der Befehl einen Eigentümernamen aber keinen Tabellennamen
anführt, zeigt optdiag alle Tabellen an, die dem angegebenen
Eigentümer gehören.
Im Eingabemodus ignoriert optdiag den in der Befehlszeile
angegebenen Tabellennamen und verwendet den Wert aus der
Eingabedatei.
Spalte
ist der Name der Spalte, deren Statistik erstellt wird.
Wenn der Befehl keinen Spaltennamen enthält, zeigt optdiag die
gesamte Statistik für eine Tabelle an.
Im Eingabemodus ignoriert optdiag den in der Befehlszeile
angegebenen Spaltennamen und verwendet die Werte aus der
Eingabedatei.
-o Ausgabedatei
gibt den Namen einer Betriebssystemdatei an, in der die Eingaben von
optdiag gespeichert werden sollen. Wenn bereits eine Datei mit diesem
Namen existiert, überschreibt optdiag diese Datei, ohne eine Warnung
auszugeben.
Dienstprogramme 241

optdiag
-U Benutzername
gibt einen Adaptive Server-Login-Namen an.
-P Kennwort
gibt Ihr Adaptive Server-Kennwort an. Wenn Sie die -P-Option nicht
angeben, fordert optdiag zur Eingabe eines Kennworts auf.
-T Trace-Wert
setzt Trace-Flags für die optdiag-Sitzung. Die optdiag-Trace-Flags sind die
folgenden:
Optionswert Bedeutung
1 Nicht mit einer Warnmeldung unterbrechen, wenn die optdiag-Version der
verwendeten Adaptive Server-Installation nicht mit der Adaptive Server-Version
in der Eingabedatei übereinstimmt.
2 Statusmeldung „Nächste Tabelle ist Tabellenname“, wenn im Eingabemodus.
4 Konsistenzprüfung der Schrittnummern beim Laden von Histogrammen im
Eingabemodus überspringen.
6 Zeilen der Eingabedatei während des Eingabemodus anzeigen. Diese Option hat im
Anzeigemodus keine Auswirkung.
-I Interfaces-Datei
gibt Namen und Position der Interfaces-Datei an, die verwendet werden soll,
wenn eine Verbindung mit Adaptive Server hergestellt wird.
Wenn Sie -I nicht verwenden und einen Interfaces-Dateinamen angeben,
sucht optdiag nach der Interfaces-Datei (interfaces in UNIX), im Verzeichnis,
das durch die SYBASE-Umgebungsvariable festgelegt ist. In Windows NT
sucht optdiag nach einer Datei namens sql.ini im ini-Unterverzeichnis des
Sybase-Installationsverzeichnisses (d:\sybase). Wenn SYBASE nicht
eingestellt ist, sucht optdiag nach der Datei im Standard-$SYBASE-
Verzeichnis (%SYBASE% in Windows NT).
-S Server
gibt den Namen der Adaptive Server-Installation an, mit dem die Verbindung
hergestellt werden soll. optdiag sucht nach diesem Name in der interfaces-
Datei (sql.ini in Windows NT).
Wenn Sie -S ohne Angabe eines Servernamens verwenden,
sucht optdiag nach einem Server namens SYBASE.
Wenn Sie -S nicht verwenden, sucht optdiag nach dem Server,
den Ihre DSQUERY-Umgebungsvariable angibt.
242 Adaptive Server Enterprise

-v
Kapitel 8 Übersicht über die Dienstprogrammbefehle
zeigt die Versionsnummer und Copyright-Meldung für optdiag an und
beendet dann.
-h
zeigt die optdiag-Syntaxhilfe an.
-s
-v
bezieht Systemtabellen in die optdiag-Ausgabe ein. Standardmäßig werden
nur Benutzertabellen aufgenommen.
zeigt die Versionsnummer und Copyright-Meldung für optdiag an und
beendet dann.
-h
zeigt die optdiag-Syntaxhilfe an.
-s
bezieht Systemtabellen in die optdiag-Ausgabe ein. Standardmäßig werden
nur Benutzertabellen aufgenommen.
-z Sprache
ist der offizielle Name einer Alternativsprache, die der Server für
Datumsformate und zur Anzeige von optdiag-Eingabeaufforderungen
und Meldungen verwendet. Ohne die -z-Option verwendet optdiag die
Standardsprache des Servers.
Sie können Adaptive Server-Sprachen während oder nach der Installation
hinzufügen. Nach der Installation des Adaptive Server-Systems verwenden
Sie entweder das langinstall-Dienstprogramm oder die gespeicherte
Prozedur sp_addlanguage, um eine Sprache hinzuzufügen.
-J Client-Zeichensatz
gibt den Zeichensatz an, der auf dem Client verwendet wird. Ein Filter
konvertiert die Eingabe zwischen Client-Zeichensatz und dem Adaptive
Server-Zeichensatz.
Indem Sie -J Client-Zeichensatz verwenden, fordern Sie Adaptive Server
auf, Daten in und von Client-Zeichensatz, dem Zeichensatz des Clients,
zu konvertieren.
Indem Sie -J ohne einen Zeichensatznamen verwenden, geben Sie
Zeichensatzkonvertierung als NULL an, und keine Konvertierung findet
statt. Verwenden Sie -J alleine, wenn der Client und der Server denselben
Zeichensatz verwenden.
Dienstprogramme 243

optdiag
Indem Sie -J weglassen, stellen Sie den Zeichensatz auf den Standardwert
der Plattform ein. Ein Filter konvertiert die Eingabe zwischen dem
Standardzeichensatz und dem Adaptive Server-Zeichensatz. Beachten Sie,
dass der Standardwert nicht unbedingt der Zeichensatz ist, den der Client
verwendet.
Weitere Hinweise über Zeichensätze und ihre zugeordnete Optionen finden
Sie in der Dokumentation Systemadministration für Adaptive Server
Enterprise.
-a Anzeige-Zeichensatz
führt optdiag von einem Terminal aus, dessen Zeichensatz von dem des
Rechners, auf dem optdiag läuft, verschieden ist.
-a in Verbindung mit -J gibt die Zeichensatzkonvertierungs-Datei (.xlt)
an, die für die Konvertierung erforderlich ist.
Verwenden Sie -a ohne -J nur dann, wenn der Client-Zeichensatz mit
dem Standardzeichensatz identisch ist.
Hinweis Der ascii_7-Zeichensatz ist mit allen anderen Zeichensätzen
kompatibel. Wenn entweder der Adaptive Server- oder der Clientzeichensatz
auf ascii_7 eingestellt ist, können alle 7-Bit-ASCII-Zeichen unverändert
zwischen Client und Server übermittelt werden. Andere Zeichen erzeugen
Konvertierungsfehler. Weitere Hinweise über Zeichensatzkonvertierung
finden Sie in der Dokumentation Systemadministration für Adaptive
Enterprise.
Beispiele Beispiel 1 Zeigt die Statistik für alle Benutzertabellen in der pubs2-Datenbank
an und platziert die Ausgabe in die pubs2.opt-Datei:
optdiag statistics pubs2 -Usa -Ppasswd -o pubs2.opt
Beispiel 2 Zeigt die Statistik für die titles-Tabelle an:
optdiag statistics pubs2..titles -Usa -Ppasswd -o titles.opt
Beispiel 3 Zeigt die Statistik im roman8-Zeichensatz mit Zeilen-Labels und
Fehlermeldungen auf Französisch an:
optdiag statistics pubs2..titles -Usa -Ppasswd -o titles.opt -J roman8
-z french
Beispiel 4 Zeigt Binärdaten-Statistik für die price-Spalte in der titles-
Tabelle an:
optdiag binary statistics pubs2..titles.price -Usa -Ppasswd -o price.opt
244 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beispiel 5 Lädt eine bearbeitete Statistik aus der price.opt-Datei:
optdiag statistics -i price.opt -Usa -Ppasswd
Syntax Sie müssen die SYBASE-Umgebungsvariable auf die Position der
aktuellen Version der Adaptive Server-Installation einstellen, bevor Sie
optdiag verwenden können.
Standardmäßig bezieht optdiag nicht die Systemtabellen ein, wenn Sie
die Statistik für eine Datenbank anzeigen. Um die Systemtabellen in die
Ausgabe aufzunehmen, verwenden Sie die -s-Option.
Wenn Sie den binary-Modus verwenden, zeigt optdiag Werte in lesbarer
Form mit Kommentarmarken (#) am Anfang der Ausgabezeilen an,
wie im folgenden Beispiel:
Statistics for column: "price"
Last update of column statistics: Jan 20 1998 7:16PM
Statistics loaded from Optdiag.
Range cell density: 0x3f8b9cfefece26bf
# Range cell density: 0.0134830400000000
Total density: 0x3f8b9cfefece26bf
# Total density: 0.0134830400000000
Range selectivity: default used (0.33)
# Range selectivity: default used (0.33)
In between selectivity: default used (0.25)
# In between selectivity: default used (0.25)
Wenn Sie optdiag mit einer Eingabedatei verwenden, um die Statistik zu
ändern, werden alle Zeichen nach dem „#“ in einer Ausgabezeile ignoriert.
Das Konvertieren von Gleitkomma-Werten führt möglicherweise zu
Rundungsfehlern, wenn Sie Dateien für die Eingabe verwenden.
Wenn Sie die Statistik auf dieselbe Hardware-Plattform laden, sollten Sie
die Statistik bearbeiten, indem Sie die Binärdatenwerte verwenden,
um eine größere Genauigkeit zu erreichen.
Dienstprogramme 245

optdiag
Byte-Sortierfolge und binäre optdiag-Dateien
Verwenden Sie nicht die binary-Modusoption, um eine Statistik
zwischen Adaptive Server-Installationen auf Rechner zu verschieben,
die verschiedene Byte-Sortierfolgen verwenden.
Auf einem inkompatiblen Architektur-Server sollten Sie immer die
Binärdaten-Statistik als Kommentar darstellen und die Statistik in
lesbarer Form laden.
Auf einem Server mit kompatibler Architektur können Sie entweder
Binärdaten-Statistik oder Statistik in lesbarer Form laden.
Eingabemodus
Wenn Sie die -i Eingabedatei-Syntax verwenden, liest optdiag die benannte
Datei und aktualisiert die Statistik in sysstatistics.
optdiag-Eingabemodus ändert den Konfigurationsparameter allow update
to system tables, indem der Parameter auf 1 am Anfang der Sitzung
eingestellt wird, und dann auf 0 am Ende der Sitzung.
Während der Histogramm-Eingabe überprüft der Prozess die folgenden
Regeln und zeigt Fehlermeldungen für jede verletzte Regel an:
Die Schrittnummern müssen monoton erhöht werden, außer der
Befehl enthält die -T4-Trace-Flag.
Der Spaltenwert für die Schritte muss monoton ansteigen.
Die Gewichtung für jede Zelle muss zwischen 0.0 und 1.0 liegen.
Die Summe der Gewichtungen bei einer Spalte muss nahe bei
1.0 liegen.
Die erste Zelle stellt Nullwerte dar und muss vorhanden sein, sogar
bei Spalten, die keine Nullwerte zulassen. Es muss eine Zelle geben,
um den Nullwert darzustellen.
Zwei benachbarte Zellen dürfen nicht beide den

pwdcrypt
Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beschreibung Erstellt und schreibt ein verschlüsseltes LDAP-Kennwort in der Datei
libtcl.cfg. pwdcrypt befindet sich unter $SYBASE/$SYBASE_OCS/bin.
Syntax pwdcrypt
Parameter Keine
Windows NT Das Dienstprogramm befindet sich unter
%SYBASE%\%SYBASE_OCS%\bin.
Beispiele Die Eingabe von pwdcrypt an der Eingabeaufforderung gibt die Anforderung
zurück, Ihr Kennwort zweimal einzugeben, woraufhin pwdcrypt das LDAP-
Kennwort zurückgibt:
pwdcrypt
Enter password please: Kennwort
Enter password again : Kennwort
The encrypted password:
0x01312a775ab9d5c71f99f05f7712d2cded288d0ae1ce79268d0e8669313d1bc4c706
Ersetzen Sie den letzten Teil der LDAP-URL in libtcl.cfg mit diesem
verschlüsselten Kennwort:
ldap=libdldap.so
ldap://dolly:389/dc=sybase,dc=com????bindname=cn=Manager,dc=sybase,dc=com?
0x01312a775ab9d5c71f99f05f7712d2cded288d0ae1ce79268d0e8669313d1bc4c706
Ein nicht-verschlüsseltes Kennwort sieht folgendermaßen aus:
ldap=libdldap.so
ldap://dolly:389/dc=sybase,dc=com????bindname=cn=Manager,dc=sybase,dc=com?
secret
Syntax Sie müssen die SYBASE-Umgebungsvariable auf die Position der aktuellen
Version der Adaptive Server-Installation einstellen, bevor Sie pwdcrypt
verwenden können.
Berechtigungen Sie müssen Datei-Systemberechtigungen verwenden, um den nicht
autorisierten Zugriff auf das verschlüsselte Kennwort in Ihrer libtcl.cfg-Datei
zu verhindern.
Dienstprogramme 247

showserver
showserver
Beschreibung Nur UNIX-Plattformen Zeigt die Adaptive Server- und Backup Server-
Installationen an, die derzeit auf dem lokalen Rechner ausgeführt werden;
steht nur für UNIX-Plattformen zur Verfügung. showserver befindet sich
unter $SYBASE/ASE-12_5/install.
Syntax showserver
Parameter Keine
Beispiele
showserver
USER PID %CPU %MEM SZ RSS TT STAT START TIME COMMAND
user114276 0.0 1.7 712 1000 ? S Apr 5514:05 dataserver
-d greensrv.dat -sgreensrv -einstall/greensrv+_errorlog
sybase 1071 0.0 1.4 408 820 ? S Mar 28895:38
/usr/local/sybase/bin/dataserver -d/dev/rsd1f -e/install/errorlog
user128493 0.0 0.0 3692 0 ? IW Apr 1 0:10 backupserver -SSYB_BACKUP
-e/install/backup.log -Iinterfaces -Mbin/sybmultbuf -Lus_english -Jiso_1
Syntax showserver gibt Prozessinformationen über Adaptive Server oder Backup
Server aus. Wenn keine Server laufen, wird nur der Header angezeigt.
Siehe auch Befehle dataserver, startserver
Funktion – host_name
Dienstprogramme langinstall
248 Adaptive Server Enterprise

sqldbgr
Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beschreibung sqldbgr ist ein Befehlszeilenprogramm, das gespeicherte Prozeduren und
Trigger auf Fehler untersucht. Wie mit vielen Fehlersuchprogrammen können
Sie Folgendes durchführen:
sqldbgr an eine Aufgabe anhängen
Breakpoints festlegen, aktivieren und deaktivieren
Eine Aufgabe zeilenweise abarbeiten
Prozeduren starten und verlassen
sqldbgr aus gespeicherten Prozeduren oder Triggern lösen, wenn die
Fehlersuche beendet ist.
UNIX-Plattformen sqldbgr befindet sich unter $SYBASE/ASE-12_5/bin.
Windows NT sqldbgr befindet sich unter %SYBASE%\ASE-12_5\bin.
Syntax sqldbgr
-U Benutzername
-PKennwort
-S Host:Port
Parameter -U Benutzername
gibt den Benutzernamen an. Sie müssen eine Leerstelle zwischen -U und
Benutzername einfügen.
-P Kennwort
gibt das Kennwort des Benutzers an. Sie müssen eine Leerstelle zwischen -P
und Kennwort einfügen.
-S Host:Port
gibt den Rechnernamen und die Portnummer an. Sie müssen eine Leerstelle
zwischen -S und Host:Port einfügen.
Beispiele Beispiel 1 Dieses Beispiel zeigt sqldbgr bei der Fehlersuche in gespeicherten
Prozeduren und Triggern auf Host MERCURY:
$SYBASE/ASE-12_5/bin/sqldbgr -U sa -P -S MERCURY:16896
(sqldbg) stop in sp_who
Breakpoint moved to line 20
(sqldbg) run sp_who
(sp_who::20)if @@trancount = 0
(sqldbg) next
(sp_who::22) set chained off
(sqldbg) cont
Dienstprogramme 249

sqldbgr
fid spid status loginame origname hostname blk_spid dbname cmd block_xloid
0 2 sleeping NULL NULL 0 master NETWORK HANDLER 0
0 3 sleeping NULL NULL 0 master NETWORK HANDLER 0
0 4 sleeping NULL NULL 0 master DEADLOCK TUNE 0
0 5 sleeping NULL NULL 0 master MIRROR HANDLER 0
0 6 sleeping NULL NULL 0 master ASTC HANDLER 0
0 7 sleeping NULL NULL 0 master ASTC HANDLER 0
0 8 sleeping NULL NULL 0 master CHECKPOINT SLEEP 0
0 9 sleeping NULL NULL 0 master HOUSEKEEPER 0
0 10 running sa sa 0 master SELECT 0
0 11 sleeping sa sa
(sqldbg) show breakpoints
1 stop in sp_who
(sqldbg)
Beispiel 2 Hier meldet sich der Systemadministrator bei Adaptive Server
mittels isql an und startet sqldbgr von der Befehlszeile aus, um bei einer
gespeicherten Prozedur Fehler zu suchen, die in einer anderen Task läuft:
$SYBASE/$SYBASE_OCS/bin/isql -U sa -P
1> select @@spid
2> go
------
12
1>
$SYBASE/ASE-12_5/bin/sqldbgr -U sa -P -S MERCURY:16896
(sqldbg) attach 13
The spid is invalid
(sqldbg) attach 12
(sqldbg) show breakpoints
(sqldbg) stop in sp_who
Breakpoint moved to line 20
(sqldbg) /* jetzt führen Sie die sp_who-Prozedur von spid 12 aus */
(sqldbg) where
(sp_who::20::@loginname = )
(ADHOC::1::null)
(sqldbg) next
(sp_who::22) set chained off
(sqldbg) next
(sp_who::25)set transaction isolation level 1
(sqldbg) cont
(sqldbg) /* jetzt wird das sp_who-Ergebnis auf dem isql-Bildeschirm
angezeigt */
(sqldbg) detach 12
(sqldbg)
250 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Syntax Der sql-Befehl wird im Kontext der auf Fehler behandelten Aufgabe
durchgeführt, während der mysql-Befehl im Kontext der Fehlersuchaufgabe
ausgeführt wird. Die Einstellung von sitzungsspezifischen
Informationen, beispielsweise für set quoted_identifier on über sql
funktioniert nicht.
Der Sybase jConnect JDBC-Treiber verwendet standardmäßig set
quoted_identifier on. Da das sqldbgr-Dienstprogramm mit jConnect-
Argumenten, die Anführungszeichen erfordern, aufgebaut ist,
verwenden Sie bei der Eingabe von Optionen Apostrophe anstelle
von Anführungszeichen. Verwenden Sie beispielsweise sp_configure
'allow update' anstelle von sp_configure "allow update".
Bevor Sie sqldbgr ausführen können, müssen Sie die Umgebung
SYBASE_JRE oder JAVA_HOME auf den Standort einstellen,
der die Java-Ausführungsumgebung enthält.
Wenn Sie sqldbgr an der Befehlseingabeaufforderung aufrufen, startet das
Dienstprogramm und die Eingabeaufforderung ändert sich in eine sqldbgr-
Eingabeaufforderung:
(sqldbgr)
Sobald die (sqldbgr)-Eingabeaufforderung angezeigt wird, können Sie
die folgenden sqldbgr-Befehle eingeben, um die gewünschten Aufgaben
durchzuführen:
Tabelle 8-4: sqldbgr-Befehle und ihre Beschreibung
Befehl Beschreibung
attach spid Hängt an sqldbgr eine Aufgabe an, wenn Sie bereits bei Adaptive Server
angemeldet sind.
Hinweis Sie können attach spid nicht verwenden, um an eine Prozedur anzuhängen,
die nicht läuft.
sqldbgr kann nicht in einer Sitzung bei mehreren Aufgaben Fehler beheben. Wenn Sie
versuchen, das Dienstprogramm an mehrere Aufgaben anzuhängen, bleibt die erste
spid weiterhin als angehängt markiert. Da Sie nicht an eine bereits angehängte spid
anhängen können, müssen Sie den detach-Befehl verwenden und dann an eine andere
spid anhängen.
run Prozedurname Fehlerbehebung bei gespeicherten Prozeduren und Triggern, ohne sqldbgr an eine
vorhandene Aufgabe anzuhängen.
Wenn Sie versuchen, run Prozedurname auszuführen, während Sie bereits bei einer
vorhandenen Aufgabe mit attach spid Fehler beheben, schlägt run Prozedurname
fehl und Sie erhalten folgende Meldung:
Cannot run a procedure while debugging another task
Dienstprogramme 251

sqldbgr
Befehl Beschreibung
stop in Prozedurname
[at line #]
Setzt einen Breakpoint, um die Fehlerbehebung der gespeicherten Prozedur oder des
Triggers am Beginn des angegebenen Prozedurnamens zu stoppen.
stop in Prozedurname at line # setzt einen Breakpoint, um die Fehlerbehebung der
gespeicherten Prozedur oder des Triggers an der festgelegten Zeile innerhalb der
angegebenen Prozedur zu stoppen.
Wenn Sie eine ungültige Zeilennummer eingeben, verschiebt sqldbgr den Breakpoint
an die nächste gültige Nummer und zeigt Folgendes an:
Invalid line number
Sie können diesen Befehl auch verwenden, um mehrere Breakpoints zu setzen.
show breakpoints Zeigt den Breakpoint-Handle in der Form einer eindeutigen Zahl an, wie auch die
Breakpoint-Anweisungen, die vom Benutzer während der sqldbgr-Sitzung
eingegeben wurde.
Wenn Sie eine Breakpoint-Zeilennummer angeben, die keine gültige SQL-
Anweisung enthält, verschiebt Adaptive Server den Breakpoint an die nächste gültige
Zeilennummer. Adaptive Server ändert allerdings nicht den von Ihnen eingegebenen
Befehl. Daher kann show breakpoints einen in der sqldbgr-Sitzung eingegeben
Breakpoint-Handle und eine Breakpoint-Anweisung zurückgeben,
die verschieden sind.
Ein Sternchen (*) in der Breakpoint-Zeile bedeutet, dass der Breakpoint gesetzt aber
derzeit deaktiviert ist.
use dbName Teilt sqldbgr mit, welche Datenbank verwendet werden soll, um die Fehler bei
gespeicherten Prozeduren und Triggern dieser Datenbank zu beheben.
show variables [at level #]
show @varName [at level #]
show variables zeigt alle Variablen und ihre Werte in der aktuellen gespeicherten
SQL-Prozedur oder Trigger an.
show variables at level # zeigt Variablen und ihre Werte in der aktuellen gespeicherten
SQL-Prozedur oder Trigger an der angegebenen Stufe an.
show @varName zeigt die angegebene Variable und ihren Wert in der aktuellen
gespeicherten SQL-Prozedur oder Trigger an.
show @varName at level # zeigt die angegebene Variable und ihren Wert in der
aktuellen gespeicherten SQL-Prozedur oder Trigger an der angegebenen Stufe an.
Hinweis sqldbgr unterstützt nicht Java-Variablen.
show where Zeigt den Aufruf-Stack der gespeicherten Prozeduren und Trigger an, die in der
Aufgabe vorhanden sind, deren Fehler behoben werden.
step oder next step oder next fordert sqldbgr auf, zur nächsten Anweisung in der aktuellen
gespeicherten Prozedur oder Trigger zu gehen.
step into Fordert sqldbgr auf, in eine Prozedur zu wechseln, wenn die aktuelle Anweisung eine
execute-Anweisung ist. Wenn die aktuelle Anweisung eine update-, delete- oder
insert-Anweisung ist und Trigger enthält, fordert step into sqldbgr auf, in die update-,
delete- oder insert-Trigger zu gehen.
252 Adaptive Server Enterprise

Befehl Beschreibung
Kapitel 8 Übersicht über die Dienstprogrammbefehle
step out Fordert sqldbgr auf, die aktuelle gespeicherte Prozedur oder Trigger zu verlassen und
an der nächsten Zeile in der aufrufenden Prozedur zu stoppen.
set @varName = VALUE Setzt den Wert der angegebenen Variablen auf den im Befehl angegebenen
Variablenwert in der aktuellen gespeicherten Prozedur oder Trigger. Die Werte der
Variablen, die mit set @varName = VALUE eingestellt wurden, gelten nur für die
aktuelle sqldbgr-Sitzung.
cont[inue] Fordert sqldbgr auf, mit der Fehlerbehebung fortzufahren und am nächsten
Breakpoint (falls vorhanden) zu stoppen.
delete # Löscht den angegebenen Breakpoint, der in der aktuellen Instanz von sqldbgr
gesetzt wurde.
enable # und disable # Aktiviert die angegebenen Breakpoints. disable # deaktiviert sie.
sql jede_sql-Anweisung Führt Ad-hoc-SQL-Anweisungen aus. Mit diesem Befehl können Sie Daten aus
temporären Tabellen auswählen und analysieren, die durch die Aufgabe erstellt
werden, deren Fehler behoben werden.
sql jede_sql-Anweisung gibt eine Ergebnismenge sowie alle aufgetretenen Fehler
zurück.
detach spid Löst sqldbgr von der angegebenen spid und gibt die auf Fehler behandelte
Aufgabe frei.
Die Breakpoints werden gelöscht, die für die auf Fehler behandelte Aufgabe während
der aktuellen sqldbgr-Sitzung gesetzt wurden.
help [all] Zeigt sqldbgr-Befehle an.
Fehlermeldung Beschreibung
Cannot allocate resource
in ASE
Cannot create Debugger
handle in ASE
Tabelle 8-5 listet alle sqldbgr-Fehlermeldungen auf:
Tabelle 8-5: sqldbgr-Fehlermeldungen und ihre Bedeutung
Zeigt an, dass Adaptive Server nicht genügend Speicher-Ressourcen hat,
um sqldbgr auszuführen. Erhöhen Sie procedure cache size und starten Sie
sqldbgr erneut.
Zeigt an, dass Adaptive Server nicht genügend Speicher-Ressourcen hat,
um einen Debugger-Handle zu erstellen. Erhöhen Sie procedure cache size
und starten Sie sqldbgr erneut.
The spid is invalid Wird angezeigt, wenn Sie versuchen, sqldbgr an eine ungültige spid
anzuhängen. Überprüfen Sie nochmals die spid und versuchen Sie es erneut.
You cannot debug a task
that is not owned by you
Spid is already being
debugged
Spid is not debugged
currently
Wird angezeigt, wenn Sie versuchen, eine Aufgabe auf Fehler zu behandeln,
die nicht Ihnen gehört. Sie müssen sich als der Eigentümer der zu
behandelnden Aufgabe beim Server anmelden.
Wird angezeigt, wenn Sie attach spid ausführen und versuchen, an ein spid
anzuhängen, das bereits behandelt wird.
Wird angezeigt, wenn Sie detach spid ausführen und versuchen, von einer
spid zu lösen, die nicht an sqldbgr angehängt ist.
Dienstprogramme 253

sqldbgr
Fehlermeldung Beschreibung
Invalid command Wird angezeigt, wenn Sie einen ungültigen Befehl eingeben.
Invalid procedure name Wird angezeigt, wenn Sie einen ungültigen Prozedurnamen bei stop in
Prozedurname eingeben.
Invalid line number Wird angezeigt, wenn Sie eine ungültige Zeilennummer bei stop in
Prozedurname at line # eingeben.
Variable not found Wird angezeigt, wenn Sie eine ungültige Variable bei show @varName,
show @varName at level # oder set @varName = VALUE eingeben.
Illegal conversion
attempted
Conversion from text to
datatype failed
Cannot run a procedure
while debugging another
task
Wird angezeigt, wenn Sie set @varName = VALUE ausführen und versuchen,
die Variable in einen ungültigen Wert zu konvertieren.
Wird angezeigt, wenn set @varName = VALUE scheitert.
Wird angezeigt, wenn Sie run Prozedurname verwenden, während das
Debug-Programm bereits eine vorhandene Aufgabe mit attach spid
untersucht.
254 Adaptive Server Enterprise

sqlloc
Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beschreibung Nur UNIX-Plattformen Installiert und modifiziert Sprachen-, Zeichensatz-
und Sortierreihenfolge-Standardwerte für Adaptive Server auf UNIX-
Plattformen, wobei eine auf X11/Motif basierende grafische
Benutzeroberfläche verwendet wird. sqlloc befindet sich unter
$SYBASE/ASE-12_5/bin.
Syntax sqlloc
[-S Server]
[-U Benutzer]
[-P Kennwort]
[-s Sybase-Verzeichnis]
[-I Interfaces-Datei]
[-r Ressourcendatei]
Oder
sqlloc -v
Parameter -S Server
gibt den Namen der Adaptive Server-Installation an, mit dem die
Verbindung hergestellt werden soll.
-U Benutzer
gibt einen Login-Namen an. Login-Namen reagieren auf
Groß/Kleinschreibung.
-P Kennwort
gibt das Kennwort des mit -U eingegebenen Benutzers an.
-s Sybase-Verzeichnis
gibt den Wert für die SYBASE-Umgebungsvariable an.
-I Interfaces-Datei
gibt den Namen und Position der Interfaces-Datei an, die durchsucht
werden soll, wenn eine Verbindung mit Adaptive Server hergestellt wird.
-r Ressourcendatei
führt die angegebene Ressourcendatei aus.
-v
gibt die Versionsnummer und Copyright-Meldung für sqlloc an und
beendet dann.
Syntax Sie müssen die SYBASE-Umgebungsvariable auf die Position
der aktuellen Version der Adaptive Server-Installation einstellen,
bevor Sie sqlloc verwenden können.
Dienstprogramme 255

sqlloc
Sie müssen die DISPLAY-Umgebungsvariable einstellen, bevor Sie sqlloc
aufrufen, außer Sie verwenden den -v-Parameter, um die Versionsnummer
anzuzeigen.
Berechtigungen Sie müssen Sybase-Systemadministrator sein, um sqlloc auszuführen.
Siehe auch In der Dokumentation Installation Guide for UNIX Platforms finden Sie
weitere Hinweise über das sqlloc-Dienstprogramm.
Dienstprogramme – langinstall, sqllocres
256 Adaptive Server Enterprise

sqllocres
Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beschreibung Nur UNIX-Plattformen Installiert und modifiziert Sprachen-, Zeichensatz-
und Sortierreihenfolge-Standardwerte für Adaptive Server unter Verwendung
einer Ressourcendatei. sqllocres befindet sich unter $SYBASE/CS-12_5/bin.
Syntax sqllocres
[-S Server]
[-U Benutzer]
[-P Kennwort]
[-s Sybase-Verzeichnis]
[-I Interfaces-Datei]
[-r Ressourcendatei]
Oder
sqllocres -v
Parameter -S Server
gibt den Namen der Adaptive Server-Installation an, mit dem die
Verbindung hergestellt werden soll.
-U Benutzer
gibt einen Login-Namen an.
-P Kennwort
gibt das Kennwort des mit -U eingegebenen Benutzers an.
-s Sybase-Verzeichnis
gibt den Wert für die SYBASE-Umgebungsvariable an.
-I Interfaces-Datei
gibt den Namen und Position der Interfaces-Datei an, die durchsucht werden
soll, wenn eine Verbindung mit Adaptive Server hergestellt wird.
-r Ressourcendatei
führt die angegebene Ressourcendatei aus.
-v
gibt die Versionsnummer und Copyright-Meldung für sqllocres an und
beendet dann.
Syntax Sie müssen die SYBASE-Umgebungsvariable auf die Position der aktuellen
Version der Adaptive Server-Installation einstellen, bevor Sie sqllocres
verwenden können.
Berechtigungen Sie müssen Sybase-Systemadministrator sein, um sqllocres auszuführen
Siehe auch Weitere Hinweise über das sqllocres-Dienstprogramm finden Sie in der
Dokumentation Installation Guide for UNIX Platforms.
Dienstprogramme 257

sqllocres
Dienstprogramme langinstall, sqlloc
258 Adaptive Server Enterprise

sqlsrvr
Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beschreibung Nur Windows-Plattformen Die Adaptive Server-Programmdatei befindet
sich unter %SYBASE%\ASE-12_5\bin.
Syntax sqlserver [-f] [-g] [-G] [-h] [-H] [-m] [-P] [-q] [-v] [-X]
[-a Pfad_zu_CAP-Direktivendatei]
[-b Master-Device-Größe]
[-c Konfig-Datei_für_Server]
[-d Devicename]
[-e Pfad_zu_Fehler-Log]
[-i Interfaces-Datei-Verzeichnis]
[-K Keytab-Datei]
[-L Konfig-Dateiname_für_Connectivity]
[-M gemeinsam_genutzer_Speicher-Repository-Verzeichnis]
[-p SA-Loginname]
[-r Spiegel-Plattenspeichername]
[-s Servername]
[-T Trace-Flag]
[-u SA/SSO-Name]
[-w Master- | Modelldatenbank]
[-y [Kennwort] ]
[-z Seitengröße [ k | K ] ]
Parameter -f
erzwingt die Initialisierung eines Devices oder einer Datenbank. Sie müssen
sowohl -b als auch -w angeben, um -f verwenden zu können.
-g
schaltet das Protokollieren von Ereignissen aus.
-G
legt den Namen des Ereignislog-Servers fest.
-h
druckt die Hilfemeldung und beendet dann.
-H
startet den HA-Server (High Availability, Hohe Verfügbarkeit), wenn Sie
die HA-Funktion in Ihrer Adaptive Server-Installation installiert haben.
-m
startet Adaptive Server im Einzelbenutzer-Modus.
-q
behandelt Datenbanken im Ruhezustand wie „in Wiederherstellung“.
-v
gibt die Versionsnummer und Copyright-Meldung für sqlsrvr an und
beendet dann.
Dienstprogramme 259

sqlsrvr
-X
startet diesen Server als sybmon, und nicht als dataserver.
-a Pfad_zu_CAP-Direktivendatei
gibt den Pfad zur CAP-Direktivendatei an.
-b Master-Device-Größe
legt die Größe des Master-Devices fest.
-c Konfig-Datei_für_Server
gibt den vollständigen Pfadnamen einer Adaptive Server-Konfigurationsdatei
an. Verwenden Sie diesen Parameter, um Adaptive Server mit den
Konfigurationswerten in der angegebenen Konfigurationsdatei zu starten.
Wenn Sie eine Konfigurationsdatei mit dem sqlsrvr -c-Parameter angeben,
stellen Sie sicher, dass alle Parameter in dieser Konfigurationsdatei
kompatibel sind, bevor Sie den Server neu starten. Wenn einige
Konfigurationsparameter nicht kompatibel sind, startet der Server
möglicherweise nicht neu. Um das zu vermeiden, geben Sie keine
Konfigurationsdatei an, wenn Sie das Master-Device einrichten.
Die Einrichtphase verwendet alle Standardeinstellungen, wenn Sie
keine Konfigurationsdatei angeben.
Weitere Hinweise finden Sie in der Dokumentation Systemadministration
für Adaptive Server Enterprise.
-d Devicename
ist der vollständige Pfadname des Devices für die master-Datenbank.
Das Master-Datenbankdevice muss für den Benutzer beschreibbar sein,
der Adaptive Server startet. Das Standard-master-Datenbankdevice ist
d_master.
-e Fehlerlogdatei
ist der vollständige Pfadname der Fehlerlogdatei für Fehlermeldungen der
Adaptive Server-Systemebene.
-i Interfaces-Datei-Verzeichnis
gibt den Namen und den Standort der Interfaces-Datei an, die durchsucht
werden soll, wenn die Verbindung mit der Adaptive Server-Installation
eingerichtet wird. Wenn -I weggelassen wird, sucht sqlsrvr nach einer Datei
namens interfaces in dem Verzeichnis, auf das von Ihrer Sybase-
Umgebungsvariablen gezeigt wird.
-K Keytab-Datei
gibt den Pfad zur Keytab-Datei an, die zur Authentifizierung in DCE
verwendet wird.
260 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-L Konfig-Dateiname_für_Connectivity
gibt den Namen der Konfigurationsdatei für Connectivity an.
-M gemeinsam_genutzer_Speicher-Verzeichnis
platziert Shared-Memory-Dateien in das angegebene Verzeichnis und nicht
an den Standardstandort, $SYBASE%. Wenn gemeinsam_genutzter_
Speicher-Verzeichnis mit „\“ startet, wird angenommen, dass der
Verzeichnisname absolut ist. Ansonsten wird der Verzeichnisname relativ
zu $SYBASE% interpretiert.
-p SSO-Loginname
gibt den Login-Namen eines Sicherheitsadministrators an, wenn Adaptive
Server gestartet wird, damit für das neue Konto ein neues Kennwort
eingerichtet werden kann. Adaptive Server erzeugt ein Zufallskennwort,
zeigt es an, verschlüsselt es und speichert es in master..syslogins als das
neue Kennwort für das Konto.
-r Master-Spiegel
startet den Spiegel für das Master-Device. Verwenden Sie diesen Parameter,
um Adaptive Server zu starten, falls das Master-Device beschädigt wurde.
-s Servername
gibt den Namen der Adaptive Server-Installation an, die gestartet werden
soll. Wenn -s weggelassen wird, wird ein Server mit Namen SYBASE
gestartet.
-T Trace-Flag
-u SA/SSO-Name
gibt den Namen des Systemadministrators oder Sicherheitsadministrators
an, den Sie freigeben wollen.
-w Master- | Modelldatenbank
legt fest, ob Sie eine Master- oder eine Modelldatenbank schreiben wollen.
-y [Kennwort]
mit diesem Parameter können Sie ein Kennwort für den verschlüsselten
privaten Schlüssel zuordnen, damit der Server den Benutzer zur Eingabe
eines Kennworts auffordert. Dieses Kennwort sollte jenem entsprechen,
mit dem Sie den privaten Schlüssel verschlüsselt haben, als er erstellt
wurde. Sie können diesen Parameter nicht verwenden, wenn Sie den
Server im Hintergrund ausführen.
Dienstprogramme 261

sqlsrvr
Hinweis Auch wenn Sie ein Kennwort mit -y, setzen können, empfiehlt Sybase
ausdrücklich, dies aus Sicherheitsgründen zu unterlassen.
Ein privater Schlüssel ist im digitalen Zertifikat Ihres Servers enthalten.
Standardmäßig finden Sie die Zertifikatsdatei unter:
%SYBASE%\%SYBASE_ASE%\certificates\Servername.crt
Der Standort der Zertifikatsdatei ändert sich, wenn Sie den sp_ssladmin
addcert-Befehl aufrufen.
-z Seitengröße
legt die Seitengröße für den Server fest. Sie müssen -b und -w verwenden,
um diese Option zu nutzen, und eine gerade Zweierpotenz zwischen
2 KByte und 16 KByte angeben, da sonst der Server nicht neu startet.
Beispiele Beispiel 1 Erstellt eine neue Installation mit einem 100-MByte-Master-
Device und einer 4-KByte-Seite:
sqlsrvr -d d_master -z 4k -b 100.02M
Die Leerstellen zwischen den Optionen und den nachfolgenden Argumenten
sind fakultativ und werden akzeptiert. In diesem Beispiel werden „100.02M“
für ein 100-MByte-Master-Device festgelegt, da der Server einen 16-KByte-
Overhead für seinen Konfigurationsbereich benötigt.
Beispiel 2 Schreibt eine fehlerhafte model-Datenbank neu:
sqlsrvr -d d_master -w model
Beispiel 3 Schreibt eine fehlerhafte master-Datenbank neu, wobei die
Devicegröße angegeben wird:
sqlsrvr -d d_master -w master -z 4k
Beispiel 4 Schreibt eine fehlerhafte master-Datenbank neu, indem Deviceund
Seitengrößen festgelegt werden und der Server gezwungen wird, diese
Werte anstelle von solchen, die er möglicherweise im Konfigurationsblock
findet, zu akzeptieren:
sqlsrvr -d d_master -w master -z 4k -b 100.02M -f
Beispiel 5 Schreibt eine fehlerhafte master-Datenbank, wobei eine
Seitengröße angegeben wird, die nicht der entspricht, die der Server in
seinem Konfigurationsblock findet. Das erzeugt einen Fehler:
sqlsrvr -d d_master -w master -z 8k
00:00000:00000:2001/01/19 12:01:26.94 server Die
konfigurierte Seitengröße des Servers entspricht nicht
262 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
der, die auf der Befehlszeile angegeben ist. Um die
konfigurierte Größe zu verwenden, lassen Sie die
Größenangabe in der Befehlszeile weg. Um den Wert in der
Befehlszeile zu verwenden, geben Sie 'force' (-f) ein.
Beispiel 6 Schreibt eine fehlerhafte master-Datenbank neu, wobei eine
inkorrekte Seitengröße angegeben ist, sogar bei einem normalen Neustart.
Das erzeugt einen Fehler:
sqlsrvr -d d_master -z4000
sqlsrvr: Die 'z'-Option darf nicht ohne 'b' oder 'w'
verwendet werden. sqlsrvr: Server wird die 'z'-Option
ignorieren. sqlsrvr: die 'z'-Option enthält eine
ungültige Seitengröße. sqlsrvr: Die Seitengröße
muss eine gerade Zweierpotenz zwischen 2048 und
16384 Byte sein.
Syntax Das sqlsrvr-Dienstprogramm wird in anderen Sybase-Dokumenten als
dataserver bezeichnet.
Starten Sie Adaptive Server mit dem services manager-Dienstprogramm
und nicht, indem Sie direkt das sqlsrvr-Programm ausführen. Wenn Sie
Standardparameter ändern wollen, bearbeiten Sie die Registerschlüssel
von Adaptive Server. Weitere Hinweise finden Sie im Konfigurationshandbuch
für Ihre Plattform.
Adaptive Server leitet seine Ausführungsumgebung aus Werten in der
sysconfigures-Systemtabelle ab. Führen Sie die Systemprozedur
sp_configure aus, um die Konfigurationswerte anzuzeigen;
mit sp_configure und reconfigure ändern Sie die Konfiguration.
Da Adaptive Server-Kennwörter verschlüsselt sind, können
Sie vergessene Kennwörter nicht wiederherstellen. Wenn alle
Sicherheitsadministratoren ihre Kennwörter verlieren, erzeugt der
-p-Parameter ein neues Kennwort für ein Sicherheitsadministrator-Konto.
Starten Sie Adaptive Server mit -p, melden Sie sich sofort bei Adaptive
Server mit einem neuen Zufalls-Kennwort an und führen Sie sp_password
aus, um Ihr Kennwort durch ein sichereres zu ersetzen.
Dienstprogramme 263

sqlsrvr
Standardmäßig protokolliert Adaptive Server Fehlermeldungen in der
lokalen Fehlerlogdatei und dem lokalen Windows NT-Ereignis-Log. Sie
können das Windows NT-Ereignis-Log deaktivieren, indem Sie den -g-
Parameter einbeziehen und einen anderen Rechner für das Ereignislog mit
-G Rechnername angeben. Bei der Eingabe des Arguments Rechnername
müssen Sie die Standard-Windows NT-Konventionen benutzen. Beispiel:
Um einen PC mit der Bezeichnung „LOGSITE“ anzugeben, geben Sie
„\\LOGSITE“ als Rechnername-Argument ein. Hinweise über das
Protokollieren von Fehlermeldungen finden Sie im Konfigurationshandbuch
für Ihre Plattform.
Nachdem Sie das Installationsprogramm fertig ausgeführt haben, stellen
Sie die Dateiberechtigungen in der ausführbaren sqlsrvr-Datei ein, um den
Zugriff auf ihre Ausführung zu beschränken.
Wenn Sie einen Adaptive Server-Namen ohne den -s-Parameter
angeben und nicht die Umgebungsvariable DSLISTEN eingestellt
haben, verwendet sqlsrvr den Adaptive Server-Standardnamen SYBASE.
Der Wert der Umgebungsvariablen DSLISTEN setzt diesen Standardwert
außer Kraft. Der -s-Parameter setzt den Standardwert und die DSLISTEN-
Umgebungsvariable außer Kraft.
Automatische Login-Sperren können dazu führen, dass auf einem Rechner
alle Logins gesperrt sind, die dazu berechtigt sind, Logins freizugeben
(Systemadministratoren und Sicherheitsadministratoren). Wenn
das passiert, verwenden Sie das sqlsrvr-Dienstprogramm mit dem
-u-Parameter, um das angegebene Login auf Systemadministrator- oder
Sicherheitsadministrator-Berechtigungen zu überprüfen, geben Sie das
Konto frei und setzen Sie den Zählerwert für aktuelle fehlgeschlagene
Logins auf Null.
-f ist nur gültig, wenn der Parameter mit-b und/oder -w verwendet wird.
Der Server startet nicht neu, wenn Sie -f ohne -b oder -w verwenden.
-f wirkt sich auf den Server unterschiedlich aus, abhängig davon, ob -w
vorhanden ist. Weitere Hinweise finden Sie unter -b und -w weiter unten.
Adaptive Server starten
Sie können eine der beiden nachstehenden Methoden verwenden, um Adaptive
Server mit einer bezeichneten Konfigurationsdatei zu starten:
Verwenden Sie Server Config, um den Server dahingehend
zu konfigurieren, dass er den -c-Parameter aufweist. Im Fenster
„Adaptive Server konfigurieren“ wählen Sie die Option „Befehlszeile“,
und im Fenster „Befehlszeilenparameter“ geben Sie Folgendes ein:
-CKonfigurationsdatei-Pfadname
264 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
Wenn Sie beispielsweise „-chaze.cfg“ eingeben, wird der Server mit der
Konfigurationsdatei haze.cfg hochgefahren.
Starten Sie Adaptive Server von der Befehlszeile und verwenden Sie den
-c-Parameter.
Abhängigkeiten und Bedingungen der -b- und -w-Optionen
Die Auswirkung von -b ist abhängig davon, ob -w vorhanden ist:
-b ohne -w erstellt ein Master-Device, benannt durch -d
(der Standardwert ist d_master) und mit einer in -z angegebenen
Seitengröße (der Standardwert ist 2048):
Wenn das benannte Device bereits als eine OS-Datei vorhanden ist,
schlägt der Versuch fehl und Sie müssen die vorhandene Datei
entfernen und es nochmals versuchen.
Wenn das benannte Device eine vorhandene unformatierte Partition
benennt, schlägt der Versuch fehl, außer Sie beziehen die -f-Option
ein. Das reinitialisiert die unformatierte Partition als ein Server-
Master-Device.
-b mit -w master fordert dataserver dazu auf, die in -z angegebene Größe
zu verwenden, wenn die Master-Datenbank neu erstellt wird. Diese
Einstellung bezieht sich nicht auf das Erstellen eines neuen Devices.
-w erfordert möglicherweise zusätzliche Optionen:
Wenn Sie -w model verwenden, werden die -z- und -b-Optionen akzeptiert,
aber ignoriert.
Wenn Sie -w master bei neuen Installationen verwenden, werden -z und -b
nicht benötigt, weil die Device-Größeninformationen im config_block
gespeichert sind.
Wenn Sie -w master zum Upgrade alter Installationen verwenden,
beachten Sie Folgendes:
Der Server benötigt -b und/oder -z, wenn der config_block keinen
gültigen Eintrag für die zugeordneten Größen enthält. Der Befehl
schlägt fehl, wenn er keine gültigen Daten für die Seitengröße oder
die Devicegröße erhält.
Sie können -b und/oder -z angeben, wenn config_block gültige
Einträge für die Größen, die sie darstellen, enthält. Wenn die Größen
allerdings nicht mit denen im config_block übereinstimmen, müssen
Sie -f hinzufügen, um Ihre neuen Größenwerte durchzusetzen.
Dienstprogramme 265

sqlsrvr
-f kann ohne -b oder -z auftreten, da -f den Server auch anweist,
beschädigte Zuordnungsseiten als zur master-Datenbank gehörend
zu akzeptieren. Das ist nützlich, wenn Sie schwer beschädigte
Datenbanken wiederherstellen. Wenn Sie-w master -f angeben,
ordnet der Server der master-Datenbank jede Zuordnungsseite auf
dem benannten Master-Device zu, die zu keiner anderen Datenbank
als master gehört.
Berechtigungen Jeder mit Ausführungsberechtigung auf die Binärdaten, der Lese/Schreib-
Zugriff auf alle Dateien hat.
Benutzte Tabellen sysconfigures
Siehe auch Befehle disk mirror, disk remirror, reconfigure
Systemprozeduren sp_configure, sp_password
Dienstprogramme startserver
266 Adaptive Server Enterprise

sqlupgrade
Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beschreibung Nur UNIX-Plattformen Stellt Ihre derzeit installierte Adaptive Server-
Version auf die neueste Version um, wobei eine auf X11/Motif basierende
grafische Benutzeroberfläche (GUI) verwendet wird. sqlupgrade befindet sich
unter $SYBASE/ASE-12_5/bin.
Syntax sqlupgrade
[-s Sybase-Verzeichnis]
[-r Ressourcendatei]
Oder
sqlupgrade -v
Parameter -s Sybase-Verzeichnis
gibt den Wert für die SYBASE-Umgebungsvariable an.
-r Ressourcendatei
führt die angegebene Ressourcendatei aus.
-v
gibt die Versionsnummer und Copyright-Meldung für sqlupgrade an und
beendet dann.
Syntax Sie müssen die SYBASE-Umgebungsvariable auf die Position der
aktuellen Version der Adaptive Server-Installation einstellen, bevor Sie
sqlupgrade verwenden können.
Sie müssen die DISPLAY-Umgebungsvariable einstellen, bevor Sie
sqlupgrade aufrufen, außer Sie verwenden den -v-Parameter, um die
Versionsnummer anzuzeigen.
Berechtigungen Sie müssen Sybase-Systemadministrator sein, um sqlupgrade auszuführen
Siehe auch Weitere Hinweise über das sqlupgrade-Dienstprogramm finden Sie in der
Dokumentation Installation Guide for UNIX Platforms.
Dienstprogramme sqlupgraderes
Dienstprogramme 267

sqlupgraderes
sqlupgraderes
Beschreibung Nur UNIX-Plattformen Stellt auf UNIX-Plattformen Ihre derzeit installierte
Adaptive Server-Version auf die neueste Version um, wobei Ressourcendateien
verwendet werden. sqlupgraderes befindet sich unter $SYBASE/
$SYBASE_OCS/bin.
Syntax sqlupgraderes
[-s Sybase-Verzeichnis]
[-r Ressourcendatei]
Oder
sqlupgraderes -v
Parameter -s Sybase-Verzeichnis
gibt den Wert für die SYBASE-Umgebungsvariable an.
-r Ressourcendatei
führt die angegebene Ressourcendatei aus.
-v
gibt die Versionsnummer und Copyright-Meldung für sqlupgraderes an und
beendet dann.
Syntax Sie müssen die SYBASE-Umgebungsvariable auf die Position der aktuellen
Version der Adaptive Server-Installation einstellen, bevor Sie sqlupgraderes
verwenden können.
Berechtigungen Sie müssen Sybase-Systemadministrator sein, um sqlupgraderes auszuführen.
Siehe auch In der Dokumentation Installation Guide for UNIX Platforms finden Sie
weitere Hinweise über das sqlupgraderes-Dienstprogramm.
Dienstprogramme sqlupgrade
268 Adaptive Server Enterprise

srvbuild
Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beschreibung Nur UNIX-Plattformen Erstellt neue Adaptive Server, Backup Server,
Monitor Server oder XP Server mit den Standard- oder benutzerdefinierten
Werten für wichtige Konfigurationsattribute, wobei eine auf X11/Motif
basierende grafische Benutzeroberfläche verwendet wird. srvbuild befindet
sich unter $SYBASE/ASE-12_5/bin.
Syntax srvbuild
[-s sybase-Verzeichnis]
[-I Interfaces-Datei]
[-r Ressourcendatei]
Oder
srvbuild -v
Parameter -s sybase-Verzeichnis
gibt den Wert für die SYBASE-Umgebungsvariable an.
-I Interfaces-Datei
gibt den Namen und Position der Interfaces-Datei an, die durchsucht werden
soll, wenn eine Verbindung mit Adaptive Server hergestellt wird.
-r Ressourcendatei
führt die angegebene Ressourcendatei aus.
-v
gibt die Versionsnummer und Copyright-Meldung für srvbuild an und
beendet dann.
Syntax So müssen Sie die SYBASE-Umgebungsvariable einstellen:
Auf die Position der aktuellen Version von Adaptive Server, bevor Sie
srvbuild verwenden können.
Bevor Sie srvbuild aufrufen, außer Sie verwenden den -v-Parameter,
um die Versionsnummer anzuzeigen.
Berechtigungen Sie müssen Sybase-Systemadministrator sein, um srvbuild auszuführen.
Siehe auch Weitere Hinweise über das srvbuild-Dienstprogramm finden Sie in der
Dokumentation Installation Guide for UNIX Platforms.
Dienstprogramme srvbuildres
Dienstprogramme 269

srvbuildres
srvbuildres
Beschreibung Nur UNIX-Plattformen Erstellt neue Adaptive Server, Backup Server,
Monitor Server oder XP Server mit den Standard- oder benutzerdefinierten
Werten für wichtige Konfigurationsattribute, wobei Ressourcendateien
verwendet werden. srvbuildres befindet sich unter $SYBASE/ASE-12_5/bin.
Syntax srvbuildres
[-s sybase-Verzeichnis]
[-I Interfaces-Datei]
[-r Ressourcendatei]
Oder
srvbuildres -v
Parameter -s sybase-Verzeichnis
gibt den Wert für die SYBASE-Umgebungsvariable an.
-I Interfaces-Datei
gibt den Namen und Position der Interfaces-Datei an, die durchsucht werden
soll, wenn eine Verbindung mit Adaptive Server hergestellt wird.
-r Ressourcendatei
führt die angegebene Ressourcendatei aus.
-v
gibt die Versionsnummer und Copyright-Meldung für srvbuildres an und
beendet dann.
Syntax Sie müssen die SYBASE-Umgebungsvariable auf die Position der aktuellen
Version der Adaptive Server-Installation einstellen, bevor Sie srvbuildres
verwenden können.
Berechtigungen Sie müssen Sybase-Systemadministrator sein, um srvbuildres auszuführen.
Siehe auch In der Dokumentation Installation Guide for UNIX Platforms finden Sie
weitere Hinweise über das srvbuildres-Dienstprogramm.
Dienstprogramme srvbuild
270 Adaptive Server Enterprise

startserver
Kapitel 8 Übersicht über die Dienstprogrammbefehle
Beschreibung Nur UNIX-Plattformen Startet eine Adaptive Server- oder Backup Server-
Installation. startserver befindet sich unter $SYBASE/ASE-12_5/bin.
Syntax startserver [[-f Runserver-Datei] [-m]] ...
Parameter -f Runserver-Datei
legt den Namen einer ausführbaren Serverdatei unter Verwendung relativer
Pfadangaben fest, die jedes Mal referenziert wird, wenn Sie Adaptive Server
oder Backup Server starten. Standardmäßig befindet sich die diese Datei im
aktuellen Verzeichnis und heißt RUN_Servername. Wenn Sie ein zweites
Adaptive Server-System auf demselben Rechner starten, erstellt startserver
eine neue Datei namens RUN_Servername.
-m
startet Adaptive Server im Einzelbenutzer-Modus, in dem sich nur der
System-Administrator anmelden kann, und schaltet den allow updates to
system tables-Konfigurationsparameter auf on. Verwenden Sie diesen
Modus, um die master-Datenbank wiederherzustellen. Der System-
Administrator kann den dbo use only-Parameter von sp_dboption für
System-Administrationsaktivitäten verwenden, die mehr als einen Prozess
erfordern, wie das Kopieren mit dem Massenexport/-import oder die
Verwendung von Data Dictionary. startserver normally starts up only
one server per node.
Der -m-Parameter erstellt eine m_RUNSERVER-Datei und überschreibt alle
vorhandenen m_RUNSERVER-Dateien.
Beispiele Beispiel 1 Startet ein Adaptive Server-System namens SYBASE von der
Runserver-Datei RUN_Servername im aktuellen Verzeichnis:
startserver
Beispiel 2 Startet ein Adaptive Server-System namens MYSERVER und
einen Backup Server namens SYB_BACKUP:
startserver -f RUN_MYSERVER -f RUN_SYB_BACKUP
Beispiel 3 Startet nur das Backup Server-System SYB_BACKUP:
startserver -f RUN_SYB_BACKUP
Syntax startserver verwendet die Information in der Runserver-Datei,
um Adaptive Server oder Backup Server zu starten. Das Master-Device
muss für den Benutzer beschreibbar sein, der Adaptive Server startet.
Dienstprogramme 271

startserver
Der startserver-Befehl erstellt eine Adaptive Server-Fehlerlogdatei
(errorlog genannt) in dem Verzeichnis, in dem Sie den Server starten,
und fügt diese Information als Teil des -e-Parameters in die ausführbare
Adaptive Server-Zeile der Runserver-Datei hinzu. Wenn ein zweites
Adaptive Server-System auf demselben Rechner gestartet wird, wird ein
neues Error-Log namens errorlog_Servername erstellt; diese Information
wird der Runserver-Datei dieses Servers hinzugefügt. Der Benutzer muss
Ausführungsberechtigung für die angegebene Runserver-Datei haben.
Sie können mehrere Server starten, indem Sie mehr als eine Runserver-
Datei anführen, wie in Beispiel 2 gezeigt. Sie können -m nach jedem
-f Runserverdatei angeben.
Adaptive Server leitet seine Ausführungsumgebung aus Werten in der
config-Datei ab. Führen Sie sp_configure aus oder bearbeiten Sie die
config-Datei, um Konfigurationsparameter anzuzeigen oder zu ändern.
Um die Integrität Ihres Adaptive Server-Systems sicherzustellen ist es
wichtig, dass Sie entsprechende Betriebssystem-Sicherheitsmaßnahmen
für die ausführbare startserver-Datei und die Runserver-Datei anwenden.
Die Runserver-Datei
Die Runserver-Datei, die von srvbuild während der Installation erstellt
wird, enthält den dataserver-Befehl, um Adaptive Server, oder den
backupserver-Befehl, um Backup Server zu starten. Standardmäßig
befindet sich die diese Datei im aktuellen Verzeichnis und heißt
RUN_Servername. Sie können die Runserver-Datei bearbeiten, um die
Optionen und Parameter für die Befehle zu korrigieren. Das folgende
Beispiel zeigt zwei Muster-Runserver-Dateien.
Runserver-Datei für Server MYSERVER:
#!/bin/sh
#
# Adaptive Server Information:
# name: /MYSERVER
# master device: /remote/Masters/myserver_dat
# master device size: 10752
# errorlog: /remote/serverdev/install/errorlog
# interfaces: /remote/serverdev/interfaces
#
#
/remote/serverdev/bin/dataserver -d/remote/Masters/myserver_dat \
-sMYSERVER -e/remote/serverdev/install/MYSERVER_errorlog \
-i/remote/serverdev &
Runserver-Datei für Backup Server SYB_BACKUP:
272 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
#!/bin/sh
#
# Backup Server Information:
# name: SYB_BACKUP
# errorlog: /remote/serverdev/install/backup.log
# interfaces: /remote/serverdev/interfaces
# location of multibuf: /remote/serverdev/bin/sybmultbuf
# language: us_english
# character set: iso_1
# tape configuration file: /remote/serverdev/backup_tape.cfg
#
#
/remote/serverdev/bin/backupserver -SSYB_BACKUP \
-e/remote/serverdev/install/backup.log \
-I/remote/serverdev/interfaces \
-M/remote/serverdev/bin/sybmultbuf -Lus_english -Jiso_1 \
-c/remote/serverdev/backup_tape.cfg
Siehe auch Befehle disk mirror, disk remirror, disk unmirror
Dienstprogramme backupserver, dataserver
Dienstprogramme 273

sybmigrate
sybmigrate
Beschreibung sybmigrate ermöglicht es, eine Adaptive Server-Installation von einer
Seitengröße zu einer anderen Seitengröße zu konvertieren und zwischen
Plattformen zu migrieren. Die Programmdatei befindet sich im Verzeichnis
$SYBASE/$SYBASE_ASE/bin/sybmigrate.
Windows NT Die Programmdatei befindet sich im Verzeichnis
%SYBASE%\%SYBASE_ASE%\bin\sybmigrate.bat.
Syntax sybmigrate [-v ] [-h ] [-f]
[-D 1 | 2 | 3 | 4]
[-I Interfaces-Datei ]
[-r Eingabe-Ressourcendatei]
[-m setup | migrate | validate | report]
[-rn status | space_est | repl | diff | password]
[-l Logdatei]
[-t Ausgabe-Vorlage-Ressourcendatei]
[-J Client-Zeichensatz]
[-z Sprache]
[-T Trace-Flags]
[-Tase Trace-Flags]
[-f ]
Parameter -v
druckt die Versionszeichenfolge und beendet dann.
-h
-f
druckt die Hilfeinformationen und Hinweise zur Syntaxverwendung und
beendet dann.
hebt die Sperrsitzung auf.
-D
stellt die Ebene der Fehlerbehebung für sybmigrate ein.
Die Standardebene ist 2.
-I
-r
bezeichnet eine bestimmte interfaces-Datei zum Suchen von Servernamen.
Wenn Sie keinen Speicherort für die interfaces-Datei angeben, wird in
Windows $SYBASE/interfaces bzw. UNIX %SYBASE%\ini\sql.ini
verwendet.
gibt an, dass der Ressourcendatei-Modus beim Migrationsverfahren
verwendet werden soll. Wenn Sie die Eingabe-Ressourcendatei nicht unter
Verwendung des -r-Parameters angeben, wird sybmigrate im GUI-Modus
ausgeführt.
274 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-m
bestimmt die Art der Vorgänge, die durchgeführt werden:
setup – Einrichten des Repository und der aktiven Migrationsdatenbank
und Migration der serverweiten Daten.
migrate – Ausführung der Daten- und Objektmigration.
validate – Validierung der migrierten Objekte.
report – Ausführung eines der fünf möglichen Berichten. Die Berichte
können im GUI- und Ressourcendatei-Modus ausgeführt werden.
Die verfügbaren Berichte sind:
status – Der Objektmigration-Statusbericht enthält Informationen
über Objekte, die migriert wurden.
space_est – Verwenden Sie den Zieldatenbank-
Speicherschätzungsbericht, um zu überprüfen, ob Sie Ihrer
Zieldatenbank genügend Ressourcen zugewiesen haben.
repl – Mit dem Replikationsbericht überprüfen Sie explizit
replizierte Objekte, die migriert wurden, bestimmen den Typ des
Replikationssystems und erstellen SQL-Befehle für Benutzer zur
Ausführung auf der Adaptive Server-Zielinstallation und
Replication Server.
diff – Überprüft die Objekte zwischen Quell- und Zieldatenbanken.
Der diff-Bericht enthält folgende Informationen für folgende
Objekttypen:
Serverinformationen
Datenbankinformationen
DDL-Objekte
Benutzertabellendaten
password – Erstellt eine Datei für die geänderten Kennwörter.
-rn
gibt an, welche Art von Bericht erzeugt werden soll. Wenn -rn nicht
angegeben wird, werden alle fünf Berichte ausgeführt.
-l
bestimmt eine benutzerdefinierte Logdatei, in der die Ausgabe des
Migrationsprozesses gespeichert wird. Ohne Angabe von -l werden die
Logs unter $SYBASE/$SYBASE_ASE/init/logs oder im Arbeitsverzeichnis
gespeichert.
Dienstprogramme 275

sybmigrate
-t
-J
weist sybmigrate an, eine Ausgabe-Vorlage-Ressourcendatei zu generieren,
die für nachfolgende Migrationen im Ressourcendatei-Modus verwendet
werden soll.
gibt den für die Adaptive Server-Verbindung zu verwendenden
Zeichensatz an.
-z
gibt die für die Adaptive Server-Verbindung zu verwendende Sprache an.
-T
legt Befehlszeilen-Trace-Flags fest.
-Tase
wird verwendet, um Adaptive Server-Trace-Flags (eingeschaltet mit dbcc
traceon) für alle von sybmigrate geöffneten Adaptive Server-Verbindungen
auszuführen. Die Trace-Flags müssen in einer durch Kommas getrennten
Listen angegeben werden.
Beispiele Beispiel 1 Führt den status-Bericht aus:
sybmigrate -r Ressourcendatei -m report -rn status
Beispiel 2 Führt den space_est-Bericht im Ressourcendatei-Modus aus:
sybmigrate -r Ressourcendatei -m report -rn space_est
Beispiel 3 Führt den repl-Bericht aus:
sybmigrate -r Ressourcendatei -m report -rn repl
Syntax Wenn sybmigrate eine Sitzung nicht ordnungsgemäß beendet hat, heben
Sie mit -f die geschaffene Verbindung zwischen Quell- und Zieldatenbank
auf, so dass nur eine Sitzung von sybmigrate in einem Quell- und
Zieldatenbankpfad ausgeführt werden kann.
Wenn Sie den -r-Parameter verwenden, müssen Sie auch das -m-Argument
benutzen, um die Art des durchzuführenden Vorgangs anzugeben: setup,
migrate, validate oder report. Sie können den gesamten Migrationsprozess
im Ressourcendatei-Modus ausführen oder ihn wahlweise auch nur
teilweise auf diese Art ausführen.
Sie können -t nur im Ressourcendatei-Modus ausführen.
276 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-t erfordert, dass Sie sybmigrate unter Verwendung des -r-Arguments
starten, wobei die Login-Informationen angegeben werden.
Die Verwendung dieses Arguments macht es auch erforderlich, -
m zu verwenden, um anzugeben, welche Art von Ressourcendatei
erzeugt werden soll.
Sie können sybmigrate außer Kraft setzen und die interfaces-Datei
verwenden, indem Sie das -I-Argument angeben, wenn der LDAP-
Eintrag in $SYBASE/$SYBASE_OCS/config/libtcl.cfg (in Unix) oder
in %SYBASE%\%SYBASE_OCS%\ini\libtcl.cfg (in NT) definiert ist.
Berichte
status – Der Objektmigration-Statusbericht enthält Informationen über
Objekte, die migriert wurden.
space_est – Verwenden Sie den Zieldatenbank-Speicherschätzungsbericht,
um zu überprüfen, ob Sie Ihrer Zieldatenbank genügend
Ressourcen zugewiesen haben.
repl – Mit dem Replikationsbericht überprüfen Sie explizit replizierte
Objekte, die migriert wurden, bestimmen den Typ des Replikationssystems
und erstellen SQL-Befehle für Benutzer zur Ausführung
auf der Adaptive Server-Zielinstallation und Replication Server.
diff – Überprüft die Objekte zwischen Quell- und Zieldatenbanken.
Die Benutzer können den Bericht an einzelnen Objekten oder der
ganzen Datenbank ausführen, mit Ausnahme von Server- und
Datenbankinformationen oder Metadaten. Sie können den diff-Bericht
jederzeit ausführen. Zur Ausführung des diff-Berichtes müssen Sie keine
Einrichtungssitzung ausführen. Der Name der Quell- und Zieldatenbank
muss bei Ausführung des diff-Berichtes nicht derselbe sein.
Der diff-Bericht enthält folgende Informationen für folgende Objekttypen:
Serverinformationen – Vergleich der Zeilenanzahl der
Systemkataloge in der Master-Datenbank zwischen der
Adaptive Server-Quell- und Zielinstallation. Diese Aufgabe
ähnelt der Validierungssitzung.
Datenbankinformationen – Vergleich der Zeilenanzahl der Systemkataloge
in der Benutzerdatenbank zwischen der Adaptive Server-
Quell- und Zielinstallation. Diese Aufgabe ähnelt der Validierungssitzung.
Dienstprogramme 277

xpserver
DDL-Objekte – Der Bericht zeigt, ob die Objekte in der Adaptive
Server-Quell- oder Zielinstallation vorhanden sind. Wenn die Objekte
in beiden Datenbanken vorhanden sind, wird das Objekt nicht in dem
Bericht angezeigt.
Benutzertabellendaten – Vergleich der Zeilenzahl der Benutzertabellen
in der Adaptive Server-Quell- und Zielinstallation. Wenn die
Tabelle nur in der Quell- oder Zieldatenbank vorhanden ist, wird die
Tabelle nicht in dem Bericht angezeigt.
Berechtigungen Sie müssen Sybase Systemadministrator sein oder sich mit „sa_role“
anmelden, um sybmigrate verwenden zu können.
Siehe auch Kapitel 6, „Migrations-Dienstprogramm“ enthält ausführliche Informationen
zum sybmigrate-Dienstprogramm.
xpserver
Beschreibung Startet XP Server manuell.
Syntax xpserver -S XP-Server
xpserver
-SXP-Server
[-I Interfaces-Datei]
[-pPriorität]
[-sStack-Größe]
[-u]
[-v]
[-x]
Parameter -S XP-Server
gibt den Namen der XP Server-Installation an, die gestartet werden soll.
Das Format des XP Server-Namens ist SQLSERVERNAME_XP, wobei
SQLSERVERNAME der Name der Adaptive Server-Installation ist, für den
das XP Server-System dediziert ist. So würde zum Beispiel das XP Server-
System für eine Adaptive Server-Installation namens SMOKE SMOKE_XP
genannt werden. Der XP Server-Name muss in Großbuchstaben sein.
-I Interfaces-Datei
gibt den Namen und den Standort des Verzeichnisses an, das die Interfaces-
Datei (sql.ini) enthält, nach der Adaptive Server bei der Verbindungsaufnahme
mit XP Server sucht. Wenn Sie -I nicht festlegen, benutzt xpserver
das ini-Unterverzeichnis des %SYBASE%-Versionsverzeichnisses.
278 Adaptive Server Enterprise

Kapitel 8 Übersicht über die Dienstprogrammbefehle
-p Priorität
legt die Priorität für den Open Server-Prozess fest. Werte zwischen 0
(Minimum) und 15 (Maximum) sind gültig. Damit wird der esp execution
priority-Konfigurationsparameter aufgehoben. Der Standardwert ist 8.
-s Stack-Größe
legt (in Byte) die Stack-Größe des Prozesses fest, mit dem eine erweiterte
gespeicherte Prozedur (ESP) ausgeführt wird. Damit wird der esp execution
stacksize-Konfigurationsparameter aufgehoben, falls er eingestellt ist.
Der Standardwert ist 34816 Byte.
-u
-v
-x
legt fest, dass die Funktionen automatisch vom XP Server-Speicher entladen
werden, nachdem die ESP-Anforderung beendet ist. Damit wird der esp
unload dll-Konfigurationsparameter aufgehoben, falls er eingestellt ist.
Der Standardwert ist, die Funktion nicht zu entladen.
gibt die Versionsnummer und Copyright-Meldung für XP Server an und
beendet dann.
legt fest, dass der Client-Sicherheitskontext verwendet werden soll, um
Betriebssystem-Befehle mittels der System-ESP xp_cmdshell auszuführen.
Damit wird der xp_cmdshell context-Konfigurationsparameter aufgehoben,
falls er eingestellt ist. Der Standardwert ist die Verwendung des
Sicherheitskontextes vom Betriebssystemkonto der Adaptive Server-
Sitzung.
Syntax XP Server wird normalerweise automatisch von Adaptive Server gestartet.
Verwenden Sie den manuellen Befehl zum Starten von XP Server nur
dann, wenn Sie in einer „XP Server nicht gestartet“-Fehlermeldung dazu
aufgefordert werden.
Es darf nur ein XP Server-System pro Adaptive Server-Installation geben.
Eine Adaptive Server-Installation, die ESP ausführt, kommuniziert mit
einem einzigen XP Server-System, und die ESP werden synchron
ausgeführt.
Dienstprogramme 279

xpserver
Der -p-Parameter wirkt sich auf die Priorität aus, die der Open Server-
Scheduler verwendet. Wenn -p einen hohen Wert hat, kann der Scheduler
XP Server ausführen, bevor er die anderen Threads in seiner Task-Liste
ausführt. Wenn -p einen niedrigen Wert hat, kann der Scheduler XP
Server nur dann ausführen, wenn es keine weiteren Open Server-Threads
in seiner Task-Liste gibt. Dieser Parameter ist unabhängig von den
Anwendung-Warteschlangen-Prioritäten in Adaptive Server, die von
sp_bindexeclass eingestellt werden.
Siehe dazu die Erörterung der Mehrfach-Thread-Programmierung in der
Dokumentation Open Server Server Library/C Reference Manual. Dort
finden Sie Hinweise zur Abfolgeplanung von Open Server-Threads.
Wenn das automatische Entladen von ESP-Funktionen nicht durch den -u-
Parameter oder den esp unload dll-Konfigurationsparameter eingestellt ist,
können Sie sie jederzeit während der Laufzeit mit sp_freedll entladen.
Im Unterschied zu Adaptive Server und Backup Server hat XP Server
keine Runserver-Datei.
Bei der Konfiguration einer XP Server-Installation muss der Name
des Verzeichnisdiensteintrags mit „_XP“ in Großbuchstaben enden,
beispielsweise „abcdef_XP“ oder „ABCDEF_XP“.
Berechtigungen Zum Ausführen von xpserver sind keine besonderen Berechtigungen
erforderlich.
Siehe auch System ESP xp_cmdshell
Systemprozeduren sp_configure, sp_freedll
280 Adaptive Server Enterprise

Index
Symbols
!! (Ausrufezeichen), Betriebssystembefehls-
Präfix (isql) 234
\ (Rückstrich)
Escape-Zeichen für Sonderzeichen 152
\ (Rückstrich), Datenfeldabschlusszeichen in
interaktivem bcp 47
\\0 (Null), Zeichenabschlusszeichen in
interaktivem bcp 47
\gt (Umleitung hinaus) in isql 16
\isql 16
\xd2 \xd3 (Anführungszeichen) zum Umschließen
von Sonderzeichen 152
“ ” (Anführungszeichen) zum Umschließen von
Sonderzeichen 152
A
Abfragepuffer, zurücksetzen 12
Abschlusszeichen (bcp) 53
andere Programme, verwenden für 47
ändern 38
definiert 19
Feld und Zeile, und 46, 48
Adaptive Server
ausführen (dataserver) 187
ausführen (sqlsrvr) 255
Konfiguration, Migration 108
Upgrade (sqlupgrade) 263
Upgrade mit Ressourcendateien
(sqlupgraderes) 264
Zurücksetzen von Prozessen 63
Adaptive Server (Quelle), Migration 95
Adaptive Server (Ziel), Migration 95
additional network memory, Parameter 105
allow_dup_row, Option von create index, und bcp 66
andere Dienstprogramme von Adaptive Server
und bcp 68
Ändern
Servereinträge (dscp) 89
Servereinträge mit dsedit 77, 80
Sortierreihenfolgen (sqllocres) 254, 255
Sortierreihenfolgen, in GUI (sqlloc) 253, 254
Sprachen (sqllocres) 254, 255
Sprachen, in GUI (sqlloc) 253, 254
Zeichensätze (sqllocres) 254, 255
Zeichensätze, in GUI (sqlloc) 253, 254
Anführungszeichen (\xd2 \xd3) zum Umschließen
von Sonderzeichen 152
Anführungszeichen (‘ ’) zum Umschließen von
Sonderzeichen 152
Ansichten, kopieren mit defncopy 209
Anwendungsprogramme, Daten kopieren von 54
Anzahl
Serververbindungen zu backupserver 158
ascii_7, Zeichensatz
defncopy und 210
ASCII-Format, bcp und 36
Auffüllen mit Zeichen und bcp 46
Aufgaben nach der Migration, für sybmigrate 130
Ausführen von Adaptive Server 187, 255
Siehe auch dataserver, Dienstprogrammbefehl 187
Siehe auch sqlsrvr, Dienstprogrammbefehl 255
Ausgabeformate, Daten Siehe Exportieren von Daten mit
interaktivem bcp 54
Ausrufezeichen (!!) Betriebssystembefehls-
Präfix (isql) 234
Auswählen eines Verzeichnisdienst-Bildschirms 72
B
Backup Server 158
Siehe auch backupserver, Dienstprogrammbefehl
158
backupserver, Dienstprogrammbefehl 158
Berechtigungen, erforderliche 162
Definition 158
Dienstprogramme 281

Index
Fehlerlogdatei 159
Fehlermeldungen in 162
Interfaces-Datei 162
Interfaces-Datei, Name und Position von 158
LC_ALL, Umgebungsvariable 159
Server starten und 161
Servernamen angeben 158
Serververbindungen, Anzahl von 158
Sprache, Standardwert 159
Trace Flags 162
vollständige Pfadnamen angeben 159
Zeichensatz, Standardwert 160
-bbatch_size, Parameter 62
bcp für die Migration 96
bcp, Dienstprogrammbefehl 69, 163
Abschlusszeichen verwendet in 19
allow_dup_row, Option von create index 66
andere Dienstprogramme von Adaptive Server und 68
Anweisungsfolgen in 62
Anweisungsfolgen von Tabellenzeilen importieren 62
Anweisungsfolgengröße-Einstellungen 166
ASCII-Format und 36
-bbatch_size, Parameter 62
Beispiele der Verwendung 168
Berechtigungen erforderlich für 20, 43
Binärformat und 19
Dateispeichertypen in 40
Daten exportieren 54, 57, 64
Datenintegrität 67
Datenspeichergröße in 40
Datentypen 46
Datenübertragung, vorbereiten für 20
Datenverlust und Sicherung 24
Definition 163
dump database und 68
eindeutige Identity-Spaltenwerte und 34
einfügen und 69
Eingabeaufforderungen in 40
Eingabeaufforderungen und Antworten Siehe
Interaktiver bcp 38
erläutert 18
Fehler in Datenkonvertierung 66
Fehlerdateien 65
Feldabschlusszeichen 38, 41
Feldlängen 36
Formatdateien 50, 54
Fragen zur Performance bei 22, 34, 68
Geschwindigkeit, Modi der 21
Geschwindigkeit, und Indizes und Trigger 22
Identity-Spalten und 33
Importieren von Daten 25, 28, 57, 61
Indexerstellung 66
Indizes und Trigger, löschen 25
interaktiver Modus 38, 48
Kennwortverschlüsselung in 170
Konfigurationsparameter 65
langsame Version und Deadlocks auf
Indexseite 27
langsame Version von 23
load database und 68
load transaction und 68
maximale Geschwindigkeit, aktivieren 68
natives Dateiformat und 36
natives Format und 36
nicht interaktiv 36
non-iso_1-Datendateien und 61
partitionierte Tabellen und 26, 35, 64
Performance der Vorgänge steigern 65
Platzbedarf für Daten 25
Präfixlänge 40
Regeln und Daten kopieren 68
schnelle Version von 23
schnelle Version von, und Wiederherstellbarkeit
von Daten 23
Seitenzuweisungen, zunehmend für 28
select into/bulkcopy/pllsort und 25
Sonderzeichen, Behandlung 167
sp_dboption 25
Speichertypen 46
Sprachen, andere Sprachen verwenden 61
Standardfeldlänge, Konvertierung von Nichtzeichen
in Standarddatentyp 45
Standardwerte für Daten 67
Standardwerte für Spalten und Datentypen 67
System Data Format (SDF), Ausgabe 55
Systemunterschiede 37
Tabellen-Standardwerte und Daten kopieren 67
Trigger in Zieltabelle nicht ausgelöst 22
Trigger und Daten kopieren 68
Übertragen von Daten zwischen Programmen 19
verwenden mit Zugriffsregeln auf Zeilenebene 62
Warnung über Daten-Wiederherstellung 166
282 Adaptive Server Enterprise

Wiederherstellbarkeit beim Import von
Daten erleichtern 63
Zeichenformat 36
Zeichenformat, Dateien 36
Zeichenformat, Standard 37
Zeichenformate akzeptiert 19
Zeichensatz-Standardwerte 169
Zeilenabschlusszeichen 38
Zurücksetzen von Prozessen 63
Bearbeiten
Interfaces-Dateien 72, 74
Interfaces-Dateien in GUI (dsedit) 217
Netzwerktransportadressen in dsedit 80
Befehlsabschlusszeichen (isql) 10
Statistikoption 14
Begrenzer
Daten exportieren mit 56
Importieren von Daten mít 59
Beispiele
bcp, Dienstprogrammbefehl 168
defncopy, Dienstprogrammbefehl 213
dscp, Dienstprogrammbefehl 216
isql, Dienstprogrammbefehl 227
showserver, Dienstprogrammbefehl 247
startserver, Dienstprogrammbefehl 267, 268
Berechtigungen erforderlich für
bcp, Dienstprogrammbefehl 20, 43
Betriebssystemdatei, Tabellen kopieren in 20
Tabellen, Daten kopieren in 20
Berechtigungen, erforderliche
backupserver, Dienstprogrammbefehl 162
Betriebssystemdatei, Tabellen
hineinkopieren 175
charset, Dienstprogrammbefehl 186
dataserver, Dienstprogrammbefehl 192, 260
dscp, Dienstprogrammbefehl 216
dsedit, Dienstprogrammbefehl 72, 217
langinstall, Dienstprogrammbefehl 237
optdiag, Dienstprogrammbefehl 245
sqlloc, Dienstprogrammbefehl 254
sqllocres, Dienstprogrammbefehl 255
sqlupgrade, Dienstprogrammbefehl 263
sqlupgraderes, Dienstprogrammbefehl 264
srvbuild, Dientsprogrammbefehl 265
srvbuildres, Dienstprogrammbefehl 266
tables, Daten hineinkopieren 175
xpserver, Dienstprogrammbefehl 275
Index
Berichte für sybmigrate 112, 270
Betriebssystemdateien
erforderliche Berechtigung zum Hineinkopieren
von Tabellen 175
erforderliche Berechtigungen zum Kopieren
von Tabellen in 20
natives Format 36
Betriebssysteme
Befehlspräfix (!!) (isql) 234
Nicht-Zeichen-Datentypformatierung 42
nummerische Datentypformatierung 36
Binärdaten
bcp und 19
Standard in interaktivem bcp 43
buildmaster, Dienstprogrammbefehl Siehe
auch dataserver
C
char-Datentyp und bcp 36
charset, Dienstprogrammbefehl 185, 186
Berechtigungen, erforderliche 186
Definition 185
Einstellungen für 186
CIS bulk insert array size
Konfiguration für die Migration 104, 109
CIS bulk insert batch size 109
CIS packet size
Konfiguration, Migration 108
Migration 105
Copy Threads für sybmigrate 107
create index, Befehl, bcp und doppelte Zeilen 66
Dienstprogramme 283
D
data limits filter mode, Migration 131
dataserver, Dienstprogrammbefehl 187
Berechtigungen, erforderliche 192, 260
Definition 187
Kennwörter, neue generieren 192
Dateien
Fehler (bcp) 65
natives Format 36
Siehe auch Formatdateien in bcp 50
Standardformate mit bcp 36

Index
Daten
Analyse Siehe Feldabschlusszeichen 38
erforderliche Berechtigung zum Kopieren
in Tabellen 175
erforderliche Berechtigungen zum Kopieren
in Tabellen 20
Konvertierungsfehler 66, 67
mit Adaptive-Server-Befehlen ändern 69
mit Adaptive-Server-Befehlen verschieben 68
mit bcp aus verschiedenen Programmen übertragen 19
mit bcp importieren und exportieren 18
mit Leerzeichen in interaktivem bcp auffüllen 44
Wiederherstellbarkeit 23
Datenbank erneut migrieren 142
Datenbankdaten, Migrieren 97
Datenbanken zusammenführen, bei der Migration 142
Datenbanken, kopieren mit bcp 69
Datenbank-Managementsystem, andere 54
Datenbankobjekte
kopieren mit bcp 163
Datentypen
bcp, Dateispeichertypen für 42
bcp, Dateispeichertypen in 39
bcp, verwendet in 46
bcp-Formatdateien für 50
char 36
Feldlängen im interaktiven bcp 41, 48
implizite Konvertierung von 41, 42
Konvertierung von Nichtzeichen- in
Zeichen-Standardfeldlänge in bcp 45
kopieren und Kompatibilität 59
Speicherung (SYB) 52
Standardwerte und bcp 67
Datenübertragung, Standardformate mit bcp 36
ddlgen für die Migration 96
Debug-Level für sybmigrate 111
default network packet size, Konfigurationsparameter 65
Definitionen
backupserver, Dienstprogrammbefehl 158
bcp, Dienstprogrammbefehl 163
charset, Dienstprogrammbefehl 185
dataserver, Dienstprogrammbefehl 187
defncopy, Dienstprogrammbefehl 209
dscp, Dienstprogrammbefehl 216
dsedit, Dienstprogrammbefehl 217
isql, Dienstprogrammbefehl 226
kopieren. Siehe defncopy,
Dienstprogrammbefehl 209
optdiag, Dienstprogrammbefehl 239
showserver, Dienstprogrammbefehl 247
sqlloc, Dienstprogrammbefehl 253
sqllocres, Dienstprogrammbefehl 254
sqlsrvr, Dienstprogrammbefehl 255
sqlupgrade, Dienstprogrammbefehl 263
sqlupgraderes, Dienstprogrammbefehl 264
srvbuild, Dientsprogrammbefehl 264
srvbuildres, Dienstprogrammbefehl 265
startserver, Dienstprogrammbefehl 266
sybmigrate, Dienstprogrammbefehl 269
xpserver, Dienstprogrammbefehl 273
defncopy, Dienstprogrammbefehl 209
ascii_7 Zeichensatz und 210
Ausfall wegen langer Kommentare 214
Beispiele 213
Definition 209
Kennwörter und Ausfälle 210
Report Workbench, inkompatibel mit 209
verschlüsselter Text 215
Dienstprogrammbefehle
Sonderzeichen verwenden 152
Tabelle der Befehle 153
DISPLAY, Umgebungsvariable
in dsedit einstellen 72
dscp, Dienstprogrammbefehl 216
Befehlstabelle 93
Beispiele 216
Berechtigungen, erforderliche 216
definiert 85
Definition 216
Einträge, neue durch Kopieren erstellen 90
exit-Befehl 93
help 85
Hilfe 93
in andere Sitzungen kopieren 91
quit-Befehl 93
Serverattribute 87
Servereinträge ändern 89
Servereinträge auflisten 91
Servereinträge hinzufügen 88
Servereinträge kopieren 90
Servereinträge löschen 92
Servereintraginhalt anzeigen 91
284 Adaptive Server Enterprise

Sitzungen auflisten 86
Sitzungen öffnen 86
Sitzungen schließen 86
starten 85
zwischen Sitzungen kopieren 90
dsedit, Dienstprogrammbefehl 217
Befehlszeilenoptionen 72
Berechtigungen, erforderliche 72, 217
Bildschirm „Directory Service Session“ 74
Definition 217
DISPLAY-Umgebungsvariable und 72
Fehlerbehandlung 71, 83
Hinzufügen, Ändern oder Löschen von
Servereinträgen nicht möglich 84
Info 71
libtcl.cfg-Datei 73
Netzwerktransportadressen bearbeiten 80
Netzwerktransportadressen hinzufügen 80, 83
Fehlermeldung \xd2Öffnen der X-Anzeige nicht
möglich\xd3 84
öffnen mit sql.ini 73
Serverattribute 76
Servereinträge ändern 77, 80
Servereinträge hinzufügen 77, 80
Servereinträge kopieren 79, 80, 82, 83
Servereinträge löschen 78
Servereinträge umbenennen 78
Sitzungen öffnen 74
Sitzungen schließen 74
starten 72
startet nicht 83
SYBASE-Umgebungsvariable und Position von
libtcl.cfg ermitteln 73
Verzeichnisdienst-Bildschirm auswählen 72
von der Befehlseingabeaufforderung starten 71
von entfernten Rechnern ausführen 72
Windows NT Explorer aus starten 71
DSLISTEN, Umgebungsvariable
backupserver und 161
dump database, Befehl
bcp und 68
dump transaction, Befehl
bcp und 68
Fehlermeldung, dump database empfohlen 23
Index
E
Echo-Eingabe (isql) 16
Eingabeaufforderungen
bcp Siehe Interaktiver bcp 38
Eingabeaufforderungen in bcp-
Dienstprogrammbefehl 40
enable unicode conversions, Migration 106
Entfernte Rechner 72
Entfernte Rechner, dsedit verwenden 72
Erstellen
neue Server (srvbuild) 264, 265
neue Server mit Ressourcendateien
(srvbuildres) 265, 266
exit-Befehl
in dscp 93
in isql 10
Exportieren von Daten mit interaktivem bcp 54, 57
Begrenzer 56
Fehlerdateien und 67
Felder mit fester Länge 54
für andere Software 54
Text- und Bilddaten 64
Exportieren von Daten Siehe Exportieren von Daten
mit interaktivem bcp 54
F
Fehler
in Datenkonvertierungen 66, 67
Vorgänge, speichern während des Exports 67
Vorgänge, speichern während des Imports 65
Fehlerbehandlung, dsedit 83
Fehlerbereinigung, sybmigrate 142
Fehlerdateien
bcp und 65, 67
Exportieren und 67
Fehlerlogdateien
für backupserver 159
Fehlermeldungen
dsedit und X-Anzeige 84
dump database statt dump transaction 23
in backupserver 162
select into/bulkcopy/pllsort in schnellem bcp auf
Tabellen ohne Indizes oder Trigger 25
Fehlermeldungen, Migration 140
Dienstprogramme 285

Index
Fehlersuche-Dienstprogramm 247
Feldabschlusszeichen 38
bcp 41
interaktiver bcp 47, 48
Felder mit fester Länge 54
Feldlängen
Importieren 57
in interaktivem bcp 44, 46
Präfixlänge, Ganzzahlwert in 53
Formatdateien in bcp 50, 54
Abschlusszeichen 53
Anzahl der Datensätze in 51
Elemente verwendet in 50
Format verwendet für 50
Hostdatei-Datenlänge 53
Hostdatei-Datentyp-Speicherungsformate (SYB) 52
Hostdatei-Spaltenreihenfolge 52
Präfixlänge, Ganzzahlwert in 53
Server-Spaltenname 54
Server-Spaltenreihenfolge 53
Spalten-Dezimalstellen 54
Spalten-Gesamtstellenzahl 54
Spaltennummern 51
speichern 50
TSD-Versionsnummer in 51
G
Gespeicherte Prozeduren
kopieren mit defncopy 209
Größe
Datenspeicher in bcp 40
Paketgröße 64
Text- oder Bilddaten- 64
GUI-Modus
Migration 114
H
help, Befehl (dscp) 85
Hilfebefehl (dscp) 93
Hinweise
Anweisungsfolgengröße-Einstellungen in bcp 166
ascii_7, Zeichensatz-Kompatibilität 210
defncopy und Report Workbench 209
Kennwörter verwenden 152
langsame Version von bcp und Deadlock 27
Nullabschlusszeichen oder kein
Abschlusszeichen 48
select into/bulkcopy/pllsort und Kopieren
von Daten in bcp 25
Sicherheit 152
Sonderzeichen, Behandlung in bcp 167
Systemunterschiede in bcp 37
Trigger von bcp in Zieltabelle nicht ausgelöst 22
verborgener verschlüsselter Text 215
Hinzufügen
Netzwerktransportadressen in dsedit 80, 83
Servereinträge in dscp 88
Servereinträge in dsedit 77, 80
Hohe Verfügbarkeit
Migration 138
Host-Datei
isql und Lesevorgänge 16
Hostdateien
Datenlänge 53
Datentyp-Speicherungsformate (SYB) 52
natives Format in interaktivem bcp 44
Spaltenreihenfolge 52
I
Identity-Spalten
bcp und 34
Paralleler bcp und 33, 34
ignore_dup_key, Option von create index und bcp 66
image, Datentyp
interaktiver bcp und 43
Importieren von Daten
Anweisungsfolgen in 62
paralleler bcp, Anforderungen für 29, 34
Partitionieren, ungesteuerte Verwendung 27
partitionierte Tabellen 27
Schritte der schnellen Version von bcp 25
Wiederherstellbarkeit nach Zurücksetzung
erleichtern 63
Importieren von Daten mit interaktivem bcp 57, 61
Begrenzer 59
Fehlerdateien und 67
Feldlängen 57
Kompatibilität von Datentypen, und Ausfall 59
Importieren von Daten Siehe Kopieren von Daten
mit interaktivem bcp 57
286 Adaptive Server Enterprise

Index neu erstellen, Migration 130
Index Threads für sybmigrate 108
Indizes
bcp, vor der Verwendung löschen 25
Verlangsamen von bcp 22
insert, Befehl
Massenexport/-import der Daten, Vergleich 69
Installieren
Sortierreihenfolgen (sqllocres) 254, 255
Sortierreihenfolgen, in GUI (sqlloc) 253, 254
Sprachen (sqllocres) 254, 255
Sprachen, in GUI (sqlloc) 253, 254
Sprachen, neue (langinstall) 236, 239
Zeichensätze (sqllocres) 254, 255
Zeichensätze, in GUI (sqlloc) 253, 254
Interaktiver bcp
Daten für andere Software kopieren 39
implizite Konvertierung von Datentypen 41, 42
interaktiver bcp 38, 48
Abschlusszeichen für neue Zeilen (\\n) 47
Abschlusszeichen für tabellarische
Datenvorbereitung 47
Abschlusszeichen, Feld und Zeile 46, 48
auffüllen, Daten mit Leerstellen 44
Binärdaten, Standardwert 43
Dateispeichertypen 39, 42
Daten exportieren 54, 57
Feldabschlusszeichen 47, 48
Felder, Präfixlänge von 42, 44
Feldlänge 44, 46
image-Datentyp, Standardwert für 43
Importieren von Daten 57, 61
Nullwerte und 43
Rückstrich, Abschlusszeichen (\) 47
Speicherlänge 44, 46
Standardwerte für Eingabeaufforderungen 38, 48
Tabulator-Feldabschlusszeichen (\\) 47
Textdaten kopieren, Standardwert für 43
Zeichenabschlusszeichen Null oder
unsichtbar (\\0) 47
Zeichenformatdateien, Abschlusszeichen für 47
Zeilenabschlusszeichen 47, 48
Zeilenschaltung,
Datenfeldabschlusszeichen (\\r) 47
Interaktiver SQL-Parser 226
Siehe auch isql, Dienstprogrammbefehl 226
Index
Interface-Dateien
dscp-Sitzungen öffnen 86
interfaces-Datei
für sybmigrate 111
Interfaces-Dateien
backupserver und 162
backupserver, Name und Position festlegen 158
dscp, anzeigen und bearbeiten mit 216
dsedit, anzeigen und bearbeiten mit 217
dsedit, bearbeiten mit 74
dsedit, in GUI anzeigen und bearbeiten mit 217
zum Bearbeiten öffnen 72
Interfaces-Dateien in GUI anzeigen 217
Siehe auch dsedit, Dienstprogrammbefehl 217
Interfaces-Dateien in GUI bearbeiten
Siehe auch dsedit, Dienstprogrammbefehl 217
iso_1, Zeichensatz 61
isql, Dienstprogrammbefehl 226
\< (Umleitung herein), Symbol 16
\gt (Umleitung hinaus), Symbol 16
Abfragen, bearbeiten 12
Abfragepuffer, zurücksetzen 12
Ausgabe, Formatierung 11
Ausgabedatei 11
Befehlsabschlusszeichen 10
Befehlsabschlusszeichen, ändern 13
Befehlsabschlusszeichen, zurücksetzen 228
Beispiele 227
Definition 226
Echo-Eingabe 16
exit-Befehl 10
Host-Dateien, lesen 16
maximale Anweisungsgröße 10
Netzwerkpaketgröße 15
Netzwerkpaketgröße, angeben 15
Paketgröße 15
quit-Befehl 10
reset-Befehl 12
Spaltentrennzeichen 11
Statistik 14
Statistikoption mit Befehlsabschlusszeichen 14
Tippfehler korrigieren 12
Transact-SQL, Verwendung mit 10
Zeilennummern, entfernen 11, 16
isql-Ausgabe formatieren 11
Dienstprogramme 287

Index
J
JAVA_HOME, Umgebungsvariable
Migration 102
Java-Spalten für die Migration 106
K
Kennwörter
bcp-Verschlüsselung 170
defncopy und 210
Hinweise zur Verwendung 152
neue generieren 192
Komma-begrenzte Ausgabe 54, 56
Komponentenverzeichnis für die Migration 102
Konventionen, Syntax xv
Kopieren
andere Sitzungen in dscp 91
neue Einträge mit dscp 90
Servereinträge mit dscp 90
Servereinträge mit dsedit 79, 80, 82, 83
zwischen Sitzungen in dscp 90
Kopieren von Definitionen 209
L
Laden von Zeichensätzen 185, 186
Siehe auch charset, Dienstprogrammbefehl 185
LANG, Umgebungsvariable in backupserver 159
langinstall, Dienstprogrammbefehl 236, 239
Berechtigungen, erforderliche 237
Definition 236
langsame Version von bcp 23
Deadlocks auf Indexseiten 27
LC_ALL, Umgebungsvariable in backupserver 159
load database, Befehl und bcp 68
load transaction, Befehl
bcp und 68
Löschen
Servereinträge (dscp) 92
M
manuelle Migration, was nicht migriert wird 98
Massenexport/-import 69
Massenimport/-export der Daten
Siehe auch bcp, Dienstprogrammbefehl 163
max memory, Migration 105
max network packet size, Konfiguration für
die Migration 109
max network packet size, Konfigurationsparameter 65
max packet size allowed, für sybmigrate 105
max parallel degree, Konfiguration für die
Migration 108
Mehrbyte-Zeichensätze, Migration 107
Migrieren
Server (sybmigrate) 269
N
natives Dateiformat
bcp und 36
natives Format, Dateien 36
Netzwerkpaketgröße
angeben in isql 15
Netzwerktransportadressen
dsedit, bearbeiten mit 80
hinzufügen mit dsedit 80, 83
Netzwerktransporte 75
Neue Server erstellen, mit Ressourcendateien 265, 266
Siehe auch srvbuildres,
Dienstprogrammbefehl 265
Neue Server, erstellen 264, 265
Siehe auch srvbuild, Dienstprogrammbefehl 264
Neue Zeile, Abschlusszeichen (\\n)
in bcp 37
in interaktivem bcp 47
nicht druckbare Zeichen, Hostdatei 44
nicht protokollierte Transaktionen 23
Nicht-Zeichen-Datentypen,
Betriebssystemformat für 42
Null, Zeichenabschlusszeichen (\\0) in
interaktivem bcp 47
Nullwerte 66
interaktiver bcp und 43
number of sort buffers für die Migration 109
number of user connections für die Migration 108
288 Adaptive Server Enterprise

number of user connections, für die Migration 109
number of worker processes für die Migration 108
nummerische Datentypen
bcp-Konvertierung in Zeichenspeicherung 45
Betriebssystemformat für 36
Spalten-Dezimalstellen 54
Spalten-Gesamtstellenzahl 54
Nummern
Zeile, entfernen aus isql 11, 16
O
Objekte
keine Migration 140
nach der Migration neu erstellen 143
Objekthierarchie für die Migration 103
Öffnen
Sitzungen in dscp 86
Sitzungen in dsedit 74
optdiag, Dienstprogrammbefehl 239
Berechtigungen, erforderliche 245
Definition 239
P
Paketgröße, Netzwerk
angeben in isql 15
bcp, angeben mit 64
Paralleler bcp
in eine bestimmte Partition kopieren 29, 33
Syntax 32
verschiedene Methoden der Verwendung 31
paralleler bcp
Identity-Spalten und 33, 34
verschiedene Methoden der Verwendung 34
partitionierte Tabellen in bcp 26, 35
Importieren von Daten, Methoden für das 27
Kopieren von Daten, ungesteuert 27
Seitenzuweisungen, zunehmend 28
Performance
bcp und 22, 34, 68
isql-Netzwerkpaketgröße 15
Massenexport und Paketgröße 65
Index
Positionen von backupserver-Fehlerlogdateien 159
Präfixfeldlängen im interaktiven bcp 42
Präfixfeldlängen in interaktivem bcp 44
Präfixlänge 53
Präfixlängen in bcp 40
Primärdatenbank, nach Migration
wiederherstellen 133
Primäre Replikatdatenbank, Migration 132
Problembehebung, Migration 140
Puffer, Abfrage 12
Q
quit-Befehl
in dscp 93
in isql 10
R
Regeln
defncopy, kopieren mit 209
Tabellen, Daten kopieren in 67
Replication Server, replizierte Daten in
Adaptive Server 12.5 migrieren 130
Replikatdatenbank
Migration 132
Nach Migration wiederherstellen 134
Replizierte Datenbanken
Aufgaben nach der Migration 133
Report Workbench, inkompatibel mit defncopy 209
reset, Befehl (isql) 12
Ressourcedatei-Modus, Migration 122
RSSD-Datenbank
Migration 132
Nach Migration wiederherstellen 135
Rückstrich (\)
Abschlusszeichen in interaktivem bcp 47
Escape-Zeichen für Sonderzeichen 152
Dienstprogramme 289

Index
S
Schließen einer Sitzung
dscp 86
dsedit 74
schnelle Version von bcp 23
Importieren von Daten 25
Wiederherstellbarkeit von Daten und 23
Schriftartkonventionen xv
Security Mechanism, Serverattribut (dscp) 88
select into, Befehl, Vergleich mit dem Massenexport/import
der Daten 69
select into/bulkcopy/pllsort, Datenbankoption
bcp und 25
Server
backupserver, Namen festlegen in 158
backupserver, starten in 161
Geschwindigkeitsmodi bei der Verwendung von bcp
21
migrieren 269
startserver, Dienstprogrammbefehl 266
startserver, starten in 266
sybmigrate, Dienstprogrammbefehl 269
Server anzeigen 247
Siehe auch showserver, Dienstprogrammbefehl 247
Server Entry Editor, Fenster 75
Server Name, Serverattribut (dscp) 87
Server Object Version, Serverattribut (dscp) 87
Server Service, Serverattribut (dscp) 87
Server Status, Serverattribut (dscp) 87
Serverattribute (dscp) 87
Serverdaten, Migrieren 96
Servereinträge
ändern mit dsedit 77, 80
hinzufügen mit dsedit 77
Inhalt mit dscp anzeigen 91
kopieren mit dsedit 79, 80, 82, 83
löschen mit dsedit 78
mit dscp auflisten 91
Servereinträge hinzufügen 80
umbenennen mit dsedit 78
Servernamen in backupserver festlegen 158
Serverspalte
Namen 54
Reihenfolge 53
Serververbindungen
backupserver, Anzahl von 158
Setup-Sitzung, für sybmigrate 103
showserver, Dienstprogrammbefehl 247
Beispiele 247
Definition 247
Sicherheit, Hinweise zu 152
Sichern, verglichen mit dem Massenexport/-import
der Daten 68
Sitzungen
auflisten (dscp) 86
Sitzungen für die Migration sperren 111
Sonderzeichen
bcp, Behandlung in 167
Dienstprogrammbefehle, Verwendung in 152
Sortierreihenfolgen
installieren und ändern (sqllocres) 254, 255
installieren und ändern, in GUI (sqlloc) 253, 254
sp_dboption system procedure and bcp 25
Spalten
Datentypgrößen und 44
mit fester oder mit variabler Länge 43
Null 66
Spaltentrennzeichen (isql) 11
Standardwerte und bcp 67
Spalten-Gesamtstellenzahl in nummerischen oder
dezimalen Speicherungsformaten 54
speichern
Fehler bei Exportvorgängen 67
Fehler bei Kopiervorgängen 65
Formatdateien (bcp) 50
Speicherplatzbedarf und bcp-Schritte 25
Speichertypen, in bcp verwendet 46
Sprachen
andere Sprachen, mit bcp 61
Angabe für die Migration 114
installieren und ändern (sqllocres) 254, 255
installieren und ändern, in GUI (sqlloc) 253, 254
Migration 106
neue installieren (langinstall) 236, 239
SPX/IPX-Adressen für Interface-Einträge 81
sql.ini, Datei
dsedit-Sitzungen, öffnen mit 73
Einträge ändern 77
Einträge hinzufügen 77
Einträge kopieren 79, 82, 83
Einträge löschen 78
Einträge umbenennen 78
290 Adaptive Server Enterprise

sqldbgr, Dienstprogramm 247
sqlloc, Dienstprogrammbefehl 253, 254
Berechtigungen, erforderliche 254
Definition 253
sqllocres, Dienstprogrammbefehl 254, 255
Berechtigungen, erforderliche 255
Definition 254
SQL-Parser-Dienstprogramm. Siehe isql,
Dienstprogrammbefehl 226
sqlsrvr, Dienstprogrammbefehl 255
Definition 255
sqlupgrade, Dienstprogrammbefehl 263
Berechtigungen, erforderliche 263
Definition 263
sqlupgraderes, Dienstprogrammbefehl 264
Berechtigungen, erforderliche 264
Definition 264
srvbuild, Dientsprogrammbefehl 264, 265
Berechtigungen, erforderliche 265
Definition 264
srvbuild, für sybmigrate 101
srvbuildres, Dienstprogrammbefehl 265, 266
Berechtigungen, erforderliche 266
Definition 265
Standardwerte
bcp-Datenkonvertierung 45
bcp-Eingabeaufforderungen 38, 48
Daten in Tabellen kopieren 67
Eingabeaufforderungen im
interaktiven bcp 38, 48
kopieren mit defncopy 209
select into/bulkcopy/pllsort-Optionseinstellungen
in neuen Datenbanken 25
Sprachen in backupserver 159
Zeichensätze in backupserver 160
Zeichensätze, in bcp 169
Starten
dscp-Dienstprogramm 85
dsedit, Dienstprogrammbefehl 71, 72
Server (startserver) 266
XP Server manuell (xpserver) 273, 275
startserver, Dienstprogrammbefehl 266
backupserver und 161
Beispiele 267
Definition 266
Runserver-Datei, Beispiele 268
Index
Statistik
aktualisierte laden (optdiag) 239
anzeigen (optdiag) 239
isql 14
SYBASE, Umgebungsvariable 102
SYBASE_ASE, Umgebungsvariable 102
SYBASE-Umgebungsvariable in dsedit 73
sybmigrate
Adaptive Server (Quelle) 95
Adaptive Server (Ziel) 95
Adaptive Server-Version 95
additional network memory, Parameter 105
Aufgaben für replizierte Datenbanken nach der
Migration 133
Aufgaben nach der Migration 130
ausführbare Datei 102
ausführen 110
Ausgabevorlage, Ressourcedatei 114
bcp 96
benutzerdefinierte Logdatei 113
Berechtigungen 101
Bereinigen von Fehlern nach der Migration 142
Berichte 112, 270
CIS bulk insert array size 109
CIS bulk insert array size, Konfiguration 104
CIS bulk insert batch size, Konfiguration 109
CIS packet size, Konfiguration 105, 108
Copy Threads 107
data limits filter mode für replizierte Daten 131
Datenbank erneut migrieren 142
ddlgen 96
Debug-Level 111
einzelne Objekte neu erstellen 143
erforderliche Komponenten 100
Fehlervermeidung 110
GUI-Modus 114
Hilfeinformationen 111
Index neu erstellen 130
Index Threads 108
Installation 100
interfaces-Datei 111
Java-Spalten 106
Komponentenverzeichnis 102
Konfiguration des alten Adaptive Server 108
Konfiguration und Optimierung 107
max packet size allowed, Konfiguration 105
Dienstprogramme 291

Index
max parallel degree, Konfiguration 108
Mehrbyte-Zeichensätze 107
mehrere Sitzungen 104
Migration der Datenbankdaten 97
Migration der Serverdaten 96
Migration einer primären Replikatdatenbank 132
Migration einer Replikatdatenbank 132
Migration einer RSSD-Datenbank 132
Migration mit hoher Verfügbarkeit 138
Migrationssitzung 120
Migrieren von Replication Server-Daten 130
number of sort buffers, Konfiguration 109
number of user connections, Konfiguration 108, 109
number of worker processes, Konfiguration 108
Objekte werden nicht migriert 140
Objekthierarchie 103
Plattformen 102
Primärdatenbanken wiederherstellen 133
Problembehebung und Fehlermeldungen 140
Replikatdatenbanken wiederherstellen 134
Ressourcedatei-Modus 122
RSSD-Datenbanken wiederherstellen 135
Setup-Sitzung 103, 114
Speicher für JVM 102
Sprache angeben 114
Sprachen 106
sybmigrate , Log 135
Syntax 111
Trace-Flags für die Befehlszeile 114
Überschreiben der Sperrsitzung 111
Umgebungsvariablen 102
Upgrade 100
Validierungssitzung 103, 122
Versionspfad 102
versionsübergreifende Migration 139
Versionszeichenfolge 111
Voraussetzungen 100
Vorbereitung der Migration 104
Zeichensatz angeben 114
Zeichensatzkonvertierung 106
zwei Datenbanken zusammenführen 142
sybmigrate ,max network packet size-
Konfiguration 109
sybmigrate, Dienstprogrammbefehl 269
Definition 269
sybmigrate, was nicht migriert wird 98
sybmigrate,max memory-Konfiguration 105
SYBMIGRATE_MEMORY, Umgebungsvariable
Migration 102
sybmultbuf, zum Starten von Backup Server 159
Symbole, Feldabschlusszeichen (bcp) 47
Syntax
für sybmigrate 111
Syntaxkonventionen xv
sysconfig.exe, für sybmigrate 101
System Data Format (SDF), Ausgabe in bcp 55
Systemprozedur (sp_dboption) 25
T
Tabellen
bcp-Eingabeaufforderungen in 40
bcp-Zeichensatz-Standardwerte 169
Dienstprogrammbefehle 153
erforderliche Berechtigung zum Hineinkopieren
von Daten 175
erforderliche Berechtigung zum Kopieren in
Betriebssystemdateien 175
erforderliche Berechtigungen zum Kopieren in
Betriebssystemdateien 20
erforderliche Berechtigungen zum Kopieren von
Daten in 20
Tabellendaten, kopieren 48
Tabellenzeilen
Kopieren in Anweisungsfolgen 62
Länge 31
Tabulare Ausgabe 54, 57
Tabulator-Feldabschlusszeichen (\\\) in
interaktivem bcp 47
TCP/IP-Adressen für Interface-Einträge 81
text, Datentyp
interaktiver bcp und 43
Trace Flags und backupserver 162
Trace-Flags, für sybmigrate 114
Transact-SQL
mit isql verwenden 10
Transport Address, Serverattribut (dscp) 88
Transport Type, Serverattribut (dscp) 87
Trigger
bcp, vor der Verwendung löschen 25
kopieren mit defncopy 209
Tabellen, Daten kopieren in 67
Verlangsamen von bcp 22
292 Adaptive Server Enterprise

U
Übersicht
dscp-Befehle 93
Übertragen von Daten aus Programmen mit bcp 19
Umbenennen von Servereinträgen mit dsedit 78
Umgebungsvariablen
DSLISTEN (backupserver) 161
LANG (backupserver) 159
LC_ALL (backupserver) 159
SYBASE_ASE 102
Versionspfad, für sybmigrate 102
Umleitung herein, Symbol (\isql) 16
Umleitung hinaus, Symbol (\gt) in isql 16
Upgrade, Adaptive Server 263
Siehe auch sqlupgrade,
Dienstprogrammbefehl 263
Upgrade, Adaptive Server mit
Ressourcendateien 264
Siehe auch sqlupgraderes,
Dienstprogrammbefehl 264
V
Validierungssitzung, für sybmigrate 103
Verborgener verschlüsselter Text 215
Version von Adaptive Server für sybmigrate 95
Versionspfad, für sybmigrate 102
Verzeichnisdienste
Einträge ändern 77
Einträge hinzufügen 77
Einträge kopieren 79, 82, 83
Einträge löschen 78
Einträge umbenennen 78
öffnen, mit dsedit 73
Vollständige Pfadnamen angeben
in Backup Server 159
Vollständige Pfadnamen in Backup Server
verwenden 159
Index
W
Warnungen
bcp in Daten-Wiederherstellung 166
bcp-Datenverlust 24
defncopy-Ausfall wegen langer Kommentare 214
X
XP Server, manuell starten 273, 275
Siehe auch xpserver, Dienstprogrammbefehl 273
xpserver, Dienstprogrammbefehl 273, 275
Berechtigungen, erforderliche 275
Definition 273
Z
Zeichenformate
Abschlusszeichen für 47
bcp 19
Standard in bcp 36, 37
Zeichensatz
Angabe für die Migration 114
Zeichensätze
backupserver, Standardwert in 160
bcp, Standardwerte in 169
installieren und ändern (sqllocres) 254, 255
installieren und ändern, in GUI (sqlloc) 253, 254
Konvertieren von Nichtzeichen-Daten 44
laden mit charset 185, 186
systemeigene Standardwerte 61
Zeilen in bcp, und fehlerhafte Tabellen 67
Zeilen, Tabelle
Länge 31
Massenexport/-import und Fehler 63
Zeilenabschlusszeichen
bcp in 38
interaktiver bcp in 47, 48
Zeilennummern, entfernen in isql 11
Zeilenschaltung, Datenfeldabschlusszeichen (\\r)
in interaktivem bcp 47
Zeilenummern, entfernen in isql 16
Zugriffsregeln auf Zeilenebene und bcp 62
Zurücksetzen von Prozessen 63
Dienstprogramme 293

Index
294 Adaptive Server Enterprise