SQL

Tilgjengelige servertyper

Med vår SQL-integrasjon kan du vise alt som kan uttrykkes med SQL. Plecto støtter følgende SQL-servertyper:

• MySQL

• PostgreSQL

• Microsoft SQL Server 2005 eller senere (inkludert Azure SQL)

• Oracle

• Snowflake

• BigQuery*

• AWS Athena*

• AWS Redshift*

*server-spesifikk konfigurasjonsprosess

Tekniske detaljer

• Oppdateringsfrekvens: Tilpasset (fra hvert 1 minutt til en gang om dagen)

• Støtter tilpassede felt? Ja

• Støtter slettede registreringer? Nei

Oppdateringsfrekvenser

Systemet vårt vil automatisk øke SQL-oppdateringsfrekvensen til en datakilde, avhengig av tiden brukt på å importere fra serveren din. Eksempler:

• Hvis oppdateringsfrekvensen er satt til 1 minutt, men importen tar mellom 30 - 120 sekunder, vil Plecto justere oppdateringsfrekvensen til 5 minutter.

• Hvis oppdateringsfrekvensen er satt til 1 eller 5 minutter, men importen tar mellom 120 - 180 sekunder, vil Plecto justere oppdateringsfrekvensen til 15 minutter.

• Hvis oppdateringsfrekvensen er satt til 1, 5 eller 15 minutter, men importen tar mellom 180 - 360 sekunder, vil Plecto justere oppdateringsfrekvensen til 1 time.

Trinn 1: Konfigurer brannmuren din

Før du prøver å importere data fra SQL-serveren din, vennligst sørg for å konfigurere brannmuren din til kun å tillate trafikk fra følgende kilde:

• 51.159.130.44

Den 28.-29. juni 2025, utførte Plecto en migrasjon til en europeisk basert hosting-leverandør, og derfor erstatter IP-adressen som er oppført ovenfor de gamle Plecto IP-ene. Adressen ovenfor erstatter de gamle IP-ene som ble brukt for trafikk, så vennligst sørg for å oppdatere konfigurasjonen din hvis du ikke har gjort det ennå.

Følgende Plecto IP-adresser vil bli avviklet etter 28. juni 2025:

• 54.76.22.100

• 54.76.22.43

• 52.210.249.227

Trinn 2: Koble SQL-serveren din til Plecto

Vi anbefaler at du oppretter et nytt brukernavn og passord som er spesifikt ment for å koble databasen din til Plecto. På denne måten unngår du å dele det samme passordet mellom databaser. Det vil også tillate deg å begrense tillatelsen for den opprettede brukeren til kun å ha lesetilgang.

1. Gå til Datakilder > Ny datakilde og velg databasen din.

   Hvis du vil konfigurere Amazon Athena/Redshift-databaser, se deres spesifikke integrasjonsguider.

2. Fyll ut legitimasjonen. Hvis du har tilgang til databasen, bør du kunne samle inn legitimasjonen din.

   1. Merknad om Vertsnavn: Du må oppgi en offentlig IP. Hvis du legger til en lokal IP, vil ikke forbindelsen fungere. Lær mer.

   2. Merknad om Brukernavn når du kobler til med Azure: Hvis du bruker SQL-server på Azure, bør du legge til brukernavn@[vertsnavn] i brukernavnsfeltet. For eksempel, hvis vertsnavnet er plecto.database.windows.net, så bør du skrive brukernavn@plecto.database.windows.net i brukernavnsfeltet.

   3. Hvis du vil bruke SSH Tunnel: SSH lar deg transportere data over en sikker og kryptert forbindelse. Vennligst kontakt den tekniske personalet i organisasjonen din hvis du vil koble databasen din til Plecto ved hjelp av en SSH-tunnel, men ikke vet hvordan.

      RSA privatnøkkel. Plecto bruker en RSA privatnøkkel (PEM-format) for å få tilgang til databasen din. Du bør generere nøkkelen i systemet du bruker, og den bør formateres i Plecto som følger:

      -----BEGIN RSA PRIVATE KEY----- *lim inn nøkkel her *-----END RSA PRIVATE KEY-----

3. Klikk Fortsett og gå til Trinn 3 der du må skrive en SQL-setning.

Trinn 3: Skriv en SQL-setning

Når du kobler Plecto til databasen, må du skrive en SELECT-setning der du inkluderer følgende standardfelt:

• member_id (påkrevd for å opprette brukeren, hvis ID ikke finnes)

• member_name (påkrevd for å kartlegge data til medlemmer i Plecto)

