Inhaltsverzeichnis
mi_InsertTempdb_TwoIDs
Dient dem Einfügen von Werten in die Tabelle „TwoIDs“ der Tabelle „tempdb“. (Wird z.B. für st_GetPersonPDStatistics_Ad benötigt.)
Anmerkung:
Grundsätzliche Vorgehensweise der mi_InsertTemp...-Prozeduren für Tabellen der Datenbank „tempdb“: In den „Listen-Parametern“ werden Werte (durch '¶' getrennt bzw. durch eine andere Zeichenkette, wenn ein entsprechender Parameter vorhanden ist) übergeben, aus denen die jeweilige Prozedur einen Datensatz bildet und in die zugehörige Tabelle einfügt. Der erste Datensatz wird aus den jeweils ersten Elementen der „Listen-Parameter“ zusammengesetzt, der zweite Datensatz aus den jeweils zweiten Elementen usw. Das bedeutet insbesondere, daß alle „Listen-Parameter“ die GLEICHE Anzahl Elemente enthalten müssen, sonst gibt es einen Fehler („-500“).
Hintergrund:
Für stored procedures gibt es leider keine „array“-Parameter. Als work-around werden sogenannte permanente, temporäre Tabellen (in der speziellen Datenbank „tempdb“) verwendet. Da mehrere Prozesse diese Tabellen gleichzeitig verwenden können, gibt es in jeder dieser Tabellen eine Spalte „spid“, damit jeder Prozeß seine (eindeutige) „Server-Process-ID“ („SELECT spid“) zusammen mit den gewünschten Daten speichern kann. So wird verhindert, daß Prozesse (versehentlich oder absichtlich) auf Daten anderer Prozesse zugreifen können.
| HTTP-Method | POST |
| HTTP-Auth | Optional |
| Tags | |
| Engine-Kategorie | miscellaneous |
| Engine-Typ | Daten-Änderung |
| Letzte Aktualisierung | 7.0.0 (2013-06-04) |
Parameter
| Name 1) | Standard-Wert | Beschreibung 2) | SQL-Datentyp3) | ab Version |
|---|---|---|---|---|
| IDList1 | Liste von IDs (durch '¶' getrennt) - die angegebenen Werte werden in der Spalte „ID1“ gespeichert | varchar(16384) | 3.5.0 | |
| IDList2 | Liste von IDs (durch '¶' getrennt) - die angegebenen Werte werden in der Spalte „ID2“ gespeichert | varchar(16384) | 3.5.0 | |
| Delete | 0 | „0“ : Keine Daten vorher löschen „1“ : Alle Datensätze zur „spid“ vorher löschen | bit | 3.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) |
|---|---|---|
| -500 | Falsche Parameter | nur direkt |
XML-Schema
Die Rückgabe erfolgt als XML-Dokument welches gegen das Schema Response/EngineProcedure_v1_0.xsd validiert.
Historie
| 7.0.0 | 2013-06-04 | Datentyp der „IDList…“-Parameter wurde jeweils erweitert [von „255“ auf „16384“] |
| 6.5.3 | 2013-03-18 | 1. Anpassungen an den aktuellen Quellcode-Standard 2. Etwas optimierte Abarbeitung |
| 4.0.14 | 2004-06-03 | Es gab bisher keinen Fehler [entgegen der Doku], wenn in „IDList2“ MEHR Elemente angegeben wurden, als im Parameter „IDList1“ ! |
| 4.0.9 | 2004-03-03 | Fehler : An einer Stelle wurde mitten in der Transaktion ein „return(-500)“ geworfen - ohne ein „rollback tran“ ! |
| 3.5.13 | 2001-12-06 | |
| 3.5.0 | 2000-11-23 | 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_TwoIDs"> <Parameters/> </Procedure> </Batch> </ListOfBatches>