Grenzen und bekannte Einschränkungen (Referenz)

Was der OData-ODBC-Treiber nicht kann oder anders tut als der ODBC-Treiber von SQL Server, und warum. Jede Grenze nennt, wo die Abhilfe beschrieben ist.

• Nur OData v4 mit JSON. OData v2/v3 und Dienste ohne $metadata werden nicht unterstützt.
• Bitbreite: Eine 32-Bit-Anwendung lädt nur den x86-Treiber, eine 64-Bit-Anwendung nur den x64-Treiber. Das Installationspaket installiert beide; es setzt 64-Bit-Windows voraus.
• Transaktionen nur, wo der Dienst sie anbietet. Kündigt der Dienst in $metadata eine Adresse für Transaktionen an (Store.Transactions, so etwa der Datendienst Wkl.Data.Gateway), wirken BeginTrans, CommitTrans und Rollback in VBA/DAO und BeginTransaction in ADO.NET wie über den Treiber von SQL Server. Ohne diese Ankündigung meldet der Treiber keine Transaktionen: ADO.NET erhält bei BeginTransaction den Fehler HYC00, und Access behält BeginTrans dann für sich – ein Rollback nimmt auf dem Dienst nichts zurück. Bricht die Verbindung während CommitTrans ab, ist unbekannt, ob gespeichert wurde. Wie Sie das vor dem Einsatz prüfen und was bei Fehlern geschieht, steht unter Transaktionen.
• Auf einen ausgelasteten Dienst wartet der Treiber. Antwortet der Dienst beim Lesen mit 429 (zu viele Anfragen) oder 503 (vorübergehend nicht verfügbar), wartet der Treiber so lange, wie Retry-After sagt, und fragt erneut; ohne Angabe wartet er 1, 2, 4, 8 und 16 Sekunden. Eine einzelne Wartezeit über 60 Sekunden oder mehr als 120 Sekunden insgesamt wartet er nicht ab, sondern meldet HYT00 mit der Zeit des Dienstes. Den Dialog Verbinden öffnet ein ausgelasteter Dienst nicht. RETRY=OFF schaltet auch das Warten ab.
• Wiederholung nach einem Verbindungsabbruch ist eingeschaltet. Der Treiber wiederholt Lesen und Schreiben nach 1 und 3 Sekunden; beim Schreiben ist das nur sicher, wenn der Dienst Idempotency-Key einhält. Für einen Dienst, der das nicht tut, schalten Sie sie mit RETRY=OFF ab. Siehe Zusagen je Art des Dienstes.
• Der CommandBuilder von ADO.NET in der Vorgabe braucht die Durchreiche, oder eine andere Nebenläufigkeitsregel; siehe ADO.NET und Visual Studio.
• ADO.NET überträgt einen DateTime nur auf die Millisekunde; siehe ADO.NET und Visual Studio.
• Nur, was sich übersetzen lässt – oder durchgereicht wird. Eine Anweisung, die nicht in eine OData-Abfrage passt, wird abgewiesen, sofern die Verbindung keine Adresse für eigene Anweisungen nennt (siehe Wie der Treiber Anweisungen übersetzt). Der Treiber lädt in keinem Fall stillschweigend die ganze Entitätsmenge, um lokal zu filtern.
• Bearbeiten ohne Schlüssel nur, wenn der Dienst es anbietet. Eine Entitätsmenge ohne Schlüssel ist schreibgeschützt, es sei denn, $metadata deklariert für sie die Aktionen UpdateByOriginal und DeleteByOriginal. Dann nennt Access den Satz über seine alten Werte; gleiche Sätze bleiben unveränderbar.
• Ändern und Löschen brauchen eine Zeilenversion, die der Dienst deklariert. Deklariert er eine – eine gespeicherte Spalte oder einen berechneten Wert –, nimmt Access sie als einzige Zusatzbedingung, und der Treiber macht daraus If-Match; ein Schreibkonflikt erscheint dann in Access als solcher. Deklariert er keine, stellt Access die alten Werte aller Spalten in die Bedingung. Das lässt sich in OData nicht ausdrücken, und der Treiber weist es ab, statt die Prüfung stillschweigend fallen zu lassen: Sonst überschriebe die Änderung eine fremde Änderung, die Access für ausgeschlossen hält. Anlegen ist auch ohne Zeilenversion möglich. Abhilfe schafft der Dienst, nicht der Treiber: Er deklariert eine Zeilenversion oder einen berechneten Stempel.
• Eine übersetzte Anweisung liest genau eine Entitätsmenge; Verbünde und Unterabfragen laufen nur über die Durchreiche, siehe Unterstütztes SQL.
• LIKE nur in den Formen x%, %x, %x% und ohne _ als Platzhalter ([_] und ein Fluchtzeichen sind erlaubt); siehe Unterstütztes SQL.
• Der Cursor liest vorwärts, ohne Lesezeichen und ohne Sperren.
• Ein paar Zeichen bleiben im Namen kodiert (!, ", ., [, ], `, Steuerzeichen, Leerzeichen am Anfang); siehe Fehlerbehebung.
• Ein Name mit mehr als 64 Zeichen scheitert in Access, wie über den Treiber von SQL Server; siehe Fehlerbehebung.
• Access teilt Verbindungen nach DATABASE. Zwei Verknüpfungen mit gleichem DATABASE laufen über eine Verbindung, auch bei verschiedener URL – und lesen und schreiben dann still die Daten des ersten Dienststamms. Der Treiber erfährt davon nichts und kann es nicht verhindern; die Regel für die Einrichtung steht unter Mehrere Dienststämme in einer Datei. Ebenso teilen sich Verknüpfungen, die sich nur in ROLE= unterscheiden, eine Verbindung; dann gilt die Datenbank-Identität der ersten. Verschiedene Dienststämme und eine zweite Identität in derselben Sitzung brauchen deshalb verschiedene DATABASE-Werte; der Treiber ergänzt einen, wenn die Zeichenfolge keinen nennt. Siehe Verbindungszeichenfolge des Treibers.
• Der Dialog erscheint nur, wo die Anwendung ihn zulässt: mit einem Fenster und nicht mit SQL_DRIVER_NOPROMPT. Ohne Fenster scheitert eine unvollständige Verbindung mit der Abweisung des Dienstes. Öffnet Access eine Verknüpfung ohne gespeichertes Kennwort, meldet sich der Treiber mit dem zuletzt benutzten Namen an, dessen Kennwort mit „Kennwort speichern“ abgelegt ist; sonst fragt er mit einem kurzen Anmeldeformular. Nach „Abbrechen“ fragt er für denselben Dienst fünf Sekunden lang nicht erneut.
• Access zeigt beim gescheiterten Verbindungsaufbau nur DAO 3151; siehe Fehlerbehebung.
• Eine durchgereichte Anweisung beschreibt der Dienst vor dem Ausführen. Fragt eine Anwendung zwischen SQLPrepare und SQLExecute nach den Spalten, holt der Treiber die Beschreibung beim Dienst, ohne die Anweisung auszuführen. Das geschieht nur, wenn der Dienst die Adresse für eigene Anweisungen selbst nennt (Store.PassThrough); mit einer Adresse aus PASSTHROUGH und bei einer Anweisung, die SQL Server nicht ohne Ausführen beschreiben kann (temporäre Tabellen), meldet der Treiber bis zum Ausführen null Spalten.
• Nur die erste Ergebnismenge kommt Zeile für Zeile. Jede weitere Menge einer durchgereichten Anweisung trifft mit dem Ende der ersten ein und liegt im Speicher, bis die Anwendung sie mit SQLMoreResults erreicht. Eine große Menge gehört deshalb an die erste Stelle der Prozedur.
• DAO GetRows hängt bei einem Fehler beim Weiterlesen – mit jedem Treiber; siehe Fehlerbehebung.
• Eine durchgereichte Anweisung wird ganz gelesen. Es gibt keine Folgeseiten: Die Menge bestimmt die Anweisung selbst, und der Dienst begrenzt sie über seine Zeilenobergrenze. Greift diese Grenze, liefert der Treiber die gelieferten Zeilen und meldet danach HY000 „Der Dienst hat das Ergebnis nach N Zeilen gekürzt …“; Access zeigt das als „ODBC-Aufruf fehlgeschlagen“. Siehe Antworten einordnen.
• Nur abbildbare Teile des OData-Modells erscheinen. Komplexe Werte, Sammlungen, Beziehungen, Singletons, Funktionen und vererbte Eigenschaften fehlen im Katalog; siehe Wie aus einem OData-Dienst ein relationales ODBC-Modell wird.
• Ein gebundener Binärwert reist als Text. Auf dem Durchreichepfad wird er base64-kodiert übergeben; eine Anweisung, die einen Binärwert vergleichen muss, sollte ihn selbst hinschreiben.

• Ablaufverfolgung: Zur Fehlersuche dienen die Ablaufverfolgung des Treibers und die des Treibermanagers; siehe Die Ablaufverfolgung einschalten. Die Spur hält ihre Datei offen, solange der Prozess läuft, und schreibt jede Zeile sofort.
• Ein Aufruf blockiert den Thread der Anwendung wie bei einem nativen Treiber, bis die Antwort da ist, und verarbeitet währenddessen keine Fensternachrichten. Ereignisse der Anwendung, etwa „Beim Anzeigen“ eines Datenblatts in Access, laufen deshalb nie mitten in einem Treiberaufruf.
• Zertifikate: Über https prüft der Treiber das Zertifikat gegen die Zertifikatsspeicher von Windows, ohne Schalter zum Abschalten; ein nicht vertrautes Zertifikat ergibt 08S01 und wird nicht wiederholt. Siehe 08S01 „UntrustedRoot“.

• Schemaänderungen: Der Treiber lädt $metadata einmal je Verbindung und hält es, bis die Verbindung geschlossen wird. Ändert sich das Schema des Dienstes, solange eine Anwendung verbunden ist:

  Änderung	Folge bis zum Neuaufbau
  Spalte oder Tabelle hinzugefügt	nicht sichtbar
  Spalte entfernt oder umbenannt	eine Anfrage, die sie nennt, lehnt der Dienst ab; die Anwendung erhält die Meldung des Dienstes
  Recht entzogen	der Dienst lehnt ab (403), auch wenn die Tabelle noch angezeigt wird

  Neu aufbauen heißt in Access: Access schließen und neu öffnen, danach im Tabellenverknüpfungs-Manager die betroffenen Verknüpfungen aktualisieren; erst dann übernimmt Access neue Spalten und Typen in die Verknüpfung.

Wer eine Anwendung vom ODBC-Treiber von SQL Server (ODBC Driver 18) auf diesen Treiber umstellt, erhält über die Durchreiche dieselben Werte, wo beide Treiber ein Ergebnis liefern. In folgenden Punkten verhält sich dieser Treiber anders, in der x86- wie in der x64-Version:

• Unterstütztes SQL
• Verbindungszeichenfolge des Treibers
• Wie der Treiber Anweisungen übersetzt