• date (påkrevd dato knyttet til denne posten (alltid i UTC!))

• reference (påkrevd unik identifikator; kan brukes til å oppdatere registreringer)

• team_name (valgfritt; vi vil oppdatere det i Plecto-datakilden)

Lagrte prosedyrer. Plecto kan også bruke lagrede prosedyrer i stedet for SELECT-setninger. Disse bør brukes med en EXEC-setning. Vennligst merk at de lagrede prosedyrene fortsatt bør inkludere standardfeltene nevnt ovenfor.

Hvordan begrense SQL-setningen

Ved hver import vil Plecto importere og oppdatere alle data, inkludert radene som allerede er importert, men som ikke har endret seg siden forrige importkjøring. Derfor, vær oppmerksom på hvor mye data du faktisk trenger å importere – jo mer optimal oppsettet ditt er, jo raskere vil Plecto kunne behandle dataene dine.

For å fremskynde oppdateringene og ha en lavere belastning på serverne dine, vennligst begrens setningen din slik at den bare returnerer de nylig endrede dataene. Du kan bruke variabelen {{ last_update_time }} for å filtrere for elementer som ikke ble importert siden forrige kjøring.

• Hvis du har et datofelt, kan du legge til følgende funksjon i klausulen, og variabelen vil bli erstattet med den nyeste datoen og tiden når datakilden ble oppdatert: date field >= {{ last_update_time }} 

• Du kan også legge til en øvre datogrense som vil hindre Plecto fra å importere data nyere enn den angitte grensen. Bruk følgende funksjon: date field <= {{ upper_date_limit }}

• Du kan også bruke en topp 100 i SELECT-funksjonen. Husk å sortere DESC (synkende) for å velge de nyeste postene.

last_update_time og upper_date_limit

Når du skriver en SQL-setning, kan du legge til en startdato (last_update_time) og sluttdato (upper_date_limit) som vil gjøre databasen din bare importere data fra innenfor den perioden.

Du kan kjøre en testspørring for å se hvor mange rader det er i løpet av den angitte perioden.

Medlem ID Kilde

Medlem ID Kilde forteller Plecto hvilket system som er dataleverandøren. Medlem ID Kilde bør være det samme systemnavnet du ser i Dataleverandører kolonnen under Innstillinger > Ansatte. Både Medlem ID Kilde og Dataleverandører refererer til det samme systemet.

Hvis begge steder har forskjellige systemnavn, vil Plecto opprette nye ansatte sammen med hver datainport, noe som kan resultere i dupliserte ansattprofiler. Derfor anbefaler vi å bruke det samme navnet på Medlem ID Kilde som er navnet på dataleverandøren din.

SQL datainport

• Spørringen: Skriv en SQL-setning som returnerer et antall rader, hver tilsvarende en registrering i systemet vårt. Hver rad kan ha et hvilket som helst antall kolonner som vil bli lagret på registreringen.

• Historiske data: Plecto kan importere historiske data én gang. Deretter holder vi dataene oppdatert ved å importere hver [x] minutt, men bare radene som har endret seg.

• Importlogger: Du kan se alle importlogger, både automatiske og manuelle, ved å klikke på Vis logger-knappen i øverste høyre hjørne i datakildeinnstillingene.

• Nye data: Ved hver import vil Plecto importere alle data. Hvis du bare vil se de nye/oppdaterte dataene, kan du begrense SQL-setningen din (les nedenfor). Ved å begrense setningen vil Plecto bare importere rader som har endret seg, for eksempel, innen de siste 5 minuttene.

• Rådata: Plecto fungerer best hvis du importerer rådata. Det betyr at én rad bør representere ett element. Ikke importer allerede beregnede KPI-er. Plecto kan beregne disse KPI-ene fra rådataene ved hjelp av formler.

Registreringsimportgrense på SQL

Plecto begrenser antallet registreringer som kan importeres per spørring basert på oppdateringsfrekvensen.

Manuell datainport

Fra juli 2022 støtter våre SQL-integrasjoner manuell datainport.

1. Åpne datakildeinnstillingene og klikk Importer historiske data.

2. Velg start- og sluttdatoer og klikk Start import.

Husk at hvis du vil importere mye historiske data, bør du dele datainporten opp i flere økter. Hvis du importerer mye gammel data på en gang, kan databasen kanskje ikke fullføre importen.

Start- og sluttdatoer vil bli inkludert i setningen. Når du velger start- og sluttdatoer for manuell datainport, vil de bli sendt til last_update_time og upper_date_limit i malen for setningen din.