Csv.Document

Syntaxe

 
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

O nás

Vrátí obsah dokumentu CSV jako tabulku.

• columns může mít hodnotu null, počet sloupců, seznam názvů sloupců, typ tabulky nebo záznam možností.
• delimiter může být jeden znak, seznam znaků nebo hodnota "", která označuje, že řádky by měly být rozděleny podle po sobě jdoucích prázdných znaků. Výchozí hodnota: ",".
• Informace o podporovaných hodnotách ExtraValues.Typenajdete v extraValues .
• encoding určuje typ kódování textu.

Pokud je zadán záznam pro columns (a delimiter, extraValues a encoding jsou null), mohou být poskytnuta následující pole záznamu:

• Delimiter: Oddělovač sloupců s jedním znakem. Výchozí hodnota: ",".
• Columns: Může mít hodnotu null, počet sloupců, seznam názvů sloupců nebo typ tabulky. Pokud je počet sloupců nižší než počet nalezený ve vstupu, budou další sloupce ignorovány. Pokud je počet sloupců vyšší než počet nalezený ve vstupu, budou další sloupce null. Pokud ho nezadáte, určí se počet sloupců podle toho, co se ve vstupu nachází.
• Encoding: Kódování textu souboru. Výchozí hodnota: 65001 (UTF-8).
• CsvStyle: Určuje způsob zpracování uvozovek.
  • CsvStyle.QuoteAfterDelimiter (výchozí): Uvozovky v poli mají význam pouze tehdy, pokud jsou bezprostředně za oddělovačem.
  • CsvStyle.QuoteAlways: Uvozovky v poli jsou vždy významné bez ohledu na to, kde se zobrazují.
• QuoteStyle: Určuje způsob zpracování konců řádků v uvozových čarách.
  • QuoteStyle.Csv (výchozí): Konce řádků v uvozovkách se považují za součást dat, ne jako konec aktuálního řádku.
  • QuoteStyle.None: Všechny konce řádků jsou považovány za konec aktuálního řádku, i když se vyskytují uvnitř hodnoty v uvozovkách.
• IncludeByteOrderMark: Logická hodnota označující, jestli se má na začátku výstupu CSV zahrnout značka pořadí bajtů (BOM). Pokud je tato hodnota nastavená na true, zapíše se značka pořadí bajtů (například UTF-8 BOM: 0xEF 0xBB 0xBF); když je nastaveno false, není zahrnuta žádná značka pořadí bajtů. Tato možnost je použitelná pouze ve výstupních scénářích. Výchozí hodnota je false.
• ExtraValues: Podívejte se na ExtraValues.Type pro podporované hodnoty ExtraValues.

Příklad 1

Zpracování textu CSV se záhlavími sloupců

Využití

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

Výstup

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

Příklad 2

Zpracovat text CSV s více oddělovači znaků. V tomto příkladu třetí parametr určuje vzor #|# oddělovače, který se má použít místo výchozího.

Využití

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

Výstup

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