SQL

Tillgängliga servertyper

Med vår SQL-integration kan du visa allt som kan uttryckas med SQL. Plecto stöder följande SQL-servertyper:

• MySQL

• PostgreSQL

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

• Oracle

• Snowflake

• BigQuery*

• AWS Athena*

• AWS Redshift*

*server-specifik konfigurationsprocess

Tekniska detaljer

• Uppdateringsfrekvens: Anpassad (från varje 1 minut till en gång om dagen)

• Stöder anpassade fält? Ja

• Stöder raderade registreringar? Nej

Uppdateringsfrekvenser

Vårt system kommer automatiskt att öka SQL-uppdateringsfrekvensen för en datakälla, beroende på tid som spenderas på att importera från din server. Exempel:

• Om uppdateringsfrekvensen är inställd på 1 minut, men importen tar mellan 30 - 120 sekunder, kommer Plecto att justera uppdateringsfrekvensen till 5 minuter.

• Om uppdateringsfrekvensen är inställd på 1 eller 5 minuter, men importen tar mellan 120 - 180 sekunder, kommer Plecto att justera uppdateringsfrekvensen till 15 minuter.

• Om uppdateringsfrekvensen är inställd på 1, 5 eller 15 minuter, men importen tar mellan 180 - 360 sekunder, kommer Plecto att justera uppdateringsfrekvensen till 1 timme.

Steg 1: Konfigurera din brandvägg

Innan du försöker importera data från din SQL-server, se till att konfigurera din brandvägg för att endast tillåta trafik från följande källa:

• 51.159.130.44

Den 28-29 juni 2025 genomförde Plecto en migrering till en europeisk baserad värdtjänst, och därför ersätter den ovanstående IP-adressen de gamla Plecto-IP:erna. Adressen ovan ersätter de gamla IP:erna som användes för trafik, så se till att uppdatera din konfiguration om du inte har gjort det ännu.

Följande Plecto IP-adresser kommer att avvecklas efter den 28 juni 2025:

• 54.76.22.100

• 54.76.22.43

• 52.210.249.227

Steg 2: Anslut din SQL-server till Plecto

Vi rekommenderar att du skapar ett nytt användarnamn och lösenord som är specifikt avsett för att ansluta din databas till Plecto. På så sätt undviker du att dela samma lösenord mellan databaser. Det kommer också att göra det möjligt för dig att begränsa behörigheten för den skapade användaren till att endast ha läsbehörighet.

1. Gå till Datakällor > Ny datakälla och välj din databas.

   Om du vill konfigurera Amazon Athena/Redshift-databaser, konsultera deras specifika integrationsguider.

2. Fyll i autentiseringsuppgifterna. Om du har tillgång till databasen bör du kunna samla dina autentiseringsuppgifter.

   1. Notera om Värdnamn: Du måste ange en offentlig IP. Om du lägger till en lokal IP kommer anslutningen inte att fungera. Läs mer.

   2. Notera om Användarnamn när du ansluter med Azure: Om du använder SQL-server på Azure bör du lägga till användarnamn@[värdnamn] i användarnamnfältet. Till exempel, om värdnamnet är plecto.database.windows.net, bör du skriva användarnamn@plecto.database.windows.net i användarnamnfältet.

   3. Om du vill använda SSH-tunnel: SSH gör att du kan transportera data över en säker och krypterad anslutning. Vänligen kontakta din organisations tekniska personal om du vill ansluta din databas till Plecto med en SSH-tunnel men inte vet hur.

      RSA privat nyckel. Plecto använder en RSA privat nyckel (PEM-format) för att få åtkomst till din databas. Du bör generera nyckeln i det system du använder, och den bör formateras i Plecto enligt följande:

      -----BEGIN RSA PRIVATE KEY----- *klistra in nyckeln här *-----END RSA PRIVATE KEY-----

3. Klicka på Fortsätt och gå till Steg 3 där du måste skriva en SQL-sats.

Steg 3: Skriv en SQL-sats

När du ansluter Plecto till databasen behöver du skriva en SELECT-sats där du inkluderar följande standardfält:

• member_id (obligatoriskt för att skapa användaren, om ID inte hittas)

• member_name (obligatoriskt för att mappa data till medlemmar i Plecto)

• date (obligatoriskt datum kopplat till denna post (alltid i UTC!))

