Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Er wordt een diagnostisch bericht geretourneerd met elke SQLSTATE. Dezelfde SQLSTATE wordt vaak geretourneerd met een aantal verschillende berichten. SQLSTATE 42000 (syntaxisfout of toegangsfout) wordt bijvoorbeeld geretourneerd voor de meeste fouten in de SQL-syntaxis. Elke syntaxisfout wordt echter waarschijnlijk beschreven door een ander bericht.
Voorbeelddiagnoseberichten worden weergegeven in de kolom Fout in de tabel met SQLSTATEs in bijlage A en in elke functie. Hoewel stuurprogramma's deze berichten kunnen retourneren, is het waarschijnlijker dat ze elk bericht retourneren dat aan hen wordt doorgegeven door de gegevensbron.
Toepassingen geven doorgaans diagnostische berichten weer voor de gebruiker, samen met de SQLSTATE en systeemeigen foutcode. Dit helpt het gebruikers- en ondersteuningspersoneel de oorzaak van eventuele problemen te bepalen. De onderdeelinformatie die in het bericht is ingesloten, is met name handig om dit te doen.
Diagnostische berichten zijn afkomstig van gegevensbronnen en onderdelen in een ODBC-verbinding, zoals stuurprogramma's, gateways en Driver Manager. Gegevensbronnen bieden doorgaans geen rechtstreekse ondersteuning voor ODBC. Als een onderdeel in een ODBC-verbinding daarom een bericht van een gegevensbron ontvangt, moet deze de gegevensbron identificeren als de bron van het bericht. Het moet zich ook identificeren als het onderdeel dat het bericht heeft ontvangen.
Als de bron van een fout of waarschuwing een onderdeel zelf is, moet dit worden uitgelegd in het diagnostische bericht. Daarom heeft de tekst van berichten twee verschillende indelingen. Voor fouten en waarschuwingen die niet voorkomen in een gegevensbron, moet het diagnostische bericht deze indeling gebruiken:
[vendor-identifier][ODBC-component-identifier]component-supplied-text
Voor fouten en waarschuwingen die optreden in een gegevensbron, moet het diagnostische bericht deze indeling gebruiken:
[vendor-identifier][ODBC-component-identifier][data-source-identifier]data-source-supplied-text
In de volgende tabel ziet u de betekenis van elk element.
| Onderdeel | Meaning |
|---|---|
| leverancier-identificatie | Identificeert de leverancier van het onderdeel waarin de fout of waarschuwing is opgetreden of die de fout of waarschuwing rechtstreeks van de gegevensbron heeft ontvangen. |
| ODBC-component-identifier | Identificeert het onderdeel waarin de fout of waarschuwing is opgetreden of die de fout of waarschuwing rechtstreeks van de gegevensbron heeft ontvangen. |
| gegevensbron-id | Identificeert de gegevensbron. Voor stuurprogramma's op basis van bestanden is dit meestal een bestandsindeling, zoals Xbase[1] Voor DBMS-stuurprogramma's, dit is het DBMS-product. |
| door het onderdeel geleverde tekst | Gegenereerd door het ODBC-onderdeel. |
| door de gegevensbron geleverde tekst | Gegenereerd door de gegevensbron. |
[1] In dit geval fungeert het stuurprogramma als zowel het stuurprogramma als de gegevensbron.
Vierkante haken ([ ]) moeten worden opgenomen in het bericht en geven geen optionele items aan.