Inhaltsverzeichnis
mi_InsertTempdb_TextData
Prozedur, um „umfangreicherer Text-Daten“ in die Tabelle „tempdb.dbo.TextData“ einfügen zu lassen.
Hintergrund : Lange Zeit (bis zur Version 6.0.2) wurde der ASE in der Version 11 unterstützt, weshalb in Form von Parametern an Prozeduren nur Daten bis zu 255 Bytes übergeben werden konnten - später (ab unterstützter Version ASE 15.0.x) bis zu 16384 Bytes. Diverse Prozeduren wie z.B. fo_InsertPosting_Pu sind aber dazu konzipiert, wesentlich umfangreichere Text-Daten zu verarbeiten - um diese übergeben zu können, wurde die Tabelle „tempdbo.dbo.TextData“ bereitgestellt.
Anmerkung : Seit dStore-Version 7.0.1 wird nur noch der ASE 15.7 (oder höher) unterstützt, da es ab dieser ASE-Version möglich ist, auch Daten vom Typ „text“ („strings“ bis zu 2 GB) an Prozeduren via Parameter zu übergeben. Von daher werden wohl nach und nach Prozeduren wie fo_InsertPosting_Pu etc. einen zusätzlichen Parameter vom Typ „text“ erhalten, so daß auf lange Sicht diese Prozedur hier obsolet werden wird.
| HTTP-Method | POST |
| HTTP-Auth | Optional |
| Tags | |
| Engine-Kategorie | miscellaneous |
| Engine-Typ | Daten-Änderung |
| Letzte Aktualisierung | 7.0.7 (2015-01-29) |
Parameter
| Name 1) | Standard-Wert | Beschreibung 2) | SQL-Datentyp3) | ab Version |
|---|---|---|---|---|
| Data | Parameter für die eigentlichen Textdaten | text | 6.5.0 | |
| SortNo | 1 | Eindeutige Zahl, die als Referenz zur eindeutigen Identifizierung der Daten dient (siehe z.B. den gleichnamigen Parameter von im_ModifyValueDetails_Ad) | integer | 6.5.0 |
| Format | 'txt' | Hier kann man das Format der in „Data“ angegebenen Text-Daten beschreiben - wie z.B. „txt“, „csv“ oder „html“ (nur evtl. relevant für die Prozedur, der man diese Text-Daten übergeben muß) | varchar(50) | 6.5.0 |
| Delete | 1 | Gibt an, ob (evtl.) vorhandene Daten vorher gelöscht werden sollen („1“) oder nicht („0“). Es können immer nur Daten zur „spid“ („server process id“) hinterlegt werden, weswegen noch Daten von einem vorherigen Aufruf vorhanden sein könnten. | bit | 6.5.0 |
Rückgabe
Die Prozedur hat keine Rückgaben.
Output-Parameter
Die Prozedur hat keine Output-Parameter.
Mögliche Return-Codes
| Code | Beschreibung | Quelle 4) |
|---|---|---|
| -569 | Der Benutzer hat kein Ausführungsrecht für die Prozedur | nur indirekt |
| -567 | Die Prozedur darf z. Zt. nicht ausgeführt werden | nur indirekt |
| -566 | Die Prozedur darf mit den übergebenen Parametern nicht ausgeführt werden | nur indirekt |
| -535 | Das Datum liegt nicht in der Vergangenheit | nur indirekt |
| -530 | Der Wert ist nicht konvertierbar | nur indirekt |
| -510 | Der Benutzer ist nicht registriert | nur indirekt |
| -504 | Es ist ein Problem aufgetreten, das nicht gelöst werden kann, Prozedur wird daher abgebrochen | nur indirekt |
| -502 | Die Parameter-Werte der Prozedur können nicht verarbeitet werden (kein passendes Trennzeichen) | nur indirekt |
| -500 | Falsche Parameter | direkt und indirekt |
XML-Schema
Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.
Historie
| 7.0.7 | 2015-01-29 | „Start-/Finish-Procedure“-Logik eingebaut, s. Ticket #3670 |
| 7.0.1 | 2013-08-07 | Datentyp des Parameters „Data“ auf „text“ umgestellt |
| 6.5.0 | 2012-09-17 | Erstmalig in dieser Version erstellt |
Code-Snippets
Es handelt sich um eine Methode zum Füllen von Schnittstellentabelle wie in Hintergrundinformationen zu Engine-Prozeduren erläutert. Die Methode kann ausschließlich per engine/execute in einem gemeinsamen Batch mit komplementären Prozeduren verwendet werden.
engine/execute
XML zur Ausführung mit der Methode engine/execute, z.B. per
curl --header 'Content-Type: application/xml' -X POST 'http://<partner>-<kunde>.dstore.de/default/engine/execute' -d '<xml-daten>'
<?xml version="1.0" encoding="UTF-8"?> <ListOfBatches> <Batch No="0"> <Procedure Name="mi_InsertTempdb_TextData"> <Parameters/> </Procedure> </Batch> </ListOfBatches>