Csv.Document

Syntaks

Csv.Document(
    source as any,
    optional columns as any,
    optional delimiter as any,
    optional extraValues as nullable number,
    optional encoding as nullable number
) as table

Om

Returnerer innholdet i CSV-dokumentet som en tabell.

  • columns kan være null, antall kolonner, en liste med kolonnenavn, en tabelltype eller en alternativpost.
  • delimiter kan være ett enkelt tegn, en liste over tegn eller verdien "", som angir at rader skal deles med etterfølgende mellomromstegn. Standard: ",".
  • Se ExtraValues.Type for de støttede verdiene i extraValues.
  • encoding angir tekstkodingstypen.

Hvis en post er angitt for columns (og delimiter, extraValuesog encoding er null), kan følgende postfelt angis:

  • Delimiter: Et skilletegn for kolonne med ett tegn. Standard: ",".
  • Columns: Kan være null, antall kolonner, en liste med kolonnenavn eller en tabelltype. Hvis antall kolonner er lavere enn tallet som ble funnet i inndataene, ignoreres de ekstra kolonnene. Hvis antall kolonner er høyere enn tallet som ble funnet i inndataene, vil de ekstra kolonnene være null. Når det ikke er angitt, bestemmes antall kolonner av hva som finnes i inndataene.
  • Encoding: Tekstkodingen av filen. Standard: 65001 (UTF-8).
  • CsvStyle: Angir hvordan anførselstegn håndteres.
  • QuoteStyle: Angir hvordan siterte linjeskift håndteres.
    • QuoteStyle.Csv (standard): Siterte linjeskift behandles som en del av dataene, ikke som slutten på gjeldende rad.
    • QuoteStyle.None: Alle linjeskift behandles som slutten på gjeldende rad, selv når de forekommer i en angitt verdi.
  • IncludeByteOrderMark: En logisk verdi som angir om det skal inkluderes et byteordremerke (stykkliste) i begynnelsen av CSV-utdataene. Når den er satt til sann, skrives stykklisten (for eksempel UTF-8-stykkliste: 0xEF 0xBB 0xBF); når den er satt til usann, inkluderes ingen stykkliste. Dette alternativet gjelder bare i utdatascenarioer. Standard er false.
  • ExtraValues: Se ExtraValues.Type etter verdiene som støttes av ExtraValues.

Eksempel 1

Behandle CSV-tekst med kolonneoverskrifter.

Bruk

let
    csv = Text.Combine({"OrderID,Item", "1,Fishing rod", "2,1 lb. worms"}, "#(cr)#(lf)")
in
    Table.PromoteHeaders(Csv.Document(csv))

Utdata

Table.FromRecords({
    [OrderID = "1", Item = "Fishing rod"],
    [OrderID = "2", Item = "1 lb. worms"]
})

Eksempel 2

Behandle CSV-tekst med flere skilletegn. I dette eksemplet angir den tredje parameteren skilletegnmønsteret #|# som skal brukes i stedet for standard.

Bruk

let
    csv = Text.Combine({"OrderID#|#Color", "1#|#Red", "2#|#Blue"}, "#(cr)#(lf)")
in
    Table.PromoteHeaders(Csv.Document(csv, null, "#|#"))

Utdata

Table.FromRecords({
    [OrderID = "1", Color = "Red"],
    [OrderID = "2", Color = "Blue"]
})

Eksempel 3

Behandle CSV-tekst med et egendefinert skilletegn og et fast antall kolonner.

Bruk

Csv.Document(
    "1|Barb#(cr)#(lf)2|Cal",
    [
        Delimiter = "|",
        Columns = 3
    ]
)

Utdata

Table.FromRecords({
    [Column1 = "1", Column2 = "Barb", Column3 = ""],
    [Column1 = "2", Column2 = "Cal", Column3 = ""]
})

Eksempel 4

Behandle CSV-tekst med et egendefinert skilletegn og et sett med egendefinerte kolonnenavn, mens du behandler linjeskift innebygd i anførselstegn som slutten på gjeldende rad.

Bruk

Csv.Document(
    "1|Barb|""Smith#(cr)#(lf)2|Cal|Fisher",
    [
        Delimiter = "|",
        Columns = type table [ID = text, First Name = text, Last Name = text],
        QuoteStyle = QuoteStyle.None
    ]
)

Utdata

Table.FromRecords({
    [ID = "1", First Name = "Barb", Last Name = "Smith"],
    [ID = "2", First Name = "Cal", Last Name = "Fisher"]
})
  • Last updated on