• reference (obligatorisk unik identifierare; kan användas för att uppdatera registreringar)

• team_name (valfritt; vi kommer att uppdatera det i Plecto-datakällan)

Lagrade procedurer. Plecto kan också använda lagrade procedurer istället för SELECT-satser. Dessa bör användas med ett EXEC-uttalande. Observera att de lagrade procedurerna fortfarande bör inkludera de standardfält som nämns ovan.

Hur man begränsar SQL-satsen

Vid varje import kommer Plecto att importera och uppdatera all data, inklusive rader som redan har importerats men som inte har ändrats sedan den senaste importen. Var därför medveten om hur mycket data du faktiskt behöver importera – ju mer optimalt din konfiguration är, desto snabbare kan Plecto bearbeta din data.

För att snabba upp uppdateringarna och ha en lägre belastning på dina servrar, vänligen begränsa din sats så att den endast returnerar den senaste ändrade datan. Du kan använda variabeln {{ last_update_time }} för att filtrera för objekt som inte har importerats sedan den senaste körningen.

• Om du har ett datumfält kan du lägga till följande funktion i klausulen, och variabeln kommer att ersättas med det senaste datumet och tiden när datakällan uppdaterades: date field >= {{ last_update_time }} 

• Du kan också lägga till en övre datumgräns som kommer att förhindra Plecto från att importera data nyare än den angivna gränsen. Använd följande funktion: date field <= {{ upper_date_limit }}

• Du kan också använda en top 100 i SELECT-funktionen. Kom ihåg att ordna DESC (fallande) för att välja de nyaste registren.

last_update_time och upper_date_limit

När du skriver en SQL-sats kan du lägga till ett startdatum (last_update_time) och ett slutdatum (upper_date_limit) som gör att din databas endast importerar data från den perioden.

Du kan köra en testfråga för att se hur många rader det finns under den angivna perioden.

Medlems-ID-källa

Medlems-ID-källa berättar för Plecto vilket system som är dataleverantören. Medlems-ID-källan bör vara samma systemnamn som du ser i kolumnen Dataleverantörer under Inställningar > Anställda. Både Medlems-ID-källa och Dataleverantörer hänvisar till samma system.

Om båda platserna har olika systemnamn kommer Plecto att skapa nya anställda med varje datainport, vilket kan resultera i dubblettprofiler för anställda. Därför rekommenderar vi att använda samma namn för Medlems-ID-källa som är namnet på din dataleverantör.

SQL-datainport

• Frågan: Skriv en SQL-sats som returnerar ett antal rader, där varje rad motsvarar en registrering i vårt system. Varje rad kan ha valfritt antal kolumner som kommer att sparas på registreringen.

• Historisk data: Plecto kan importera historisk data en gång. Sedan håller vi datan uppdaterad genom att importera varje [x] minut, men endast de rader som har ändrats.

• Importloggar: Du kan se alla importloggar, både automatiska och manuella, genom att klicka på knappen Visa loggar i det övre högra hörnet i datakällans inställningar.

• Ny data: Vid varje import kommer Plecto att importera all data. Om du endast vill se den nya/uppdaterade datan kan du begränsa din SQL-sats (läs nedan). Genom att begränsa satsen kommer Plecto endast att importera rader som har ändrats, till exempel inom de senaste 5 minuterna.

• Rådata: Plecto fungerar bäst om du importerar rådata. Det betyder att en rad bör representera ett objekt. Importera inte redan beräknade mått. Plecto kan beräkna dessa mått från den råa datan med hjälp av formler.

Registreringsimportgräns på SQL

Plecto begränsar antalet registreringar som kan importeras per fråga baserat på uppdateringsfrekvens.

Manuell datainport

Från och med juli 2022 stöder våra SQL-integrationer manuell datainport.

1. Öppna inställningarna för datakällan och klicka på Importera historisk data.

2. Välj start- och slutdatum och klicka på Starta import.

Tänk på att om du vill importera mycket historisk data bör du dela upp datainporten i flera sessioner. Om du importerar mycket gammal data på en gång kanske databasen inte kan slutföra importen.

Start- och slutdatum kommer att inkluderas i satsen. När du väljer start- och slutdatum för manuell datainport kommer de att skickas till last_update_time och upper_date_limit i din sasts mall.