SQL

Tilgængelige servertyper

Med vores SQL-integration kan du vise alt, hvad der kan udtrykkes med SQL. Plecto understøtter følgende SQL-servertyper:

• MySQL

• PostgreSQL

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

• Oracle

• Snowflake

• BigQuery*

• AWS Athena*

• AWS Redshift*

*server-specifik konfigurationsproces

Tekniske detaljer

• Opdateringsfrekvens: Brugerdefineret (fra hver 1 minut til én gang om dagen)

• Understøtter brugerdefinerede felter? Ja

• Understøtter slettede registreringer? Nej

Opdateringsfrekvenser

Vores system vil automatisk øge SQL-opdateringsfrekvensen for en datakilde afhængigt af tiden brugt på at importere fra din server. Eksempler:

• Hvis opdateringsfrekvensen er indstillet til 1 minut, men importen tager mellem 30-120 sekunder, vil Plecto justere opdateringsfrekvensen til 5 minutter.

• Hvis opdateringsfrekvensen er indstillet til 1 eller 5 minutter, men importen tager mellem 120-180 sekunder, vil Plecto justere opdateringsfrekvensen til 15 minutter.

• Hvis opdateringsfrekvensen er indstillet til 1, 5 eller 15 minutter, men importen tager mellem 180-360 sekunder, vil Plecto justere opdateringsfrekvensen til 1 time.

Trin 1: Konfigurer din firewall

Før du forsøger at importere data fra din SQL-server, skal du sørge for at konfigurere din firewall til kun at tillade trafik fra følgende kilde:

• 51.159.130.44

Den 28.-29. juni 2025 foretog Plecto en migration til en europæisk hosting-udbyder, og derfor erstatter IP-adressen ovenfor de gamle Plecto IP-adresser. Adressen ovenfor erstatter de gamle IP-adresser, der bruges til trafik, så sørg for at opdatere din konfiguration, hvis du ikke allerede har gjort det.

Følgende Plecto IP-adresser udfases efter 28. juni 2025:

• 54.76.22.100

• 54.76.22.43

• 52.210.249.227

Trin 2: Forbind din SQL-server til Plecto

Vi anbefaler, at du opretter et nyt brugernavn og adgangskode, der specifikt er beregnet til at forbinde din database til Plecto. På denne måde undgår du at dele samme adgangskode på tværs af databaser. Det vil også give dig mulighed for at begrænse tilladdelser for den oprettede bruger til kun at have læseadgang.

1. Gå til Data sources > New data source og vælg din database.

   Hvis du vil konfigurere Amazon Athena/Redshift-databaser, skal du konsultere deres specifikke integrationsvejledninger.

2. Udfyld legitimationsoplysningerne. Hvis du har adgang til databasen, bør du være i stand til at indsamle dine legitimationsoplysninger.

   1. Bemærk til Hostname: Du skal give en offentlig IP. Hvis du tilføjer en lokal IP, virker forbindelsen ikke. Læs mere.

   2. Bemærk til Username når du forbinder med Azure: Hvis du bruger SQL-server på Azure, skal du tilføje username@[hostname] i brugernavnfeltet. Hvis hostname f.eks. er plecto.database.windows.net, skal du skrive username@plecto.database.windows.net i brugernavnfeltet.

   3. Hvis du vil bruge SSH Tunnel: SSH giver dig mulighed for at transportere data over en sikker og krypteret forbindelse. Kontakt din organisations tekniske personale, hvis du vil forbinde din database til Plecto ved hjælp af en SSH-tunnel, men ikke ved, hvordan.

      RSA private nøgle. Plecto bruger en RSA-privat nøgle (PEM-format) til at få adgang til din database. Du skal generere nøglen i det system, du bruger, og den skal formateres i Plecto som følger:

      -----BEGIN RSA PRIVATE KEY----- *indsæt nøgle her *-----END RSA PRIVATE KEY-----

3. Klik Continue og gå til Trin 3, hvor du skal skrive en SQL-sætning.

Trin 3: Skriv en SQL-sætning

Når du forbinder Plecto til databasen, skal du skrive en SELECT-sætning, hvor du inkluderer følgende standardfelter:

• member_id (krævet for at oprette brugeren, hvis ID ikke findes)

• member_name (krævet for at knytte data til medlemmer i Plecto)

• date (krævet dato, der er forbundet med denne registrering (altid i UTC!))

