Csv.Document

Składnia

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

Informacje

Zwraca zawartość dokumentu CSV jako tabelę.

  • columns może mieć wartość null, liczbę kolumn, listę nazw kolumn, typ tabeli lub rekord opcji.
  • delimiter może być pojedynczym znakiem, listą znaków lub wartością "", która wskazuje, że wiersze powinny być dzielone przez kolejne znaki odstępu. Wartość domyślna: ",".
  • Zobacz ExtraValues.Type, aby poznać obsługiwane wartości extraValues.
  • encoding określa typ kodowania tekstu.

Jeśli określono columns rekord (i delimiter, extraValuesi encoding mają wartość null), można podać następujące pola rekordów:

  • Delimiter: ogranicznik kolumn z pojedynczym znakiem. Wartość domyślna: ",".
  • Columns: może mieć wartość null, liczbę kolumn, listę nazw kolumn lub typ tabeli. Jeśli liczba kolumn jest niższa niż liczba znaleziona w danych wejściowych, dodatkowe kolumny zostaną zignorowane. Jeśli liczba kolumn jest większa niż liczba znaleziona w danych wejściowych, dodatkowe kolumny będą mieć wartość null. Jeśli nie zostanie określona, liczba kolumn będzie określana przez to, co znajduje się w danych wejściowych.
  • Encoding: kodowanie tekstu pliku. Ustawienie domyślne: 65001 (UTF-8).
  • CsvStyle: określa sposób obsługi cudzysłowów.
  • QuoteStyle: określa sposób obsługi zacytowanych podziałów wierszy.
    • QuoteStyle.Csv (ustawienie domyślne): podziały wierszy w cudzysłów są traktowane jako część danych, a nie jako koniec bieżącego wiersza.
    • QuoteStyle.None: Wszystkie podziały wierszy są traktowane jako koniec bieżącego wiersza, nawet jeśli występują wewnątrz cytowanej wartości.
  • IncludeByteOrderMark: wartość logiczna wskazująca, czy na początku danych wyjściowych CSV ma być uwzględniony znak kolejności bajtów (BOM). Jeśli ustawiono wartość true, BOM jest zapisywany (na przykład UTF-8 BOM: 0xEF 0xBB 0xBF); w przypadku ustawienia wartości false nie jest uwzględniany żaden model BOM. Ta opcja ma zastosowanie tylko w scenariuszach wyjściowych. Wartość domyślna to false.
  • ExtraValues: Zapoznaj się z ExtraValues.Type obsługiwanymi wartościami funkcji ExtraValues.

Przykład 1

Przetwarzanie tekstu CSV z nagłówkami kolumn.

Użycie

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

Wyjście

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

Przykład 2

Przetwarzanie tekstu CSV z wieloma znakami ogranicznika. W tym przykładzie trzeci parametr określa wzorzec #|# ogranicznika do użycia zamiast domyślnego.

Użycie

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

Wyjście

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