NMBRS API Data Model
NMBRS SQL-Driverattributen |
Het SQL-stuurprogramma voor NMBRS heeft veel kenmerken die kunnen worden verfijnd om de verwerking te verbeteren in scenario's met onbetrouwbare netwerkverbindingen naar de API-server van NMBRS of met grote hoeveelheden gegevens. Ook hebben veel drivers driver-specifieke attributen om het feitelijke gedrag te finetunen of data te verwerken die niet aan de specificaties voldoen.
Aan de NMBRS-driverattributen wordt een standaardwaarde toegekend die zelden behoeft te worden gewijzigd. Indien nodig kunnen echter wijzigingen worden aangebracht op vier niveau's die in de onderstaande tabel met afzonderlijke vinkjes zijn aangegeven:
•Connection string: de connection string uit het settings*.xml bestand en toegepast tijdens het aanmelden.
•Set SQL-statement: een set SQL-statement dat moet worden uitgevoerd nadat de verbinding tot stand is gebracht.
•Aanmelden: waarde die door de gebruiker interactief moet worden opgegeven tijdens het aanmelden in een gebruikersinterface.
De verbindingsstring voor NMBRS is te vinden in het settings*.xml bestand dat voor de database wordt gebruikt. De referentiehandleidingen bevatten instructies voor het verplaatsen van de settings*.xml bestanden. Settings*.xml-bestanden bevinden zich meestal in de map %USERPROFILE%\invantive in de meeste implementatiescenario's. Elke datacontainer van een database in de connection string kan een connectionString element hebben waarin de naam en de waarden van attributen worden gespecificeerd. Zowel naam als waarde moeten naar behoren worden geëscaped volgens de XML-semantiek. De feitelijke toepassing van de waarde gebeurt uitsluitend tijdens het aanmelden. Er moet een nieuwe verbinding tot stand worden gebracht om de waarde van het driverattribuut te wijzigen met behulp van een connection string.
Het set SQL-statement kan na aanmelding worden uitgevoerd. De syntaxis is: set NAME VALUE, of voor een gedistribueerde database: set NAME@ALIAS VALUE. In sommige scenario's moet u de naam van de driverattribuut tussen vierkante haken zetten om te voorkomen dat de naam wordt ontleed, bijvoorbeeld wanneer een gereserveerd SQL-trefwoord deel uitmaakt van de naam. De nieuwe waarde wordt direct na uitvoering van de set-statement van kracht. Het set-statement kan tijdens een sessie zo vaak worden uitgevoerd als nodig is.
Driverattributen die interactief op een waarde kunnen worden ingesteld worden meestal weergegeven in het aanmeldvenster. Afhankelijk van het platform en de ontwerpbeslissingen van de ontwerper van de gebruikersinterface kunnen sommige of alle beschikbare driverattributen beschikbaar worden gesteld.
De NMBRS-driver kan worden geconfigureerd via de volgende attributen:
Code |
Beschrijving |
Oorsprong |
Standaardwaarde |
Set van Verbindingsstring |
Set van Set SQL-Statement |
Instellen vanuit bestuurdersbestand |
Instellen vanaf aanmelden |
|---|---|---|---|---|---|---|---|
analysis-enforce-row-uniqueness |
Zorg ervoor dat rijen uniek zijn voor software-analyse. |
Shared |
False |
✓ |
✓ |
✓ |
|
api-url |
URL van de webdienst. |
NMBRS |
|
✓ |
|
✓ |
|
bulk-delete-page-size-rows |
Aantal te verwijderen rijen per batch bij bulk verwijderen. |
Shared |
10000 |
✓ |
✓ |
✓ |
|
bulk-insert-page-size-bytes |
Geschatte maximale grootte in bytes van de batch bij het invoegen in bulk. |
Shared |
10000000 |
✓ |
✓ |
✓ |
|
bulk-insert-page-size-rows |
Aantal in te voegen rijen per batch bij bulkinvoer. |
Shared |
10000 |
✓ |
✓ |
✓ |
|
force-case-sensitive-identifiers |
Beschouw identifiers als hoofdlettergevoelig, onafhankelijk van de mogelijkheden van het platform. |
Shared |
False |
✓ |
✓ |
✓ |
|
forced-casing-identifiers |
Forced casing van identifiers. Keuze uit: Unset, Lower, Upper en Mixed. |
Shared |
|
✓ |
✓ |
✓ |
|
http-disk-cache-compression-level |
Compressieniveau voor de HTTP-schijfcache, variërend van 1 (weinig) tot 9 (intensief). Standaard is 5. |
Shared |
5 |
✓ |
✓ |
✓ |
|
http-disk-cache-directory |
Directory waar de HTTP-cache is opgeslagen. |
Shared |
C:\Users\gle3.WS212\Invantive\Cache\http\gle3\shared |
✓ |
✓ |
✓ |
|
http-disk-cache-ignore-write-errors |
Of schrijffouten naar de schijfcache moeten worden genegeerd. |
Shared |
False |
✓ |
✓ |
✓ |
|
http-disk-cache-max-age-sec |
Maximaal aanvaardbare leeftijd in seconden voor het gebruik van gegevens in de HTTP-schijfcache. |
Shared |
2592000 |
✓ |
✓ |
✓ |
|
http-get-timeout-max-ms |
HTTP GET timeout maximum on retry (ms) |
|
24000 |
✓ |
✓ |
✓ |
|
http-get-timeout-ms |
HTTP GET timeout (ms) |
|
56000 |
✓ |
✓ |
✓ |
|
http-memory-cache-compression-level |
Compressieniveau voor de HTTP geheugencache, variërend van 1 (weinig) tot 9 (intensief). Standaard is 5. |
|
5 |
✓ |
✓ |
✓ |
|
http-memory-cache-max-age-sec |
Maximaal aanvaardbare leeftijd in seconden voor het gebruik van gegevens in de HTTP-geheugencache. |
|
14400 |
✓ |
✓ |
✓ |
|
http-post-timeout-max-ms |
HTTP POST timeout maximum on retry (ms) |
|
58000 |
✓ |
✓ |
✓ |
|
http-post-timeout-ms |
HTTP POST timeout (ms) |
|
57000 |
✓ |
✓ |
✓ |
|
invantive-sql-compress-sparse-arrays |
Of de sparse arrays in resultatensets moeten worden gecomprimeerd tijdens de compressie. |
SQL Engine V1 |
True |
✓ |
✓ |
✓ |
|
invantive-sql-correct-invalid-date |
Of ongeldig geachte data moeten worden gecorrigeerd omdat ze vóór 01-01-1753 liggen. Als ze nul zijn, worden ze verwijderd. Anders worden ze vervangen door 01-01-1753. |
SQL Engine V1 |
False |
✓ |
✓ |
✓ |
|
invantive-sql-forward-filters-to-data-containers |
Of filters moeten worden doorgestuurd naar gegevenscontainers. |
SQL Engine V1 |
True |
✓ |
✓ |
✓ |
|
invantive-sql-share-byte-arrays |
Of het geheugen dat wordt gebruikt door identieke byte-arrays in resultatensets tijdens compressie moet worden gedeeld. |
SQL Engine V1 |
True |
✓ |
✓ |
✓ |
|
invantive-sql-share-strings |
Of het geheugen dat wordt gebruikt door identieke strings in resultatensets tijdens compressie moet worden gedeeld. |
SQL Engine V1 |
True |
✓ |
✓ |
✓ |
|
invantive-sql-shuffle-fetch-results-data-containers |
Of resultaten uit gegevenscontainers moeten worden geschud. |
SQL Engine V1 |
False |
✓ |
✓ |
✓ |
|
invantive-use-cache |
Of de resultaten van een query in de cache moeten worden opgeslagen. |
SQL Engine V1 |
True |
✓ |
✓ |
✓ |
|
log-native-calls-to-disk-max-events |
Maximum aantal te registreren oproepgebeurtenissen vanaf de laatste activering. |
Shared |
|
✓ |
✓ |
✓ |
|
log-native-calls-to-disk-max-seconds |
Maximum aantal seconden om oproepen te registreren vanaf de laatste activering. |
Shared |
|
✓ |
✓ |
✓ |
|
log-native-calls-to-disk-on-error |
Registreert native calls naar data container backend als disk files wanneer de call een fout heeft opgeleverd. |
Shared |
False |
✓ |
✓ |
✓ |
|
log-native-calls-to-disk-on-success |
Registreert native calls naar data container backend als disk files wanneer de call geen error opleverde. |
Shared |
False |
✓ |
✓ |
✓ |
|
log-native-calls-to-trace |
Log native calls naar data container backend op de trace. |
Shared |
False |
✓ |
✓ |
✓ |
|
maximum-length-identifiers |
Niet-standaard maximale lengte in tekens van identificatienamen. |
Shared |
|
✓ |
✓ |
✓ |
|
max-url-length-accepted |
De maximaal aanvaarde URL-lengte voordat er een fout optreedt. |
Shared |
8000 |
✓ |
✓ |
✓ |
|
max-url-length-desired |
De maximale gewenste URL-lengte. |
Shared |
8000 |
✓ |
✓ |
✓ |
|
minimum-length-text |
Breid alle tekstkolommen uit tot deze lengte om de verwerking van XML mogelijk te maken die langere tekstwaarden gebruikt dan de XSD specificeert. |
XML |
|
✓ |
|
|
✓ |
partition-slot-based-rate-limit-length-ms |
Totale lengte in milliseconden over alle slots van een partitiegebaseerde snelheidslimiet. |
Shared |
60000 |
✓ |
|
✓ |
|
partition-slot-based-rate-limit-slots |
Aantal slots per partitiegebaseerde snelheidslimiet. Nul betekent geen slotgebaseerde snelheidslimiet. |
Shared |
|
✓ |
|
✓ |
|
pre-request-delay-ms |
Vertraging voorafgaand aan het verzoek in milliseconden per verzoek. |
Shared |
0 |
✓ |
✓ |
✓ |
|
requested-page-size |
Voorkeur aantal rijen om te wisselen per rondreis; alleen effectief op beperkte platforms zoals AFAS Online. |
Shared |
|
✓ |
✓ |
✓ |
|
requests-parallel-max |
Maximumaantal parallelle gegevensaanvragen van afzonderlijke partities op de gegevenscontainer. |
Shared |
32 |
✓ |
✓ |
✓ |
|
result-set-memory-cache |
Actie: ingesteld op "leeg" om leeg te maken. |
XML |
|
|
✓ |
|
|
revert-to-v1 |
Of teruggekeerd moet worden naar het V1 NMBRS-stuurprogramma. Gebruikt V2 indien false. |
NMBRS |
False |
✓ |
|
✓ |
|
slot-based-rate-limit-length-ms |
Totale lengte in milliseconden over alle slots van een slot-based snelheidslimiet. |
Shared |
60000 |
✓ |
|
✓ |
|
slot-based-rate-limit-slots |
Aantal slots van een slot-based rate limit. Nul betekent geen slot-based rate limit. |
Shared |
|
✓ |
|
✓ |
|
standardize-identifiers |
Herschrijf alle identifiers naar de voorkeurstandaarden zoals geconfigureerd door standardize-identifiers-casing en maximum-length-identifiers. |
Shared |
True |
✓ |
✓ |
✓ |
|
standardize-identifiers-casing |
Herschrijf alle identifiers naar de aanbevolen standaard platform-specifieke casing wanneer een datamodel op een case-afhankelijk platform wordt gewijzigd. |
Shared |
True |
✓ |
✓ |
✓ |
|
use-http-disk-cache-read |
Of HTTP-reacties van eerdere query's die op schijf zijn opgeslagen, moeten worden gebruikt om de huidige query te beantwoorden. |
Shared |
False |
✓ |
✓ |
✓ |
|
use-http-disk-cache-write |
Of HTTP-reacties op schijf moeten worden opgeslagen. |
Shared |
False |
✓ |
✓ |
✓ |
|
use-http-memory-cache-read |
Of HTTP-reacties van eerdere in het geheugen opgeslagen query's die de huidige query kunnen beantwoorden, moeten worden gebruikt. |
|
True |
✓ |
✓ |
✓ |
|
use-http-memory-cache-write |
Of HTTP antwoorden van vorige queries moeten worden onthouden voor gebruik door toekomstige queries. |
|
True |
✓ |
✓ |
✓ |
|
use-metadata-memory-cache |
Of de eerder berekende metadata in het geheugen moeten worden gebruikt. |
XML |
True |
✓ |
✓ |
✓ |
|
use-result-memory-cache |
Of de in het geheugen opgeslagen resultaten van eerdere zoekopdrachten die de huidige zoekopdracht kunnen beantwoorden, moeten worden gebruikt. |
XML |
False |
✓ |
✓ |
✓ |
|
22-12-2022 20:57 Versie 22.1.101-BETA+3681
