XAA 3.1 SQL-Driverattributen |
De SQL-driver voor XAA 3.1 heeft vele instelmogelijkheden die kunnen worden verfijnd om de werking te verbeteren in scenario's met onbetrouwbare netwerkverbindingen met de XAA 3.1-server 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 XAA 3.1-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.
The connection string for XAA 3.1 can be found in the settings*.xml file used for the database. De referentiehandleidingen bevatten instructies voor het verplaatsen van de settings*.xml bestanden. Settings*.xml-bestanden bevinden zich meestal in de map </text><text styleclass="Code Example In Regel" translate="true">%USERPROFILE%\invantive</text><text styleclass="Normal" translate="true"> in de meeste implementatiescenario's. De referentiehandleidingen bevatten instructies voor het verplaatsen van de settings*.xml bestanden. Elke datacontainer van een database in de connection string kan een </text><text styleclass="Code Example In Regel" translate="true">connectionString</text><text styleclass="Normal" translate="true"> 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: </text><text styleclass="Code Example In Regel" translate="true">set NAME VALUE</text><text styleclass="Normal" translate="true">, of voor een gedistribueerde database: </text><text styleclass="Code Example In Regel" translate="true">set NAME@ALIAS VALUE</text><text styleclass="Normal" translate="true">. 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 XAA 3.1-driver kan worden geconfigureerd via de volgende attributen:
Code |
Omschrijving |
Herkomst |
Standaardwaarde |
Instellen vanuit Connection String |
Instellen vanuit Set SQL-Statement |
Instellen vanuit Driversbestand |
Instellen vanuit Aanmelden |
---|---|---|---|---|---|---|---|
analysis-enforce-row-uniqueness |
Use for analysis only! Enforce rows to be unique. |
Shared |
False |
✓ |
✓ |
✓ |
|
bulk-delete-page-size-rows |
Number of rows to delete per batch when bulk deleting |
Shared |
10000 |
✓ |
✓ |
✓ |
|
bulk-insert-page-size-bytes |
Approximate maximum size in bytes of batch when bulk inserting |
Shared |
10000000 |
✓ |
✓ |
✓ |
|
bulk-insert-page-size-rows |
Number of rows to insert per batch when bulk inserting |
Shared |
10000 |
✓ |
✓ |
✓ |
|
force-case-sensitive-identifiers |
Consider identifiers as case-sensitive independent of the platform capabilities. |
Shared |
False |
✓ |
✓ |
✓ |
|
forced-casing-identifiers |
Forced casing of identifiers. Choose from Unset, Lower, Upper and Mixed. |
Shared |
|
✓ |
✓ |
✓ |
|
invantive-sql-compress-sparse-arrays |
Whether to compress sparse arrays in result sets during compression. |
SQL Engine V1 |
True |
✓ |
✓ |
✓ |
|
invantive-sql-correct-invalid-date |
Whether to correct dates considered invalid since they are before 01-01-1753. When nullable, they are removed. Otherwise they are replaced by 01-01-1753. |
SQL Engine V1 |
False |
✓ |
✓ |
✓ |
|
invantive-sql-forward-filters-to-data-containers |
Whether to forward filters to data containers. |
SQL Engine V1 |
True |
✓ |
✓ |
✓ |
|
invantive-sql-share-byte-arrays |
Whether to share the memory used by identical byte arrays in result sets during compression. |
SQL Engine V1 |
True |
✓ |
✓ |
✓ |
|
invantive-sql-share-strings |
Whether to share the memory used by identical strings in result sets during compression. |
SQL Engine V1 |
True |
✓ |
✓ |
✓ |
|
invantive-sql-shuffle-fetch-results-data-containers |
Whether to shuffle results fetched from data containers. |
SQL Engine V1 |
False |
✓ |
✓ |
✓ |
|
invantive-use-cache |
Whether to cache the results of a query. |
SQL Engine V1 |
True |
✓ |
✓ |
✓ |
|
log-native-calls-to-disk-max-events |
Maximum number of events to register from last activation. |
Shared |
|
✓ |
✓ |
✓ |
|
log-native-calls-to-disk-max-seconds |
Maximum number of seconds to register from last activation. |
Shared |
|
✓ |
✓ |
✓ |
|
log-native-calls-to-disk-on-error |
Registers native calls to data container backend as disk files when an error occurred. |
Shared |
False |
✓ |
✓ |
✓ |
|
log-native-calls-to-disk-on-success |
Registers native calls to data container backend as disk files when successful. |
Shared |
False |
✓ |
✓ |
✓ |
|
log-native-calls-to-trace |
Log native calls to data container backend on the trace. |
Shared |
False |
✓ |
✓ |
✓ |
|
maximum-length-identifiers |
Non-default maximum length in characters of identifier names. |
Shared |
|
✓ |
✓ |
✓ |
|
max-url-length-accepted |
The maximum accepted URL length before raising an error. |
Shared |
8000 |
✓ |
✓ |
✓ |
|
max-url-length-desired |
The maximum desired URL length. |
Shared |
8000 |
✓ |
✓ |
✓ |
|
minimum-length-text |
Extend all text columns to this length to allow processing of XML that uses longer text values than the XSD specifies. |
XML |
|
✓ |
|
|
✓ |
partition-slot-based-rate-limit-length-ms |
Total length in ms across all slots of a partition-based rate limit. |
Shared |
60000 |
✓ |
|
✓ |
|
partition-slot-based-rate-limit-slots |
Number of slots per partition-based rate limit. Null means no slot-based rate limit |
Shared |
|
✓ |
|
✓ |
|
pre-request-delay-ms |
Pre-request delay in milliseconds per request. |
Shared |
0 |
✓ |
✓ |
✓ |
|
requested-page-size |
Preferred number of rows to exchange per round trip; only effective on limited platforms such as AFAS Online |
Shared |
|
✓ |
✓ |
✓ |
|
requests-parallel-max |
Maximum number of parallel data requests from individual partitions on the data container. |
Shared |
32 |
✓ |
✓ |
✓ |
|
result-set-memory-cache |
Action: provide 'empty' to empty. |
XML |
|
|
✓ |
|
|
slot-based-rate-limit-length-ms |
Total length in ms across all slots of a slot-based rate limit. |
Shared |
60000 |
✓ |
|
✓ |
|
slot-based-rate-limit-slots |
Number of slots of a slot-based rate limit. Null means no slot-based rate limit |
Shared |
|
✓ |
|
✓ |
|
standardize-identifiers |
Rewrite all identifiers to the preferred standards as configured by standardize-identifiers-casing and maximum-length-identifiers. |
Shared |
True |
✓ |
✓ |
✓ |
|
standardize-identifiers-casing |
Rewrite all identifiers to the recommended standard platform-specific casing when changing a data model on a case-dependent platform. |
Shared |
True |
✓ |
✓ |
✓ |
|
use-metadata-memory-cache |
Whether to use the metadata in memory calculated previously Has only practical use during development on a XML provider. |
XML |
True |
✓ |
✓ |
✓ |
|
use-result-memory-cache |
Whether to use result sets cached in memory from previous queries that can answer the current query. |
XML |
False |
✓ |
✓ |
✓ |
|
xml-directories |
Kommagescheiden lijst van mappen met XML-bestanden |
|
|
✓ |
✓ |
✓ |
✓ |
xml-extension |
Zoekpatroon voor XML-bestanden, inclusief ondersteuning voor * en ? |
|
*.xaa |
✓ |
✓ |
✓ |
✓ |
xml-namespaces |
Comma-separated list of namespace prefixes and their URI |
|
xaa=http://www.auditfiles.nl/XAA/3.1 |
✓ |
✓ |
✓ |
|
19-12-2022 16:36 Versie 22.1.113-BETA+3734