Del via


Hent data fra Amazon S3

I denne artikkelen lærer du hvordan du henter data fra Amazon S3 til enten en ny eller eksisterende tabell. Amazon S3 er en objektlagringstjeneste bygget for å lagre og hente data.

Hvis du vil ha mer informasjon om Amazon S3, kan du se Hva er Amazon S3?.

Forutsetninger

Kilde

  1. Velg Hent datapå det nedre båndet i KQL-databasen.

    I vinduet Hent data er fanen Kilde valgt.

  2. Velg datakilden fra den tilgjengelige listen. I dette eksemplet inntar du data fra Amazon S3.

    Skjermbilde av hent datavinduet med kildefanen valgt.

Konfigurere

  1. Velg en måltabell. Hvis du vil innta data i en ny tabell, velger du +Ny tabell og skriver inn et tabellnavn.

    Notat

    Tabellnavn kan være opptil 1024 tegn, inkludert mellomrom, alfanumeriske tegn, bindestreker og understrekingstegn. Spesialtegn støttes ikke.

  2. Lim inn tilkoblingsstrengen for én enkelt samling i URI--feltet, eller et enkeltobjekt i følgende format.

    Samling: https://BucketName.s3.RegionName.amazonaws.com;AwsCredentials=AwsAccessID,AwsSecretKey

    Du kan også bruke samlingsfiltre for å filtrere data i henhold til en bestemt filtype.

    Skjermbilde av konfigurer fanen med den nye tabellen angitt og en Amazon S3-tilkoblingsstreng limt inn.

  3. Velg Neste.

Inspisere

Fanen Undersøk åpnes med en forhåndsvisning av dataene.

Hvis du vil fullføre inntaksprosessen, velger du Fullfør.

Skjermbilde av undersøk-fanen.

Eventuelt:

Rediger kolonner

Notat

  • For tabellformater (CSV, TSV, PSV) kan du ikke tilordne en kolonne to ganger. Hvis du vil tilordne til en eksisterende kolonne, må du først slette den nye kolonnen.
  • Du kan ikke endre en eksisterende kolonnetype. Hvis du prøver å tilordne til en kolonne med et annet format, kan du ende opp med tomme kolonner.

Endringene du kan gjøre i en tabell, avhenger av følgende parametere:

  • tabelltype er ny eller eksisterende
  • Tilordning type er ny eller eksisterende
Tabelltype Tilordningstype Tilgjengelige justeringer
Ny tabell Ny tilordning Gi nytt navn til kolonne, endre datatype, endre datakilde, tilordningstransformasjon, legge til kolonne, slette kolonne
Eksisterende tabell Ny tilordning Legg til kolonne (der du deretter kan endre datatype, gi nytt navn til og oppdatere)
Eksisterende tabell Eksisterende tilordning ingen

Skjermbilde av kolonner som er åpne for redigering.

Tilordningstransformasjoner

Noen dataformattilordninger (Parquet, JSON og Avro) støtter enkle inntakstidstransformasjoner. Hvis du vil bruke tilordningstransformasjoner, oppretter eller oppdaterer du en kolonne i vinduet Rediger kolonner.

Tilordningstransformasjoner kan utføres på en kolonne av typen streng eller datetime, der kilden har datatypeint eller lang. Støttede tilordningstransformasjoner er:

  • DateTimeFromUnixSeconds
  • DateTimeFromUnixMilliseconds
  • DateTimeFromUnixMicroseconds
  • DateTimeFromUnixNanoseconds

Avanserte alternativer basert på datatype

tabell (CSV, TSV, PSV):

  • Hvis du inntar tabellformater i en eksisterende tabell, kan du velge Avansert>Behold tabellskjema. Tabelldata inneholder ikke nødvendigvis kolonnenavnene som brukes til å tilordne kildedata til de eksisterende kolonnene. Når dette alternativet er merket av, utføres tilordningen etter rekkefølge, og tabellskjemaet forblir det samme. Hvis dette alternativet ikke er avmerket, opprettes nye kolonner for innkommende data, uavhengig av datastruktur.

  • Hvis du vil bruke den første raden som kolonnenavn, velger du Avansert>Første rad er kolonneoverskrift.

    Skjermbilde av avanserte CSV-alternativer.

JSON:

  • Hvis du vil bestemme kolonnedeling av JSON-data, velger du Avansert>Nestede nivåer, fra 1 til 100.

  • Hvis du velger Avansert>Hopp over JSON-linjer med feil, blir dataene inntatt i JSON-format. Hvis du lar denne avmerkingsboksen være umerket, blir dataene inntatt i flerjsonformat.

    Skjermbilde av avanserte JSON-alternativer.

Sammendrag

I vinduet dataforberedelse merkes alle tre trinnene med grønne hakemerker når datainntaket fullføres. Du kan velge et kort som skal spørres, slippe de inntatte dataene eller se et instrumentbord i inntakssammendraget.

Skjermbilde av sammendragssiden med vellykket inntak fullført.