• reference (krævet unikt identifikator; kan bruges til at opdatere registreringer)

• team_name (valgfrit; vi vil upserte det i Plecto-datakilden)

Lagrede procedurer. Plecto kan også bruge lagrede procedurer i stedet for SELECT-sætninger. Disse bør bruges med en EXEC-sætning. Bemærk, at de lagrede procedurer stadig skal omfatte de standardfelter, der er nævnt ovenfor.

Hvordan du begrænser SQL-sætningen

Med hver import vil Plecto importere og opdatere alle data, inklusive rækkerne, der allerede er blevet importeret, men ikke har ændret sig siden sidste importkørsel. Vær derfor opmærksom på, hvor meget data du rent faktisk har brug for at importere – jo mere optimal din opsætning er, desto hurtigere kan Plecto behandle dine data.

For at fremskynde opdateringerne og have en lavere belastning på dine servere, begrænser du din sætning, så den kun returnerer de senest ændrede data. Du kan bruge variablen {{ last_update_time }} til at filtrere efter elementer, der ikke blev importeret siden sidste kørsel.

• Hvis du har et datofelt, kan du tilføje følgende funktion til sætningen, og variablen vil blive erstattet med den seneste dato og tidspunkt, når datakilden blev opdateret: date field >= {{ last_update_time }}

• Du kan også tilføje en øvre datogrammegrænse, der forhindrer Plecto i at importere data, der er nyere end den angivne grænse. Brug følgende funktion: date field <= {{ upper_date_limit }}

• Du kan også bruge en top 100 i SELECT-funktionen. Husk at bestille DESC (faldende) for at vælge de nyeste poster.

last_update_time og upper_date_limit

Når du skriver en SQL-sætning, kan du tilføje en startdato (last_update_time) og slutdato (upper_date_limit), der vil gøre, at din database kun importerer data inden for denne periode.

Du kan køre en test-forespørgsel for at se, hvor mange rækker der er inden for den angivne periode.

Medlem ID-kilde

Medlems ID-kilde fortæller Plecto, hvilket system der er datakøberen. Medlems ID-kilden skal være det samme systemnavn, du ser i Data suppliers-kolonnen under Settings > Employees. Både Medlem ID-kilde og Datakøbere henviser til det samme system.

Hvis begge steder har forskellige systemnavne, vil Plecto oprette nye medarbejdere med hver dataimport, hvilket kan resultere i duplikerede medarbeiderprofiler. Derfor anbefaler vi at bruge det samme medlems-ID-kildenavn som navnet på din datakøber.

SQL-dataimport

• Forespørgslen: Skriv en SQL-sætning, der returnerer et antal rækker, som hver svarer til en registrering i vores system. Hver række kan have et vilkårligt antal kolonner, der vil blive gemt på registreringen.

• Historiske data: Plecto kan importere historiske data én gang. Derefter holder vi dataene opdateret ved at importere hver [x] minut, men kun de rækker, der har ændret sig.

• Importlogs: Du kan se alle importlogs, både automatiske og manuelle, ved at klikke på knappen View logs i øverste højre hjørne i datakildindstillingerne.

• Nye data: Med hver import vil Plecto importere alle data. Hvis du kun vil se de nye/opdaterede data, kan du begrænse din SQL-sætning (se nedenfor). Ved at begrænse sætningen vil Plecto kun importere rækker, der har ændret sig, for eksempel inden for de seneste 5 minutter.

• Rådata: Plecto fungerer bedst, hvis du importerer rådata. Det betyder, at en række skal repræsentere ét element. Importér ikke allerede beregnede mål. Plecto kan beregne disse målinger fra rådata ved hjælp af formler.

Importgrænse for registreringer på SQL

Plecto begrænser antallet af registreringer, der kan importeres pr. forespørgsel baseret på opdateringsfrekvensen.

Manuel dataimport

Fra juli 2022 understøtter vores SQL-integrationer manuel dataimport.

1. Åbn datakildindstillingerne og klik Import historical data.

2. Vælg start- og slutdatoer og klik Start import.

Husk på, at hvis du vil importere meget historiske data, bør du dele dataimport i flere sessioner. Hvis du importerer meget gamle data på én gang, kan databasen ikke fuldføre importen.

Start- og slutdatoer vil blive inkluderet i sætningen. Når du vælger start- og slutdatoer for manuel dataimport, sendes de til last_update_time og upper_date_limit i din sætnings skabelon.