Legg til egendefinerte omskrivningsregler for spørringer i Invantive UniversalSQL Server

Invantive UniversalSQL Server tilbyr sanntidstilkobling ved bruk av TDS-protokollen til Microsoft SQL Server til over 80 (sky)plattformer som Freshdesk, Freshservice, ActiveCampaign, Salesforce, Twinfield og andre.

Alle SQL-setninger utføres som Invantive UniversalSQL. Mange SQL Server-klientprogrammer vil kjøre uten noen endringer. SQL Server-programmer kan imidlertid også bruke SQL-setninger som ikke er kompatible med Invantive UniversalSQL. En innebygd preprosessor dekker mange bruksområder, men ikke alle.

Dette emnet forklarer hvordan du kan utvide preprosessoren til Invantive UniversalSQL Server med din egen logikk. Emnet er basert på de første stegene for å få Sumatra 2022 til å fungere mot en Invantive-database.

Legg til database

Etter installasjon av Sumatra 2022 startes webbehandleren, og en database legges til:

Spesifisering av nye påloggingsopplysninger feiler med itgensql005: Unsupported function 'HAS_PERMS_BY_NAME' found... som vist nedenfor:

SQL-setningen det gjelder, kan hentes fra Elastic, Invantive Trace eller monitoren. Ved hjelp av Monitor ble SQL-setningen raskt funnet:

til å være:

select name from sys.databases where HAS_PERMS_BY_NAME('[' + replace(name,']',']]') + ']', 'DATABASE', 'SELECT') = 1

I appsettings.json til Invantive UniversalSQL Server introduseres en seksjon for å utvide preprosessoren som følger:

  , "QueryRewriteRules":
    [ { "Code": "rle001"
      , "SortingOrder": "A001"
      , "RegexPattern": "select name from sys\\.databases where HAS_PERMS_BY_NAME\\('\\[' \\+ replace\\(name,'\\]','\\]\\]'\\) \\+ '\\]', 'DATABASE', 'SELECT'\\) = 1"
      , "Replacement": "select 'master'"
      , "NextCodeOnMatch": "EXIT"
      , "NextCodeOnNoMatch": null
      }
    , { "Code": "EXIT"
      , "SortingOrder": "EXIT"
      , "RegexPattern": "xyzxyzxyz"
      , "Replacement": "xyzxyzxyz"
      , "NextCodeOnMatch": null
      , "NextCodeOnNoMatch": null
      , "ExitSuccess": true
      }
    ]

Når SQL-setningen samsvarer med regelen rle001, skrives spørringen om til å returnere bare master ved hjelp av en Invantive UniversalSQL-setning. Deretter fortsetter utførelsen med omskrivingsregelen EXIT (som kunne vært utelatt i denne spesifikke situasjonen).

Etter omstart lykkes nå tilkoblingen med Sumatra, som antar at det kun finnes en master-database:

Neste utfordring

Når opprettelsen av databasen fortsetter videre, oppstår følgende feil:

som skyldes en spørring med en etterfølgende vognretur (carriage return):

select count(*) from INFORMATION_SCHEMA.TABLES where TABLE_NAME = 'ExactLicense' and TABLE_SCHEMA = 'dbo' union all select case when count(*) = 3 then 1 else 0 end from INFORMATION_SCHEMA.TABLES where TABLE_NAME in ('Uren', 'WeekStaat', 'weburen_config') and TABLE_SCHEMA = 'sumatra' union all select case when count(*) = 4 then 1 else 0 end from INFORMATION_SCHEMA.TABLES where TABLE_NAME in ('bedryf', 'gbkmut', 'requesttasks', 'GLMaps') and TABLE_SCHEMA = 'dbo'\n

og forventet resultat på et miljø som ikke er Exact Globe, er tre rader, hver med 0.

Sluttresultat

Etter flere iterasjoner er resultatet:

  , "QueryRewriteRules":
    [ { "Code": "rle001"
      , "SortingOrder": "A001"
      , "RegexPattern": "select name from sys\\.databases where HAS_PERMS_BY_NAME\\('\\[' \\+ replace\\(name,'\\]','\\]\\]'\\) \\+ '\\]', 'DATABASE', 'SELECT'\\) = 1"
      , "Replacement": "select 'master'"
      , "NextCodeOnMatch": "EXIT"
      , "NextCodeOnNoMatch": null
      }
    , { "Code": "rle002"
      , "SortingOrder": "A002"
      , "RegexPattern": "select count\\(\\*\\) from INFORMATION_SCHEMA\\.TABLES where TABLE_NAME = 'ExactLicense' and TABLE_SCHEMA = 'dbo' union all select case when count\\(\\*\\) = 3 then 1 else 0 end from INFORMATION_SCHEMA\\.TABLES where TABLE_NAME in \\('Uren', 'WeekStaat', 'weburen_config'\\) and TABLE_SCHEMA = 'sumatra' union all select case when count\\(\\*\\) = 4 then 1 else 0 end from INFORMATION_SCHEMA\\.TABLES where TABLE_NAME in \\('bedryf', 'gbkmut', 'requesttasks', 'GLMaps'\\) and TABLE_SCHEMA = 'dbo'\n"
      , "Replacement": "select 0 union all select 0 union all select 0"
      , "NextCodeOnMatch": "EXIT"
      , "NextCodeOnNoMatch": null
      }
    , { "Code": "rle003"
      , "SortingOrder": "A003"
      , "RegexPattern": "select count\\(\\*\\) from fn_my_permissions\\(null,'DATABASE'\\) where permission_name = 'SELECT'"
      , "Replacement": "select 1"
      , "NextCodeOnMatch": "EXIT"
      , "NextCodeOnNoMatch": null
      , "ExitError": false
      , "ExitErrorMessage": null
      }
    , { "Code": "EXIT"
      , "SortingOrder": "EXIT"
      , "RegexPattern": "xyzxyzxyz"
      , "Replacement": "xyzxyzxyz"
      , "NextCodeOnMatch": null
      , "NextCodeOnNoMatch": null
      , "ExitSuccess": true
      }
    ]

Fullstendig dokumentasjon for Invantive UniversalSQL Server er tilgjengelig på: